Re: Bug#1041731: Hyphens in man pages

2023-10-16 Thread Gioele Barabucci
On 16/10/23 08:36, Gard Spreemann wrote: I've also found scdoc to be a quite pleasant and very lightweight alternative I've noticed that the bullet points in man pages produced by scdoc are "off" compared to those produced by "pod2man". For example compare

Re: Bug#1041731: Hyphens in man pages

2023-10-16 Thread Colin Watson
My plan, as indicated in https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1041731#62, had been to leave things much as they are for most of the period while trixie is in development, and then put the ".char - \-" etc. workarounds back in place for nroff output for trixie's release; this would

Re: Bug#1041731: Hyphens in man pages

2023-10-16 Thread Gard Spreemann
On October 16, 2023 2:41:08 AM GMT+02:00, "Trent W. Buck" wrote: >FWIW, there are lighter alternatives than pandoc: > >pandoc:After this operation, 174 MB of > additional disk space will be used. >sphinx-doc (sphinx-build -b man): After this operation, 140

Re: Bug#1041731: Hyphens in man pages

2023-10-15 Thread G. Branden Robinson
At 2023-10-15T13:11:47-0700, Russ Allbery wrote: > Sorry for my original message, which was very poorly worded and > probably incredibly confusing. Let me try to make less of a hash of > it. I think what I'm proposing is something like: My reply to this didn't make it to the -devel list even

Re: Bug#1041731: Hyphens in man pages

2023-10-15 Thread Trent W. Buck
On Sun 15 Oct 2023 17:33:07 +0200, Iustin Pop wrote: > At least you're not lazy. I am, so what I did many times is add a > build-depends on pandoc, and write the man page in rst or md. I think > that's a worse solution (pandoc is really heavy), but at least, I don't > have to go back to *roff.

Re: Bug#1041731: Hyphens in man pages

2023-10-15 Thread Russ Allbery
"G. Branden Robinson" writes: > How about this? > \- Minus sign. \- produces the basic Latin hyphen‐minus > specifying Unix command‐line options and frequently used in > file names. “-” is a hyphen in roff; some output devices > replace it with

Re: Bug#1041731: Hyphens in man pages

2023-10-15 Thread G. Branden Robinson
Hi Russ, At 2023-10-15T12:06:14-0700, Russ Allbery wrote: > Minor point, but since you posted it No worries! > "G. Branden Robinson" writes: > > > ... > > > \- Minus sign or basic Latin hyphen‐minus. \- produces the > > Unix command‐line option dash in the output.