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: 2012-05-09 12:59-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 them "
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:66
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:81 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:65 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:62
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 "COMPATIBILITY 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 v9 mode:"
547 " % echo 9 > debian/compat\n"
554 "Your package will also need a versioned build dependency on a version of "
555 "debhelper equal to (or greater than) the compatibility level your package "
556 "uses. So for compatibility level 9, ensure debian/control has:"
563 " Build-Depends: debhelper (>= 9)\n"
570 "Unless otherwise indicated, all debhelper documentation assumes that you are "
571 "using the most recent compatibility level, and in most cases does not "
572 "indicate if the behavior is different in an earlier compatibility level, so "
573 "if you are not using the most recent compatibility level, you're advised to "
574 "read below for notes about what is different in earlier compatibility "
580 msgid "These are the available compatibility levels:"
591 "This is the original debhelper compatibility level, and so it is the default "
592 "one. In this mode, debhelper will use F<debian/tmp> as the package tree "
593 "directory for the first binary package listed in the control file, while "
594 "using debian/I<package> for all other packages listed in the F<control> "
599 #: debhelper.pod:298 debhelper.pod:305 debhelper.pod:328 debhelper.pod:357
600 msgid "This mode is deprecated."
611 "In this mode, debhelper will consistently use debian/I<package> as the "
612 "package tree directory for every package that is built."
622 msgid "This mode works like v2, with the following additions:"
626 #: debhelper.pod:313 debhelper.pod:318 debhelper.pod:322 debhelper.pod:336 debhelper.pod:341 debhelper.pod:346 debhelper.pod:351 debhelper.pod:365 debhelper.pod:369 debhelper.pod:374 debhelper.pod:378 debhelper.pod:390 debhelper.pod:395 debhelper.pod:401 debhelper.pod:407 debhelper.pod:420 debhelper.pod:427 debhelper.pod:431 debhelper.pod:435 debhelper.pod:448 debhelper.pod:452 debhelper.pod:460 debhelper.pod:465 debhelper.pod:479 debhelper.pod:484 debhelper.pod:491 debhelper.pod:496 debhelper.pod:501 debhelper.pod:505 debhelper.pod:511 debhelper.pod:516 debhelper.pod:521 debhelper.pod:536
633 "Debhelper config files support globbing via B<*> and B<?>, when "
634 "appropriate. To turn this off and use those characters raw, just prefix with "
641 "B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call "
648 "Every file in F<etc/> is automatically flagged as a conffile by "
659 msgid "Changes from v3 are:"
665 "B<dh_makeshlibs -V> will not include the Debian part of the version number "
666 "in the generated dependency line in the shlibs file."
672 "You are encouraged to put the new B<${misc:Depends}> into F<debian/control> "
673 "to supplement the B<${shlibs:Depends}> field."
679 "B<dh_fixperms> will make all files in F<bin/> directories and in "
680 "F<etc/init.d> executable."
685 msgid "B<dh_link> will correct existing links to conform with policy."
695 msgid "Changes from v4 are:"
700 msgid "Comments are ignored in debhelper config files."
706 "B<dh_strip --dbg-package> now specifies the name of a package to put "
707 "debugging symbols in, not the packages to take the symbols from."
712 msgid "B<dh_installdocs> skips installing empty files."
717 msgid "B<dh_install> errors out if wildcards expand to nothing."
727 msgid "Changes from v5 are:"
733 "Commands that generate maintainer script fragments will order the fragments "
734 "in reverse order for the F<prerm> and F<postrm> scripts."
740 "B<dh_installwm> will install a slave manpage link for "
741 "F<x-window-manager.1.gz>, if it sees the man page in F<usr/share/man/man1> "
742 "in the package build directory."
748 "B<dh_builddeb> did not previously delete everything matching "
749 "B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as "
750 "B<CVS:.svn:.git>. Now it does."
756 "B<dh_installman> allows overwriting existing man pages in the package build "
757 "directory. In previous compatibility levels it silently refuses to do this."
767 msgid "Changes from v6 are:"
773 "B<dh_install>, will fall back to looking for files in F<debian/tmp> if it "
774 "doesn't find them in the current directory (or wherever you tell it look "
775 "using B<--sourcedir>). This allows B<dh_install> to interoperate with "
776 "B<dh_auto_install>, which installs to F<debian/tmp>, without needing any "
777 "special parameters."
782 msgid "B<dh_clean> will read F<debian/clean> and delete files listed there."
787 msgid "B<dh_clean> will delete toplevel F<*-stamp> files."
793 "B<dh_installchangelogs> will guess at what file is the upstream changelog if "
804 msgid "Changes from v7 are:"
809 msgid "Commands will fail rather than warning when they are passed unknown options."
815 "B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it "
816 "generates shlibs files for. So B<-X> can be used to exclude libraries. "
817 "Also, libraries in unusual locations that B<dpkg-gensymbols> would not have "
818 "processed before will be passed to it, a behavior change that can cause some "
819 "packages to fail to build."
825 "B<dh> requires the sequence to run be specified as the first parameter, and "
826 "any switches come after it. Ie, use \"B<dh $@ --foo>\", not \"B<dh --foo "
833 "B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to "
844 msgid "This is the recommended mode of operation."
849 msgid "Changes from v8 are:"
855 "Multiarch support. In particular, B<dh_auto_configure> passes multiarch "
856 "directories to autoconf in --libdir and --libexecdir."
862 "dh is aware of the usual dependencies between targets in debian/rules. So, "
863 "\"dh binary\" will run any build, build-arch, build-indep, install, etc "
864 "targets that exist in the rules file. There's no need to define an explicit "
865 "binary target with explicit dependencies on the other targets."
871 "B<dh_strip> compresses debugging symbol files to reduce the installed size "
878 "B<dh_auto_configure> does not include the source package name in "
879 "--libexecdir when using autoconf."
884 msgid "B<dh> does not default to enabling --with=python-support"
890 "All of the B<dh_auto_>I<*> debhelper programs and B<dh> set environment "
891 "variables listed by B<dpkg-buildflags>, unless they are already set."
897 "B<dh_auto_configure> passes B<dpkg-buildflags> CFLAGS, CPPFLAGS, and LDFLAGS "
898 "to perl F<Makefile.PL> and F<Build.PL>"
904 "B<dh_strip> puts separated debug symbols in a location based on their "
911 "Executable debhelper config files are run and their output used as the "
922 msgid "This compatibility level is still open for development; use with caution."
927 msgid "Changes from v9 are:"
936 #: debhelper.pod:544 dh_auto_test:45 dh_installcatalogs:59 dh_installdocs:116 dh_installemacsen:67 dh_installexamples:53 dh_installinit:128 dh_installman:82 dh_installmime:51 dh_installmodules:60 dh_installudev:55 dh_installwm:54 dh_installxfonts:37 dh_movefiles:64 dh_strip:68 dh_usrlocal:49
942 msgid "Multiple binary package support"
948 "If your source package generates more than one binary package, debhelper "
949 "programs will default to acting on all binary packages when run. If your "
950 "source package happens to generate one architecture dependent package, and "
951 "another architecture independent package, this is not the correct behavior, "
952 "because you need to generate the architecture dependent packages in the "
953 "binary-arch F<debian/rules> target, and the architecture independent "
954 "packages in the binary-indep F<debian/rules> target."
960 "To facilitate this, as well as give you more control over which packages are "
961 "acted on by debhelper programs, all debhelper programs accept the B<-a>, "
962 "B<-i>, B<-p>, and B<-s> parameters. These parameters are cumulative. If "
963 "none are given, debhelper programs default to acting on all packages listed "
964 "in the control file."
969 msgid "Automatic generation of Debian install scripts"
975 "Some debhelper commands will automatically generate parts of Debian "
976 "maintainer scripts. If you want these automatically generated things "
977 "included in your existing Debian maintainer scripts, then you need to add "
978 "B<#DEBHELPER#> to your scripts, in the place the code should be added. "
979 "B<#DEBHELPER#> will be replaced by any auto-generated code when you run "
986 "If a script does not exist at all and debhelper needs to add something to "
987 "it, then debhelper will create the complete script."
993 "All debhelper commands that automatically generate code in this way let it "
994 "be disabled by the -n parameter (see above)."
1000 "Note that the inserted code will be shell code, so you cannot directly use "
1001 "it in a Perl script. If you would like to embed it into a Perl script, here "
1002 "is one way to do that (note that I made sure that $1, $2, etc are set with "
1007 #: debhelper.pod:582
1010 " my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n"
1013 " system ($temp) / 256 == 0\n"
1014 " \tor die \"Problem with debhelper scripts: $!\";\n"
1019 #: debhelper.pod:588
1020 msgid "Automatic generation of miscellaneous dependencies."
1024 #: debhelper.pod:590
1026 "Some debhelper commands may make the generated package need to depend on "
1027 "some other packages. For example, if you use L<dh_installdebconf(1)>, your "
1028 "package will generally need to depend on debconf. Or if you use "
1029 "L<dh_installxfonts(1)>, your package will generally need to depend on a "
1030 "particular version of xutils. Keeping track of these miscellaneous "
1031 "dependencies can be annoying since they are dependent on how debhelper does "
1032 "things, so debhelper offers a way to automate it."
1036 #: debhelper.pod:598
1038 "All commands of this type, besides documenting what dependencies may be "
1039 "needed on their man pages, will automatically generate a substvar called "
1040 "B<${misc:Depends}>. If you put that token into your F<debian/control> file, "
1041 "it will be expanded to the dependencies debhelper figures you need."
1045 #: debhelper.pod:603
1047 "This is entirely independent of the standard B<${shlibs:Depends}> generated "
1048 "by L<dh_makeshlibs(1)>, and the B<${perl:Depends}> generated by "
1049 "L<dh_perl(1)>. You can choose not to use any of these, if debhelper's "
1050 "guesses don't match reality."
1054 #: debhelper.pod:608
1055 msgid "Package build directories"
1059 #: debhelper.pod:610
1061 "By default, all debhelper programs assume that the temporary directory used "
1062 "for assembling the tree of files in a package is debian/I<package>."
1066 #: debhelper.pod:613
1068 "Sometimes, you might want to use some other temporary directory. This is "
1069 "supported by the B<-P> flag. For example, \"B<dh_installdocs "
1070 "-Pdebian/tmp>\", will use B<debian/tmp> as the temporary directory. Note "
1071 "that if you use B<-P>, the debhelper programs can only be acting on a single "
1072 "package at a time. So if you have a package that builds many binary "
1073 "packages, you will need to also use the B<-p> flag to specify which binary "
1074 "package the debhelper program will act on."
1078 #: debhelper.pod:621
1083 #: debhelper.pod:623
1085 "Debhelper includes support for udebs. To create a udeb with debhelper, add "
1086 "\"B<Package-Type: udeb>\" to the package's stanza in F<debian/control>. "
1087 "Debhelper will try to create udebs that comply with debian-installer policy, "
1088 "by making the generated package files end in F<.udeb>, not installing any "
1089 "documentation into a udeb, skipping over F<preinst>, F<postrm>, F<prerm>, "
1090 "and F<config> scripts, etc."
1094 #: debhelper.pod:630
1099 #: debhelper.pod:634
1100 msgid "B<DH_VERBOSE>"
1104 #: debhelper.pod:636
1106 "Set to B<1> to enable verbose mode. Debhelper will output every command it "
1107 "runs that modifies files on the build system."
1111 #: debhelper.pod:639
1112 msgid "B<DH_COMPAT>"
1116 #: debhelper.pod:641
1118 "Temporarily specifies what compatibility level debhelper should run at, "
1119 "overriding any value in F<debian/compat>."
1123 #: debhelper.pod:644
1124 msgid "B<DH_NO_ACT>"
1128 #: debhelper.pod:646
1129 msgid "Set to B<1> to enable no-act mode."
1133 #: debhelper.pod:648
1134 msgid "B<DH_OPTIONS>"
1138 #: debhelper.pod:650
1140 "Anything in this variable will be prepended to the command line arguments of "
1141 "all debhelper commands."
1145 #: debhelper.pod:653
1147 "When using L<dh(1)>, it can be passed options that will be passed on to each "
1148 "debhelper command, which is generally better than using DH_OPTIONS."
1152 #: debhelper.pod:656
1153 msgid "B<DH_ALWAYS_EXCLUDE>"
1157 #: debhelper.pod:658
1159 "If set, this adds the value the variable is set to to the B<-X> options of "
1160 "all commands that support the B<-X> option. Moreover, B<dh_builddeb> will "
1161 "B<rm -rf> anything that matches the value in your package build tree."
1165 #: debhelper.pod:662
1167 "This can be useful if you are doing a build from a CVS source tree, in which "
1168 "case setting B<DH_ALWAYS_EXCLUDE=CVS> will prevent any CVS directories from "
1169 "sneaking into the package you build. Or, if a package has a source tarball "
1170 "that (unwisely) includes CVS directories, you might want to export "
1171 "B<DH_ALWAYS_EXCLUDE=CVS> in F<debian/rules>, to make it take effect wherever "
1172 "your package is built."
1176 #: debhelper.pod:669
1178 "Multiple things to exclude can be separated with colons, as in "
1179 "B<DH_ALWAYS_EXCLUDE=CVS:.svn>"
1183 #: debhelper.pod:674 dh:893 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:256 dh_installlogcheck:78 dh_installlogrotate:50 dh_installman:261 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
1188 #: debhelper.pod:678
1189 msgid "F</usr/share/doc/debhelper/examples/>"
1193 #: debhelper.pod:680
1194 msgid "A set of example F<debian/rules> files that use debhelper."
1198 #: debhelper.pod:682
1199 msgid "L<http://kitenet.net/~joey/code/debhelper/>"
1203 #: debhelper.pod:684
1204 msgid "Debhelper web site."
1208 #: debhelper.pod:688 dh:899 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:267 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
1213 #: debhelper.pod:690 dh:901 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:264 dh_installlogrotate:58 dh_installman:269 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
1214 msgid "Joey Hess <joeyh@debian.org>"
1219 msgid "dh - debhelper command sequencer"
1225 "B<dh> I<sequence> [B<--with> I<addon>[B<,>I<addon> ...]] [B<--list>] "
1226 "[S<I<debhelper options>>]"
1232 "B<dh> runs a sequence of debhelper commands. The supported I<sequence>s "
1233 "correspond to the targets of a F<debian/rules> file: B<build-arch>, "
1234 "B<build-indep>, B<build>, B<clean>, B<install-indep>, B<install-arch>, "
1235 "B<install>, B<binary-arch>, B<binary-indep>, and B<binary>."
1240 msgid "OVERRIDE TARGETS"
1246 "A F<debian/rules> file using B<dh> can override the command that is run at "
1247 "any step in a sequence, by defining an override target."
1253 "To override I<dh_command>, add a target named B<override_>I<dh_command> to "
1254 "the rules file. When it would normally run I<dh_command>, B<dh> will instead "
1255 "call that target. The override target can then run the command with "
1256 "additional options, or run entirely different commands instead. See examples "
1257 "below. (Note that to use this feature, you should Build-Depend on debhelper "
1264 "Override targets can also be defined to run only when building architecture "
1265 "dependent or architecture independent packages. Use targets with names like "
1266 "B<override_>I<dh_command>B<-arch> and B<override_>I<dh_command>B<-indep>. "
1267 "(Note that to use this feature, you should Build-Depend on debhelper 8.9.7 "
1272 #: 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:59 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:47 dh_installlogcheck:42 dh_installlogrotate:22 dh_installman:61 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
1278 msgid "B<--with> I<addon>[B<,>I<addon> ...]"
1284 "Add the debhelper commands specified by the given addon to appropriate "
1285 "places in the sequence of commands that is run. This option can be repeated "
1286 "more than once, or multiple addons can be listed, separated by commas. This "
1287 "is used when there is a third-party package that provides debhelper "
1288 "commands. See the F<PROGRAMMING> file for documentation about the sequence "
1294 msgid "B<--without> I<addon>"
1300 "The inverse of B<--with>, disables using the given addon. This option can be "
1301 "repeated more than once, or multiple addons to disable can be listed, "
1302 "separated by commas."
1307 msgid "List all available addons."
1312 msgid "Prints commands that would run for a given sequence, but does not run them."
1318 "Other options passed to B<dh> are passed on to each command it runs. This "
1319 "can be used to set an option like B<-v> or B<-X> or B<-N>, as well as for "
1320 "more specialised options."
1324 #: dh:76 dh_installdocs:105 dh_link:73 dh_makeshlibs:97 dh_shlibdeps:69
1331 "To see what commands are included in a sequence, without actually doing "
1339 "\tdh binary-arch --no-act\n"
1346 "This is a very simple rules file, for packages where the default sequences "
1347 "of commands work with no additional options."
1351 #: dh:86 dh:107 dh:120
1354 "\t#!/usr/bin/make -f\n"
1363 "Often you'll want to pass an option to a specific debhelper command. The "
1364 "easy way to do with is by adding an override target for that command."
1368 #: dh:93 dh:178 dh:189
1371 "\t#!/usr/bin/make -f\n"
1381 "\toverride_dh_strip:\n"
1382 "\t\tdh_strip -Xfoo\n"
1390 "\toverride_dh_auto_configure:\n"
1391 "\t\tdh_auto_configure -- --with-foo --disable-bar\n"
1398 "Sometimes the automated L<dh_auto_configure(1)> and L<dh_auto_build(1)> "
1399 "can't guess what to do for a strange package. Here's how to avoid running "
1400 "either and instead run your own commands."
1407 "\toverride_dh_auto_configure:\n"
1408 "\t\t./mondoconfig\n"
1416 "\toverride_dh_auto_build:\n"
1417 "\t\tmake universe-explode-in-delight\n"
1424 "Another common case is wanting to do something manually before or after a "
1425 "particular debhelper command is run."
1432 "\toverride_dh_fixperms:\n"
1434 "\t\tchmod 4755 debian/foo/usr/bin/foo\n"
1441 "If your package uses autotools and you want to freshen F<config.sub> and "
1442 "F<config.guess> with newer versions from the B<autotools-dev> package at "
1443 "build time, you can use some commands provided in B<autotools-dev> that "
1444 "automate it, like this."
1451 "\t#!/usr/bin/make -f\n"
1453 "\t\tdh $@ --with autotools_dev\n"
1460 "Python tools are not run by dh by default, due to the continual change in "
1461 "that area. (Before compatibility level v9, dh does run B<dh_pysupport>.) "
1462 "Here is how to use B<dh_python2>."
1469 "\t#!/usr/bin/make -f\n"
1471 "\t\tdh $@ --with python2\n"
1478 "Here is how to force use of Perl's B<Module::Build> build system, which can "
1479 "be necessary if debhelper wrongly detects that the package uses MakeMaker."
1486 "\t#!/usr/bin/make -f\n"
1488 "\t\tdh $@ --buildsystem=perl_build\n"
1495 "Here is an example of overriding where the B<dh_auto_>I<*> commands find the "
1496 "package's source, for a package where the source is located in a "
1504 "\t#!/usr/bin/make -f\n"
1506 "\t\tdh $@ --sourcedirectory=src\n"
1513 "And here is an example of how to tell the B<dh_auto_>I<*> commands to build "
1514 "in a subdirectory, which will be removed on B<clean>."
1521 "\t#!/usr/bin/make -f\n"
1523 "\t\tdh $@ --builddirectory=build\n"
1530 "If your package can be built in parallel, you can support parallel building "
1531 "as follows. Then B<dpkg-buildpackage -j> will work."
1538 "\t#!/usr/bin/make -f\n"
1540 "\t\tdh $@ --parallel\n"
1547 "Here is a way to prevent B<dh> from running several commands that you don't "
1548 "want it to run, by defining empty override targets for each command."
1555 "\t# Commands not to run:\n"
1556 "\toverride_dh_auto_test override_dh_compress override_dh_fixperms:\n"
1563 "A long build process for a separate documentation package can be separated "
1564 "out using architecture independent overrides. These will be skipped when "
1565 "running build-arch and binary-arch sequences."
1572 "\toverride_dh_auto_build-indep:\n"
1573 "\t\t$(MAKE) -C docs\n"
1581 "\t# No tests needed for docs\n"
1582 "\toverride_dh_auto_test-indep:\n"
1590 "\toverride_dh_auto_install-indep:\n"
1591 "\t\t$(MAKE) -C docs install\n"
1598 "Adding to the example above, suppose you need to chmod a file, but only when "
1599 "building the architecture dependent package, as it's not present when "
1600 "building only documentation."
1607 "\toverride_dh_fixperms-arch:\n"
1609 "\t\tchmod 4755 debian/foo/usr/bin/foo\n"
1621 "If you're curious about B<dh>'s internals, here's how it works under the "
1628 "Each debhelper command will record when it's successfully run in "
1629 "F<debian/package.debhelper.log>. (Which B<dh_clean> deletes.) So B<dh> can "
1630 "tell which commands have already been run, for which packages, and skip "
1631 "running those commands again."
1637 "Each time B<dh> is run, it examines the log, and finds the last logged "
1638 "command that is in the specified sequence. It then continues with the next "
1639 "command in the sequence. The B<--until>, B<--before>, B<--after>, and "
1640 "B<--remaining> options can override this behavior."
1646 "A sequence can also run dependent targets in debian/rules. For example, the "
1647 "\"binary\" sequence runs the \"install\" target."
1653 "B<dh> uses the B<DH_INTERNAL_OPTIONS> environment variable to pass "
1654 "information through to debhelper commands that are run inside override "
1655 "targets. The contents (and indeed, existence) of this environment variable, "
1656 "as the name might suggest, is subject to change at any time."
1662 "Commands in the B<build-indep>, B<install-indep> and B<binary-indep> "
1663 "sequences are passed the B<-i> option to ensure they only work on "
1664 "architecture independent packages, and commands in the B<build-arch>, "
1665 "B<install-arch> and B<binary-arch> sequences are passed the B<-a> option to "
1666 "ensure they only work on architecture dependent packages."
1671 msgid "DEPRECATED OPTIONS"
1677 "The following options are deprecated. It's much better to use override "
1683 msgid "B<--until> I<cmd>"
1688 msgid "Run commands in the sequence until and including I<cmd>, then stop."
1693 msgid "B<--before> I<cmd>"
1698 msgid "Run commands in the sequence before I<cmd>, then stop."
1703 msgid "B<--after> I<cmd>"
1708 msgid "Run commands in the sequence that come after I<cmd>."
1713 msgid "B<--remaining>"
1718 msgid "Run all commands in the sequence that have yet to be run."
1724 "In the above options, I<cmd> can be a full name of a debhelper command, or a "
1725 "substring. It'll first search for a command in the sequence exactly matching "
1726 "the name, to avoid any ambiguity. If there are multiple substring matches, "
1727 "the last one in the sequence will be used."
1731 #: dh:895 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:258 dh_installlogcheck:80 dh_installlogrotate:52 dh_installman:263 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
1732 msgid "L<debhelper(7)>"
1736 #: dh:897 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:260 dh_installlogrotate:54 dh_installman:265 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
1737 msgid "This program is a part of debhelper."
1742 msgid "dh_auto_build - automatically builds a package"
1748 "B<dh_auto_build> [S<I<build system options>>] [S<I<debhelper options>>] "
1749 "[S<B<--> I<params>>]"
1755 "B<dh_auto_build> is a debhelper program that tries to automatically build a "
1756 "package. It does so by running the appropriate command for the build system "
1757 "it detects the package uses. For example, if a F<Makefile> is found, this is "
1758 "done by running B<make> (or B<MAKE>, if the environment variable is set). If "
1759 "there's a F<setup.py>, or F<Build.PL>, it is run to build the package."
1765 "This is intended to work for about 90% of packages. If it doesn't work, "
1766 "you're encouraged to skip using B<dh_auto_build> at all, and just run the "
1767 "build process manually."
1771 #: dh_auto_build:30 dh_auto_clean:32 dh_auto_configure:33 dh_auto_install:45 dh_auto_test:33
1773 "See L<debhelper(7)/B<BUILD SYSTEM OPTIONS>> for a list of common build "
1774 "system selection and control options."
1778 #: 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:93 dh_makeshlibs:91 dh_shlibdeps:37
1779 msgid "B<--> I<params>"
1785 "Pass I<params> to the program that is run, after the parameters that "
1786 "B<dh_auto_build> usually passes."
1791 msgid "dh_auto_clean - automatically cleans up after a build"
1797 "B<dh_auto_clean> [S<I<build system options>>] [S<I<debhelper options>>] "
1798 "[S<B<--> I<params>>]"
1804 "B<dh_auto_clean> is a debhelper program that tries to automatically clean up "
1805 "after a package build. It does so by running the appropriate command for the "
1806 "build system it detects the package uses. For example, if there's a "
1807 "F<Makefile> and it contains a B<distclean>, B<realclean>, or B<clean> "
1808 "target, then this is done by running B<make> (or B<MAKE>, if the environment "
1809 "variable is set). If there is a F<setup.py> or F<Build.PL>, it is run to "
1810 "clean the package."
1816 "This is intended to work for about 90% of packages. If it doesn't work, or "
1817 "tries to use the wrong clean target, you're encouraged to skip using "
1818 "B<dh_auto_clean> at all, and just run B<make clean> manually."
1824 "Pass I<params> to the program that is run, after the parameters that "
1825 "B<dh_auto_clean> usually passes."
1829 #: dh_auto_configure:5
1830 msgid "dh_auto_configure - automatically configure a package prior to building"
1834 #: dh_auto_configure:14
1836 "B<dh_auto_configure> [S<I<build system options>>] [S<I<debhelper options>>] "
1837 "[S<B<--> I<params>>]"
1841 #: dh_auto_configure:18
1843 "B<dh_auto_configure> is a debhelper program that tries to automatically "
1844 "configure a package prior to building. It does so by running the appropriate "
1845 "command for the build system it detects the package uses. For example, it "
1846 "looks for and runs a F<./configure> script, F<Makefile.PL>, F<Build.PL>, or "
1847 "F<cmake>. A standard set of parameters is determined and passed to the "
1848 "program that is run. Some build systems, such as make, do not need a "
1849 "configure step; for these B<dh_auto_configure> will exit without doing "
1854 #: dh_auto_configure:27
1856 "This is intended to work for about 90% of packages. If it doesn't work, "
1857 "you're encouraged to skip using B<dh_auto_configure> at all, and just run "
1858 "F<./configure> or its equivalent manually."
1862 #: dh_auto_configure:40
1864 "Pass I<params> to the program that is run, after the parameters that "
1865 "B<dh_auto_configure> usually passes. For example:"
1869 #: dh_auto_configure:43
1872 " dh_auto_configure -- --with-foo --enable-bar\n"
1877 #: dh_auto_install:5
1878 msgid "dh_auto_install - automatically runs make install or similar"
1882 #: dh_auto_install:17
1884 "B<dh_auto_install> [S<I<build system options>>] [S<I<debhelper options>>] "
1885 "[S<B<--> I<params>>]"
1889 #: dh_auto_install:21
1891 "B<dh_auto_install> is a debhelper program that tries to automatically "
1892 "install built files. It does so by running the appropriate command for the "
1893 "build system it detects the package uses. For example, if there's a "
1894 "F<Makefile> and it contains a B<install> target, then this is done by "
1895 "running B<make> (or B<MAKE>, if the environment variable is set). If there "
1896 "is a F<setup.py> or F<Build.PL>, it is used. Note that the Ant build system "
1897 "does not support installation, so B<dh_auto_install> will not install files "
1902 #: dh_auto_install:29
1904 "Unless B<--destdir> option is specified, the files are installed into "
1905 "debian/I<package>/ if there is only one binary package. In the multiple "
1906 "binary package case, the files are instead installed into F<debian/tmp/>, "
1907 "and should be moved from there to the appropriate package build directory "
1908 "using L<dh_install(1)>."
1912 #: dh_auto_install:35
1914 "B<DESTDIR> is used to tell make where to install the files. If the Makefile "
1915 "was generated by MakeMaker from a F<Makefile.PL>, it will automatically set "
1916 "B<PREFIX=/usr> too, since such Makefiles need that."
1920 #: dh_auto_install:39
1922 "This is intended to work for about 90% of packages. If it doesn't work, or "
1923 "tries to use the wrong install target, you're encouraged to skip using "
1924 "B<dh_auto_install> at all, and just run make install manually."
1928 #: dh_auto_install:50 dh_builddeb:25
1929 msgid "B<--destdir=>I<directory>"
1933 #: dh_auto_install:52
1935 "Install files into the specified I<directory>. If this option is not "
1936 "specified, destination directory is determined automatically as described in "
1937 "the L</B<DESCRIPTION>> section."
1941 #: dh_auto_install:58
1943 "Pass I<params> to the program that is run, after the parameters that "
1944 "B<dh_auto_install> usually passes."
1949 msgid "dh_auto_test - automatically runs a package's test suites"
1955 "B<dh_auto_test> [S<I<build system options>>] [S<I<debhelper options>>] "
1956 "[S<B<--> I<params>>]"
1962 "B<dh_auto_test> is a debhelper program that tries to automatically run a "
1963 "package's test suite. It does so by running the appropriate command for the "
1964 "build system it detects the package uses. For example, if there's a Makefile "
1965 "and it contains a B<test> or B<check> target, then this is done by running "
1966 "B<make> (or B<MAKE>, if the environment variable is set). If the test suite "
1967 "fails, the command will exit nonzero. If there's no test suite, it will exit "
1968 "zero without doing anything."
1974 "This is intended to work for about 90% of packages with a test suite. If it "
1975 "doesn't work, you're encouraged to skip using B<dh_auto_test> at all, and "
1976 "just run the test suite manually."
1982 "Pass I<params> to the program that is run, after the parameters that "
1983 "B<dh_auto_test> usually passes."
1989 "If the B<DEB_BUILD_OPTIONS> environment variable contains B<nocheck>, no "
1990 "tests will be performed."
1996 "dh_bugfiles - install bug reporting customization files into package build "
2002 msgid "B<dh_bugfiles> [B<-A>] [S<I<debhelper options>>]"
2008 "B<dh_bugfiles> is a debhelper program that is responsible for installing bug "
2009 "reporting customization files (bug scripts and/or bug control files and/or "
2010 "presubj files) into package build directories."
2014 #: 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:26 dh_installlogcheck:21 dh_installman:51 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
2020 msgid "debian/I<package>.bug-script"
2026 "This is the script to be run by the bug reporting program for generating a "
2027 "bug report template. This file is installed as F<usr/share/bug/package> in "
2028 "the package build directory if no other types of bug reporting customization "
2029 "files are going to be installed for the package in question. Otherwise, this "
2030 "file is installed as F<usr/share/bug/package/script>. Finally, the installed "
2031 "script is given execute permissions."
2036 msgid "debian/I<package>.bug-control"
2042 "It is the bug control file containing some directions for the bug reporting "
2043 "tool. This file is installed as F<usr/share/bug/package/control> in the "
2044 "package build directory."
2049 msgid "debian/I<package>.bug-presubj"
2055 "The contents of this file are displayed to the user by the bug reporting "
2056 "tool before allowing the user to write a bug report on the package to the "
2057 "Debian Bug Tracking System. This file is installed as "
2058 "F<usr/share/bug/package/presubj> in the package build directory."
2064 "Install F<debian/bug-*> files to ALL packages acted on when respective "
2065 "F<debian/package.bug-*> files do not exist. Normally, F<debian/bug-*> will "
2066 "be installed to the first package only."
2071 msgid "F</usr/share/doc/reportbug/README.developers.gz>"
2075 #: dh_bugfiles:126 dh_lintian:59
2076 msgid "L<debhelper(1)>"
2081 msgid "Modestas Vainius <modestas@vainius.eu>"
2086 msgid "dh_builddeb - build Debian binary packages"
2092 "B<dh_builddeb> [S<I<debhelper options>>] [B<--destdir=>I<directory>] "
2093 "[B<--filename=>I<name>] [S<B<--> I<params>>]"
2099 "B<dh_builddeb> simply calls L<dpkg-deb(1)> to build a Debian package or "
2106 "Use this if you want the generated F<.deb> files to be put in a directory "
2107 "other than the default of \"F<..>\"."
2112 msgid "B<--filename=>I<name>"
2118 "Use this if you want to force the generated .deb file to have a particular "
2119 "file name. Does not work well if more than one .deb is generated!"
2124 msgid "Pass I<params> to L<dpkg-deb(1)> when it is used to build the package."
2129 msgid "B<-u>I<params>"
2135 "This is another way to pass I<params> to L<dpkg-deb(1)>. It is deprecated; "
2136 "use B<--> instead."
2141 msgid "dh_clean - clean up package build directories"
2147 "B<dh_clean> [S<I<debhelper options>>] [B<-k>] [B<-d>] [B<-X>I<item>] "
2155 "B<dh_clean> is a debhelper program that is responsible for cleaning up after "
2157 "package is built. It removes the package build directories, and removes "
2159 "other files including F<debian/files>, and any detritus left behind by "
2161 "debhelper commands. It also removes common files that should not appear in "
2164 " #*# *~ DEADJOE *.orig *.rej *.SUMS TAGS .deps/* *.P *-stamp\n"
2171 "It does not run \"make clean\" to clean up after the build process. Use "
2172 "L<dh_auto_clean(1)> to do things like that."
2178 "B<dh_clean> (or \"B<dh clean>\") should be the last debhelper command run in "
2179 "the B<clean> target in F<debian/rules>."
2184 msgid "F<debian/clean>"
2189 msgid "Can list other files to be removed."
2193 #: dh_clean:45 dh_installchangelogs:60
2194 msgid "B<-k>, B<--keep>"
2199 msgid "This is deprecated, use L<dh_prep(1)> instead."
2204 msgid "B<-d>, B<--dirs-only>"
2210 "Only clean the package build directories, do not clean up any other files at "
2215 #: dh_clean:54 dh_prep:30
2216 msgid "B<-X>I<item> B<--exclude=>I<item>"
2222 "Exclude files that contain I<item> anywhere in their filename from being "
2223 "deleted, even if they would normally be deleted. You may use this option "
2224 "multiple times to build up a list of things to exclude."
2228 #: dh_clean:60 dh_compress:64 dh_installdocs:98 dh_installexamples:46 dh_installinfo:40 dh_installmanpages:44 dh_movefiles:55 dh_testdir:27
2234 msgid "Delete these I<file>s too."
2239 msgid "dh_compress - compress files and fix symlinks in package build directories"
2245 "B<dh_compress> [S<I<debhelper options>>] [B<-X>I<item>] [B<-A>] [S<I<file> "
2252 "B<dh_compress> is a debhelper program that is responsible for compressing "
2253 "the files in package build directories, and makes sure that any symlinks "
2254 "that pointed to the files before they were compressed are updated to point "
2261 "By default, B<dh_compress> compresses files that Debian policy mandates "
2262 "should be compressed, namely all files in F<usr/share/info>, "
2263 "F<usr/share/man>, files in F<usr/share/doc> that are larger than 4k in size, "
2264 "(except the F<copyright> file, F<.html> and other web files, image files, "
2265 "and files that appear to be already compressed based on their extensions), "
2266 "and all F<changelog> files. Plus PCF fonts underneath "
2267 "F<usr/share/fonts/X11/>"
2272 msgid "debian/I<package>.compress"
2277 msgid "These files are deprecated."
2283 "If this file exists, the default files are not compressed. Instead, the file "
2284 "is ran as a shell script, and all filenames that the shell script outputs "
2285 "will be compressed. The shell script will be run from inside the package "
2286 "build directory. Note though that using B<-X> is a much better idea in "
2287 "general; you should only use a F<debian/package.compress> file if you really "
2294 "Exclude files that contain F<item> anywhere in their filename from being "
2295 "compressed. For example, B<-X.tiff> will exclude TIFF files from "
2296 "compression. You may use this option multiple times to build up a list of "
2297 "things to exclude."
2303 "Compress all files specified by command line parameters in ALL packages "
2309 msgid "Add these files to the list of files to compress."
2313 #: dh_compress:70 dh_perl:61 dh_python:66 dh_strip:74 dh_usrlocal:55
2319 msgid "Debian policy, version 3.0"
2324 msgid "dh_desktop - deprecated no-op"
2329 msgid "B<dh_desktop> [S<I<debhelper options>>]"
2335 "B<dh_desktop> was a debhelper program that registers F<.desktop> files. "
2336 "However, it no longer does anything, and is now deprecated."
2342 "If a package ships F<desktop> files, they just need to be installed in the "
2343 "correct location (F</usr/share/applications>) and they will be registered by "
2344 "the appropriate tools for the corresponding desktop environments."
2348 #: dh_desktop:33 dh_icons:67 dh_scrollkeeper:30
2349 msgid "L<debhelper>"
2353 #: dh_desktop:39 dh_scrollkeeper:36
2354 msgid "Ross Burton <ross@burtonini.com>"
2359 msgid "dh_fixperms - fix permissions of files in package build directories"
2364 msgid "B<dh_fixperms> [S<I<debhelper options>>] [B<-X>I<item>]"
2370 "B<dh_fixperms> is a debhelper program that is responsible for setting the "
2371 "permissions of files and directories in package build directories to a sane "
2372 "state -- a state that complies with Debian policy."
2378 "B<dh_fixperms> makes all files in F<usr/share/doc> in the package build "
2379 "directory (excluding files in the F<examples/> directory) be mode 644. It "
2380 "also changes the permissions of all man pages to mode 644. It makes all "
2381 "files be owned by root, and it removes group and other write permission from "
2382 "all files. It removes execute permissions from any libraries, headers, Perl "
2383 "modules, or desktop files that have it set. It makes all files in the "
2384 "standard F<bin> and F<sbin> directories, F<usr/games/> and F<etc/init.d> "
2385 "executable (since v4). Finally, it removes the setuid and setgid bits from "
2386 "all files in the package."
2391 msgid "B<-X>I<item>, B<--exclude> I<item>"
2397 "Exclude files that contain I<item> anywhere in their filename from having "
2398 "their permissions changed. You may use this option multiple times to build "
2399 "up a list of things to exclude."
2404 msgid "dh_gconf - install GConf defaults files and register schemas"
2409 msgid "B<dh_gconf> [S<I<debhelper options>>] [B<--priority=>I<priority>]"
2415 "B<dh_gconf> is a debhelper program that is responsible for installing GConf "
2416 "defaults files and registering GConf schemas."
2421 msgid "An appropriate dependency on gconf2 will be generated in B<${misc:Depends}>."
2426 msgid "debian/I<package>.gconf-defaults"
2432 "Installed into F<usr/share/gconf/defaults/10_package> in the package build "
2433 "directory, with I<package> replaced by the package name."
2438 msgid "debian/I<package>.gconf-mandatory"
2444 "Installed into F<usr/share/gconf/mandatory/10_package> in the package build "
2445 "directory, with I<package> replaced by the package name."
2450 msgid "B<--priority> I<priority>"
2456 "Use I<priority> (which should be a 2-digit number) as the defaults priority "
2457 "instead of B<10>. Higher values than ten can be used by derived "
2458 "distributions (B<20>), CDD distributions (B<50>), or site-specific packages "
2464 msgid "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>"
2469 msgid "dh_gencontrol - generate and install control file"
2474 msgid "B<dh_gencontrol> [S<I<debhelper options>>] [S<B<--> I<params>>]"
2480 "B<dh_gencontrol> is a debhelper program that is responsible for generating "
2481 "control files, and installing them into the I<DEBIAN> directory with the "
2482 "proper permissions."
2488 "This program is merely a wrapper around L<dpkg-gencontrol(1)>, which calls "
2489 "it once for each package being acted on, and passes in some additional "
2495 msgid "Pass I<params> to L<dpkg-gencontrol(1)>."
2500 msgid "B<-u>I<params>, B<--dpkg-gencontrol-params=>I<params>"
2506 "This is another way to pass I<params> to L<dpkg-gencontrol(1)>. It is "
2507 "deprecated; use B<--> instead."
2512 msgid "dh_icons - Update Freedesktop icon caches"
2517 msgid "B<dh_icons> [S<I<debhelper options>>] [B<-n>]"
2523 "B<dh_icons> is a debhelper program that updates Freedesktop icon caches when "
2524 "needed, using the B<update-icon-caches> program provided by GTK+2.12. "
2525 "Currently this program does not handle installation of the files, though it "
2526 "may do so at a later date. It takes care of adding maintainer script "
2527 "fragments to call B<update-icon-caches>."
2531 #: dh_icons:29 dh_installcatalogs:53 dh_installdebconf:65 dh_installemacsen:52 dh_installinit:51 dh_installmenu:45 dh_installmime:45 dh_installmodules:48 dh_installudev:49 dh_installwm:44 dh_makeshlibs:77 dh_python:60 dh_usrlocal:43
2532 msgid "B<-n>, B<--noscripts>"
2537 msgid "Do not modify maintainer scripts."
2543 "Ross Burton <ross@burtonini.com> Jordi Mallach <jordi@debian.org> Josselin "
2544 "Mouette <joss@debian.org>"
2549 msgid "dh_install - install files into package build directories"
2555 "B<dh_install> [B<-X>I<item>] [B<--autodest>] [B<--sourcedir=>I<dir>] "
2556 "[S<I<debhelper options>>] [S<I<file|dir> ... I<destdir>>]"
2562 "B<dh_install> is a debhelper program that handles installing files into "
2563 "package build directories. There are many B<dh_install>I<*> commands that "
2564 "handle installing specific types of files such as documentation, examples, "
2565 "man pages, and so on, and they should be used when possible as they often "
2566 "have extra intelligence for those particular tasks. B<dh_install>, then, is "
2567 "useful for installing everything else, for which no particular intelligence "
2568 "is needed. It is a replacement for the old B<dh_movefiles> command."
2574 "This program may be used in one of two ways. If you just have a file or two "
2575 "that the upstream Makefile does not install for you, you can run "
2576 "B<dh_install> on them to move them into place. On the other hand, maybe you "
2577 "have a large package that builds multiple binary packages. You can use the "
2578 "upstream F<Makefile> to install it all into F<debian/tmp>, and then use "
2579 "B<dh_install> to copy directories and files from there into the proper "
2580 "package build directories."
2586 "From debhelper compatibility level 7 on, B<dh_install> will fall back to "
2587 "looking in F<debian/tmp> for files, if it doesn't find them in the current "
2588 "directory (or whereever you've told it to look using B<--sourcedir>)."
2593 msgid "debian/I<package>.install"
2599 "List the files to install into each package and the directory they should be "
2600 "installed to. The format is a set of lines, where each line lists a file or "
2601 "files to install, and at the end of the line tells the directory it should "
2602 "be installed in. The name of the files (or directories) to install should be "
2603 "given relative to the current directory, while the installation directory is "
2604 "given relative to the package build directory. You may use wildcards in the "
2605 "names of the files to install (in v3 mode and above)."
2611 "Note that if you list exactly one filename or wildcard-pattern on a line by "
2612 "itself, with no explicit destination, then B<dh_install> will automatically "
2613 "guess the destination to use, the same as if the --autodest option were "
2619 msgid "B<--list-missing>"
2625 "This option makes B<dh_install> keep track of the files it installs, and "
2626 "then at the end, compare that list with the files in the source "
2627 "directory. If any of the files (and symlinks) in the source directory were "
2628 "not installed to somewhere, it will warn on stderr about that."
2634 "This may be useful if you have a large package and want to make sure that "
2635 "you don't miss installing newly added files in new upstream releases."
2641 "Note that files that are excluded from being moved via the B<-X> option are "
2647 msgid "B<--fail-missing>"
2653 "This option is like B<--list-missing>, except if a file was missed, it will "
2654 "not only list the missing files, but also fail with a nonzero exit code."
2658 #: dh_install:83 dh_installexamples:43
2660 "Exclude files that contain I<item> anywhere in their filename from being "
2665 #: dh_install:86 dh_movefiles:42
2666 msgid "B<--sourcedir=>I<dir>"
2671 msgid "Look in the specified directory for files to be installed."
2677 "Note that this is not the same as the B<--sourcedirectory> option used by "
2678 "the B<dh_auto_>I<*> commands. You rarely need to use this option, since "
2679 "B<dh_install> automatically looks for files in F<debian/tmp> in debhelper "
2680 "compatibility level 7 and above."
2685 msgid "B<--autodest>"
2691 "Guess as the destination directory to install things to. If this is "
2692 "specified, you should not list destination directories in "
2693 "F<debian/package.install> files or on the command line. Instead, "
2694 "B<dh_install> will guess as follows:"
2700 "Strip off F<debian/tmp> (or the sourcedir if one is given) from the front of "
2701 "the filename, if it is present, and install into the dirname of the "
2702 "filename. So if the filename is F<debian/tmp/usr/bin>, then that directory "
2703 "will be copied to F<debian/package/usr/>. If the filename is "
2704 "F<debian/tmp/etc/passwd>, it will be copied to F<debian/package/etc/>."
2709 msgid "I<file|dir> ... I<destdir>"
2715 "Lists files (or directories) to install and where to install them to. The "
2716 "files will be installed into the first package F<dh_install> acts on."
2728 "B<dh_install> cannot rename files or directories, it can only install them\n"
2729 "with the names they already have into wherever you want in the package\n"
2735 #: dh_installcatalogs:5
2736 msgid "dh_installcatalogs - install and register SGML Catalogs"
2740 #: dh_installcatalogs:16
2741 msgid "B<dh_installcatalogs> [S<I<debhelper options>>] [B<-n>]"
2745 #: dh_installcatalogs:20
2747 "B<dh_installcatalogs> is a debhelper program that installs and registers "
2748 "SGML catalogs. It complies with the Debian XML/SGML policy."
2752 #: dh_installcatalogs:23
2754 "Catalogs will be registered in a supercatalog, in "
2755 "F</etc/sgml/I<package>.cat>."
2759 #: dh_installcatalogs:26
2761 "This command automatically adds maintainer script snippets for registering "
2762 "and unregistering the catalogs and supercatalogs (unless B<-n> is "
2763 "used). These snippets are inserted into the maintainer scripts by "
2764 "B<dh_installdeb>; see L<dh_installdeb(1)> for an explanation of Debhelper "
2765 "maintainer script snippets."
2769 #: dh_installcatalogs:32
2771 "A dependency on B<sgml-base> will be added to B<${misc:Depends}>, so be sure "
2772 "your package uses that variable in F<debian/control>."
2776 #: dh_installcatalogs:39
2777 msgid "debian/I<package>.sgmlcatalogs"
2781 #: dh_installcatalogs:41
2783 "Lists the catalogs to be installed per package. Each line in that file "
2784 "should be of the form C<I<source> I<dest>>, where I<source> indicates where "
2785 "the catalog resides in the source tree, and I<dest> indicates the "
2786 "destination location for the catalog under the package build area. I<dest> "
2787 "should start with F</usr/share/sgml/>."
2791 #: dh_installcatalogs:55 dh_installinit:53
2792 msgid "Do not modify F<postinst>/F<postrm>/F<prerm> scripts."
2796 #: dh_installcatalogs:61 dh_installdocs:122 dh_installemacsen:69 dh_installinit:130 dh_installmime:53 dh_installmodules:62 dh_installudev:57 dh_installwm:56 dh_usrlocal:51
2798 "Note that this command is not idempotent. L<dh_prep(1)> should be called "
2799 "between invocations of this command. Otherwise, it may cause multiple "
2800 "instances of the same text to be added to maintainer scripts."
2804 #: dh_installcatalogs:120
2805 msgid "F</usr/share/doc/sgml-base-doc/>"
2809 #: dh_installcatalogs:124
2810 msgid "Adam Di Carlo <aph@debian.org>"
2814 #: dh_installchangelogs:5
2815 msgid "dh_installchangelogs - install changelogs into package build directories"
2819 #: dh_installchangelogs:14
2821 "B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] "
2826 #: dh_installchangelogs:18
2828 "B<dh_installchangelogs> is a debhelper program that is responsible for "
2829 "installing changelogs into package build directories."
2833 #: dh_installchangelogs:21
2835 "An upstream F<changelog> file may be specified as an option. If none is "
2836 "specified, it looks for files with names that seem likely to be changelogs. "
2837 "(In compatibility level 7 and above.)"
2841 #: dh_installchangelogs:25
2843 "If there is an upstream F<changelog> file, it will be be installed as "
2844 "F<usr/share/doc/package/changelog> in the package build directory. If the "
2845 "changelog is a F<html> file (determined by file extension), it will be "
2846 "installed as F<usr/share/doc/package/changelog.html> instead, and will be "
2847 "converted to plain text with B<html2text> to generate "
2848 "F<usr/share/doc/package/changelog>."
2852 #: dh_installchangelogs:36
2853 msgid "F<debian/changelog>"
2857 #: dh_installchangelogs:38
2858 msgid "F<debian/NEWS>"
2862 #: dh_installchangelogs:40
2863 msgid "debian/I<package>.changelog"
2867 #: dh_installchangelogs:42
2868 msgid "debian/I<package>.NEWS"
2872 #: dh_installchangelogs:44
2874 "Automatically installed into usr/share/doc/I<package>/ in the package build "
2879 #: dh_installchangelogs:47
2881 "Use the package specific name if I<package> needs a different F<NEWS> or "
2882 "F<changelog> file."
2886 #: dh_installchangelogs:50
2888 "The F<changelog> file is installed with a name of changelog for native "
2889 "packages, and F<changelog.Debian> for non-native packages. The F<NEWS> file "
2890 "is always installed with a name of F<NEWS.Debian>."
2894 #: dh_installchangelogs:62
2896 "Keep the original name of the upstream changelog. This will be accomplished "
2897 "by installing the upstream changelog as F<changelog>, and making a symlink "
2898 "from that to the original name of the F<changelog> file. This can be useful "
2899 "if the upstream changelog has an unusual name, or if other documentation in "
2900 "the package refers to the F<changelog> file."
2904 #: dh_installchangelogs:70
2906 "Exclude upstream F<changelog> files that contain I<item> anywhere in their "
2907 "filename from being installed."
2911 #: dh_installchangelogs:73
2916 #: dh_installchangelogs:75
2917 msgid "Install this file as the upstream changelog."
2922 msgid "dh_installcron - install cron scripts into etc/cron.*"
2926 #: dh_installcron:14
2927 msgid "B<dh_installcron> [S<B<debhelper options>>] [B<--name=>I<name>]"
2931 #: dh_installcron:18
2933 "B<dh_installcron> is a debhelper program that is responsible for installing "
2938 #: dh_installcron:25
2939 msgid "debian/I<package>.cron.daily"
2943 #: dh_installcron:27
2944 msgid "debian/I<package>.cron.weekly"
2948 #: dh_installcron:29
2949 msgid "debian/I<package>.cron.monthly"
2953 #: dh_installcron:31
2954 msgid "debian/I<package>.cron.hourly"
2958 #: dh_installcron:33
2959 msgid "debian/I<package>.cron.d"
2963 #: dh_installcron:35
2965 "Installed into the appropriate F<etc/cron.*/> directory in the package build "
2970 #: dh_installcron:44 dh_installifupdown:43 dh_installinit:98 dh_installlogcheck:46 dh_installlogrotate:26 dh_installmodules:52 dh_installpam:35 dh_installppp:39 dh_installudev:39
2971 msgid "B<--name=>I<name>"
2975 #: dh_installcron:46
2977 "Look for files named F<debian/package.name.cron.*> and install them as "
2978 "F<etc/cron.*/name>, instead of using the usual files and installing them as "
2984 msgid "dh_installdeb - install files into the DEBIAN directory"
2989 msgid "B<dh_installdeb> [S<I<debhelper options>>]"
2995 "B<dh_installdeb> is a debhelper program that is responsible for installing "
2996 "files into the F<DEBIAN> directories in package build directories with the "
2997 "correct permissions."
3002 msgid "I<package>.postinst"
3007 msgid "I<package>.preinst"
3012 msgid "I<package>.postrm"
3017 msgid "I<package>.prerm"
3022 msgid "These maintainer scripts are installed into the F<DEBIAN> directory."
3028 "Inside the scripts, the token B<#DEBHELPER#> is replaced with shell script "
3029 "snippets generated by other debhelper commands."
3034 msgid "I<package>.triggers"
3039 msgid "I<package>.shlibs"
3044 msgid "These control files are installed into the F<DEBIAN> directory."
3049 msgid "I<package>.conffiles"
3054 msgid "This control file will be installed into the F<DEBIAN> directory."
3060 "In v3 compatibility mode and higher, all files in the F<etc/> directory in a "
3061 "package will automatically be flagged as conffiles by this program, so there "
3062 "is no need to list them manually here."
3067 msgid "I<package>.maintscript"
3073 "Lines in this file correspond to L<dpkg-maintscript-helper(1)> commands and "
3074 "parameters. Any shell metacharacters will be escaped, so arbitrary shell "
3075 "code cannot be inserted here. For example, a line such as C<mv_conffile "
3076 "/etc/oldconffile /etc/newconffile> will insert maintainer script snippets "
3077 "into all maintainer scripts sufficient to move that conffile."
3083 "A versioned Pre-Dependency on dpkg is needed to use "
3084 "L<dpkg-maintscript-helper(1)>. An appropriate Pre-Dependency is set in "
3085 "${misc:Pre-Depends} ; you should make sure to put that token into an "
3086 "appropriate place in your debian/control file."
3090 #: dh_installdebconf:5
3092 "dh_installdebconf - install files used by debconf in package build "
3097 #: dh_installdebconf:14
3098 msgid "B<dh_installdebconf> [S<I<debhelper options>>] [B<-n>] [S<B<--> I<params>>]"
3102 #: dh_installdebconf:18
3104 "B<dh_installdebconf> is a debhelper program that is responsible for "
3105 "installing files used by debconf into package build directories."
3109 #: dh_installdebconf:21
3111 "It also automatically generates the F<postrm> commands needed to interface "
3112 "with debconf. The commands are added to the maintainer scripts by "
3113 "B<dh_installdeb>. See L<dh_installdeb(1)> for an explanation of how that "
3118 #: dh_installdebconf:26
3120 "Note that if you use debconf, your package probably needs to depend on it "
3121 "(it will be added to B<${misc:Depends}> by this program)."
3125 #: dh_installdebconf:29
3127 "Note that for your config script to be called by B<dpkg>, your F<postinst> "
3128 "needs to source debconf's confmodule. B<dh_installdebconf> does not install "
3129 "this statement into the F<postinst> automatically as it is too hard to do it "
3134 #: dh_installdebconf:38
3135 msgid "debian/I<package>.config"
3139 #: dh_installdebconf:40
3141 "This is the debconf F<config> script, and is installed into the F<DEBIAN> "
3142 "directory in the package build directory."
3146 #: dh_installdebconf:43
3148 "Inside the script, the token B<#DEBHELPER#> is replaced with shell script "
3149 "snippets generated by other debhelper commands."
3153 #: dh_installdebconf:46
3154 msgid "debian/I<package>.templates"
3158 #: dh_installdebconf:48
3160 "This is the debconf F<templates> file, and is installed into the F<DEBIAN> "
3161 "directory in the package build directory."
3165 #: dh_installdebconf:51
3166 msgid "F<debian/po/>"
3170 #: dh_installdebconf:53
3172 "If this directory is present, this program will automatically use "
3173 "L<po2debconf(1)> to generate merged templates files that include the "
3174 "translations from there."
3178 #: dh_installdebconf:57
3179 msgid "For this to work, your package should build-depend on F<po-debconf>."
3183 #: dh_installdebconf:67
3184 msgid "Do not modify F<postrm> script."
3188 #: dh_installdebconf:71
3189 msgid "Pass the params to B<po2debconf>."
3194 msgid "dh_installdirs - create subdirectories in package build directories"
3198 #: dh_installdirs:14
3199 msgid "B<dh_installdirs> [S<I<debhelper options>>] [B<-A>] [S<I<dir> ...>]"
3203 #: dh_installdirs:18
3205 "B<dh_installdirs> is a debhelper program that is responsible for creating "
3206 "subdirectories in package build directories."
3210 #: dh_installdirs:25
3211 msgid "debian/I<package>.dirs"
3215 #: dh_installdirs:27
3216 msgid "Lists directories to be created in I<package>."
3220 #: dh_installdirs:37
3222 "Create any directories specified by command line parameters in ALL packages "
3223 "acted on, not just the first."
3227 #: dh_installdirs:40
3232 #: dh_installdirs:42
3234 "Create these directories in the package build directory of the first package "
3235 "acted on. (Or in all packages if B<-A> is specified.)"
3240 msgid "dh_installdocs - install documentation into package build directories"
3244 #: dh_installdocs:14
3246 "B<dh_installdocs> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] "
3251 #: dh_installdocs:18
3253 "B<dh_installdocs> is a debhelper program that is responsible for installing "
3254 "documentation into F<usr/share/doc/package> in package build directories."
3258 #: dh_installdocs:25
3259 msgid "debian/I<package>.docs"
3263 #: dh_installdocs:27
3264 msgid "List documentation files to be installed into I<package>."
3268 #: dh_installdocs:29
3269 msgid "F<debian/copyright>"
3273 #: dh_installdocs:31
3275 "The copyright file is installed into all packages, unless a more specific "
3276 "copyright file is available."
3280 #: dh_installdocs:34
3281 msgid "debian/I<package>.copyright"
3285 #: dh_installdocs:36
3286 msgid "debian/I<package>.README.Debian"
3290 #: dh_installdocs:38
3291 msgid "debian/I<package>.TODO"
3295 #: dh_installdocs:40
3296 msgid "Each of these files is automatically installed if present for a I<package>."
3300 #: dh_installdocs:43
3301 msgid "F<debian/README.Debian>"
3305 #: dh_installdocs:45
3306 msgid "F<debian/TODO>"
3310 #: dh_installdocs:47
3312 "These files are installed into the first binary package listed in "
3317 #: dh_installdocs:50
3319 "Note that F<README.debian> files are also installed as F<README.Debian>, and "
3320 "F<TODO> files will be installed as F<TODO.Debian> in non-native packages."
3324 #: dh_installdocs:53
3325 msgid "debian/I<package>.doc-base"
3329 #: dh_installdocs:55
3331 "Installed as doc-base control files. Note that the doc-id will be determined "
3332 "from the B<Document:> entry in the doc-base control file in question."
3336 #: dh_installdocs:59
3337 msgid "debian/I<package>.doc-base.*"
3341 #: dh_installdocs:61
3343 "If your package needs to register more than one document, you need multiple "
3344 "doc-base files, and can name them like this."
3348 #: dh_installdocs:72 dh_installinfo:37 dh_installman:67
3350 "Install all files specified by command line parameters in ALL packages acted "
3355 #: dh_installdocs:77
3357 "Exclude files that contain I<item> anywhere in their filename from being "
3358 "installed. Note that this includes doc-base files."
3362 #: dh_installdocs:80
3363 msgid "B<--link-doc=>I<package>"
3367 #: dh_installdocs:82
3369 "Make the documentation directory of all packages acted on be a symlink to "
3370 "the documentation directory of I<package>. This has no effect when acting on "
3371 "I<package> itself, or if the documentation directory to be created already "
3372 "exists when B<dh_installdocs> is run. To comply with policy, I<package> must "
3373 "be a binary package that comes from the same source package."
3377 #: dh_installdocs:88
3379 "debhelper will try to avoid installing files into linked documentation "
3380 "directories that would cause conflicts with the linked package. The B<-A> "
3381 "option will have no effect on packages with linked documentation "
3382 "directories, and F<copyright>, F<changelog>, F<README.Debian>, and F<TODO> "
3383 "files will not be installed."
3387 #: dh_installdocs:94
3389 "(An older method to accomplish the same thing, which is still supported, is "
3390 "to make the documentation directory of a package be a dangling symlink, "
3391 "before calling B<dh_installdocs>.)"
3395 #: dh_installdocs:100
3397 "Install these files as documentation into the first package acted on. (Or in "
3398 "all packages if B<-A> is specified)."
3402 #: dh_installdocs:107
3403 msgid "This is an example of a F<debian/package.docs> file:"
3407 #: dh_installdocs:109
3412 " debian/notes-for-maintainers.txt\n"
3413 " docs/manual.txt\n"
3414 " docs/manual.pdf\n"
3415 " docs/manual-html/\n"
3420 #: dh_installdocs:118
3422 "Note that B<dh_installdocs> will happily copy entire directory hierarchies "
3423 "if you ask it to (similar to B<cp -a>). If it is asked to install a "
3424 "directory, it will install the complete contents of the directory."
3428 #: dh_installemacsen:5
3429 msgid "dh_installemacsen - register an Emacs add on package"
3433 #: dh_installemacsen:14
3435 "B<dh_installemacsen> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] "
3436 "[B<--flavor=>I<foo>]"
3440 #: dh_installemacsen:18
3442 "B<dh_installemacsen> is a debhelper program that is responsible for "
3443 "installing files used by the Debian B<emacsen-common> package into package "
3444 "build directories."
3448 #: dh_installemacsen:22
3450 "It also automatically generates the F<postinst> and F<prerm> commands needed "
3451 "to register a package as an Emacs add on package. The commands are added to "
3452 "the maintainer scripts by B<dh_installdeb>. See L<dh_installdeb(1)> for an "
3453 "explanation of how this works."
3457 #: dh_installemacsen:31
3458 msgid "debian/I<package>.emacsen-install"
3462 #: dh_installemacsen:33
3464 "Installed into F<usr/lib/emacsen-common/packages/install/package> in the "
3465 "package build directory."
3469 #: dh_installemacsen:36
3470 msgid "debian/I<package>.emacsen-remove"
3474 #: dh_installemacsen:38
3476 "Installed into F<usr/lib/emacsen-common/packages/remove/package> in the "
3477 "package build directory."
3481 #: dh_installemacsen:41
3482 msgid "debian/I<package>.emacsen-startup"
3486 #: dh_installemacsen:43
3488 "Installed into etc/emacs/site-start.d/50I<package>.el in the package build "
3489 "directory. Use B<--priority> to use a different priority than 50."
3493 #: dh_installemacsen:54 dh_python:62 dh_usrlocal:45
3494 msgid "Do not modify F<postinst>/F<prerm> scripts."
3498 #: dh_installemacsen:56 dh_installwm:38
3499 msgid "B<--priority=>I<n>"
3503 #: dh_installemacsen:58
3504 msgid "Sets the priority number of a F<site-start.d> file. Default is 50."
3508 #: dh_installemacsen:60
3509 msgid "B<--flavor=>I<foo>"
3513 #: dh_installemacsen:62
3515 "Sets the flavor a F<site-start.d> file will be installed in. Default is "
3516 "B<emacs>, alternatives include B<xemacs> and B<emacs20>."
3520 #: dh_installexamples:5
3521 msgid "dh_installexamples - install example files into package build directories"
3525 #: dh_installexamples:14
3527 "B<dh_installexamples> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] "
3532 #: dh_installexamples:18
3534 "B<dh_installexamples> is a debhelper program that is responsible for "
3535 "installing examples into F<usr/share/doc/package/examples> in package build "
3540 #: dh_installexamples:26
3541 msgid "debian/I<package>.examples"
3545 #: dh_installexamples:28
3546 msgid "Lists example files or directories to be installed."
3550 #: dh_installexamples:38
3552 "Install any files specified by command line parameters in ALL packages acted "
3557 #: dh_installexamples:48
3559 "Install these files (or directories) as examples into the first package "
3560 "acted on. (Or into all packages if B<-A> is specified.)"
3564 #: dh_installexamples:55
3566 "Note that B<dh_installexamples> will happily copy entire directory "
3567 "hierarchies if you ask it to (similar to B<cp -a>). If it is asked to "
3568 "install a directory, it will install the complete contents of the directory."
3572 #: dh_installifupdown:5
3573 msgid "dh_installifupdown - install if-up and if-down hooks"
3577 #: dh_installifupdown:14
3578 msgid "B<dh_installifupdown> [S<I<debhelper options>>] [B<--name=>I<name>]"
3582 #: dh_installifupdown:18
3584 "B<dh_installifupdown> is a debhelper program that is responsible for "
3585 "installing F<if-up>, F<if-down>, F<if-pre-up>, and F<if-post-down> hook "
3586 "scripts into package build directories."
3590 #: dh_installifupdown:26
3591 msgid "debian/I<package>.if-up"
3595 #: dh_installifupdown:28
3596 msgid "debian/I<package>.if-down"
3600 #: dh_installifupdown:30
3601 msgid "debian/I<package>.if-pre-up"
3605 #: dh_installifupdown:32
3606 msgid "debian/I<package>.if-post-down"
3610 #: dh_installifupdown:34
3612 "These files are installed into etc/network/if-*.d/I<package> in the package "
3617 #: dh_installifupdown:45
3619 "Look for files named F<debian/package.name.if-*> and install them as "
3620 "F<etc/network/if-*/name>, instead of using the usual files and installing "
3621 "them as the package name."
3626 msgid "dh_installinfo - install info files"
3630 #: dh_installinfo:14
3631 msgid "B<dh_installinfo> [S<I<debhelper options>>] [B<-A>] [S<I<file> ...>]"
3635 #: dh_installinfo:18
3637 "B<dh_installinfo> is a debhelper program that is responsible for installing "
3638 "info files into F<usr/share/info> in the package build directory."
3642 #: dh_installinfo:25
3643 msgid "debian/I<package>.info"
3647 #: dh_installinfo:27
3648 msgid "List info files to be installed."
3652 #: dh_installinfo:42
3654 "Install these info files into the first package acted on. (Or in all "
3655 "packages if B<-A> is specified)."
3661 "dh_installinit - install init scripts and/or upstart jobs into package build "
3666 #: dh_installinit:14
3668 "B<dh_installinit> [S<I<debhelper options>>] [B<--name=>I<name>] [B<-n>] "
3669 "[B<-R>] [B<-r>] [B<-d>] [S<B<--> I<params>>]"
3673 #: dh_installinit:18
3675 "B<dh_installinit> is a debhelper program that is responsible for installing "
3676 "init scripts with associated defaults files, as well as upstart job files "
3677 "into package build directories."
3681 #: dh_installinit:22
3683 "It also automatically generates the F<postinst> and F<postrm> and F<prerm> "
3684 "commands needed to set up the symlinks in F</etc/rc*.d/> to start and stop "
3689 #: dh_installinit:30
3690 msgid "debian/I<package>.init"
3694 #: dh_installinit:32
3696 "If this exists, it is installed into etc/init.d/I<package> in the package "
3701 #: dh_installinit:35
3702 msgid "debian/I<package>.default"
3706 #: dh_installinit:37
3708 "If this exists, it is installed into etc/default/I<package> in the package "
3713 #: dh_installinit:40
3714 msgid "debian/I<package>.upstart"
3718 #: dh_installinit:42
3720 "If this exists, it is installed into etc/init/I<package>.conf in the package "
3725 #: dh_installinit:55
3726 msgid "B<-o>, B<--onlyscripts>"
3730 #: dh_installinit:57
3732 "Only modify F<postinst>/F<postrm>/F<prerm> scripts, do not actually install "
3733 "any init script, default files, or upstart job. May be useful if the init "
3734 "script or upstart job is shipped and/or installed by upstream in a way that "
3735 "doesn't make it easy to let B<dh_installinit> find it."
3739 #: dh_installinit:62
3740 msgid "B<-R>, B<--restart-after-upgrade>"
3744 #: dh_installinit:64
3746 "Do not stop the init script until after the package upgrade has been "
3747 "completed. This is different than the default behavior, which stops the "
3748 "script in the F<prerm>, and starts it again in the F<postinst>."
3752 #: dh_installinit:68
3754 "This can be useful for daemons that should not have a possibly long downtime "
3755 "during upgrade. But you should make sure that the daemon will not get "
3756 "confused by the package being upgraded while it's running before using this "
3761 #: dh_installinit:73
3762 msgid "B<-r>, B<--no-restart-on-upgrade>"
3766 #: dh_installinit:75
3767 msgid "Do not stop init script on upgrade."
3771 #: dh_installinit:77
3772 msgid "B<--no-start>"
3776 #: dh_installinit:79
3778 "Do not start the init script on install or upgrade, or stop it on removal. "
3779 "Only call B<update-rc.d>. Useful for rcS scripts."
3783 #: dh_installinit:82
3784 msgid "B<-d>, B<--remove-d>"
3788 #: dh_installinit:84
3790 "Remove trailing B<d> from the name of the package, and use the result for "
3791 "the filename the upstart job file is installed as in F<etc/init/> , and for "
3792 "the filename the init script is installed as in etc/init.d and the default "
3793 "file is installed as in F<etc/default/> . This may be useful for daemons "
3794 "with names ending in B<d>. (Note: this takes precedence over the "
3795 "B<--init-script> parameter described below.)"
3799 #: dh_installinit:91
3800 msgid "B<-u>I<params> B<--update-rcd-params=>I<params>"
3804 #: dh_installinit:95
3806 "Pass I<params> to L<update-rc.d(8)>. If not specified, B<defaults> will be "
3807 "passed to L<update-rc.d(8)>."
3811 #: dh_installinit:100
3813 "Install the init script (and default file) as well as upstart job file using "
3814 "the filename I<name> instead of the default filename, which is the package "
3815 "name. When this parameter is used, B<dh_installinit> looks for and installs "
3816 "files named F<debian/package.name.init>, F<debian/package.name.default> and "
3817 "F<debian/package.name.upstart> instead of the usual F<debian/package.init>, "
3818 "F<debian/package.default> and F<debian/package.upstart>."
3822 #: dh_installinit:108
3823 msgid "B<--init-script=>I<scriptname>"
3827 #: dh_installinit:110
3829 "Use I<scriptname> as the filename the init script is installed as in "
3830 "F<etc/init.d/> (and also use it as the filename for the defaults file, if it "
3831 "is installed). If you use this parameter, B<dh_installinit> will look to see "
3832 "if a file in the F<debian/> directory exists that looks like "
3833 "F<package.scriptname> and if so will install it as the init script in "
3834 "preference to the files it normally installs."
3838 #: dh_installinit:117
3840 "This parameter is deprecated, use the B<--name> parameter instead. This "
3841 "parameter is incompatible with the use of upstart jobs."
3845 #: dh_installinit:120
3846 msgid "B<--error-handler=>I<function>"
3850 #: dh_installinit:122
3852 "Call the named shell I<function> if running the init script fails. The "
3853 "function should be provided in the F<prerm> and F<postinst> scripts, before "
3854 "the B<#DEBHELPER#> token."
3858 #: dh_installinit:262
3863 #: dh_installinit:266
3864 msgid "Steve Langasek <steve.langasek@canonical.com>"
3868 #: dh_installlogcheck:5
3869 msgid "dh_installlogcheck - install logcheck rulefiles into etc/logcheck/"
3873 #: dh_installlogcheck:14
3874 msgid "B<dh_installlogcheck> [S<I<debhelper options>>]"
3878 #: dh_installlogcheck:18
3880 "B<dh_installlogcheck> is a debhelper program that is responsible for "
3881 "installing logcheck rule files."
3885 #: dh_installlogcheck:25
3886 msgid "debian/I<package>.logcheck.cracking"
3890 #: dh_installlogcheck:27
3891 msgid "debian/I<package>.logcheck.violations"
3895 #: dh_installlogcheck:29
3896 msgid "debian/I<package>.logcheck.violations.ignore"
3900 #: dh_installlogcheck:31
3901 msgid "debian/I<package>.logcheck.ignore.workstation"
3905 #: dh_installlogcheck:33
3906 msgid "debian/I<package>.logcheck.ignore.server"
3910 #: dh_installlogcheck:35
3911 msgid "debian/I<package>.logcheck.ignore.paranoid"
3915 #: dh_installlogcheck:37
3917 "Each of these files, if present, are installed into corresponding "
3918 "subdirectories of F<etc/logcheck/> in package build directories."
3922 #: dh_installlogcheck:48
3924 "Look for files named F<debian/package.name.logcheck.*> and install them into "
3925 "the corresponding subdirectories of F<etc/logcheck/>, but use the specified "
3926 "name instead of that of the package."
3930 #: dh_installlogcheck:82
3933 "This program is a part of debhelper.\n"
3938 #: dh_installlogcheck:86
3939 msgid "Jon Middleton <jjm@debian.org>"
3943 #: dh_installlogrotate:5
3944 msgid "dh_installlogrotate - install logrotate config files"
3948 #: dh_installlogrotate:14
3949 msgid "B<dh_installlogrotate> [S<I<debhelper options>>] [B<--name=>I<name>]"
3953 #: dh_installlogrotate:18
3955 "B<dh_installlogrotate> is a debhelper program that is responsible for "
3956 "installing logrotate config files into F<etc/logrotate.d> in package build "
3957 "directories. Files named F<debian/package.logrotate> are installed."
3961 #: dh_installlogrotate:28
3963 "Look for files named F<debian/package.name.logrotate> and install them as "
3964 "F<etc/logrotate.d/name>, instead of using the usual files and installing "
3965 "them as the package name."
3970 msgid "dh_installman - install man pages into package build directories"
3975 msgid "B<dh_installman> [S<I<debhelper options>>] [S<I<manpage> ...>]"
3981 "B<dh_installman> is a debhelper program that handles installing man pages "
3982 "into the correct locations in package build directories. You tell it what "
3983 "man pages go in your packages, and it figures out where to install them "
3984 "based on the section field in their B<.TH> or B<.Dt> line. If you have a "
3985 "properly formatted B<.TH> or B<.Dt> line, your man page will be installed "
3986 "into the right directory, with the right name (this includes proper handling "
3987 "of pages with a subsection, like B<3perl>, which are placed in F<man3>, and "
3988 "given an extension of F<.3perl>). If your B<.TH> or B<.Dt> line is incorrect "
3989 "or missing, the program may guess wrong based on the file extension."
3995 "It also supports translated man pages, by looking for extensions like "
3996 "F<.ll.8> and F<.ll_LL.8>, or by use of the B<--language> switch."
4002 "If B<dh_installman> seems to install a man page into the wrong section or "
4003 "with the wrong extension, this is because the man page has the wrong section "
4004 "listed in its B<.TH> or B<.Dt> line. Edit the man page and correct the "
4005 "section, and B<dh_installman> will follow suit. See L<man(7)> for details "
4006 "about the B<.TH> section, and L<mdoc(7)> for the B<.Dt> section. If "
4007 "B<dh_installman> seems to install a man page into a directory like "
4008 "F</usr/share/man/pl/man1/>, that is because your program has a name like "
4009 "F<foo.pl>, and B<dh_installman> assumes that means it is translated into "
4010 "Polish. Use B<--language=C> to avoid this."
4016 "After the man page installation step, B<dh_installman> will check to see if "
4017 "any of the man pages in the temporary directories of any of the packages it "
4018 "is acting on contain F<.so> links. If so, it changes them to symlinks."
4024 "Also, B<dh_installman> will use man to guess the character encoding of each "
4025 "manual page and convert it to UTF-8. If the guesswork fails for some reason, "
4026 "you can override it using an encoding declaration. See L<manconv(1)> for "
4032 msgid "debian/I<package>.manpages"
4037 msgid "Lists man pages to be installed."
4042 msgid "B<--language=>I<ll>"
4048 "Use this to specify that the man pages being acted on are written in the "
4049 "specified language."
4054 msgid "I<manpage> ..."
4060 "Install these man pages into the first package acted on. (Or in all packages "
4061 "if B<-A> is specified)."
4067 "An older version of this program, L<dh_installmanpages(1)>, is still used by "
4068 "some packages, and so is still included in debhelper. It is, however, "
4069 "deprecated, due to its counterintuitive and inconsistent interface. Use this "
4074 #: dh_installmanpages:5
4075 msgid "dh_installmanpages - old-style man page installer (deprecated)"
4079 #: dh_installmanpages:15
4080 msgid "B<dh_installmanpages> [S<I<debhelper options>>] [S<I<file> ...>]"
4084 #: dh_installmanpages:19
4086 "B<dh_installmanpages> is a debhelper program that is responsible for "
4087 "automatically installing man pages into F<usr/share/man/> in package build "
4092 #: dh_installmanpages:23
4094 "This is a DWIM-style program, with an interface unlike the rest of "
4095 "debhelper. It is deprecated, and you are encouraged to use "
4096 "L<dh_installman(1)> instead."
4100 #: dh_installmanpages:27
4102 "B<dh_installmanpages> scans the current directory and all subdirectories for "
4103 "filenames that look like man pages. (Note that only real files are looked "
4104 "at; symlinks are ignored.) It uses L<file(1)> to verify that the files are "
4105 "in the correct format. Then, based on the files' extensions, it installs "
4106 "them into the correct man directory."
4110 #: dh_installmanpages:33
4112 "All filenames specified as parameters will be skipped by "
4113 "B<dh_installmanpages>. This is useful if by default it installs some man "
4114 "pages that you do not want to be installed."
4118 #: dh_installmanpages:37
4120 "After the man page installation step, B<dh_installmanpages> will check to "
4121 "see if any of the man pages are F<.so> links. If so, it changes them to "
4126 #: dh_installmanpages:46
4128 "Do not install these files as man pages, even if they look like valid man "
4133 #: dh_installmanpages:51
4138 #: dh_installmanpages:53
4140 "B<dh_installmanpages> will install the man pages it finds into B<all> "
4141 "packages you tell it to act on, since it can't tell what package the man "
4142 "pages belong in. This is almost never what you really want (use B<-p> to "
4143 "work around this, or use the much better L<dh_installman(1)> program "
4148 #: dh_installmanpages:58
4149 msgid "Files ending in F<.man> will be ignored."
4153 #: dh_installmanpages:60
4155 "Files specified as parameters that contain spaces in their filenames will "
4156 "not be processed properly."
4161 msgid "dh_installmenu - install Debian menu files into package build directories"
4165 #: dh_installmenu:14
4166 msgid "B<dh_installmenu> [S<B<debhelper options>>] [B<-n>]"
4170 #: dh_installmenu:18
4172 "B<dh_installmenu> is a debhelper program that is responsible for installing "
4173 "files used by the Debian B<menu> package into package build directories."
4177 #: dh_installmenu:21
4179 "It also automatically generates the F<postinst> and F<postrm> commands "
4180 "needed to interface with the Debian B<menu> package. These commands are "
4181 "inserted into the maintainer scripts by L<dh_installdeb(1)>."
4185 #: dh_installmenu:29
4186 msgid "debian/I<package>.menu"
4190 #: dh_installmenu:31
4192 "Debian menu files, installed into usr/share/menu/I<package> in the package "
4193 "build directory. See L<menufile(5)> for its format."
4197 #: dh_installmenu:34
4198 msgid "debian/I<package>.menu-method"
4202 #: dh_installmenu:36
4204 "Debian menu method files, installed into etc/menu-methods/I<package> in the "
4205 "package build directory."
4209 #: dh_installmenu:47 dh_installmime:47 dh_makeshlibs:79
4210 msgid "Do not modify F<postinst>/F<postrm> scripts."
4214 #: dh_installmenu:89
4215 msgid "L<debhelper(7)> L<update-menus(1)> L<menufile(5)>"
4220 msgid "dh_installmime - install mime files into package build directories"
4224 #: dh_installmime:14
4225 msgid "B<dh_installmime> [S<I<debhelper options>>] [B<-n>]"
4229 #: dh_installmime:18
4231 "B<dh_installmime> is a debhelper program that is responsible for installing "
4232 "mime files into package build directories."
4236 #: dh_installmime:21
4238 "It also automatically generates the F<postinst> and F<postrm> commands "
4239 "needed to interface with the debian B<mime-support> and B<shared-mime-info> "
4240 "packages. These commands are inserted into the maintainer scripts by "
4241 "L<dh_installdeb(1)>."
4245 #: dh_installmime:29
4246 msgid "debian/I<package>.mime"
4250 #: dh_installmime:31
4252 "Installed into usr/lib/mime/packages/I<package> in the package build "
4257 #: dh_installmime:34
4258 msgid "debian/I<package>.sharedmimeinfo"
4262 #: dh_installmime:36
4264 "Installed into /usr/share/mime/packages/I<package>.xml in the package build "
4269 #: dh_installmodules:5
4270 msgid "dh_installmodules - register modules with modutils"
4274 #: dh_installmodules:16
4275 msgid "B<dh_installmodules> [S<I<debhelper options>>] [B<-n>] [B<--name=>I<name>]"
4279 #: dh_installmodules:20
4281 "B<dh_installmodules> is a debhelper program that is responsible for "
4282 "registering kernel modules."
4286 #: dh_installmodules:23
4288 "Kernel modules are searched for in the package build directory and if found, "
4289 "F<preinst>, F<postinst> and F<postrm> commands are automatically generated "
4290 "to run B<depmod> and register the modules when the package is installed. "
4291 "These commands are inserted into the maintainer scripts by "
4292 "L<dh_installdeb(1)>."
4296 #: dh_installmodules:33
4297 msgid "debian/I<package>.modprobe"
4301 #: dh_installmodules:35
4302 msgid "Installed to etc/modprobe.d/I<package>.conf in the package build directory."
4306 #: dh_installmodules:37
4307 msgid "debian/I<package>.modules"
4311 #: dh_installmodules:39
4313 "These files were installed for use by modutils, but are now not used and "
4314 "B<dh_installmodules> will warn if these files are present."
4318 #: dh_installmodules:50
4319 msgid "Do not modify F<preinst>/F<postinst>/F<postrm> scripts."
4323 #: dh_installmodules:54
4325 "When this parameter is used, B<dh_installmodules> looks for and installs "
4326 "files named debian/I<package>.I<name>.modprobe instead of the usual "
4327 "debian/I<package>.modprobe"
4332 msgid "dh_installpam - install pam support files"
4337 msgid "B<dh_installpam> [S<I<debhelper options>>] [B<--name=>I<name>]"
4343 "B<dh_installpam> is a debhelper program that is responsible for installing "
4344 "files used by PAM into package build directories."
4349 msgid "debian/I<package>.pam"
4354 msgid "Installed into etc/pam.d/I<package> in the package build directory."
4360 "Look for files named debian/I<package>.I<name>.pam and install them as "
4361 "etc/pam.d/I<name>, instead of using the usual files and installing them "
4362 "using the package name."
4367 msgid "dh_installppp - install ppp ip-up and ip-down files"
4372 msgid "B<dh_installppp> [S<I<debhelper options>>] [B<--name=>I<name>]"
4378 "B<dh_installppp> is a debhelper program that is responsible for installing "
4379 "ppp ip-up and ip-down scripts into package build directories."
4384 msgid "debian/I<package>.ppp.ip-up"
4389 msgid "Installed into etc/ppp/ip-up.d/I<package> in the package build directory."
4394 msgid "debian/I<package>.ppp.ip-down"
4399 msgid "Installed into etc/ppp/ip-down.d/I<package> in the package build directory."
4405 "Look for files named F<debian/package.name.ppp.ip-*> and install them as "
4406 "F<etc/ppp/ip-*/name>, instead of using the usual files and installing them "
4407 "as the package name."
4412 msgid "dh_installudev - install udev rules files"
4416 #: dh_installudev:15
4418 "B<dh_installudev> [S<I<debhelper options>>] [B<-n>] [B<--name=>I<name>] "
4419 "[B<--priority=>I<priority>]"
4423 #: dh_installudev:19
4425 "B<dh_installudev> is a debhelper program that is responsible for installing "
4426 "B<udev> rules files."
4430 #: dh_installudev:22
4432 "Code is added to the F<preinst> and F<postinst> to handle the upgrade from "
4433 "the old B<udev> rules file location."
4437 #: dh_installudev:29
4438 msgid "debian/I<package>.udev"
4442 #: dh_installudev:31
4443 msgid "Installed into F<lib/udev/rules.d/> in the package build directory."
4447 #: dh_installudev:41
4449 "When this parameter is used, B<dh_installudev> looks for and installs files "
4450 "named debian/I<package>.I<name>.udev instead of the usual "
4451 "debian/I<package>.udev."
4455 #: dh_installudev:45
4456 msgid "B<--priority=>I<priority>"
4460 #: dh_installudev:47
4461 msgid "Sets the priority string of the F<rules.d> symlink. Default is 60."
4465 #: dh_installudev:51
4466 msgid "Do not modify F<preinst>/F<postinst> scripts."
4471 msgid "dh_installwm - register a window manager"
4477 "B<dh_installwm> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] "
4484 "B<dh_installwm> is a debhelper program that is responsible for generating "
4485 "the F<postinst> and F<prerm> commands that register a window manager with "
4486 "L<update-alternatives(8)>. The window manager's man page is also registered "
4487 "as a slave symlink (in v6 mode and up), if it is found in "
4488 "F<usr/share/man/man1/> in the package build directory."
4493 msgid "debian/I<package>.wm"
4498 msgid "List window manager programs to register."
4504 "Set the priority of the window manager. Default is 20, which is too low for "
4505 "most window managers; see the Debian Policy document for instructions on "
4506 "calculating the correct value."
4511 msgid "Do not modify F<postinst>/F<prerm> scripts. Turns this command into a no-op."
4521 msgid "Window manager programs to register."
4525 #: dh_installxfonts:5
4526 msgid "dh_installxfonts - register X fonts"
4530 #: dh_installxfonts:14
4531 msgid "B<dh_installxfonts> [S<I<debhelper options>>]"
4535 #: dh_installxfonts:18
4537 "B<dh_installxfonts> is a debhelper program that is responsible for "
4538 "registering X fonts, so their corresponding F<fonts.dir>, F<fonts.alias>, "
4539 "and F<fonts.scale> be rebuilt properly at install time."
4543 #: dh_installxfonts:22
4545 "Before calling this program, you should have installed any X fonts provided "
4546 "by your package into the appropriate location in the package build "
4547 "directory, and if you have F<fonts.alias> or F<fonts.scale> files, you "
4548 "should install them into the correct location under F<etc/X11/fonts> in your "
4549 "package build directory."
4553 #: dh_installxfonts:28
4555 "Your package should depend on B<xfonts-utils> so that the "
4556 "B<update-fonts->I<*> commands are available. (This program adds that "
4557 "dependency to B<${misc:Depends}>.)"
4561 #: dh_installxfonts:32
4563 "This program automatically generates the F<postinst> and F<postrm> commands "
4564 "needed to register X fonts. These commands are inserted into the maintainer "
4565 "scripts by B<dh_installdeb>. See L<dh_installdeb(1)> for an explanation of "
4570 #: dh_installxfonts:39
4572 "See L<update-fonts-alias(8)>, L<update-fonts-scale(8)>, and "
4573 "L<update-fonts-dir(8)> for more information about X font installation."
4577 #: dh_installxfonts:42
4579 "See Debian policy, section 11.8.5. for details about doing fonts the Debian "
4585 msgid "dh_link - create symlinks in package build directories"
4591 "B<dh_link> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] [S<I<source "
4592 "destination> ...>]"
4598 "B<dh_link> is a debhelper program that creates symlinks in package build "
4605 "B<dh_link> accepts a list of pairs of source and destination files. The "
4606 "source files are the already existing files that will be symlinked from. The "
4607 "destination files are the symlinks that will be created. There B<must> be an "
4608 "equal number of source and destination files specified."
4614 "Be sure you B<do> specify the full filename to both the source and "
4615 "destination files (unlike you would do if you were using something like "
4622 "B<dh_link> will generate symlinks that comply with Debian policy - absolute "
4623 "when policy says they should be absolute, and relative links with as short a "
4624 "path as possible. It will also create any subdirectories it needs to to put "
4631 "B<dh_link> also scans the package build tree for existing symlinks which do "
4632 "not conform to Debian policy, and corrects them (v4 or later)."
4637 msgid "debian/I<package>.links"
4643 "Lists pairs of source and destination files to be symlinked. Each pair "
4644 "should be put on its own line, with the source and destination separated by "
4651 "Create any links specified by command line parameters in ALL packages acted "
4652 "on, not just the first."
4658 "Exclude symlinks that contain I<item> anywhere in their filename from being "
4659 "corrected to comply with Debian policy."
4664 msgid "I<source destination> ..."
4670 "Create a file named I<destination> as a link to a file named I<source>. Do "
4671 "this in the package build directory of the first package acted on. (Or in "
4672 "all packages if B<-A> is specified.)"
4679 " dh_link usr/share/man/man1/foo.1 usr/share/man/man1/bar.1\n"
4685 msgid "Make F<bar.1> be a symlink to F<foo.1>"
4692 " dh_link var/lib/foo usr/lib/foo \\\n"
4693 " usr/share/man/man1/foo.1 usr/share/man/man1/bar.1\n"
4700 "Make F</usr/lib/foo/> be a link to F</var/lib/foo/>, and F<bar.1> be a "
4701 "symlink to the F<foo.1>"
4706 msgid "dh_lintian - install lintian override files into package build directories"
4711 msgid "B<dh_lintian> [S<I<debhelper options>>]"
4717 "B<dh_lintian> is a debhelper program that is responsible for installing "
4718 "override files used by lintian into package build directories."
4723 msgid "debian/I<package>.lintian-overrides"
4729 "Installed into usr/share/lintian/overrides/I<package> in the package build "
4730 "directory. This file is used to suppress erroneous lintian diagnostics."
4735 msgid "F<debian/source.lintian-overrides>"
4741 "These files are not installed, but will be scanned by lintian to provide "
4742 "overrides for the source package."
4747 msgid "L<lintian(1)>"
4752 msgid "Steve Robbins <smr@debian.org>"
4756 #: dh_listpackages:5
4757 msgid "dh_listpackages - list binary packages debhelper will act on"
4761 #: dh_listpackages:14
4762 msgid "B<dh_listpackages> [S<I<debhelper options>>]"
4766 #: dh_listpackages:18
4768 "B<dh_listpackages> is a debhelper program that outputs a list of all binary "
4769 "packages debhelper commands will act on. If you pass it some options, it "
4770 "will change the list to match the packages other debhelper commands would "
4771 "act on if passed the same options."
4776 msgid "dh_makeshlibs - automatically create shlibs file and call dpkg-gensymbols"
4782 "B<dh_makeshlibs> [S<I<debhelper options>>] [B<-m>I<major>] "
4783 "[B<-V>I<[dependencies]>] [B<-n>] [B<-X>I<item>] [S<B<--> I<params>>]"
4789 "B<dh_makeshlibs> is a debhelper program that automatically scans for shared "
4790 "libraries, and generates a shlibs file for the libraries it finds."
4796 "It also adds a call to ldconfig in the F<postinst> and F<postrm> scripts (in "
4797 "v3 mode and above only) to any packages in which it finds shared libraries."
4803 "Packages that support multiarch are detected, and a Pre-Dependency on "
4804 "multiarch-support is set in ${misc:Pre-Depends} ; you should make sure to "
4805 "put that token into an appropriate place in your debian/control file for "
4806 "packages supporting multiarch."
4811 msgid "debian/I<package>.symbols"
4816 msgid "debian/I<package>.symbols.I<arch>"
4822 "These symbols files, if present, are passed to L<dpkg-gensymbols(1)> to be "
4823 "processed and installed. Use the I<arch> specific names if you need to "
4824 "provide different symbols files for different architectures."
4829 msgid "B<-m>I<major>, B<--major=>I<major>"
4835 "Instead of trying to guess the major number of the library with objdump, use "
4836 "the major number specified after the -m parameter. This is much less useful "
4837 "than it used to be, back in the bad old days when this program looked at "
4838 "library filenames rather than using objdump."
4843 msgid "B<-V>, B<-V>I<dependencies>"
4848 msgid "B<--version-info>, B<--version-info=>I<dependencies>"
4854 "By default, the shlibs file generated by this program does not make packages "
4855 "depend on any particular version of the package containing the shared "
4856 "library. It may be necessary for you to add some version dependency "
4857 "information to the shlibs file. If B<-V> is specified with no dependency "
4858 "information, the current upstream version of the package is plugged into a "
4859 "dependency that looks like \"I<packagename> B<(E<gt>>= "
4860 "I<packageversion>B<)>\". Note that in debhelper compatibility levels before "
4861 "v4, the Debian part of the package version number is also included. If B<-V> "
4862 "is specified with parameters, the parameters can be used to specify the "
4863 "exact dependency information needed (be sure to include the package name)."
4869 "Beware of using B<-V> without any parameters; this is a conservative setting "
4870 "that always ensures that other packages' shared library dependencies are at "
4871 "least as tight as they need to be (unless your library is prone to changing "
4872 "ABI without updating the upstream version number), so that if the maintainer "
4873 "screws up then they won't break. The flip side is that packages might end up "
4874 "with dependencies that are too tight and so find it harder to be upgraded."
4880 "Exclude files that contain I<item> anywhere in their filename or directory "
4881 "from being treated as shared libraries."
4886 msgid "B<--add-udeb=>I<udeb>"
4892 "Create an additional line for udebs in the shlibs file and use I<udeb> as "
4893 "the package name for udebs to depend on instead of the regular library "
4899 msgid "Pass I<params> to L<dpkg-gensymbols(1)>."
4903 #: dh_makeshlibs:101
4904 msgid "B<dh_makeshlibs>"
4908 #: dh_makeshlibs:103
4911 "Assuming this is a package named F<libfoobar1>, generates a shlibs file "
4913 "looks something like:\n"
4914 " libfoobar 1 libfoobar1\n"
4919 #: dh_makeshlibs:107
4920 msgid "B<dh_makeshlibs -V>"
4924 #: dh_makeshlibs:109
4927 "Assuming the current version of the package is 1.1-3, generates a shlibs\n"
4928 "file that looks something like:\n"
4929 " libfoobar 1 libfoobar1 (>= 1.1)\n"
4934 #: dh_makeshlibs:113
4935 msgid "B<dh_makeshlibs -V 'libfoobar1 (E<gt>= 1.0)'>"
4939 #: dh_makeshlibs:115
4942 "Generates a shlibs file that looks something like:\n"
4943 " libfoobar 1 libfoobar1 (>= 1.0)\n"
4949 msgid "dh_md5sums - generate DEBIAN/md5sums file"
4955 "B<dh_md5sums> [S<I<debhelper options>>] [B<-x>] [B<-X>I<item>] "
4956 "[B<--include-conffiles>]"
4962 "B<dh_md5sums> is a debhelper program that is responsible for generating a "
4963 "F<DEBIAN/md5sums> file, which lists the md5sums of each file in the "
4964 "package. These files are used by the B<debsums> package."
4970 "All files in F<DEBIAN/> are omitted from the F<md5sums> file, as are all "
4971 "conffiles (unless you use the B<--include-conffiles> switch)."
4976 msgid "The md5sums file is installed with proper permissions and ownerships."
4981 msgid "B<-x>, B<--include-conffiles>"
4987 "Include conffiles in the md5sums list. Note that this information is "
4988 "redundant since it is included elsewhere in Debian packages."
4994 "Exclude files that contain I<item> anywhere in their filename from being "
4995 "listed in the md5sums file."
5000 msgid "dh_movefiles - move files out of debian/tmp into subpackages"
5006 "B<dh_movefiles> [S<I<debhelper options>>] [B<--sourcedir=>I<dir>] "
5007 "[B<-X>I<item>] S<I<file> ...>]"
5013 "B<dh_movefiles> is a debhelper program that is responsible for moving files "
5014 "out of F<debian/tmp> or some other directory and into other package build "
5015 "directories. This may be useful if your package has a F<Makefile> that "
5016 "installs everything into F<debian/tmp>, and you need to break that up into "
5023 "Note: B<dh_install> is a much better program, and you are recommended to use "
5024 "it instead of B<dh_movefiles>."
5029 msgid "debian/I<package>.files"
5035 "Lists the files to be moved into a package, separated by whitespace. The "
5036 "filenames listed should be relative to F<debian/tmp/>. You can also list "
5037 "directory names, and the whole directory will be moved."
5043 "Instead of moving files out of F<debian/tmp> (the default), this option "
5044 "makes it move files out of some other directory. Since the entire contents "
5045 "of the sourcedir is moved, specifying something like B<--sourcedir=/> is "
5046 "very unsafe, so to prevent mistakes, the sourcedir must be a relative "
5047 "filename; it cannot begin with a `B</>'."
5052 msgid "B<-Xitem>, B<--exclude=item>"
5058 "Exclude files that contain B<item> anywhere in their filename from being "
5065 "Lists files to move. The filenames listed should be relative to "
5066 "F<debian/tmp/>. You can also list directory names, and the whole directory "
5067 "will be moved. It is an error to list files here unless you use B<-p>, "
5068 "B<-i>, or B<-a> to tell B<dh_movefiles> which subpackage to put them in."
5074 "Note that files are always moved out of F<debian/tmp> by default (even if "
5075 "you have instructed debhelper to use a compatibility level higher than one, "
5076 "which does not otherwise use debian/tmp for anything at all). The idea "
5077 "behind this is that the package that is being built can be told to install "
5078 "into F<debian/tmp>, and then files can be moved by B<dh_movefiles> from that "
5079 "directory. Any files or directories that remain are ignored, and get deleted "
5080 "by B<dh_clean> later."
5085 msgid "dh_perl - calculates Perl dependencies and cleans up after MakeMaker"
5090 msgid "B<dh_perl> [S<I<debhelper options>>] [B<-d>] [S<I<library dirs> ...>]"
5096 "B<dh_perl> is a debhelper program that is responsible for generating the "
5097 "B<${perl:Depends}> substitutions and adding them to substvars files."
5103 "The program will look at Perl scripts and modules in your package, and will "
5104 "use this information to generate a dependency on B<perl> or B<perlapi>. The "
5105 "dependency will be substituted into your package's F<control> file wherever "
5106 "you place the token B<${perl:Depends}>."
5112 "B<dh_perl> also cleans up empty directories that MakeMaker can generate when "
5113 "installing Perl modules."
5124 "In some specific cases you may want to depend on B<perl-base> rather than "
5125 "the full B<perl> package. If so, you can pass the -d option to make "
5126 "B<dh_perl> generate a dependency on the correct base package. This is only "
5127 "necessary for some packages that are included in the base system."
5133 "Note that this flag may cause no dependency on B<perl-base> to be generated "
5134 "at all. B<perl-base> is Essential, so its dependency can be left out, unless "
5135 "a versioned dependency is needed."
5146 "By default, scripts and architecture independent modules don't depend on any "
5147 "specific version of B<perl>. The B<-V> option causes the current version of "
5148 "the B<perl> (or B<perl-base> with B<-d>) package to be specified."
5153 msgid "I<library dirs>"
5159 "If your package installs Perl modules in non-standard directories, you can "
5160 "make B<dh_perl> check those directories by passing their names on the "
5161 "command line. It will only check the F<vendorlib> and F<vendorarch> "
5162 "directories by default."
5167 msgid "Debian policy, version 3.8.3"
5172 msgid "Perl policy, version 1.20"
5177 msgid "Brendan O'Dea <bod@debian.org>"
5182 msgid "dh_prep - perform cleanups in preparation for building a binary package"
5187 msgid "B<dh_prep> [S<I<debhelper options>>] [B<-X>I<item>]"
5193 "B<dh_prep> is a debhelper program that performs some file cleanups in "
5194 "preparation for building a binary package. (This is what B<dh_clean -k> used "
5195 "to do.) It removes the package build directories, F<debian/tmp>, and some "
5196 "temp files that are generated when building a binary package."
5202 "It is typically run at the top of the B<binary-arch> and B<binary-indep> "
5203 "targets, or at the top of a target such as install that they depend on."
5209 "Exclude files that contain F<item> anywhere in their filename from being "
5210 "deleted, even if they would normally be deleted. You may use this option "
5211 "multiple times to build up a list of things to exclude."
5217 "dh_python - calculates Python dependencies and adds postinst and prerm "
5218 "Python scripts (deprecated)"
5224 "B<dh_python> [S<I<debhelper options>>] [B<-n>] [B<-V> I<version>] "
5225 "[S<I<module dirs> ...>]"
5231 "Note: This program is deprecated. You should use B<dh_python2> instead. "
5232 "This program will do nothing if F<debian/pycompat> or a B<Python-Version> "
5233 "F<control> file field exists."
5239 "B<dh_python> is a debhelper program that is responsible for generating the "
5240 "B<${python:Depends}> substitutions and adding them to substvars files. It "
5241 "will also add a F<postinst> and a F<prerm> script if required."
5247 "The program will look at Python scripts and modules in your package, and "
5248 "will use this information to generate a dependency on B<python>, with the "
5249 "current major version, or on B<python>I<X>B<.>I<Y> if your scripts or "
5250 "modules need a specific B<python> version. The dependency will be "
5251 "substituted into your package's F<control> file wherever you place the token "
5252 "B<${python:Depends}>."
5258 "If some modules need to be byte-compiled at install time, appropriate "
5259 "F<postinst> and F<prerm> scripts will be generated. If already byte-compiled "
5260 "modules are found, they are removed."
5265 msgid "If you use this program, your package should build-depend on B<python>."
5270 msgid "I<module dirs>"
5276 "If your package installs Python modules in non-standard directories, you can "
5277 "make F<dh_python> check those directories by passing their names on the "
5278 "command line. By default, it will check F</usr/lib/site-python>, "
5279 "F</usr/lib/$PACKAGE>, F</usr/share/$PACKAGE>, F</usr/lib/games/$PACKAGE>, "
5280 "F</usr/share/games/$PACKAGE> and F</usr/lib/python?.?/site-packages>."
5286 "Note: only F</usr/lib/site-python>, F</usr/lib/python?.?/site-packages> and "
5287 "the extra names on the command line are searched for binary (F<.so>) "
5293 msgid "B<-V> I<version>"
5299 "If the F<.py> files your package ships are meant to be used by a specific "
5300 "B<python>I<X>B<.>I<Y> version, you can use this option to specify the "
5301 "desired version, such as B<2.3>. Do not use if you ship modules in "
5302 "F</usr/lib/site-python>."
5307 msgid "Debian policy, version 3.5.7"
5312 msgid "Python policy, version 0.3.7"
5317 msgid "Josselin Mouette <joss@debian.org>"
5322 msgid "most ideas stolen from Brendan O'Dea <bod@debian.org>"
5326 #: dh_scrollkeeper:5
5327 msgid "dh_scrollkeeper - deprecated no-op"
5331 #: dh_scrollkeeper:14
5332 msgid "B<dh_scrollkeeper> [S<I<debhelper options>>] [B<-n>] [S<I<directory>>]"
5336 #: dh_scrollkeeper:18
5338 "B<dh_scrollkeeper> was a debhelper program that handled registering OMF "
5339 "files for ScrollKeeper. However, it no longer does anything, and is now "
5345 msgid "dh_shlibdeps - calculate shared library dependencies"
5351 "B<dh_shlibdeps> [S<I<debhelper options>>] [B<-L>I<package>] "
5352 "[B<-l>I<directory>] [B<-X>I<item>] [S<B<--> I<params>>]"
5358 "B<dh_shlibdeps> is a debhelper program that is responsible for calculating "
5359 "shared library dependencies for packages."
5365 "This program is merely a wrapper around L<dpkg-shlibdeps(1)> that calls it "
5366 "once for each package listed in the F<control> file, passing it a list of "
5367 "ELF executables and shared libraries it has found."
5373 "Exclude files that contain F<item> anywhere in their filename from being "
5374 "passed to B<dpkg-shlibdeps>. This will make their dependencies be ignored. "
5375 "This may be useful in some situations, but use it with caution. This option "
5376 "may be used more than once to exclude more than one thing."
5381 msgid "Pass I<params> to L<dpkg-shlibdeps(1)>."
5386 msgid "B<-u>I<params>, B<--dpkg-shlibdeps-params=>I<params>"
5392 "This is another way to pass I<params> to L<dpkg-shlibdeps(1)>. It is "
5393 "deprecated; use B<--> instead."
5398 msgid "B<-l>I<directory>[B<:>I<directory> ...]"
5404 "With recent versions of B<dpkg-shlibdeps>, this option is generally not "
5411 "Before B<dpkg-shlibdeps> is run, B<LD_LIBRARY_PATH> will have added to it "
5412 "the specified directory (or directories -- separate with colons). With "
5413 "recent versions of B<dpkg-shlibdeps>, this is mostly only useful for "
5414 "packages that build multiple flavors of the same library, or other "
5415 "situations where the library is installed into a directory not on the "
5416 "regular library search path."
5421 msgid "B<-L>I<package>, B<--libpackage=>I<package>"
5427 "With recent versions of B<dpkg-shlibdeps>, this option is generally not "
5428 "needed, unless your package builds multiple flavors of the same library."
5434 "It tells B<dpkg-shlibdeps> (via its B<-S> parameter) to look first in the "
5435 "package build directory for the specified package, when searching for "
5436 "libraries, symbol files, and shlibs files."
5442 "Suppose that your source package produces libfoo1, libfoo-dev, and "
5443 "libfoo-bin binary packages. libfoo-bin links against libfoo1, and should "
5444 "depend on it. In your rules file, first run B<dh_makeshlibs>, then "
5460 "This will have the effect of generating automatically a shlibs file for "
5461 "libfoo1, and using that file and the libfoo1 library in the "
5462 "F<debian/libfoo1/usr/lib> directory to calculate shared library dependency "
5469 "If a libbar1 package is also produced, that is an alternate build of libfoo, "
5470 "and is installed into F</usr/lib/bar/>, you can make libfoo-bin depend on "
5471 "libbar1 as follows:"
5478 "\tdh_shlibdeps -Llibbar1 -l/usr/lib/bar\n"
5484 msgid "L<debhelper(7)>, L<dpkg-shlibdeps(1)>"
5489 msgid "dh_strip - strip executables, shared libraries, and some static libraries"
5495 "B<dh_strip> [S<I<debhelper options>>] [B<-X>I<item>] "
5496 "[B<--dbg-package=>I<package>] [B<--keep-debug>]"
5502 "B<dh_strip> is a debhelper program that is responsible for stripping "
5503 "executables, shared libraries, and static libraries that are not used for "
5510 "This program examines your package build directories and works out what to "
5511 "strip on its own. It uses L<file(1)> and file permissions and filenames to "
5512 "figure out what files are shared libraries (F<*.so>), executable binaries, "
5513 "and static (F<lib*.a>) and debugging libraries (F<lib*_g.a>, F<debug/*.so>), "
5514 "and strips each as much as is possible. (Which is not at all for debugging "
5515 "libraries.) In general it seems to make very good guesses, and will do the "
5516 "right thing in almost all cases."
5522 "Since it is very hard to automatically guess if a file is a module, and hard "
5523 "to determine how to strip a module, B<dh_strip> does not currently deal with "
5524 "stripping binary modules such as F<.o> files."
5530 "Exclude files that contain I<item> anywhere in their filename from being "
5531 "stripped. You may use this option multiple times to build up a list of "
5532 "things to exclude."
5537 msgid "B<--dbg-package=>I<package>"
5543 "Causes B<dh_strip> to save debug symbols stripped from the packages it acts "
5544 "on as independent files in the package build directory of the specified "
5545 "debugging package."
5551 "For example, if your packages are libfoo and foo and you want to include a "
5552 "I<foo-dbg> package with debugging symbols, use B<dh_strip "
5553 "--dbg-package=>I<foo-dbg>."
5559 "Note that this option behaves significantly different in debhelper "
5560 "compatibility levels 4 and below. Instead of specifying the name of a debug "
5561 "package to put symbols in, it specifies a package (or packages) which should "
5562 "have separated debug symbols, and the separated symbols are placed in "
5563 "packages with B<-dbg> added to their name."
5568 msgid "B<-k>, B<--keep-debug>"
5574 "Debug symbols will be retained, but split into an independent file in "
5575 "F<usr/lib/debug/> in the package build directory. B<--dbg-package> is easier "
5576 "to use than this option, but this option is more flexible."
5582 "If the B<DEB_BUILD_OPTIONS> environment variable contains B<nostrip>, "
5583 "nothing will be stripped, in accordance with Debian policy (section 10.1 "
5589 msgid "Debian policy, version 3.0.1"
5593 #: dh_suidregister:5
5594 msgid "dh_suidregister - suid registration program (deprecated)"
5598 #: dh_suidregister:9 dh_undocumented:14
5603 #: dh_suidregister:13
5605 "This program used to register suid and sgid files with L<suidregister(1)>, "
5606 "but with the introduction of L<dpkg-statoverride(8)>, registration of files "
5607 "in this way is unnecessary, and even harmful, so this program is deprecated "
5608 "and should not be used."
5612 #: dh_suidregister:18
5613 msgid "CONVERTING TO STATOVERRIDE"
5617 #: dh_suidregister:20
5619 "Converting a package that uses this program to use the new statoverride "
5620 "mechanism is easy. Just remove the call to B<dh_suidregister> from "
5621 "F<debian/rules>, and add a versioned conflicts into your F<control> file, as "
5626 #: dh_suidregister:25
5629 " Conflicts: suidmanager (<< 0.50)\n"
5634 #: dh_suidregister:27
5636 "The conflicts is only necessary if your package used to register things with "
5637 "suidmanager; if it did not, you can just remove the call to this program "
5638 "from your rules file."
5643 msgid "dh_testdir - test directory before building Debian package"
5648 msgid "B<dh_testdir> [S<I<debhelper options>>] [S<I<file> ...>]"
5654 "B<dh_testdir> tries to make sure that you are in the correct directory when "
5655 "building a Debian package. It makes sure that the file F<debian/control> "
5656 "exists, as well as any other files you specify. If not, it exits with an "
5662 msgid "Test for the existence of these files too."
5667 msgid "dh_testroot - ensure that a package is built as root"
5672 msgid "B<dh_testroot> [S<I<debhelper options>>]"
5678 "B<dh_testroot> simply checks to see if you are root. If not, it exits with "
5679 "an error. Debian packages must be built as root, though you can use "
5684 #: dh_undocumented:5
5685 msgid "dh_undocumented - undocumented.7 symlink program (deprecated no-op)"
5689 #: dh_undocumented:18
5691 "This program used to make symlinks to the F<undocumented.7> man page for man "
5692 "pages not present in a package. Debian policy now frowns on use of the "
5693 "F<undocumented.7> man page, and so this program does nothing, and should not "
5699 msgid "dh_usrlocal - migrate usr/local directories to maintainer scripts"
5704 msgid "B<dh_usrlocal> [S<I<debhelper options>>] [B<-n>]"
5710 "B<dh_usrlocal> is a debhelper program that can be used for building packages "
5711 "that will provide a subdirectory in F</usr/local> when installed."
5717 "It finds subdirectories of F<usr/local> in the package build directory, and "
5718 "removes them, replacing them with maintainer script snippets (unless B<-n> "
5719 "is used) to create the directories at install time, and remove them when the "
5720 "package is removed, in a manner compliant with Debian policy. These snippets "
5721 "are inserted into the maintainer scripts by B<dh_installdeb>. See "
5722 "L<dh_installdeb(1)> for an explanation of debhelper maintainer script "
5729 "If the directories found in the build tree have unusual owners, groups, or "
5730 "permissions, then those values will be preserved in the directories made by "
5731 "the F<postinst> script. However, as a special exception, if a directory is "
5732 "owned by root.root, it will be treated as if it is owned by root.staff and "
5733 "is mode 2775. This is useful, since that is the group and mode policy "
5734 "recommends for directories in F</usr/local>."
5739 msgid "Debian policy, version 2.2"
5744 msgid "Andrew Stribblehill <ads@debian.org>"
projects / debhelper.git / blob