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

Wed May 31 18:53:55 UTC 2017

This bug was fixed in the package debhelper - 10.4ubuntu1

---------------
debhelper (10.4ubuntu1) artful; urgency=medium

  * Merge from Debian unstable.  Remaining changes:
    - dh_installchangelogs: Do not install upstream changelog in compat
      level 7. This floods packages with huge upstream changelogs which
      are unnecessary on an installed system.
    - Restore maintainer ability to override ddeb compression
    - Generate ddebs from debhelper instead of pkg-create-dbgsym
      + Make debhelper Conflict/Replace pkg-create-dbgsym to force it off.
      + Mirror udeb code in dh_builddeb to allow us to alter file extension.
      + Set dbgsym Package-Type to ddeb to get correct debian/files output.
      + Depend on dpkg-dev (>= 1.18.23ubuntu3) so the above works correctly.

debhelper (10.4) experimental; urgency=medium

  * Team upload.

  [ Niels Thykier ]
  * meson.pm: Pass --wrap-mode=nodownload to meson (requires meson
    0.40-1 or later).
  * dh_install: Fix initialized warning when --sourcedir is absent
    on the cmd-line.
  * dh_missing: Accept --sourcedir (given it is passed by dh_install).
    (Closes: #862049)
  * Dh_Lib.pm: Fix a bug in pkgfile that caused dh to skip helpers
    that had configuration files.  Thanks to Michael Biebl for finding
    and reporting.  (Closes: #863387)

  [ Chris Lamb ]
  * dh_fixperms: Fix regression where dh_fixperms would fail to correct
    permissions because it used an invalid find expression.
    (Closes: #862003)

debhelper (10.3) experimental; urgency=medium

  [ Helmut Grohne ]
  * Supply PKG_CONFIG for cross compilation with the makefile buildsystem.
    (Closes: #853881)
  * Disable stripping during dh_auto_* in makefile buildsystem in compat 11.
    (Closes: #844077)
  * Remove explicit "Multi-Arch: no" stanzas as they are auto-rejected.
    (Closes: #857028)

  [ Niels Thykier ]
  * Dh_Lib.pm: Make getpackages() produce the correct result independently
    of the order of the fields in a given paragraph of debian/control.
    (Closes: #847138)
  * dh_installman: Report installed manpages so the new dh_missing tool
    is informed about them.
  * dh_install: Deprecate --list-missing/--fail-missing in favor of the
    new dh_missing tool.  The options will be removed in compat 11.
  * dh: Run dh_missing by default (in no op mode).
  * dh_prep: Clean up generated files so they work like other temporary
    debhelper files.
  * dh_installinit: Clarify that it might make sense to skip dh_installinit
    for a package if it provides a systemd service but no sysvinit file.
    (Closes: #800043)
  * dh_installinit: Deprecate --no-restart-on-upgrade in favor of the new
    name --no-stop-on-upgrade, which does the same thing but is less
    likely to be confused with --no-restart-after-upgrade and is more
    descriptive of what it actually does.  Thanks to  Simon McVittie and
    Michael Biebl for the help.  (Closes: #837528)
  * debian/rules: Only apply the --no-parallel to dh_auto_test.  The rest
    of debhelper's build appears to work fine with --parallel.
  * dh_systemd_enable.1: Clarify that --no-enable does not control
    whether a service is started and that dh_systemd_start is the tool
    that does that.  (Closes: #770281)
  * autoconf.pm: Set --runstatedir to "/run" in compat 11.  Thanks to
    Michael Biebl for the suggestion.
  * dh_fixperms: Refactor to reduce the constant overhead a bit and
    extract some patterns into data list.  The latter hopefully reducing
    the need for tweaking dh_fixperms' logic.
  * dh_installdocs: Document that --link-doc has limitations on source and
    target package plus that compat 10 will reject unsupported
    combinations.
  * dh_gencontrol: Avoid adding Homepage fields to dbgsym packages.  Avoids
    non-overridable warnings from lintian when there is an issue in the
    homepage field of the original binary.  (Closes: #812248)
  * dh_strip: Fix a check that could cause dh_strip to generate dbgsym
    packages when it should not.
  * dh: Stop loading python-support in all compat levels as dh_pysupport
    has been removed in stretch.
  * python_support.pm: Remove the content with a deprecation warning as
    the module can no longer do anything.
  * dh_installman.1: Improve the manpage to clarify the scope of
    dh_installman and provide an examples.  (Closes: LP: #184156)
  * makefile.pm: Disable parallel installation if libtool is present to
    avoid a race-condition in automake when using libtool.
    (Closes: #861627)

  [ Steven Chamberlain ]
  * When cross-compiling for GNU/kFreeBSD host systems, set
    CMAKE_SYSTEM_NAME to the correct value "kFreeBSD", not "FreeBSD".
    (Closes: #856688)

  [ Felipe Sateler ]
  * dh_systemd_enable.1: Improve the wording of the documentation for
    the --no-enable option.  (Closes: #844602)

  [ Michael Biebl ]
  * Add support for meson + ninja build systems.  (Closes: #795253)

  [ Michael Stapelberg ]
  * dh_missing: New tool to handle --list-missing/--fail-missing.
    (Closes: #415396, #616070)
  * Dh_Lib.pm: Introduce a log_installed_files sub that can be used
    to inform dh_missing that a given file has been installed.

  [ Johannes Schauer ]
  * dh_link.1: Improve the documentation and use ln(1) as a reference
    to make it simpler for people, who are used to the terms from ln.
    (Closes: #860091)

 -- Iain Lane <iain at orangesquash.org.uk>  Wed, 31 May 2017 15:31:00
+0100

** Changed in: debhelper (Ubuntu)
       Status: Confirmed => Fix Released

-- 
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:
  Fix Released

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