[Bug 184156] Re: man page of dh_installman incomplete for newbie

[Tim Landscheidt]

I was looking for information on how to specify man pages for multiple
binary packages installed by "make install", and the man page for
dh_installman (and this bug report) was not helpful.  It took me trial
and error (and a look at dh_installman's source) to find out that you
need to specify:

| debian/tmp/usr/share/man/man1/jstart.1
| debian/tmp/usr/share/man/man1/jstop.1
| debian/tmp/usr/share/man/man1/jsub.1

This was (very) counterintuitive, as for example *.install lists files
as:

| usr/bin/job
| usr/bin/jstart
| usr/bin/jstop
| usr/bin/jsub
| usr/bin/qcronsub

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to debhelper in Ubuntu.
https://bugs.launchpad.net/bugs/184156

Title:
  man page of dh_installman incomplete for newbie

Status in “debhelper” package in Ubuntu:
  Confirmed

Bug description:
  Today I had to use dh_installman for the first time, so I looked at
  its man page. The man page explains what it does, but the information
  about how to use it is missing. The following information would have
  been useful in my case (Fortunately, somebody in irc gave it to me;
  googling was not very helpful) :

  <Example of missing info>
  You can use dh_installman in the following way: 
  - create a file called yourpackagename.manpages in the debian directory 
  - for each man page to install, add a line of the form "debian/manpagename" (without quotes) to the yourpackagename.manpages file
  - put each man page to install by dh_installman into the debian directory 
  <end of example of missing info>

  The actual manpage talkes about  debian/package.manpages (=
  yourpackagename.manpages from my example), but it does not explain how
  to add the man pages to it, nor in what directory to store the man
  pages.

  Finally, I wonder whether similar dh_* helpers lack the same
  information.

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/debhelper/+bug/184156/+subscriptions