Re: [groff] [PATCH] man7/mdoc_samples.7: srcfix: Avoid a warning about a wrong section

2019-02-27 Thread G. Branden Robinson
At 2019-02-27T10:09:44+0100, Michael Kerrisk (man-pages) wrote: > Bjarni, > > On 2/16/19 7:03 PM, Bjarni Ingi Gislason wrote: > > Usage: .Rv -std in sections 2 and 3 only (#1672) > > > > The output from "nroff" and "groff" is unchanged > > Can you please elaborate on what the problem problem i

Re: [groff] [PATCH] man7/mdoc_samples.7: srcfix: Avoid a warning about a wrong section

2019-02-27 Thread Ingo Schwarze
Hello Micheal, dear colleagues, G. Branden Robinson wrote on Wed, Feb 27, 2019 at 08:48:50PM +1100: > At 2019-02-27T10:09:44+0100, Michael Kerrisk (man-pages) wrote: >> On 2/16/19 7:03 PM, Bjarni Ingi Gislason wrote: >>> Usage: .Rv -std in sections 2 and 3 only (#1672) >>> The output from "nrof

Re: [groff] [PATCH] man7/mdoc_samples.7: srcfix: Avoid a warning about a wrong section

2019-02-27 Thread Michael Kerrisk (man-pages)
Hello Branden, On Wed, 27 Feb 2019 at 10:48, G. Branden Robinson wrote: > > At 2019-02-27T10:09:44+0100, Michael Kerrisk (man-pages) wrote: > > Bjarni, > > > > On 2/16/19 7:03 PM, Bjarni Ingi Gislason wrote: > > > Usage: .Rv -std in sections 2 and 3 only (#1672) > > > > > > The output from "nrof

Re: [groff] [PATCH] man7/mdoc_samples.7: srcfix: Avoid a warning about a wrong section

2019-02-27 Thread G. Branden Robinson
At 2019-02-27T13:37:46+0100, Michael Kerrisk (man-pages) wrote: > So, summary: should I apply Bjarni's patch? Or does this lead to > back-compatibility problems? For maximum back-compatibility, you'd leave all of the string defines (.ds requests) active and uncommented. Zooming out a little bit,

Re: [groff] [PATCH] man7/mdoc_samples.7: srcfix: Avoid a warning about a wrong section

2019-02-27 Thread Michael Kerrisk (man-pages)
Hello Ingo, Thank you for your very detailed mail. I'll leave aside the history of people's interactions, and cut to the chase at the end of this mail... [...] > The two actual problems are both within the Linux man-pages project, > not within groff: > > 1. While back in the early 1990ies, Cyn

Re: [groff] [PATCH] man7/mdoc_samples.7: srcfix: Avoid a warning about a wrong section

2019-02-27 Thread Michael Kerrisk (man-pages)
> Or, as Ingo suggested, drop the page altogether. Exactly. Thanks, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Re: [groff] [PATCH] man7/mdoc_samples.7: srcfix: Avoid a warning about a wrong section

2019-02-27 Thread G. Branden Robinson
At 2019-02-27T13:34:29+0100, Ingo Schwarze wrote: > > as those are part of the interface of a macro package, > > I think this phrase invites a misunderstanding. With a library or > macro package, the term "interface" is usually understood as "user > interface" or "API", i.e. what application prog

Re: [groff] [PATCH] man7/mdoc_samples.7: srcfix: Avoid a warning about a wrong section

2019-02-27 Thread Ingo Schwarze
Hi Michael, Michael Kerrisk (man-pages) wrote on Wed, Feb 27, 2019 at 03:28:19PM +0100: > I am *not at all* attached to keeping to these pages. Their > presence in the project has always felt a bit anomalous to me. > > Back when I took over maintainership in 2004, there were a small > number of