Re: All caps .TH page title

2022-08-04 Thread Alejandro Colomar
Hi, On 8/2/22 22:10, DJ Chase wrote: Would this work: OUTPUT="$(mandoc -Tlint || true)" OUTPUT="$(printf %s\\n "$OUTPUT" | sed '/reg/ex/d')" if [ "$OUTPUT" ]; then printf %s\\n "$OUTPUT" exit 1 fi Yes, something like that is wh

Re: All caps .TH page title

2022-08-02 Thread DJ Chase
On Tue Aug 2, 2022 at 12:19 PM EDT, Alejandro Colomar wrote: > On 8/2/22 17:51, DJ Chase wrote: > > You could swap mandoc’s stderr and stdout, then filter it with sed and > > redirect sed to stderr: > > > > mandoc -W 3>&2 2>&1 1>&3 | sed '/reg/ex/d' >&2 > > > > Of course if mandoc also norma

Re: All caps .TH page title

2022-08-02 Thread Alejandro Colomar
Hi DJ Chase, On 8/2/22 17:51, DJ Chase wrote: On Tue Aug 2, 2022 at 5:55 AM EDT, Alejandro Colomar wrote: The thing is that I'm running mandoc(1) from a Makefile, which means that not only stdout/stderr is important, but also the exit status. There's no trivial way to ignore mandoc(1)'s error c

Re: All caps .TH page title

2022-08-02 Thread Alejandro Colomar
Hi Ingo, On 8/2/22 14:55, Ingo Schwarze wrote: Hi Alejandro, Alejandro Colomar wrote on Tue, Aug 02, 2022 at 12:58:41AM +0200: Would you mind disabling the following warning?: mandoc: man3type/regex_t.3type:7:5: STYLE: lower case character in document title: TH regex_t Yes. [...] Good.

Re: All caps .TH page title

2022-08-02 Thread DJ Chase
On Tue Aug 2, 2022 at 5:55 AM EDT, Alejandro Colomar wrote: > The thing is that I'm running mandoc(1) from a Makefile, which means > that not only stdout/stderr is important, but also the exit status. > There's no trivial way to ignore mandoc(1)'s error code for certain > warnings. Also, I run

Re: All caps .TH page title

2022-08-02 Thread Ingo Schwarze
Hi Alejandro, Alejandro Colomar wrote on Tue, Aug 02, 2022 at 12:58:41AM +0200: > Would you mind disabling the following warning?: > > mandoc: man3type/regex_t.3type:7:5: STYLE: lower case character > in document title: TH regex_t Yes. Deleting that style recommendation is definitely one of th

Re: All caps .TH page title

2022-08-02 Thread Alejandro Colomar
Hi Bjarni, On 8/2/22 02:13, Bjarni Ingi Gislason wrote: It is simpler to use a filter, like #!/bin/dash mandoc -T lint $* | sed -e '/cannot parse date, using it verbatim:/d' \ -e '/empty block: UR$/d' \ -e '/: \.so is fragile, better use ln/,+3 d' \ -e '/: ignoring macro in table: /d' \ -e

Re: All caps .TH page title

2022-08-01 Thread Bjarni Ingi Gislason
On Tue, Aug 02, 2022 at 12:58:41AM +0200, Alejandro Colomar wrote: >[...] > Would you mind disabling the following warning?: > > mandoc: man3type/regex_t.3type:7:5: STYLE: lower case character in document > title: TH regex_t > > :) > > Also, may I make you reconsider allowing one to disable spe

Re: All caps .TH page title

2022-08-01 Thread Alejandro Colomar
Hi Ingo, On 7/23/22 20:37, Ingo Schwarze wrote: Hi Doug, G. Branden Robinson wrote on Fri, Jul 22, 2022 at 07:48:21AM -0500: 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

Re: All caps .TH page title

2022-07-27 Thread Ingo Schwarze
Hi Branden, G. Branden Robinson wrote on Sun, Jul 24, 2022 at 10:44:47AM -0500: > At 2022-07-24T16:57:19+0200, Ingo Schwarze wrote: >> But dismissing decade-old *BSD standards like the use of /usr/ for the >> base system and /usr/local/ for packages as a standard violation, and >> promoting /opt/

Re: All caps .TH page title

2022-07-24 Thread G. Branden Robinson
At 2022-07-24T16:57:19+0200, Ingo Schwarze wrote: > But dismissing decade-old *BSD standards like the use of /usr/ for the > base system and /usr/local/ for packages as a standard violation, and > promoting /opt/ which is firmly a Linux-only invention, Oh, no it's not. I remember that thing from

Re: All caps .TH page title

2022-07-24 Thread Ingo Schwarze
Hi Alejandro, Alejandro Colomar wrote on Sun, Jul 24, 2022 at 01:20:46PM +0200: > On 7/23/22 21:29, Ingo Schwarze 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 diff

Re: All caps .TH page title

