From nobody Fri Jun 10 16:20:03 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 B81818525FC for ; Fri, 10 Jun 2022 16:20:06 +0000 (UTC) (envelope-from sgk@troutmask.apl.washington.edu) Received: from troutmask.apl.washington.edu (troutmask.apl.washington.edu [128.95.76.21]) (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-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "troutmask", Issuer "troutmask" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4LKR5155qwz4SMp; Fri, 10 Jun 2022 16:20:05 +0000 (UTC) (envelope-from sgk@troutmask.apl.washington.edu) Received: from troutmask.apl.washington.edu (localhost [127.0.0.1]) by troutmask.apl.washington.edu (8.16.1/8.16.1) with ESMTPS id 25AGK3VJ042413 (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384 bits=256 verify=NO); Fri, 10 Jun 2022 09:20:03 -0700 (PDT) (envelope-from sgk@troutmask.apl.washington.edu) Received: (from sgk@localhost) by troutmask.apl.washington.edu (8.16.1/8.16.1/Submit) id 25AGK3eC042412; Fri, 10 Jun 2022 09:20:03 -0700 (PDT) (envelope-from sgk) Date: Fri, 10 Jun 2022 09:20:03 -0700 From: Steve Kargl To: Steffen Nurpmeso Cc: Baptiste Daroussin , freebsd-hackers@freebsd.org Subject: Re: mandoc and volume titles Message-ID: Reply-To: sgk@troutmask.apl.washington.edu References: <20220609071702.umix3bbub3qxunlq@aniel.nours.eu> <20220609152904.gc9ue%steffen@sdaoden.eu> <20220609165536.A5vGK%steffen@sdaoden.eu> <20220609214906.6--d0%steffen@sdaoden.eu> <20220610123126.oXt_A%steffen@sdaoden.eu> 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 MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20220610123126.oXt_A%steffen@sdaoden.eu> X-Rspamd-Queue-Id: 4LKR5155qwz4SMp X-Spamd-Bar: - Authentication-Results: mx1.freebsd.org; dkim=none; dmarc=fail reason="No valid SPF, No valid DKIM" header.from=washington.edu (policy=none); spf=none (mx1.freebsd.org: domain of sgk@troutmask.apl.washington.edu has no SPF policy when checking 128.95.76.21) smtp.mailfrom=sgk@troutmask.apl.washington.edu X-Spamd-Result: default: False [-1.55 / 15.00]; HAS_REPLYTO(0.00)[sgk@troutmask.apl.washington.edu]; ARC_NA(0.00)[]; MID_RHS_MATCH_FROM(0.00)[]; FROM_HAS_DN(0.00)[]; RCPT_COUNT_THREE(0.00)[3]; TO_DN_SOME(0.00)[]; MIME_GOOD(-0.10)[text/plain]; REPLYTO_ADDR_EQ_FROM(0.00)[]; NEURAL_HAM_MEDIUM(-0.70)[-0.696]; TO_MATCH_ENVRCPT_SOME(0.00)[]; NEURAL_HAM_SHORT(-0.96)[-0.958]; NEURAL_SPAM_LONG(0.10)[0.100]; MLMMJ_DEST(0.00)[freebsd-hackers]; R_SPF_NA(0.00)[no SPF record]; FROM_EQ_ENVFROM(0.00)[]; R_DKIM_NA(0.00)[]; MIME_TRACE(0.00)[0:+]; ASN(0.00)[asn:73, ipnet:128.95.0.0/16, country:US]; RCVD_COUNT_TWO(0.00)[2]; RCVD_TLS_ALL(0.00)[]; DMARC_POLICY_SOFTFAIL(0.10)[washington.edu : No valid SPF, No valid DKIM,none] X-ThisMailContainsUnwantedMimeParts: N On Fri, Jun 10, 2022 at 02:31:26PM +0200, Steffen Nurpmeso wrote: > 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 don't see how a discussion on an idea that may make FreeBSD more useful for its user is "messing up software". But, you have made it clear that such discussion are unwelcomed here. > ... > |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. It is magic to the extent that doc-volume-* is undocumented in mandoc(1) and mdoc(7). It is magic to doc-volume-* to work with mandoc(1) as well mandoc does not recognize doc-volume-* > #?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.) I have no idea what the above is meant to demonstrate. But, if your're tracking 5.5.0, groff lived in src/contrib, so yes, you'll like find doc-volumen-ds in the treele:kargl[216] cat a.c % foreach i (1 2 3 4 5 6 7 8 9) foreach? find /usr/src -name \*.$i -type f | xargs grep doc-volume | wc -l foreach? end 0 0 0 0 0 0 0 0 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. Thanks for granting me permission to try to improve FreeBSD. -- Steve