From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp-out1.suse.de (smtp-out1.suse.de [195.135.220.28]) by sourceware.org (Postfix) with ESMTPS id 73B383889810; Mon, 7 Jun 2021 13:30:24 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 73B383889810 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=suse.cz Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=suse.cz Received: from imap.suse.de (imap-alt.suse-dmz.suse.de [192.168.254.47]) (using TLSv1.2 with cipher ECDHE-ECDSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp-out1.suse.de (Postfix) with ESMTPS id 1F2C221A91; Mon, 7 Jun 2021 13:30:23 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1623072623; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=9aBkQaSHiD92CMVpv4YSHM2E3AO6VBeTUGg511RLqTA=; b=pbyi23Vb4xuMKlYEvv6KHIwn++C3/SHLO+KxlD1QZQBZU+8f+AzODGR5M+aa99DKWjR12P uFTA7gxFwy8i0G4e4zaCPeirbLirZoYLv5um5FWBi+IWfC3LwajH1hcpeEmuMci3X7lzma VTeqhV0p0M+pohJCr8t9bsaN4MhC+kc= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1623072623; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=9aBkQaSHiD92CMVpv4YSHM2E3AO6VBeTUGg511RLqTA=; b=My0RQ/AyZxQE/KDrrvnEUDjToPdiQYwE28DZTOhhPblUjrZZGjLC0PgY/0LiUGHdAoxX33 8077wm2PAPHjbEAA== Received: from imap3-int (imap-alt.suse-dmz.suse.de [192.168.254.47]) by imap.suse.de (Postfix) with ESMTP id EFBC4118DD; Mon, 7 Jun 2021 13:30:22 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1623072623; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=9aBkQaSHiD92CMVpv4YSHM2E3AO6VBeTUGg511RLqTA=; b=pbyi23Vb4xuMKlYEvv6KHIwn++C3/SHLO+KxlD1QZQBZU+8f+AzODGR5M+aa99DKWjR12P uFTA7gxFwy8i0G4e4zaCPeirbLirZoYLv5um5FWBi+IWfC3LwajH1hcpeEmuMci3X7lzma VTeqhV0p0M+pohJCr8t9bsaN4MhC+kc= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1623072623; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=9aBkQaSHiD92CMVpv4YSHM2E3AO6VBeTUGg511RLqTA=; b=My0RQ/AyZxQE/KDrrvnEUDjToPdiQYwE28DZTOhhPblUjrZZGjLC0PgY/0LiUGHdAoxX33 8077wm2PAPHjbEAA== Received: from director2.suse.de ([192.168.254.72]) by imap3-int with ESMTPSA id YeK+OW4fvmAtJAAALh3uQQ (envelope-from ); Mon, 07 Jun 2021 13:30:22 +0000 Subject: Re: RFC: Sphinx for GCC documentation To: "Koning, Paul" , Tobias Burnus Cc: Jason Merrill via Gcc-patches , GCC Development References: <1446990946.2994.192.camel@surprise> <1a22bc37-3d48-132f-a3d5-219471cd443c@suse.cz> <7366de44-aece-e53a-42ca-65f59407ec04@codesourcery.com> <6FABDF1B-98D7-4A58-8472-66120672E429@dell.com> From: =?UTF-8?Q?Martin_Li=c5=a1ka?= Message-ID: <0423bc02-b477-9c8a-1157-93e048d85974@suse.cz> Date: Mon, 7 Jun 2021 15:30:22 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.10.2 MIME-Version: 1.0 In-Reply-To: <6FABDF1B-98D7-4A58-8472-66120672E429@dell.com> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-4.6 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, KAM_EU, NICE_REPLY_A, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=no autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on server2.sourceware.org X-BeenThere: gcc@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 07 Jun 2021 13:30:34 -0000 On 6/4/21 4:24 PM, Koning, Paul wrote: > > >> On Jun 4, 2021, at 3:55 AM, Tobias Burnus wrote: >> >> Hello, >> >> On 13.05.21 13:45, Martin Liška wrote: >>> On 4/1/21 3:30 PM, Martin Liška wrote: >>>> That said, I'm asking the GCC community for a green light before I >>>> invest >>>> more time on it? >>> So far, I've received just a small feedback about the transition. In >>> most cases positive. >>> >>> [1] https://splichal.eu/scripts/sphinx/ >> >> The HTML output looks quite nice. >> >> What I observed: >> >> * Looking at >> https://splichal.eu/scripts/sphinx/gfortran/_build/html/intrinsic-procedures/access-checks-file-access-modes.html >> why is the first argument description in bold? >> It is also not very readable to have a scollbar there – linebreaks would be better. >> → I think that's because the assumption is that the first line contains a header >> and the rest the data > > Explicit line breaks are likely to be wrong depending on the reader's window size. I would suggest setting the table to have cells with line-wrapped contents. That would typically be the default in HTML, I'm curious why that is not happening here. Note that Sphinx supports 2 types of tables: Grid Table and Simple table. We prefer the later and one can do proper line breaking in the Grid type. https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#tables Anyway, this is resolved as I use more appropriate directive: https://splichal.eu/scripts/sphinx/gfortran/_build/html/intrinsic-procedures/access-checks-file-access-modes.html Martin > > paul > >