Re: x-to-1

2023-02-11 Thread Reuben Thomas
On Sat, 11 Feb 2023 at 09:05, Bruno Haible wrote: > The package name doesn't change that often. (Although, for 'recode', it > already changed 3 times: recode → GNU recode → Free recode → recode.) > It may just be me, but I've renamed packages myself often enough, and then failed to find particul

Re: x-to-1

2023-02-11 Thread Bruno Haible
Reuben Thomas wrote: > it avoids repeating the name of the package. The package name doesn't change that often. (Although, for 'recode', it already changed 3 times: recode → GNU recode → Free recode → recode.) Bruno

Re: x-to-1

2023-02-11 Thread Reuben Thomas
On Sat, 11 Feb 2023 at 08:48, Bruno Haible wrote: > I got the impression that without a .x file, the NAME section of the output > is too silly. > > This is correct, but although (as you observe) this means that some documentation goes in the Makefile.am, it avoids repeating the name of the packag

Re: x-to-1

2023-02-11 Thread Bruno Haible
Reuben Thomas wrote: > There's one final thing that would be useful for > recode: to make the .x file optional. Recode (unlike all the other programs > I use with help2man) does not need any extra information. I tried simply > creating an empty .x file, but help2man gives an error. I got the impre

Re: x-to-1

2023-02-10 Thread Reuben Thomas
On Thu, 9 Feb 2023 at 02:49, Bruno Haible wrote: > > > > In general, then, it would be good if x-to-1 ignored unknown options and > > passed them to help2man; would that be possible? > > Passing down additional options to help2man is a very good idea; > implemented > below. Ignoring unknown optio

Re: x-to-1

2023-02-08 Thread Bruno Haible
Reuben Thomas wrote: > 1. Before, I passed --locale=en_US.UTF-8 so I could use non-ASCII > characters in my man pages directly. The --version output of recode > mentions the original author's name, François Pinard. I guess I can get > around that with a manual AUTHOR section that uses a \*['] seque

Re: x-to-1

2023-02-08 Thread Bruno Haible
Reuben Thomas wrote: > It would be good to document that x-to-1 needs CROSS_COMPILING and PERL set > up by configure.ac. Or perhaps it's worth a gnulib module? Good point. I think putting these tests into a Gnulib module 'x-to-1' would not be the right approach, because - there are several ways