Re: Hyphens in man pages

2023-10-24 Thread Paul Wise
On Tue, 2023-10-24 at 05:40 +, Tobias Frost wrote: > Am 24. Oktober 2023 03:43:29 UTC schrieb Paul Wise: > > > BTW: as a Debian member, you have access to a gratis subscription: > > > > https://wiki.debian.org/MemberBenefits#LWN > > AFAIK this is no longer available. I am still using the

Re: Hyphens in man pages

2023-10-24 Thread Tobias Frost
Am 24. Oktober 2023 03:43:29 UTC schrieb Paul Wise : >BTW: as a Debian member, you have access to a gratis subscription: > >https://wiki.debian.org/MemberBenefits#LWN AFAIK this is no longer available.

Re: Hyphens in man pages

2023-10-23 Thread G. Branden Robinson
Hi Jon, At 2023-10-23T17:24:30-0600, Jonathan Corbet wrote: > When I wrote the article (last week) it was a lot closer :) > > As for why: Debian may have resolved this, for now at least, but this > is an issue that is sure to crop up in distributions that are not as > quick to pick up new groff

Re: Hyphens in man pages

2023-10-23 Thread Paul Wise
On Mon, 2023-10-23 at 11:17 -0500, G. Branden Robinson wrote: > https://lwn.net/Articles/947941/ > > Would someone be willing to send me a subscriber-sponsored link to it? BTW: as a Debian member, you have access to a gratis subscription: https://wiki.debian.org/MemberBenefits#LWN -- bye,

Re: Hyphens in man pages

2023-10-23 Thread Jonathan Corbet
"G. Branden Robinson" writes: > I am disappointed that LWN did not cover the groff 1.23.0 release, its > first in four years and featuring over 400 bug fixes,[1] even as a tiny > blurb on the back page, but seizes upon this issue, which quietly died > down a week ago, and should therefore have

Re: Hyphens in man pages

2023-10-23 Thread G. Branden Robinson
At 2023-10-23T11:17:07-0500, G. Branden Robinson wrote: > Would someone be willing to send me a subscriber-sponsored link to it? Thanks to the three fleet-fingered folks who supplied me with one. I am amply equipped to resume my crusade against ignorance and misinformation...except... Now that

Re: Hyphens in man pages

2023-10-23 Thread G. Branden Robinson
At 2023-10-14T20:51:27-0600, Antonio Russo wrote: > I discovered a new pet peeve today: I must report with some dismay that this thread made LWN. https://lwn.net/Articles/947941/ Would someone be willing to send me a subscriber-sponsored link to it? I intend to attempt to address what I expect

Re: Hyphens in man pages

2023-10-15 Thread G. Branden Robinson
At 2023-10-15T10:01:20-0700, Russ Allbery wrote: > I think my position at this point as pod2man maintainer (not yet > implemented in podlators) is that every occurrence of - in POD source > will be translated into \-, rather than using the current heuristics, > and people who meant to use ‐ should

Re: Hyphens in man pages

2023-10-15 Thread Gioele Barabucci
On 15/10/23 19:13, Johannes Schauer Marin Rodrigues wrote: Quoting Gioele Barabucci (2023-10-15 17:59:32) On 15/10/23 17:33, 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

Re: Hyphens in man pages

2023-10-15 Thread Russ Allbery
Minor point, but since you posted it "G. Branden Robinson" writes: > ... > \- Minus sign or basic Latin hyphen‐minus. \- produces the > Unix command‐line option dash in the output. “-” is a > hyphen in the roff language; some output devices replace it >

Re: Hyphens in man pages

2023-10-15 Thread G. Branden Robinson
Hi Wookey, At 2023-10-15T16:08:32+0100, Wookey wrote: > OK. So I read all that, and learned a whole load of stuff I was quite > happy not knowing about. > > However despite reading it all, and especially this bit: > > Whenever I've maintained man pages in roff I tend to be precise in > > the

Re: Hyphens in man pages

2023-10-15 Thread Johannes Schauer Marin Rodrigues
Hi, Quoting Gioele Barabucci (2023-10-15 17:59:32) > On 15/10/23 17:33, 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

Re: Hyphens in man pages

2023-10-15 Thread Russ Allbery
Wookey writes: > I was left not actually know what - and \- represent, nor which one I > _should_ be using in my man pages. And that seems to be the one thing we > should be telling the 'average maintainer'. - turns into a real hyphen (­, U+2010). \- turns into the ASCII hyphen-minus that we

Re: Hyphens in man pages

2023-10-15 Thread Gioele Barabucci
On 15/10/23 17:33, 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. Another option for the

Re: Hyphens in man pages

2023-10-15 Thread Andreas Metzler
On 2023-10-15 Wookey wrote: [...] > OK. So I read all that, and learned a whole load of stuff I was quite > happy not knowing about. > However despite reading it all, and especially this bit: > "Whenever I've maintained man pages in roff I tend to be precise in > > the usage of - and \-, but TBH

Re: Hyphens in man pages

2023-10-15 Thread Iustin Pop
On 2023-10-15 16:08:32, Wookey wrote: > I think you can consider me representative of the typical maintainer > who's intereaction with *roff languages almost entirely takes the > form: 'Oh bloody hell I really ought to write a man page for this > because upstream is too youthful to have done so -

Re: Hyphens in man pages

2023-10-15 Thread Wookey
On 2023-10-15 01:30 -0500, G. Branden Robinson wrote: > At 2023-10-14T20:51:27-0600, Antonio Russo wrote: > > Quick background: in the context of Unix usage as documented by > nroff/troff, the dash used at the shell prompt, in text editors, and in > programming language source code is a "minus

Re: Hyphens in man pages

2023-10-15 Thread G. Branden Robinson
At 2023-10-14T20:51:27-0600, Antonio Russo wrote: > I discovered a new pet peeve today: if you search for a command in a > manual page, say -e in man 1 zgrep, it's a crapshot whether just > searching for '-e' will find the command or not. The reason is that > "-" may been accidentally encoded as

Re: Hyphens in man pages

2023-10-15 Thread Jochen Sprickerhof
Hi Antonio, this is discussed in: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1052675 Cheers Jochen signature.asc Description: PGP signature