From nobody Fri Jun 10 12:31:26 2022 X-Original-To: freebsd-hackers@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id DF40184096E for ; Fri, 10 Jun 2022 12:31:30 +0000 (UTC) (envelope-from steffen@sdaoden.eu) Received: from sdaoden.eu (sdaoden.eu [217.144.132.164]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 4LKL1F63Nfz3tH2; Fri, 10 Jun 2022 12:31:29 +0000 (UTC) (envelope-from steffen@sdaoden.eu) Received: from kent.sdaoden.eu (kent.sdaoden.eu [192.0.2.2]) by sdaoden.eu (Postfix) with ESMTPS id CF25316059; Fri, 10 Jun 2022 14:31:27 +0200 (CEST) Received: by kent.sdaoden.eu (Postfix, from userid 1000) id 2EDF78AB1C; Fri, 10 Jun 2022 14:31:26 +0200 (CEST) Date: Fri, 10 Jun 2022 14:31:26 +0200 Author: Steffen Nurpmeso From: Steffen Nurpmeso To: Steve Kargl Cc: Baptiste Daroussin , freebsd-hackers@freebsd.org Subject: Re: mandoc and volume titles Message-ID: <20220610123126.oXt_A%steffen@sdaoden.eu> In-Reply-To: References: <20220609071702.umix3bbub3qxunlq@aniel.nours.eu> <20220609152904.gc9ue%steffen@sdaoden.eu> <20220609165536.A5vGK%steffen@sdaoden.eu> <20220609214906.6--d0%steffen@sdaoden.eu> User-Agent: s-nail v14.9.24-254-g443e374be3 OpenPGP: id=EE19E1C1F2F7054F8D3954D8308964B51883A0DD; url=https://ftp.sdaoden.eu/steffen.asc; preference=signencrypt BlahBlahBlah: Any stupid boy can crush a beetle. But all the professors in the world can make no bugs. X-Rspamd-Queue-Id: 4LKL1F63Nfz3tH2 X-Spamd-Bar: -- Authentication-Results: mx1.freebsd.org; dkim=none; dmarc=none; spf=pass (mx1.freebsd.org: domain of steffen@sdaoden.eu designates 217.144.132.164 as permitted sender) smtp.mailfrom=steffen@sdaoden.eu X-Spamd-Result: default: False [-2.23 / 15.00]; ARC_NA(0.00)[]; NEURAL_HAM_MEDIUM(-0.96)[-0.963]; RCPT_COUNT_THREE(0.00)[3]; TO_DN_SOME(0.00)[]; R_SPF_ALLOW(-0.20)[+a]; FROM_HAS_DN(0.00)[]; MIME_GOOD(-0.10)[text/plain]; DMARC_NA(0.00)[sdaoden.eu]; NEURAL_HAM_LONG(-0.99)[-0.986]; TO_MATCH_ENVRCPT_SOME(0.00)[]; NEURAL_HAM_SHORT(-0.98)[-0.983]; MID_CONTAINS_FROM(1.00)[]; MLMMJ_DEST(0.00)[freebsd-hackers]; FROM_EQ_ENVFROM(0.00)[]; R_DKIM_NA(0.00)[]; MIME_TRACE(0.00)[0:+]; ASN(0.00)[asn:15987, ipnet:217.144.128.0/20, country:DE]; RCVD_COUNT_TWO(0.00)[2]; RCVD_TLS_ALL(0.00)[]; RECEIVED_SPAMHAUS_PBL(0.00)[192.0.2.2:received] X-ThisMailContainsUnwantedMimeParts: N List-Id: Technical discussions relating to FreeBSD List-Archive: https://lists.freebsd.org/archives/freebsd-hackers List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-hackers@freebsd.org Steve Kargl wrote in : |On Thu, Jun 09, 2022 at 11:49:06PM +0200, Steffen Nurpmeso wrote: |> Steve Kargl wrote in ... |>|.ds volume-operating-system steve |>|.ds volume-ds-8 kargl |> |> If you use ".Dt TDI 1", you must set volume-ds-1. |> |>|.Dd June 8, 2022 |>|.Dt TDI 1 |>|.Sh NAME |>|.Nm tdi |>| |>|% mandoc tdi.1 | head -1 |> |> This is mandoc Mr. Kargl. ... |% cat steve.4 |.Dd June 8, 2022 |.ds doc-volume-operating-system Steve |.ds doc-volume-ds-4 Kargl |.Dt TDI 4 |.Sh NAME |.Nm tdi |Hi. |% mandoc steve.4 Well you can ignore totally what i say. And you can mess up software in the FreeBSD base system and introduce incompatible islands whenever you want to. I pointed out that the mandoc maintainer is currently having a run, i think i saw .ds request fly by, and from that to introducing up-upstream compatible handling of 20+ years old mdoc(7) macros would only be a small step. ... |Having to install groff and adding undocumented .ds magic isn't the ... This is not magic but decade old stuff, whether you like it or not. #?0|kent:free-src.git$ git grep -i doc-volume-ds release/5.5.0~50784 | wc -l 31 (I do not track anything before 5.5.0.) |solution for a FreeBSD base system functionality. In fact, I think |it would be better to have the mdoc(7) package grow a .Vl macro to |allow the volume title to be easily overridden. You can think whatever you want, and fill the remaining two letter combinations until they are all gone. Have a nice day. --steffen | |Der Kragenbaer, The moon bear, |der holt sich munter he cheerfully and one by one |einen nach dem anderen runter wa.ks himself off |(By Robert Gernhardt)