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.2 required=5.0 tests=DKIM_INVALID,DKIM_SIGNED, T_TVD_MIME_EPI autolearn=no autolearn_force=no version=3.4.4 Received: (qmail 15649 invoked from network); 23 Oct 2023 10:33:58 -0000 Received: from bsd.lv (HELO mandoc.bsd.lv) (66.111.2.12) by inbox.vuxu.org with ESMTPUTF8; 23 Oct 2023 10:33:58 -0000 Received: from fantadrom.bsd.lv (localhost [127.0.0.1]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id 73a18bcc for ; Mon, 23 Oct 2023 10:33:55 +0000 (UTC) Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id 3defcecf for ; Mon, 23 Oct 2023 10:33:55 +0000 (UTC) Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by ams.source.kernel.org (Postfix) with ESMTP id AB22CB802BE; Mon, 23 Oct 2023 10:33:53 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id DA89FC433C9; Mon, 23 Oct 2023 10:33:51 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1698057233; bh=tfdjcjQmQ1bEV8b264bdhqLB+wmeFYitGzoo+mHK8G4=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=tSJCmmfBK+HRkxE0+G098VwA9i36YcMdabrJlokzsDsTg+YzOQWzTilD49Q+6S6vb JC70AdYnsrJLGeO8CyC4nKcbgeMfynJmz1Y6g53nSnbZuWMinDYO5HxVsKyWKebkei 5OM32AV3oyrUh3fwBQ0oWjV6D0tbla2wfKjROVIvDS6TnB/gsmqfU3xsC9TPEjJuQj Hl0gNXebFI15LntIi2mtYzfFigVfzo9baoWm4KVauc4Pmp3UX7hoFVvMXhD7H2WfZP FeOeEz35w7StdTlp2g9dCtywcjxECmQLKpebor38WLiRjqnK1b1Uq3A2OPBtlf55lY GIXqUw5KJbCeA== Date: Mon, 23 Oct 2023 12:33:43 +0200 From: Alejandro Colomar To: "G. Branden Robinson" Cc: Paul Eggert , tech@mandoc.bsd.lv, Ingo Schwarze , Alejandro Colomar Subject: Re: mandoc mishandles tzfile(5)'s .IP \(bu "\w'\(bu 'u" Message-ID: References: <884cb5d0-27ce-a5ca-b449-972021e62e92@gmail.com> <7c3294cf-e3d0-c716-d1c0-5b6c5c757d7e@cs.ucla.edu> <7eb92df5-6c87-8384-c4a8-2a00eabf1c8e@gmail.com> <66ef5b92-6e19-8bea-2840-6c2f0240d225@cs.ucla.edu> <160e850e-c5eb-45a9-9011-b766ade9dd10@cs.ucla.edu> <20231023083059.h43j6g2cse3e55en@illithid> X-Mailinglist: mandoc-tech Reply-To: tech@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="EZ/B16iiEbELMQ+5" Content-Disposition: inline In-Reply-To: <20231023083059.h43j6g2cse3e55en@illithid> --EZ/B16iiEbELMQ+5 Content-Type: text/plain; protected-headers=v1; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Date: Mon, 23 Oct 2023 12:33:43 +0200 From: Alejandro Colomar To: "G. Branden Robinson" Cc: Paul Eggert , tech@mandoc.bsd.lv, Ingo Schwarze , Alejandro Colomar Subject: Re: mandoc mishandles tzfile(5)'s .IP \(bu "\w'\(bu 'u" Hi Branden, On Mon, Oct 23, 2023 at 03:30:59AM -0500, G. Branden Robinson wrote: > Hi Paul, >=20 > At 2023-10-22T17:41:28-0700, Paul Eggert wrote: > > On 2023-10-22 14:06, Ingo Schwarze wrote: > > > mandoc only supports ASCII strings as arguments to \w, not escape > > > sequences or formatting instructions. > >=20 > > For the TZDB man pages mandoc need not support all that, just \(bu. > >=20 > > Just to make sure we're on the same page, I reproduced the problem by > > running the command "mandoc -man -Tascii t.5", where t.5 contains the > > following lines: > >=20 > > .TH tzfile 5 > > .SH NAME > > .IP \(bu "\w'\(bu 'u" > > xxx > > .PP > > yyy >=20 > At the risk of being simplistic, why not just give `IP` an explicit > measurement as an argument? >=20 > .IP \(bu 2n He feels that IP \(bu 3n is too long of a space in PDF. "\w'\(bu 'u" has the benefit of being 3n in terminals, but shorter in PDF. This was triggered after my suggestion of using 3[n] instead of 2[n] to clearly separate the bullet from the bulleted text, as docuemented in man-pages(7). Cheers, Alex >=20 > (Or 3n, or 4n, or whatever looks best to you.) >=20 > > The output should contain two spaces between the bullet's "o" and the > > "x", but with current mandoc it contains five spaces. >=20 > If you're viewing on a terminal, `.IP \(bu 3n` should achieve this.[1] >=20 > (Typesetters are a different story because how wide a bullet is depends > on the output device and the font.) >=20 > I'm not saying that better mandoc(1) support for `\w` would be an awful > thing to have, but it doesn't seem necessary, to me, to solve this > specific problem. >=20 > Regards, > Branden >=20 > [1] Strictly, you can leave the "n" off, but I consider that slightly > sloppy, and I think that the explicit scaling unit is also helpful > as a reminder to the man page author that `IP`'s second argument, > unlike most arguments to man(7) macros, will _not_ be formatted as > text. I might take that. --=20 --EZ/B16iiEbELMQ+5 Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAABCgAdFiEE6jqH8KTroDDkXfJAnowa+77/2zIFAmU2TAcACgkQnowa+77/ 2zJF7A//daA8HgT9H1a59CBoF7zoY6Uu4GugzoqP4oifDNDMNcfcOoPjFNdSwY2s y/iTk6CGrvuNOLrm2wTsBfTRT0lATB+1QGANpUt0B1ECycinWA+PACV8hM+P5plY mLJ7/3XvPUVNYY1IcObH1CC5LFx+vyG1OoBI2x7B2SVjpNGxCg28jyFrswdP9kWC PPqtka4cCUURzKEAShQTxz0WSTpIGgU/PRUksdw+LTotC4YVAf8LMabdzQTV09R9 3y8TbnPdQ6DHbSTZZID/DFcpjX4LGkJ3XssCiC3dPCcRpZWTR1+K4iSlsMikNNlA VYDe2qgO4EesvdT894DlzUstRTlURDeEc8NR9FyjRx3bDqCG94of5lpuJ0/aRt4G fFo9BYoox0PU/+DeTc7BL5+UFYnLrynGzKjtoTcaXHrSiTF+Zu2xLYd/mXxljA5h 6wOChl/eYkJZHSJVJSSMolGPDZWU6+D6Jz602Dv1sks6YlNbahzheIIzJk5OhWsy jkZ+BixI/ZCZ9bQdveYeMUU1CsXVFz4uplDfj+16YgTh8Rnl9lEdSw5pFC4Okw6m 2ykDywe93K76/SyMgHI37y5gIkMG/EVOZCgmjbWkXI8TgGIARImI0QTjpjfF0HeY fSB4QO5y+xaD+eIkaeOtqtlwejjiZxAqGNDifaJq7/Dpf48IUGE= =WDlC -----END PGP SIGNATURE----- --EZ/B16iiEbELMQ+5-- -- To unsubscribe send an email to tech+unsubscribe@mandoc.bsd.lv