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-12-27 11:53-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:13 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:17 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 for the first (or only) binary package listed in F<debian/control>, "
154 "debhelper will use F<debian/foo> when there's no F<debian/package.foo> file."
160 "In some rare cases, you may want to have different versions of these files "
161 "for different architectures or OSes. If files named "
162 "debian/I<package>.foo.I<ARCH> or debian/I<package>.foo.I<OS> exist, where "
163 "I<ARCH> and I<OS> are the same as the output of \"B<dpkg-architecture "
164 "-qDEB_HOST_ARCH>\" / \"B<dpkg-architecture -qDEB_HOST_ARCH_OS>\", then they "
165 "will be used in preference to other, more general files."
171 "Mostly, these config files are used to specify lists of various types of "
172 "files. Documentation or example files to install, files to move, and so on. "
173 "When appropriate, in cases like these, you can use standard shell wildcard "
174 "characters (B<?> and B<*> and B<[>I<..>B<]> character classes) in the "
175 "files. You can also put comments in these files; lines beginning with B<#> "
182 "The syntax of these files is intentionally kept very simple to make then "
183 "easy to read, understand, and modify. If you prefer power and complexity, "
184 "you can make the file executable, and write a program that outputs whatever "
185 "content is appropriate for a given situation. When you do so, the output is "
186 "not further processed to expand wildcards or strip comments."
191 msgid "SHARED DEBHELPER OPTIONS"
196 msgid "The following command line options are supported by all debhelper programs."
201 msgid "B<-v>, B<--verbose>"
206 msgid "Verbose mode: show all commands that modify the package build directory."
210 #: debhelper.pod:106 dh:64
217 "Do not really do anything. If used with -v, the result is that the command "
218 "will output what it would have done."
223 msgid "B<-a>, B<--arch>"
229 "Act on architecture dependent packages that should be built for the build "
235 msgid "B<-i>, B<--indep>"
240 msgid "Act on all architecture independent packages."
245 msgid "B<-p>I<package>, B<--package=>I<package>"
251 "Act on the package named I<package>. This option may be specified multiple "
252 "times to make debhelper operate on a given set of packages."
257 msgid "B<-s>, B<--same-arch>"
263 "This used to be a smarter version of the B<-a> flag, but the B<-a> flag is "
269 msgid "B<-N>I<package>, B<--no-package=>I<package>"
275 "Do not act on the specified package even if an B<-a>, B<-i>, or B<-p> option "
276 "lists the package as one that should be acted on."
281 msgid "B<--remaining-packages>"
287 "Do not act on the packages which have already been acted on by this "
288 "debhelper command earlier (i.e. if the command is present in the package "
289 "debhelper log). For example, if you need to call the command with special "
290 "options only for a couple of binary packages, pass this option to the last "
291 "call of the command to process the rest of packages with default settings."
296 msgid "B<--ignore=>I<file>"
302 "Ignore the specified file. This can be used if F<debian/> contains a "
303 "debhelper config file that a debhelper command should not act on. Note that "
304 "F<debian/compat>, F<debian/control>, and F<debian/changelog> can't be "
305 "ignored, but then, there should never be a reason to ignore those files."
311 "For example, if upstream ships a F<debian/init> that you don't want "
312 "B<dh_installinit> to install, use B<--ignore=debian/init>"
317 msgid "B<-P>I<tmpdir>, B<--tmpdir=>I<tmpdir>"
322 msgid "Use I<tmpdir> for package build directory. The default is debian/I<package>"
327 msgid "B<--mainpackage=>I<package>"
333 "This little-used option changes the package which debhelper considers the "
334 "\"main package\", that is, the first one listed in F<debian/control>, and "
335 "the one for which F<debian/foo> files can be used instead of the usual "
336 "F<debian/package.foo> files."
341 msgid "B<-O=>I<option>|I<bundle>"
347 "This is used by L<dh(1)> when passing user-specified options to all the "
348 "commands it runs. If the command supports the specified option or option "
349 "bundle, it will take effect. If the command does not support the option (or "
350 "any part of an option bundle), it will be ignored."
355 msgid "COMMON DEBHELPER OPTIONS"
361 "The following command line options are supported by some debhelper "
362 "programs. See the man page of each program for a complete explanation of "
363 "what each option does."
373 msgid "Do not modify F<postinst>, F<postrm>, etc. scripts."
377 #: debhelper.pod:185 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
378 msgid "B<-X>I<item>, B<--exclude=>I<item>"
384 "Exclude an item from processing. This option may be used multiple times, to "
385 "exclude more than one thing."
389 #: debhelper.pod:190 dh_bugfiles:54 dh_compress:59 dh_installdirs:35 dh_installdocs:70 dh_installexamples:36 dh_installinfo:35 dh_installman:64 dh_link:55
390 msgid "B<-A>, B<--all>"
396 "Makes files or other items that are specified on the command line take "
397 "effect in ALL packages acted on, not just the first."
402 msgid "BUILD SYSTEM OPTIONS"
408 "The following command line options are supported by all of the "
409 "B<dh_auto_>I<*> debhelper programs. These programs support a variety of "
410 "build systems, and normally heuristically determine which to use, and how to "
411 "use them. You can use these command line options to override the default "
412 "behavior. Typically these are passed to L<dh(1)>, which then passes them to "
413 "all the B<dh_auto_>I<*> programs."
418 msgid "B<-S>I<buildsystem>, B<--buildsystem=>I<buildsystem>"
424 "Force use of the specified I<buildsystem>, instead of trying to auto-select "
425 "one which might be applicable for the package."
430 msgid "B<-D>I<directory>, B<--sourcedirectory=>I<directory>"
436 "Assume that the original package source tree is at the specified "
437 "I<directory> rather than the top level directory of the Debian source "
443 msgid "B<-B>[I<directory>], B<--builddirectory=>[I<directory>]"
449 "Enable out of source building and use the specified I<directory> as the "
450 "build directory. If I<directory> parameter is omitted, a default build "
451 "directory will chosen."
457 "If this option is not specified, building will be done in source by default "
458 "unless the build system requires or prefers out of source tree building. In "
459 "such a case, the default build directory will be used even if "
460 "B<--builddirectory> is not specified."
466 "If the build system prefers out of source tree building but still allows in "
467 "source building, the latter can be re-enabled by passing a build directory "
468 "path that is the same as the source directory path."
473 msgid "B<--parallel>"
479 "Enable parallel builds if underlying build system supports them. The number "
480 "of parallel jobs is controlled by the B<DEB_BUILD_OPTIONS> environment "
481 "variable (L<Debian Policy, section 4.9.1>) at build time. It might also be "
482 "subject to a build system specific limit."
488 "If this option is not specified, debhelper currently defaults to not "
489 "allowing parallel package builds."
494 msgid "B<--max-parallel=>I<maximum>"
500 "This option implies B<--parallel> and allows further limiting the number of "
501 "jobs that can be used in a parallel build. If the package build is known to "
502 "only work with certain levels of concurrency, you can set this to the "
503 "maximum level that is known to work, or that you wish to support."
507 #: debhelper.pod:251 dh:60
508 msgid "B<--list>, B<-l>"
514 "List all build systems supported by debhelper on this system. The list "
515 "includes both default and third party build systems (marked as such). Also "
516 "shows which build system would be automatically selected, or which one is "
517 "manually specified with the B<--buildsystem> option."
522 msgid "COMPATABILITY LEVELS"
528 "From time to time, major non-backwards-compatible changes need to be made to "
529 "debhelper, to keep it clean and well-designed as needs change and its author "
530 "gains more experience. To prevent such major changes from breaking existing "
531 "packages, the concept of debhelper compatibility levels was introduced. You "
532 "tell debhelper which compatibility level it should use, and it modifies its "
533 "behavior in various ways."
539 "Tell debhelper what compatibility level to use by writing a number to "
540 "F<debian/compat>. For example, to turn on v8 mode:"
547 " % echo 8 > debian/compat\n"
554 "Unless otherwise indicated, all debhelper documentation assumes that you are "
555 "using the most recent compatibility level, and in most cases does not "
556 "indicate if the behavior is different in an earlier compatibility level, so "
557 "if you are not using the most recent compatibility level, you're advised to "
558 "read below for notes about what is different in earlier compatibility "
564 msgid "These are the available compatibility levels:"
575 "This is the original debhelper compatibility level, and so it is the default "
576 "one. In this mode, debhelper will use F<debian/tmp> as the package tree "
577 "directory for the first binary package listed in the control file, while "
578 "using debian/I<package> for all other packages listed in the F<control> "
583 #: debhelper.pod:292 debhelper.pod:299 debhelper.pod:322 debhelper.pod:351
584 msgid "This mode is deprecated."
595 "In this mode, debhelper will consistently use debian/I<package> as the "
596 "package tree directory for every package that is built."
606 msgid "This mode works like v2, with the following additions:"
610 #: debhelper.pod:307 debhelper.pod:312 debhelper.pod:316 debhelper.pod:330 debhelper.pod:335 debhelper.pod:340 debhelper.pod:345 debhelper.pod:359 debhelper.pod:363 debhelper.pod:368 debhelper.pod:372 debhelper.pod:384 debhelper.pod:389 debhelper.pod:395 debhelper.pod:401 debhelper.pod:414 debhelper.pod:421 debhelper.pod:425 debhelper.pod:429 debhelper.pod:444 debhelper.pod:448 debhelper.pod:456 debhelper.pod:461 debhelper.pod:475 debhelper.pod:480 debhelper.pod:487 debhelper.pod:492 debhelper.pod:497 debhelper.pod:501 debhelper.pod:507 debhelper.pod:512 debhelper.pod:517
617 "Debhelper config files support globbing via B<*> and B<?>, when "
618 "appropriate. To turn this off and use those characters raw, just prefix with "
625 "B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call "
632 "Every file in F<etc/> is automatically flagged as a conffile by "
643 msgid "Changes from v3 are:"
649 "B<dh_makeshlibs -V> will not include the Debian part of the version number "
650 "in the generated dependency line in the shlibs file."
656 "You are encouraged to put the new B<${misc:Depends}> into F<debian/control> "
657 "to supplement the B<${shlibs:Depends}> field."
663 "B<dh_fixperms> will make all files in F<bin/> directories and in "
664 "F<etc/init.d> executable."
669 msgid "B<dh_link> will correct existing links to conform with policy."
679 msgid "Changes from v4 are:"
684 msgid "Comments are ignored in debhelper config files."
690 "B<dh_strip --dbg-package> now specifies the name of a package to put "
691 "debugging symbols in, not the packages to take the symbols from."
696 msgid "B<dh_installdocs> skips installing empty files."
701 msgid "B<dh_install> errors out if wildcards expand to nothing."
711 msgid "Changes from v5 are:"
717 "Commands that generate maintainer script fragments will order the fragments "
718 "in reverse order for the F<prerm> and F<postrm> scripts."
724 "B<dh_installwm> will install a slave manpage link for "
725 "F<x-window-manager.1.gz>, if it sees the man page in F<usr/share/man/man1> "
726 "in the package build directory."
732 "B<dh_builddeb> did not previously delete everything matching "
733 "B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as "
734 "B<CVS:.svn:.git>. Now it does."
740 "B<dh_installman> allows overwriting existing man pages in the package build "
741 "directory. In previous compatibility levels it silently refuses to do this."
751 msgid "Changes from v6 are:"
757 "B<dh_install>, will fall back to looking for files in F<debian/tmp> if it "
758 "doesn't find them in the current directory (or wherever you tell it look "
759 "using B<--sourcedir>). This allows B<dh_install> to interoperate with "
760 "B<dh_auto_install>, which installs to F<debian/tmp>, without needing any "
761 "special parameters."
766 msgid "B<dh_clean> will read F<debian/clean> and delete files listed there."
771 msgid "B<dh_clean> will delete toplevel F<*-stamp> files."
777 "B<dh_installchangelogs> will guess at what file is the upstream changelog if "
788 msgid "This is the recommended mode of operation."
793 msgid "Changes from v7 are:"
798 msgid "Commands will fail rather than warning when they are passed unknown options."
804 "B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it "
805 "generates shlibs files for. So B<-X> can be used to exclude libraries. "
806 "Also, libraries in unusual locations that B<dpkg-gensymbols> would not have "
807 "processed before will be passed to it, a behavior change that can cause some "
808 "packages to fail to build."
814 "B<dh> requires the sequence to run be specified as the first parameter, and "
815 "any switches come after it. Ie, use \"B<dh $@ --foo>\", not \"B<dh --foo "
822 "B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to "
833 msgid "This compatibility level is still open for development; use with caution."
838 msgid "Changes from v8 are:"
844 "Multiarch support. In particular, B<dh_auto_configure> passes multiarch "
845 "directories to autoconf in --libdir and --libexecdir."
851 "dh is aware of the usual dependencies between targets in debian/rules. So, "
852 "\"dh binary\" will run any build, build-arch, build-indep, install, etc "
853 "targets that exist in the rules file. There's no need to define an explicit "
854 "binary target with explicit dependencies on the other targets."
860 "B<dh_strip> compresses debugging symbol files to reduce the installed size "
867 "B<dh_auto_configure> does not include the source package name in "
868 "--libexecdir when using autoconf."
873 msgid "B<dh> does not default to enabling --with=python-support"
879 "All of the B<dh_auto_>I<*> debhelper programs and B<dh> set environment "
880 "variables listed by B<dpkg-buildflags>, unless they are already set. They "
881 "support DEB_BUILD_OPTIONS=noopt too."
886 msgid "B<dh_auto_configure> passes CFLAGS to perl F<Makefile.PL> and F<Build.PL>"
892 "B<dh_strip> puts separated debug symbols in a location based on their "
899 "Executable debhelper config files are run and their output used as the "
904 #: debhelper.pod:526 dh_auto_test:45 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
910 msgid "Multiple binary package support"
916 "If your source package generates more than one binary package, debhelper "
917 "programs will default to acting on all binary packages when run. If your "
918 "source package happens to generate one architecture dependent package, and "
919 "another architecture independent package, this is not the correct behavior, "
920 "because you need to generate the architecture dependent packages in the "
921 "binary-arch F<debian/rules> target, and the architecture independent "
922 "packages in the binary-indep F<debian/rules> target."
928 "To facilitate this, as well as give you more control over which packages are "
929 "acted on by debhelper programs, all debhelper programs accept the B<-a>, "
930 "B<-i>, B<-p>, and B<-s> parameters. These parameters are cumulative. If "
931 "none are given, debhelper programs default to acting on all packages listed "
932 "in the control file."
937 msgid "Automatic generation of Debian install scripts"
943 "Some debhelper commands will automatically generate parts of Debian "
944 "maintainer scripts. If you want these automatically generated things "
945 "included in your existing Debian maintainer scripts, then you need to add "
946 "B<#DEBHELPER#> to your scripts, in the place the code should be added. "
947 "B<#DEBHELPER#> will be replaced by any auto-generated code when you run "
954 "If a script does not exist at all and debhelper needs to add something to "
955 "it, then debhelper will create the complete script."
961 "All debhelper commands that automatically generate code in this way let it "
962 "be disabled by the -n parameter (see above)."
968 "Note that the inserted code will be shell code, so you cannot directly use "
969 "it in a Perl script. If you would like to embed it into a Perl script, here "
970 "is one way to do that (note that I made sure that $1, $2, etc are set with "
978 " my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n"
981 " system ($temp) / 256 == 0\n"
982 " \tor die \"Problem with debhelper scripts: $!\";\n"
988 msgid "Automatic generation of miscellaneous dependencies."
994 "Some debhelper commands may make the generated package need to depend on "
995 "some other packages. For example, if you use L<dh_installdebconf(1)>, your "
996 "package will generally need to depend on debconf. Or if you use "
997 "L<dh_installxfonts(1)>, your package will generally need to depend on a "
998 "particular version of xutils. Keeping track of these miscellaneous "
999 "dependencies can be annoying since they are dependent on how debhelper does "
1000 "things, so debhelper offers a way to automate it."
1004 #: debhelper.pod:580
1006 "All commands of this type, besides documenting what dependencies may be "
1007 "needed on their man pages, will automatically generate a substvar called "
1008 "B<${misc:Depends}>. If you put that token into your F<debian/control> file, "
1009 "it will be expanded to the dependencies debhelper figures you need."
1013 #: debhelper.pod:585
1015 "This is entirely independent of the standard B<${shlibs:Depends}> generated "
1016 "by L<dh_makeshlibs(1)>, and the B<${perl:Depends}> generated by "
1017 "L<dh_perl(1)>. You can choose not to use any of these, if debhelper's "
1018 "guesses don't match reality."
1022 #: debhelper.pod:590
1023 msgid "Package build directories"
1027 #: debhelper.pod:592
1029 "By default, all debhelper programs assume that the temporary directory used "
1030 "for assembling the tree of files in a package is debian/I<package>."
1034 #: debhelper.pod:595
1036 "Sometimes, you might want to use some other temporary directory. This is "
1037 "supported by the B<-P> flag. For example, \"B<dh_installdocs "
1038 "-Pdebian/tmp>\", will use B<debian/tmp> as the temporary directory. Note "
1039 "that if you use B<-P>, the debhelper programs can only be acting on a single "
1040 "package at a time. So if you have a package that builds many binary "
1041 "packages, you will need to also use the B<-p> flag to specify which binary "
1042 "package the debhelper program will act on."
1046 #: debhelper.pod:603
1051 #: debhelper.pod:605
1053 "Debhelper includes support for udebs. To create a udeb with debhelper, add "
1054 "\"B<Package-Type: udeb>\" to the package's stanza in F<debian/control>, and "
1055 "build-depend on debhelper (>= 4.2). Debhelper will try to create udebs that "
1056 "comply with debian-installer policy, by making the generated package files "
1057 "end in F<.udeb>, not installing any documentation into a udeb, skipping over "
1058 "F<preinst>, F<postrm>, F<prerm>, and F<config> scripts, etc."
1062 #: debhelper.pod:612
1063 msgid "Build depends"
1067 #: debhelper.pod:614
1069 "Once your package uses debhelper to build, be sure to add debhelper to your "
1070 "Build-Depends line in F<debian/control>. You should build-depend on a "
1071 "version of debhelper equal to (or greater than) the debhelper compatibility "
1072 "level your package uses. So if your package used compatibility level 7:"
1076 #: debhelper.pod:620
1079 " Build-Depends: debhelper (>= 7)\n"
1084 #: debhelper.pod:622
1089 #: debhelper.pod:626
1090 msgid "B<DH_VERBOSE>"
1094 #: debhelper.pod:628
1096 "Set to B<1> to enable verbose mode. Debhelper will output every command it "
1097 "runs that modifies files on the build system."
1101 #: debhelper.pod:631
1102 msgid "B<DH_COMPAT>"
1106 #: debhelper.pod:633
1108 "Temporarily specifies what compatibility level debhelper should run at, "
1109 "overriding any value in F<debian/compat>."
1113 #: debhelper.pod:636
1114 msgid "B<DH_NO_ACT>"
1118 #: debhelper.pod:638
1119 msgid "Set to B<1> to enable no-act mode."
1123 #: debhelper.pod:640
1124 msgid "B<DH_OPTIONS>"
1128 #: debhelper.pod:642
1130 "Anything in this variable will be prepended to the command line arguments of "
1131 "all debhelper commands."
1135 #: debhelper.pod:645
1137 "When using L<dh(1)>, it can be passed options that will be passed on to each "
1138 "debhelper command, which is generally better than using DH_OPTIONS."
1142 #: debhelper.pod:648
1143 msgid "B<DH_ALWAYS_EXCLUDE>"
1147 #: debhelper.pod:650
1149 "If set, this adds the value the variable is set to to the B<-X> options of "
1150 "all commands that support the B<-X> option. Moreover, B<dh_builddeb> will "
1151 "B<rm -rf> anything that matches the value in your package build tree."
1155 #: debhelper.pod:654
1157 "This can be useful if you are doing a build from a CVS source tree, in which "
1158 "case setting B<DH_ALWAYS_EXCLUDE=CVS> will prevent any CVS directories from "
1159 "sneaking into the package you build. Or, if a package has a source tarball "
1160 "that (unwisely) includes CVS directories, you might want to export "
1161 "B<DH_ALWAYS_EXCLUDE=CVS> in F<debian/rules>, to make it take effect wherever "
1162 "your package is built."
1166 #: debhelper.pod:661
1168 "Multiple things to exclude can be separated with colons, as in "
1169 "B<DH_ALWAYS_EXCLUDE=CVS:.svn>"
1173 #: debhelper.pod:666 dh:890 dh_auto_build:47 dh_auto_clean:50 dh_auto_configure:52 dh_auto_install:85 dh_auto_test:59 dh_bugfiles:122 dh_builddeb:120 dh_clean:142 dh_compress:206 dh_desktop:31 dh_fixperms:127 dh_gconf:99 dh_gencontrol:82 dh_icons:65 dh_install:258 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:78 dh_installlogrotate:50 dh_installman:259 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:242 dh_suidregister:117 dh_testdir:44 dh_testroot:27 dh_undocumented:28 dh_usrlocal:114
1178 #: debhelper.pod:670
1179 msgid "F</usr/share/doc/debhelper/examples/>"
1183 #: debhelper.pod:672
1184 msgid "A set of example F<debian/rules> files that use debhelper."
1188 #: debhelper.pod:674
1189 msgid "L<http://kitenet.net/~joey/code/debhelper/>"
1193 #: debhelper.pod:676
1194 msgid "Debhelper web site."
1198 #: debhelper.pod:680 dh:896 dh_auto_build:53 dh_auto_clean:56 dh_auto_configure:58 dh_auto_install:91 dh_auto_test:65 dh_bugfiles:130 dh_builddeb:126 dh_clean:148 dh_compress:212 dh_desktop:37 dh_fixperms:133 dh_gconf:105 dh_gencontrol:88 dh_icons:71 dh_install:264 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:84 dh_installlogrotate:56 dh_installman:265 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:248 dh_suidregister:123 dh_testdir:50 dh_testroot:33 dh_undocumented:34 dh_usrlocal:120
1203 #: debhelper.pod:682 dh:898 dh_auto_build:55 dh_auto_clean:58 dh_auto_configure:60 dh_auto_install:93 dh_auto_test:67 dh_builddeb:128 dh_clean:150 dh_compress:214 dh_fixperms:135 dh_gencontrol:90 dh_install:266 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:267 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:250 dh_suidregister:125 dh_testdir:52 dh_testroot:35 dh_undocumented:36
1204 msgid "Joey Hess <joeyh@debian.org>"
1209 msgid "dh - debhelper command sequencer"
1215 "B<dh> I<sequence> [B<--with> I<addon>[B<,>I<addon> ...]] [B<--list>] "
1216 "[S<I<debhelper options>>]"
1222 "B<dh> runs a sequence of debhelper commands. The supported I<sequence>s "
1223 "correspond to the targets of a F<debian/rules> file: B<build-arch>, "
1224 "B<build-indep>, B<build>, B<clean>, B<install-indep>, B<install-arch>, "
1225 "B<install>, B<binary-arch>, B<binary-indep>, and B<binary>."
1230 msgid "OVERRIDE TARGETS"
1236 "A F<debian/rules> file using B<dh> can override the command that is run at "
1237 "any step in a sequence, by defining an override target."
1243 "To override I<dh_command>, add a target named B<override_>I<dh_command> to "
1244 "the rules file. When it would normally run I<dh_command>, B<dh> will instead "
1245 "call that target. The override target can then run the command with "
1246 "additional options, or run entirely different commands instead. See examples "
1247 "below. (Note that to use this feature, you should Build-Depend on debhelper "
1254 "Override targets can also be defined to run only when building architecture "
1255 "dependent or architecture independent packages. Use targets with names like "
1256 "B<override_>I<dh_command>B<-arch> and B<override_>I<dh_command>B<-indep>. "
1257 "(Note that to use this feature, you should Build-Depend on debhelper 8.9.7 "
1262 #: dh:43 dh_auto_build:28 dh_auto_clean:30 dh_auto_configure:31 dh_auto_install:43 dh_auto_test:31 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_installlogcheck:42 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
1268 msgid "B<--with> I<addon>[B<,>I<addon> ...]"
1274 "Add the debhelper commands specified by the given addon to appropriate "
1275 "places in the sequence of commands that is run. This option can be repeated "
1276 "more than once, or multiple addons can be listed, separated by commas. This "
1277 "is used when there is a third-party package that provides debhelper "
1278 "commands. See the F<PROGRAMMING> file for documentation about the sequence "
1284 msgid "B<--without> I<addon>"
1289 msgid "The inverse of B<--with>, disables using the given addon."
1294 msgid "List all available addons."
1299 msgid "Prints commands that would run for a given sequence, but does not run them."
1305 "Other options passed to B<dh> are passed on to each command it runs. This "
1306 "can be used to set an option like B<-v> or B<-X> or B<-N>, as well as for "
1307 "more specialised options."
1311 #: dh:74 dh_installdocs:105 dh_link:73 dh_makeshlibs:97 dh_shlibdeps:69
1318 "To see what commands are included in a sequence, without actually doing "
1326 "\tdh binary-arch --no-act\n"
1333 "This is a very simple rules file, for packages where the default sequences "
1334 "of commands work with no additional options."
1338 #: dh:84 dh:105 dh:118
1341 "\t#!/usr/bin/make -f\n"
1350 "Often you'll want to pass an option to a specific debhelper command. The "
1351 "easy way to do with is by adding an override target for that command."
1355 #: dh:91 dh:176 dh:187
1358 "\t#!/usr/bin/make -f\n"
1368 "\toverride_dh_strip:\n"
1369 "\t\tdh_strip -Xfoo\n"
1377 "\toverride_dh_auto_configure:\n"
1378 "\t\tdh_auto_configure -- --with-foo --disable-bar\n"
1385 "Sometimes the automated L<dh_auto_configure(1)> and L<dh_auto_build(1)> "
1386 "can't guess what to do for a strange package. Here's how to avoid running "
1387 "either and instead run your own commands."
1394 "\toverride_dh_auto_configure:\n"
1395 "\t\t./mondoconfig\n"
1403 "\toverride_dh_auto_build:\n"
1404 "\t\tmake universe-explode-in-delight\n"
1411 "Another common case is wanting to do something manually before or after a "
1412 "particular debhelper command is run."
1419 "\toverride_dh_fixperms:\n"
1421 "\t\tchmod 4755 debian/foo/usr/bin/foo\n"
1428 "If your package uses autotools and you want to freshen F<config.sub> and "
1429 "F<config.guess> with newer versions from the B<autotools-dev> package at "
1430 "build time, you can use some commands provided in B<autotools-dev> that "
1431 "automate it, like this."
1438 "\t#!/usr/bin/make -f\n"
1440 "\t\tdh $@ --with autotools_dev\n"
1447 "Python tools are not run by dh by default, due to the continual change in "
1448 "that area. (Before compatibility level v9, dh does run B<dh_pysupport>.) "
1449 "Here is how to use B<dh_python2>."
1456 "\t#!/usr/bin/make -f\n"
1458 "\t\tdh $@ --with python2\n"
1465 "Here is how to force use of Perl's B<Module::Build> build system, which can "
1466 "be necessary if debhelper wrongly detects that the package uses MakeMaker."
1473 "\t#!/usr/bin/make -f\n"
1475 "\t\tdh $@ --buildsystem=perl_build\n"
1482 "Here is an example of overriding where the B<dh_auto_>I<*> commands find the "
1483 "package's source, for a package where the source is located in a "
1491 "\t#!/usr/bin/make -f\n"
1493 "\t\tdh $@ --sourcedirectory=src\n"
1500 "And here is an example of how to tell the B<dh_auto_>I<*> commands to build "
1501 "in a subdirectory, which will be removed on B<clean>."
1508 "\t#!/usr/bin/make -f\n"
1510 "\t\tdh $@ --builddirectory=build\n"
1517 "If your package can be built in parallel, you can support parallel building "
1518 "as follows. Then B<dpkg-buildpackage -j> will work."
1525 "\t#!/usr/bin/make -f\n"
1527 "\t\tdh $@ --parallel\n"
1534 "Here is a way to prevent B<dh> from running several commands that you don't "
1535 "want it to run, by defining empty override targets for each command."
1542 "\t# Commands not to run:\n"
1543 "\toverride_dh_auto_test override_dh_compress override_dh_fixperms:\n"
1550 "A long build process for a separate documentation package can be separated "
1551 "out using architecture independent overrides. These will be skipped when "
1552 "running build-arch and binary-arch sequences."
1559 "\toverride_dh_auto_build-indep:\n"
1560 "\t\t$(MAKE) -C docs\n"
1568 "\t# No tests needed for docs\n"
1569 "\toverride_dh_auto_test-indep:\n"
1577 "\toverride_dh_auto_install-indep:\n"
1578 "\t\t$(MAKE) -C docs install\n"
1585 "Adding to the example above, suppose you need to chmod a file, but only when "
1586 "building the architecture dependent package, as it's not present when "
1587 "building only documentation."
1594 "\toverride_dh_fixperms-arch:\n"
1596 "\t\tchmod 4755 debian/foo/usr/bin/foo\n"
1608 "If you're curious about B<dh>'s internals, here's how it works under the "
1615 "Each debhelper command will record when it's successfully run in "
1616 "F<debian/package.debhelper.log>. (Which B<dh_clean> deletes.) So B<dh> can "
1617 "tell which commands have already been run, for which packages, and skip "
1618 "running those commands again."
1624 "Each time B<dh> is run, it examines the log, and finds the last logged "
1625 "command that is in the specified sequence. It then continues with the next "
1626 "command in the sequence. The B<--until>, B<--before>, B<--after>, and "
1627 "B<--remaining> options can override this behavior."
1633 "A sequence can also run dependent targets in debian/rules. For example, the "
1634 "\"binary\" sequence runs the \"install\" target."
1640 "B<dh> uses the B<DH_INTERNAL_OPTIONS> environment variable to pass "
1641 "information through to debhelper commands that are run inside override "
1642 "targets. The contents (and indeed, existence) of this environment variable, "
1643 "as the name might suggest, is subject to change at any time."
1649 "Commands in the B<build-indep>, B<install-indep> and B<binary-indep> "
1650 "sequences are passed the B<-i> option to ensure they only work on "
1651 "architecture independent packages, and commands in the B<build-arch>, "
1652 "B<install-arch> and B<binary-arch> sequences are passed the B<-a> option to "
1653 "ensure they only work on architecture dependent packages."
1658 msgid "DEPRECATED OPTIONS"
1664 "The following options are deprecated. It's much better to use override "
1670 msgid "B<--until> I<cmd>"
1675 msgid "Run commands in the sequence until and including I<cmd>, then stop."
1680 msgid "B<--before> I<cmd>"
1685 msgid "Run commands in the sequence before I<cmd>, then stop."
1690 msgid "B<--after> I<cmd>"
1695 msgid "Run commands in the sequence that come after I<cmd>."
1700 msgid "B<--remaining>"
1705 msgid "Run all commands in the sequence that have yet to be run."
1711 "In the above options, I<cmd> can be a full name of a debhelper command, or a "
1712 "substring. It'll first search for a command in the sequence exactly matching "
1713 "the name, to avoid any ambiguity. If there are multiple substring matches, "
1714 "the last one in the sequence will be used."
1718 #: dh:892 dh_auto_build:49 dh_auto_clean:52 dh_auto_configure:54 dh_auto_install:87 dh_auto_test:61 dh_builddeb:122 dh_clean:144 dh_compress:208 dh_fixperms:129 dh_gconf:101 dh_gencontrol:84 dh_install:260 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:80 dh_installlogrotate:52 dh_installman:261 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:244 dh_suidregister:119 dh_testdir:46 dh_testroot:29 dh_undocumented:30 dh_usrlocal:116
1719 msgid "L<debhelper(7)>"
1723 #: dh:894 dh_auto_build:51 dh_auto_clean:54 dh_auto_configure:56 dh_auto_install:89 dh_auto_test:63 dh_bugfiles:128 dh_builddeb:124 dh_clean:146 dh_compress:210 dh_desktop:35 dh_fixperms:131 dh_gconf:103 dh_gencontrol:86 dh_icons:69 dh_install:262 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:263 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:246 dh_suidregister:121 dh_testdir:48 dh_testroot:31 dh_undocumented:32 dh_usrlocal:118
1724 msgid "This program is a part of debhelper."
1729 msgid "dh_auto_build - automatically builds a package"
1735 "B<dh_auto_build> [S<I<build system options>>] [S<I<debhelper options>>] "
1736 "[S<B<--> I<params>>]"
1742 "B<dh_auto_build> is a debhelper program that tries to automatically build a "
1743 "package. It does so by running the appropriate command for the build system "
1744 "it detects the package uses. For example, if a F<Makefile> is found, this is "
1745 "done by running B<make> (or B<MAKE>, if the environment variable is set). If "
1746 "there's a F<setup.py>, or F<Build.PL>, it is run to build the package."
1752 "This is intended to work for about 90% of packages. If it doesn't work, "
1753 "you're encouraged to skip using B<dh_auto_build> at all, and just run the "
1754 "build process manually."
1758 #: dh_auto_build:30 dh_auto_clean:32 dh_auto_configure:33 dh_auto_install:45 dh_auto_test:33
1760 "See L<debhelper(7)/B<BUILD SYSTEM OPTIONS>> for a list of common build "
1761 "system selection and control options."
1765 #: dh_auto_build:35 dh_auto_clean:37 dh_auto_configure:38 dh_auto_install:56 dh_auto_test:38 dh_builddeb:35 dh_gencontrol:30 dh_installdebconf:69 dh_installinit:99 dh_makeshlibs:91 dh_shlibdeps:37
1766 msgid "B<--> I<params>"
1772 "Pass I<params> to the program that is run, after the parameters that "
1773 "B<dh_auto_build> usually passes."
1778 msgid "dh_auto_clean - automatically cleans up after a build"
1784 "B<dh_auto_clean> [S<I<build system options>>] [S<I<debhelper options>>] "
1785 "[S<B<--> I<params>>]"
1791 "B<dh_auto_clean> is a debhelper program that tries to automatically clean up "
1792 "after a package build. It does so by running the appropriate command for the "
1793 "build system it detects the package uses. For example, if there's a "
1794 "F<Makefile> and it contains a B<distclean>, B<realclean>, or B<clean> "
1795 "target, then this is done by running B<make> (or B<MAKE>, if the environment "
1796 "variable is set). If there is a F<setup.py> or F<Build.PL>, it is run to "
1797 "clean the package."
1803 "This is intended to work for about 90% of packages. If it doesn't work, or "
1804 "tries to use the wrong clean target, you're encouraged to skip using "
1805 "B<dh_auto_clean> at all, and just run B<make clean> manually."
1811 "Pass I<params> to the program that is run, after the parameters that "
1812 "B<dh_auto_clean> usually passes."
1816 #: dh_auto_configure:5
1817 msgid "dh_auto_configure - automatically configure a package prior to building"
1821 #: dh_auto_configure:14
1823 "B<dh_auto_configure> [S<I<build system options>>] [S<I<debhelper options>>] "
1824 "[S<B<--> I<params>>]"
1828 #: dh_auto_configure:18
1830 "B<dh_auto_configure> is a debhelper program that tries to automatically "
1831 "configure a package prior to building. It does so by running the appropriate "
1832 "command for the build system it detects the package uses. For example, it "
1833 "looks for and runs a F<./configure> script, F<Makefile.PL>, F<Build.PL>, or "
1834 "F<cmake>. A standard set of parameters is determined and passed to the "
1835 "program that is run. Some build systems, such as make, do not need a "
1836 "configure step; for these B<dh_auto_configure> will exit without doing "
1841 #: dh_auto_configure:27
1843 "This is intended to work for about 90% of packages. If it doesn't work, "
1844 "you're encouraged to skip using B<dh_auto_configure> at all, and just run "
1845 "F<./configure> or its equivalent manually."
1849 #: dh_auto_configure:40
1851 "Pass I<params> to the program that is run, after the parameters that "
1852 "B<dh_auto_configure> usually passes. For example:"
1856 #: dh_auto_configure:43
1859 " dh_auto_configure -- --with-foo --enable-bar\n"
1864 #: dh_auto_install:5
1865 msgid "dh_auto_install - automatically runs make install or similar"
1869 #: dh_auto_install:17
1871 "B<dh_auto_install> [S<I<build system options>>] [S<I<debhelper options>>] "
1872 "[S<B<--> I<params>>]"
1876 #: dh_auto_install:21
1878 "B<dh_auto_install> is a debhelper program that tries to automatically "
1879 "install built files. It does so by running the appropriate command for the "
1880 "build system it detects the package uses. For example, if there's a "
1881 "F<Makefile> and it contains a B<install> target, then this is done by "
1882 "running B<make> (or B<MAKE>, if the environment variable is set). If there "
1883 "is a F<setup.py> or F<Build.PL>, it is used. Note that the Ant build system "
1884 "does not support installation, so B<dh_auto_install> will not install files "
1889 #: dh_auto_install:29
1891 "Unless B<--destdir> option is specified, the files are installed into "
1892 "debian/I<package>/ if there is only one binary package. In the multiple "
1893 "binary package case, the files are instead installed into F<debian/tmp/>, "
1894 "and should be moved from there to the appropriate package build directory "
1895 "using L<dh_install(1)>."
1899 #: dh_auto_install:35
1901 "B<DESTDIR> is used to tell make where to install the files. If the Makefile "
1902 "was generated by MakeMaker from a F<Makefile.PL>, it will automatically set "
1903 "B<PREFIX=/usr> too, since such Makefiles need that."
1907 #: dh_auto_install:39
1909 "This is intended to work for about 90% of packages. If it doesn't work, or "
1910 "tries to use the wrong install target, you're encouraged to skip using "
1911 "B<dh_auto_install> at all, and just run make install manually."
1915 #: dh_auto_install:50 dh_builddeb:25
1916 msgid "B<--destdir=>I<directory>"
1920 #: dh_auto_install:52
1922 "Install files into the specified I<directory>. If this option is not "
1923 "specified, destination directory is determined automatically as described in "
1924 "the L</B<DESCRIPTION>> section."
1928 #: dh_auto_install:58
1930 "Pass I<params> to the program that is run, after the parameters that "
1931 "B<dh_auto_install> usually passes."
1936 msgid "dh_auto_test - automatically runs a package's test suites"
1942 "B<dh_auto_test> [S<I<build system options>>] [S<I<debhelper options>>] "
1943 "[S<B<--> I<params>>]"
1949 "B<dh_auto_test> is a debhelper program that tries to automatically run a "
1950 "package's test suite. It does so by running the appropriate command for the "
1951 "build system it detects the package uses. For example, if there's a Makefile "
1952 "and it contains a B<test> or B<check> target, then this is done by running "
1953 "B<make> (or B<MAKE>, if the environment variable is set). If the test suite "
1954 "fails, the command will exit nonzero. If there's no test suite, it will exit "
1955 "zero without doing anything."
1961 "This is intended to work for about 90% of packages with a test suite. If it "
1962 "doesn't work, you're encouraged to skip using B<dh_auto_test> at all, and "
1963 "just run the test suite manually."
1969 "Pass I<params> to the program that is run, after the parameters that "
1970 "B<dh_auto_test> usually passes."
1976 "If the B<DEB_BUILD_OPTIONS> environment variable contains B<nocheck>, no "
1977 "tests will be performed."
1983 "dh_bugfiles - install bug reporting customization files into package build "
1989 msgid "B<dh_bugfiles> [B<-A>] [S<I<debhelper options>>]"
1995 "B<dh_bugfiles> is a debhelper program that is responsible for installing bug "
1996 "reporting customization files (bug scripts and/or bug control files and/or "
1997 "presubj files) into package build directories."
2001 #: 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
2007 msgid "debian/I<package>.bug-script"
2013 "This is the script to be run by the bug reporting program for generating a "
2014 "bug report template. This file is installed as F<usr/share/bug/package> in "
2015 "the package build directory if no other types of bug reporting customization "
2016 "files are going to be installed for the package in question. Otherwise, this "
2017 "file is installed as F<usr/share/bug/package/script>. Finally, the installed "
2018 "script is given execute permissions."
2023 msgid "debian/I<package>.bug-control"
2029 "It is the bug control file containing some directions for the bug reporting "
2030 "tool. This file is installed as F<usr/share/bug/package/control> in the "
2031 "package build directory."
2036 msgid "debian/I<package>.bug-presubj"
2042 "The contents of this file are displayed to the user by the bug reporting "
2043 "tool before allowing the user to write a bug report on the package to the "
2044 "Debian Bug Tracking System. This file is installed as "
2045 "F<usr/share/bug/package/presubj> in the package build directory."
2051 "Install F<debian/bug-*> files to ALL packages acted on when respective "
2052 "F<debian/package.bug-*> files do not exist. Normally, F<debian/bug-*> will "
2053 "be installed to the first package only."
2058 msgid "F</usr/share/doc/reportbug/README.developers.gz>"
2062 #: dh_bugfiles:126 dh_lintian:59
2063 msgid "L<debhelper(1)>"
2068 msgid "Modestas Vainius <modestas@vainius.eu>"
2073 msgid "dh_builddeb - build Debian binary packages"
2079 "B<dh_builddeb> [S<I<debhelper options>>] [B<--destdir=>I<directory>] "
2080 "[B<--filename=>I<name>] [S<B<--> I<params>>]"
2086 "B<dh_builddeb> simply calls L<dpkg-deb(1)> to build a Debian package or "
2093 "Use this if you want the generated F<.deb> files to be put in a directory "
2094 "other than the default of \"F<..>\"."
2099 msgid "B<--filename=>I<name>"
2105 "Use this if you want to force the generated .deb file to have a particular "
2106 "file name. Does not work well if more than one .deb is generated!"
2111 msgid "Pass I<params> to L<dpkg-deb(1)> when it is used to build the package."
2116 msgid "B<-u>I<params>"
2122 "This is another way to pass I<params> to L<dpkg-deb(1)>. It is deprecated; "
2123 "use B<--> instead."
2128 msgid "dh_clean - clean up package build directories"
2134 "B<dh_clean> [S<I<debhelper options>>] [B<-k>] [B<-d>] [B<-X>I<item>] "
2142 "B<dh_clean> is a debhelper program that is responsible for cleaning up after "
2144 "package is built. It removes the package build directories, and removes "
2146 "other files including F<debian/files>, and any detritus left behind by "
2148 "debhelper commands. It also removes common files that should not appear in "
2151 " #*# *~ DEADJOE *.orig *.rej *.SUMS TAGS .deps/* *.P *-stamp\n"
2158 "It does not run \"make clean\" to clean up after the build process. Use "
2159 "L<dh_auto_clean(1)> to do things like that."
2165 "B<dh_clean> (or \"B<dh clean>\") should be the last debhelper command run in "
2166 "the B<clean> target in F<debian/rules>."
2171 msgid "F<debian/clean>"
2176 msgid "Can list other files to be removed."
2180 #: dh_clean:45 dh_installchangelogs:60
2181 msgid "B<-k>, B<--keep>"
2186 msgid "This is deprecated, use L<dh_prep(1)> instead."
2191 msgid "B<-d>, B<--dirs-only>"
2197 "Only clean the package build directories, do not clean up any other files at "
2202 #: dh_clean:54 dh_prep:30
2203 msgid "B<-X>I<item> B<--exclude=>I<item>"
2209 "Exclude files that contain I<item> anywhere in their filename from being "
2210 "deleted, even if they would normally be deleted. You may use this option "
2211 "multiple times to build up a list of things to exclude."
2215 #: dh_clean:60 dh_compress:64 dh_installdocs:98 dh_installexamples:46 dh_installinfo:40 dh_installmanpages:44 dh_movefiles:55 dh_testdir:27
2221 msgid "Delete these I<file>s too."
2226 msgid "dh_compress - compress files and fix symlinks in package build directories"
2232 "B<dh_compress> [S<I<debhelper options>>] [B<-X>I<item>] [B<-A>] [S<I<file> "
2239 "B<dh_compress> is a debhelper program that is responsible for compressing "
2240 "the files in package build directories, and makes sure that any symlinks "
2241 "that pointed to the files before they were compressed are updated to point "
2248 "By default, B<dh_compress> compresses files that Debian policy mandates "
2249 "should be compressed, namely all files in F<usr/share/info>, "
2250 "F<usr/share/man>, files in F<usr/share/doc> that are larger than 4k in size, "
2251 "(except the F<copyright> file, F<.html> and other web files, image files, "
2252 "and files that appear to be already compressed based on their extensions), "
2253 "and all F<changelog> files. Plus PCF fonts underneath "
2254 "F<usr/share/fonts/X11/>"
2259 msgid "debian/I<package>.compress"
2264 msgid "These files are deprecated."
2270 "If this file exists, the default files are not compressed. Instead, the file "
2271 "is ran as a shell script, and all filenames that the shell script outputs "
2272 "will be compressed. The shell script will be run from inside the package "
2273 "build directory. Note though that using B<-X> is a much better idea in "
2274 "general; you should only use a F<debian/package.compress> file if you really "
2281 "Exclude files that contain F<item> anywhere in their filename from being "
2282 "compressed. For example, B<-X.tiff> will exclude TIFF files from "
2283 "compression. You may use this option multiple times to build up a list of "
2284 "things to exclude."
2290 "Compress all files specified by command line parameters in ALL packages "
2296 msgid "Add these files to the list of files to compress."
2300 #: dh_compress:70 dh_perl:61 dh_python:66 dh_strip:74 dh_usrlocal:55
2306 msgid "Debian policy, version 3.0"
2311 msgid "dh_desktop - deprecated no-op"
2316 msgid "B<dh_desktop> [S<I<debhelper options>>]"
2322 "B<dh_desktop> was a debhelper program that registers F<.desktop> files. "
2323 "However, it no longer does anything, and is now deprecated."
2329 "If a package ships F<desktop> files, they just need to be installed in the "
2330 "correct location (F</usr/share/applications>) and they will be registered by "
2331 "the appropriate tools for the corresponding desktop environments."
2335 #: dh_desktop:33 dh_icons:67 dh_scrollkeeper:30
2336 msgid "L<debhelper>"
2340 #: dh_desktop:39 dh_scrollkeeper:36
2341 msgid "Ross Burton <ross@burtonini.com>"
2346 msgid "dh_fixperms - fix permissions of files in package build directories"
2351 msgid "B<dh_fixperms> [S<I<debhelper options>>] [B<-X>I<item>]"
2357 "B<dh_fixperms> is a debhelper program that is responsible for setting the "
2358 "permissions of files and directories in package build directories to a sane "
2359 "state -- a state that complies with Debian policy."
2365 "B<dh_fixperms> makes all files in F<usr/share/doc> in the package build "
2366 "directory (excluding files in the F<examples/> directory) be mode 644. It "
2367 "also changes the permissions of all man pages to mode 644. It makes all "
2368 "files be owned by root, and it removes group and other write permission from "
2369 "all files. It removes execute permissions from any libraries, headers, Perl "
2370 "modules, or desktop files that have it set. It makes all files in the "
2371 "standard F<bin> and F<sbin> directories, F<usr/games/> and F<etc/init.d> "
2372 "executable (since v4). Finally, it removes the setuid and setgid bits from "
2373 "all files in the package."
2378 msgid "B<-X>I<item>, B<--exclude> I<item>"
2384 "Exclude files that contain I<item> anywhere in their filename from having "
2385 "their permissions changed. You may use this option multiple times to build "
2386 "up a list of things to exclude."
2391 msgid "dh_gconf - install GConf defaults files and register schemas"
2396 msgid "B<dh_gconf> [S<I<debhelper options>>] [B<--priority=>I<priority>]"
2402 "B<dh_gconf> is a debhelper program that is responsible for installing GConf "
2403 "defaults files and registering GConf schemas."
2408 msgid "An appropriate dependency on gconf2 will be generated in B<${misc:Depends}>."
2413 msgid "debian/I<package>.gconf-defaults"
2419 "Installed into F<usr/share/gconf/defaults/10_package> in the package build "
2420 "directory, with I<package> replaced by the package name."
2425 msgid "debian/I<package>.gconf-mandatory"
2431 "Installed into F<usr/share/gconf/mandatory/10_package> in the package build "
2432 "directory, with I<package> replaced by the package name."
2437 msgid "B<--priority> I<priority>"
2443 "Use I<priority> (which should be a 2-digit number) as the defaults priority "
2444 "instead of B<10>. Higher values than ten can be used by derived "
2445 "distributions (B<20>), CDD distributions (B<50>), or site-specific packages "
2451 msgid "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>"
2456 msgid "dh_gencontrol - generate and install control file"
2461 msgid "B<dh_gencontrol> [S<I<debhelper options>>] [S<B<--> I<params>>]"
2467 "B<dh_gencontrol> is a debhelper program that is responsible for generating "
2468 "control files, and installing them into the I<DEBIAN> directory with the "
2469 "proper permissions."
2475 "This program is merely a wrapper around L<dpkg-gencontrol(1)>, which calls "
2476 "it once for each package being acted on, and passes in some additional "
2482 msgid "Pass I<params> to L<dpkg-gencontrol(1)>."
2487 msgid "B<-u>I<params>, B<--dpkg-gencontrol-params=>I<params>"
2493 "This is another way to pass I<params> to L<dpkg-gencontrol(1)>. It is "
2494 "deprecated; use B<--> instead."
2499 msgid "dh_icons - Update Freedesktop icon caches"
2504 msgid "B<dh_icons> [S<I<debhelper options>>] [B<-n>]"
2510 "B<dh_icons> is a debhelper program that updates Freedesktop icon caches when "
2511 "needed, using the B<update-icon-caches> program provided by GTK+2.12. "
2512 "Currently this program does not handle installation of the files, though it "
2513 "may do so at a later date. It takes care of adding maintainer script "
2514 "fragments to call B<update-icon-caches>."
2518 #: 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
2519 msgid "B<-n>, B<--noscripts>"
2524 msgid "Do not modify maintainer scripts."
2530 "Ross Burton <ross@burtonini.com> Jordi Mallach <jordi@debian.org> Josselin "
2531 "Mouette <joss@debian.org>"
2536 msgid "dh_install - install files into package build directories"
2542 "B<dh_install> [B<-X>I<item>] [B<--autodest>] [B<--sourcedir=>I<dir>] "
2543 "[S<I<debhelper options>>] [S<I<file> ... I<dest>>]"
2549 "B<dh_install> is a debhelper program that handles installing files into "
2550 "package build directories. There are many B<dh_install>I<*> commands that "
2551 "handle installing specific types of files such as documentation, examples, "
2552 "man pages, and so on, and they should be used when possible as they often "
2553 "have extra intelligence for those particular tasks. B<dh_install>, then, is "
2554 "useful for installing everything else, for which no particular intelligence "
2555 "is needed. It is a replacement for the old B<dh_movefiles> command."
2561 "This program may be used in one of two ways. If you just have a file or two "
2562 "that the upstream Makefile does not install for you, you can run "
2563 "B<dh_install> on them to move them into place. On the other hand, maybe you "
2564 "have a large package that builds multiple binary packages. You can use the "
2565 "upstream F<Makefile> to install it all into F<debian/tmp>, and then use "
2566 "B<dh_install> to copy directories and files from there into the proper "
2567 "package build directories."
2573 "From debhelper compatibility level 7 on, B<dh_install> will fall back to "
2574 "looking in F<debian/tmp> for files, if it doesn't find them in the current "
2575 "directory (or whereever you've told it to look using B<--sourcedir>)."
2580 msgid "debian/I<package>.install"
2586 "List the files to install into each package and the directory they should be "
2587 "installed to. The format is a set of lines, where each line lists a file or "
2588 "files to install, and at the end of the line tells the directory it should "
2589 "be installed in. The name of the files (or directories) to install should be "
2590 "given relative to the current directory, while the installation directory is "
2591 "given relative to the package build directory. You may use wildcards in the "
2592 "names of the files to install (in v3 mode and above)."
2597 msgid "B<--list-missing>"
2603 "This option makes B<dh_install> keep track of the files it installs, and "
2604 "then at the end, compare that list with the files in the source "
2605 "directory. If any of the files (and symlinks) in the source directory were "
2606 "not installed to somewhere, it will warn on stderr about that."
2612 "This may be useful if you have a large package and want to make sure that "
2613 "you don't miss installing newly added files in new upstream releases."
2619 "Note that files that are excluded from being moved via the B<-X> option are "
2625 msgid "B<--fail-missing>"
2631 "This option is like B<--list-missing>, except if a file was missed, it will "
2632 "not only list the missing files, but also fail with a nonzero exit code."
2636 #: dh_install:78 dh_installexamples:43
2638 "Exclude files that contain I<item> anywhere in their filename from being "
2643 #: dh_install:81 dh_movefiles:42
2644 msgid "B<--sourcedir=>I<dir>"
2649 msgid "Look in the specified directory for files to be installed."
2655 "Note that this is not the same as the B<--sourcedirectory> option used by "
2656 "the B<dh_auto_>I<*> commands. You rarely need to use this option, since "
2657 "B<dh_install> automatically looks for files in F<debian/tmp> in debhelper "
2658 "compatibility level 7 and above."
2663 msgid "B<--autodest>"
2669 "Guess as the destination directory to install things to. If this is "
2670 "specified, you should not list destination directories in "
2671 "F<debian/package.install> files or on the command line. Instead, "
2672 "B<dh_install> will guess as follows:"
2678 "Strip off F<debian/tmp> (or the sourcedir if one is given) from the front of "
2679 "the filename, if it is present, and install into the dirname of the "
2680 "filename. So if the filename is F<debian/tmp/usr/bin>, then that directory "
2681 "will be copied to F<debian/package/usr/>. If the filename is "
2682 "F<debian/tmp/etc/passwd>, it will be copied to F<debian/package/etc/>."
2688 "Note that if you list exactly one filename or wildcard-pattern on a line by "
2689 "itself in a F<debian/package.install> file, with no explicit destination, "
2690 "then B<dh_install> will automatically guess the destination even if this "
2696 msgid "I<file> ... I<dest>"
2702 "Lists files (or directories) to install and where to install them to. The "
2703 "files will be installed into the first package F<dh_install> acts on."
2715 "B<dh_install> cannot rename files or directories, it can only install them\n"
2716 "with the names they already have into wherever you want in the package\n"
2722 #: dh_installcatalogs:5
2723 msgid "dh_installcatalogs - install and register SGML Catalogs"
2727 #: dh_installcatalogs:16
2728 msgid "B<dh_installcatalogs> [S<I<debhelper options>>] [B<-n>]"
2732 #: dh_installcatalogs:20
2734 "B<dh_installcatalogs> is a debhelper program that installs and registers "
2735 "SGML catalogs. It complies with the Debian XML/SGML policy."
2739 #: dh_installcatalogs:23
2741 "Catalogs will be registered in a supercatalog, in "
2742 "F</etc/sgml/I<package>.cat>."
2746 #: dh_installcatalogs:26
2748 "This command automatically adds maintainer script snippets for registering "
2749 "and unregistering the catalogs and supercatalogs (unless B<-n> is "
2750 "used). These snippets are inserted into the maintainer scripts by "
2751 "B<dh_installdeb>; see L<dh_installdeb(1)> for an explanation of Debhelper "
2752 "maintainer script snippets."
2756 #: dh_installcatalogs:32
2758 "A dependency on B<sgml-base> will be added to B<${misc:Depends}>, so be sure "
2759 "your package uses that variable in F<debian/control>."
2763 #: dh_installcatalogs:39
2764 msgid "debian/I<package>.sgmlcatalogs"
2768 #: dh_installcatalogs:41
2770 "Lists the catalogs to be installed per package. Each line in that file "
2771 "should be of the form C<I<source> I<dest>>, where I<source> indicates where "
2772 "the catalog resides in the source tree, and I<dest> indicates the "
2773 "destination location for the catalog under the package build area. I<dest> "
2774 "should start with F</usr/share/sgml/>."
2778 #: dh_installcatalogs:55 dh_installinit:54
2779 msgid "Do not modify F<postinst>/F<postrm>/F<prerm> scripts."
2783 #: 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
2785 "Note that this command is not idempotent. L<dh_prep(1)> should be called "
2786 "between invocations of this command. Otherwise, it may cause multiple "
2787 "instances of the same text to be added to maintainer scripts."
2791 #: dh_installcatalogs:120
2792 msgid "F</usr/share/doc/sgml-base-doc/>"
2796 #: dh_installcatalogs:124
2797 msgid "Adam Di Carlo <aph@debian.org>"
2801 #: dh_installchangelogs:5
2802 msgid "dh_installchangelogs - install changelogs into package build directories"
2806 #: dh_installchangelogs:14
2808 "B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] "
2813 #: dh_installchangelogs:18
2815 "B<dh_installchangelogs> is a debhelper program that is responsible for "
2816 "installing changelogs into package build directories."
2820 #: dh_installchangelogs:21
2822 "An upstream F<changelog> file may be specified as an option. If none is "
2823 "specified, it looks for files with names that seem likely to be changelogs. "
2824 "(In compatibility level 7 and above.)"
2828 #: dh_installchangelogs:25
2830 "If there is an upstream F<changelog> file, it will be be installed as "
2831 "F<usr/share/doc/package/changelog> in the package build directory. If the "
2832 "changelog is a F<html> file (determined by file extension), it will be "
2833 "installed as F<usr/share/doc/package/changelog.html> instead, and will be "
2834 "converted to plain text with B<html2text> to generate "
2835 "F<usr/share/doc/package/changelog>."
2839 #: dh_installchangelogs:36
2840 msgid "F<debian/changelog>"
2844 #: dh_installchangelogs:38
2845 msgid "F<debian/NEWS>"
2849 #: dh_installchangelogs:40
2850 msgid "debian/I<package>.changelog"
2854 #: dh_installchangelogs:42
2855 msgid "debian/I<package>.NEWS"
2859 #: dh_installchangelogs:44
2861 "Automatically installed into usr/share/doc/I<package>/ in the package build "
2866 #: dh_installchangelogs:47
2868 "Use the package specific name if I<package> needs a different F<NEWS> or "
2869 "F<changelog> file."
2873 #: dh_installchangelogs:50
2875 "The F<changelog> file is installed with a name of changelog for native "
2876 "packages, and F<changelog.Debian> for non-native packages. The F<NEWS> file "
2877 "is always installed with a name of F<NEWS.Debian>."
2881 #: dh_installchangelogs:62
2883 "Keep the original name of the upstream changelog. This will be accomplished "
2884 "by installing the upstream changelog as F<changelog>, and making a symlink "
2885 "from that to the original name of the F<changelog> file. This can be useful "
2886 "if the upstream changelog has an unusual name, or if other documentation in "
2887 "the package refers to the F<changelog> file."
2891 #: dh_installchangelogs:70
2893 "Exclude upstream F<changelog> files that contain I<item> anywhere in their "
2894 "filename from being installed."
2898 #: dh_installchangelogs:73
2903 #: dh_installchangelogs:75
2904 msgid "Install this file as the upstream changelog."
2909 msgid "dh_installcron - install cron scripts into etc/cron.*"
2913 #: dh_installcron:14
2914 msgid "B<dh_installcron> [S<B<debhelper options>>] [B<--name=>I<name>]"
2918 #: dh_installcron:18
2920 "B<dh_installcron> is a debhelper program that is responsible for installing "
2925 #: dh_installcron:25
2926 msgid "debian/I<package>.cron.daily"
2930 #: dh_installcron:27
2931 msgid "debian/I<package>.cron.weekly"
2935 #: dh_installcron:29
2936 msgid "debian/I<package>.cron.monthly"
2940 #: dh_installcron:31
2941 msgid "debian/I<package>.cron.hourly"
2945 #: dh_installcron:33
2946 msgid "debian/I<package>.cron.d"
2950 #: dh_installcron:35
2952 "Installed into the appropriate F<etc/cron.*/> directory in the package build "
2957 #: dh_installcron:44 dh_installifupdown:43 dh_installinit:104 dh_installlogcheck:46 dh_installlogrotate:26 dh_installmodules:52 dh_installpam:35 dh_installppp:39 dh_installudev:39
2958 msgid "B<--name=>I<name>"
2962 #: dh_installcron:46
2964 "Look for files named F<debian/package.name.cron.*> and install them as "
2965 "F<etc/cron.*/name>, instead of using the usual files and installing them as "
2971 msgid "dh_installdeb - install files into the DEBIAN directory"
2976 msgid "B<dh_installdeb> [S<I<debhelper options>>]"
2982 "B<dh_installdeb> is a debhelper program that is responsible for installing "
2983 "files into the F<DEBIAN> directories in package build directories with the "
2984 "correct permissions."
2989 msgid "I<package>.postinst"
2994 msgid "I<package>.preinst"
2999 msgid "I<package>.postrm"
3004 msgid "I<package>.prerm"
3009 msgid "These maintainer scripts are installed into the F<DEBIAN> directory."
3015 "Inside the scripts, the token B<#DEBHELPER#> is replaced with shell script "
3016 "snippets generated by other debhelper commands."
3021 msgid "I<package>.triggers"
3026 msgid "I<package>.shlibs"
3031 msgid "These control files are installed into the F<DEBIAN> directory."
3036 msgid "I<package>.conffiles"
3041 msgid "This control file will be installed into the F<DEBIAN> directory."
3047 "In v3 compatibility mode and higher, all files in the F<etc/> directory in a "
3048 "package will automatically be flagged as conffiles by this program, so there "
3049 "is no need to list them manually here."
3054 msgid "I<package>.maintscript"
3060 "Lines in this file correspond to L<dpkg-maintscript-helper(1)> commands and "
3061 "parameters. Any shell metacharacters will be escaped, so arbitrary shell "
3062 "code cannot be inserted here. For example, a line such as C<mv_conffile "
3063 "/etc/oldconffile /etc/newconffile> will insert maintainer script snippets "
3064 "into all maintainer scripts sufficient to move that conffile."
3070 "A versioned Pre-Dependency on dpkg is needed to use "
3071 "L<dpkg-maintscript-helper(1)>. An appropriate Pre-Dependency is set in "
3072 "${misc:Pre-Depends} ; you should make sure to put that token into an "
3073 "appropriate place in your debian/control file."
3077 #: dh_installdebconf:5
3079 "dh_installdebconf - install files used by debconf in package build "
3084 #: dh_installdebconf:14
3085 msgid "B<dh_installdebconf> [S<I<debhelper options>>] [B<-n>] [S<B<--> I<params>>]"
3089 #: dh_installdebconf:18
3091 "B<dh_installdebconf> is a debhelper program that is responsible for "
3092 "installing files used by debconf into package build directories."
3096 #: dh_installdebconf:21
3098 "It also automatically generates the F<postrm> commands needed to interface "
3099 "with debconf. The commands are added to the maintainer scripts by "
3100 "B<dh_installdeb>. See L<dh_installdeb(1)> for an explanation of how that "
3105 #: dh_installdebconf:26
3107 "Note that if you use debconf, your package probably needs to depend on it "
3108 "(it will be added to B<${misc:Depends}> by this program)."
3112 #: dh_installdebconf:29
3114 "Note that for your config script to be called by B<dpkg>, your F<postinst> "
3115 "needs to source debconf's confmodule. B<dh_installdebconf> does not install "
3116 "this statement into the F<postinst> automatically as it is too hard to do it "
3121 #: dh_installdebconf:38
3122 msgid "debian/I<package>.config"
3126 #: dh_installdebconf:40
3128 "This is the debconf F<config> script, and is installed into the F<DEBIAN> "
3129 "directory in the package build directory."
3133 #: dh_installdebconf:43
3135 "Inside the script, the token B<#DEBHELPER#> is replaced with shell script "
3136 "snippets generated by other debhelper commands."
3140 #: dh_installdebconf:46
3141 msgid "debian/I<package>.templates"
3145 #: dh_installdebconf:48
3147 "This is the debconf F<templates> file, and is installed into the F<DEBIAN> "
3148 "directory in the package build directory."
3152 #: dh_installdebconf:51
3153 msgid "F<debian/po/>"
3157 #: dh_installdebconf:53
3159 "If this directory is present, this program will automatically use "
3160 "L<po2debconf(1)> to generate merged templates files that include the "
3161 "translations from there."
3165 #: dh_installdebconf:57
3166 msgid "For this to work, your package should build-depend on F<po-debconf>."
3170 #: dh_installdebconf:67
3171 msgid "Do not modify F<postrm> script."
3175 #: dh_installdebconf:71
3176 msgid "Pass the params to B<po2debconf>."
3181 msgid "dh_installdirs - create subdirectories in package build directories"
3185 #: dh_installdirs:14
3186 msgid "B<dh_installdirs> [S<I<debhelper options>>] [B<-A>] [S<I<dir> ...>]"
3190 #: dh_installdirs:18
3192 "B<dh_installdirs> is a debhelper program that is responsible for creating "
3193 "subdirectories in package build directories."
3197 #: dh_installdirs:25
3198 msgid "debian/I<package>.dirs"
3202 #: dh_installdirs:27
3203 msgid "Lists directories to be created in I<package>."
3207 #: dh_installdirs:37
3209 "Create any directories specified by command line parameters in ALL packages "
3210 "acted on, not just the first."
3214 #: dh_installdirs:40
3219 #: dh_installdirs:42
3221 "Create these directories in the package build directory of the first package "
3222 "acted on. (Or in all packages if B<-A> is specified.)"
3227 msgid "dh_installdocs - install documentation into package build directories"
3231 #: dh_installdocs:14
3233 "B<dh_installdocs> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] "
3238 #: dh_installdocs:18
3240 "B<dh_installdocs> is a debhelper program that is responsible for installing "
3241 "documentation into F<usr/share/doc/package> in package build directories."
3245 #: dh_installdocs:25
3246 msgid "debian/I<package>.docs"
3250 #: dh_installdocs:27
3251 msgid "List documentation files to be installed into I<package>."
3255 #: dh_installdocs:29
3256 msgid "F<debian/copyright>"
3260 #: dh_installdocs:31
3262 "The copyright file is installed into all packages, unless a more specific "
3263 "copyright file is available."
3267 #: dh_installdocs:34
3268 msgid "debian/I<package>.copyright"
3272 #: dh_installdocs:36
3273 msgid "debian/I<package>.README.Debian"
3277 #: dh_installdocs:38
3278 msgid "debian/I<package>.TODO"
3282 #: dh_installdocs:40
3283 msgid "Each of these files is automatically installed if present for a I<package>."
3287 #: dh_installdocs:43
3288 msgid "F<debian/README.Debian>"
3292 #: dh_installdocs:45
3293 msgid "F<debian/TODO>"
3297 #: dh_installdocs:47
3299 "These files are installed into the first binary package listed in "
3304 #: dh_installdocs:50
3306 "Note that F<README.debian> files are also installed as F<README.Debian>, and "
3307 "F<TODO> files will be installed as F<TODO.Debian> in non-native packages."
3311 #: dh_installdocs:53
3312 msgid "debian/I<package>.doc-base"
3316 #: dh_installdocs:55
3318 "Installed as doc-base control files. Note that the doc-id will be determined "
3319 "from the B<Document:> entry in the doc-base control file in question."
3323 #: dh_installdocs:59
3324 msgid "debian/I<package>.doc-base.*"
3328 #: dh_installdocs:61
3330 "If your package needs to register more than one document, you need multiple "
3331 "doc-base files, and can name them like this."
3335 #: dh_installdocs:72 dh_installinfo:37 dh_installman:66
3337 "Install all files specified by command line parameters in ALL packages acted "
3342 #: dh_installdocs:77
3344 "Exclude files that contain I<item> anywhere in their filename from being "
3345 "installed. Note that this includes doc-base files."
3349 #: dh_installdocs:80
3350 msgid "B<--link-doc=>I<package>"
3354 #: dh_installdocs:82
3356 "Make the documentation directory of all packages acted on be a symlink to "
3357 "the documentation directory of I<package>. This has no effect when acting on "
3358 "I<package> itself, or if the documentation directory to be created already "
3359 "exists when B<dh_installdocs> is run. To comply with policy, I<package> must "
3360 "be a binary package that comes from the same source package."
3364 #: dh_installdocs:88
3366 "debhelper will try to avoid installing files into linked documentation "
3367 "directories that would cause conflicts with the linked package. The B<-A> "
3368 "option will have no effect on packages with linked documentation "
3369 "directories, and F<copyright>, F<changelog>, F<README.Debian>, and F<TODO> "
3370 "files will not be installed."
3374 #: dh_installdocs:94
3376 "(An older method to accomplish the same thing, which is still supported, is "
3377 "to make the documentation directory of a package be a dangling symlink, "
3378 "before calling B<dh_installdocs>.)"
3382 #: dh_installdocs:100
3384 "Install these files as documentation into the first package acted on. (Or in "
3385 "all packages if B<-A> is specified)."
3389 #: dh_installdocs:107
3390 msgid "This is an example of a F<debian/package.docs> file:"
3394 #: dh_installdocs:109
3399 " debian/notes-for-maintainers.txt\n"
3400 " docs/manual.txt\n"
3401 " docs/manual.pdf\n"
3402 " docs/manual-html/\n"
3407 #: dh_installdocs:118
3409 "Note that B<dh_installdocs> will happily copy entire directory hierarchies "
3410 "if you ask it to (similar to B<cp -a>). If it is asked to install a "
3411 "directory, it will install the complete contents of the directory."
3415 #: dh_installemacsen:5
3416 msgid "dh_installemacsen - register an Emacs add on package"
3420 #: dh_installemacsen:14
3422 "B<dh_installemacsen> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] "
3423 "[B<--flavor=>I<foo>]"
3427 #: dh_installemacsen:18
3429 "B<dh_installemacsen> is a debhelper program that is responsible for "
3430 "installing files used by the Debian B<emacsen-common> package into package "
3431 "build directories."
3435 #: dh_installemacsen:22
3437 "It also automatically generates the F<postinst> and F<prerm> commands needed "
3438 "to register a package as an Emacs add on package. The commands are added to "
3439 "the maintainer scripts by B<dh_installdeb>. See L<dh_installdeb(1)> for an "
3440 "explanation of how this works."
3444 #: dh_installemacsen:31
3445 msgid "debian/I<package>.emacsen-install"
3449 #: dh_installemacsen:33
3451 "Installed into F<usr/lib/emacsen-common/packages/install/package> in the "
3452 "package build directory."
3456 #: dh_installemacsen:36
3457 msgid "debian/I<package>.emacsen-remove"
3461 #: dh_installemacsen:38
3463 "Installed into F<usr/lib/emacsen-common/packages/remove/package> in the "
3464 "package build directory."
3468 #: dh_installemacsen:41
3469 msgid "debian/I<package>.emacsen-startup"
3473 #: dh_installemacsen:43
3475 "Installed into etc/emacs/site-start.d/50I<package>.el in the package build "
3476 "directory. Use B<--priority> to use a different priority than 50."
3480 #: dh_installemacsen:54 dh_python:62 dh_usrlocal:45
3481 msgid "Do not modify F<postinst>/F<prerm> scripts."
3485 #: dh_installemacsen:56 dh_installwm:38
3486 msgid "B<--priority=>I<n>"
3490 #: dh_installemacsen:58
3491 msgid "Sets the priority number of a F<site-start.d> file. Default is 50."
3495 #: dh_installemacsen:60
3496 msgid "B<--flavor=>I<foo>"
3500 #: dh_installemacsen:62
3502 "Sets the flavor a F<site-start.d> file will be installed in. Default is "
3503 "B<emacs>, alternatives include B<xemacs> and B<emacs20>."
3507 #: dh_installexamples:5
3508 msgid "dh_installexamples - install example files into package build directories"
3512 #: dh_installexamples:14
3514 "B<dh_installexamples> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] "
3519 #: dh_installexamples:18
3521 "B<dh_installexamples> is a debhelper program that is responsible for "
3522 "installing examples into F<usr/share/doc/package/examples> in package build "
3527 #: dh_installexamples:26
3528 msgid "debian/I<package>.examples"
3532 #: dh_installexamples:28
3533 msgid "Lists example files or directories to be installed."
3537 #: dh_installexamples:38
3539 "Install any files specified by command line parameters in ALL packages acted "
3544 #: dh_installexamples:48
3546 "Install these files (or directories) as examples into the first package "
3547 "acted on. (Or into all packages if B<-A> is specified.)"
3551 #: dh_installexamples:55
3553 "Note that B<dh_installexamples> will happily copy entire directory "
3554 "hierarchies if you ask it to (similar to B<cp -a>). If it is asked to "
3555 "install a directory, it will install the complete contents of the directory."
3559 #: dh_installifupdown:5
3560 msgid "dh_installifupdown - install if-up and if-down hooks"
3564 #: dh_installifupdown:14
3565 msgid "B<dh_installifupdown> [S<I<debhelper options>>] [B<--name=>I<name>]"
3569 #: dh_installifupdown:18
3571 "B<dh_installifupdown> is a debhelper program that is responsible for "
3572 "installing F<if-up>, F<if-down>, F<if-pre-up>, and F<if-post-down> hook "
3573 "scripts into package build directories."
3577 #: dh_installifupdown:26
3578 msgid "debian/I<package>.if-up"
3582 #: dh_installifupdown:28
3583 msgid "debian/I<package>.if-down"
3587 #: dh_installifupdown:30
3588 msgid "debian/I<package>.if-pre-up"
3592 #: dh_installifupdown:32
3593 msgid "debian/I<package>.if-post-down"
3597 #: dh_installifupdown:34
3599 "These files are installed into etc/network/if-*.d/I<package> in the package "
3604 #: dh_installifupdown:45
3606 "Look for files named F<debian/package.name.if-*> and install them as "
3607 "F<etc/network/if-*/name>, instead of using the usual files and installing "
3608 "them as the package name."
3613 msgid "dh_installinfo - install info files"
3617 #: dh_installinfo:14
3618 msgid "B<dh_installinfo> [S<I<debhelper options>>] [B<-A>] [S<I<file> ...>]"
3622 #: dh_installinfo:18
3624 "B<dh_installinfo> is a debhelper program that is responsible for installing "
3625 "info files into F<usr/share/info> in the package build directory."
3629 #: dh_installinfo:25
3630 msgid "debian/I<package>.info"
3634 #: dh_installinfo:27
3635 msgid "List info files to be installed."
3639 #: dh_installinfo:42
3641 "Install these info files into the first package acted on. (Or in all "
3642 "packages if B<-A> is specified)."
3648 "dh_installinit - install upstart jobs or init scripts into package build "
3653 #: dh_installinit:14
3655 "B<dh_installinit> [S<I<debhelper options>>] [B<--name=>I<name>] [B<-n>] "
3656 "[B<-R>] [B<-r>] [B<-d>] [S<B<--> I<params>>]"
3660 #: dh_installinit:18
3662 "B<dh_installinit> is a debhelper program that is responsible for installing "
3663 "upstart job files or init scripts with associated defaults files into "
3664 "package build directories, and in the former case providing compatibility "
3665 "handling for non-upstart systems."
3669 #: dh_installinit:23
3671 "It also automatically generates the F<postinst> and F<postrm> and F<prerm> "
3672 "commands needed to set up the symlinks in F</etc/rc*.d/> to start and stop "
3677 #: dh_installinit:31
3678 msgid "debian/I<package>.upstart"
3682 #: dh_installinit:33
3684 "If this exists, it is installed into etc/init/I<package>.conf in the package "
3689 #: dh_installinit:36
3690 msgid "debian/I<package>.init"
3694 #: dh_installinit:38
3696 "Otherwise, if this exists, it is installed into etc/init.d/I<package> in the "
3697 "package build directory."
3701 #: dh_installinit:41
3702 msgid "debian/I<package>.default"
3706 #: dh_installinit:43
3708 "If this exists, it is installed into etc/default/I<package> in the package "
3713 #: dh_installinit:56
3714 msgid "B<-o>, B<--onlyscripts>"
3718 #: dh_installinit:58
3720 "Only modify F<postinst>/F<postrm>/F<prerm> scripts, do not actually install "
3721 "any init script, default files, or upstart job. May be useful if the init "
3722 "script or upstart job is shipped and/or installed by upstream in a way that "
3723 "doesn't make it easy to let B<dh_installinit> find it."
3727 #: dh_installinit:63
3729 "If no upstart job file is installed in the target directory when "
3730 "B<dh_installinit --onlyscripts> is called, this program will assume that an "
3731 "init script is being installed and not provide the compatibility symlinks or "
3732 "upstart dependencies."
3736 #: dh_installinit:68
3737 msgid "B<-R>, B<--restart-after-upgrade>"
3741 #: dh_installinit:70
3743 "Do not stop the init script until after the package upgrade has been "
3744 "completed. This is different than the default behavior, which stops the "
3745 "script in the F<prerm>, and starts it again in the F<postinst>."
3749 #: dh_installinit:74
3751 "This can be useful for daemons that should not have a possibly long downtime "
3752 "during upgrade. But you should make sure that the daemon will not get "
3753 "confused by the package being upgraded while it's running before using this "
3758 #: dh_installinit:79
3759 msgid "B<-r>, B<--no-restart-on-upgrade>"
3763 #: dh_installinit:81
3764 msgid "Do not stop init script on upgrade."
3768 #: dh_installinit:83
3769 msgid "B<--no-start>"
3773 #: dh_installinit:85
3775 "Do not start the init script on install or upgrade, or stop it on removal. "
3776 "Only call B<update-rc.d>. Useful for rcS scripts."
3780 #: dh_installinit:88
3781 msgid "B<-d>, B<--remove-d>"
3785 #: dh_installinit:90
3787 "Remove trailing B<d> from the name of the package, and use the result for "
3788 "the filename the upstart job file is installed as in F<etc/init/> , or for "
3789 "the filename the init script is installed as in etc/init.d and the default "
3790 "file is installed as in F<etc/default/> . This may be useful for daemons "
3791 "with names ending in B<d>. (Note: this takes precedence over the "
3792 "B<--init-script> parameter described below.)"
3796 #: dh_installinit:97
3797 msgid "B<-u>I<params> B<--update-rcd-params=>I<params>"
3801 #: dh_installinit:101
3803 "Pass I<params> to L<update-rc.d(8)>. If not specified, B<defaults> will be "
3804 "passed to L<update-rc.d(8)>."
3808 #: dh_installinit:106
3810 "Install the upstart job file or the init script (and default file) using the "
3811 "filename I<name> instead of the default filename, which is the package "
3812 "name. When this parameter is used, B<dh_installinit> looks for and installs "
3813 "files named F<debian/package.name.upstart>, F<debian/package.name.init> and "
3814 "F<debian/package.name.default>, instead of the usual "
3815 "F<debian/package.upstart>, F<debian/package.init> and "
3816 "F<debian/package.default>."
3820 #: dh_installinit:113
3821 msgid "B<--init-script=>I<scriptname>"
3825 #: dh_installinit:115
3827 "Use I<scriptname> as the filename the init script is installed as in "
3828 "F<etc/init.d/> (and also use it as the filename for the defaults file, if it "
3829 "is installed). If you use this parameter, B<dh_installinit> will look to see "
3830 "if a file in the F<debian/> directory exists that looks like "
3831 "F<package.scriptname> and if so will install it as the init script in "
3832 "preference to the files it normally installs."
3836 #: dh_installinit:122
3838 "This parameter is deprecated, use the B<--name> parameter instead. This "
3839 "parameter will be ignored completely for upstart jobs."
3843 #: dh_installinit:125
3844 msgid "B<--error-handler=>I<function>"
3848 #: dh_installinit:127
3850 "Call the named shell I<function> if running the init script fails. The "
3851 "function should be provided in the F<prerm> and F<postinst> scripts, before "
3852 "the B<#DEBHELPER#> token."
3856 #: dh_installinit:281
3861 #: dh_installinit:285
3862 msgid "Steve Langasek <steve.langasek@canonical.com>"
3866 #: dh_installlogcheck:5
3867 msgid "dh_installlogcheck - install logcheck rulefiles into etc/logcheck/"
3871 #: dh_installlogcheck:14
3872 msgid "B<dh_installlogcheck> [S<I<debhelper options>>]"
3876 #: dh_installlogcheck:18
3878 "B<dh_installlogcheck> is a debhelper program that is responsible for "
3879 "installing logcheck rule files."
3883 #: dh_installlogcheck:25
3884 msgid "debian/I<package>.logcheck.cracking"
3888 #: dh_installlogcheck:27
3889 msgid "debian/I<package>.logcheck.violations"
3893 #: dh_installlogcheck:29
3894 msgid "debian/I<package>.logcheck.violations.ignore"
3898 #: dh_installlogcheck:31
3899 msgid "debian/I<package>.logcheck.ignore.workstation"
3903 #: dh_installlogcheck:33
3904 msgid "debian/I<package>.logcheck.ignore.server"
3908 #: dh_installlogcheck:35
3909 msgid "debian/I<package>.logcheck.ignore.paranoid"
3913 #: dh_installlogcheck:37
3915 "Each of these files, if present, are installed into corresponding "
3916 "subdirectories of F<etc/logcheck/> in package build directories."
3920 #: dh_installlogcheck:48
3922 "Look for files named F<debian/package.name.logcheck.*> and install them into "
3923 "the corresponding subdirectories of F<etc/logcheck/>, but use the specified "
3924 "name instead of that of the package."
3928 #: dh_installlogcheck:82
3931 "This program is a part of debhelper.\n"
3936 #: dh_installlogcheck:86
3937 msgid "Jon Middleton <jjm@debian.org>"
3941 #: dh_installlogrotate:5
3942 msgid "dh_installlogrotate - install logrotate config files"
3946 #: dh_installlogrotate:14
3947 msgid "B<dh_installlogrotate> [S<I<debhelper options>>] [B<--name=>I<name>]"
3951 #: dh_installlogrotate:18
3953 "B<dh_installlogrotate> is a debhelper program that is responsible for "
3954 "installing logrotate config files into F<etc/logrotate.d> in package build "
3955 "directories. Files named F<debian/package.logrotate> are installed."
3959 #: dh_installlogrotate:28
3961 "Look for files named F<debian/package.name.logrotate> and install them as "
3962 "F<etc/logrotate.d/name>, instead of using the usual files and installing "
3963 "them as the package name."
3968 msgid "dh_installman - install man pages into package build directories"
3973 msgid "B<dh_installman> [S<I<debhelper options>>] [S<I<manpage> ...>]"
3979 "B<dh_installman> is a debhelper program that handles installing man pages "
3980 "into the correct locations in package build directories. You tell it what "
3981 "man pages go in your packages, and it figures out where to install them "
3982 "based on the section field in their B<.TH> line. If you have a properly "
3983 "formatted B<.TH> line, your man page will be installed into the right "
3984 "directory, with the right name (this includes proper handling of pages with "
3985 "a subsection, like B<3perl>, which are placed in F<man3>, and given an "
3986 "extension of F<.3perl>). If your B<.TH> line is incorrect or missing, the "
3987 "program may guess wrong based on the file extension."
3993 "It also supports translated man pages, by looking for extensions like "
3994 "F<.ll.8> and F<.ll_LL.8>, or by use of the B<--language> switch."
4000 "If B<dh_installman> seems to install a man page into the wrong section or "
4001 "with the wrong extension, this is because the man page has the wrong section "
4002 "listed in its B<.TH> line. Edit the man page and correct the section, and "
4003 "B<dh_installman> will follow suit. See L<man(7)> for details about the "
4004 "B<.TH> section. If B<dh_installman> seems to install a man page into a "
4005 "directory like F</usr/share/man/pl/man1/>, that is because your program has "
4006 "a name like F<foo.pl>, and B<dh_installman> assumes that means it is "
4007 "translated into Polish. Use B<--language=C> to avoid this."
4013 "After the man page installation step, B<dh_installman> will check to see if "
4014 "any of the man pages in the temporary directories of any of the packages it "
4015 "is acting on contain F<.so> links. If so, it changes them to symlinks."
4021 "Also, B<dh_installman> will use man to guess the character encoding of each "
4022 "manual page and convert it to UTF-8. If the guesswork fails for some reason, "
4023 "you can override it using an encoding declaration. See L<manconv(1)> for "
4029 msgid "debian/I<package>.manpages"
4034 msgid "Lists man pages to be installed."
4039 msgid "B<--language=>I<ll>"
4045 "Use this to specify that the man pages being acted on are written in the "
4046 "specified language."
4051 msgid "I<manpage> ..."
4057 "Install these man pages into the first package acted on. (Or in all packages "
4058 "if B<-A> is specified)."
4064 "An older version of this program, L<dh_installmanpages(1)>, is still used by "
4065 "some packages, and so is still included in debhelper. It is, however, "
4066 "deprecated, due to its counterintuitive and inconsistent interface. Use this "
4071 #: dh_installmanpages:5
4072 msgid "dh_installmanpages - old-style man page installer (deprecated)"
4076 #: dh_installmanpages:15
4077 msgid "B<dh_installmanpages> [S<I<debhelper options>>] [S<I<file> ...>]"
4081 #: dh_installmanpages:19
4083 "B<dh_installmanpages> is a debhelper program that is responsible for "
4084 "automatically installing man pages into F<usr/share/man/> in package build "
4089 #: dh_installmanpages:23
4091 "This is a DWIM-style program, with an interface unlike the rest of "
4092 "debhelper. It is deprecated, and you are encouraged to use "
4093 "L<dh_installman(1)> instead."
4097 #: dh_installmanpages:27
4099 "B<dh_installmanpages> scans the current directory and all subdirectories for "
4100 "filenames that look like man pages. (Note that only real files are looked "
4101 "at; symlinks are ignored.) It uses L<file(1)> to verify that the files are "
4102 "in the correct format. Then, based on the files' extensions, it installs "
4103 "them into the correct man directory."
4107 #: dh_installmanpages:33
4109 "All filenames specified as parameters will be skipped by "
4110 "B<dh_installmanpages>. This is useful if by default it installs some man "
4111 "pages that you do not want to be installed."
4115 #: dh_installmanpages:37
4117 "After the man page installation step, B<dh_installmanpages> will check to "
4118 "see if any of the man pages are F<.so> links. If so, it changes them to "
4123 #: dh_installmanpages:46
4125 "Do not install these files as man pages, even if they look like valid man "
4130 #: dh_installmanpages:51
4135 #: dh_installmanpages:53
4137 "B<dh_installmanpages> will install the man pages it finds into B<all> "
4138 "packages you tell it to act on, since it can't tell what package the man "
4139 "pages belong in. This is almost never what you really want (use B<-p> to "
4140 "work around this, or use the much better L<dh_installman(1)> program "
4145 #: dh_installmanpages:58
4146 msgid "Files ending in F<.man> will be ignored."
4150 #: dh_installmanpages:60
4152 "Files specified as parameters that contain spaces in their filenames will "
4153 "not be processed properly."
4158 msgid "dh_installmenu - install Debian menu files into package build directories"
4162 #: dh_installmenu:14
4163 msgid "B<dh_installmenu> [S<B<debhelper options>>] [B<-n>]"
4167 #: dh_installmenu:18
4169 "B<dh_installmenu> is a debhelper program that is responsible for installing "
4170 "files used by the Debian B<menu> package into package build directories."
4174 #: dh_installmenu:21
4176 "It also automatically generates the F<postinst> and F<postrm> commands "
4177 "needed to interface with the Debian B<menu> package. These commands are "
4178 "inserted into the maintainer scripts by L<dh_installdeb(1)>."
4182 #: dh_installmenu:29
4183 msgid "debian/I<package>.menu"
4187 #: dh_installmenu:31
4189 "Debian menu files, installed into usr/share/menu/I<package> in the package "
4190 "build directory. See L<menufile(5)> for its format."
4194 #: dh_installmenu:34
4195 msgid "debian/I<package>.menu-method"
4199 #: dh_installmenu:36
4201 "Debian menu method files, installed into etc/menu-methods/I<package> in the "
4202 "package build directory."
4206 #: dh_installmenu:47 dh_installmime:47 dh_makeshlibs:79
4207 msgid "Do not modify F<postinst>/F<postrm> scripts."
4211 #: dh_installmenu:89
4212 msgid "L<debhelper(7)> L<update-menus(1)> L<menufile(5)>"
4217 msgid "dh_installmime - install mime files into package build directories"
4221 #: dh_installmime:14
4222 msgid "B<dh_installmime> [S<I<debhelper options>>] [B<-n>]"
4226 #: dh_installmime:18
4228 "B<dh_installmime> is a debhelper program that is responsible for installing "
4229 "mime files into package build directories."
4233 #: dh_installmime:21
4235 "It also automatically generates the F<postinst> and F<postrm> commands "
4236 "needed to interface with the debian B<mime-support> and B<shared-mime-info> "
4237 "packages. These commands are inserted into the maintainer scripts by "
4238 "L<dh_installdeb(1)>."
4242 #: dh_installmime:29
4243 msgid "debian/I<package>.mime"
4247 #: dh_installmime:31
4249 "Installed into usr/lib/mime/packages/I<package> in the package build "
4254 #: dh_installmime:34
4255 msgid "debian/I<package>.sharedmimeinfo"
4259 #: dh_installmime:36
4261 "Installed into /usr/share/mime/packages/I<package>.xml in the package build "
4266 #: dh_installmodules:5
4267 msgid "dh_installmodules - register modules with modutils"
4271 #: dh_installmodules:16
4272 msgid "B<dh_installmodules> [S<I<debhelper options>>] [B<-n>] [B<--name=>I<name>]"
4276 #: dh_installmodules:20
4278 "B<dh_installmodules> is a debhelper program that is responsible for "
4279 "registering kernel modules."
4283 #: dh_installmodules:23
4285 "Kernel modules are searched for in the package build directory and if found, "
4286 "F<preinst>, F<postinst> and F<postrm> commands are automatically generated "
4287 "to run B<depmod> and register the modules when the package is installed. "
4288 "These commands are inserted into the maintainer scripts by "
4289 "L<dh_installdeb(1)>."
4293 #: dh_installmodules:33
4294 msgid "debian/I<package>.modprobe"
4298 #: dh_installmodules:35
4299 msgid "Installed to etc/modprobe.d/I<package>.conf in the package build directory."
4303 #: dh_installmodules:37
4304 msgid "debian/I<package>.modules"
4308 #: dh_installmodules:39
4310 "These files were installed for use by modutils, but are now not used and "
4311 "B<dh_installmodules> will warn if these files are present."
4315 #: dh_installmodules:50
4316 msgid "Do not modify F<preinst>/F<postinst>/F<postrm> scripts."
4320 #: dh_installmodules:54
4322 "When this parameter is used, B<dh_installmodules> looks for and installs "
4323 "files named debian/I<package>.I<name>.modprobe instead of the usual "
4324 "debian/I<package>.modprobe"
4329 msgid "dh_installpam - install pam support files"
4334 msgid "B<dh_installpam> [S<I<debhelper options>>] [B<--name=>I<name>]"
4340 "B<dh_installpam> is a debhelper program that is responsible for installing "
4341 "files used by PAM into package build directories."
4346 msgid "debian/I<package>.pam"
4351 msgid "Installed into etc/pam.d/I<package> in the package build directory."
4357 "Look for files named debian/I<package>.I<name>.pam and install them as "
4358 "etc/pam.d/I<name>, instead of using the usual files and installing them "
4359 "using the package name."
4364 msgid "dh_installppp - install ppp ip-up and ip-down files"
4369 msgid "B<dh_installppp> [S<I<debhelper options>>] [B<--name=>I<name>]"
4375 "B<dh_installppp> is a debhelper program that is responsible for installing "
4376 "ppp ip-up and ip-down scripts into package build directories."
4381 msgid "debian/I<package>.ppp.ip-up"
4386 msgid "Installed into etc/ppp/ip-up.d/I<package> in the package build directory."
4391 msgid "debian/I<package>.ppp.ip-down"
4396 msgid "Installed into etc/ppp/ip-down.d/I<package> in the package build directory."
4402 "Look for files named F<debian/package.name.ppp.ip-*> and install them as "
4403 "F<etc/ppp/ip-*/name>, instead of using the usual files and installing them "
4404 "as the package name."
4409 msgid "dh_installudev - install udev rules files"
4413 #: dh_installudev:15
4415 "B<dh_installudev> [S<I<debhelper options>>] [B<-n>] [B<--name=>I<name>] "
4416 "[B<--priority=>I<priority>]"
4420 #: dh_installudev:19
4422 "B<dh_installudev> is a debhelper program that is responsible for installing "
4423 "B<udev> rules files."
4427 #: dh_installudev:22
4429 "Code is added to the F<preinst> and F<postinst> to handle the upgrade from "
4430 "the old B<udev> rules file location."
4434 #: dh_installudev:29
4435 msgid "debian/I<package>.udev"
4439 #: dh_installudev:31
4440 msgid "Installed into F<lib/udev/rules.d/> in the package build directory."
4444 #: dh_installudev:41
4446 "When this parameter is used, B<dh_installudev> looks for and installs files "
4447 "named debian/I<package>.I<name>.udev instead of the usual "
4448 "debian/I<package>.udev."
4452 #: dh_installudev:45
4453 msgid "B<--priority=>I<priority>"
4457 #: dh_installudev:47
4458 msgid "Sets the priority string of the F<rules.d> symlink. Default is 60."
4462 #: dh_installudev:51
4463 msgid "Do not modify F<preinst>/F<postinst> scripts."
4468 msgid "dh_installwm - register a window manager"
4474 "B<dh_installwm> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] "
4481 "B<dh_installwm> is a debhelper program that is responsible for generating "
4482 "the F<postinst> and F<prerm> commands that register a window manager with "
4483 "L<update-alternatives(8)>. The window manager's man page is also registered "
4484 "as a slave symlink (in v6 mode and up), if it is found in "
4485 "F<usr/share/man/man1/> in the package build directory."
4490 msgid "debian/I<package>.wm"
4495 msgid "List window manager programs to register."
4501 "Set the priority of the window manager. Default is 20, which is too low for "
4502 "most window managers; see the Debian Policy document for instructions on "
4503 "calculating the correct value."
4508 msgid "Do not modify F<postinst>/F<prerm> scripts. Turns this command into a no-op."
4518 msgid "Window manager programs to register."
4522 #: dh_installxfonts:5
4523 msgid "dh_installxfonts - register X fonts"
4527 #: dh_installxfonts:14
4528 msgid "B<dh_installxfonts> [S<I<debhelper options>>]"
4532 #: dh_installxfonts:18
4534 "B<dh_installxfonts> is a debhelper program that is responsible for "
4535 "registering X fonts, so their corresponding F<fonts.dir>, F<fonts.alias>, "
4536 "and F<fonts.scale> be rebuilt properly at install time."
4540 #: dh_installxfonts:22
4542 "Before calling this program, you should have installed any X fonts provided "
4543 "by your package into the appropriate location in the package build "
4544 "directory, and if you have F<fonts.alias> or F<fonts.scale> files, you "
4545 "should install them into the correct location under F<etc/X11/fonts> in your "
4546 "package build directory."
4550 #: dh_installxfonts:28
4552 "Your package should depend on B<xfonts-utils> so that the "
4553 "B<update-fonts->I<*> commands are available. (This program adds that "
4554 "dependency to B<${misc:Depends}>.)"
4558 #: dh_installxfonts:32
4560 "This program automatically generates the F<postinst> and F<postrm> commands "
4561 "needed to register X fonts. These commands are inserted into the maintainer "
4562 "scripts by B<dh_installdeb>. See L<dh_installdeb(1)> for an explanation of "
4567 #: dh_installxfonts:39
4569 "See L<update-fonts-alias(8)>, L<update-fonts-scale(8)>, and "
4570 "L<update-fonts-dir(8)> for more information about X font installation."
4574 #: dh_installxfonts:42
4576 "See Debian policy, section 11.8.5. for details about doing fonts the Debian "
4582 msgid "dh_link - create symlinks in package build directories"
4588 "B<dh_link> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] [S<I<source "
4589 "destination> ...>]"
4595 "B<dh_link> is a debhelper program that creates symlinks in package build "
4602 "B<dh_link> accepts a list of pairs of source and destination files. The "
4603 "source files are the already existing files that will be symlinked from. The "
4604 "destination files are the symlinks that will be created. There B<must> be an "
4605 "equal number of source and destination files specified."
4611 "Be sure you B<do> specify the full filename to both the source and "
4612 "destination files (unlike you would do if you were using something like "
4619 "B<dh_link> will generate symlinks that comply with Debian policy - absolute "
4620 "when policy says they should be absolute, and relative links with as short a "
4621 "path as possible. It will also create any subdirectories it needs to to put "
4628 "B<dh_link> also scans the package build tree for existing symlinks which do "
4629 "not conform to Debian policy, and corrects them (v4 or later)."
4634 msgid "debian/I<package>.links"
4640 "Lists pairs of source and destination files to be symlinked. Each pair "
4641 "should be put on its own line, with the source and destination separated by "
4648 "Create any links specified by command line parameters in ALL packages acted "
4649 "on, not just the first."
4655 "Exclude symlinks that contain I<item> anywhere in their filename from being "
4656 "corrected to comply with Debian policy."
4661 msgid "I<source destination> ..."
4667 "Create a file named I<destination> as a link to a file named I<source>. Do "
4668 "this in the package build directory of the first package acted on. (Or in "
4669 "all packages if B<-A> is specified.)"
4676 " dh_link usr/share/man/man1/foo.1 usr/share/man/man1/bar.1\n"
4682 msgid "Make F<bar.1> be a symlink to F<foo.1>"
4689 " dh_link var/lib/foo usr/lib/foo \\\n"
4690 " usr/share/man/man1/foo.1 usr/share/man/man1/bar.1\n"
4697 "Make F</usr/lib/foo/> be a link to F</var/lib/foo/>, and F<bar.1> be a "
4698 "symlink to the F<foo.1>"
4703 msgid "dh_lintian - install lintian override files into package build directories"
4708 msgid "B<dh_lintian> [S<I<debhelper options>>]"
4714 "B<dh_lintian> is a debhelper program that is responsible for installing "
4715 "override files used by lintian into package build directories."
4720 msgid "debian/I<package>.lintian-overrides"
4726 "Installed into usr/share/lintian/overrides/I<package> in the package build "
4727 "directory. This file is used to suppress erroneous lintian diagnostics."
4732 msgid "F<debian/source.lintian-overrides>"
4738 "These files are not installed, but will be scanned by lintian to provide "
4739 "overrides for the source package."
4744 msgid "L<lintian(1)>"
4749 msgid "Steve Robbins <smr@debian.org>"
4753 #: dh_listpackages:5
4754 msgid "dh_listpackages - list binary packages debhelper will act on"
4758 #: dh_listpackages:14
4759 msgid "B<dh_listpackages> [S<I<debhelper options>>]"
4763 #: dh_listpackages:18
4765 "B<dh_listpackages> is a debhelper program that outputs a list of all binary "
4766 "packages debhelper commands will act on. If you pass it some options, it "
4767 "will change the list to match the packages other debhelper commands would "
4768 "act on if passed the same options."
4773 msgid "dh_makeshlibs - automatically create shlibs file and call dpkg-gensymbols"
4779 "B<dh_makeshlibs> [S<I<debhelper options>>] [B<-m>I<major>] "
4780 "[B<-V>I<[dependencies]>] [B<-n>] [B<-X>I<item>] [S<B<--> I<params>>]"
4786 "B<dh_makeshlibs> is a debhelper program that automatically scans for shared "
4787 "libraries, and generates a shlibs file for the libraries it finds."
4793 "It also adds a call to ldconfig in the F<postinst> and F<postrm> scripts (in "
4794 "v3 mode and above only) to any packages in which it finds shared libraries."
4800 "Packages that support multiarch are detected, and a Pre-Dependency on "
4801 "multiarch-support is set in ${misc:Pre-Depends} ; you should make sure to "
4802 "put that token into an appropriate place in your debian/control file for "
4803 "packages supporting multiarch."
4808 msgid "debian/I<package>.symbols"
4813 msgid "debian/I<package>.symbols.I<arch>"
4819 "These symbols files, if present, are passed to L<dpkg-gensymbols(1)> to be "
4820 "processed and installed. Use the I<arch> specific names if you need to "
4821 "provide different symbols files for different architectures."
4826 msgid "B<-m>I<major>, B<--major=>I<major>"
4832 "Instead of trying to guess the major number of the library with objdump, use "
4833 "the major number specified after the -m parameter. This is much less useful "
4834 "than it used to be, back in the bad old days when this program looked at "
4835 "library filenames rather than using objdump."
4840 msgid "B<-V>, B<-V>I<dependencies>"
4845 msgid "B<--version-info>, B<--version-info=>I<dependencies>"
4851 "By default, the shlibs file generated by this program does not make packages "
4852 "depend on any particular version of the package containing the shared "
4853 "library. It may be necessary for you to add some version dependency "
4854 "information to the shlibs file. If B<-V> is specified with no dependency "
4855 "information, the current upstream version of the package is plugged into a "
4856 "dependency that looks like \"I<packagename> B<(E<gt>>= "
4857 "I<packageversion>B<)>\". Note that in debhelper compatibility levels before "
4858 "v4, the Debian part of the package version number is also included. If B<-V> "
4859 "is specified with parameters, the parameters can be used to specify the "
4860 "exact dependency information needed (be sure to include the package name)."
4866 "Beware of using B<-V> without any parameters; this is a conservative setting "
4867 "that always ensures that other packages' shared library dependencies are at "
4868 "least as tight as they need to be (unless your library is prone to changing "
4869 "ABI without updating the upstream version number), so that if the maintainer "
4870 "screws up then they won't break. The flip side is that packages might end up "
4871 "with dependencies that are too tight and so find it harder to be upgraded."
4877 "Exclude files that contain I<item> anywhere in their filename or directory "
4878 "from being treated as shared libraries."
4883 msgid "B<--add-udeb=>I<udeb>"
4889 "Create an additional line for udebs in the shlibs file and use I<udeb> as "
4890 "the package name for udebs to depend on instead of the regular library "
4896 msgid "Pass I<params> to L<dpkg-gensymbols(1)>."
4900 #: dh_makeshlibs:101
4901 msgid "B<dh_makeshlibs>"
4905 #: dh_makeshlibs:103
4908 "Assuming this is a package named F<libfoobar1>, generates a shlibs file "
4910 "looks something like:\n"
4911 " libfoobar 1 libfoobar1\n"
4916 #: dh_makeshlibs:107
4917 msgid "B<dh_makeshlibs -V>"
4921 #: dh_makeshlibs:109
4924 "Assuming the current version of the package is 1.1-3, generates a shlibs\n"
4925 "file that looks something like:\n"
4926 " libfoobar 1 libfoobar1 (>= 1.1)\n"
4931 #: dh_makeshlibs:113
4932 msgid "B<dh_makeshlibs -V 'libfoobar1 (E<gt>= 1.0)'>"
4936 #: dh_makeshlibs:115
4939 "Generates a shlibs file that looks something like:\n"
4940 " libfoobar 1 libfoobar1 (>= 1.0)\n"
4946 msgid "dh_md5sums - generate DEBIAN/md5sums file"
4952 "B<dh_md5sums> [S<I<debhelper options>>] [B<-x>] [B<-X>I<item>] "
4953 "[B<--include-conffiles>]"
4959 "B<dh_md5sums> is a debhelper program that is responsible for generating a "
4960 "F<DEBIAN/md5sums> file, which lists the md5sums of each file in the "
4961 "package. These files are used by the B<debsums> package."
4967 "All files in F<DEBIAN/> are omitted from the F<md5sums> file, as are all "
4968 "conffiles (unless you use the B<--include-conffiles> switch)."
4973 msgid "The md5sums file is installed with proper permissions and ownerships."
4978 msgid "B<-x>, B<--include-conffiles>"
4984 "Include conffiles in the md5sums list. Note that this information is "
4985 "redundant since it is included elsewhere in Debian packages."
4991 "Exclude files that contain I<item> anywhere in their filename from being "
4992 "listed in the md5sums file."
4997 msgid "dh_movefiles - move files out of debian/tmp into subpackages"
5003 "B<dh_movefiles> [S<I<debhelper options>>] [B<--sourcedir=>I<dir>] "
5004 "[B<-X>I<item>] S<I<file> ...>]"
5010 "B<dh_movefiles> is a debhelper program that is responsible for moving files "
5011 "out of F<debian/tmp> or some other directory and into other package build "
5012 "directories. This may be useful if your package has a F<Makefile> that "
5013 "installs everything into F<debian/tmp>, and you need to break that up into "
5020 "Note: B<dh_install> is a much better program, and you are recommended to use "
5021 "it instead of B<dh_movefiles>."
5026 msgid "debian/I<package>.files"
5032 "Lists the files to be moved into a package, separated by whitespace. The "
5033 "filenames listed should be relative to F<debian/tmp/>. You can also list "
5034 "directory names, and the whole directory will be moved."
5040 "Instead of moving files out of F<debian/tmp> (the default), this option "
5041 "makes it move files out of some other directory. Since the entire contents "
5042 "of the sourcedir is moved, specifying something like B<--sourcedir=/> is "
5043 "very unsafe, so to prevent mistakes, the sourcedir must be a relative "
5044 "filename; it cannot begin with a `B</>'."
5049 msgid "B<-Xitem>, B<--exclude=item>"
5055 "Exclude files that contain B<item> anywhere in their filename from being "
5062 "Lists files to move. The filenames listed should be relative to "
5063 "F<debian/tmp/>. You can also list directory names, and the whole directory "
5064 "will be moved. It is an error to list files here unless you use B<-p>, "
5065 "B<-i>, or B<-a> to tell B<dh_movefiles> which subpackage to put them in."
5071 "Note that files are always moved out of F<debian/tmp> by default (even if "
5072 "you have instructed debhelper to use a compatibility level higher than one, "
5073 "which does not otherwise use debian/tmp for anything at all). The idea "
5074 "behind this is that the package that is being built can be told to install "
5075 "into F<debian/tmp>, and then files can be moved by B<dh_movefiles> from that "
5076 "directory. Any files or directories that remain are ignored, and get deleted "
5077 "by B<dh_clean> later."
5082 msgid "dh_perl - calculates Perl dependencies and cleans up after MakeMaker"
5087 msgid "B<dh_perl> [S<I<debhelper options>>] [B<-d>] [S<I<library dirs> ...>]"
5093 "B<dh_perl> is a debhelper program that is responsible for generating the "
5094 "B<${perl:Depends}> substitutions and adding them to substvars files."
5100 "The program will look at Perl scripts and modules in your package, and will "
5101 "use this information to generate a dependency on B<perl> or B<perlapi>. The "
5102 "dependency will be substituted into your package's F<control> file wherever "
5103 "you place the token B<${perl:Depends}>."
5109 "B<dh_perl> also cleans up empty directories that MakeMaker can generate when "
5110 "installing Perl modules."
5121 "In some specific cases you may want to depend on B<perl-base> rather than "
5122 "the full B<perl> package. If so, you can pass the -d option to make "
5123 "B<dh_perl> generate a dependency on the correct base package. This is only "
5124 "necessary for some packages that are included in the base system."
5130 "Note that this flag may cause no dependency on B<perl-base> to be generated "
5131 "at all. B<perl-base> is Essential, so its dependency can be left out, unless "
5132 "a versioned dependency is needed."
5143 "By default, scripts and architecture independent modules don't depend on any "
5144 "specific version of B<perl>. The B<-V> option causes the current version of "
5145 "the B<perl> (or B<perl-base> with B<-d>) package to be specified."
5150 msgid "I<library dirs>"
5156 "If your package installs Perl modules in non-standard directories, you can "
5157 "make B<dh_perl> check those directories by passing their names on the "
5158 "command line. It will only check the F<vendorlib> and F<vendorarch> "
5159 "directories by default."
5164 msgid "Debian policy, version 3.8.3"
5169 msgid "Perl policy, version 1.20"
5174 msgid "Brendan O'Dea <bod@debian.org>"
5179 msgid "dh_prep - perform cleanups in preparation for building a binary package"
5184 msgid "B<dh_prep> [S<I<debhelper options>>] [B<-X>I<item>]"
5190 "B<dh_prep> is a debhelper program that performs some file cleanups in "
5191 "preparation for building a binary package. (This is what B<dh_clean -k> used "
5192 "to do.) It removes the package build directories, F<debian/tmp>, and some "
5193 "temp files that are generated when building a binary package."
5199 "It is typically run at the top of the B<binary-arch> and B<binary-indep> "
5200 "targets, or at the top of a target such as install that they depend on."
5206 "Exclude files that contain F<item> anywhere in their filename from being "
5207 "deleted, even if they would normally be deleted. You may use this option "
5208 "multiple times to build up a list of things to exclude."
5214 "dh_python - calculates Python dependencies and adds postinst and prerm "
5215 "Python scripts (deprecated)"
5221 "B<dh_python> [S<I<debhelper options>>] [B<-n>] [B<-V> I<version>] "
5222 "[S<I<module dirs> ...>]"
5228 "Note: This program is deprecated. You should use B<dh_python2> instead. "
5229 "This program will do nothing if F<debian/pycompat> or a B<Python-Version> "
5230 "F<control> file field exists."
5236 "B<dh_python> is a debhelper program that is responsible for generating the "
5237 "B<${python:Depends}> substitutions and adding them to substvars files. It "
5238 "will also add a F<postinst> and a F<prerm> script if required."
5244 "The program will look at Python scripts and modules in your package, and "
5245 "will use this information to generate a dependency on B<python>, with the "
5246 "current major version, or on B<python>I<X>B<.>I<Y> if your scripts or "
5247 "modules need a specific B<python> version. The dependency will be "
5248 "substituted into your package's F<control> file wherever you place the token "
5249 "B<${python:Depends}>."
5255 "If some modules need to be byte-compiled at install time, appropriate "
5256 "F<postinst> and F<prerm> scripts will be generated. If already byte-compiled "
5257 "modules are found, they are removed."
5262 msgid "If you use this program, your package should build-depend on B<python>."
5267 msgid "I<module dirs>"
5273 "If your package installs Python modules in non-standard directories, you can "
5274 "make F<dh_python> check those directories by passing their names on the "
5275 "command line. By default, it will check F</usr/lib/site-python>, "
5276 "F</usr/lib/$PACKAGE>, F</usr/share/$PACKAGE>, F</usr/lib/games/$PACKAGE>, "
5277 "F</usr/share/games/$PACKAGE> and F</usr/lib/python?.?/site-packages>."
5283 "Note: only F</usr/lib/site-python>, F</usr/lib/python?.?/site-packages> and "
5284 "the extra names on the command line are searched for binary (F<.so>) "
5290 msgid "B<-V> I<version>"
5296 "If the F<.py> files your package ships are meant to be used by a specific "
5297 "B<python>I<X>B<.>I<Y> version, you can use this option to specify the "
5298 "desired version, such as B<2.3>. Do not use if you ship modules in "
5299 "F</usr/lib/site-python>."
5304 msgid "Debian policy, version 3.5.7"
5309 msgid "Python policy, version 0.3.7"
5314 msgid "Josselin Mouette <joss@debian.org>"
5319 msgid "most ideas stolen from Brendan O'Dea <bod@debian.org>"
5323 #: dh_scrollkeeper:5
5324 msgid "dh_scrollkeeper - deprecated no-op"
5328 #: dh_scrollkeeper:14
5329 msgid "B<dh_scrollkeeper> [S<I<debhelper options>>] [B<-n>] [S<I<directory>>]"
5333 #: dh_scrollkeeper:18
5335 "B<dh_scrollkeeper> was a debhelper program that handled registering OMF "
5336 "files for ScrollKeeper. However, it no longer does anything, and is now "
5342 msgid "dh_shlibdeps - calculate shared library dependencies"
5348 "B<dh_shlibdeps> [S<I<debhelper options>>] [B<-L>I<package>] "
5349 "[B<-l>I<directory>] [B<-X>I<item>] [S<B<--> I<params>>]"
5355 "B<dh_shlibdeps> is a debhelper program that is responsible for calculating "
5356 "shared library dependencies for packages."
5362 "This program is merely a wrapper around L<dpkg-shlibdeps(1)> that calls it "
5363 "once for each package listed in the F<control> file, passing it a list of "
5364 "ELF executables and shared libraries it has found."
5370 "Exclude files that contain F<item> anywhere in their filename from being "
5371 "passed to B<dpkg-shlibdeps>. This will make their dependencies be ignored. "
5372 "This may be useful in some situations, but use it with caution. This option "
5373 "may be used more than once to exclude more than one thing."
5378 msgid "Pass I<params> to L<dpkg-shlibdeps(1)>."
5383 msgid "B<-u>I<params>, B<--dpkg-shlibdeps-params=>I<params>"
5389 "This is another way to pass I<params> to L<dpkg-shlibdeps(1)>. It is "
5390 "deprecated; use B<--> instead."
5395 msgid "B<-l>I<directory>[B<:>I<directory> ...]"
5401 "With recent versions of B<dpkg-shlibdeps>, this option is generally not "
5408 "Before B<dpkg-shlibdeps> is run, B<LD_LIBRARY_PATH> will have added to it "
5409 "the specified directory (or directories -- separate with colons). With "
5410 "recent versions of B<dpkg-shlibdeps>, this is mostly only useful for "
5411 "packages that build multiple flavors of the same library, or other "
5412 "situations where the library is installed into a directory not on the "
5413 "regular library search path."
5418 msgid "B<-L>I<package>, B<--libpackage=>I<package>"
5424 "With recent versions of B<dpkg-shlibdeps>, this option is generally not "
5425 "needed, unless your package builds multiple flavors of the same library."
5431 "It tells B<dpkg-shlibdeps> (via its B<-S> parameter) to look first in the "
5432 "package build directory for the specified package, when searching for "
5433 "libraries, symbol files, and shlibs files."
5439 "Suppose that your source package produces libfoo1, libfoo-dev, and "
5440 "libfoo-bin binary packages. libfoo-bin links against libfoo1, and should "
5441 "depend on it. In your rules file, first run B<dh_makeshlibs>, then "
5457 "This will have the effect of generating automatically a shlibs file for "
5458 "libfoo1, and using that file and the libfoo1 library in the "
5459 "F<debian/libfoo1/usr/lib> directory to calculate shared library dependency "
5466 "If a libbar1 package is also produced, that is an alternate build of libfoo, "
5467 "and is installed into F</usr/lib/bar/>, you can make libfoo-bin depend on "
5468 "libbar1 as follows:"
5475 "\tdh_shlibdeps -Llibbar1 -l/usr/lib/bar\n"
5481 msgid "L<debhelper(7)>, L<dpkg-shlibdeps(1)>"
5486 msgid "dh_strip - strip executables, shared libraries, and some static libraries"
5492 "B<dh_strip> [S<I<debhelper options>>] [B<-X>I<item>] "
5493 "[B<--dbg-package=>I<package>] [B<--keep-debug>]"
5499 "B<dh_strip> is a debhelper program that is responsible for stripping "
5500 "executables, shared libraries, and static libraries that are not used for "
5507 "This program examines your package build directories and works out what to "
5508 "strip on its own. It uses L<file(1)> and file permissions and filenames to "
5509 "figure out what files are shared libraries (F<*.so>), executable binaries, "
5510 "and static (F<lib*.a>) and debugging libraries (F<lib*_g.a>, F<debug/*.so>), "
5511 "and strips each as much as is possible. (Which is not at all for debugging "
5512 "libraries.) In general it seems to make very good guesses, and will do the "
5513 "right thing in almost all cases."
5519 "Since it is very hard to automatically guess if a file is a module, and hard "
5520 "to determine how to strip a module, B<dh_strip> does not currently deal with "
5521 "stripping binary modules such as F<.o> files."
5527 "Exclude files that contain I<item> anywhere in their filename from being "
5528 "stripped. You may use this option multiple times to build up a list of "
5529 "things to exclude."
5534 msgid "B<--dbg-package=>I<package>"
5540 "Causes B<dh_strip> to save debug symbols stripped from the packages it acts "
5541 "on as independent files in the package build directory of the specified "
5542 "debugging package."
5548 "For example, if your packages are libfoo and foo and you want to include a "
5549 "I<foo-dbg> package with debugging symbols, use B<dh_strip "
5550 "--dbg-package=>I<foo-dbg>."
5556 "Note that this option behaves significantly different in debhelper "
5557 "compatibility levels 4 and below. Instead of specifying the name of a debug "
5558 "package to put symbols in, it specifies a package (or packages) which should "
5559 "have separated debug symbols, and the separated symbols are placed in "
5560 "packages with B<-dbg> added to their name."
5565 msgid "B<-k>, B<--keep-debug>"
5571 "Debug symbols will be retained, but split into an independent file in "
5572 "F<usr/lib/debug/> in the package build directory. B<--dbg-package> is easier "
5573 "to use than this option, but this option is more flexible."
5579 "If the B<DEB_BUILD_OPTIONS> environment variable contains B<nostrip>, "
5580 "nothing will be stripped, in accordance with Debian policy (section 10.1 "
5586 msgid "Debian policy, version 3.0.1"
5590 #: dh_suidregister:5
5591 msgid "dh_suidregister - suid registration program (deprecated)"
5595 #: dh_suidregister:9 dh_undocumented:14
5600 #: dh_suidregister:13
5602 "This program used to register suid and sgid files with L<suidregister(1)>, "
5603 "but with the introduction of L<dpkg-statoverride(8)>, registration of files "
5604 "in this way is unnecessary, and even harmful, so this program is deprecated "
5605 "and should not be used."
5609 #: dh_suidregister:18
5610 msgid "CONVERTING TO STATOVERRIDE"
5614 #: dh_suidregister:20
5616 "Converting a package that uses this program to use the new statoverride "
5617 "mechanism is easy. Just remove the call to B<dh_suidregister> from "
5618 "F<debian/rules>, and add a versioned conflicts into your F<control> file, as "
5623 #: dh_suidregister:25
5626 " Conflicts: suidmanager (<< 0.50)\n"
5631 #: dh_suidregister:27
5633 "The conflicts is only necessary if your package used to register things with "
5634 "suidmanager; if it did not, you can just remove the call to this program "
5635 "from your rules file."
5640 msgid "dh_testdir - test directory before building Debian package"
5645 msgid "B<dh_testdir> [S<I<debhelper options>>] [S<I<file> ...>]"
5651 "B<dh_testdir> tries to make sure that you are in the correct directory when "
5652 "building a Debian package. It makes sure that the file F<debian/control> "
5653 "exists, as well as any other files you specify. If not, it exits with an "
5659 msgid "Test for the existence of these files too."
5664 msgid "dh_testroot - ensure that a package is built as root"
5669 msgid "B<dh_testroot> [S<I<debhelper options>>]"
5675 "B<dh_testroot> simply checks to see if you are root. If not, it exits with "
5676 "an error. Debian packages must be built as root, though you can use "
5681 #: dh_undocumented:5
5682 msgid "dh_undocumented - undocumented.7 symlink program (deprecated no-op)"
5686 #: dh_undocumented:18
5688 "This program used to make symlinks to the F<undocumented.7> man page for man "
5689 "pages not present in a package. Debian policy now frowns on use of the "
5690 "F<undocumented.7> man page, and so this program does nothing, and should not "
5696 msgid "dh_usrlocal - migrate usr/local directories to maintainer scripts"
5701 msgid "B<dh_usrlocal> [S<I<debhelper options>>] [B<-n>]"
5707 "B<dh_usrlocal> is a debhelper program that can be used for building packages "
5708 "that will provide a subdirectory in F</usr/local> when installed."
5714 "It finds subdirectories of F<usr/local> in the package build directory, and "
5715 "removes them, replacing them with maintainer script snippets (unless B<-n> "
5716 "is used) to create the directories at install time, and remove them when the "
5717 "package is removed, in a manner compliant with Debian policy. These snippets "
5718 "are inserted into the maintainer scripts by B<dh_installdeb>. See "
5719 "L<dh_installdeb(1)> for an explanation of debhelper maintainer script "
5726 "If the directories found in the build tree have unusual owners, groups, or "
5727 "permissions, then those values will be preserved in the directories made by "
5728 "the F<postinst> script. However, as a special exception, if a directory is "
5729 "owned by root.root, it will be treated as if it is owned by root.staff and "
5730 "is mode 2775. This is useful, since that is the group and mode policy "
5731 "recommends for directories in F</usr/local>."
5736 msgid "Debian policy, version 2.2"
5741 msgid "Andrew Stribblehill <ads@debian.org>"
projects / debhelper.git / blob