← Back to branch summary

~noskcaj/ubuntu/saucy/debhelper/saucy

« back to all changes in this revision

Viewing changes to dh_installmanpages

  • Committer: Bazaar Package Importer
  • Author(s): أحمد المحمودي (Ahmed El-Mahmoudy)
  • Date: 2011-02-07 17:16:49 UTC
  • mfrom: (1.4.21 sid)
  • Revision ID: james.westby@ubuntu.com-20110207171649-v8k6uowavom83cxt
Tags: 8.1.0ubuntu1
https://launchpad.net/bugs/714705
* Merge with Debian (LP: #714705); remaining changes:
  - dh_installinit: Add --upstart-only and --onlyscripts-upstart modes.
  - Add various autoscripts for above: postinst-upstart,
    postinst-upstart-replace, postinst-upstart-restart,
    prerm-upstart, prerm-upstart-norestart, preinst-removeconffile.
  - dh_installudev: Change default init.d symlink priority to 40.
  - dh_installchangelogs: Do not install upstream changelog in compat level
    7. This floods packages with huge upstream changelogs which take
    precious CD space.
  - dh_strip, dh_makeshlibs: use triplet-objdump, triplet-objcopy and
    triplet-strip from cross-binutils when cross-compiling; Debian #412118.
  - add dh_apparmor and autoscripts
  - debian/rules: override build target to set executable bit for
    dh_apparmor before actually running dh build, that is in order to get
    the manpage built for dh_apparmor.

Show diffs side-by-side

added added

removed removed

Lines of Context:
dh_installmanpages
12
12
 
13
13
=head1 SYNOPSIS
14
14
 
15
 
B<dh_installmanpages> [S<I<debhelper options>>] [S<I<file ...>>]
 
15
B<dh_installmanpages> [S<I<debhelper options>>] [S<I<file> ...>]
16
16
 
17
17
=head1 DESCRIPTION
18
18
 
19
 
dh_installmanpages is a debhelper program that is responsible for
20
 
automatically installing man pages into usr/share/man/
 
19
B<dh_installmanpages> is a debhelper program that is responsible for
 
20
automatically installing man pages into F<usr/share/man/>
21
21
in package build directories.
22
22
 
23
23
This is a DWIM-style program, with an interface unlike the rest of
24
24
debhelper. It is deprecated, and you are encouraged to use
25
25
L<dh_installman(1)> instead.
26
26
 
27
 
dh_installmanpages scans the current directory and all subdirectories for
 
27
B<dh_installmanpages> scans the current directory and all subdirectories for
28
28
filenames that look like man pages. (Note that only real files are looked
29
29
at; symlinks are ignored.) It uses L<file(1)> to verify that the files are
30
30
in the correct format. Then, based on the files' extensions, it installs 
31
31
them into the correct man directory.
32
32
 
33
 
All filenames specified as parameters will be skipped by dh_installmanpages.
 
33
All filenames specified as parameters will be skipped by B<dh_installmanpages>.
34
34
This is useful if by default it installs some man pages that you do not
35
35
want to be installed.
36
36
 
37
 
After the man page installation step, dh_installmanpages will check to see
38
 
if any of the man pages are ".so" links. If so, it changes them to symlinks.
 
37
After the man page installation step, B<dh_installmanpages> will check to see
 
38
if any of the man pages are F<.so> links. If so, it changes them to symlinks.
39
39
 
40
40
=head1 OPTIONS
41
41
 
42
42
=over 4
43
43
 
44
 
=item I<file ...>
 
44
=item I<file> ...
45
45
 
46
46
Do not install these files as man pages, even if they look like valid man
47
47
pages.
50
50
 
51
51
=head1 BUGS
52
52
 
53
 
dh_installmanpages will install the man pages it finds into B<all> packages
 
53
B<dh_installmanpages> will install the man pages it finds into B<all> packages
54
54
you tell it to act on, since it can't tell what package the man
55
 
pages belong in. This is almost never what you really want (use -p to work
 
55
pages belong in. This is almost never what you really want (use B<-p> to work
56
56
around this, or use the much better L<dh_installman(1)> program instead).
57
57
 
58
 
Files ending in I<.man> will be ignored.
 
58
Files ending in F<.man> will be ignored.
59
59
 
60
60
Files specified as parameters that contain spaces in their filenames will
61
61
not be processed properly.