From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-0.0 required=5.0 tests=T_SCC_BODY_TEXT_LINE, UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 25688 invoked from network); 25 Mar 2022 21:20:38 -0000 Received: from bsd.lv (HELO mandoc.bsd.lv) (66.111.2.12) by inbox.vuxu.org with ESMTPUTF8; 25 Mar 2022 21:20:38 -0000 Received: from fantadrom.bsd.lv (localhost [127.0.0.1]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id 12ab4d15 for ; Fri, 25 Mar 2022 16:20:36 -0500 (EST) Received: from mx.stare.cz (uvt.stare.cz [185.63.96.79]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id 3ee47f48 for ; Fri, 25 Mar 2022 16:20:31 -0500 (EST) Received: from localhost (stare.cz [local]) by stare.cz (OpenSMTPD) with ESMTPA id 4c02a3d4 for ; Fri, 25 Mar 2022 22:20:30 +0100 (CET) Date: Fri, 25 Mar 2022 22:20:30 +0100 From: Jan Stary To: discuss@mandoc.bsd.lv Subject: Re: HTML output: section headers with diacritics not in table of contents Message-ID: References: X-Mailinglist: mandoc-discuss Reply-To: discuss@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: On Mar 25 21:59:26, mario.blaettermann@gmail.com wrote: > Hello Jan, > > Am Fr., 25. März 2022 um 21:36 Uhr schrieb Jan Stary : > > > > On Mar 25 17:57:21, mario.blaettermann@gmail.com wrote: > > > > Regarding -O toc, you should be aware that a number of senior OpenBSD > > > > developers hated the feature so much that i disabled it completely > > > > on man.openbsd.org. They argue the feature is superfluous, noisy, > > > > and the whole idea of prefixing a TOC to a manual page is misguided. > > > > > > > To mention, the TOC works at man.openbsd.org, for example: > > > http://man.openbsd.org/mandoc#Syntax_tree_output > > > > I don't see a TOC on that page. > > > What you've expected is probably a TOC like [1]. Yes, because that's what mandoc calls a TOC: toc If an input file contains at least two non-standard sections, print a table of contents near the beginning of the output. > But the TOC generated > by Mandoc doesn't mean a real table of contents in this case, it's > merely a »hidden« TOC, which enables to click on section headers and > options to generate hyperlinks for that position. If you can open the > link mentioned above, and »Syntax tree output« is on top of the page > displayed in the browser, then this kind of TOC works. > [1] https://archlinux.org/pacman/makepkg.8.html I think these are 'tags' in the mandoc parlance. http://man.openbsd.org/mandoc#tag Jan -- To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv