Re: All caps .TH page title

2022-07-22 Thread Alejandro Colomar (man-pages)
On 7/22/22 04:14, G. Branden Robinson wrote: At least, _Exit(2) and _exit(2) point to the same page. nan(3) and NAN(3) don't, though! Pretty gross. A useful counterexample of good practice, though. We can't blame the writers, since the identifiers have those names in C. Luckily, man(1)

Re: All caps .TH page title

2022-07-22 Thread Douglas McIlroy
Changing the .TH case convention throughout the Unix world is about as futile an effort as English spelling reform. Doing it for groff-related man pages only would simply brand groff as quirky. At least the current convention has the virtue of simplicity. A convention of matching the case of comma

Re: All caps .TH page title

2022-07-22 Thread Alejandro Colomar
Hi, On 7/22/22 12:35, Alejandro Colomar (man-pages) wrote: BTW, I think I didn't reply (or if I did was very short) to your comment that other languages may find it difficult to mirror our use of subsections, since their main section is already a subsection (e.g., 3pl).  I'd say that since C i

Re: All caps .TH page title

2022-07-22 Thread G. Branden Robinson
Hi Doug, At 2022-07-22T07:36:03-0400, Douglas McIlroy wrote: > Changing the .TH case convention throughout the Unix world is about as > futile an effort as English spelling reform. I love a challenge. > Doing it for groff-related man pages only would simply brand groff as > quirky. True, but on

Re: All caps .TH page title

2022-07-22 Thread Ingo Schwarze
Hi, Colin Watson wrote on Fri, Jul 22, 2022 at 01:22:57AM +0100: > man-db doesn't index on the .TH section at all, and I don't believe > I've encountered the practice of doing so in other indexers > (I could be wrong, but I think that's something I would have > remembered if I'd noticed it). FWI

[PATCH] NULL.3def: Add documentation for NULL

2022-07-22 Thread Alejandro Colomar
Reported-by: "G. Branden Robinson" Signed-off-by: Alejandro Colomar --- Hi all! As hinted in recent mails to groff@ and linux-man@, I'm going to inaugurate a new [sub]section for constants. I think it should contain constants, normally represented by object-like macros in C. But it should als

Re: All caps .TH page title

2022-07-22 Thread Alejandro Colomar
Hi Branden, Doug, On 7/22/22 14:48, G. Branden Robinson wrote: Hi Doug, At 2022-07-22T07:36:03-0400, Douglas McIlroy wrote: Changing the .TH case convention throughout the Unix world is about as futile an effort as English spelling reform. I love a challenge. Doing it for groff-related man

Re: All caps .TH page title

2022-07-22 Thread G. Branden Robinson
Hi Alex, At 2022-07-22T13:46:37+0200, Alejandro Colomar wrote: > On 7/22/22 12:35, Alejandro Colomar (man-pages) wrote: > > BTW, I think I didn't reply (or if I did was very short) to your > > comment that other languages may find it difficult to mirror our use > > of subsections, since their main

a new intro(1) (was: All caps .TH page title)

2022-07-22 Thread G. Branden Robinson
Hi Alex, At 2022-07-22T20:31:08+0200, Alejandro Colomar wrote: > On 7/22/22 14:48, G. Branden Robinson wrote: > > intro(x) pages are sorely neglected these days, a sad situation. > > > > A couple of years ago someone on this list proposed a revised > > intro(1), which people on this list found to

Re: Is it possible to detect `grotty -i` at runtime?

2022-07-22 Thread Dave Kemper
The root problem seems to be that troff is sort of wishy-washy about the distinction between underlining and italics, regarding one as a fallback for the other rather than the two as distinct operations. http://savannah.gnu.org/bugs/?57462 seeks to address this, though no one has yet volunteered to

learn(1) (was: a new intro(1) (was: All caps .TH page title))

2022-07-22 Thread Alejandro Colomar
Hi Branden, On 7/22/22 23:04, G. Branden Robinson wrote: At 2022-07-22T20:31:08+0200, Alejandro Colomar wrote: Also, now that we speak about these things... I've always wondered what happened to learn(1). It's a program mentioned[1] in UNIX for Beginners [2nd ed.; K.], that doesn't seem to ex

Re: All caps .TH page title

2022-07-22 Thread Alejandro Colomar
Hi Branden, On 7/22/22 21:03, G. Branden Robinson wrote: Hi Alex, At 2022-07-22T13:46:37+0200, Alejandro Colomar wrote: On 7/22/22 12:35, Alejandro Colomar (man-pages) wrote: BTW, I think I didn't reply (or if I did was very short) to your comment that other languages may find it difficult to

man(7) DS and DE macros (was: [PATCH 4/5] tm.3type: describe tm_zone, tm_gmtoff)

2022-07-22 Thread G. Branden Robinson
[dropped наб from CC list; added groff@] At 2022-07-22T12:57:53+0200, Alejandro Colomar (man-pages) wrote: > You answered all that I thought you would, and even more. As always, > you surprise me with great knowledge that I didn't even know I could > ask for, and that's the main reason I tend to

tbl(1) minor issues

2022-07-22 Thread Alejandro Colomar
Hi Branden, I'm reading tbl(1), so I'll report a few (minor issues) I found: Within: [ Region options The line immediately following the .TS token may specify region options: keywords that influence the interpreta‐ tion or rendering of the region as a whole or all t

Re: warning on mid-input line sentence endings (was: Warn on semantic newlines)

2022-07-22 Thread Dave Kemper
On 7/17/22, G. Branden Robinson wrote: > I'm having trouble thinking of single other example that needs > to operate at the level of the formatter as this one does. Hmm... does the USER care what level it's operating at? Should the user interface for this low-level diagnostic look basically like

Re: man(7) DS and DE macros (was: [PATCH 4/5] tm.3type: describe tm_zone, tm_gmtoff)

2022-07-22 Thread Alejandro Colomar
Hi Branden, On 7/23/22 00:20, G. Branden Robinson wrote: [dropped наб from CC list; added groff@] At 2022-07-22T12:57:53+0200, Alejandro Colomar (man-pages) wrote: You answered all that I thought you would, and even more. As always, you surprise me with great knowledge that I didn't even know

Re: learn(1) (was: a new intro(1) (was: All caps .TH page title))

2022-07-22 Thread Larry McVoy
That tarball is not how it should be done, it unpacks in . Should unpack in learn/ Just a FYI. On Fri, Jul 22, 2022 at 11:43:37PM +0200, Alejandro Colomar wrote: > Hi Branden, > > On 7/22/22 23:04, G. Branden Robinson wrote: > >At 2022-07-22T20:31:08+0200, Alejandro Colomar wrote: > >>Also, now

Re: man(7) DS and DE macros (was: [PATCH 4/5] tm.3type: describe tm_zone, tm_gmtoff)

2022-07-22 Thread G. Branden Robinson
Hi Alex, At 2022-07-23T01:47:40+0200, Alejandro Colomar wrote: > On 7/23/22 00:20, G. Branden Robinson wrote: > > No indeed. My Logitech thumb-operated trackball hates me, as does > > the company--they don't even sell a corded version anymore. Due to > > some diabolical collusion with the alkali

Re: tbl(1) minor issues

2022-07-22 Thread G. Branden Robinson
Hi Alex, At 2022-07-23T01:08:18+0200, Alejandro Colomar wrote: > I'm reading tbl(1), so I'll report a few (minor issues) I found: Thank you; I appreciate the review. Yours is the first it's gotten since I rewrote it. > [ >spaces, or tabs. (AT&T tbl accepted only options with >