[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Creating symlinks to manpages

On Mon, Feb 11, 2013 at 03:18:20PM +0400, Игорь Пашев wrote:
> The thing I concern it that I need to know exact file name for link target.
> If I write foo.1m in d/XXX.manpages, it results in foo.1M.gz (with
> capital M) in a package.

There is, as far as I can see, no code in dh_installman that forces the
section to upper-case.  I think you have misidentified the cause.  You
can use the DH_VERBOSE=1 environment variable to see exactly what
debhelper is doing.

In general I do not think that needing to know this kind of thing for
the link target is a problem.  We've already established that you do not
need to concern yourself with compression provided that you run dh_link
before dh_compress, and sections rarely change so it's easy to just
write them into your .manpages file.

> Is there any handy way to "link" manpages? That is I could just write
> "`bar` is described in `foo`". I know about .so, but looks urgly because
> debhelper finally replaces it with symlink :-)

Any file format for this needs to involve explicitly stating the
section, because it's perfectly valid and possible for the same manual
page name to exist in multiple sections even in the same package (for
example, the po4a package ships both po4a(1) and po4a(7)).  The current
dh_link format seems fine to me for this.  If having to maintain it
bothers you, you can always encourage upstream to install the proper
symlinks in whatever their equivalent of 'make install' is.

Colin Watson                                       [cjwatson@debian.org]

Reply to: