From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-wr1-x431.google.com (mail-wr1-x431.google.com [IPv6:2a00:1450:4864:20::431]) by sourceware.org (Postfix) with ESMTPS id 833973855023; Mon, 12 Jul 2021 14:05:23 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 833973855023 Received: by mail-wr1-x431.google.com with SMTP id i94so25774674wri.4; Mon, 12 Jul 2021 07:05:23 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=NJwFymNJvUDEsyiFo9zBT6R6/HABdVrXiEL8NEInYJ8=; b=XWERNS8z1UZL6LfmF19EaoSbFL/bAAwoO6mjQ5qqa7XsetSrCNoCLjuiQPQ8oPmyRK hVSCi9yi44sYIGIJVcEUsSb6+FstJaFFFwe0NUQqsxu7fQW1cee085ObjJIEptYct941 Wv5dRpqZjcX08dnoYh3TFSRwsu6MT4s+H+Ol4bBESJe9oyaTGJp91xqgGFtGElVDiIEm jJViZ6zIBZ6yj7ej8OZIMHkkxnkKr97eNE3e9RWdaZx1Sx8kCPe+c2Rw0POGyt6nmDOB MQ7ZCx8DXhdJBRRuEYCKdHUvpdow2gHKztWhRo8xmLuyJs2JhWbh2p3sWNMZnQrTUm+v +8tQ== X-Gm-Message-State: AOAM5310KDUNP3MiUriZIfDBklQ/AY+wHu+L+uEr5bzhsY3Kdn+ZvOaL upoQIEPWsZ3xbKhOx9VEcmlOfaJiMVtT/1zZBac= X-Google-Smtp-Source: ABdhPJzzatXdmjTks0jaQ/moCoAeDSsCuT/4ERNR3WdRCtaLKOiQHq3Ss0S8S5bNZvP6oi+P6x0IrSmfsEwnNF58PN4= X-Received: by 2002:a5d:6ac8:: with SMTP id u8mr18015478wrw.30.1626098722592; Mon, 12 Jul 2021 07:05:22 -0700 (PDT) MIME-Version: 1.0 References: <1446990946.2994.192.camel@surprise> <1a22bc37-3d48-132f-a3d5-219471cd443c@suse.cz> <3a2a573b-5185-fff5-f9da-6e5e39953ad6@suse.cz> <8641dc55-5412-fbd7-bafd-13604311f5ad@suse.cz> <5ffe3e32-ece0-a1b4-1fcf-e35177fa80b5@suse.cz> <87489d9a-44e2-411c-3f3a-534d07e78b95@suse.cz> <0866a0ea-c846-ea5e-ac7a-d1c8f106cc45@suse.cz> <5bb9a10d-f3b9-f16a-7430-bbae2d4978e2@suse.cz> <2f60f602-5d88-7674-9620-2172748664c5@suse.cz> <83a6n8obh4.fsf@gnu.org> <57743e51-04d5-ec2e-b684-54f0321ef0bd@suse.cz> <83pmw3mrcg.fsf@gnu.org> <98388e12-3712-575b-9387-45b6ea7ef498@suse.cz> <83v95fabwx.fsf@gnu.org> In-Reply-To: From: Jonathan Wakely Date: Mon, 12 Jul 2021 15:05:11 +0100 Message-ID: Subject: Re: Benefits of using Sphinx documentation format To: Eli Zaretskii Cc: =?UTF-8?Q?Martin_Li=C5=A1ka?= , "gcc@gcc.gnu.org" , gcc-patches , "Joseph S. Myers" Content-Type: text/plain; charset="UTF-8" X-Spam-Status: No, score=-1.2 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_FROM, KAM_SHORT, RCVD_IN_DNSWL_NONE, 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, 12 Jul 2021 14:05:25 -0000 On Mon, 12 Jul 2021 at 14:53, Jonathan Wakely wrote: > For me, these items are enough justification to switch away from > texinfo, which produces crap HTML pages with crap anchors. You can't > find out the anchors without inspecting (and searching) the HTML > source. That's utterly stupid. And even after you do that, the anchor > is at the wrong place: > https://gcc.gnu.org/onlinedocs/gcc/Overall-Options.html#index-c > As somebody who spends a lot of time helping users on the mailing > list, IRC, stackoverflow, and elsewhere, this "feature" of the texinfo > HTML has angered me for many years. To be clear, I give links to users frequently (several times a week, every week, for decades) and prefer to give them a link to specific options. Obviously I link to the online HTML docs rather than telling them an 'info' command to run, because most people don't use info pages or know how to navigate them. That means I can't provide decent links, because the actual option name I'm trying to link to is always off the top of the page. This is simply unacceptable IMHO. Texinfo must go.