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 245D4385482F for ; Mon, 9 Aug 2021 12:12:20 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 245D4385482F 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 imap1.suse-dmz.suse.de (imap1.suse-dmz.suse.de [192.168.254.73]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by smtp-out1.suse.de (Postfix) with ESMTPS id 1814F21D97; Mon, 9 Aug 2021 12:12:19 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1628511139; 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=Syk6a5jj3oR3mVHFeYW0qq5jBuHGirw61ToQ79y5S9o=; b=OJXs6k8zwectt0cosvWUgCLz+CAhS7b8sUeqZHmbrNv60GpL5tz/E/0GEk5DMeVIBVKKAt 7OCsNZTGnWiM/SYPM8lXdbrY4Opsmu2bvjWx8KQ+TbFJy7eTRpLfloHMB8niyZRgY0L/AQ Es5G3ukhNyHSGSsO+2ykeBREhO72RW0= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1628511139; 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=Syk6a5jj3oR3mVHFeYW0qq5jBuHGirw61ToQ79y5S9o=; b=CS20oAv+8eNqEoEpK35TSYpcWmRfLOUaT7594vc5OmHLFxShyiqkA2fNk44iwvETz7RWIf pN6temAha96nN8BA== Received: from imap1.suse-dmz.suse.de (imap1.suse-dmz.suse.de [192.168.254.73]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by imap1.suse-dmz.suse.de (Postfix) with ESMTPS id EEE2313731; Mon, 9 Aug 2021 12:12:18 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap1.suse-dmz.suse.de with ESMTPSA id mu7wOKIbEWG3XQAAGKfGzw (envelope-from ); Mon, 09 Aug 2021 12:12:18 +0000 Subject: Re: Benefits of using Sphinx documentation format To: Eli Zaretskii , Richard Biener Cc: gcc@gcc.gnu.org References: <1446990946.2994.192.camel@surprise> <83r1g3aady.fsf@gnu.org> <144d27f7-9486-0515-2ebd-4e8d9d9fc3b2@suse.cz> <4988937.164lfTNWpH@excalibur> <83k0lva2hv.fsf@gnu.org> <83y2aa8m7g.fsf@gnu.org> From: =?UTF-8?Q?Martin_Li=c5=a1ka?= Message-ID: <0ad00e9a-9a0c-e2b8-1073-631efb44a554@suse.cz> Date: Mon, 9 Aug 2021 14:12:18 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.12.0 MIME-Version: 1.0 In-Reply-To: <83y2aa8m7g.fsf@gnu.org> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Spam-Status: No, score=-4.7 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, NICE_REPLY_A, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) 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, 09 Aug 2021 12:12:21 -0000 On 7/13/21 1:52 PM, Eli Zaretskii via Gcc wrote: >> From: Richard Biener >> Date: Tue, 13 Jul 2021 08:24:17 +0200 >> Cc: Eli Zaretskii , "gcc@gcc.gnu.org" >> >> I actually like texinfo (well, because I know it somewhat, compare to sphinx). >> I think it produces quite decent PDF manuals. I never use the html >> output (in fact I read our manual using grep & vim in the original >> .texi form ...). > > FTR, I almost exclusively use the (Emacs) Info reader to read the > manuals in Info format. I never understood those who prefer reading > HTML-formatted docs in a Web browser. It's very easy. HTML output is much nice from the visual point of view and everybody uses a browser nowadays. Moreover, one can easily Google for e.g. option name, or provide a link at pages like StackOverflow. That's reality. > > So I never understood people, let alone developers, who are willing to > throw such power out the window and use HTML. I only do that when > there's a manual I don't have installed in the Info format (a rare > phenomenon) or some other similarly exceptional cases. But I get it > that there are strange people who prefer HTML nonetheless. More > importantly, the Texinfo developers understand that, and actively work > towards making the Texinfo HTML better, with some impressive progress > already there, see the latest release 6.8 of Texinfo (Gavin mentioned > some of the advances). > I've read that and yes, there's a progress. However, I still see a rapid gap in what can be achieved by a mode modern tool like Sphinx. Martin