2022-07-24 Thread Alejandro Colomar (mailing lists)
Hi Branden and Ralph, On 7/24/22 12:25, Ralph Corderoy wrote: Hi Branden, Do you think I should go further and warn man page authors away from attempting to redefine these macros in their pages? No, I think you should go less and not change the headers and footers so as to inspire the man-pa

Re: All caps .TH page title

2022-07-24 Thread Alejandro Colomar (man-pages)
Hi Ingo, On 7/23/22 21:29, Ingo Schwarze wrote: Hi Alejandro, 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 i

Re: All caps .TH page title

2022-07-24 Thread Ralph Corderoy
Hi Branden, > Do you think I should go further and warn man page authors away from > attempting to redefine these macros in their pages? No, I think you should go less and not change the headers and footers so as to inspire the man-page author to correct the deviancy. :-) -- Cheers, Ralph.

Re: All caps .TH page title

2022-07-23 Thread Ingo Schwarze
Hi Alejandro, 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). Othe

Re: All caps .TH page title

2022-07-23 Thread Ingo Schwarze
Hi Doug, G. Branden Robinson wrote on Fri, Jul 22, 2022 at 07:48:21AM -0500: > 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. In addition to that,

Re: All caps .TH page title

2022-07-23 Thread G. Branden Robinson
At 2022-07-23T11:51:04+0100, Ralph Corderoy wrote: > > And, as I shall never cease to remind people, the man(7) `PT` and > > `BT` traps are replaceable, thanks to the efforts of Larry Kollar > > around 20 years ago. > > Are you saying a man-page author should work around groff's increasing > devia

Re: All caps .TH page title

2022-07-23 Thread G. Branden Robinson
At 2022-07-23T11:51:04+0100, Ralph Corderoy wrote: > Doug wrote: > > > Doing it for groff-related man pages only would simply brand groff > > > as quirky. > ... > > And, as I shall never cease to remind people, the man(7) `PT` and > > `BT` traps are replaceable, thanks to the efforts of Larry Kolla

Re: All caps .TH page title

2022-07-23 Thread Ralph Corderoy
Hi Branden, Doug wrote: > > Doing it for groff-related man pages only would simply brand groff > > as quirky. ... > And, as I shall never cease to remind people, the man(7) `PT` and `BT` > traps are replaceable, thanks to the efforts of Larry Kollar around 20 > years ago. Are you saying a man-pag

Re: All caps .TH page title

2022-07-23 Thread Ralph Corderoy
Hi Alejandro, Wandering off-topic... > $ find man* -type f \ >| tr '[:upper:]' '[:lower:]' \ >| sort \ >| uniq -d \ >| while read f; do > find man* -type f \ > | grep -i $f; >done; > man2/_Exit.2 > man2/_exit.2 > man3/nan.3 > man3/NAN.3 You may like to know GNU's

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

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

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 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

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 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 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 (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-21 Thread G. Branden Robinson
At 2022-07-21T20:34:39-0500, G. Branden Robinson wrote: > Ah, thanks, Colin. A quick consultation of ncurses man pages reveals > that mandb(8)'s idea of the manual section comes from its place in the > directory hierarchy, not from parsing the arguments to the `TH` call. > My error! Sorry, no, I

Re: All caps .TH page title

2022-07-21 Thread G. Branden Robinson
[Colin and Ingo dropped from CC since I know they read the groff list] Hi Alex, At 2022-07-22T01:16:49+0200, Alejandro Colomar wrote: > On 7/21/22 20:36, G. Branden Robinson wrote: > > At 2022-07-21T16:29:21+0200, Alejandro Colomar wrote: > > > I've never been convinced about the page title being

Re: All caps .TH page title

2022-07-21 Thread G. Branden Robinson
At 2022-07-22T01:22:57+0100, Colin Watson wrote: > On Fri, Jul 22, 2022 at 01:16:49AM +0200, Alejandro Colomar wrote: > > On 7/21/22 20:36, G. Branden Robinson wrote: > > > At 2022-07-21T16:29:21+0200, Alejandro Colomar wrote: > > > > Also, does it have any functional implications? I'm especially

Re: All caps .TH page title

2022-07-21 Thread Colin Watson
On Fri, Jul 22, 2022 at 01:16:49AM +0200, Alejandro Colomar wrote: > On 7/21/22 20:36, G. Branden Robinson wrote: > > At 2022-07-21T16:29:21+0200, Alejandro Colomar wrote: > > > Also, does it have any functional implications? I'm especially > > > interested in knowing if that may affect in any way

Re: All caps .TH page title

2022-07-21 Thread Alejandro Colomar
Hi Branden, On 7/21/22 20:36, G. Branden Robinson wrote: Hi Alex, At 2022-07-21T16:29:21+0200, Alejandro Colomar wrote: I've never been convinced about the page title being in all caps in the .TH line. From recent groff@ discussions, I guess that neither of you are either. Well, Ingo was mo