Re: [PATCH] Improve man page headers

[Colin Watson]

On Wed, Jun 09, 2010 at 10:31:26PM +0200, Vladimir 'φ-coder/phcoder' Serbinenko 
wrote:
> On 06/08/2010 08:26 PM, Colin Watson wrote:
> > On Tue, Jun 08, 2010 at 07:58:57PM +0200, Grégoire Sutre wrote:
> >> In a recent message sent to the list [1], I proposed the following
> >> modification [2] to account for filename transformations in man pages:
> >>
> >> +  * Makefile.in (install-local): Use installed files on help2man command
> >> +  line to account for file name transformations.
> >>
> >>
> >> -    $(HELP2MAN) --section=1 -o $(DESTDIR)$(mandir)/man1/$$dest.1  
> >> $(builddir)/$$file; \
> >> +    $(HELP2MAN) --section=1 -o $(DESTDIR)$(mandir)/man1/$$dest.1  
> >> $(DESTDIR)$(bindir)/$$dest; \
> >>
> >>
> >> Could your approach also support filename transformations?
> >
> > I'm not sure how that would work.  I guess you'd need
> > program_transform_name applied to the .h2m files.  Do you want me to put
> > my patch in a bzr branch so that you can experiment with that?  I'm not
> > sure I have time right now.
> 
> I think it's not worth it. At least FreeBSD when packaging GNU coreutils
> add 'g' prefix to tools but didn't change the manuals. Perhaps we should
> just leave both man pages and info manual as they are and let the distro
> care if they have a different policy.

I think this is probably fair enough for now.  If it becomes a problem,
I'm sure it won't be too hard to fix.

I've gone ahead and committed this.

Thanks,

-- 
Colin Watson                                       address@hidden