`\c`, mdoc(7), and man(7) extension macros (was: [PATCH 1/2] man*/: srcfix)

2023-10-26 Thread G. Branden Robinson
Hi Alex, At 2023-10-25T21:38:59+0200, Alejandro Colomar wrote: > On Wed, Oct 25, 2023 at 01:54:24PM -0500, G. Branden Robinson wrote: > > diff --git a/man2/open.2 b/man2/open.2 > > index 4c921723c..6603dfdff 100644 > > --- a/man2/open.2 > > +++ b/man2/open.2 > > @@ -82,8 +82,13 @@ .SH DESCRIPTION

Re: `\c`, mdoc(7), and man(7) extension macros (was: [PATCH 1/2] man*/: srcfix)

2023-10-26 Thread Alejandro Colomar
Hi Branden, On Thu, Oct 26, 2023 at 07:58:35AM -0500, G. Branden Robinson wrote: [...] > > And mdoc _does_ manage to make `\c` > almost(?) totally unnecessary--at the cost of a weighty internal > recursive macro reprocessing system that no other *roff package is known > to implement. > > (This i

Re: 1.23 prints some strange error

2023-10-26 Thread G. Branden Robinson
At 2023-10-25T16:20:27+0200, Walter Alejandro Iglesias wrote: > What you did above is not the step by step way I posted to reproduce > the bug. Of course it won't be helpful if you overlook it. You've already gotten what I would have thought to be a sufficient explanation of the diagnostic messag

Why does man(7) have 3 paragraph macros for the same thing? (was: `\c`, mdoc(7), and man(7) extension macros)

2023-10-26 Thread G. Branden Robinson
At 2023-10-26T16:12:36+0200, Alejandro Colomar wrote: > Regarding PP, LP, and P, what's the history of them? Why do we have > the 3? I'm willing to reduce them to just one. I invite Doug McIlroy to go on record, but my surmise is that they were introduced as crutches for people already familiar

Re: Why does man(7) have 3 paragraph macros for the same thing? (was: `\c`, mdoc(7), and man(7) extension macros)

2023-10-26 Thread Alejandro Colomar
Hi Branden, On Thu, Oct 26, 2023 at 09:51:40AM -0500, G. Branden Robinson wrote: > At 2023-10-26T16:12:36+0200, Alejandro Colomar wrote: > > Regarding PP, LP, and P, what's the history of them? Why do we have > > the 3? I'm willing to reduce them to just one. > > I invite Doug McIlroy to go on

Re: 1.23 prints some strange error

2023-10-26 Thread Walter Alejandro Iglesias
On Thu, Oct 26, 2023 at 09:35:07AM -0500, G. Branden Robinson wrote: > At 2023-10-25T16:20:27+0200, Walter Alejandro Iglesias wrote: > > What you did above is not the step by step way I posted to reproduce > > the bug. Of course it won't be helpful if you overlook it. > > You've already gotten wh

Re: Why does man(7) have 3 paragraph macros for the same thing? (was: `\c`, mdoc(7), and man(7) extension macros)

2023-10-26 Thread G. Branden Robinson
At 2023-10-26T16:58:13+0200, Alejandro Colomar wrote: > On Thu, Oct 26, 2023 at 09:51:40AM -0500, G. Branden Robinson wrote: > > At 2023-10-26T16:12:36+0200, Alejandro Colomar wrote: > > > Regarding PP, LP, and P, what's the history of them? Why do we > > > have the 3? I'm willing to reduce them

Re: 1.23 prints some strange error

2023-10-26 Thread G. Branden Robinson
Hi Walter, At 2023-10-26T17:21:21+0200, Walter Alejandro Iglesias wrote: > Ah, now I understand where's the problem, as it happens to me, groff > 1.22.4 also ingores what you're explaining. For me, the output doesn't change, but groff 1.22.4 doesn't emit a diagnostic. But that's not a surprise.

Re: Why does man(7) have 3 paragraph macros for the same thing? (was: `\c`, mdoc(7), and man(7) extension macros)

2023-10-26 Thread G. Branden Robinson
[self-correcting follow-up] At 2023-10-26T09:51:42-0500, G. Branden Robinson wrote: > In ms(7), `LP` sets a paragraph that is left-aligned, and `PP` sets > one with a first-line indentation. > > In man(7), all (ordinary) paragraphs behave analogously to ms(7)'s > `PP`. A first-line indentation i

Re: mandoc -man -Thtml bug: inconsistent vertical space before .TP

2023-10-26 Thread Ingo Schwarze
Hi Branden and Alejandro, G. Branden Robinson wrote on Tue, Oct 24, 2023 at 04:54:21AM -0500: > At 2023-10-24T02:13:34+0200, Ingo Schwarze wrote: >> 5. On top of all that, i have a hard time to think of any macro >> that has a more wicked failure mode than .TQ in case the >> formatter do

Re: Why does man(7) have 3 paragraph macros for the same thing?

2023-10-26 Thread Ingo Schwarze
Hi Branden and Alejandro, G. Branden Robinson wrote on Thu, Oct 26, 2023 at 10:28:13AM -0500: > At 2023-10-26T16:58:13+0200, Alejandro Colomar wrote: >> On Thu, Oct 26, 2023 at 09:51:40AM -0500, G. Branden Robinson wrote: >>> At 2023-10-26T16:12:36+0200, Alejandro Colomar wrote: Regarding PP

Re: Why does man(7) have 3 paragraph macros for the same thing? (was: `\c`, mdoc(7), and man(7) extension macros)

2023-10-26 Thread Alejandro Colomar
Hi Branden, On Thu, Oct 26, 2023 at 11:09:23AM -0500, G. Branden Robinson wrote: > [self-correcting follow-up] > > At 2023-10-26T09:51:42-0500, G. Branden Robinson wrote: > > In ms(7), `LP` sets a paragraph that is left-aligned, and `PP` sets > > one with a first-line indentation. > > > > In man

Re: Why does man(7) have 3 paragraph macros for the same thing? (was: `\c`, mdoc(7), and man(7) extension macros)

2023-10-26 Thread Alejandro Colomar
Hi Branden, On Thu, Oct 26, 2023 at 10:28:13AM -0500, G. Branden Robinson wrote: > At 2023-10-26T16:58:13+0200, Alejandro Colomar wrote: > > On Thu, Oct 26, 2023 at 09:51:40AM -0500, G. Branden Robinson wrote: > > > At 2023-10-26T16:12:36+0200, Alejandro Colomar wrote: > > > > Regarding PP, LP, an

Re: Why does man(7) have 3 paragraph macros for the same thing?

2023-10-26 Thread Alejandro Colomar
Hi Ingo, On Thu, Oct 26, 2023 at 07:52:13PM +0200, Ingo Schwarze wrote: > > I consider this a bikeshed discussion. Sure. But someone has to design the bike parkings. I find a lot awful bike parkings that harm bike's wheels, and have to park it in a sign or tree nearby. > > Given that Branden

Re: mandoc -man -Thtml bug: inconsistent vertical space before .TP

2023-10-26 Thread Alejandro Colomar
On Thu, Oct 26, 2023 at 06:37:58PM +0200, Ingo Schwarze wrote: > That is completely true, and my point 5 is completely bogus. This is > embarrassing, in particular since it also tainted the commit message. > I'm not completely sure how the wrong idea entered my head, possibly by > confusing .TP an

Re: `\c`, mdoc(7), and man(7) extension macros (was: [PATCH 1/2] man*/: srcfix)

2023-10-26 Thread Ingo Schwarze
Hi Branden and Alejandro, G. Branden Robinson wrote on Thu, Oct 26, 2023 at 07:58:35AM -0500: > At 2023-10-25T21:38:59+0200, Alejandro Colomar wrote: >> On Wed, Oct 25, 2023 at 01:54:24PM -0500, G. Branden Robinson wrote: >>> diff --git a/man2/open.2 b/man2/open.2 >>> index 4c921723c..6603dfdff 1

Re: `\c`, mdoc(7), and man(7) extension macros (was: [PATCH 1/2] man*/: srcfix)

2023-10-26 Thread Alejandro Colomar
Hi Ingo, [...ingoring the battle in which I don't want to participate...] [My position here is that man(7) has problems, but I fear that jumping to mdoc(7) *may* be worse; I can't know before jumping, which is a problem. Maybe if some pages are added written in mdoc(7), I get used to it and start