1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Free Software Foundation, Inc.
3 # This file is distributed under the same license as the PACKAGE package.
4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
9 "Project-Id-Version: PACKAGE VERSION\n"
10 "POT-Creation-Date: 2011-06-24 14:29-0400\n"
11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13 "Language-Team: LANGUAGE <LL@li.org>\n"
16 "Content-Type: text/plain; charset=CHARSET\n"
17 "Content-Transfer-Encoding: 8bit\n"
20 #: debhelper.pod:1 dh:3 dh_auto_build:3 dh_auto_clean:3 dh_auto_configure:3 dh_auto_install:3 dh_auto_test:3 dh_bugfiles:3 dh_builddeb:3 dh_clean:3 dh_compress:3 dh_desktop:3 dh_fixperms:3 dh_gconf:3 dh_gencontrol:3 dh_icons:3 dh_install:3 dh_installcatalogs:3 dh_installchangelogs:3 dh_installcron:3 dh_installdeb:3 dh_installdebconf:3 dh_installdirs:3 dh_installdocs:3 dh_installemacsen:3 dh_installexamples:3 dh_installifupdown:3 dh_installinfo:3 dh_installinit:3 dh_installlogcheck:3 dh_installlogrotate:3 dh_installman:3 dh_installmanpages:3 dh_installmenu:3 dh_installmime:3 dh_installmodules:3 dh_installpam:3 dh_installppp:3 dh_installudev:3 dh_installwm:3 dh_installxfonts:3 dh_link:3 dh_lintian:3 dh_listpackages:3 dh_makeshlibs:3 dh_md5sums:3 dh_movefiles:3 dh_perl:3 dh_prep:3 dh_python:3 dh_scrollkeeper:3 dh_shlibdeps:3 dh_strip:3 dh_suidregister:3 dh_testdir:3 dh_testroot:3 dh_undocumented:3 dh_usrlocal:3
26 msgid "debhelper - the debhelper tool suite"
30 #: debhelper.pod:5 dh:12 dh_auto_build:12 dh_auto_clean:13 dh_auto_configure:12 dh_auto_install:15 dh_auto_test:12 dh_bugfiles:12 dh_builddeb:12 dh_clean:12 dh_compress:13 dh_desktop:12 dh_fixperms:12 dh_gconf:12 dh_gencontrol:12 dh_icons:13 dh_install:13 dh_installcatalogs:14 dh_installchangelogs:12 dh_installcron:12 dh_installdeb:12 dh_installdebconf:12 dh_installdirs:12 dh_installdocs:12 dh_installemacsen:12 dh_installexamples:12 dh_installifupdown:12 dh_installinfo:12 dh_installinit:12 dh_installlogcheck:12 dh_installlogrotate:12 dh_installman:13 dh_installmanpages:13 dh_installmenu:12 dh_installmime:12 dh_installmodules:14 dh_installpam:12 dh_installppp:12 dh_installudev:13 dh_installwm:12 dh_installxfonts:12 dh_link:13 dh_lintian:12 dh_listpackages:12 dh_makeshlibs:12 dh_md5sums:13 dh_movefiles:12 dh_perl:14 dh_prep:12 dh_python:13 dh_scrollkeeper:12 dh_shlibdeps:13 dh_strip:13 dh_suidregister:7 dh_testdir:12 dh_testroot:7 dh_undocumented:12 dh_usrlocal:15
37 "B<dh_>I<*> [B<-v>] [B<-a>] [B<-i>] [B<-s>] [B<--no-act>] [B<-p>I<package>] "
38 "[B<-N>I<package>] [B<-P>I<tmpdir>]"
42 #: debhelper.pod:9 dh:16 dh_auto_build:16 dh_auto_clean:17 dh_auto_configure:16 dh_auto_install:19 dh_auto_test:16 dh_bugfiles:16 dh_builddeb:16 dh_clean:16 dh_compress:17 dh_desktop:16 dh_fixperms:16 dh_gconf:16 dh_gencontrol:16 dh_icons:17 dh_install:17 dh_installcatalogs:18 dh_installchangelogs:16 dh_installcron:16 dh_installdeb:16 dh_installdebconf:16 dh_installdirs:16 dh_installdocs:16 dh_installemacsen:16 dh_installexamples:16 dh_installifupdown:16 dh_installinfo:16 dh_installinit:16 dh_installlogcheck:16 dh_installlogrotate:16 dh_installman:17 dh_installmanpages:17 dh_installmenu:16 dh_installmime:16 dh_installmodules:18 dh_installpam:16 dh_installppp:16 dh_installudev:17 dh_installwm:16 dh_installxfonts:16 dh_link:17 dh_lintian:16 dh_listpackages:16 dh_makeshlibs:16 dh_md5sums:17 dh_movefiles:16 dh_perl:18 dh_prep:16 dh_python:17 dh_scrollkeeper:16 dh_shlibdeps:17 dh_strip:17 dh_suidregister:11 dh_testdir:16 dh_testroot:11 dh_undocumented:16 dh_usrlocal:19
49 "Debhelper is used to help you build a Debian package. The philosophy behind "
50 "debhelper is to provide a collection of small, simple, and easily understood "
51 "tools that are used in F<debian/rules> to automate various common aspects of "
52 "building a package. This means less work for you, the packager. It also, to "
53 "some degree means that these tools can be changed if Debian policy changes, "
54 "and packages that use them will require only a rebuild to comply with the "
61 "A typical F<debian/rules> file that uses debhelper will call several "
62 "debhelper commands in sequence, or use L<dh(1)> to automate this "
63 "process. Examples of rules files that use debhelper are in "
64 "F</usr/share/doc/debhelper/examples/>"
70 "To create a new Debian package using debhelper, you can just copy one of the "
71 "sample rules files and edit it by hand. Or you can try the B<dh-make> "
72 "package, which contains a L<dh_make|dh_make(1)> command that partially "
73 "automates the process. For a more gentle introduction, the B<maint-guide> "
74 "Debian package contains a tutorial about making your first package using "
80 msgid "DEBHELPER COMMANDS"
86 "Here is the list of debhelper commands you can use. See their man pages for "
87 "additional documentation."
97 msgid "Deprecated Commands"
102 msgid "A few debhelper commands are deprecated and should not be used."
107 msgid "#LIST_DEPRECATED#"
112 msgid "Other Commands"
118 "If a program's name starts with B<dh_>, and the program is not on the above "
119 "lists, then it is not part of the debhelper package, but it should still "
120 "work like the other programs described on this page."
125 msgid "DEBHELPER CONFIG FILES"
131 "Many debhelper commands make use of files in F<debian/> to control what they "
132 "do. Besides the common F<debian/changelog> and F<debian/control>, which are "
133 "in all packages, not just those using debhelper, some additional files can "
134 "be used to configure the behavior of specific debhelper commands. These "
135 "files are typically named debian/I<package>.foo (where I<package> of course, "
136 "is replaced with the package that is being acted on)."
142 "For example, B<dh_installdocs> uses files named F<debian/package.docs> to "
143 "list the documentation files it will install. See the man pages of "
144 "individual commands for details about the names and formats of the files "
145 "they use. Generally, these files will list files to act on, one file per "
146 "line. Some programs in debhelper use pairs of files and destinations or "
147 "slightly more complicated formats."
153 "Note that if a package is the first (or only) binary package listed in "
154 "F<debian/control>, debhelper will use F<debian/foo> if no "
155 "F<debian/package.foo> file can be found."
161 "In some rare cases, you may want to have different versions of these files "
162 "for different architectures or OSes. If files named "
163 "debian/I<package>.foo.I<ARCH> or debian/I<package>.foo.I<OS> exist, where "
164 "I<ARCH> and I<OS> are the same as the output of \"B<dpkg-architecture "
165 "-qDEB_HOST_ARCH>\" / \"B<dpkg-architecture -qDEB_HOST_ARCH_OS>\", then they "
166 "will be used in preference to other, more general files."
172 "In many cases, these config files are used to specify various types of "
173 "files. Documentation or example files to install, files to move, and so on. "
174 "When appropriate, in cases like these, you can use standard shell wildcard "
175 "characters (B<?> and B<*> and B<[>I<..>B<]> character classes) in the files."
181 "You can also put comments in these files; lines beginning with B<#> are "
187 msgid "SHARED DEBHELPER OPTIONS"
192 msgid "The following command line options are supported by all debhelper programs."
197 msgid "B<-v>, B<--verbose>"
202 msgid "Verbose mode: show all commands that modify the package build directory."
206 #: debhelper.pod:101 dh:72
213 "Do not really do anything. If used with -v, the result is that the command "
214 "will output what it would have done."
219 msgid "B<-a>, B<--arch>"
225 "Act on architecture dependent packages that should be built for the build "
231 msgid "B<-i>, B<--indep>"
236 msgid "Act on all architecture independent packages."
241 msgid "B<-p>I<package>, B<--package=>I<package>"
247 "Act on the package named I<package>. This option may be specified multiple "
248 "times to make debhelper operate on a given set of packages."
253 msgid "B<-s>, B<--same-arch>"
259 "This used to be a smarter version of the B<-a> flag, but the B<-a> flag is "
265 msgid "B<-N>I<package>, B<--no-package=>I<package>"
271 "Do not act on the specified package even if an B<-a>, B<-i>, or B<-p> option "
272 "lists the package as one that should be acted on."
277 msgid "B<--remaining-packages>"
283 "Do not act on the packages which have already been acted on by this "
284 "debhelper command earlier (i.e. if the command is present in the package "
285 "debhelper log). For example, if you need to call the command with special "
286 "options only for a couple of binary packages, pass this option to the last "
287 "call of the command to process the rest of packages with default settings."
292 msgid "B<--ignore=>I<file>"
298 "Ignore the specified file. This can be used if F<debian/> contains a "
299 "debhelper config file that a debhelper command should not act on. Note that "
300 "F<debian/compat>, F<debian/control>, and F<debian/changelog> can't be "
301 "ignored, but then, there should never be a reason to ignore those files."
307 "For example, if upstream ships a F<debian/init> that you don't want "
308 "B<dh_installinit> to install, use B<--ignore=debian/init>"
313 msgid "B<-P>I<tmpdir>, B<--tmpdir=>I<tmpdir>"
318 msgid "Use I<tmpdir> for package build directory. The default is debian/I<package>"
323 msgid "B<--mainpackage=>I<package>"
329 "This little-used option changes the package which debhelper considers the "
330 "\"main package\", that is, the first one listed in F<debian/control>, and "
331 "the one for which F<debian/foo> files can be used instead of the usual "
332 "F<debian/package.foo> files."
337 msgid "B<-O=>I<option>|I<bundle>"
343 "This is used by L<dh(1)> when passing user-specified options to all the "
344 "commands it runs. If the command supports the specified option or option "
345 "bundle, it will take effect. If the command does not support the option (or "
346 "any part of an option bundle), it will be ignored."
351 msgid "COMMON DEBHELPER OPTIONS"
357 "The following command line options are supported by some debhelper "
358 "programs. See the man page of each program for a complete explanation of "
359 "what each option does."
369 msgid "Do not modify F<postinst>, F<postrm>, etc. scripts."
373 #: debhelper.pod:180 dh_compress:52 dh_install:76 dh_installchangelogs:68 dh_installdocs:75 dh_installexamples:41 dh_link:60 dh_makeshlibs:81 dh_md5sums:37 dh_shlibdeps:30 dh_strip:39
374 msgid "B<-X>I<item>, B<--exclude=>I<item>"
380 "Exclude an item from processing. This option may be used multiple times, to "
381 "exclude more than one thing."
385 #: debhelper.pod:185 dh_bugfiles:54 dh_compress:59 dh_installdirs:35 dh_installdocs:70 dh_installexamples:36 dh_installinfo:35 dh_installman:64 dh_link:55
386 msgid "B<-A>, B<--all>"
392 "Makes files or other items that are specified on the command line take "
393 "effect in ALL packages acted on, not just the first."
398 msgid "BUILD SYSTEM OPTIONS"
404 "All of the B<dh_auto_>I<*> debhelper programs sets environment variables "
405 "listed by B<dpkg-buildflags>, unless they are already set. They support "
406 "DEB_BUILD_OPTIONS=noopt too."
412 "The following command line options are supported by all of the "
413 "B<dh_auto_>I<*> debhelper programs. These programs support a variety of "
414 "build systems, and normally heuristically determine which to use, and how to "
415 "use them. You can use these command line options to override the default "
421 msgid "B<-S>I<buildsystem>, B<--buildsystem=>I<buildsystem>"
427 "Force use of the specified I<buildsystem>, instead of trying to auto-select "
428 "one which might be applicable for the package."
433 msgid "B<-D>I<directory>, B<--sourcedirectory=>I<directory>"
439 "Assume that the original package source tree is at the specified "
440 "I<directory> rather than the top level directory of the Debian source "
446 msgid "B<-B>[I<directory>], B<--builddirectory=>[I<directory>]"
452 "Enable out of source building and use the specified I<directory> as the "
453 "build directory. If I<directory> parameter is omitted, a default build "
454 "directory will chosen."
460 "If this option is not specified, building will be done in source by default "
461 "unless the build system requires or prefers out of source tree building. In "
462 "such a case, the default build directory will be used even if "
463 "B<--builddirectory> is not specified."
469 "If the build system prefers out of source tree building but still allows in "
470 "source building, the latter can be re-enabled by passing a build directory "
471 "path that is the same as the source directory path."
476 msgid "B<--parallel>"
482 "Enable parallel builds if underlying build system supports them. The number "
483 "of parallel jobs is controlled by the B<DEB_BUILD_OPTIONS> environment "
484 "variable (L<Debian Policy, section 4.9.1>) at build time. It might also be "
485 "subject to a build system specific limit."
491 "If this option is not specified, debhelper currently defaults to not "
492 "allowing parallel package builds."
497 msgid "B<--max-parallel=>I<maximum>"
503 "This option implies B<--parallel> and allows further limiting the number of "
504 "jobs that can be used in a parallel build. If the package build is known to "
505 "only work with certain levels of concurrency, you can set this to the "
506 "maximum level that is known to work, or that you wish to support."
510 #: debhelper.pod:248 dh:52
511 msgid "B<--list>, B<-l>"
517 "List all build systems supported by debhelper on this system. The list "
518 "includes both default and third party build systems (marked as such). Also "
519 "shows which build system would be automatically selected, or which one is "
520 "manually specified with the B<--buildsystem> option."
524 #: debhelper.pod:257 dh_auto_test:44 dh_installcatalogs:59 dh_installdocs:116 dh_installemacsen:67 dh_installexamples:53 dh_installinit:133 dh_installman:81 dh_installmime:51 dh_installmodules:60 dh_installudev:55 dh_installwm:54 dh_installxfonts:37 dh_movefiles:64 dh_strip:68 dh_usrlocal:49
530 msgid "Multiple binary package support"
536 "If your source package generates more than one binary package, debhelper "
537 "programs will default to acting on all binary packages when run. If your "
538 "source package happens to generate one architecture dependent package, and "
539 "another architecture independent package, this is not the correct behavior, "
540 "because you need to generate the architecture dependent packages in the "
541 "binary-arch F<debian/rules> target, and the architecture independent "
542 "packages in the binary-indep F<debian/rules> target."
548 "To facilitate this, as well as give you more control over which packages are "
549 "acted on by debhelper programs, all debhelper programs accept the B<-a>, "
550 "B<-i>, B<-p>, and B<-s> parameters. These parameters are cumulative. If "
551 "none are given, debhelper programs default to acting on all packages listed "
552 "in the control file."
557 msgid "Automatic generation of Debian install scripts"
563 "Some debhelper commands will automatically generate parts of Debian "
564 "maintainer scripts. If you want these automatically generated things "
565 "included in your existing Debian maintainer scripts, then you need to add "
566 "B<#DEBHELPER#> to your scripts, in the place the code should be added. "
567 "B<#DEBHELPER#> will be replaced by any auto-generated code when you run "
574 "If a script does not exist at all and debhelper needs to add something to "
575 "it, then debhelper will create the complete script."
581 "All debhelper commands that automatically generate code in this way let it "
582 "be disabled by the -n parameter (see above)."
588 "Note that the inserted code will be shell code, so you cannot directly use "
589 "it in a Perl script. If you would like to embed it into a Perl script, here "
590 "is one way to do that (note that I made sure that $1, $2, etc are set with "
598 " my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n"
601 " system ($temp) / 256 == 0\n"
602 " \tor die \"Problem with debhelper scripts: $!\";\n"
608 msgid "Automatic generation of miscellaneous dependencies."
614 "Some debhelper commands may make the generated package need to depend on "
615 "some other packages. For example, if you use L<dh_installdebconf(1)>, your "
616 "package will generally need to depend on debconf. Or if you use "
617 "L<dh_installxfonts(1)>, your package will generally need to depend on a "
618 "particular version of xutils. Keeping track of these miscellaneous "
619 "dependencies can be annoying since they are dependant on how debhelper does "
620 "things, so debhelper offers a way to automate it."
626 "All commands of this type, besides documenting what dependencies may be "
627 "needed on their man pages, will automatically generate a substvar called "
628 "B<${misc:Depends}>. If you put that token into your F<debian/control> file, "
629 "it will be expanded to the dependencies debhelper figures you need."
635 "This is entirely independent of the standard B<${shlibs:Depends}> generated "
636 "by L<dh_makeshlibs(1)>, and the B<${perl:Depends}> generated by "
637 "L<dh_perl(1)>. You can choose not to use any of these, if debhelper's "
638 "guesses don't match reality."
643 msgid "Package build directories"
649 "By default, all debhelper programs assume that the temporary directory used "
650 "for assembling the tree of files in a package is debian/I<package>."
656 "Sometimes, you might want to use some other temporary directory. This is "
657 "supported by the B<-P> flag. For example, \"B<dh_installdocs "
658 "-Pdebian/tmp>\", will use B<debian/tmp> as the temporary directory. Note "
659 "that if you use B<-P>, the debhelper programs can only be acting on a single "
660 "package at a time. So if you have a package that builds many binary "
661 "packages, you will need to also use the B<-p> flag to specify which binary "
662 "package the debhelper program will act on."
667 msgid "Debhelper compatibility levels"
673 "From time to time, major non-backwards-compatible changes need to be made to "
674 "debhelper, to keep it clean and well-designed as needs change and its author "
675 "gains more experience. To prevent such major changes from breaking existing "
676 "packages, the concept of debhelper compatibility levels was introduced. You "
677 "tell debhelper which compatibility level it should use, and it modifies its "
678 "behavior in various ways."
684 "Tell debhelper what compatibility level to use by writing a number to "
685 "F<debian/compat>. For example, to turn on v8 mode:"
692 " % echo 8 > debian/compat\n"
699 "Unless otherwise indicated, all debhelper documentation assumes that you are "
700 "using the most recent compatibility level, and in most cases does not "
701 "indicate if the behavior is different in an earlier compatibility level, so "
702 "if you are not using the most recent compatibility level, you're advised to "
703 "read below for notes about what is different in earlier compatibility "
709 msgid "These are the available compatibility levels:"
720 "This is the original debhelper compatibility level, and so it is the default "
721 "one. In this mode, debhelper will use F<debian/tmp> as the package tree "
722 "directory for the first binary package listed in the control file, while "
723 "using debian/I<package> for all other packages listed in the F<control> "
728 #: debhelper.pod:366 debhelper.pod:373 debhelper.pod:396 debhelper.pod:425
729 msgid "This mode is deprecated."
740 "In this mode, debhelper will consistently use debian/I<package> as the "
741 "package tree directory for every package that is built."
751 msgid "This mode works like v2, with the following additions:"
755 #: debhelper.pod:381 debhelper.pod:386 debhelper.pod:390 debhelper.pod:404 debhelper.pod:409 debhelper.pod:414 debhelper.pod:419 debhelper.pod:433 debhelper.pod:437 debhelper.pod:442 debhelper.pod:446 debhelper.pod:458 debhelper.pod:463 debhelper.pod:469 debhelper.pod:475 debhelper.pod:488 debhelper.pod:495 debhelper.pod:499 debhelper.pod:503 debhelper.pod:518 debhelper.pod:522 debhelper.pod:530 debhelper.pod:535 debhelper.pod:549 debhelper.pod:554 debhelper.pod:559
762 "Debhelper config files support globbing via B<*> and B<?>, when "
763 "appropriate. To turn this off and use those characters raw, just prefix with "
770 "B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call "
777 "Every file in F<etc/> is automatically flagged as a conffile by "
788 msgid "Changes from v3 are:"
794 "B<dh_makeshlibs -V> will not include the Debian part of the version number "
795 "in the generated dependency line in the shlibs file."
801 "You are encouraged to put the new B<${misc:Depends}> into F<debian/control> "
802 "to supplement the B<${shlibs:Depends}> field."
808 "B<dh_fixperms> will make all files in F<bin/> directories and in "
809 "F<etc/init.d> executable."
814 msgid "B<dh_link> will correct existing links to conform with policy."
824 msgid "Changes from v4 are:"
829 msgid "Comments are ignored in debhelper config files."
835 "B<dh_strip --dbg-package> now specifies the name of a package to put "
836 "debugging symbols in, not the packages to take the symbols from."
841 msgid "B<dh_installdocs> skips installing empty files."
846 msgid "B<dh_install> errors out if wildcards expand to nothing."
856 msgid "Changes from v5 are:"
862 "Commands that generate maintainer script fragments will order the fragments "
863 "in reverse order for the F<prerm> and F<postrm> scripts."
869 "B<dh_installwm> will install a slave manpage link for "
870 "F<x-window-manager.1.gz>, if it sees the man page in F<usr/share/man/man1> "
871 "in the package build directory."
877 "B<dh_builddeb> did not previously delete everything matching "
878 "B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as "
879 "B<CVS:.svn:.git>. Now it does."
885 "B<dh_installman> allows overwriting existing man pages in the package build "
886 "directory. In previous compatibility levels it silently refuses to do this."
896 msgid "Changes from v6 are:"
902 "B<dh_install>, will fall back to looking for files in F<debian/tmp> if it "
903 "doesn't find them in the current directory (or wherever you tell it look "
904 "using B<--sourcedir>). This allows B<dh_install> to interoperate with "
905 "B<dh_auto_install>, which installs to F<debian/tmp>, without needing any "
906 "special parameters."
911 msgid "B<dh_clean> will read F<debian/clean> and delete files listed there."
916 msgid "B<dh_clean> will delete toplevel F<*-stamp> files."
922 "B<dh_installchangelogs> will guess at what file is the upstream changelog if "
933 msgid "This is the recommended mode of operation."
938 msgid "Changes from v7 are:"
943 msgid "Commands will fail rather than warning when they are passed unknown options."
949 "B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it "
950 "generates shlibs files for. So B<-X> can be used to exclude libraries. "
951 "Also, libraries in unusual locations that B<dpkg-gensymbols> would not have "
952 "processed before will be passed to it, a behavior change that can cause some "
953 "packages to fail to build."
959 "B<dh> requires the sequence to run be specified as the first parameter, and "
960 "any switches come after it. Ie, use \"B<dh $@ --foo>\", not \"B<dh --foo "
967 "B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to "
978 msgid "This compatability level is still open for development; use with caution."
983 msgid "Changes from v8 are:"
989 "Multiarch support. In particular, B<dh_auto_configure> passes multiarch "
990 "directories to autoconf in --libdir and --libexecdir."
996 "dh supports use of standard targets in debian/rules without needing to "
997 "manually define the dependencies between targets there."
1001 #: debhelper.pod:561
1003 "<dh_auto_configure> does not include the source package name in --libexecdir "
1004 "when using autoconf."
1008 #: debhelper.pod:568
1013 #: debhelper.pod:570
1015 "Debhelper includes support for udebs. To create a udeb with debhelper, add "
1016 "\"B<Package-Type: udeb>\" to the package's stanza in F<debian/control>, and "
1017 "build-depend on debhelper (>= 4.2). Debhelper will try to create udebs that "
1018 "comply with debian-installer policy, by making the generated package files "
1019 "end in F<.udeb>, not installing any documentation into a udeb, skipping over "
1020 "F<preinst>, F<postrm>, F<prerm>, and F<config> scripts, etc."
1024 #: debhelper.pod:577
1029 #: debhelper.pod:579
1031 "In general, if any debhelper program needs a directory to exist under "
1032 "B<debian/>, it will create it. I haven't bothered to document this in all "
1033 "the man pages, but for example, B<dh_installdeb> knows to make "
1034 "debian/I<package>/DEBIAN/ before trying to put files there, "
1035 "B<dh_installmenu> knows you need a debian/I<package>/usr/share/menu/ before "
1036 "installing the menu files, etc."
1040 #: debhelper.pod:585
1042 "Once your package uses debhelper to build, be sure to add debhelper to your "
1043 "Build-Depends line in F<debian/control>. You should build-depend on a "
1044 "version of debhelper equal to (or greater than) the debhelper compatibility "
1045 "level your package uses. So if your package used compatibility level 7:"
1049 #: debhelper.pod:591
1052 " Build-Depends: debhelper (>= 7)\n"
1057 #: debhelper.pod:593
1062 #: debhelper.pod:597
1063 msgid "B<DH_VERBOSE>"
1067 #: debhelper.pod:599
1069 "Set to B<1> to enable verbose mode. Debhelper will output every command it "
1070 "runs that modifies files on the build system."
1074 #: debhelper.pod:602
1075 msgid "B<DH_COMPAT>"
1079 #: debhelper.pod:604
1081 "Temporarily specifies what compatibility level debhelper should run at, "
1082 "overriding any value in F<debian/compat>."
1086 #: debhelper.pod:607
1087 msgid "B<DH_NO_ACT>"
1091 #: debhelper.pod:609
1092 msgid "Set to B<1> to enable no-act mode."
1096 #: debhelper.pod:611
1097 msgid "B<DH_OPTIONS>"
1101 #: debhelper.pod:613
1103 "Anything in this variable will be prepended to the command line arguments of "
1104 "all debhelper commands. Command-specific options will be ignored by commands "
1105 "that do not support them."
1109 #: debhelper.pod:617
1111 "This is useful in some situations, for example, if you need to pass B<-p> to "
1112 "all debhelper commands that will be run. One good way to set B<DH_OPTIONS> "
1113 "is by using \"Target-specific Variable Values\" in your F<debian/rules> "
1114 "file. See the make documentation for details on doing this."
1118 #: debhelper.pod:622
1119 msgid "B<DH_ALWAYS_EXCLUDE>"
1123 #: debhelper.pod:624
1125 "If set, this adds the value the variable is set to to the B<-X> options of "
1126 "all commands that support the B<-X> option. Moreover, B<dh_builddeb> will "
1127 "B<rm -rf> anything that matches the value in your package build tree."
1131 #: debhelper.pod:628
1133 "This can be useful if you are doing a build from a CVS source tree, in which "
1134 "case setting B<DH_ALWAYS_EXCLUDE=CVS> will prevent any CVS directories from "
1135 "sneaking into the package you build. Or, if a package has a source tarball "
1136 "that (unwisely) includes CVS directories, you might want to export "
1137 "B<DH_ALWAYS_EXCLUDE=CVS> in F<debian/rules>, to make it take effect wherever "
1138 "your package is built."
1142 #: debhelper.pod:635
1144 "Multiple things to exclude can be separated with colons, as in "
1145 "B<DH_ALWAYS_EXCLUDE=CVS:.svn>"
1149 #: debhelper.pod:640 dh:872 dh_auto_build:47 dh_auto_clean:50 dh_auto_configure:53 dh_auto_install:85 dh_auto_test:58 dh_bugfiles:122 dh_builddeb:91 dh_clean:139 dh_compress:204 dh_desktop:31 dh_fixperms:129 dh_gconf:99 dh_gencontrol:82 dh_icons:65 dh_install:280 dh_installcatalogs:116 dh_installchangelogs:171 dh_installcron:77 dh_installdeb:144 dh_installdebconf:126 dh_installdirs:86 dh_installdocs:307 dh_installemacsen:124 dh_installexamples:106 dh_installifupdown:69 dh_installinfo:77 dh_installinit:275 dh_installlogcheck:66 dh_installlogrotate:50 dh_installman:258 dh_installmanpages:197 dh_installmenu:87 dh_installmime:95 dh_installmodules:124 dh_installpam:59 dh_installppp:65 dh_installudev:115 dh_installwm:108 dh_installxfonts:87 dh_link:226 dh_lintian:57 dh_listpackages:30 dh_makeshlibs:258 dh_md5sums:90 dh_movefiles:170 dh_perl:146 dh_prep:60 dh_python:280 dh_scrollkeeper:28 dh_shlibdeps:171 dh_strip:230 dh_suidregister:117 dh_testdir:44 dh_testroot:27 dh_undocumented:28 dh_usrlocal:114
1154 #: debhelper.pod:644
1155 msgid "F</usr/share/doc/debhelper/examples/>"
1159 #: debhelper.pod:646
1160 msgid "A set of example F<debian/rules> files that use debhelper."
1164 #: debhelper.pod:648
1165 msgid "L<http://kitenet.net/~joey/code/debhelper/>"
1169 #: debhelper.pod:650
1170 msgid "Debhelper web site."
1174 #: debhelper.pod:654 dh:878 dh_auto_build:53 dh_auto_clean:56 dh_auto_configure:59 dh_auto_install:91 dh_auto_test:64 dh_bugfiles:130 dh_builddeb:97 dh_clean:145 dh_compress:210 dh_desktop:37 dh_fixperms:135 dh_gconf:105 dh_gencontrol:88 dh_icons:71 dh_install:286 dh_installcatalogs:122 dh_installchangelogs:177 dh_installcron:83 dh_installdeb:150 dh_installdebconf:132 dh_installdirs:92 dh_installdocs:313 dh_installemacsen:130 dh_installexamples:112 dh_installifupdown:75 dh_installinfo:83 dh_installlogcheck:72 dh_installlogrotate:56 dh_installman:264 dh_installmanpages:203 dh_installmenu:95 dh_installmime:101 dh_installmodules:130 dh_installpam:65 dh_installppp:71 dh_installudev:121 dh_installwm:114 dh_installxfonts:93 dh_link:232 dh_lintian:65 dh_listpackages:36 dh_makeshlibs:264 dh_md5sums:96 dh_movefiles:176 dh_perl:152 dh_prep:66 dh_python:286 dh_scrollkeeper:34 dh_shlibdeps:177 dh_strip:236 dh_suidregister:123 dh_testdir:50 dh_testroot:33 dh_undocumented:34 dh_usrlocal:120
1179 #: debhelper.pod:656 dh:880 dh_auto_build:55 dh_auto_clean:58 dh_auto_configure:61 dh_auto_install:93 dh_auto_test:66 dh_builddeb:99 dh_clean:147 dh_compress:212 dh_fixperms:137 dh_gencontrol:90 dh_install:288 dh_installchangelogs:179 dh_installcron:85 dh_installdeb:152 dh_installdebconf:134 dh_installdirs:94 dh_installdocs:315 dh_installemacsen:132 dh_installexamples:114 dh_installifupdown:77 dh_installinfo:85 dh_installinit:283 dh_installlogrotate:58 dh_installman:266 dh_installmanpages:205 dh_installmenu:97 dh_installmime:103 dh_installmodules:132 dh_installpam:67 dh_installppp:73 dh_installudev:123 dh_installwm:116 dh_installxfonts:95 dh_link:234 dh_listpackages:38 dh_makeshlibs:266 dh_md5sums:98 dh_movefiles:178 dh_prep:68 dh_shlibdeps:179 dh_strip:238 dh_suidregister:125 dh_testdir:52 dh_testroot:35 dh_undocumented:36
1180 msgid "Joey Hess <joeyh@debian.org>"
1185 msgid "dh - debhelper command sequencer"
1191 "B<dh> I<sequence> [B<--with> I<addon>[B<,>I<addon> ...]] [B<--list>] "
1192 "[B<--until> I<cmd>] [B<--before> I<cmd>] [B<--after> I<cmd>] "
1193 "[B<--remaining>] [S<I<debhelper options>>]"
1199 "B<dh> runs a sequence of debhelper commands. The supported I<sequence>s "
1200 "correspond to the targets of a F<debian/rules> file: B<build-arch>, "
1201 "B<build-indep>, B<build>, B<clean>, B<install-indep>, B<install-arch>, "
1202 "B<install>, B<binary-arch>, B<binary-indep>, and B<binary>."
1208 "Commands in the B<build-indep>, B<install-indep> and B<binary-indep> "
1209 "sequences are passed the B<-i> option to ensure they only work on "
1210 "architecture independent packages, and commands in the B<build-arch>, "
1211 "B<install-arch> and B<binary-arch> sequences are passed the B<-a> option to "
1212 "ensure they only work on architecture dependent packages."
1218 "If F<debian/rules> contains a target with a name like "
1219 "B<override_>I<dh_command>, then when it would normally run I<dh_command>, "
1220 "B<dh> will instead call that target. The override target can then run the "
1221 "command with additional options, or run entirely different commands "
1222 "instead. See examples below. (Note that to use this feature, you should "
1223 "Build-Depend on debhelper 7.0.50 or above.)"
1227 #: dh:35 dh_auto_build:28 dh_auto_clean:30 dh_auto_configure:31 dh_auto_install:43 dh_auto_test:30 dh_bugfiles:50 dh_builddeb:21 dh_clean:41 dh_compress:48 dh_fixperms:31 dh_gconf:39 dh_gencontrol:26 dh_icons:25 dh_install:54 dh_installcatalogs:49 dh_installchangelogs:56 dh_installcron:40 dh_installdebconf:61 dh_installdirs:31 dh_installdocs:66 dh_installemacsen:48 dh_installexamples:32 dh_installifupdown:39 dh_installinfo:31 dh_installinit:48 dh_installlogrotate:22 dh_installman:60 dh_installmanpages:40 dh_installmenu:41 dh_installmime:41 dh_installmodules:44 dh_installpam:31 dh_installppp:35 dh_installudev:35 dh_installwm:34 dh_link:51 dh_makeshlibs:43 dh_md5sums:28 dh_movefiles:38 dh_perl:31 dh_prep:26 dh_python:39 dh_shlibdeps:26 dh_strip:35 dh_testdir:23 dh_usrlocal:39
1233 msgid "B<--with> I<addon>[B<,>I<addon> ...]"
1239 "Add the debhelper commands specified by the given addon to appropriate "
1240 "places in the sequence of commands that is run. This option can be repeated "
1241 "more than once, or multiple addons can be listed, separated by commas. This "
1242 "is used when there is a third-party package that provides debhelper "
1243 "commands. See the F<PROGRAMMING> file for documentation about the sequence "
1249 msgid "B<--without> I<addon>"
1254 msgid "The inverse of B<--with>, disables using the given addon."
1259 msgid "List all available addons."
1264 msgid "B<--until> I<cmd>"
1269 msgid "Run commands in the sequence until and including I<cmd>, then stop."
1274 msgid "B<--before> I<cmd>"
1279 msgid "Run commands in the sequence before I<cmd>, then stop."
1284 msgid "B<--after> I<cmd>"
1289 msgid "Run commands in the sequence that come after I<cmd>."
1294 msgid "B<--remaining>"
1299 msgid "Run all commands in the sequence that have yet to be run."
1304 msgid "Prints commands that would run for a given sequence, but does not run them."
1310 "All other options passed to B<dh> are passed on to each command it "
1311 "runs. This can be used to set an option like B<-v> or B<-X> or B<-N>, as "
1312 "well as for more specialised options."
1318 "In the above options, I<cmd> can be a full name of a debhelper command, or a "
1319 "substring. It'll first search for a command in the sequence exactly matching "
1320 "the name, to avoid any ambiguity. If there are multiple substring matches, "
1321 "the last one in the sequence will be used."
1325 #: dh:113 dh_installdocs:105 dh_link:73 dh_makeshlibs:97 dh_shlibdeps:69
1332 "To see what commands are included in a sequence, without actually doing "
1340 "\tdh binary-arch --no-act\n"
1347 "This is a very simple rules file, for packages where the default sequences "
1348 "of commands work with no additional options."
1352 #: dh:123 dh:130 dh:144 dh:157
1355 "\t#!/usr/bin/make -f\n"
1365 "Often you'll want to pass an option to a specific debhelper command. The\n"
1366 "easy way to do with is by adding an override target for that command.\n"
1374 "\toverride_dh_strip:\n"
1375 "\t\tdh_strip -Xfoo\n"
1383 "\toverride_dh_installdocs:\n"
1384 "\t\tdh_installdocs README TODO\n"
1391 "Sometimes the automated L<dh_auto_configure(1)> and L<dh_auto_build(1)> "
1392 "can't guess what to do for a strange package. Here's how to avoid running "
1393 "either and instead run your own commands."
1400 "\toverride_dh_auto_configure:\n"
1401 "\t\t./mondoconfig\n"
1409 "\toverride_dh_auto_build:\n"
1410 "\t\tmake universe-explode-in-delight\n"
1417 "Another common case is wanting to do something manually before or after a "
1418 "particular debhelper command is run."
1425 "\toverride_dh_fixperms:\n"
1427 "\t\tchmod 4755 debian/foo/usr/bin/foo\n"
1434 "If your package is a Python package, B<dh> will use B<dh_pysupport> by "
1435 "default. This is how to use B<dh_pycentral> instead."
1442 "\t#!/usr/bin/make -f\n"
1444 "\t\tdh $@ --with python-central\n"
1451 "If your package uses autotools and you want to freshen F<config.sub> and "
1452 "F<config.guess> with newer versions from the B<autotools-dev> package at "
1453 "build time, you can use some commands provided in B<autotools-dev> that "
1454 "automate it, like this."
1461 "\t#!/usr/bin/make -f\n"
1463 "\t\tdh $@ --with autotools_dev\n"
1470 "Here is how to force use of Perl's B<Module::Build> build system, which can "
1471 "be necessary if debhelper wrongly detects that the package uses MakeMaker."
1478 "\t#!/usr/bin/make -f\n"
1480 "\t\tdh $@ --buildsystem=perl_build\n"
1488 "To patch your package using quilt, you can tell B<dh> to use quilt's B<dh>\n"
1489 "sequence addons like this:\n"
1497 "\t#!/usr/bin/make -f\n"
1499 "\t\tdh $@ --with quilt\n"
1506 "Here is an example of overriding where the B<dh_auto_>I<*> commands find the "
1507 "package's source, for a package where the source is located in a "
1515 "\t#!/usr/bin/make -f\n"
1517 "\t\tdh $@ --sourcedirectory=src\n"
1524 "And here is an example of how to tell the B<dh_auto_>I<*> commands to build "
1525 "in a subdirectory, which will be removed on B<clean>."
1532 "\t#!/usr/bin/make -f\n"
1534 "\t\tdh $@ --builddirectory=build\n"
1541 "If your package can be built in parallel, you can support parallel building "
1542 "as follows. Then B<dpkg-buildpackage -j> will work."
1549 "\t#!/usr/bin/make -f\n"
1551 "\t\tdh $@ --parallel\n"
1558 "Here is a way to prevent B<dh> from running several commands that you don't "
1559 "want it to run, by defining empty override targets for each command."
1563 #: dh:221 dh:232 dh:249
1566 "\t#!/usr/bin/make -f\n"
1576 "\t# Commands not to run:\n"
1577 "\toverride_dh_auto_test override_dh_compress override_dh_fixperms:\n"
1584 "Sometimes, you may need to make an override target only run commands when a "
1585 "particular package is being built. This can be accomplished using "
1586 "L<dh_listpackages(1)> to test what is being built. For example:"
1593 "\toverride_dh_fixperms:\n"
1595 "\tifneq (,$(filter foo, $(shell dh_listpackages)))\n"
1596 "\t\tchmod 4755 debian/foo/usr/bin/foo\n"
1604 "Finally, remember that you are not limited to using override targets in the "
1605 "rules file when using B<dh>. You can also explicitly define any of the "
1606 "regular rules file targets when it makes sense to do so. A common reason to "
1607 "do this is when your package needs different B<build-arch> and "
1608 "B<build-indep> targets. For example, a package with a long document build "
1609 "process can put it in B<build-indep>."
1617 "\t\t$(MAKE) docs\n"
1619 "\t\t$(MAKE) bins\n"
1626 "Note that in the example above, dh will arrange for \"debian/rules build\" "
1627 "to call your build-indep and build-arch targets. You do not need to "
1628 "explicitly define the dependencies in the rules file when using dh with "
1629 "compatability level v9. This example would be more complicated with earlier "
1630 "compatability levels."
1641 "If you're curious about B<dh>'s internals, here's how it works under the "
1648 "Each debhelper command will record when it's successfully run in "
1649 "F<debian/package.debhelper.log>. (Which B<dh_clean> deletes.) So B<dh> can "
1650 "tell which commands have already been run, for which packages, and skip "
1651 "running those commands again."
1657 "Each time B<dh> is run, it examines the log, and finds the last logged "
1658 "command that is in the specified sequence. It then continues with the next "
1659 "command in the sequence. The B<--until>, B<--before>, B<--after>, and "
1660 "B<--remaining> options can override this behavior."
1666 "A sequence can also run dependent targets in debian/rules. For example, the "
1667 "\"binary\" sequence runs the \"install\" target."
1673 "B<dh> sets environment variables listed by B<dpkg-buildflags>, unless they "
1674 "are already set. It supports DEB_BUILD_OPTIONS=noopt too."
1680 "B<dh> uses the B<DH_INTERNAL_OPTIONS> environment variable to pass "
1681 "information through to debhelper commands that are run inside override "
1682 "targets. The contents (and indeed, existence) of this environment variable, "
1683 "as the name might suggest, is subject to change at any time."
1687 #: dh:874 dh_auto_build:49 dh_auto_clean:52 dh_auto_configure:55 dh_auto_install:87 dh_auto_test:60 dh_builddeb:93 dh_clean:141 dh_compress:206 dh_fixperms:131 dh_gconf:101 dh_gencontrol:84 dh_install:282 dh_installcatalogs:118 dh_installchangelogs:173 dh_installcron:79 dh_installdeb:146 dh_installdebconf:128 dh_installdirs:88 dh_installdocs:309 dh_installemacsen:126 dh_installexamples:108 dh_installifupdown:71 dh_installinfo:79 dh_installinit:277 dh_installlogcheck:68 dh_installlogrotate:52 dh_installman:260 dh_installmanpages:199 dh_installmime:97 dh_installmodules:126 dh_installpam:61 dh_installppp:67 dh_installudev:117 dh_installwm:110 dh_installxfonts:89 dh_link:228 dh_listpackages:32 dh_makeshlibs:260 dh_md5sums:92 dh_movefiles:172 dh_perl:148 dh_prep:62 dh_python:282 dh_strip:232 dh_suidregister:119 dh_testdir:46 dh_testroot:29 dh_undocumented:30 dh_usrlocal:116
1688 msgid "L<debhelper(7)>"
1692 #: dh:876 dh_auto_build:51 dh_auto_clean:54 dh_auto_configure:57 dh_auto_install:89 dh_auto_test:62 dh_bugfiles:128 dh_builddeb:95 dh_clean:143 dh_compress:208 dh_desktop:35 dh_fixperms:133 dh_gconf:103 dh_gencontrol:86 dh_icons:69 dh_install:284 dh_installchangelogs:175 dh_installcron:81 dh_installdeb:148 dh_installdebconf:130 dh_installdirs:90 dh_installdocs:311 dh_installemacsen:128 dh_installexamples:110 dh_installifupdown:73 dh_installinfo:81 dh_installinit:279 dh_installlogrotate:54 dh_installman:262 dh_installmanpages:201 dh_installmenu:93 dh_installmime:99 dh_installmodules:128 dh_installpam:63 dh_installppp:69 dh_installudev:119 dh_installwm:112 dh_installxfonts:91 dh_link:230 dh_lintian:61 dh_listpackages:34 dh_makeshlibs:262 dh_md5sums:94 dh_movefiles:174 dh_perl:150 dh_prep:64 dh_python:284 dh_scrollkeeper:32 dh_shlibdeps:175 dh_strip:234 dh_suidregister:121 dh_testdir:48 dh_testroot:31 dh_undocumented:32 dh_usrlocal:118
1693 msgid "This program is a part of debhelper."
1698 msgid "dh_auto_build - automatically builds a package"
1704 "B<dh_auto_build> [S<I<build system options>>] [S<I<debhelper options>>] "
1705 "[S<B<--> I<params>>]"
1711 "B<dh_auto_build> is a debhelper program that tries to automatically build a "
1712 "package. It does so by running the appropriate command for the build system "
1713 "it detects the package uses. For example, if a F<Makefile> is found, this is "
1714 "done by running B<make> (or B<MAKE>, if the environment variable is set). If "
1715 "there's a F<setup.py>, or F<Build.PL>, it is run to build the package."
1721 "This is intended to work for about 90% of packages. If it doesn't work, "
1722 "you're encouraged to skip using B<dh_auto_build> at all, and just run the "
1723 "build process manually."
1727 #: dh_auto_build:30 dh_auto_clean:32 dh_auto_configure:33 dh_auto_install:45 dh_auto_test:32
1729 "See L<debhelper(7)/B<BUILD SYSTEM OPTIONS>> for a list of common build "
1730 "system selection and control options."
1734 #: dh_auto_build:35 dh_auto_clean:37 dh_auto_configure:38 dh_auto_install:56 dh_auto_test:37 dh_builddeb:35 dh_gencontrol:30 dh_installdebconf:69 dh_installinit:99 dh_makeshlibs:91 dh_shlibdeps:37
1735 msgid "B<--> I<params>"
1741 "Pass I<params> to the program that is run. These can be used to supplement "
1742 "or override any standard parameters that B<dh_auto_build> passes."
1747 msgid "dh_auto_clean - automatically cleans up after a build"
1753 "B<dh_auto_clean> [S<I<build system options>>] [S<I<debhelper options>>] "
1754 "[S<B<--> I<params>>]"
1760 "B<dh_auto_clean> is a debhelper program that tries to automatically clean up "
1761 "after a package build. It does so by running the appropriate command for the "
1762 "build system it detects the package uses. For example, if there's a "
1763 "F<Makefile> and it contains a B<distclean>, B<realclean>, or B<clean> "
1764 "target, then this is done by running B<make> (or B<MAKE>, if the environment "
1765 "variable is set). If there is a F<setup.py> or F<Build.PL>, it is run to "
1766 "clean the package."
1772 "This is intended to work for about 90% of packages. If it doesn't work, or "
1773 "tries to use the wrong clean target, you're encouraged to skip using "
1774 "B<dh_auto_clean> at all, and just run B<make clean> manually."
1780 "Pass I<params> to the program that is run. These can be used to supplement "
1781 "or override the any standard parameters that B<dh_auto_clean> passes."
1785 #: dh_auto_configure:5
1786 msgid "dh_auto_configure - automatically configure a package prior to building"
1790 #: dh_auto_configure:14
1792 "B<dh_auto_configure> [S<I<build system options>>] [S<I<debhelper options>>] "
1793 "[S<B<--> I<params>>]"
1797 #: dh_auto_configure:18
1799 "B<dh_auto_configure> is a debhelper program that tries to automatically "
1800 "configure a package prior to building. It does so by running the appropriate "
1801 "command for the build system it detects the package uses. For example, it "
1802 "looks for and runs a F<./configure> script, F<Makefile.PL>, F<Build.PL>, or "
1803 "F<cmake>. A standard set of parameters is determined and passed to the "
1804 "program that is run. Some build systems, such as make, do not need a "
1805 "configure step; for these B<dh_auto_configure> will exit without doing "
1810 #: dh_auto_configure:27
1812 "This is intended to work for about 90% of packages. If it doesn't work, "
1813 "you're encouraged to skip using B<dh_auto_configure> at all, and just run "
1814 "F<./configure> or its equivalent manually."
1818 #: dh_auto_configure:40
1820 "Pass I<params> to the program that is run, after the standard parameters "
1821 "that B<dh_auto_configure> passes. This can be used to supplement or override "
1822 "those parameters. For example:"
1826 #: dh_auto_configure:44
1829 " dh_auto_configure -- --with-foo --enable-bar\n"
1834 #: dh_auto_install:5
1835 msgid "dh_auto_install - automatically runs make install or similar"
1839 #: dh_auto_install:17
1841 "B<dh_auto_install> [S<I<build system options>>] [S<I<debhelper options>>] "
1842 "[S<B<--> I<params>>]"
1846 #: dh_auto_install:21
1848 "B<dh_auto_install> is a debhelper program that tries to automatically "
1849 "install built files. It does so by running the appropriate command for the "
1850 "build system it detects the package uses. For example, if there's a "
1851 "F<Makefile> and it contains a B<install> target, then this is done by "
1852 "running B<make> (or B<MAKE>, if the environment variable is set). If there "
1853 "is a F<setup.py> or F<Build.PL>, it is used. Note that the Ant build system "
1854 "does not support installation, so B<dh_auto_install> will not install files "
1859 #: dh_auto_install:29
1861 "Unless B<--destdir> option is specified, the files are installed into "
1862 "debian/I<package>/ if there is only one binary package. In the multiple "
1863 "binary package case, the files are instead installed into F<debian/tmp/>, "
1864 "and should be moved from there to the appropriate package build directory "
1865 "using L<dh_install(1)>."
1869 #: dh_auto_install:35
1871 "B<DESTDIR> is used to tell make where to install the files. If the Makefile "
1872 "was generated by MakeMaker from a F<Makefile.PL>, it will automatically set "
1873 "B<PREFIX=/usr> too, since such Makefiles need that."
1877 #: dh_auto_install:39
1879 "This is intended to work for about 90% of packages. If it doesn't work, or "
1880 "tries to use the wrong install target, you're encouraged to skip using "
1881 "B<dh_auto_install> at all, and just run make install manually."
1885 #: dh_auto_install:50 dh_builddeb:25
1886 msgid "B<--destdir=>I<directory>"
1890 #: dh_auto_install:52
1892 "Install files into the specified I<directory>. If this option is not "
1893 "specified, destination directory is determined automatically as described in "
1894 "the L</B<DESCRIPTION>> section."
1898 #: dh_auto_install:58
1900 "Pass I<params> to the program that is run. These can be used to supplement "
1901 "or override the any standard parameters that B<dh_auto_install> passes."
1906 msgid "dh_auto_test - automatically runs a package's test suites"
1912 "B<dh_auto_test> [S<I<build system options>>] [S<I<debhelper options>>] "
1913 "[S<B<--> I<params>>]"
1919 "B<dh_auto_test> is a debhelper program that tries to automatically run a "
1920 "package's test suite. It does so by running the appropriate command for the "
1921 "build system it detects the package uses. For example, if there's a Makefile "
1922 "and it contains a B<test> or B<check> target, then this is done by running "
1923 "B<make> (or B<MAKE>, if the environment variable is set). If the test suite "
1924 "fails, the command will exit nonzero. If there's no test suite, it will exit "
1925 "zero without doing anything."
1931 "This is intended to work for about 90% of packages with a test suite. If it "
1932 "doesn't work, you're encouraged to skip using B<dh_auto_test> at all, and "
1933 "just run the test suite manually."
1939 "Pass I<params> to the program that is run. These can be used to supplement "
1940 "or override the any standard parameters that B<dh_auto_test> passes."
1946 "If the B<DEB_BUILD_OPTIONS> environment variable contains B<nocheck>, no "
1947 "tests will be performed."
1953 "dh_bugfiles - install bug reporting customization files into package build "
1959 msgid "B<dh_bugfiles> [B<-A>] [S<I<debhelper options>>]"
1965 "B<dh_bugfiles> is a debhelper program that is responsible for installing bug "
1966 "reporting customization files (bug scripts and/or bug control files and/or "
1967 "presubj files) into package build directories."
1971 #: dh_bugfiles:22 dh_clean:31 dh_compress:31 dh_gconf:23 dh_install:38 dh_installcatalogs:35 dh_installchangelogs:32 dh_installcron:21 dh_installdeb:22 dh_installdebconf:34 dh_installdirs:21 dh_installdocs:21 dh_installemacsen:27 dh_installexamples:22 dh_installifupdown:22 dh_installinfo:21 dh_installinit:27 dh_installlogcheck:21 dh_installman:50 dh_installmenu:25 dh_installmime:25 dh_installmodules:29 dh_installpam:21 dh_installppp:21 dh_installudev:25 dh_installwm:24 dh_link:39 dh_lintian:21 dh_makeshlibs:29 dh_movefiles:26
1977 msgid "debian/I<package>.bug-script"
1983 "This is the script to be run by the bug reporting program for generating a "
1984 "bug report template. This file is installed as F<usr/share/bug/package> in "
1985 "the package build directory if no other types of bug reporting customization "
1986 "files are going to be installed for the package in question. Otherwise, this "
1987 "file is installed as F<usr/share/bug/package/script>. Finally, the installed "
1988 "script is given execute permissions."
1993 msgid "debian/I<package>.bug-control"
1999 "It is the bug control file containing some directions for the bug reporting "
2000 "tool. This file is installed as F<usr/share/bug/package/control> in the "
2001 "package build directory."
2006 msgid "debian/I<package>.bug-presubj"
2012 "The contents of this file are displayed to the user by the bug reporting "
2013 "tool before allowing the user to write a bug report on the package to the "
2014 "Debian Bug Tracking System. This file is installed as "
2015 "F<usr/share/bug/package/presubj> in the package build directory."
2021 "Install F<debian/bug-*> files to ALL packages acted on when respective "
2022 "F<debian/package.bug-*> files do not exist. Normally, F<debian/bug-*> will "
2023 "be installed to the first package only."
2028 msgid "F</usr/share/doc/reportbug/README.developers.gz>"
2032 #: dh_bugfiles:126 dh_lintian:59
2033 msgid "L<debhelper(1)>"
2038 msgid "Modestas Vainius <modestas@vainius.eu>"
2043 msgid "dh_builddeb - build Debian binary packages"
2049 "B<dh_builddeb> [S<I<debhelper options>>] [B<--destdir=>I<directory>] "
2050 "[B<--filename=>I<name>] [S<B<--> I<params>>]"
2056 "B<dh_builddeb> simply calls L<dpkg-deb(1)> to build a Debian package or "
2063 "Use this if you want the generated F<.deb> files to be put in a directory "
2064 "other than the default of \"F<..>\"."
2069 msgid "B<--filename=>I<name>"
2075 "Use this if you want to force the generated .deb file to have a particular "
2076 "file name. Does not work well if more than one .deb is generated!"
2081 msgid "Pass I<params> to L<dpkg-deb(1)> when it is used to build the package."
2086 msgid "B<-u>I<params>"
2092 "This is another way to pass I<params> to L<dpkg-deb(1)>. It is deprecated; "
2093 "use B<--> instead."
2098 msgid "dh_clean - clean up package build directories"
2104 "B<dh_clean> [S<I<debhelper options>>] [B<-k>] [B<-d>] [B<-X>I<item>] "
2112 "B<dh_clean> is a debhelper program that is responsible for cleaning up after "
2114 "package is built. It removes the package build directories, and removes "
2116 "other files including F<debian/files>, and any detritus left behind by "
2118 "debhelper commands. It also removes common files that should not appear in "
2121 " #*# *~ DEADJOE *.orig *.rej *.SUMS TAGS .deps/* *.P *-stamp\n"
2128 "It does not run \"make clean\" to clean up after the build process. Use "
2129 "L<dh_auto_clean(1)> to do things like that."
2135 "B<dh_clean> (or \"B<dh clean>\") should be the last debhelper command run in "
2136 "the B<clean> target in F<debian/rules>."
2141 msgid "F<debian/clean>"
2146 msgid "Can list other files to be removed."
2150 #: dh_clean:45 dh_installchangelogs:60
2151 msgid "B<-k>, B<--keep>"
2156 msgid "This is deprecated, use L<dh_prep(1)> instead."
2161 msgid "B<-d>, B<--dirs-only>"
2167 "Only clean the package build directories, do not clean up any other files at "
2172 #: dh_clean:54 dh_prep:30
2173 msgid "B<-X>I<item> B<--exclude=>I<item>"
2179 "Exclude files that contain I<item> anywhere in their filename from being "
2180 "deleted, even if they would normally be deleted. You may use this option "
2181 "multiple times to build up a list of things to exclude."
2185 #: dh_clean:60 dh_compress:64 dh_installdocs:98 dh_installexamples:46 dh_installinfo:40 dh_installmanpages:44 dh_movefiles:55 dh_testdir:27
2191 msgid "Delete these I<file>s too."
2196 msgid "dh_compress - compress files and fix symlinks in package build directories"
2202 "B<dh_compress> [S<I<debhelper options>>] [B<-X>I<item>] [B<-A>] [S<I<file> "
2209 "B<dh_compress> is a debhelper program that is responsible for compressing "
2210 "the files in package build directories, and makes sure that any symlinks "
2211 "that pointed to the files before they were compressed are updated to point "
2218 "By default, B<dh_compress> compresses files that Debian policy mandates "
2219 "should be compressed, namely all files in F<usr/share/info>, "
2220 "F<usr/share/man>, files in F<usr/share/doc> that are larger than 4k in size, "
2221 "(except the F<copyright> file, F<.html> and other web files, image files, "
2222 "and files that appear to be already compressed based on their extensions), "
2223 "and all F<changelog> files. Plus PCF fonts underneath "
2224 "F<usr/share/fonts/X11/>"
2229 msgid "debian/I<package>.compress"
2234 msgid "These files are deprecated."
2240 "If this file exists, the default files are not compressed. Instead, the file "
2241 "is ran as a shell script, and all filenames that the shell script outputs "
2242 "will be compressed. The shell script will be run from inside the package "
2243 "build directory. Note though that using B<-X> is a much better idea in "
2244 "general; you should only use a F<debian/package.compress> file if you really "
2251 "Exclude files that contain F<item> anywhere in their filename from being "
2252 "compressed. For example, B<-X.tiff> will exclude TIFF files from "
2253 "compression. You may use this option multiple times to build up a list of "
2254 "things to exclude."
2260 "Compress all files specified by command line parameters in ALL packages "
2266 msgid "Add these files to the list of files to compress."
2270 #: dh_compress:70 dh_perl:61 dh_python:66 dh_strip:74 dh_usrlocal:55
2276 msgid "Debian policy, version 3.0"
2281 msgid "dh_desktop - deprecated no-op"
2286 msgid "B<dh_desktop> [S<I<debhelper options>>]"
2292 "B<dh_desktop> was a debhelper program that registers F<.desktop> files. "
2293 "However, it no longer does anything, and is now deprecated."
2299 "If a package ships F<desktop> files, they just need to be installed in the "
2300 "correct location (F</usr/share/applications>) and they will be registered by "
2301 "the appropriate tools for the corresponding desktop environments."
2305 #: dh_desktop:33 dh_icons:67 dh_scrollkeeper:30
2306 msgid "L<debhelper>"
2310 #: dh_desktop:39 dh_scrollkeeper:36
2311 msgid "Ross Burton <ross@burtonini.com>"
2316 msgid "dh_fixperms - fix permissions of files in package build directories"
2321 msgid "B<dh_fixperms> [S<I<debhelper options>>] [B<-X>I<item>]"
2327 "B<dh_fixperms> is a debhelper program that is responsible for setting the "
2328 "permissions of files and directories in package build directories to a sane "
2329 "state -- a state that complies with Debian policy."
2335 "B<dh_fixperms> makes all files in F<usr/share/doc> in the package build "
2336 "directory (excluding files in the F<examples/> directory) be mode 644. It "
2337 "also changes the permissions of all man pages to mode 644. It makes all "
2338 "files be owned by root, and it removes group and other write permission from "
2339 "all files. It removes execute permissions from any libraries, headers, Perl "
2340 "modules, or desktop files that have it set. It makes all files in the "
2341 "standard F<bin> and F<sbin> directories, F<usr/games/> and F<etc/init.d> "
2342 "executable (since v4). Finally, it removes the setuid and setgid bits from "
2343 "all files in the package."
2348 msgid "B<-X>I<item>, B<--exclude> I<item>"
2354 "Exclude files that contain I<item> anywhere in their filename from having "
2355 "their permissions changed. You may use this option multiple times to build "
2356 "up a list of things to exclude."
2361 msgid "dh_gconf - install GConf defaults files and register schemas"
2366 msgid "B<dh_gconf> [S<I<debhelper options>>] [B<--priority=>I<priority>]"
2372 "B<dh_gconf> is a debhelper program that is responsible for installing GConf "
2373 "defaults files and registering GConf schemas."
2378 msgid "An appropriate dependency on gconf2 will be generated in B<${misc:Depends}>."
2383 msgid "debian/I<package>.gconf-defaults"
2389 "Installed into F<usr/share/gconf/defaults/10_package> in the package build "
2390 "directory, with I<package> replaced by the package name."
2395 msgid "debian/I<package>.gconf-mandatory"
2401 "Installed into F<usr/share/gconf/mandatory/10_package> in the package build "
2402 "directory, with I<package> replaced by the package name."
2407 msgid "B<--priority> I<priority>"
2413 "Use I<priority> (which should be a 2-digit number) as the defaults priority "
2414 "instead of B<10>. Higher values than ten can be used by derived "
2415 "distributions (B<20>), CDD distributions (B<50>), or site-specific packages "
2421 msgid "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>"
2426 msgid "dh_gencontrol - generate and install control file"
2431 msgid "B<dh_gencontrol> [S<I<debhelper options>>] [S<B<--> I<params>>]"
2437 "B<dh_gencontrol> is a debhelper program that is responsible for generating "
2438 "control files, and installing them into the I<DEBIAN> directory with the "
2439 "proper permissions."
2445 "This program is merely a wrapper around L<dpkg-gencontrol(1)>, which calls "
2446 "it once for each package being acted on, and passes in some additional "
2452 msgid "Pass I<params> to L<dpkg-gencontrol(1)>."
2457 msgid "B<-u>I<params>, B<--dpkg-gencontrol-params=>I<params>"
2463 "This is another way to pass I<params> to L<dpkg-gencontrol(1)>. It is "
2464 "deprecated; use B<--> instead."
2469 msgid "dh_icons - Update Freedesktop icon caches"
2474 msgid "B<dh_icons> [S<I<debhelper options>>] [B<-n>]"
2480 "B<dh_icons> is a debhelper program that updates Freedesktop icon caches when "
2481 "needed, using the B<update-icon-caches> program provided by GTK+2.12. "
2482 "Currently this program does not handle installation of the files, though it "
2483 "may do so at a later date. It takes care of adding maintainer script "
2484 "fragments to call B<update-icon-caches>."
2488 #: dh_icons:29 dh_installcatalogs:53 dh_installdebconf:65 dh_installemacsen:52 dh_installinit:52 dh_installmenu:45 dh_installmime:45 dh_installmodules:48 dh_installudev:49 dh_installwm:44 dh_makeshlibs:77 dh_python:60 dh_usrlocal:43
2489 msgid "B<-n>, B<--noscripts>"
2494 msgid "Do not modify maintainer scripts."
2500 "Ross Burton <ross@burtonini.com> Jordi Mallach <jordi@debian.org> Josselin "
2501 "Mouette <joss@debian.org>"
2506 msgid "dh_install - install files into package build directories"
2512 "B<dh_install> [B<-X>I<item>] [B<--autodest>] [B<--sourcedir=>I<dir>] "
2513 "[S<I<debhelper options>>] [S<I<file> ... I<dest>>]"
2519 "B<dh_install> is a debhelper program that handles installing files into "
2520 "package build directories. There are many B<dh_install>I<*> commands that "
2521 "handle installing specific types of files such as documentation, examples, "
2522 "man pages, and so on, and they should be used when possible as they often "
2523 "have extra intelligence for those particular tasks. B<dh_install>, then, is "
2524 "useful for installing everything else, for which no particular intelligence "
2525 "is needed. It is a replacement for the old B<dh_movefiles> command."
2531 "This program may be used in one of two ways. If you just have a file or two "
2532 "that the upstream Makefile does not install for you, you can run "
2533 "B<dh_install> on them to move them into place. On the other hand, maybe you "
2534 "have a large package that builds multiple binary packages. You can use the "
2535 "upstream F<Makefile> to install it all into F<debian/tmp>, and then use "
2536 "B<dh_install> to copy directories and files from there into the proper "
2537 "package build directories."
2543 "From debhelper compatibility level 7 on, B<dh_install> will fall back to "
2544 "looking in F<debian/tmp> for files, if it doesn't find them in the current "
2545 "directory (or whereever you've told it to look using B<--sourcedir>)."
2550 msgid "debian/I<package>.install"
2556 "List the files to install into each package and the directory they should be "
2557 "installed to. The format is a set of lines, where each line lists a file or "
2558 "files to install, and at the end of the line tells the directory it should "
2559 "be installed in. The name of the files (or directories) to install should be "
2560 "given relative to the current directory, while the installation directory is "
2561 "given relative to the package build directory. You may use wildcards in the "
2562 "names of the files to install (in v3 mode and above)."
2567 msgid "B<--list-missing>"
2573 "This option makes B<dh_install> keep track of the files it installs, and "
2574 "then at the end, compare that list with the files in the source "
2575 "directory. If any of the files (and symlinks) in the source directory were "
2576 "not installed to somewhere, it will warn on stderr about that."
2582 "This may be useful if you have a large package and want to make sure that "
2583 "you don't miss installing newly added files in new upstream releases."
2589 "Note that files that are excluded from being moved via the B<-X> option are "
2595 msgid "B<--fail-missing>"
2601 "This option is like B<--list-missing>, except if a file was missed, it will "
2602 "not only list the missing files, but also fail with a nonzero exit code."
2606 #: dh_install:78 dh_installexamples:43
2608 "Exclude files that contain I<item> anywhere in their filename from being "
2613 #: dh_install:81 dh_movefiles:42
2614 msgid "B<--sourcedir=>I<dir>"
2619 msgid "Look in the specified directory for files to be installed."
2625 "Note that this is not the same as the B<--sourcedirectory> option used by "
2626 "the B<dh_auto_>I<*> commands. You rarely need to use this option, since "
2627 "B<dh_install> automatically looks for files in F<debian/tmp> in debhelper"
2632 msgid "compatibility level 7 and above."
2637 msgid "B<--autodest>"
2643 "Guess as the destination directory to install things to. If this is "
2644 "specified, you should not list destination directories in "
2645 "F<debian/package.install> files or on the command line. Instead, "
2646 "B<dh_install> will guess as follows:"
2652 "Strip off F<debian/tmp> (or the sourcedir if one is given) from the front of "
2653 "the filename, if it is present, and install into the dirname of the "
2654 "filename. So if the filename is F<debian/tmp/usr/bin>, then that directory "
2655 "will be copied to F<debian/package/usr/>. If the filename is "
2656 "F<debian/tmp/etc/passwd>, it will be copied to F<debian/package/etc/>."
2662 "Note that if you list exactly one filename or wildcard-pattern on a line by "
2663 "itself in a F<debian/package.install> file, with no explicit destination, "
2664 "then B<dh_install> will automatically guess the destination even if this "
2670 msgid "I<file> ... I<dest>"
2676 "Lists files (or directories) to install and where to install them to. The "
2677 "files will be installed into the first package F<dh_install> acts on."
2688 "Suppose your package's upstream F<Makefile> installs a binary, a man page, "
2689 "and a library into appropriate subdirectories of F<debian/tmp>. You want to "
2690 "put the library into package libfoo, and the rest into package foo. Your "
2691 "rules file will run \"B<dh_install --sourcedir=debian/tmp>\". Make "
2692 "F<debian/foo.install> contain:"
2700 " usr/share/man/man1\n"
2706 msgid "While F<debian/libfoo.install> contains:"
2713 " usr/lib/libfoo*.so.*\n"
2720 "If you want a libfoo-dev package too, F<debian/libfoo-dev.install> might "
2729 " usr/lib/libfoo*.so\n"
2730 " usr/share/man/man3\n"
2743 "B<dh_install> cannot rename files or directories, it can only install them\n"
2744 "with the names they already have into wherever you want in the package\n"
2750 #: dh_installcatalogs:5
2751 msgid "dh_installcatalogs - install and register SGML Catalogs"
2755 #: dh_installcatalogs:16
2756 msgid "B<dh_installcatalogs> [S<I<debhelper options>>] [B<-n>]"
2760 #: dh_installcatalogs:20
2762 "B<dh_installcatalogs> is a debhelper program that installs and registers "
2763 "SGML catalogs. It complies with the Debian XML/SGML policy."
2767 #: dh_installcatalogs:23
2769 "Catalogs will be registered in a supercatalog, in "
2770 "F</etc/sgml/I<package>.cat>."
2774 #: dh_installcatalogs:26
2776 "This command automatically adds maintainer script snippets for registering "
2777 "and unregistering the catalogs and supercatalogs (unless B<-n> is "
2778 "used). These snippets are inserted into the maintainer scripts by "
2779 "B<dh_installdeb>; see L<dh_installdeb(1)> for an explanation of Debhelper "
2780 "maintainer script snippets."
2784 #: dh_installcatalogs:32
2786 "A dependency on B<sgml-base> will be added to B<${misc:Depends}>, so be sure "
2787 "your package uses that variable in F<debian/control>."
2791 #: dh_installcatalogs:39
2792 msgid "debian/I<package>.sgmlcatalogs"
2796 #: dh_installcatalogs:41
2798 "Lists the catalogs to be installed per package. Each line in that file "
2799 "should be of the form C<I<source> I<dest>>, where I<source> indicates where "
2800 "the catalog resides in the source tree, and I<dest> indicates the "
2801 "destination location for the catalog under the package build area. I<dest> "
2802 "should start with F</usr/share/sgml/>."
2806 #: dh_installcatalogs:55 dh_installinit:54
2807 msgid "Do not modify F<postinst>/F<postrm>/F<prerm> scripts."
2811 #: dh_installcatalogs:61 dh_installdocs:122 dh_installemacsen:69 dh_installinit:135 dh_installmime:53 dh_installmodules:62 dh_installudev:57 dh_installwm:56 dh_usrlocal:51
2813 "Note that this command is not idempotent. L<dh_prep(1)> should be called "
2814 "between invocations of this command. Otherwise, it may cause multiple "
2815 "instances of the same text to be added to maintainer scripts."
2819 #: dh_installcatalogs:120
2820 msgid "F</usr/share/doc/sgml-base-doc/>"
2824 #: dh_installcatalogs:124
2825 msgid "Adam Di Carlo <aph@debian.org>"
2829 #: dh_installchangelogs:5
2830 msgid "dh_installchangelogs - install changelogs into package build directories"
2834 #: dh_installchangelogs:14
2836 "B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] "
2841 #: dh_installchangelogs:18
2843 "B<dh_installchangelogs> is a debhelper program that is responsible for "
2844 "installing changelogs into package build directories."
2848 #: dh_installchangelogs:21
2850 "An upstream F<changelog> file may be specified as an option. If none is "
2851 "specified, it looks for files with names that seem likely to be changelogs. "
2852 "(In compatibility level 7 and above.)"
2856 #: dh_installchangelogs:25
2858 "If there is an upstream F<changelog> file, it will be be installed as "
2859 "F<usr/share/doc/package/changelog> in the package build directory. If the "
2860 "changelog is a F<html> file (determined by file extension), it will be "
2861 "installed as F<usr/share/doc/package/changelog.html> instead, and will be "
2862 "converted to plain text with B<html2text> to generate "
2863 "F<usr/share/doc/package/changelog>."
2867 #: dh_installchangelogs:36
2868 msgid "F<debian/changelog>"
2872 #: dh_installchangelogs:38
2873 msgid "F<debian/NEWS>"
2877 #: dh_installchangelogs:40
2878 msgid "debian/I<package>.changelog"
2882 #: dh_installchangelogs:42
2883 msgid "debian/I<package>.NEWS"
2887 #: dh_installchangelogs:44
2889 "Automatically installed into usr/share/doc/I<package>/ in the package build "
2894 #: dh_installchangelogs:47
2896 "Use the package specific name if I<package> needs a different F<NEWS> or "
2897 "F<changelog> file."
2901 #: dh_installchangelogs:50
2903 "The F<changelog> file is installed with a name of changelog for native "
2904 "packages, and F<changelog.Debian> for non-native packages. The F<NEWS> file "
2905 "is always installed with a name of F<NEWS.Debian>."
2909 #: dh_installchangelogs:62
2911 "Keep the original name of the upstream changelog. This will be accomplished "
2912 "by installing the upstream changelog as F<changelog>, and making a symlink "
2913 "from that to the original name of the F<changelog> file. This can be useful "
2914 "if the upstream changelog has an unusual name, or if other documentation in "
2915 "the package refers to the F<changelog> file."
2919 #: dh_installchangelogs:70
2921 "Exclude upstream F<changelog> files that contain I<item> anywhere in their "
2922 "filename from being installed."
2926 #: dh_installchangelogs:73
2931 #: dh_installchangelogs:75
2932 msgid "Install this file as the upstream changelog."
2937 msgid "dh_installcron - install cron scripts into etc/cron.*"
2941 #: dh_installcron:14
2942 msgid "B<dh_installcron> [S<B<debhelper options>>] [B<--name=>I<name>]"
2946 #: dh_installcron:18
2948 "B<dh_installcron> is a debhelper program that is responsible for installing "
2953 #: dh_installcron:25
2954 msgid "debian/I<package>.cron.daily"
2958 #: dh_installcron:27
2959 msgid "debian/I<package>.cron.weekly"
2963 #: dh_installcron:29
2964 msgid "debian/I<package>.cron.monthly"
2968 #: dh_installcron:31
2969 msgid "debian/I<package>.cron.hourly"
2973 #: dh_installcron:33
2974 msgid "debian/I<package>.cron.d"
2978 #: dh_installcron:35
2980 "Installed into the appropriate F<etc/cron.*/> directory in the package build "
2985 #: dh_installcron:44 dh_installifupdown:43 dh_installinit:104 dh_installlogrotate:26 dh_installmodules:52 dh_installpam:35 dh_installppp:39 dh_installudev:39
2986 msgid "B<--name=>I<name>"
2990 #: dh_installcron:46
2992 "Look for files named F<debian/package.name.cron.*> and install them as "
2993 "F<etc/cron.*/name>, instead of using the usual files and installing them as "
2999 msgid "dh_installdeb - install files into the DEBIAN directory"
3004 msgid "B<dh_installdeb> [S<I<debhelper options>>]"
3010 "B<dh_installdeb> is a debhelper program that is responsible for installing "
3011 "files into the F<DEBIAN> directories in package build directories with the "
3012 "correct permissions."
3017 msgid "I<package>.postinst"
3022 msgid "I<package>.preinst"
3027 msgid "I<package>.postrm"
3032 msgid "I<package>.prerm"
3037 msgid "These maintainer scripts are installed into the F<DEBIAN> directory."
3043 "Inside the scripts, the token B<#DEBHELPER#> is replaced with shell script "
3044 "snippets generated by other debhelper commands."
3049 msgid "I<package>.triggers"
3054 msgid "I<package>.shlibs"
3059 msgid "These control files are installed into the F<DEBIAN> directory."
3064 msgid "I<package>.conffiles"
3069 msgid "This control file will be installed into the F<DEBIAN> directory."
3075 "In v3 compatibility mode and higher, all files in the F<etc/> directory in a "
3076 "package will automatically be flagged as conffiles by this program, so there "
3077 "is no need to list them manually here."
3082 msgid "I<package>.maintscript"
3088 "Lines in this file correspond to L<dpkg-maintscript-helper(1)> commands and "
3089 "parameters. Any shell metacharacters will be escaped, so arbitrary shell "
3090 "code cannot be inserted here. For example, a line such as C<mv_conffile "
3091 "/etc/oldconffile /etc/newconffile> will insert maintainer script snippets "
3092 "into all maintainer scripts sufficient to move that conffile."
3098 "A versioned Pre-Dependency on dpkg is needed to use "
3099 "L<dpkg-maintscript-helper(1)>. An appropriate Pre-Dependency is set in "
3100 "${misc:Pre-Depends} ; you should make sure to put that token into an "
3101 "appropriate place in your debian/control file."
3105 #: dh_installdebconf:5
3107 "dh_installdebconf - install files used by debconf in package build "
3112 #: dh_installdebconf:14
3113 msgid "B<dh_installdebconf> [S<I<debhelper options>>] [B<-n>] [S<B<--> I<params>>]"
3117 #: dh_installdebconf:18
3119 "B<dh_installdebconf> is a debhelper program that is responsible for "
3120 "installing files used by debconf into package build directories."
3124 #: dh_installdebconf:21
3126 "It also automatically generates the F<postrm> commands needed to interface "
3127 "with debconf. The commands are added to the maintainer scripts by "
3128 "B<dh_installdeb>. See L<dh_installdeb(1)> for an explanation of how that "
3133 #: dh_installdebconf:26
3135 "Note that if you use debconf, your package probably needs to depend on it "
3136 "(it will be added to B<${misc:Depends}> by this program)."
3140 #: dh_installdebconf:29
3142 "Note that for your config script to be called by B<dpkg>, your F<postinst> "
3143 "needs to source debconf's confmodule. B<dh_installdebconf> does not install "
3144 "this statement into the F<postinst> automatically as it it too hard to do it "
3149 #: dh_installdebconf:38
3150 msgid "debian/I<package>.config"
3154 #: dh_installdebconf:40
3156 "This is the debconf F<config> script, and is installed into the F<DEBIAN> "
3157 "directory in the package build directory."
3161 #: dh_installdebconf:43
3163 "Inside the script, the token B<#DEBHELPER#> is replaced with shell script "
3164 "snippets generated by other debhelper commands."
3168 #: dh_installdebconf:46
3169 msgid "debian/I<package>.templates"
3173 #: dh_installdebconf:48
3175 "This is the debconf F<templates> file, and is installed into the F<DEBIAN> "
3176 "directory in the package build directory."
3180 #: dh_installdebconf:51
3181 msgid "F<debian/po/>"
3185 #: dh_installdebconf:53
3187 "If this directory is present, this program will automatically use "
3188 "L<po2debconf(1)> to generate merged templates files that include the "
3189 "translations from there."
3193 #: dh_installdebconf:57
3194 msgid "For this to work, your package should build-depend on F<po-debconf>."
3198 #: dh_installdebconf:67
3199 msgid "Do not modify F<postrm> script."
3203 #: dh_installdebconf:71
3204 msgid "Pass the params to B<po2debconf>."
3209 msgid "dh_installdirs - create subdirectories in package build directories"
3213 #: dh_installdirs:14
3214 msgid "B<dh_installdirs> [S<I<debhelper options>>] [B<-A>] [S<I<dir> ...>]"
3218 #: dh_installdirs:18
3220 "B<dh_installdirs> is a debhelper program that is responsible for creating "
3221 "subdirectories in package build directories."
3225 #: dh_installdirs:25
3226 msgid "debian/I<package>.dirs"
3230 #: dh_installdirs:27
3231 msgid "Lists directories to be created in I<package>."
3235 #: dh_installdirs:37
3237 "Create any directories specified by command line parameters in ALL packages "
3238 "acted on, not just the first."
3242 #: dh_installdirs:40
3247 #: dh_installdirs:42
3249 "Create these directories in the package build directory of the first package "
3250 "acted on. (Or in all packages if B<-A> is specified.)"
3255 msgid "dh_installdocs - install documentation into package build directories"
3259 #: dh_installdocs:14
3261 "B<dh_installdocs> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] "
3266 #: dh_installdocs:18
3268 "B<dh_installdocs> is a debhelper program that is responsible for installing "
3269 "documentation into F<usr/share/doc/package> in package build directories."
3273 #: dh_installdocs:25
3274 msgid "debian/I<package>.docs"
3278 #: dh_installdocs:27
3279 msgid "List documentation files to be installed into I<package>."
3283 #: dh_installdocs:29
3284 msgid "F<debian/copyright>"
3288 #: dh_installdocs:31
3290 "The copyright file is installed into all packages, unless a more specific "
3291 "copyright file is available."
3295 #: dh_installdocs:34
3296 msgid "debian/I<package>.copyright"
3300 #: dh_installdocs:36
3301 msgid "debian/I<package>.README.Debian"
3305 #: dh_installdocs:38
3306 msgid "debian/I<package>.TODO"
3310 #: dh_installdocs:40
3311 msgid "Each of these files is automatically installed if present for a I<package>."
3315 #: dh_installdocs:43
3316 msgid "F<debian/README.Debian>"
3320 #: dh_installdocs:45
3321 msgid "F<debian/TODO>"
3325 #: dh_installdocs:47
3327 "These files are installed into the first binary package listed in "
3332 #: dh_installdocs:50
3334 "Note that F<README.debian> files are also installed as F<README.Debian>, and "
3335 "F<TODO> files will be installed as F<TODO.Debian> in non-native packages."
3339 #: dh_installdocs:53
3340 msgid "debian/I<package>.doc-base"
3344 #: dh_installdocs:55
3346 "Installed as doc-base control files. Note that the doc-id will be determined "
3347 "from the B<Document:> entry in the doc-base control file in question."
3351 #: dh_installdocs:59
3352 msgid "debian/I<package>.doc-base.*"
3356 #: dh_installdocs:61
3358 "If your package needs to register more than one document, you need multiple "
3359 "doc-base files, and can name them like this."
3363 #: dh_installdocs:72 dh_installinfo:37 dh_installman:66
3365 "Install all files specified by command line parameters in ALL packages acted "
3370 #: dh_installdocs:77
3372 "Exclude files that contain I<item> anywhere in their filename from being "
3373 "installed. Note that this includes doc-base files."
3377 #: dh_installdocs:80
3378 msgid "B<--link-doc=>I<package>"
3382 #: dh_installdocs:82
3384 "Make the documentation directory of all packages acted on be a symlink to "
3385 "the documentation directory of I<package>. This has no effect when acting on "
3386 "I<package> itself, or if the documentation directory to be created already "
3387 "exists when B<dh_installdocs> is run. To comply with policy, I<package> must "
3388 "be a binary package that comes from the same source package."
3392 #: dh_installdocs:88
3394 "debhelper will try to avoid installing files into linked documentation "
3395 "directories that would cause conflicts with the linked package. The B<-A> "
3396 "option will have no effect on packages with linked documentation "
3397 "directories, and F<copyright>, F<changelog>, F<README.Debian>, and F<TODO> "
3398 "files will not be installed."
3402 #: dh_installdocs:94
3404 "(An older method to accomplish the same thing, which is still supported, is "
3405 "to make the documentation directory of a package be a dangling symlink, "
3406 "before calling B<dh_installdocs>.)"
3410 #: dh_installdocs:100
3412 "Install these files as documentation into the first package acted on. (Or in "
3413 "all packages if B<-A> is specified)."
3417 #: dh_installdocs:107
3418 msgid "This is an example of a F<debian/package.docs> file:"
3422 #: dh_installdocs:109
3427 " debian/notes-for-maintainers.txt\n"
3428 " docs/manual.txt\n"
3429 " docs/manual.pdf\n"
3430 " docs/manual-html/\n"
3435 #: dh_installdocs:118
3437 "Note that B<dh_installdocs> will happily copy entire directory hierarchies "
3438 "if you ask it to (similar to B<cp -a>). If it is asked to install a "
3439 "directory, it will install the complete contents of the directory."
3443 #: dh_installemacsen:5
3444 msgid "dh_installemacsen - register an Emacs add on package"
3448 #: dh_installemacsen:14
3450 "B<dh_installemacsen> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] "
3451 "[B<--flavor=>I<foo>]"
3455 #: dh_installemacsen:18
3457 "B<dh_installemacsen> is a debhelper program that is responsible for "
3458 "installing files used by the Debian B<emacsen-common> package into package "
3459 "build directories."
3463 #: dh_installemacsen:22
3465 "It also automatically generates the F<postinst> and F<prerm> commands needed "
3466 "to register a package as an Emacs add on package. The commands are added to "
3467 "the maintainer scripts by B<dh_installdeb>. See L<dh_installdeb(1)> for an "
3468 "explanation of how this works."
3472 #: dh_installemacsen:31
3473 msgid "debian/I<package>.emacsen-install"
3477 #: dh_installemacsen:33
3479 "Installed into F<usr/lib/emacsen-common/packages/install/package> in the "
3480 "package build directory."
3484 #: dh_installemacsen:36
3485 msgid "debian/I<package>.emacsen-remove"
3489 #: dh_installemacsen:38
3491 "Installed into F<usr/lib/emacsen-common/packages/remove/package> in the "
3492 "package build directory."
3496 #: dh_installemacsen:41
3497 msgid "debian/I<package>.emacsen-startup"
3501 #: dh_installemacsen:43
3503 "Installed into etc/emacs/site-start.d/50I<package>.el in the package build "
3504 "directory. Use B<--priority> to use a different priority than 50."
3508 #: dh_installemacsen:54 dh_python:62 dh_usrlocal:45
3509 msgid "Do not modify F<postinst>/F<prerm> scripts."
3513 #: dh_installemacsen:56 dh_installwm:38
3514 msgid "B<--priority=>I<n>"
3518 #: dh_installemacsen:58
3519 msgid "Sets the priority number of a F<site-start.d> file. Default is 50."
3523 #: dh_installemacsen:60
3524 msgid "B<--flavor=>I<foo>"
3528 #: dh_installemacsen:62
3530 "Sets the flavor a F<site-start.d> file will be installed in. Default is "
3531 "B<emacs>, alternatives include B<xemacs> and B<emacs20>."
3535 #: dh_installexamples:5
3536 msgid "dh_installexamples - install example files into package build directories"
3540 #: dh_installexamples:14
3542 "B<dh_installexamples> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] "
3547 #: dh_installexamples:18
3549 "B<dh_installexamples> is a debhelper program that is responsible for "
3550 "installing examples into F<usr/share/doc/package/examples> in package build "
3555 #: dh_installexamples:26
3556 msgid "debian/I<package>.examples"
3560 #: dh_installexamples:28
3561 msgid "Lists example files or directories to be installed."
3565 #: dh_installexamples:38
3567 "Install any files specified by command line parameters in ALL packages acted "
3572 #: dh_installexamples:48
3574 "Install these files (or directories) as examples into the first package "
3575 "acted on. (Or into all packages if B<-A> is specified.)"
3579 #: dh_installexamples:55
3581 "Note that B<dh_installexamples> will happily copy entire directory "
3582 "hierarchies if you ask it to (similar to B<cp -a>). If it is asked to "
3583 "install a directory, it will install the complete contents of the directory."
3587 #: dh_installifupdown:5
3588 msgid "dh_installifupdown - install if-up and if-down hooks"
3592 #: dh_installifupdown:14
3593 msgid "B<dh_installifupdown> [S<I<debhelper options>>] [B<--name=>I<name>]"
3597 #: dh_installifupdown:18
3599 "B<dh_installifupdown> is a debhelper program that is responsible for "
3600 "installing F<if-up>, F<if-down>, F<if-pre-up>, and F<if-post-down> hook "
3601 "scripts into package build directories."
3605 #: dh_installifupdown:26
3606 msgid "debian/I<package>.if-up"
3610 #: dh_installifupdown:28
3611 msgid "debian/I<package>.if-down"
3615 #: dh_installifupdown:30
3616 msgid "debian/I<package>.if-pre-up"
3620 #: dh_installifupdown:32
3621 msgid "debian/I<package>.if-post-down"
3625 #: dh_installifupdown:34
3627 "These files are installed into etc/network/if-*.d/I<package> in the package "
3632 #: dh_installifupdown:45
3634 "Look for files named F<debian/package.name.if-*> and install them as "
3635 "F<etc/network/if-*/name>, instead of using the usual files and installing "
3636 "them as the package name."
3641 msgid "dh_installinfo - install info files"
3645 #: dh_installinfo:14
3646 msgid "B<dh_installinfo> [S<I<debhelper options>>] [B<-A>] [S<I<file> ...>]"
3650 #: dh_installinfo:18
3652 "B<dh_installinfo> is a debhelper program that is responsible for installing "
3653 "info files into F<usr/share/info> in the package build directory."
3657 #: dh_installinfo:25
3658 msgid "debian/I<package>.info"
3662 #: dh_installinfo:27
3663 msgid "List info files to be installed."
3667 #: dh_installinfo:42
3669 "Install these info files into the first package acted on. (Or in all "
3670 "packages if B<-A> is specified)."
3676 "dh_installinit - install upstart jobs or init scripts into package build "
3681 #: dh_installinit:14
3683 "B<dh_installinit> [S<I<debhelper options>>] [B<--name=>I<name>] [B<-n>] "
3684 "[B<-R>] [B<-r>] [B<-d>] [B<-O>] [S<B<--> I<params>>]"
3688 #: dh_installinit:18
3690 "B<dh_installinit> is a debhelper program that is responsible for installing "
3691 "upstart job files or init scripts with associated defaults files into "
3692 "package build directories, and in the former case providing compatibility "
3693 "handling for non-upstart systems."
3697 #: dh_installinit:23
3699 "It also automatically generates the F<postinst> and F<postrm> and F<prerm> "
3700 "commands needed to set up the symlinks in F</etc/rc*.d/> and to start and "
3701 "stop the init scripts."
3705 #: dh_installinit:31
3706 msgid "debian/I<package>.upstart"
3710 #: dh_installinit:33
3712 "If this exists, it is installed into etc/init/I<package>.conf in the package "
3717 #: dh_installinit:36
3718 msgid "debian/I<package>.init"
3722 #: dh_installinit:38
3724 "Otherwise, if this exists, it is installed into etc/init.d/I<package> in the "
3725 "package build directory."
3729 #: dh_installinit:41
3730 msgid "debian/I<package>.default"
3734 #: dh_installinit:43
3736 "If this exists, it is installed into etc/default/I<package> in the package "
3741 #: dh_installinit:56
3742 msgid "B<-o>, B<--onlyscripts>"
3746 #: dh_installinit:58
3748 "Only modify F<postinst>/F<postrm>/F<prerm> scripts, do not actually install "
3749 "any init script, default files, or upstart job. May be useful if the init "
3750 "script or upstart job is shipped and/or installed by upstream in a way that "
3751 "doesn't make it easy to let B<dh_installinit> find it."
3755 #: dh_installinit:63
3757 "If no upstart job file is installed in the target directory when "
3758 "B<dh_installinit --onlyscripts> is called, this program will assume that an "
3759 "init script is being installed and not provide the compatibility symlinks or "
3760 "upstart dependencies."
3764 #: dh_installinit:68
3765 msgid "B<-R>, B<--restart-after-upgrade>"
3769 #: dh_installinit:70
3771 "Do not stop the init script until after the package upgrade has been "
3772 "completed. This is different than the default behavior, which stops the "
3773 "script in the F<prerm>, and starts it again in the F<postinst>."
3777 #: dh_installinit:74
3779 "This can be useful for daemons that should not have a possibly long downtime "
3780 "during upgrade. But you should make sure that the daemon will not get "
3781 "confused by the package being upgraded while it's running before using this "
3786 #: dh_installinit:79
3787 msgid "B<-r>, B<--no-restart-on-upgrade>"
3791 #: dh_installinit:81
3792 msgid "Do not stop init script on upgrade."
3796 #: dh_installinit:83
3797 msgid "B<--no-start>"
3801 #: dh_installinit:85
3803 "Do not start the init script on install or upgrade, or stop it on removal. "
3804 "Only call B<update-rc.d>. Useful for rcS scripts."
3808 #: dh_installinit:88
3809 msgid "B<-d>, B<--remove-d>"
3813 #: dh_installinit:90
3815 "Remove trailing B<d> from the name of the package, and use the result for "
3816 "the filename the upstart job file is installed as in F<etc/init/> , or for "
3817 "the filename the init script is installed as in etc/init.d and the default "
3818 "file is installed as in F<etc/default/> . This may be useful for daemons "
3819 "with names ending in B<d>. (Note: this takes precedence over the "
3820 "B<--init-script> parameter described below.)"
3824 #: dh_installinit:97
3825 msgid "B<-u>I<params> B<--update-rcd-params=>I<params>"
3829 #: dh_installinit:101
3831 "Pass I<params> to L<update-rc.d(8)>. If not specified, B<defaults> will be "
3832 "passed to L<update-rc.d(8)>."
3836 #: dh_installinit:106
3838 "Install the upstart job file or the init script (and default file) using the "
3839 "filename I<name> instead of the default filename, which is the package "
3840 "name. When this parameter is used, B<dh_installinit> looks for and installs "
3841 "files named F<debian/package.name.upstart>, F<debian/package.name.init> and "
3842 "F<debian/package.name.default>, instead of the usual "
3843 "F<debian/package.upstart>, F<debian/package.init> and "
3844 "F<debian/package.default>."
3848 #: dh_installinit:113
3849 msgid "B<--init-script=>I<scriptname>"
3853 #: dh_installinit:115
3855 "Use I<scriptname> as the filename the init script is installed as in "
3856 "F<etc/init.d/> (and also use it as the filename for the defaults file, if it "
3857 "is installed). If you use this parameter, B<dh_installinit> will look to see "
3858 "if a file in the F<debian/> directory exists that looks like "
3859 "F<package.scriptname> and if so will install it as the init script in "
3860 "preference to the files it normally installs."
3864 #: dh_installinit:122
3866 "This parameter is deprecated, use the B<--name> parameter instead. This "
3867 "parameter will be ignored completely for upstart jobs."
3871 #: dh_installinit:125
3872 msgid "B<--error-handler=>I<function>"
3876 #: dh_installinit:127
3878 "Call the named shell I<function> if running the init script fails. The "
3879 "function should be provided in the F<prerm> and F<postinst> scripts, before "
3880 "the B<#DEBHELPER#> token."
3884 #: dh_installinit:281
3889 #: dh_installinit:285
3890 msgid "Steve Langasek <steve.langasek@canonical.com>"
3894 #: dh_installlogcheck:5
3895 msgid "dh_installlogcheck - install logcheck rulefiles into etc/logcheck/"
3899 #: dh_installlogcheck:14
3900 msgid "B<dh_installlogcheck> [S<I<debhelper options>>]"
3904 #: dh_installlogcheck:18
3906 "B<dh_installlogcheck> is a debhelper program that is responsible for "
3907 "installing logcheck rule files."
3911 #: dh_installlogcheck:25
3912 msgid "debian/I<package>.logcheck.cracking"
3916 #: dh_installlogcheck:27
3917 msgid "debian/I<package>.logcheck.violations"
3921 #: dh_installlogcheck:29
3922 msgid "debian/I<package>.logcheck.violations.ignore"
3926 #: dh_installlogcheck:31
3927 msgid "debian/I<package>.logcheck.ignore.workstation"
3931 #: dh_installlogcheck:33
3932 msgid "debian/I<package>.logcheck.ignore.server"
3936 #: dh_installlogcheck:35
3937 msgid "debian/I<package>.logcheck.ignore.paranoid"
3941 #: dh_installlogcheck:37
3943 "Each of these files, if present, are installed into corresponding "
3944 "subdirectories of F<etc/logcheck/> in package build directories."
3948 #: dh_installlogcheck:70
3951 "This program is a part of debhelper.\n"
3956 #: dh_installlogcheck:74
3957 msgid "Jon Middleton <jjm@debian.org>"
3961 #: dh_installlogrotate:5
3962 msgid "dh_installlogrotate - install logrotate config files"
3966 #: dh_installlogrotate:14
3967 msgid "B<dh_installlogrotate> [S<I<debhelper options>>] [B<--name=>I<name>]"
3971 #: dh_installlogrotate:18
3973 "B<dh_installlogrotate> is a debhelper program that is responsible for "
3974 "installing logrotate config files into F<etc/logrotate.d> in package build "
3975 "directories. Files named F<debian/package.logrotate> are installed."
3979 #: dh_installlogrotate:28
3981 "Look for files named F<debian/package.name.logrotate> and install them as "
3982 "F<etc/logrotate.d/name>, instead of using the usual files and installing "
3983 "them as the package name."
3988 msgid "dh_installman - install man pages into package build directories"
3993 msgid "B<dh_installman> [S<I<debhelper options>>] [S<I<manpage> ...>]"
3999 "B<dh_installman> is a debhelper program that handles installing man pages "
4000 "into the correct locations in package build directories. You tell it what "
4001 "man pages go in your packages, and it figures out where to install them "
4002 "based on the section field in their B<.TH> line. If you have a properly "
4003 "formatted B<.TH> line, your man page will be installed into the right "
4004 "directory, with the right name (this includes proper handling of pages with "
4005 "a subsection, like B<3perl>, which are placed in F<man3>, and given an "
4006 "extension of F<.3perl>). If your B<.TH> line is incorrect or missing, the "
4007 "program may guess wrong based on the file extension."
4013 "It also supports translated man pages, by looking for extensions like "
4014 "F<.ll.8> and F<.ll_LL.8>, or by use of the B<--language> switch."
4020 "If B<dh_installman> seems to install a man page into the wrong section or "
4021 "with the wrong extension, this is because the man page has the wrong section "
4022 "listed in its B<.TH> line. Edit the man page and correct the section, and "
4023 "B<dh_installman> will follow suit. See L<man(7)> for details about the "
4024 "B<.TH> section. If B<dh_installman> seems to install a man page into a "
4025 "directory like F</usr/share/man/pl/man1/>, that is because your program has "
4026 "a name like F<foo.pl>, and B<dh_installman> assumes that means it is "
4027 "translated into Polish. Use B<--language=C> to avoid this."
4033 "After the man page installation step, B<dh_installman> will check to see if "
4034 "any of the man pages in the temporary directories of any of the packages it "
4035 "is acting on contain F<.so> links. If so, it changes them to symlinks."
4041 "Also, B<dh_installman> will use man to guess the character encoding of each "
4042 "manual page and convert it to UTF-8. If the guesswork fails for some reason, "
4043 "you can override it using an encoding declaration. See L<manconv(1)> for "
4049 msgid "debian/I<package>.manpages"
4054 msgid "Lists man pages to be installed."
4059 msgid "B<--language=>I<ll>"
4065 "Use this to specify that the man pages being acted on are written in the "
4066 "specified language."
4071 msgid "I<manpage> ..."
4077 "Install these man pages into the first package acted on. (Or in all packages "
4078 "if B<-A> is specified)."
4084 "An older version of this program, L<dh_installmanpages(1)>, is still used by "
4085 "some packages, and so is still included in debhelper. It is, however, "
4086 "deprecated, due to its counterintuitive and inconsistent interface. Use this "
4091 #: dh_installmanpages:5
4092 msgid "dh_installmanpages - old-style man page installer (deprecated)"
4096 #: dh_installmanpages:15
4097 msgid "B<dh_installmanpages> [S<I<debhelper options>>] [S<I<file> ...>]"
4101 #: dh_installmanpages:19
4103 "B<dh_installmanpages> is a debhelper program that is responsible for "
4104 "automatically installing man pages into F<usr/share/man/> in package build "
4109 #: dh_installmanpages:23
4111 "This is a DWIM-style program, with an interface unlike the rest of "
4112 "debhelper. It is deprecated, and you are encouraged to use "
4113 "L<dh_installman(1)> instead."
4117 #: dh_installmanpages:27
4119 "B<dh_installmanpages> scans the current directory and all subdirectories for "
4120 "filenames that look like man pages. (Note that only real files are looked "
4121 "at; symlinks are ignored.) It uses L<file(1)> to verify that the files are "
4122 "in the correct format. Then, based on the files' extensions, it installs "
4123 "them into the correct man directory."
4127 #: dh_installmanpages:33
4129 "All filenames specified as parameters will be skipped by "
4130 "B<dh_installmanpages>. This is useful if by default it installs some man "
4131 "pages that you do not want to be installed."
4135 #: dh_installmanpages:37
4137 "After the man page installation step, B<dh_installmanpages> will check to "
4138 "see if any of the man pages are F<.so> links. If so, it changes them to "
4143 #: dh_installmanpages:46
4145 "Do not install these files as man pages, even if they look like valid man "
4150 #: dh_installmanpages:51
4155 #: dh_installmanpages:53
4157 "B<dh_installmanpages> will install the man pages it finds into B<all> "
4158 "packages you tell it to act on, since it can't tell what package the man "
4159 "pages belong in. This is almost never what you really want (use B<-p> to "
4160 "work around this, or use the much better L<dh_installman(1)> program "
4165 #: dh_installmanpages:58
4166 msgid "Files ending in F<.man> will be ignored."
4170 #: dh_installmanpages:60
4172 "Files specified as parameters that contain spaces in their filenames will "
4173 "not be processed properly."
4178 msgid "dh_installmenu - install Debian menu files into package build directories"
4182 #: dh_installmenu:14
4183 msgid "B<dh_installmenu> [S<B<debhelper options>>] [B<-n>]"
4187 #: dh_installmenu:18
4189 "B<dh_installmenu> is a debhelper program that is responsible for installing "
4190 "files used by the Debian B<menu> package into package build directories."
4194 #: dh_installmenu:21
4196 "It also automatically generates the F<postinst> and F<postrm> commands "
4197 "needed to interface with the Debian B<menu> package. These commands are "
4198 "inserted into the maintainer scripts by L<dh_installdeb(1)>."
4202 #: dh_installmenu:29
4203 msgid "debian/I<package>.menu"
4207 #: dh_installmenu:31
4209 "Debian menu files, installed into usr/share/menu/I<package> in the package "
4210 "build directory. See L<menufile(5)> for its format."
4214 #: dh_installmenu:34
4215 msgid "debian/I<package>.menu-method"
4219 #: dh_installmenu:36
4221 "Debian menu method files, installed into etc/menu-methods/I<package> in the "
4222 "package build directory."
4226 #: dh_installmenu:47 dh_installmime:47 dh_makeshlibs:79
4227 msgid "Do not modify F<postinst>/F<postrm> scripts."
4231 #: dh_installmenu:89
4232 msgid "L<debhelper(7)> L<update-menus(1)> L<menufile(5)>"
4237 msgid "dh_installmime - install mime files into package build directories"
4241 #: dh_installmime:14
4242 msgid "B<dh_installmime> [S<I<debhelper options>>] [B<-n>]"
4246 #: dh_installmime:18
4248 "B<dh_installmime> is a debhelper program that is responsible for installing "
4249 "mime files into package build directories."
4253 #: dh_installmime:21
4255 "It also automatically generates the F<postinst> and F<postrm> commands "
4256 "needed to interface with the debian B<mime-support> and B<shared-mime-info> "
4257 "packages. These commands are inserted into the maintainer scripts by "
4258 "L<dh_installdeb(1)>."
4262 #: dh_installmime:29
4263 msgid "debian/I<package>.mime"
4267 #: dh_installmime:31
4269 "Installed into usr/lib/mime/packages/I<package> in the package build "
4274 #: dh_installmime:34
4275 msgid "debian/I<package>.sharedmimeinfo"
4279 #: dh_installmime:36
4281 "Installed into /usr/share/mime/packages/I<package>.xml in the package build "
4286 #: dh_installmodules:5
4287 msgid "dh_installmodules - register modules with modutils"
4291 #: dh_installmodules:16
4292 msgid "B<dh_installmodules> [S<I<debhelper options>>] [B<-n>] [B<--name=>I<name>]"
4296 #: dh_installmodules:20
4298 "B<dh_installmodules> is a debhelper program that is responsible for "
4299 "registering kernel modules."
4303 #: dh_installmodules:23
4305 "Kernel modules are searched for in the package build directory and if found, "
4306 "F<preinst>, F<postinst> and F<postrm> commands are automatically generated "
4307 "to run B<depmod> and register the modules when the package is installed. "
4308 "These commands are inserted into the maintainer scripts by "
4309 "L<dh_installdeb(1)>."
4313 #: dh_installmodules:33
4314 msgid "debian/I<package>.modprobe"
4318 #: dh_installmodules:35
4319 msgid "Installed to etc/modprobe.d/I<package>.conf in the package build directory."
4323 #: dh_installmodules:37
4324 msgid "debian/I<package>.modules"
4328 #: dh_installmodules:39
4330 "These files were installed for use by modutils, but are now not used and "
4331 "B<dh_installmodules> will warn if these files are present."
4335 #: dh_installmodules:50
4336 msgid "Do not modify F<preinst>/F<postinst>/F<postrm> scripts."
4340 #: dh_installmodules:54
4342 "When this parameter is used, B<dh_installmodules> looks for and installs "
4343 "files named debian/I<package>.I<name>.modprobe instead of the usual "
4344 "debian/I<package>.modprobe"
4349 msgid "dh_installpam - install pam support files"
4354 msgid "B<dh_installpam> [S<I<debhelper options>>] [B<--name=>I<name>]"
4360 "B<dh_installpam> is a debhelper program that is responsible for installing "
4361 "files used by PAM into package build directories."
4366 msgid "debian/I<package>.pam"
4371 msgid "Installed into etc/pam.d/I<package> in the package build directory."
4377 "Look for files named debian/I<package>.I<name>.pam and install them as "
4378 "etc/pam.d/I<name>, instead of using the usual files and installing them "
4379 "using the package name."
4384 msgid "dh_installppp - install ppp ip-up and ip-down files"
4389 msgid "B<dh_installppp> [S<I<debhelper options>>] [B<--name=>I<name>]"
4395 "B<dh_installppp> is a debhelper program that is responsible for installing "
4396 "ppp ip-up and ip-down scripts into package build directories."
4401 msgid "debian/I<package>.ppp.ip-up"
4406 msgid "Installed into etc/ppp/ip-up.d/I<package> in the package build directory."
4411 msgid "debian/I<package>.ppp.ip-down"
4416 msgid "Installed into etc/ppp/ip-down.d/I<package> in the package build directory."
4422 "Look for files named F<debian/package.name.ppp.ip-*> and install them as "
4423 "F<etc/ppp/ip-*/name>, instead of using the usual files and installing them "
4424 "as the package name."
4429 msgid "dh_installudev - install udev rules files"
4433 #: dh_installudev:15
4435 "B<dh_installudev> [S<I<debhelper options>>] [B<-n>] [B<--name=>I<name>] "
4436 "[B<--priority=>I<priority>]"
4440 #: dh_installudev:19
4442 "B<dh_installudev> is a debhelper program that is responsible for installing "
4443 "B<udev> rules files."
4447 #: dh_installudev:22
4449 "Code is added to the F<preinst> and F<postinst> to handle the upgrade from "
4450 "the old B<udev> rules file location."
4454 #: dh_installudev:29
4455 msgid "debian/I<package>.udev"
4459 #: dh_installudev:31
4460 msgid "Installed into F<lib/udev/rules.d/> in the package build directory."
4464 #: dh_installudev:41
4466 "When this parameter is used, B<dh_installudev> looks for and installs files "
4467 "named debian/I<package>.I<name>.udev instead of the usual "
4468 "debian/I<package>.udev."
4472 #: dh_installudev:45
4473 msgid "B<--priority=>I<priority>"
4477 #: dh_installudev:47
4478 msgid "Sets the priority string of the F<rules.d> symlink. Default is 60."
4482 #: dh_installudev:51
4483 msgid "Do not modify F<preinst>/F<postinst> scripts."
4488 msgid "dh_installwm - register a window manager"
4494 "B<dh_installwm> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] "
4501 "B<dh_installwm> is a debhelper program that is responsible for generating "
4502 "the F<postinst> and F<prerm> commands that register a window manager with "
4503 "L<update-alternatives(8)>. The window manager's man page is also registered "
4504 "as a slave symlink (in v6 mode and up), if it is found in "
4505 "F<usr/share/man/man1/> in the package build directory."
4510 msgid "debian/I<package>.wm"
4515 msgid "List window manager programs to register."
4521 "Set the priority of the window manager. Default is 20, which is too low for "
4522 "most window managers; see the Debian Policy document for instructions on "
4523 "calculating the correct value."
4528 msgid "Do not modify F<postinst>/F<prerm> scripts. Turns this command into a no-op."
4538 msgid "Window manager programs to register."
4542 #: dh_installxfonts:5
4543 msgid "dh_installxfonts - register X fonts"
4547 #: dh_installxfonts:14
4548 msgid "B<dh_installxfonts> [S<I<debhelper options>>]"
4552 #: dh_installxfonts:18
4554 "B<dh_installxfonts> is a debhelper program that is responsible for "
4555 "registering X fonts, so their corresponding F<fonts.dir>, F<fonts.alias>, "
4556 "and F<fonts.scale> be rebuilt properly at install time."
4560 #: dh_installxfonts:22
4562 "Before calling this program, you should have installed any X fonts provided "
4563 "by your package into the appropriate location in the package build "
4564 "directory, and if you have F<fonts.alias> or F<fonts.scale> files, you "
4565 "should install them into the correct location under F<etc/X11/fonts> in your "
4566 "package build directory."
4570 #: dh_installxfonts:28
4572 "Your package should depend on B<xfonts-utils> so that the "
4573 "B<update-fonts->I<*> commands are available. (This program adds that "
4574 "dependency to B<${misc:Depends}>.)"
4578 #: dh_installxfonts:32
4580 "This program automatically generates the F<postinst> and F<postrm> commands "
4581 "needed to register X fonts. These commands are inserted into the maintainer "
4582 "scripts by B<dh_installdeb>. See L<dh_installdeb(1)> for an explanation of "
4587 #: dh_installxfonts:39
4589 "See L<update-fonts-alias(8)>, L<update-fonts-scale(8)>, and "
4590 "L<update-fonts-dir(8)> for more information about X font installation."
4594 #: dh_installxfonts:42
4596 "See Debian policy, section 11.8.5. for details about doing fonts the Debian "
4602 msgid "dh_link - create symlinks in package build directories"
4608 "B<dh_link> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] [S<I<source "
4609 "destination> ...>]"
4615 "B<dh_link> is a debhelper program that creates symlinks in package build "
4622 "B<dh_link> accepts a list of pairs of source and destination files. The "
4623 "source files are the already existing files that will be symlinked from. The "
4624 "destination files are the symlinks that will be created. There B<must> be an "
4625 "equal number of source and destination files specified."
4631 "Be sure you B<do> specify the full filename to both the source and "
4632 "destination files (unlike you would do if you were using something like "
4639 "B<dh_link> will generate symlinks that comply with Debian policy - absolute "
4640 "when policy says they should be absolute, and relative links with as short a "
4641 "path as possible. It will also create any subdirectories it needs to to put "
4648 "B<dh_link> also scans the package build tree for existing symlinks which do "
4649 "not conform to Debian policy, and corrects them (v4 or later)."
4654 msgid "debian/I<package>.links"
4660 "Lists pairs of source and destination files to be symlinked. Each pair "
4661 "should be put on its own line, with the source and destination separated by "
4668 "Create any links specified by command line parameters in ALL packages acted "
4669 "on, not just the first."
4675 "Do not correct symlinks that contain I<item> anywhere in their filename from "
4676 "being corrected to comply with Debian policy."
4681 msgid "I<source destination> ..."
4687 "Create a file named I<destination> as a link to a file named I<source>. Do "
4688 "this in the package build directory of the first package acted on. (Or in "
4689 "all packages if B<-A> is specified.)"
4696 " dh_link usr/share/man/man1/foo.1 usr/share/man/man1/bar.1\n"
4702 msgid "Make F<bar.1> be a symlink to F<foo.1>"
4709 " dh_link var/lib/foo usr/lib/foo \\\n"
4710 " usr/share/man/man1/foo.1 usr/share/man/man1/bar.1\n"
4717 "Make F</usr/lib/foo/> be a link to F</var/lib/foo/>, and F<bar.1> be a "
4718 "symlink to the F<foo.1>"
4723 msgid "dh_lintian - install lintian override files into package build directories"
4728 msgid "B<dh_lintian> [S<I<debhelper options>>]"
4734 "B<dh_lintian> is a debhelper program that is responsible for installing "
4735 "override files used by lintian into package build directories."
4740 msgid "debian/I<package>.lintian-overrides"
4746 "Installed into usr/share/lintian/overrides/I<package> in the package build "
4747 "directory. This file is used to suppress erroneous lintian diagnostics."
4752 msgid "F<debian/source.lintian-overrides>"
4758 "These files are not installed, but will be scanned by lintian to provide "
4759 "overrides for the source package."
4764 msgid "L<lintian(1)>"
4769 msgid "Steve Robbins <smr@debian.org>"
4773 #: dh_listpackages:5
4774 msgid "dh_listpackages - list binary packages debhelper will act on"
4778 #: dh_listpackages:14
4779 msgid "B<dh_listpackages> [S<I<debhelper options>>]"
4783 #: dh_listpackages:18
4785 "B<dh_listpackages> is a debhelper program that outputs a list of all binary "
4786 "packages debhelper commands will act on. If you pass it some options, it "
4787 "will change the list to match the packages other debhelper commands would "
4788 "act on if passed the same options."
4793 msgid "dh_makeshlibs - automatically create shlibs file and call dpkg-gensymbols"
4799 "B<dh_makeshlibs> [S<I<debhelper options>>] [B<-m>I<major>] "
4800 "[B<-V>I<[dependencies]>] [B<-n>] [B<-X>I<item>] [S<B<--> I<params>>]"
4806 "B<dh_makeshlibs> is a debhelper program that automatically scans for shared "
4807 "libraries, and generates a shlibs file for the libraries it finds."
4813 "It also adds a call to ldconfig in the F<postinst> and F<postrm> scripts (in "
4814 "v3 mode and above only) to any packages in which it finds shared libraries."
4820 "Packages that support multiarch are detected, and a Pre-Dependency on "
4821 "multiarch-support is set in ${misc:Pre-Depends} ; you should make sure to "
4822 "put that token into an appropriate place in your debian/control file for "
4823 "packages supporting multiarch."
4828 msgid "debian/I<package>.symbols"
4833 msgid "debian/I<package>.symbols.I<arch>"
4839 "These symbols files, if present, are passed to L<dpkg-gensymbols(1)> to be "
4840 "processed and installed. Use the I<arch> specific names if you need to "
4841 "provide different symbols files for different architectures."
4846 msgid "B<-m>I<major>, B<--major=>I<major>"
4852 "Instead of trying to guess the major number of the library with objdump, use "
4853 "the major number specified after the -m parameter. This is much less useful "
4854 "than it used to be, back in the bad old days when this program looked at "
4855 "library filenames rather than using objdump."
4860 msgid "B<-V>, B<-V>I<dependencies>"
4865 msgid "B<--version-info>, B<--version-info=>I<dependencies>"
4871 "By default, the shlibs file generated by this program does not make packages "
4872 "depend on any particular version of the package containing the shared "
4873 "library. It may be necessary for you to add some version dependancy "
4874 "information to the shlibs file. If B<-V> is specified with no dependency "
4875 "information, the current upstream version of the package is plugged into a "
4876 "dependency that looks like \"I<packagename> B<(E<gt>>= "
4877 "I<packageversion>B<)>\". Note that in debhelper compatibility levels before "
4878 "v4, the Debian part of the package version number is also included. If B<-V> "
4879 "is specified with parameters, the parameters can be used to specify the "
4880 "exact dependency information needed (be sure to include the package name)."
4886 "Beware of using B<-V> without any parameters; this is a conservative setting "
4887 "that always ensures that other packages' shared library dependencies are at "
4888 "least as tight as they need to be (unless your library is prone to changing "
4889 "ABI without updating the upstream version number), so that if the maintainer "
4890 "screws up then they won't break. The flip side is that packages might end up "
4891 "with dependencies that are too tight and so find it harder to be upgraded."
4897 "Exclude files that contain I<item> anywhere in their filename or directory "
4898 "from being treated as shared libraries."
4903 msgid "B<--add-udeb=>I<udeb>"
4909 "Create an additional line for udebs in the shlibs file and use I<udeb> as "
4910 "the package name for udebs to depend on instead of the regular library "
4916 msgid "Pass I<params> to L<dpkg-gensymbols(1)>."
4920 #: dh_makeshlibs:101
4921 msgid "B<dh_makeshlibs>"
4925 #: dh_makeshlibs:103
4928 "Assuming this is a package named F<libfoobar1>, generates a shlibs file "
4930 "looks something like:\n"
4931 " libfoobar 1 libfoobar1\n"
4936 #: dh_makeshlibs:107
4937 msgid "B<dh_makeshlibs -V>"
4941 #: dh_makeshlibs:109
4944 "Assuming the current version of the package is 1.1-3, generates a shlibs\n"
4945 "file that looks something like:\n"
4946 " libfoobar 1 libfoobar1 (>= 1.1)\n"
4951 #: dh_makeshlibs:113
4952 msgid "B<dh_makeshlibs -V 'libfoobar1 (E<gt>= 1.0)'>"
4956 #: dh_makeshlibs:115
4959 "Generates a shlibs file that looks something like:\n"
4960 " libfoobar 1 libfoobar1 (>= 1.0)\n"
4966 msgid "dh_md5sums - generate DEBIAN/md5sums file"
4972 "B<dh_md5sums> [S<I<debhelper options>>] [B<-x>] [B<-X>I<item>] "
4973 "[B<--include-conffiles>]"
4979 "B<dh_md5sums> is a debhelper program that is responsible for generating a "
4980 "F<DEBIAN/md5sums> file, which lists the md5sums of each file in the "
4981 "package. These files are used by the B<debsums> package."
4987 "All files in F<DEBIAN/> are omitted from the F<md5sums> file, as are all "
4988 "conffiles (unless you use the B<--include-conffiles> switch)."
4993 msgid "The md5sums file is installed with proper permissions and ownerships."
4998 msgid "B<-x>, B<--include-conffiles>"
5004 "Include conffiles in the md5sums list. Note that this information is "
5005 "redundant since it is included elsewhere in Debian packages."
5011 "Exclude files that contain I<item> anywhere in their filename from being "
5012 "listed in the md5sums file."
5017 msgid "dh_movefiles - move files out of debian/tmp into subpackages"
5023 "B<dh_movefiles> [S<I<debhelper options>>] [B<--sourcedir=>I<dir>] "
5024 "[B<-X>I<item>] S<I<file> ...>]"
5030 "B<dh_movefiles> is a debhelper program that is responsible for moving files "
5031 "out of F<debian/tmp> or some other directory and into other package build "
5032 "directories. This may be useful if your package has a F<Makefile> that "
5033 "installs everything into F<debian/tmp>, and you need to break that up into "
5040 "Note: B<dh_install> is a much better program, and you are recommended to use "
5041 "it instead of B<dh_movefiles>."
5046 msgid "debian/I<package>.files"
5052 "Lists the files to be moved into a package, separated by whitespace. The "
5053 "filenames listed should be relative to F<debian/tmp/>. You can also list "
5054 "directory names, and the whole directory will be moved."
5060 "Instead of moving files out of F<debian/tmp> (the default), this option "
5061 "makes it move files out of some other directory. Since the entire contents "
5062 "of the sourcedir is moved, specifying something like B<--sourcedir=/> is "
5063 "very unsafe, so to prevent mistakes, the sourcedir must be a relative "
5064 "filename; it cannot begin with a `B</>'."
5069 msgid "B<-Xitem>, B<--exclude=item>"
5075 "Exclude files that contain B<item> anywhere in their filename from being "
5082 "Lists files to move. The filenames listed should be relative to "
5083 "F<debian/tmp/>. You can also list directory names, and the whole directory "
5084 "will be moved. It is an error to list files here unless you use B<-p>, "
5085 "B<-i>, or B<-a> to tell B<dh_movefiles> which subpackage to put them in."
5091 "Note that files are always moved out of F<debian/tmp> by default (even if "
5092 "you have instructed debhelper to use a compatibility level higher than one, "
5093 "which does not otherwise use debian/tmp for anything at all). The idea "
5094 "behind this is that the package that is being built can be told to install "
5095 "into F<debian/tmp>, and then files can be moved by B<dh_movefiles> from that "
5096 "directory. Any files or directories that remain are ignored, and get deleted "
5097 "by B<dh_clean> later."
5102 msgid "dh_perl - calculates Perl dependencies and cleans up after MakeMaker"
5107 msgid "B<dh_perl> [S<I<debhelper options>>] [B<-d>] [S<I<library dirs> ...>]"
5113 "B<dh_perl> is a debhelper program that is responsible for generating the "
5114 "B<${perl:Depends}> substitutions and adding them to substvars files."
5120 "The program will look at Perl scripts and modules in your package, and will "
5121 "use this information to generate a dependency on B<perl> or B<perlapi>. The "
5122 "dependency will be substituted into your package's F<control> file wherever "
5123 "you place the token B<${perl:Depends}>."
5129 "B<dh_perl> also cleans up empty directories that MakeMaker can generate when "
5130 "installing Perl modules."
5141 "In some specific cases you may want to depend on B<perl-base> rather than "
5142 "the full B<perl> package. If so, you can pass the -d option to make "
5143 "B<dh_perl> generate a dependency on the correct base package. This is only "
5144 "necessary for some packages that are included in the base system."
5150 "Note that this flag may cause no dependency on B<perl-base> to be generated "
5151 "at all. B<perl-base> is Essential, so its dependency can be left out, unless "
5152 "a versioned dependency is needed."
5163 "By default, scripts and architecture independent modules don't depend on any "
5164 "specific version of B<perl>. The B<-V> option causes the current version of "
5165 "the B<perl> (or B<perl-base> with B<-d>) package to be specified."
5170 msgid "I<library dirs>"
5176 "If your package installs Perl modules in non-standard directories, you can "
5177 "make B<dh_perl> check those directories by passing their names on the "
5178 "command line. It will only check the F<vendorlib> and F<vendorarch> "
5179 "directories by default."
5184 msgid "Debian policy, version 3.8.3"
5189 msgid "Perl policy, version 1.20"
5194 msgid "Brendan O'Dea <bod@debian.org>"
5199 msgid "dh_prep - perform cleanups in preparation for building a binary package"
5204 msgid "B<dh_prep> [S<I<debhelper options>>] [B<-X>I<item>]"
5210 "B<dh_prep> is a debhelper program that performs some file cleanups in "
5211 "preparation for building a binary package. (This is what B<dh_clean -k> used "
5212 "to do.) It removes the package build directories, F<debian/tmp>, and some "
5213 "temp files that are generated when building a binary package."
5219 "It is typically run at the top of the B<binary-arch> and B<binary-indep> "
5220 "targets, or at the top of a target such as install that they depend on."
5226 "Exclude files that contain F<item> anywhere in their filename from being "
5227 "deleted, even if they would normally be deleted. You may use this option "
5228 "multiple times to build up a list of things to exclude."
5234 "dh_python - calculates Python dependencies and adds postinst and prerm "
5235 "Python scripts (deprecated)"
5241 "B<dh_python> [S<I<debhelper options>>] [B<-n>] [B<-V> I<version>] "
5242 "[S<I<module dirs> ...>]"
5248 "Note: This program is deprecated. You should use B<dh_pysupport> or "
5249 "B<dh_pycentral> instead. This program will do nothing if F<debian/pycompat> "
5250 "or a B<Python-Version> F<control> file field exists."
5256 "B<dh_python> is a debhelper program that is responsible for generating the "
5257 "B<${python:Depends}> substitutions and adding them to substvars files. It "
5258 "will also add a F<postinst> and a F<prerm> script if required."
5264 "The program will look at Python scripts and modules in your package, and "
5265 "will use this information to generate a dependency on B<python>, with the "
5266 "current major version, or on B<python>I<X>B<.>I<Y> if your scripts or "
5267 "modules need a specific B<python> version. The dependency will be "
5268 "substituted into your package's F<control> file wherever you place the token "
5269 "B<${python:Depends}>."
5275 "If some modules need to be byte-compiled at install time, appropriate "
5276 "F<postinst> and F<prerm> scripts will be generated. If already byte-compiled "
5277 "modules are found, they are removed."
5282 msgid "If you use this program, your package should build-depend on B<python>."
5287 msgid "I<module dirs>"
5293 "If your package installs Python modules in non-standard directories, you can "
5294 "make F<dh_python> check those directories by passing their names on the "
5295 "command line. By default, it will check F</usr/lib/site-python, "
5296 "/usr/lib/$PACKAGE>, F</usr/share/$PACKAGE>, F</usr/lib/games/$PACKAGE>, "
5297 "F</usr/share/games/$PACKAGE> and F</usr/lib/python?.?/site-packages>."
5303 "Note: only F</usr/lib/site-python>, F</usr/lib/python?.?/site-packages> and "
5304 "the extra names on the command line are searched for binary (F<.so>) "
5310 msgid "B<-V> I<version>"
5316 "If the F<.py> files your package ships are meant to be used by a specific "
5317 "B<python>I<X>B<.>I<Y> version, you can use this option to specify the "
5318 "desired version, such as B<2.3>. Do not use if you ship modules in "
5319 "F</usr/lib/site-python>."
5324 msgid "Debian policy, version 3.5.7"
5329 msgid "Python policy, version 0.3.7"
5334 msgid "Josselin Mouette <joss@debian.org>"
5339 msgid "most ideas stolen from Brendan O'Dea <bod@debian.org>"
5343 #: dh_scrollkeeper:5
5344 msgid "dh_scrollkeeper - deprecated no-op"
5348 #: dh_scrollkeeper:14
5349 msgid "B<dh_scrollkeeper> [S<I<debhelper options>>] [B<-n>] [S<I<directory>>]"
5353 #: dh_scrollkeeper:18
5355 "B<dh_scrollkeeper> was a debhelper program that handled registering OMF "
5356 "files for ScrollKeeper. However, it no longer does anything, and is now "
5362 msgid "dh_shlibdeps - calculate shared library dependencies"
5368 "B<dh_shlibdeps> [S<I<debhelper options>>] [B<-L>I<package>] "
5369 "[B<-l>I<directory>] [B<-X>I<item>] [S<B<--> I<params>>]"
5375 "B<dh_shlibdeps> is a debhelper program that is responsible for calculating "
5376 "shared library dependencies for packages."
5382 "This program is merely a wrapper around L<dpkg-shlibdeps(1)> that calls it "
5383 "once for each package listed in the F<control> file, passing it a list of "
5384 "ELF executables and shared libraries it has found."
5390 "Exclude files that contain F<item> anywhere in their filename from being "
5391 "passed to B<dpkg-shlibdeps>. This will make their dependencies be ignored. "
5392 "This may be useful in some situations, but use it with caution. This option "
5393 "may be used more than once to exclude more than one thing."
5398 msgid "Pass I<params> to L<dpkg-shlibdeps(1)>."
5403 msgid "B<-u>I<params>, B<--dpkg-shlibdeps-params=>I<params>"
5409 "This is another way to pass I<params> to L<dpkg-shlibdeps(1)>. It is "
5410 "deprecated; use B<--> instead."
5415 msgid "B<-l>I<directory>[B<:>I<directory> ...]"
5421 "With recent versions of B<dpkg-shlibdeps>, this option is generally not "
5428 "Before B<dpkg-shlibdeps> is run, B<LD_LIBRARY_PATH> will have added to it "
5429 "the specified directory (or directories -- separate with colons). With "
5430 "recent versions of B<dpkg-shlibdeps>, this is mostly only useful for "
5431 "packages that build multiple flavors of the same library, or other "
5432 "situations where the library is installed into a directory not on the "
5433 "regular library search path."
5438 msgid "B<-L>I<package>, B<--libpackage=>I<package>"
5444 "With recent versions of B<dpkg-shlibdeps>, this option is generally not "
5445 "needed, unless your package builds multiple flavors of the same library."
5451 "It tells B<dpkg-shlibdeps> (via its B<-S> parameter) to look first in the "
5452 "package build directory for the specified package, when searching for "
5453 "libraries, symbol files, and shlibs files."
5459 "Suppose that your source package produces libfoo1, libfoo-dev, and "
5460 "libfoo-bin binary packages. libfoo-bin links against libfoo1, and should "
5461 "depend on it. In your rules file, first run B<dh_makeshlibs>, then "
5477 "This will have the effect of generating automatically a shlibs file for "
5478 "libfoo1, and using that file and the libfoo1 library in the "
5479 "F<debian/libfoo1/usr/lib> directory to calculate shared library dependency "
5486 "If a libbar1 package is also produced, that is an alternate build of libfoo, "
5487 "and is installed into F</usr/lib/bar/>, you can make libfoo-bin depend on "
5488 "libbar1 as follows:"
5495 "\tdh_shlibdeps -Llibbar1 -l/usr/lib/bar\n"
5501 msgid "L<debhelper(7)>, L<dpkg-shlibdeps(1)>"
5506 msgid "dh_strip - strip executables, shared libraries, and some static libraries"
5512 "B<dh_strip> [S<I<debhelper options>>] [B<-X>I<item>] "
5513 "[B<--dbg-package=>I<package>] [B<--keep-debug>]"
5519 "B<dh_strip> is a debhelper program that is responsible for stripping "
5520 "executables, shared libraries, and static libraries that are not used for "
5527 "This program examines your package build directories and works out what to "
5528 "strip on its own. It uses L<file(1)> and file permissions and filenames to "
5529 "figure out what files are shared libraries (F<*.so>), executable binaries, "
5530 "and static (F<lib*.a>) and debugging libraries (F<lib*_g.a>, F<debug/*.so>), "
5531 "and strips each as much as is possible. (Which is not at all for debugging "
5532 "libraries.) In general it seems to make very good guesses, and will do the "
5533 "right thing in almost all cases."
5539 "Since it is very hard to automatically guess if a file is a module, and hard "
5540 "to determine how to strip a module, B<dh_strip> does not currently deal with "
5541 "stripping binary modules such as F<.o> files."
5547 "Exclude files that contain I<item> anywhere in their filename from being "
5548 "stripped. You may use this option multiple times to build up a list of "
5549 "things to exclude."
5554 msgid "B<--dbg-package=>I<package>"
5560 "Causes B<dh_strip> to save debug symbols stripped from the packages it acts "
5561 "on as independent files in the package build directory of the specified "
5562 "debugging package."
5568 "For example, if your packages are libfoo and foo and you want to include a "
5569 "I<foo-dbg> package with debugging symbols, use B<dh_strip "
5570 "--dbg-package=>I<foo-dbg>."
5576 "Note that this option behaves significantly different in debhelper "
5577 "compatibility levels 4 and below. Instead of specifying the name of a debug "
5578 "package to put symbols in, it specifies a package (or packages) which should "
5579 "have separated debug symbols, and the separated symbols are placed in "
5580 "packages with B<-dbg> added to their name."
5585 msgid "B<-k>, B<--keep-debug>"
5591 "Debug symbols will be retained, but split into an independent file in "
5592 "F<usr/lib/debug/> in the package build directory. B<--dbg-package> is easier "
5593 "to use than this option, but this option is more flexible."
5599 "If the B<DEB_BUILD_OPTIONS> environment variable contains B<nostrip>, "
5600 "nothing will be stripped, in accordance with Debian policy (section 10.1 "
5606 msgid "Debian policy, version 3.0.1"
5610 #: dh_suidregister:5
5611 msgid "dh_suidregister - suid registration program (deprecated)"
5615 #: dh_suidregister:9 dh_undocumented:14
5620 #: dh_suidregister:13
5622 "This program used to register suid and sgid files with L<suidregister(1)>, "
5623 "but with the introduction of L<dpkg-statoverride(8)>, registration of files "
5624 "in this way is unnecessary, and even harmful, so this program is deprecated "
5625 "and should not be used."
5629 #: dh_suidregister:18
5630 msgid "CONVERTING TO STATOVERRIDE"
5634 #: dh_suidregister:20
5636 "Converting a package that uses this program to use the new statoverride "
5637 "mechanism is easy. Just remove the call to B<dh_suidregister> from "
5638 "F<debian/rules>, and add a versioned conflicts into your F<control> file, as "
5643 #: dh_suidregister:25
5646 " Conflicts: suidmanager (<< 0.50)\n"
5651 #: dh_suidregister:27
5653 "The conflicts is only necessary if your package used to register things with "
5654 "suidmanager; if it did not, you can just remove the call to this program "
5655 "from your rules file."
5660 msgid "dh_testdir - test directory before building Debian package"
5665 msgid "B<dh_testdir> [S<I<debhelper options>>] [S<I<file> ...>]"
5671 "B<dh_testdir> tries to make sure that you are in the correct directory when "
5672 "building a Debian package. It makes sure that the file F<debian/control> "
5673 "exists, as well as any other files you specify. If not, it exits with an "
5679 msgid "Test for the existence of these files too."
5684 msgid "dh_testroot - ensure that a package is built as root"
5689 msgid "B<dh_testroot> [S<I<debhelper options>>]"
5695 "B<dh_testroot> simply checks to see if you are root. If not, it exits with "
5696 "an error. Debian packages must be built as root, though you can use "
5701 #: dh_undocumented:5
5702 msgid "dh_undocumented - undocumented.7 symlink program (deprecated no-op)"
5706 #: dh_undocumented:18
5708 "This program used to make symlinks to the F<undocumented.7> man page for man "
5709 "pages not present in a package. Debian policy now frowns on use of the "
5710 "F<undocumented.7> man page, and so this program does nothing, and should not "
5716 msgid "dh_usrlocal - migrate usr/local directories to maintainer scripts"
5721 msgid "B<dh_usrlocal> [S<I<debhelper options>>] [B<-n>]"
5727 "B<dh_usrlocal> is a debhelper program that can be used for building packages "
5728 "that will provide a subdirectory in F</usr/local> when installed."
5734 "It finds subdirectories of F<usr/local> in the package build directory, and "
5735 "removes them, replacing them with maintainer script snippets (unless B<-n> "
5736 "is used) to create the directories at install time, and remove them when the "
5737 "package is removed, in a manner compliant with Debian policy. These snippets "
5738 "are inserted into the maintainer scripts by B<dh_installdeb>. See "
5739 "L<dh_installdeb(1)> for an explanation of debhelper maintainer script "
5746 "If the directories found in the build tree have unusual owners, groups, or "
5747 "permissions, then those values will be preserved in the directories made by "
5748 "the F<postinst> script. However, as a special exception, if a directory is "
5749 "owned by root.root, it will be treated as if it is owned by root.staff and "
5750 "is mode 2775. This is useful, since that is the group and mode policy "
5751 "recommends for directories in F</usr/local>."
5756 msgid "Debian policy, version 2.2"
5761 msgid "Andrew Stribblehill <ads@debian.org>"
projects / debhelper.git / blob