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: 2010-04-08 18:23-0300\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"
15 "Content-Type: text/plain; charset=CHARSET\n"
16 "Content-Transfer-Encoding: ENCODING"
19 #: 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_testversion:3 dh_undocumented:3 dh_usrlocal:3
25 msgid "debhelper - the debhelper tool suite"
29 #: debhelper.pod:5 dh:12 dh_auto_build:12 dh_auto_clean:12 dh_auto_configure:12 dh_auto_install:15 dh_auto_test:12 dh_bugfiles:12 dh_builddeb:12 dh_clean:12 dh_compress:13 dh_desktop:12 dh_fixperms:12 dh_gconf:12 dh_gencontrol:12 dh_icons:13 dh_install:13 dh_installcatalogs:14 dh_installchangelogs:12 dh_installcron:12 dh_installdeb:12 dh_installdebconf:12 dh_installdirs:12 dh_installdocs:12 dh_installemacsen:12 dh_installexamples:12 dh_installifupdown:12 dh_installinfo:12 dh_installinit:12 dh_installlogcheck:12 dh_installlogrotate:12 dh_installman:13 dh_installmanpages:13 dh_installmenu:12 dh_installmime:12 dh_installmodules:14 dh_installpam:12 dh_installppp:12 dh_installudev:13 dh_installwm:12 dh_installxfonts:12 dh_link:13 dh_lintian:12 dh_listpackages:12 dh_makeshlibs:12 dh_md5sums:13 dh_movefiles:12 dh_perl:14 dh_prep:12 dh_python:13 dh_scrollkeeper:12 dh_shlibdeps:13 dh_strip:13 dh_suidregister:7 dh_testdir:12 dh_testroot:7 dh_testversion:12 dh_undocumented:12 dh_usrlocal:15
36 "B<dh_>I<*> [B<-v>] [B<-a>] [B<-i>] [B<-s>] [B<--no-act>] [B<-ppackage>] "
37 "[B<-Npackage] [-Ptmpdir>]"
41 #: debhelper.pod:9 dh:16 dh_auto_build:16 dh_auto_clean:16 dh_auto_configure:16 dh_auto_install:19 dh_auto_test:16 dh_bugfiles:16 dh_builddeb:16 dh_clean:16 dh_compress:17 dh_desktop:16 dh_fixperms:16 dh_gconf:16 dh_gencontrol:16 dh_icons:17 dh_install:17 dh_installcatalogs:18 dh_installchangelogs:16 dh_installcron:16 dh_installdeb:16 dh_installdebconf:16 dh_installdirs:16 dh_installdocs:16 dh_installemacsen:16 dh_installexamples:16 dh_installifupdown:16 dh_installinfo:16 dh_installinit:16 dh_installlogcheck:16 dh_installlogrotate:16 dh_installman:17 dh_installmanpages:17 dh_installmenu:16 dh_installmime:16 dh_installmodules:18 dh_installpam:16 dh_installppp:16 dh_installudev:17 dh_installwm:16 dh_installxfonts:16 dh_link:17 dh_lintian:16 dh_listpackages:16 dh_makeshlibs:16 dh_md5sums:17 dh_movefiles:16 dh_perl:18 dh_prep:16 dh_python:17 dh_scrollkeeper:16 dh_shlibdeps:17 dh_strip:17 dh_suidregister:11 dh_testdir:16 dh_testroot:11 dh_testversion:16 dh_undocumented:16 dh_usrlocal:19
48 "Debhelper is used to help you build a debian package. The philosophy behind "
49 "debhelper is to provide a collection of small, simple, and easily understood "
50 "tools that are used in debian/rules to automate various common aspects of "
51 "building a package. This means less work for you, the packager. It also, to "
52 "some degree means that these tools can be changed if debian policy changes, "
53 "and packages that use them will require only a rebuild to comply with the "
60 "A typical debian/rules file that uses debhelper will call several debhelper "
61 "commands in sequence, or use L<dh(1)> to automate this process. Examples of "
62 "rules files that use debhelper are in F</usr/share/doc/debhelper/examples/>"
68 "To create a new debian package using debhelper, you can just copy one of the "
69 "sample rules files and edit it by hand. Or you can try the dh-make package, "
70 "which contains a L<dh_make|dh_make(1)> command that partially automates the "
71 "process. For a more gentle introduction, the maint-guide debian package "
72 "contains a tutorial about making your first package using debhelper."
77 msgid "DEBHELPER COMMANDS"
83 "Here is the list of debhelper commands you can use. See their man pages for "
84 "additional documentation."
94 msgid "Deprecated Commands"
99 msgid "A few debhelper commands are deprecated and should not be used."
104 msgid "#LIST_DEPRECATED#"
109 msgid "Other Commands"
115 "If a program's name starts with \"dh_\", and the program is not on the above "
116 "lists, then it is not part of the debhelper package, but it should still "
117 "work like the other programs described on this page."
122 msgid "DEBHELPER CONFIG FILES"
128 "Many debhelper commands make use of files in F<debian/> to control what they "
129 "do. Besides the common F<debian/changelog> and F<debian/control>, which are "
130 "in all packages, not just those using debhelper, some additional files can "
131 "be used to configure the behavior of specific debhelper commands. These "
132 "files are typically named debian/package.foo (where \"package\" of course, "
133 "is replaced with the package that is being acted on)."
139 "For example, dh_installdocs uses files named debian/package.docs to list the "
140 "documentation files it will install. See the man pages of individual "
141 "commands for details about the names and formats of the files they use. "
142 "Generally, these files will list files to act on, one file per line. Some "
143 "programs in debhelper use pairs of files and destinations or slightly more "
144 "complicated formats."
150 "Note that if a package is the first (or only) binary package listed in "
151 "debian/control, debhelper will use debian/foo if no debian/package.foo file "
158 "In some rare cases, you may want to have different versions of these files "
159 "for different architectures or OSes. If files named debian/package.foo.ARCH "
160 "or debian/package.foo.OS exist, where \"ARCH\" and \"OS\" are the same as "
161 "the output of \"dpkg-architecture -qDEB_HOST_ARCH\" / \"dpkg-architecture "
162 "-qDEB_HOST_ARCH_OS\", then they will be used in preference to other, more "
169 "In many cases, these config files are used to specify various types of "
170 "files. Documentation or example files to install, files to move, and so on. "
171 "When appropriate, in cases like these, you can use standard shell wildcard "
172 "characters ('?' and '*' and '[..]' character classes) in the files."
178 "You can also put comments in these files; lines beginning with \"#\" are "
184 msgid "SHARED DEBHELPER OPTIONS"
189 msgid "The following command line options are supported by all debhelper programs."
194 msgid "B<-v>, B<--verbose>"
199 msgid "Verbose mode: show all commands that modify the package build directory."
203 #: debhelper.pod:101 dh:70
210 "Do not really do anything. If used with -v, the result is that the command "
211 "will output what it would have done."
216 msgid "B<-a>, B<--arch>"
222 "Act on architecture dependent packages that should be built for the build "
228 msgid "B<-i>, B<--indep>"
233 msgid "Act on all architecture independent packages."
238 msgid "B<->I<ppackage>, B<--package=>I<package>"
244 "Act on the package named \"package\". This option may be specified multiple "
245 "times to make debhelper operate on a given set of packages."
250 msgid "B<-s>, B<--same-arch>"
256 "This used to be a smarter version of the -a flag, but the -a flag is now "
262 msgid "B<-N>I<package>, B<--no-package=>I<package>"
268 "Do not act on the specified package even if an -a, -i, or -p option lists "
269 "the package as one that should be acted on."
274 msgid "B<--remaining-packages>"
280 "Do not act on the packages which have already been acted on by this "
281 "debhelper command earlier (i.e. if the command is present in the package "
282 "debhelper log). For example, if you need to call the command with special "
283 "options only for a couple of binary packages, pass this option to the last "
284 "call of the command to process the rest of packages with default settings."
289 msgid "B<--ignore=>I<file>"
295 "Ignore the specified file. This can be used if debian/ contains a debhelper "
296 "config file that a debhelper command should not act on. Note that "
297 "debian/compat, debian/control, and debian/changelog can't be ignored, but "
298 "then, there should never be a reason to ignore those files."
304 "For example, if upstream ships a debian/init that you don't want "
305 "dh_installinit to install, use --ignore=debian/init"
310 msgid "B<-P>I<tmpdir>, B<--tmpdir=>I<tmpdir>"
315 msgid "Use \"tmpdir\" for package build directory. The default is debian/<package>"
320 msgid "B<--mainpackage=>I<package>"
326 "This little-used option changes the package which debhelper considers the "
327 "\"main package\", that is, the first one listed in debian/control, and the "
328 "one for which debian/foo files can be used instead of the usual "
329 "debian/package.foo files."
334 msgid "B<-O=>I<option|bundle>"
340 "This is used by L<dh(1)> when passing user-specified options to all the "
341 "commands it runs. If the command supports the specified option or option "
342 "bundle, it will take effect. If the command does not support the option (or "
343 "any part of an option bundle), it will be ignored."
348 msgid "COMMON DEBHELPER OPTIONS"
354 "The following command line options are supported by some debhelper "
355 "programs. See the man page of each program for a complete explanation of "
356 "what each option does."
366 msgid "Do not modify postinst/postrm/etc scripts."
370 #: debhelper.pod:180 dh_compress:50 dh_makeshlibs:76 dh_md5sums:37 dh_shlibdeps:30 dh_strip:39
371 msgid "B<-X>I<item>, B<--exclude=>I<item>"
377 "Exclude an item from processing. This option may be used multiple times, to "
378 "exclude more than one thing."
382 #: debhelper.pod:185 dh_bugfiles:54 dh_compress:58 dh_installdirs:35 dh_installdocs:64 dh_installexamples:36 dh_installinfo:35 dh_installman:64 dh_link:55
383 msgid "B<-A>, B<--all>"
389 "Makes files or other items that are specified on the command line take "
390 "effect in ALL packages acted on, not just the first."
395 msgid "BUILD SYSTEM OPTIONS"
401 "The following command line options are supported by all of the dh_auto_* "
402 "debhelper programs. These programs support a variety of build systems, and "
403 "normally heuristically determine which to use, and how to use them. You can "
404 "use these command line options to override the default behavior."
409 msgid "B<-S>I<buildsystem>, B<--buildsystem=>I<buildsystem>"
415 "Force use of the specified I<buildsystem>, instead of trying to auto-select "
416 "one which might be applicable for the package."
421 msgid "B<-D>I<directory>, B<--sourcedirectory=>I<directory>"
427 "Assume that the original package source tree is at the specified "
428 "I<directory> rather than the top level directory of the Debian source "
434 msgid "B<-B>[I<directory>], B<--builddirectory>=[I<directory>]"
440 "Enable out of source building and use the specified I<directory> as the "
441 "build directory. If I<directory> parameter is omitted, a default build "
442 "directory will chosen."
448 "If this option is not specified, building will be done in source by default "
449 "unless the build system requires or prefers out of source tree building. In "
450 "such a case, the default build directory will be used even if "
451 "L<--builddirectory> is not specified."
457 "If the build system prefers out of source tree building but still allows in "
458 "source building, the latter can be re-enabled by passing a build directory "
459 "path that is the same as the source directory path."
464 msgid "B<--parallel>"
470 "Enable parallel builds if underlying build system supports them. The number "
471 "of parallel jobs is controlled by the DEB_BUILD_OPTIONS environment variable "
472 "(L<Debian Policy, section 4.9.1>) at build time. It might also be subject to "
473 "a build system specific limit."
479 "If this option is not specified, debhelper currently defaults to not "
480 "allowing parallel package builds."
485 msgid "B<--max-parallel>I<=maximum>"
491 "This option implies L<--parallel> and allows further limiting the number of "
492 "jobs that can be used in a parallel build. If the package build is known to "
493 "only work with certain levels of concurrency, you can set this to the "
494 "maximum level that is known to work, or that you wish to support."
498 #: debhelper.pod:244 dh:50
499 msgid "B<--list>, B<-l>"
505 "List all build systems supported by debhelper on this system. The list "
506 "includes both default and third party build systems (marked as such). Also "
507 "shows which build system would be automatically selected, or which one is "
508 "manually specified with the I<--buildsystem> option."
512 #: debhelper.pod:253 dh_auto_test:44 dh_installcatalogs:59 dh_installdocs:110 dh_installemacsen:67 dh_installexamples:53 dh_installinit:133 dh_installman:81 dh_installmime:51 dh_installmodules:60 dh_installudev:55 dh_installwm:54 dh_installxfonts:37 dh_movefiles:64 dh_strip:68 dh_usrlocal:49
518 msgid "Multiple binary package support"
524 "If your source package generates more than one binary package, debhelper "
525 "programs will default to acting on all binary packages when run. If your "
526 "source package happens to generate one architecture dependent package, and "
527 "another architecture independent package, this is not the correct behavior, "
528 "because you need to generate the architecture dependent packages in the "
529 "binary-arch debian/rules target, and the architecture independent packages "
530 "in the binary-indep debian/rules target."
536 "To facilitate this, as well as give you more control over which packages are "
537 "acted on by debhelper programs, all debhelper programs accept the B<-a>, "
538 "B<-i>, B<-p>, and B<-s> parameters. These parameters are cumulative. If "
539 "none are given, debhelper programs default to acting on all packages listed "
540 "in the control file."
545 msgid "Automatic generation of debian install scripts"
551 "Some debhelper commands will automatically generate parts of debian "
552 "maintainer scripts. If you want these automatically generated things "
553 "included in your existing debian maintainer scripts, then you need to add "
554 "\"#DEBHELPER#\" to your scripts, in the place the code should be added. "
555 "\"#DEBHELPER#\" will be replaced by any auto-generated code when you run "
562 "If a script does not exist at all and debhelper needs to add something to "
563 "it, then debhelper will create the complete script."
569 "All debhelper commands that automatically generate code in this way let it "
570 "be disabled by the -n parameter (see above)."
576 "Note that the inserted code will be shell code, so you cannot directly use "
577 "it in a perl script. If you would like to embed it into a perl script, here "
578 "is one way to do that (note that I made sure that $1, $2, etc are set with "
586 " my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n"
589 " system ($temp) / 256 == 0\n"
590 " \tor die \"Problem with debhelper scripts: $!\";\n"
596 msgid "Automatic generation of miscellaneous dependencies."
602 "Some debhelper commands may make the generated package need to depend on "
603 "some other packages. For example, if you use L<dh_installdebconf(1)>, your "
604 "package will generally need to depend on debconf. Or if you use "
605 "L<dh_installxfonts(1)>, your package will generally need to depend on a "
606 "particular version of xutils. Keeping track of these miscellaneous "
607 "dependencies can be annoying since they are dependant on how debhelper does "
608 "things, so debhelper offers a way to automate it."
614 "All commands of this type, besides documenting what dependencies may be "
615 "needed on their man pages, will automatically generate a substvar called "
616 "${misc:Depends}. If you put that token into your debian/control file, it "
617 "will be expanded to the dependencies debhelper figures you need."
623 "This is entirely independent of the standard ${shlibs:Depends} generated by "
624 "L<dh_makeshlibs(1)>, and the ${perl:Depends} generated by L<dh_perl(1)>. "
625 "You can choose not to use any of these, if debhelper's guesses don't match "
631 msgid "Package build directories"
637 "By default, all debhelper programs assume that the temporary directory used "
638 "for assembling the tree of files in a package is debian/<package>."
644 "Sometimes, you might want to use some other temporary directory. This is "
645 "supported by the -P flag. For example, \"dh_installdocs -Pdebian/tmp\", will "
646 "use debian/tmp as the temporary directory. Note that if you use -P, the "
647 "debhelper programs can only be acting on a single package at a time. So if "
648 "you have a package that builds many binary packages, you will need to also "
649 "use the -p flag to specify which binary package the debhelper program will "
655 msgid "Debhelper compatibility levels"
661 "From time to time, major non-backwards-compatible changes need to be made to "
662 "debhelper, to keep it clean and well-designed as needs change and its author "
663 "gains more experience. To prevent such major changes from breaking existing "
664 "packages, the concept of debhelper compatibility levels was introduced. You "
665 "tell debhelper which compatibility level it should use, and it modifies its "
666 "behavior in various ways."
672 "Tell debhelper what compatibility level to use by writing a number to "
673 "debian/compat. For example, to turn on V7 mode:"
680 " % echo 7 > debian/compat\n"
687 "Unless otherwise indicated, all debhelper documentation assumes that you are "
688 "using the most recent compatibility level, and in most cases does not "
689 "indicate if the behavior is different in an earlier compatibility level, so "
690 "if you are not using the most recent compatibility level, you're advised to "
691 "read below for notes about what is different in earlier compatibility "
697 msgid "These are the available compatibility levels:"
708 "This is the original debhelper compatibility level, and so it is the default "
709 "one. In this mode, debhelper will use debian/tmp as the package tree "
710 "directory for the first binary package listed in the control file, while "
711 "using debian/<package> for all other packages listed in the control file."
715 #: debhelper.pod:362 debhelper.pod:369 debhelper.pod:392 debhelper.pod:421
716 msgid "This mode is deprecated."
727 "In this mode, debhelper will consistently use debian/<package> as the "
728 "package tree directory for every package that is built."
738 msgid "This mode works like V2, with the following additions:"
742 #: debhelper.pod:377 debhelper.pod:382 debhelper.pod:386 debhelper.pod:400 debhelper.pod:405 debhelper.pod:410 debhelper.pod:415 debhelper.pod:429 debhelper.pod:433 debhelper.pod:438 debhelper.pod:442 debhelper.pod:454 debhelper.pod:459 debhelper.pod:465 debhelper.pod:471 debhelper.pod:486 debhelper.pod:493 debhelper.pod:497 debhelper.pod:501
749 "Debhelper config files support globbing via * and ?, when appropriate. To "
750 "turn this off and use those characters raw, just prefix with a backslash."
755 msgid "dh_makeshlibs makes the postinst and postrm scripts call ldconfig."
760 msgid "Every file in etc/ is automatically flagged as a conffile by dh_installdeb."
770 msgid "Changes from V3 are:"
776 "dh_makeshlibs -V will not include the debian part of the version number in "
777 "the generated dependency line in the shlibs file."
783 "You are encouraged to put the new ${misc:Depends} into debian/control to "
784 "supplement the ${shlibs:Depends} field."
790 "dh_fixperms will make all files in bin/ directories and in etc/init.d "
796 msgid "dh_link will correct existing links to conform with policy."
806 msgid "Changes from V4 are:"
811 msgid "Comments are ignored in debhelper config files."
817 "dh_strip --dbg-package now specifies the name of a package to put debugging "
818 "symbols in, not the packages to take the symbols from."
823 msgid "dh_installdocs skips installing empty files."
828 msgid "dh_install errors out if wildcards expand to nothing."
838 msgid "Changes from V5 are:"
844 "Commands that generate maintainer script fragments will order the fragments "
845 "in reverse order for the prerm and postrm scripts."
851 "dh_installwm will install a slave manpage link for x-window-manager.1.gz, if "
852 "it sees the man page in usr/share/man/man1 in the package build directory."
858 "dh_builddeb did not previously delete everything matching DH_ALWAYS_EXCLUDE, "
859 "if it was set to a list of things to exclude, such as \"CVS:.svn:.git\". Now "
866 "dh_installman allows overwriting existing man pages in the package build "
867 "directory. In previous compatibility levels it silently refuses to do this."
877 msgid "This is the recommended mode of operation."
882 msgid "Changes from V6 are:"
888 "dh_install, will fall back to looking for files in debian/tmp if it doesn't "
889 "find them in the current directory (or wherever you tell it look using "
890 "--sourcedir). This allows dh_install to interoperate with dh_auto_install, "
891 "which installs to debian/tmp, without needing any special parameters."
896 msgid "dh_clean will read debian/clean and delete files listed there."
901 msgid "dh_clean will delete toplevel *-stamp files."
907 "dh_installchangelogs will guess at what file is the upstream changelog if "
919 "Debhelper includes support for udebs. To create a udeb with debhelper, add "
920 "\"XC-Package-Type: udeb\" to the package's stanza in debian/control, and "
921 "build-depend on debhelper (>= 4.2). Debhelper will try to create udebs that "
922 "comply with debian-installer policy, by making the generated package files "
923 "end in \".udeb\", not installing any documentation into a udeb, skipping "
924 "over preinst, postrm, prerm, and config scripts, etc."
935 "In general, if any debhelper program needs a directory to exist under "
936 "debian/, it will create it. I haven't bothered to document this in all the "
937 "man pages, but for example, dh_installdeb knows to make "
938 "debian/<package>/DEBIAN/ before trying to put files there, dh_installmenu "
939 "knows you need a debian/<package>/usr/share/menu/ before installing the menu "
946 "Once your package uses debhelper to build, be sure to add debhelper to your "
947 "Build-Depends line in debian/control. You should build-depend on a version "
948 "of debhelper equal to (or greater than) the debhelper compatibility level "
949 "your package uses. So if your package used compatibility level 7:"
956 " Build-Depends: debhelper (>= 7)\n"
973 "Set to 1 to enable verbose mode. Debhelper will output every command it runs "
974 "that modifies files on the build system."
985 "Temporarily specifies what compatibility level debhelper should run at, "
986 "overriding any value in debian/compat."
996 msgid "Set to 1 to enable no-act mode."
1000 #: debhelper.pod:553
1005 #: debhelper.pod:555
1007 "Anything in this variable will be prepended to the command line arguments of "
1008 "all debhelper commands. Command-specific options will be ignored by commands "
1009 "that do not support them."
1013 #: debhelper.pod:559
1015 "This is useful in some situations, for example, if you need to pass -p to "
1016 "all debhelper commands that will be run. One good way to set DH_OPTIONS is "
1017 "by using \"Target-specific Variable Values\" in your debian/rules file. See "
1018 "the make documentation for details on doing this."
1022 #: debhelper.pod:564
1023 msgid "DH_ALWAYS_EXCLUDE"
1027 #: debhelper.pod:566
1029 "If set, this adds the value the variable is set to to the -X options of all "
1030 "commands that support the -X option. Moreover, dh_builddeb will rm -rf "
1031 "anything that matches the value in your package build tree."
1035 #: debhelper.pod:570
1037 "This can be useful if you are doing a build from a CVS source tree, in which "
1038 "case setting DH_ALWAYS_EXCLUDE=CVS will prevent any CVS directories from "
1039 "sneaking into the package you build. Or, if a package has a source tarball "
1040 "that (unwisely) includes CVS directories, you might want to export "
1041 "DH_ALWAYS_EXCLUDE=CVS in debian/rules, to make it take effect wherever your "
1046 #: debhelper.pod:577
1048 "Multiple things to exclude can be separated with colons, as in "
1049 "DH_ALWAYS_EXCLUDE=CVS:.svn"
1053 #: debhelper.pod:582 dh:726 dh_auto_build:47 dh_auto_clean:48 dh_auto_configure:53 dh_auto_install:85 dh_auto_test:58 dh_bugfiles:122 dh_builddeb:91 dh_clean:138 dh_compress:202 dh_desktop:31 dh_fixperms:122 dh_gconf:110 dh_gencontrol:82 dh_icons:65 dh_install:279 dh_installcatalogs:116 dh_installchangelogs:169 dh_installcron:77 dh_installdeb:108 dh_installdebconf:126 dh_installdirs:86 dh_installdocs:301 dh_installemacsen:124 dh_installexamples:106 dh_installifupdown:69 dh_installinfo:77 dh_installinit:275 dh_installlogcheck:66 dh_installlogrotate:50 dh_installman:253 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:29 dh_makeshlibs:237 dh_md5sums:90 dh_movefiles:170 dh_perl:145 dh_prep:60 dh_python:280 dh_scrollkeeper:28 dh_shlibdeps:171 dh_strip:227 dh_suidregister:117 dh_testdir:44 dh_testroot:27 dh_testversion:75 dh_undocumented:28 dh_usrlocal:114
1058 #: debhelper.pod:586
1059 msgid "F</usr/share/doc/debhelper/examples/>"
1063 #: debhelper.pod:588
1064 msgid "A set of example debian/rules files that use debhelper."
1068 #: debhelper.pod:590
1069 msgid "L<http://kitenet.net/~joey/code/debhelper/>"
1073 #: debhelper.pod:592
1074 msgid "Debhelper web site."
1078 #: debhelper.pod:596 dh:732 dh_auto_build:53 dh_auto_clean:54 dh_auto_configure:59 dh_auto_install:91 dh_auto_test:64 dh_bugfiles:130 dh_builddeb:97 dh_clean:144 dh_compress:208 dh_desktop:37 dh_fixperms:128 dh_gconf:116 dh_gencontrol:88 dh_icons:71 dh_install:285 dh_installcatalogs:122 dh_installchangelogs:175 dh_installcron:83 dh_installdeb:114 dh_installdebconf:132 dh_installdirs:92 dh_installdocs:307 dh_installemacsen:130 dh_installexamples:112 dh_installifupdown:75 dh_installinfo:83 dh_installlogcheck:72 dh_installlogrotate:56 dh_installman:259 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:35 dh_makeshlibs:243 dh_md5sums:96 dh_movefiles:176 dh_perl:151 dh_prep:66 dh_python:286 dh_scrollkeeper:34 dh_shlibdeps:177 dh_strip:233 dh_suidregister:123 dh_testdir:50 dh_testroot:33 dh_testversion:81 dh_undocumented:34 dh_usrlocal:120
1083 #: debhelper.pod:598 dh:734 dh_auto_build:55 dh_auto_clean:56 dh_auto_configure:61 dh_auto_install:93 dh_auto_test:66 dh_builddeb:99 dh_clean:146 dh_compress:210 dh_fixperms:130 dh_gencontrol:90 dh_install:287 dh_installchangelogs:177 dh_installcron:85 dh_installdeb:116 dh_installdebconf:134 dh_installdirs:94 dh_installdocs:309 dh_installemacsen:132 dh_installexamples:114 dh_installifupdown:77 dh_installinfo:85 dh_installinit:283 dh_installlogrotate:58 dh_installman:261 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:37 dh_makeshlibs:245 dh_md5sums:98 dh_movefiles:178 dh_prep:68 dh_shlibdeps:179 dh_strip:235 dh_suidregister:125 dh_testdir:52 dh_testroot:35 dh_testversion:83 dh_undocumented:36
1084 msgid "Joey Hess <joeyh@debian.org>"
1089 msgid "dh - debhelper command sequencer"
1095 "B<dh> sequence [B<--with> I<addon>[,I<addon>,...]] [B<--list>] [B<--until> "
1096 "I<cmd>] [B<--before> I<cmd>] [B<--after> I<cmd>] [B<--remaining>] "
1097 "[S<I<debhelper options>>]"
1103 "dh runs a sequence of debhelper commands. The supported sequences correspond "
1104 "to the targets of a debian/rules file: \"build\", \"clean\", \"install\", "
1105 "\"binary-arch\", \"binary-indep\", and \"binary\"."
1111 "Commands in the binary-indep sequence are passed the \"-i\" option to ensure "
1112 "they only work on binary independent packages, and commands in the "
1113 "binary-arch sequences are passed the \"-a\" option to ensure they only work "
1114 "on architecture dependent packages."
1120 "If debian/rules contains a target with a name like "
1121 "\"override_I<dh_command>\", then when it would normally run I<dh_command>, "
1122 "dh will instead call that target. The override target can then run the "
1123 "command with additional options, or run entirely different commands "
1124 "instead. See examples below. (Note that to use this feature, you should "
1125 "Build-Depend on debhelper 7.0.50 or above.)"
1129 #: dh:33 dh_auto_build:28 dh_auto_clean:29 dh_auto_configure:31 dh_auto_install:43 dh_auto_test:30 dh_bugfiles:50 dh_builddeb:21 dh_clean:41 dh_compress:46 dh_fixperms:31 dh_gconf:45 dh_gencontrol:26 dh_icons:25 dh_install:54 dh_installcatalogs:49 dh_installchangelogs:56 dh_installcron:40 dh_installdebconf:61 dh_installdirs:31 dh_installdocs:60 dh_installemacsen:48 dh_installexamples:32 dh_installifupdown:39 dh_installinfo:31 dh_installinit:48 dh_installlogrotate:22 dh_installman:60 dh_installmanpages:40 dh_installmenu:41 dh_installmime:41 dh_installmodules:44 dh_installpam:31 dh_installppp:35 dh_installudev:35 dh_installwm:34 dh_link:51 dh_makeshlibs:38 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_testversion:34 dh_usrlocal:39
1135 msgid "B<--with> I<addon>[,I<addon>,...]"
1141 "Add the debhelper commands specified by the given addon to appropriate "
1142 "places in the sequence of commands that is run. This option can be repeated "
1143 "more than once, or multiple addons can be listed, separated by commas. This "
1144 "is used when there is a third-party package that provides debhelper "
1145 "commands. See the PROGRAMMING file for documentation about the sequence "
1151 msgid "B<--without> I<addon>"
1156 msgid "The inverse of --with, disables using the given addon."
1161 msgid "List all available addons."
1166 msgid "B<--until> I<cmd>"
1171 msgid "Run commands in the sequence until and including I<cmd>, then stop."
1176 msgid "B<--before> I<cmd>"
1181 msgid "Run commands in the sequence before I<cmd>, then stop."
1186 msgid "B<--after> I<cmd>"
1191 msgid "Run commands in the sequence that come after I<cmd>."
1196 msgid "B<--remaining>"
1201 msgid "Run all commands in the sequence that have yet to be run."
1206 msgid "Prints commands that would run for a given sequence, but does not run them."
1212 "All other options passed to dh are passed on to each command it runs. This "
1213 "can be used to set an option like \"-v\" or \"-X\" or \"-N\", as well as for "
1214 "more specialised options."
1220 "In the above options, I<cmd> can be a full name of a debhelper command, or a "
1221 "substring. It'll first search for a command in the sequence exactly matching "
1222 "the name, to avoid any ambiguity. If there are multiple substring matches, "
1223 "the last one in the sequence will be used."
1227 #: dh:111 dh_installdocs:99 dh_link:73 dh_makeshlibs:92 dh_shlibdeps:69
1234 "To see what commands are included in a sequence, without actually doing "
1242 "\tdh binary-arch --no-act\n"
1249 "This is a very simple rules file, for packages where the default sequences "
1250 "of commands work with no additional options."
1254 #: dh:121 dh:128 dh:142 dh:155
1257 "\t#!/usr/bin/make -f\n"
1267 "Often you'll want to pass an option to a specific debhelper command. The\n"
1268 "easy way to do with is by adding an override target for that command.\n"
1276 "\toverride_dh_strip:\n"
1277 "\t\tdh_strip -Xfoo\n"
1285 "\toverride_dh_installdocs:\n"
1286 "\t\tdh_installdocs README TODO\n"
1293 "Sometimes the automated L<dh_auto_configure(1)> and L<dh_auto_build(1)> "
1294 "can't guess what to do for a strange package. Here's how to avoid running "
1295 "either and instead run your own commands."
1302 "\toverride_dh_auto_configure:\n"
1303 "\t\t./mondoconfig\n"
1311 "\toverride_dh_auto_build:\n"
1312 "\t\tmake universe-explode-in-delight\n"
1319 "Another common case is wanting to do something manually before or after a "
1320 "particular debhelper command is run."
1327 "\toverride_dh_fixperms:\n"
1329 "\t\tchmod 4755 debian/foo/usr/bin/foo\n"
1336 "If your package is a python package, dh will use dh_pysupport by "
1337 "default. This is how to use dh_pycentral instead."
1344 "\t#!/usr/bin/make -f\n"
1346 "\t\tdh $@ --with python-central\n"
1353 "Here is how to force use of perl's Module::Build build system, which can be "
1354 "necessary if debhelper wrongly detects that the package uses MakeMaker."
1361 "\t#!/usr/bin/make -f\n"
1363 "\t\tdh $@ --buildsystem=perl_build\n"
1371 "To patch your package using quilt, you can tell dh to use quilt's dh\n"
1372 "sequence addons like this:\n"
1380 "\t#!/usr/bin/make -f\n"
1382 "\t\tdh $@ --with quilt\n"
1389 "Here is an example of overriding where the dh_auto_* commands find the "
1390 "package's source, for a package where the source is located in a "
1398 "\t#!/usr/bin/make -f\n"
1400 "\t\tdh $@ --sourcedirectory=src\n"
1407 "And here is an example of how to tell the dh_auto_* commands to build in a "
1408 "subdirectory, which will be removed on clean."
1415 "\t#!/usr/bin/make -f\n"
1417 "\t\tdh $@ --builddirectory=build\n"
1424 "If your package can be built in parallel, you can support parallel building "
1425 "as follows. Then I<dpkg-buildpackage -j> will work."
1432 "\t#!/usr/bin/make -f\n"
1434 "\t\tdh $@ --parallel\n"
1441 "Here is a way to prevent dh from running several commands that you don't "
1442 "want it to run, by defining empty override targets for each command."
1446 #: dh:210 dh:221 dh:238
1449 "\t#!/usr/bin/make -f\n"
1459 "\t# Commands not to run:\n"
1460 "\toverride_dh_auto_test override_dh_compress override_dh_fixperms:\n"
1467 "Sometimes, you may need to make an override target only run commands when a "
1468 "particular package is being built. This can be accomplished using "
1469 "L<dh_listpackages(1)> to test what is being built. For example:"
1476 "\toverride_dh_fixperms:\n"
1478 "\tifneq (,$(findstring foo, $(shell dh_listpackages)))\n"
1479 "\t\tchmod 4755 debian/foo/usr/bin/foo\n"
1487 "Finally, remember that you are not limited to using override targets in the "
1488 "rules file when using dh. You can also explicitly define any of the regular "
1489 "rules file targets when it makes sense to do so. A common reason to do this "
1490 "is if your package needs different build-arch and build-indep targets. For "
1491 "example, a package with a long document build process can put it in "
1492 "build-indep to avoid build daemons redundantly building the documentation."
1499 "\tbuild: build-arch build-indep ;\n"
1501 "\t\t$(MAKE) docs\n"
1503 "\t\t$(MAKE) bins\n"
1514 msgid "If you're curious about dh's internals, here's how it works under the hood."
1520 "Each debhelper command will record when it's successfully run in "
1521 "debian/package.debhelper.log. (Which dh_clean deletes.) So dh can tell which "
1522 "commands have already been run, for which packages, and skip running those "
1529 "Each time dh is run, it examines the log, and finds the last logged command "
1530 "that is in the specified sequence. It then continues with the next command "
1531 "in the sequence. The B<--until>, B<--before>, B<--after>, and B<--remaining> "
1532 "options can override this behavior."
1538 "dh uses the DH_INTERNAL_OPTIONS environment variable to pass information "
1539 "through to debhelper commands that are run inside override targets. The "
1540 "contents (and indeed, existence) of this environment variable, as the name "
1541 "might suggest, is subject to change at any time."
1545 #: dh:728 dh_auto_build:49 dh_auto_clean:50 dh_auto_configure:55 dh_auto_install:87 dh_auto_test:60 dh_builddeb:93 dh_clean:140 dh_compress:204 dh_fixperms:124 dh_gconf:112 dh_gencontrol:84 dh_install:281 dh_installcatalogs:118 dh_installchangelogs:171 dh_installcron:79 dh_installdeb:110 dh_installdebconf:128 dh_installdirs:88 dh_installdocs:303 dh_installemacsen:126 dh_installexamples:108 dh_installifupdown:71 dh_installinfo:79 dh_installinit:277 dh_installlogcheck:68 dh_installlogrotate:52 dh_installman:255 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:31 dh_makeshlibs:239 dh_md5sums:92 dh_movefiles:172 dh_perl:147 dh_prep:62 dh_python:282 dh_strip:229 dh_suidregister:119 dh_testdir:46 dh_testroot:29 dh_testversion:77 dh_undocumented:30 dh_usrlocal:116
1546 msgid "L<debhelper(7)>"
1550 #: dh:730 dh_auto_build:51 dh_auto_clean:52 dh_auto_configure:57 dh_auto_install:89 dh_auto_test:62 dh_bugfiles:128 dh_builddeb:95 dh_clean:142 dh_compress:206 dh_desktop:35 dh_fixperms:126 dh_gconf:114 dh_gencontrol:86 dh_icons:69 dh_install:283 dh_installchangelogs:173 dh_installcron:81 dh_installdeb:112 dh_installdebconf:130 dh_installdirs:90 dh_installdocs:305 dh_installemacsen:128 dh_installexamples:110 dh_installifupdown:73 dh_installinfo:81 dh_installinit:279 dh_installlogrotate:54 dh_installman:257 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:33 dh_makeshlibs:241 dh_md5sums:94 dh_movefiles:174 dh_perl:149 dh_prep:64 dh_python:284 dh_scrollkeeper:32 dh_shlibdeps:175 dh_strip:231 dh_suidregister:121 dh_testdir:48 dh_testroot:31 dh_testversion:79 dh_undocumented:32 dh_usrlocal:118
1551 msgid "This program is a part of debhelper."
1556 msgid "dh_auto_build - automatically builds a package"
1562 "B<dh_auto_build> [S<I<build system options>>] [S<I<debhelper options>>] "
1563 "[S<B<--> I<params>>]"
1569 "dh_auto_build is a debhelper program that tries to automatically build a "
1570 "package. It does so by running the appropriate command for the build system "
1571 "it detects the package uses. For example, if a Makefile is found, this is "
1572 "done by running make (or MAKE, if the environment variable is set). If "
1573 "there's a setup.py, or Build.PL, it is run to build the package."
1579 "This is intended to work for about 90% of packages. If it doesn't work, "
1580 "you're encouraged to skip using dh_auto_build at all, and just run the build "
1585 #: dh_auto_build:30 dh_auto_clean:31 dh_auto_configure:33 dh_auto_install:45 dh_auto_test:32
1587 "See L<debhelper(7)/BUILD SYSTEM OPTIONS> for a list of common build system "
1588 "selection and control options."
1592 #: dh_auto_build:35 dh_auto_clean:36 dh_auto_configure:38 dh_auto_install:56 dh_auto_test:37 dh_builddeb:35 dh_gencontrol:30 dh_installdebconf:69 dh_installinit:99 dh_makeshlibs:86 dh_shlibdeps:37
1593 msgid "B<--> I<params>"
1599 "Pass \"params\" to the program that is run. These can be used to supplement "
1600 "or override any standard parameters that dh_auto_build passes."
1605 msgid "dh_auto_clean - automatically cleans up after a build"
1611 "B<dh_auto_clean> [S<I<build system options>>] [S<I<debhelper options>>] "
1612 "[S<B<--> I<params>>]"
1618 "dh_auto_clean is a debhelper program that tries to automatically clean up "
1619 "after a package build. It does so by running the appropriate command for the "
1620 "build system it detects the package uses. For example, if there's a Makefile "
1621 "and it contains a \"distclean\", \"realclean\", or \"clean\" target, then "
1622 "this is done by running make (or MAKE, if the environment variable is "
1623 "set). If there is a setup.py or Build.PL, it is run to clean the package."
1629 "This is intended to work for about 90% of packages. If it doesn't work, or "
1630 "tries to use the wrong clean target, you're encouraged to skip using "
1631 "dh_auto_clean at all, and just run make clean manually."
1637 "Pass \"params\" to the program that is run. These can be used to supplement "
1638 "or override the any standard parameters that dh_auto_clean passes."
1642 #: dh_auto_configure:5
1643 msgid "dh_auto_configure - automatically configure a package prior to building"
1647 #: dh_auto_configure:14
1649 "B<dh_auto_configure> [S<I<build system options>>] [S<I<debhelper options>>] "
1650 "[S<B<--> I<params>>]"
1654 #: dh_auto_configure:18
1656 "dh_auto_configure is a debhelper program that tries to automatically "
1657 "configure a package prior to building. It does so by running the appropriate "
1658 "command for the build system it detects the package uses. For example, it "
1659 "looks for and runs a ./configure script, Makefile.PL, Build.PL, or cmake. A "
1660 "standard set of parameters is determined and passed to the program that is "
1661 "run. Some build systems, such as make, do not need a configure step; for "
1662 "these dh_auto_configure will exit without doing anything."
1666 #: dh_auto_configure:27
1668 "This is intended to work for about 90% of packages. If it doesn't work, "
1669 "you're encouraged to skip using dh_auto_configure at all, and just run "
1670 "./configure or its equivalent manually."
1674 #: dh_auto_configure:40
1676 "Pass \"params\" to the program that is run, after the standard parameters "
1677 "that dh_auto_configure passes. This can be used to supplement or override "
1678 "those parameters. For example:"
1682 #: dh_auto_configure:44
1685 " dh_auto_configure -- --with-foo --enable-bar\n"
1690 #: dh_auto_install:5
1691 msgid "dh_auto_install - automatically runs make install or similar"
1695 #: dh_auto_install:17
1697 "B<dh_auto_install> [S<I<build system options>>] [S<I<debhelper options>>] "
1698 "[S<B<--> I<params>>]"
1702 #: dh_auto_install:21
1704 "dh_auto_install is a debhelper program that tries to automatically install "
1705 "built files. It does so by running the appropriate command for the build "
1706 "system it detects the package uses. For example, if there's a Makefile and "
1707 "it contains a \"install\" target, then this is done by running make (or "
1708 "MAKE, if the environment variable is set). If there is a setup.py or "
1709 "Build.PL, it is used. Note that the Ant build system does not support "
1710 "installation, so dh_auto_install will not install files built using Ant."
1714 #: dh_auto_install:29
1716 "Unless --destdir option is specified, the files are installed into "
1717 "debian/<package>/ if there is only one binary package. In the multiple "
1718 "binary package case, the files are instead installed into debian/tmp/, and "
1719 "should be moved from there to the appropriate package build directory using "
1724 #: dh_auto_install:35
1726 "DESTDIR is used to tell make where to install the files. If the Makefile "
1727 "was generated by MakeMaker from a Makefile.PL, it will automatically set "
1728 "PREFIX=/usr too, since such Makefiles need that."
1732 #: dh_auto_install:39
1734 "This is intended to work for about 90% of packages. If it doesn't work, or "
1735 "tries to use the wrong install target, you're encouraged to skip using "
1736 "dh_auto_install at all, and just run make install manually."
1740 #: dh_auto_install:50 dh_builddeb:25
1741 msgid "B<--destdir=>I<directory>"
1745 #: dh_auto_install:52
1747 "Install files into the specified I<directory>. If this option is not "
1748 "specified, destination directory is determined automatically as described in "
1749 "the L</DESCRIPTION> section."
1753 #: dh_auto_install:58
1755 "Pass \"params\" to the program that is run. These can be used to supplement "
1756 "or override the any standard parameters that dh_auto_install passes."
1761 msgid "dh_auto_test - automatically runs a package's test suites"
1767 "B<dh_auto_test> [S<I<build system options>>] [S<I<debhelper options>>] "
1768 "[S<B<--> I<params>>]"
1774 "dh_auto_test is a debhelper program that tries to automatically run a "
1775 "package's test suite. It does so by running the appropriate command for the "
1776 "build system it detects the package uses. For example, if there's a Makefile "
1777 "and it contains a \"test\" or \"check\" target, then this is done by running "
1778 "make (or MAKE, if the environment variable is set). If the test suite fails, "
1779 "the command will exit nonzero. If there's no test suite, it will exit zero "
1780 "without doing anything."
1786 "This is intended to work for about 90% of packages with a test suite. If it "
1787 "doesn't work, you're encouraged to skip using dh_auto_test at all, and just "
1788 "run the test suite manually."
1794 "Pass \"params\" to the program that is run. These can be used to supplement "
1795 "or override the any standard parameters that dh_auto_test passes."
1801 "If the DEB_BUILD_OPTIONS environment variable contains \"nocheck\", no tests "
1802 "will be performed."
1808 "dh_bugfiles - install bug reporting customization files into package build "
1814 msgid "B<dh_bugfiles> [B<-A>] [S<I<debhelper options>>]"
1820 "dh_bugfiles is a debhelper program that is responsible for installing bug "
1821 "reporting customization files (bug scripts and/or bug control files and/or "
1822 "presubj files) into package build directories."
1826 #: dh_bugfiles:22 dh_clean:31 dh_compress:31 dh_gconf:27 dh_install:38 dh_installcatalogs:35 dh_installchangelogs:32 dh_installcron:21 dh_installdeb:22 dh_installdebconf:34 dh_installdirs:21 dh_installdocs:21 dh_installemacsen:27 dh_installexamples:22 dh_installifupdown:22 dh_installinfo:21 dh_installinit:27 dh_installlogcheck:21 dh_installman:50 dh_installmenu:25 dh_installmime:25 dh_installmodules:29 dh_installpam:21 dh_installppp:21 dh_installudev:25 dh_installwm:24 dh_link:39 dh_lintian:21 dh_makeshlibs:24 dh_movefiles:26
1832 msgid "debian/I<package>.bug-script"
1838 "This is the script to be run by the bug reporting program for generating a "
1839 "bug report template. This file is installed as F<usr/share/bug/package> in "
1840 "the package build directory if no other types of bug reporting customization "
1841 "files are going to be installed for the package in question. Otherwise, this "
1842 "file is installed as F<usr/share/bug/package/script>. Finally, the installed "
1843 "script is given execute permissions."
1848 msgid "debian/I<package>.bug-control"
1854 "It is the bug control file containing some directions for the bug reporting "
1855 "tool. This file is installed as F<usr/share/bug/package/control> in the "
1856 "package build directory."
1861 msgid "debian/I<package>.bug-presubj"
1867 "The contents of this file are displayed to the user by the bug reporting "
1868 "tool before allowing the user to write a bug report on the package to the "
1869 "Debian Bug Tracking System. This file is installed as "
1870 "F<usr/share/bug/package/presubj> in the package build directory."
1876 "Install debian/bug-* files to ALL packages acted on when respective "
1877 "debian/package.bug-* files do not exist. Normally, debian/bug-* will be "
1878 "installed to the first package only."
1883 msgid "F</usr/share/doc/reportbug/README.developers.gz>"
1887 #: dh_bugfiles:126 dh_lintian:59
1888 msgid "L<debhelper(1)>"
1893 msgid "Modestas Vainius <modestas@vainius.eu>"
1898 msgid "dh_builddeb - build debian binary packages"
1904 "B<dh_builddeb> [S<I<debhelper options>>] [B<--destdir=>I<directory>] "
1905 "[B<--filename=>I<name>] [S<B<--> I<params>>]"
1911 "dh_builddeb simply calls L<dpkg-deb(1)> to build a debian package or "
1918 "Use this if you want the generated .deb files to be put in a directory other "
1919 "than the default of \"..\""
1924 msgid "B<--filename=>I<name>"
1930 "Use this if you want to force the generated .deb file to have a particular "
1931 "file name. Does not work well if more than one .deb is generated!"
1936 msgid "Pass I<params> to L<dpkg-deb(1)> when it is used to build the package."
1941 msgid "B<-u>I<params>"
1945 #: dh_builddeb:42 dh_gencontrol:36 dh_shlibdeps:43
1947 "This is another way to pass I<params> to L<dpkg-deb(1)>. It is deprecated; "
1948 "use B<--> instead."
1953 msgid "dh_clean - clean up package build directories"
1959 "B<dh_clean> [S<I<debhelper options>>] [B<-k>] [B<-d>] [B<-X>I<item>] "
1967 "dh_clean is a debhelper program that is responsible for cleaning up after "
1969 "package is built. It removes the package build directories, and removes "
1971 "other files including debian/files, and any detritus left behind by other\n"
1972 "debhelper commands. It also removes common files that should not appear in "
1975 " #*# *~ DEADJOE *.orig *.rej *.SUMS TAGS .deps/* *.P *-stamp\n"
1982 "It does not run \"make clean\" to clean up after the build process. Use "
1983 "L<dh_auto_clean(1)> to do things like that."
1989 "dh_clean (or \"dh clean\") should be the last debhelper command run in the "
1990 "clean target in debian/rules."
1995 msgid "debian/clean"
2000 msgid "Can list other files to be removed."
2004 #: dh_clean:45 dh_installchangelogs:60
2005 msgid "B<-k>, B<--keep>"
2010 msgid "This is deprecated, use L<dh_prep(1)> instead."
2015 msgid "B<-d>, B<--dirs-only>"
2021 "Only clean the package build directories, do not clean up any other files at "
2026 #: dh_clean:54 dh_prep:30
2027 msgid "B<-X>I<item> B<--exclude=>I<item>"
2031 #: dh_clean:56 dh_prep:32
2033 "Exclude files that contain \"item\" anywhere in their filename from being "
2034 "deleted, even if they would normally be deleted. You may use this option "
2035 "multiple times to build up a list of things to exclude."
2039 #: dh_clean:60 dh_compress:63 dh_installdocs:92 dh_installexamples:46 dh_installinfo:40 dh_installmanpages:44 dh_movefiles:55 dh_testdir:27
2045 msgid "Delete these files too."
2050 msgid "dh_compress - compress files and fix symlinks in package build directories"
2056 "B<dh_compress> [S<I<debhelper options>>] [B<-X>I<item>] [B<-A>] [S<I<file "
2063 "dh_compress is a debhelper program that is responsible for compressing the "
2064 "files in package build directories, and makes sure that any symlinks that "
2065 "pointed to the files before they were compressed are updated to point to the "
2072 "By default, dh_compress compresses files that debian policy mandates should "
2073 "be compressed, namely all files in usr/share/info, usr/share/man, files in "
2074 "usr/share/doc that are larger than 4k in size, (except the copyright file, "
2075 ".html and .css files, image files, and files that appear to be already "
2076 "compressed based on their extensions), and all changelog files. Plus PCF "
2077 "fonts underneath usr/share/fonts/X11/"
2082 msgid "debian/I<package>.compress"
2088 "If this file exists, the default files are not compressed. Instead, the file "
2089 "is ran as a shell script, and all filenames that the shell script outputs "
2090 "will be compressed. The shell script will be run from inside the package "
2091 "build directory. Note though that using -X is a much better idea in general; "
2092 "you should only use a debian/package.compress file if you really need to."
2098 "Exclude files that contain \"item\" anywhere in their filename from being "
2099 "compressed. For example, -X.tiff will exclude tiff files from compression. "
2100 "You may use this option multiple times to build up a list of things to "
2101 "exclude. You can accomplish the same thing by using a debian/compress file, "
2102 "but this is easier."
2108 "Compress all files specified by command line parameters in ALL packages "
2114 msgid "Add these files to the list of files to compress."
2118 #: dh_compress:69 dh_perl:61 dh_python:66 dh_strip:74 dh_usrlocal:55
2124 msgid "Debian policy, version 3.0"
2129 msgid "dh_desktop - deprecated no-op"
2134 msgid "B<dh_desktop> [S<I<debhelper options>>]"
2140 "dh_desktop was a debhelper program that registers .desktop files. However, "
2141 "it no longer does anything, and is now deprecated."
2147 "If a package ships desktop files, they just need to be installed in the "
2148 "correct location (/usr/share/applications) and they will be registered by "
2149 "the appropriate tools for the corresponding desktop environments."
2153 #: dh_desktop:33 dh_icons:67 dh_scrollkeeper:30
2154 msgid "L<debhelper>"
2158 #: dh_desktop:39 dh_scrollkeeper:36
2159 msgid "Ross Burton <ross@burtonini.com>"
2164 msgid "dh_fixperms - fix permissions of files in package build directories"
2169 msgid "B<dh_fixperms> [S<I<debhelper options>>] [B<-X>I<item>]"
2175 "dh_fixperms is a debhelper program that is responsible for setting the "
2176 "permissions of files and directories in package build directories to a sane "
2177 "state -- a state that complies with Debian policy."
2183 "dh_fixperms makes all files in usr/share/doc in the package build directory "
2184 "(excluding files in the examples/ directory) be mode 644. It also changes "
2185 "the permissions of all man pages to mode 644. It makes all files be owned by "
2186 "root, and it removes group and other write permission from all files. It "
2187 "removes execute permissions from any libraries, headers, perl modules, or "
2188 "desktop files that have it set. It makes all files in the standard bin and "
2189 "sbin directories, usr/games/ and etc/init.d executable (since v4). Finally, "
2190 "it removes the setuid and setgid bits from all files in the package."
2195 msgid "B<-X>I<item>, B<--exclude> I<item>"
2201 "Exclude files that contain \"item\" anywhere in their filename from having "
2202 "their permissions changed. You may use this option multiple times to build "
2203 "up a list of things to exclude."
2208 msgid "dh_gconf - generate GConf schema registration scripts"
2213 msgid "B<dh_gconf> [S<I<debhelper options>>] [B<--priority=<number>>]"
2219 "dh_gconf is a debhelper program that is responsible for registering GConf "
2226 "It automatically generates the postinst and prerm fragments needed to "
2227 "register and unregister the schemas in usr/share/gconf/schemas, using "
2233 msgid "An appropriate dependency on gconf2 will be generated in ${misc:Depends}."
2238 msgid "debian/I<package>.gconf-defaults"
2244 "Installed into usr/share/gconf/defaults/10_package in the package build "
2245 "directory, with \"I<package>\" replaced by the package name. Some postinst "
2246 "and postrm fragments will be generated to run update-gconf-defaults."
2251 msgid "debian/I<package>.gconf-mandatory"
2257 "Installed into usr/share/gconf/mandatory/10_package in the package build "
2258 "directory, with \"I<package>\" replaced by the package name, and similar "
2259 "postinst and postrm fragments will be generated."
2264 msgid "B<--priority> I<priority>"
2270 "Use I<priority> (which should be a 2-digit number) as the defaults priority "
2271 "instead of 10. Higher values than ten can be used by derived distributions "
2272 "(20), CDD distributions (50), or site-specific packages (90)."
2277 msgid "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>"
2282 msgid "dh_gencontrol - generate and install control file"
2287 msgid "B<dh_gencontrol> [S<I<debhelper options>>] [S<B<--> I<params>>]"
2293 "dh_gencontrol is a debhelper program that is responsible for generating "
2294 "control files, and installing them into the DEBIAN directory with the proper "
2301 "This program is merely a wrapper around L<dpkg-gencontrol(1)>, which calls "
2302 "it once for each package being acted on, and passes in some additional "
2308 msgid "Pass \"params\" to L<dpkg-gencontrol(1)>."
2313 msgid "B<-u>I<params>, B<--dpkg-gencontrol-params>=I<params>"
2318 msgid "dh_icons - Update Freedesktop icon caches"
2323 msgid "B<dh_icons> [S<I<debhelper options>>] [B<-n>]"
2329 "dh_icons is a debhelper program that updates Freedesktop icon caches when "
2330 "needed, using the update-icon-caches program provided by GTK+2.12. "
2331 "Currently this program does not handle installation of the files, though it "
2332 "may do so at a later date. It takes care of adding maintainer script "
2333 "fragments to call F<update-icon-caches>."
2337 #: dh_icons:29 dh_installcatalogs:53 dh_installdebconf:65 dh_installemacsen:52 dh_installinit:52 dh_installmenu:45 dh_installmime:45 dh_installmodules:48 dh_installudev:49 dh_installwm:44 dh_makeshlibs:72 dh_python:60 dh_usrlocal:43
2338 msgid "B<-n>, B<--noscripts>"
2343 msgid "Do not modify maintainer scripts."
2349 "Ross Burton <ross@burtonini.com> Jordi Mallach <jordi@debian.org> Josselin "
2350 "Mouette <joss@debian.org>"
2355 msgid "dh_install - install files into package build directories"
2361 "B<dh_install> [B<-X>I<item>] [B<--autodest>] [B<--sourcedir=>I<dir>] "
2362 "[S<I<debhelper options>>] [S<I<file [...] dest>>]"
2368 "dh_install is a debhelper program that handles installing files into package "
2369 "build directories. There are many dh_install* commands that handle "
2370 "installing specific types of files such as documentation, examples, man "
2371 "pages, and so on, and they should be used when possible as they often have "
2372 "extra intelligence for those particular tasks. dh_install, then, is useful "
2373 "for installing everything else, for which no particular intelligence is "
2374 "needed. It is a replacement for the old dh_movefiles command."
2380 "This program may be used in one of two ways. If you just have a file or two "
2381 "that the upstream Makefile does not install for you, you can run dh_install "
2382 "on them to move them into place. On the other hand, maybe you have a large "
2383 "package that builds multiple binary packages. You can use the upstream "
2384 "Makefile to install it all into debian/tmp, and then use dh_install to copy "
2385 "directories and files from there into the proper package build directories."
2391 "From debhelper compatibility level 7 on, dh_install will fall back to "
2392 "looking in debian/tmp for files, if it doesn't find them in the current "
2393 "directory (or whereever you've told it to look using --sourcedir)."
2398 msgid "debian/I<package>.install"
2404 "List the files to install into each package and the directory they should be "
2405 "installed to. The format is a set of lines, where each line lists a file or "
2406 "files to install, and at the end of the line tells the directory it should "
2407 "be installed in. The name of the files (or directories) to install should be "
2408 "given relative to the current directory, while the installation directory is "
2409 "given relative to the package build directory. You may use wildcards in the "
2410 "names of the files to install (in v3 mode and above)."
2415 msgid "B<--list-missing>"
2421 "This option makes dh_install keep track of the files it installs, and then "
2422 "at the end, compare that list with the files in the source directory. If any "
2423 "of the files (and symlinks) in the source directory were not installed to "
2424 "somewhere, it will warn on stderr about that."
2430 "This may be useful if you have a large package and want to make sure that "
2431 "you don't miss installing newly added files in new upstream releases."
2437 "Note that files that are excluded from being moved via the -X option are not "
2443 msgid "B<--fail-missing>"
2449 "This option is like --list-missing, except if a file was missed, it will not "
2450 "only list the missing files, but also fail with a nonzero exit code."
2454 #: dh_install:76 dh_installchangelogs:68 dh_installdocs:69 dh_installexamples:41 dh_link:60 dh_movefiles:50
2455 msgid "B<-Xitem>, B<--exclude=item>"
2459 #: dh_install:78 dh_installexamples:43 dh_movefiles:52
2461 "Exclude files that contain \"item\" anywhere in their filename from being "
2467 msgid "B<--sourcedir=dir>"
2472 msgid "Look in the specified directory for files to be installed."
2478 "Note that this is not the same as the --sourcedirectory option used by the "
2479 "dh_auto_* commands. You rarely need to use this option, since dh_install "
2480 "automatically looks for files in debian/tmp in debhelper compatibility level "
2486 msgid "B<--autodest>"
2492 "Guess as the destination directory to install things to. If this is "
2493 "specified, you should not list destination directories in "
2494 "debian/package.install files or on the command line. Instead, dh_install "
2495 "will guess as follows:"
2501 "Strip off debian/tmp (or the sourcedir if one is given) from the front of "
2502 "the filename, if it is present, and install into the dirname of the "
2503 "filename. So if the filename is debian/tmp/usr/bin, then that directory will "
2504 "be copied to debian/package/usr/. If the filename is debian/tmp/etc/passwd, "
2505 "it will be copied to debian/package/etc/."
2511 "Note that if you list exactly one filename or wildcard-pattern on a line by "
2512 "itself in a debian/package.install file, with no explicit destination, then "
2513 "dh_install will automatically guess the destination even if this flag is not "
2519 msgid "I<file [...] dest>"
2525 "Lists files (or directories) to install and where to install them to. The "
2526 "files will be installed into the first package dh_install acts on."
2537 "Suppose your package's upstream Makefile installs a binary, a man page, and "
2538 "a library into appropriate subdirectories of debian/tmp. You want to put the "
2539 "library into package libfoo, and the rest into package foo. Your rules file "
2540 "will run \"dh_install --sourcedir=debian/tmp\". Make debian/foo.install "
2549 " usr/share/man/man1\n"
2555 msgid "While debian/libfoo.install contains:"
2562 " usr/lib/libfoo*.so.*\n"
2569 "If you want a libfoo-dev package too, debian/libfoo-dev.install might "
2578 " usr/lib/libfoo*.so\n"
2579 " usr/share/man/man3\n"
2592 "dh_install cannot rename files or directories, it can only install them\n"
2593 "with the names they already have into wherever you want in the package\n"
2599 #: dh_installcatalogs:5
2600 msgid "dh_installcatalogs - install and register SGML Catalogs"
2604 #: dh_installcatalogs:16
2605 msgid "B<dh_installcatalogs> [S<I<debhelper options>>] [B<-n>]"
2609 #: dh_installcatalogs:20
2611 "dh_installcatalogs is a debhelper program that installs and registers SGML "
2612 "catalogs. It complies with the Debian XML/SGML policy."
2616 #: dh_installcatalogs:23
2618 "Catalogs will be registered in a supercatalog, in "
2619 "F</etc/sgml/I<package>.cat>."
2623 #: dh_installcatalogs:26
2625 "This command automatically adds maintainer script snippets for registering "
2626 "and unregistering the catalogs and supercatalogs (unless B<-n> is "
2627 "used). These snippets are inserted into the maintainer scripts by "
2628 "dh_installdeb; see L<dh_installdeb(1)> for an explanation of Debhelper "
2629 "maintainer script snippets."
2633 #: dh_installcatalogs:32
2635 "A dependency on B<sgml-base> will be added to C<${misc:Depends}>, so be sure "
2636 "your package uses that variable in F<debian/control>."
2640 #: dh_installcatalogs:39
2641 msgid "debian/I<package>.sgmlcatalogs"
2645 #: dh_installcatalogs:41
2647 "Lists the catalogs to be installed per package. Each line in that file "
2648 "should be of the form C<source dest>, where C<source> indicates where the "
2649 "catalog resides in the source tree, and C<dest> indicates the destination "
2650 "location for the catalog under the package build area. C<dest> should start "
2651 "with F</usr/share/sgml/>."
2655 #: dh_installcatalogs:55
2656 msgid "Do not modify F<postinst>/F<postrm>/F<prerm> scripts."
2660 #: dh_installcatalogs:61 dh_installdocs:116 dh_installemacsen:69 dh_installinit:135 dh_installmime:53 dh_installmodules:62 dh_installudev:57 dh_installwm:56 dh_usrlocal:51
2662 "Note that this command is not idempotent. L<dh_prep(1)> should be called "
2663 "between invocations of this command. Otherwise, it may cause multiple "
2664 "instances of the same text to be added to maintainer scripts."
2668 #: dh_installcatalogs:120
2669 msgid "F</usr/share/doc/sgml-base-doc/>"
2673 #: dh_installcatalogs:124
2674 msgid "Adam Di Carlo <aph@debian.org>"
2678 #: dh_installchangelogs:5
2679 msgid "dh_installchangelogs - install changelogs into package build directories"
2683 #: dh_installchangelogs:14
2685 "B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] "
2690 #: dh_installchangelogs:18
2692 "dh_installchangelogs is a debhelper program that is responsible for "
2693 "installing changelogs into package build directories."
2697 #: dh_installchangelogs:21
2699 "An upstream changelog file may be specified as an option. If none is "
2700 "specified, a few common filenames are tried. (In compatibility level 7 and "
2705 #: dh_installchangelogs:25
2707 "If there is an upstream changelog file, it will be be installed as "
2708 "usr/share/doc/package/changelog in the package build directory. If the "
2709 "changelog is a html file (determined by file extension), it will be "
2710 "installed as usr/share/doc/package/changelog.html instead, and will be "
2711 "converted to plain text with html2text to generate "
2712 "usr/share/doc/package/changelog."
2716 #: dh_installchangelogs:36
2717 msgid "debian/changelog"
2721 #: dh_installchangelogs:38
2726 #: dh_installchangelogs:40
2727 msgid "debian/I<package>.changelog"
2731 #: dh_installchangelogs:42
2732 msgid "debian/I<package>.NEWS"
2736 #: dh_installchangelogs:44
2738 "Automatically installed into usr/share/doc/I<package>/ in the package build "
2743 #: dh_installchangelogs:47
2745 "Use the package specific name if I<package> needs a different NEWS or "
2750 #: dh_installchangelogs:50
2752 "The changelog file is installed with a name of changelog for native "
2753 "packages, and changelog.Debian for non-native packages. The NEWS file is "
2754 "always installed with a name of NEWS.Debian."
2758 #: dh_installchangelogs:62
2760 "Keep the original name of the upstream changelog. This will be accomplished "
2761 "by installing the upstream changelog as \"changelog\", and making a symlink "
2762 "from that to the original name of the changelog file. This can be useful if "
2763 "the upstream changelog has an unusual name, or if other documentation in the "
2764 "package refers to the changelog file."
2768 #: dh_installchangelogs:70
2770 "Exclude upstream changelog files that contain \"item\" anywhere in their "
2771 "filename from being installed."
2775 #: dh_installchangelogs:73
2780 #: dh_installchangelogs:75
2781 msgid "Install this file as the upstream changelog."
2786 msgid "dh_installcron - install cron scripts into etc/cron.*"
2790 #: dh_installcron:14
2791 msgid "B<dh_installcron> [S<B<debhelper options>>] [B<--name=>I<name>]"
2795 #: dh_installcron:18
2797 "dh_installcron is a debhelper program that is responsible for installing "
2802 #: dh_installcron:25
2803 msgid "debian/I<package>.cron.daily"
2807 #: dh_installcron:27
2808 msgid "debian/I<package>.cron.weekly"
2812 #: dh_installcron:29
2813 msgid "debian/I<package>.cron.monthly"
2817 #: dh_installcron:31
2818 msgid "debian/I<package>.cron.hourly"
2822 #: dh_installcron:33
2823 msgid "debian/I<package>.cron.d"
2827 #: dh_installcron:35
2829 "Installed into the appropriate etc/cron.*/ directory in the package build "
2834 #: dh_installcron:44 dh_installifupdown:43 dh_installinit:104 dh_installlogrotate:26 dh_installmodules:52 dh_installpam:35 dh_installppp:39 dh_installudev:39
2835 msgid "B<--name=>I<name>"
2839 #: dh_installcron:46
2841 "Look for files named debian/package.name.cron.* and install them as "
2842 "etc/cron.*/name, instead of using the usual files and installing them as the "
2848 msgid "dh_installdeb - install files into the DEBIAN directory"
2853 msgid "B<dh_installdeb> [S<I<debhelper options>>]"
2859 "dh_installdeb is a debhelper program that is responsible for installing "
2860 "files into the DEBIAN directories in package build directories with the "
2861 "correct permissions."
2866 msgid "I<package>.postinst"
2871 msgid "I<package>.preinst"
2876 msgid "I<package>.postrm"
2881 msgid "I<package>.prerm"
2886 msgid "These maintainer scripts are installed into the DEBIAN directory."
2892 "Inside the scripts, the token B<#DEBHELPER#> is replaced with shell script "
2893 "snippets generated by other debhelper commands."
2898 msgid "I<package>.triggers"
2903 msgid "I<package>.shlibs"
2908 msgid "These control files are installed into the DEBIAN directory."
2913 msgid "I<package>.conffiles"
2918 msgid "This control file will be installed into the DEBIAN directory."
2924 "In V3 compatibility mode and higher, all files in the etc/ directory in a "
2925 "package will automatically be flagged as conffiles by this program, so there "
2926 "is no need to list them manually here."
2930 #: dh_installdebconf:5
2932 "dh_installdebconf - install files used by debconf in package build "
2937 #: dh_installdebconf:14
2938 msgid "B<dh_installdebconf> [S<I<debhelper options>>] [B<-n>] [S<B<--> I<params>>]"
2942 #: dh_installdebconf:18
2944 "dh_installdebconf is a debhelper program that is responsible for installing "
2945 "files used by debconf into package build directories."
2949 #: dh_installdebconf:21
2951 "It also automatically generates the postrm commands needed to interface with "
2952 "debconf. The commands are added to the maintainer scripts by "
2953 "dh_installdeb. See L<dh_installdeb(1)> for an explanation of how that works."
2957 #: dh_installdebconf:26
2959 "Note that if you use debconf, your package probably needs to depend on it "
2960 "(it will be added to ${misc:Depends} by this program)."
2964 #: dh_installdebconf:29
2966 "Note that for your config script to be called by dpkg, your postinst needs "
2967 "to source debconf's confmodule. dh_installdebconf does not install this "
2968 "statement into the postinst automatically as it it too hard to do it right."
2972 #: dh_installdebconf:38
2973 msgid "debian/I<package>.config"
2977 #: dh_installdebconf:40
2979 "This is the debconf config script, and is installed into the DEBIAN "
2980 "directory in the package build directory."
2984 #: dh_installdebconf:43
2986 "Inside the script, the token B<#DEBHELPER#> is replaced with shell script "
2987 "snippets generated by other debhelper commands."
2991 #: dh_installdebconf:46
2992 msgid "debian/I<package>.templates"
2996 #: dh_installdebconf:48
2998 "This is the debconf templates file, and is installed into the DEBIAN "
2999 "directory in the package build directory."
3003 #: dh_installdebconf:51
3008 #: dh_installdebconf:53
3010 "If this directory is present, this program will automatically use "
3011 "L<po2debconf(1)> to generate merged templates files that include the "
3012 "translations from there."
3016 #: dh_installdebconf:57
3017 msgid "For this to work, your package should build-depend on po-debconf."
3021 #: dh_installdebconf:67
3022 msgid "Do not modify postrm script."
3026 #: dh_installdebconf:71
3027 msgid "Pass the params to po2debconf."
3032 msgid "dh_installdirs - create subdirectories in package build directories"
3036 #: dh_installdirs:14
3037 msgid "B<dh_installdirs> [S<I<debhelper options>>] [B<-A>] [S<I<dir ...>>]"
3041 #: dh_installdirs:18
3043 "dh_installdirs is a debhelper program that is responsible for creating "
3044 "subdirectories in package build directories."
3048 #: dh_installdirs:25
3049 msgid "debian/I<package>.dirs"
3053 #: dh_installdirs:27
3054 msgid "Lists directories to be created in I<package>."
3058 #: dh_installdirs:37
3060 "Create any directories specified by command line parameters in ALL packages "
3061 "acted on, not just the first."
3065 #: dh_installdirs:40
3070 #: dh_installdirs:42
3072 "Create these directories in the package build directory of the first package "
3073 "acted on. (Or in all packages if -A is specified.)"
3078 msgid "dh_installdocs - install documentation into package build directories"
3082 #: dh_installdocs:14
3084 "B<dh_installdocs> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] [S<I<file "
3089 #: dh_installdocs:18
3091 "dh_installdocs is a debhelper program that is responsible for installing "
3092 "documentation into usr/share/doc/package in package build directories."
3096 #: dh_installdocs:25
3097 msgid "debian/I<package>.docs"
3101 #: dh_installdocs:27
3102 msgid "List documentation files to be installed into I<package>."
3106 #: dh_installdocs:29
3107 msgid "debian/copyright"
3111 #: dh_installdocs:31
3112 msgid "debian/README.Debian"
3116 #: dh_installdocs:33
3121 #: dh_installdocs:35
3122 msgid "debian/I<package>.copyright"
3126 #: dh_installdocs:37
3127 msgid "debian/I<package>.README.Debian"
3131 #: dh_installdocs:39
3132 msgid "debian/I<package>.TODO"
3136 #: dh_installdocs:41
3138 "Each of these files is automatically installed if present. Use the package "
3139 "specific name if I<package> needs a different version of the file."
3143 #: dh_installdocs:44
3145 "Note that debian/README.debian is also installed as README.Debian, and "
3146 "debian/TODO will be installed as TODO.Debian in non-native packages."
3150 #: dh_installdocs:47
3151 msgid "debian/I<package>.doc-base"
3155 #: dh_installdocs:49
3157 "Installed as doc-base control files. Note that the doc-id will be determined "
3158 "from the \"Document:\" entry in the doc-base control file in question."
3162 #: dh_installdocs:53
3163 msgid "debian/I<package>.doc-base.*"
3167 #: dh_installdocs:55
3169 "If your package needs to register more than one document, you need multiple "
3170 "doc-base files, and can name them like this."
3174 #: dh_installdocs:66 dh_installinfo:37 dh_installman:66
3176 "Install all files specified by command line parameters in ALL packages acted "
3181 #: dh_installdocs:71
3183 "Exclude files that contain \"item\" anywhere in their filename from being "
3184 "installed. Note that this includes doc-base files."
3188 #: dh_installdocs:74
3189 msgid "B<--link-doc=>I<package>"
3193 #: dh_installdocs:76
3195 "Make the documentation directory of all packages acted on be a symlink to "
3196 "the documentation directory of I<package>. This has no effect when acting on "
3197 "I<package> itself, or if the documentation directory to be created already "
3198 "exists when B<dh_installdocs> is run. To comply with policy, I<package> must "
3199 "be a binary package that comes from the same source package."
3203 #: dh_installdocs:82
3205 "debhelper will try to avoid installing files into linked documentation "
3206 "directories that would cause conflicts with the linked package. The B<-A> "
3207 "option will have no effect on packages with linked documentation "
3208 "directories, and copyright, changelog, README.Debian, and TODO files will "
3213 #: dh_installdocs:88
3215 "(An older method to accomplish the same thing, which is still supported, is "
3216 "to make the documentation directory of a package be a dangling symlink, "
3217 "before calling dh_installdocs.)"
3221 #: dh_installdocs:94
3223 "Install these files as documentation into the first package acted on. (Or in "
3224 "all packages if B<-A> is specified)."
3228 #: dh_installdocs:101
3229 msgid "This is an example of a debian/package.docs file:"
3233 #: dh_installdocs:103
3238 " debian/notes-for-maintainers.txt\n"
3239 " docs/manual.txt\n"
3240 " docs/manual.pdf\n"
3241 " docs/manual-html/\n"
3246 #: dh_installdocs:112
3248 "Note that dh_installdocs will happily copy entire directory hierarchies if "
3249 "you ask it to (similar to cp -a). If it is asked to install a directory, it "
3250 "will install the complete contents of the directory."
3254 #: dh_installemacsen:5
3255 msgid "dh_installemacsen - register an emacs add on package"
3259 #: dh_installemacsen:14
3261 "B<dh_installemacsen> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] "
3262 "[B<--flavor=>I<foo>]"
3266 #: dh_installemacsen:18
3268 "dh_installemacsen is a debhelper program that is responsible for installing "
3269 "files used by the debian emacsen-common package into package build "
3274 #: dh_installemacsen:22
3276 "It also automatically generates the postinst and prerm commands needed to "
3277 "register a package as an emacs add on package. The commands are added to the "
3278 "maintainer scripts by dh_installdeb. See L<dh_installdeb(1)> for an "
3279 "explanation of how this works."
3283 #: dh_installemacsen:31
3284 msgid "debian/I<package>.emacsen-install"
3288 #: dh_installemacsen:33
3290 "Installed into usr/lib/emacsen-common/packages/install/package in the "
3291 "package build directory."
3295 #: dh_installemacsen:36
3296 msgid "debian/I<package>.emacsen-remove"
3300 #: dh_installemacsen:38
3302 "Installed into usr/lib/emacsen-common/packages/remove/package in the package "
3307 #: dh_installemacsen:41
3308 msgid "debian/I<package>.emacsen-startup"
3312 #: dh_installemacsen:43
3314 "Installed into etc/emacs/site-start.d/50I<package>.el in the package build "
3315 "directory. Use --priority to use a different priority than 50."
3319 #: dh_installemacsen:54
3320 msgid "Do not modify postinst/prerm scripts."
3324 #: dh_installemacsen:56 dh_installwm:38
3325 msgid "B<--priority=>I<n>"
3329 #: dh_installemacsen:58
3330 msgid "Sets the priority number of a site-start.d file. Default is 50."
3334 #: dh_installemacsen:60
3335 msgid "B<--flavor=>I<foo>"
3339 #: dh_installemacsen:62
3341 "Sets the flavor a site-start.d file will be installed in. Default is "
3342 "\"emacs\", alternatives include \"xemacs\" and \"emacs20\"."
3346 #: dh_installexamples:5
3347 msgid "dh_installexamples - install example files into package build directories"
3351 #: dh_installexamples:14
3353 "B<dh_installexamples> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] "
3358 #: dh_installexamples:18
3360 "dh_installexamples is a debhelper program that is responsible for installing "
3361 "examples into usr/share/doc/package/examples in package build directories."
3365 #: dh_installexamples:26
3366 msgid "debian/I<package>.examples"
3370 #: dh_installexamples:28
3371 msgid "Lists example files or directories to be installed."
3375 #: dh_installexamples:38
3377 "Install any files specified by command line parameters in ALL packages acted "
3382 #: dh_installexamples:48
3384 "Install these files (or directories) as examples into the first package "
3385 "acted on. (Or into all packages if -A is specified.)"
3389 #: dh_installexamples:55
3391 "Note that dh_installexamples will happily copy entire directory hierarchies "
3392 "if you ask it to (similar to cp -a). If it is asked to install a directory, "
3393 "it will install the complete contents of the directory."
3397 #: dh_installifupdown:5
3398 msgid "dh_installifupdown - install if-up and if-down hooks"
3402 #: dh_installifupdown:14
3403 msgid "B<dh_installifupdown> [S<I<debhelper options>>] [B<--name=>I<name>]"
3407 #: dh_installifupdown:18
3409 "dh_installifupdown is a debhelper program that is responsible for installing "
3410 "if-up, if-down, if-pre-up, and if-post-down hook scripts into package build "
3415 #: dh_installifupdown:26
3416 msgid "debian/I<package>.if-up"
3420 #: dh_installifupdown:28
3421 msgid "debian/I<package>.if-down"
3425 #: dh_installifupdown:30
3426 msgid "debian/I<package>.if-pre-up"
3430 #: dh_installifupdown:32
3431 msgid "debian/I<package>.if-post-down"
3435 #: dh_installifupdown:34
3437 "These files are installed into etc/network/if-*.d/I<package> in the package "
3442 #: dh_installifupdown:45
3444 "Look for files named debian/package.name.if-* and install them as "
3445 "etc/network/if-*/name, instead of using the usual files and installing them "
3446 "as the package name."
3451 msgid "dh_installinfo - install info files"
3455 #: dh_installinfo:14
3456 msgid "B<dh_installinfo> [S<I<debhelper options>>] [B<-A>] [S<I<file ...>>]"
3460 #: dh_installinfo:18
3462 "dh_installinfo is a debhelper program that is responsible for installing "
3463 "info files into usr/share/info in the package build directory."
3467 #: dh_installinfo:25
3468 msgid "debian/I<package>.info"
3472 #: dh_installinfo:27
3473 msgid "List info files to be installed."
3477 #: dh_installinfo:42
3479 "Install these info files into the first package acted on. (Or in all "
3480 "packages if -A is specified)."
3486 "dh_installinit - install upstart jobs or init scripts into package build "
3491 #: dh_installinit:14
3493 "B<dh_installinit> [S<I<debhelper options>>] [B<--name=>I<name>] [B<-n>] "
3494 "[B<-R>] [B<-r>] [B<-d>] [B<-O>] [S<B<--> I<params>>]"
3498 #: dh_installinit:18
3500 "dh_installinit is a debhelper program that is responsible for installing "
3501 "upstart job files or init scripts with associated defaults files into "
3502 "package build directories, and in the former case providing compatibility "
3503 "handling for non-upstart systems."
3507 #: dh_installinit:23
3509 "It also automatically generates the postinst and postrm and prerm commands "
3510 "needed to set up the symlinks in /etc/rc*.d/ and to start and stop the init "
3515 #: dh_installinit:31
3516 msgid "debian/I<package>.upstart"
3520 #: dh_installinit:33
3522 "If this exists, it is installed into etc/init/I<package>.conf in the package "
3527 #: dh_installinit:36
3528 msgid "debian/I<package>.init"
3532 #: dh_installinit:38
3534 "Otherwise, if this exists, it is installed into etc/init.d/I<package> in the "
3535 "package build directory."
3539 #: dh_installinit:41
3540 msgid "debian/I<package>.default"
3544 #: dh_installinit:43
3546 "If this exists, it is installed into etc/default/I<package> in the package "
3551 #: dh_installinit:54
3552 msgid "Do not modify postinst/postrm/prerm scripts."
3556 #: dh_installinit:56
3557 msgid "B<-o>, B<--onlyscripts>"
3561 #: dh_installinit:58
3563 "Only modify postinst/postrm/prerm scripts, do not actually install any init "
3564 "script, default files, or upstart job. May be useful if the init script or "
3565 "upstart job is shipped and/or installed by upstream in a way that doesn't "
3566 "make it easy to let dh_installinit find it."
3570 #: dh_installinit:63
3572 "If no upstart job file is installed in the target directory when "
3573 "dh_installinit --onlyscripts is called, this program will assume that an "
3574 "init script is being installed and not provide the compatibility symlinks or "
3575 "upstart dependencies."
3579 #: dh_installinit:68
3580 msgid "B<-R>, B<--restart-after-upgrade>"
3584 #: dh_installinit:70
3586 "Do not stop the init script until after the package upgrade has been "
3587 "completed. This is different than the default behavior, which stops the "
3588 "script in the prerm, and starts it again in the postinst."
3592 #: dh_installinit:74
3594 "This can be useful for daemons that should not have a possibly long downtime "
3595 "during upgrade. But you should make sure that the daemon will not get "
3596 "confused by the package being upgraded while it's running before using this "
3601 #: dh_installinit:79
3602 msgid "B<-r>, B<--no-restart-on-upgrade>"
3606 #: dh_installinit:81
3607 msgid "Do not stop init script on upgrade."
3611 #: dh_installinit:83
3612 msgid "B<--no-start>"
3616 #: dh_installinit:85
3618 "Do not start the init script on install or upgrade, or stop it on removal. "
3619 "Only call update-rc.d. Useful for rcS scripts."
3623 #: dh_installinit:88
3624 msgid "B<-d>, B<--remove-d>"
3628 #: dh_installinit:90
3630 "Remove trailing \"d\" from the name of the package, and use the result for "
3631 "the filename the upstart job file is installed as in etc/init/ , or for the "
3632 "filename the init script is installed as in etc/init.d and the default file "
3633 "is installed as in etc/default/ . This may be useful for daemons with names "
3634 "ending in \"d\". (Note: this takes precedence over the --init-script "
3635 "parameter described below.)"
3639 #: dh_installinit:97
3640 msgid "B<-u>I<params> B<--update-rcd-params=>I<params>"
3644 #: dh_installinit:101
3646 "Pass \"params\" to L<update-rc.d(8)>. If not specified, \"defaults\" will be "
3647 "passed to L<update-rc.d(8)>."
3651 #: dh_installinit:106
3653 "Install the upstart job file or the init script (and default file) using the "
3654 "filename I<name> instead of the default filename, which is the package "
3655 "name. When this parameter is used, dh_installinit looks for and installs "
3656 "files named debian/package.name.upstart, debian/package.name.init and "
3657 "debian/package.name.default, instead of the usual debian/package.upstart, "
3658 "debian/package.init and debian/package.default."
3662 #: dh_installinit:113
3663 msgid "B<--init-script=>I<scriptname>"
3667 #: dh_installinit:115
3669 "Use \"scriptname\" as the filename the init script is installed as in "
3670 "etc/init.d/ (and also use it as the filename for the defaults file, if it is "
3671 "installed). If you use this parameter, dh_installinit will look to see if a "
3672 "file in the debian/ directory exists that looks like \"package.scriptname\" "
3673 "and if so will install it as the init script in preference to the files it "
3674 "normally installs."
3678 #: dh_installinit:122
3680 "This parameter is deprecated, use the --name parameter instead. This "
3681 "parameter will be ignored completely for upstart jobs."
3685 #: dh_installinit:125
3686 msgid "B<--error-handler=>I<function>"
3690 #: dh_installinit:127
3692 "Call the named shell function if running the init script fails. The function "
3693 "should be provided in the prerm and postinst scripts, before the #DEBHELPER# "
3698 #: dh_installinit:281
3703 #: dh_installinit:285
3704 msgid "Steve Langasek <steve.langasek@canonical.com>"
3708 #: dh_installlogcheck:5
3709 msgid "dh_installlogcheck - install logcheck rulefiles into etc/logcheck/"
3713 #: dh_installlogcheck:14
3714 msgid "B<dh_installlogcheck> [S<B<debhelper options>>]"
3718 #: dh_installlogcheck:18
3720 "dh_installlogcheck is a debhelper program that is responsible for installing "
3721 "logcheck rule files."
3725 #: dh_installlogcheck:25
3726 msgid "debian/I<package>.logcheck.cracking"
3730 #: dh_installlogcheck:27
3731 msgid "debian/I<package>.logcheck.violations"
3735 #: dh_installlogcheck:29
3736 msgid "debian/I<package>.logcheck.violations.ignore"
3740 #: dh_installlogcheck:31
3741 msgid "debian/I<package>.logcheck.ignore.workstation"
3745 #: dh_installlogcheck:33
3746 msgid "debian/I<package>.logcheck.ignore.server"
3750 #: dh_installlogcheck:35
3751 msgid "debian/I<package>.logcheck.ignore.paranoid"
3755 #: dh_installlogcheck:37
3757 "Each of these files, if present, are installed into corresponding "
3758 "subdirectories of etc/logcheck/ in package build directories."
3762 #: dh_installlogcheck:70
3765 "This program is a part of debhelper.\n"
3770 #: dh_installlogcheck:74
3771 msgid "Jon Middleton <jjm@debian.org>"
3775 #: dh_installlogrotate:5
3776 msgid "dh_installlogrotate - install logrotate config files"
3780 #: dh_installlogrotate:14
3781 msgid "B<dh_installlogrotate> [S<I<debhelper options>>] [B<--name=>I<name>]"
3785 #: dh_installlogrotate:18
3787 "dh_installlogrotate is a debhelper program that is responsible for "
3788 "installing logrotate config files into etc/logrotate.d in package build "
3789 "directories. Files named debian/package.logrotate are installed."
3793 #: dh_installlogrotate:28
3795 "Look for files named debian/package.name.logrotate and install them as "
3796 "etc/logrotate.d/name, instead of using the usual files and installing them "
3797 "as the package name."
3802 msgid "dh_installman - install man pages into package build directories"
3807 msgid "B<dh_installman> [S<I<debhelper options>>] [S<I<manpage ...>>]"
3813 "dh_installman is a debhelper program that handles installing man pages into "
3814 "the correct locations in package build directories. You tell it what man "
3815 "pages go in your packages, and it figures out where to install them based on "
3816 "the section field in their .TH line. If you have a properly formatted .TH "
3817 "line, your man page will be installed into the right directory, with the "
3818 "right name (this includes proper handling of pages with a subsection, like "
3819 "\"3perl\", which are placed in man3, and given an extension of "
3820 "\".3perl\"). If your .TH line is incorrect or missing, the program may guess "
3821 "wrong based on the file extension."
3827 "It also supports translated man pages, by looking for extensions like .ll.8 "
3828 "and .ll_LL.8, or by use of the --language switch."
3834 "If dh_installman seems to install a man page into the wrong section or with "
3835 "the wrong extension, this is because the man page has the wrong section "
3836 "listed in its .TH line. Edit the man page and correct the section, and "
3837 "dh_installman will follow suit. See L<man(7)> for details about the .TH "
3838 "section. If dh_installman seems to install a man page into a directory like "
3839 "/usr/share/man/pl/man1/, that is because your program has a name like "
3840 "\"foo.pl\", and dh_installman assumes that means it is translated into "
3841 "Polish. Use --language=C to avoid this."
3847 "After the man page installation step, dh_installman will check to see if any "
3848 "of the man pages in the temporary directories of any of the packages it is "
3849 "acting on contain \".so\" links. If so, it changes them to symlinks."
3855 "Also, dh_installman will use man to guess the character encoding of each "
3856 "manual page and convert it to UTF-8. If the guesswork fails for some reason, "
3857 "you can override it using an encoding declaration. See L<manconv(1)> for "
3863 msgid "debian/I<package>.manpages"
3868 msgid "Lists man pages to be installed."
3873 msgid "B<--language>=ll"
3879 "Use this to specify that the man pages being acted on are written in the "
3880 "specified language."
3885 msgid "I<manpage ...>"
3891 "Install these man pages into the first package acted on. (Or in all packages "
3892 "if -A is specified)."
3898 "An older version of this program, L<dh_installmanpages(1)>, is still used by "
3899 "some packages, and so is still included in debhelper. It is, however, "
3900 "deprecated, due to its counterintuitive and inconsistent interface. Use this "
3905 #: dh_installmanpages:5
3906 msgid "dh_installmanpages - old-style man page installer (deprecated)"
3910 #: dh_installmanpages:15
3911 msgid "B<dh_installmanpages> [S<I<debhelper options>>] [S<I<file ...>>]"
3915 #: dh_installmanpages:19
3917 "dh_installmanpages is a debhelper program that is responsible for "
3918 "automatically installing man pages into usr/share/man/ in package build "
3923 #: dh_installmanpages:23
3925 "This is a DWIM-style program, with an interface unlike the rest of "
3926 "debhelper. It is deprecated, and you are encouraged to use "
3927 "L<dh_installman(1)> instead."
3931 #: dh_installmanpages:27
3933 "dh_installmanpages scans the current directory and all subdirectories for "
3934 "filenames that look like man pages. (Note that only real files are looked "
3935 "at; symlinks are ignored.) It uses L<file(1)> to verify that the files are "
3936 "in the correct format. Then, based on the files' extensions, it installs "
3937 "them into the correct man directory."
3941 #: dh_installmanpages:33
3943 "All filenames specified as parameters will be skipped by "
3944 "dh_installmanpages. This is useful if by default it installs some man pages "
3945 "that you do not want to be installed."
3949 #: dh_installmanpages:37
3951 "After the man page installation step, dh_installmanpages will check to see "
3952 "if any of the man pages are \".so\" links. If so, it changes them to "
3957 #: dh_installmanpages:46
3959 "Do not install these files as man pages, even if they look like valid man "
3964 #: dh_installmanpages:51
3969 #: dh_installmanpages:53
3971 "dh_installmanpages will install the man pages it finds into B<all> packages "
3972 "you tell it to act on, since it can't tell what package the man pages belong "
3973 "in. This is almost never what you really want (use -p to work around this, "
3974 "or use the much better L<dh_installman(1)> program instead)."
3978 #: dh_installmanpages:58
3979 msgid "Files ending in I<.man> will be ignored."
3983 #: dh_installmanpages:60
3985 "Files specified as parameters that contain spaces in their filenames will "
3986 "not be processed properly."
3991 msgid "dh_installmenu - install debian menu files into package build directories"
3995 #: dh_installmenu:14
3996 msgid "B<dh_installmenu> [S<B<debhelper options>>] [B<-n>]"
4000 #: dh_installmenu:18
4002 "dh_installmenu is a debhelper program that is responsible for installing "
4003 "files used by the debian menu package into package build directories."
4007 #: dh_installmenu:21
4009 "It also automatically generates the postinst and postrm commands needed to "
4010 "interface with the debian menu package. These commands are inserted into the "
4011 "maintainer scripts by L<dh_installdeb(1)>."
4015 #: dh_installmenu:29
4016 msgid "debian/I<package>.menu"
4020 #: dh_installmenu:31
4022 "Debian menu files, installed into usr/share/menu/I<package> in the package "
4023 "build directory. See L<menufile(5)> for its format."
4027 #: dh_installmenu:34
4028 msgid "debian/I<package>.menu-method"
4032 #: dh_installmenu:36
4034 "Debian menu method files, installed into etc/menu-methods/I<package> in the "
4035 "package build directory."
4039 #: dh_installmenu:47 dh_installmime:47 dh_installmodules:50 dh_installudev:51 dh_makeshlibs:74 dh_python:62
4040 msgid "Do not modify postinst/postrm scripts."
4044 #: dh_installmenu:89
4045 msgid "L<debhelper(7)> L<update-menus(1)> L<menufile(5)>"
4050 msgid "dh_installmime - install mime files into package build directories"
4054 #: dh_installmime:14
4055 msgid "B<dh_installmime> [S<I<debhelper options>>] [B<-n>]"
4059 #: dh_installmime:18
4061 "dh_installmime is a debhelper program that is responsible for installing "
4062 "mime files into package build directories."
4066 #: dh_installmime:21
4068 "It also automatically generates the postinst and postrm commands needed to "
4069 "interface with the debian mime-support and shared-mime-info packages. These "
4070 "commands are inserted into the maintainer scripts by L<dh_installdeb(1)>."
4074 #: dh_installmime:29
4075 msgid "debian/I<package>.mime"
4079 #: dh_installmime:31
4081 "Installed into usr/lib/mime/packages/I<package> in the package build "
4086 #: dh_installmime:34
4087 msgid "debian/I<package>.sharedmimeinfo"
4091 #: dh_installmime:36
4093 "Installed into /usr/share/mime/packages/I<package>.xml in the package build "
4098 #: dh_installmodules:5
4099 msgid "dh_installmodules - register modules with modutils"
4103 #: dh_installmodules:16
4104 msgid "B<dh_installmodules> [S<I<debhelper options>>] [B<-n>] [B<--name=>I<name>]"
4108 #: dh_installmodules:20
4110 "dh_installmodules is a debhelper program that is responsible for registering "
4115 #: dh_installmodules:23
4117 "Kernel modules are searched for in the package build directory and if found, "
4118 "postinst and postrm commands are automatically generated to run depmod and "
4119 "register the modules when the package is installed. These commands are "
4120 "inserted into the maintainer scripts by L<dh_installdeb(1)>."
4124 #: dh_installmodules:33
4125 msgid "debian/I<package>.modprobe"
4129 #: dh_installmodules:35
4130 msgid "Installed to etc/modprobe.d/I<package>.conf in the package build directory."
4134 #: dh_installmodules:37
4135 msgid "debian/I<package>.modules"
4139 #: dh_installmodules:39
4141 "These files were installed for use by modutils, but are now not used and "
4142 "dh_installmodules will warn if these files are present."
4146 #: dh_installmodules:54
4148 "When this parameter is used, dh_installmodules looks for and installs files "
4149 "named debian/I<package>.I<name>.modprobe instead of the usual "
4150 "debian/I<package>.modprobe"
4155 msgid "dh_installpam - install pam support files"
4160 msgid "B<dh_installpam> [S<I<debhelper options>>] [B<--name=>I<name>]"
4166 "dh_installpam is a debhelper program that is responsible for installing "
4167 "files used by PAM into package build directories."
4172 msgid "debian/I<package>.pam"
4177 msgid "Installed into etc/pam.d/I<package> in the package build directory."
4183 "Look for files named debian/I<package>.I<name>.pam and install them as "
4184 "etc/pam.d/I<name>, instead of using the usual files and installing them "
4185 "using the package name."
4190 msgid "dh_installppp - install ppp ip-up and ip-down files"
4195 msgid "B<dh_installppp> [S<I<debhelper options>>] [B<--name=>I<name>]"
4201 "dh_installppp is a debhelper program that is responsible for installing ppp "
4202 "ip-up and ip-down scripts into package build directories."
4207 msgid "debian/I<package>.ppp.ip-up"
4212 msgid "Installed into etc/ppp/ip-up.d/I<package> in the package build directory."
4217 msgid "debian/I<package>.ppp.ip-down"
4222 msgid "Installed into etc/ppp/ip-down.d/I<package> in the package build directory."
4228 "Look for files named debian/package.name.ppp.ip-* and install them as "
4229 "etc/ppp/ip-*/name, instead of using the usual files and installing them as "
4235 msgid "dh_installudev - install udev rules files"
4239 #: dh_installudev:15
4241 "B<dh_installudev> [S<I<debhelper options>>] [B<-n>] [B<--name=>I<name>] "
4242 "[B<--priority=>I<priority>]"
4246 #: dh_installudev:19
4248 "dh_installudev is a debhelper program that is responsible for installing "
4253 #: dh_installudev:22
4255 "Code is added to the preinst and postinst to handle the upgrade from the old "
4256 "udev rules file location."
4260 #: dh_installudev:29
4261 msgid "debian/I<package>.udev"
4265 #: dh_installudev:31
4266 msgid "Installed into lib/udev/rules.d/ in the package build directory."
4270 #: dh_installudev:41
4272 "When this parameter is used, dh_installudev looks for and installs files "
4273 "named debian/I<package>.I<name>.udev instead of the usual "
4274 "debian/I<package>.udev."
4278 #: dh_installudev:45
4279 msgid "B<--priority=>I<priority>"
4283 #: dh_installudev:47
4284 msgid "Sets the priority string of the rules.d symlink. Default is 60."
4289 msgid "dh_installwm - register a window manager"
4295 "B<dh_installwm> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] "
4302 "dh_installwm is a debhelper program that is responsible for generating the "
4303 "postinst and postrm commands that register a window manager with "
4304 "L<update-alternatives(8)>. The window manager's man page is also registered "
4305 "as a slave symlink (in v6 mode and up), if it is found in "
4306 "usr/share/man/man1/ in the package build directory."
4311 msgid "debian/I<package>.wm"
4316 msgid "List window manager programs to register."
4322 "Set the priority of the window manager. Default is 20, which is too low for "
4323 "most window managers; see the Debian Policy document for instructions on "
4324 "calculating the correct value."
4329 msgid "Do not modify postinst/postrm scripts. Turns this command into a no-op."
4339 msgid "Window manager programs to register."
4343 #: dh_installxfonts:5
4344 msgid "dh_installxfonts - register X fonts"
4348 #: dh_installxfonts:14
4349 msgid "B<dh_installxfonts> [S<I<debhelper options>>]"
4353 #: dh_installxfonts:18
4355 "dh_installxfonts is a debhelper program that is responsible for registering "
4356 "X fonts, so their corresponding fonts.dir, fonts.alias, and fonts.scale be "
4357 "rebuilt properly at install time."
4361 #: dh_installxfonts:22
4363 "Before calling this program, you should have installed any X fonts provided "
4364 "by your package into the appropriate location in the package build "
4365 "directory, and if you have fonts.alias or fonts.scale files, you should "
4366 "install them into the correct location under etc/X11/fonts in your package "
4371 #: dh_installxfonts:28
4373 "Your package should depend on xfonts-utils so that the update-fonts-* "
4374 "commands are available. (This program adds that dependency to "
4379 #: dh_installxfonts:32
4381 "This program automatically generates the postinst and postrm commands needed "
4382 "to register X fonts. These commands are inserted into the maintainer scripts "
4383 "by dh_installdeb. See L<dh_installdeb(1)> for an explanation of how this "
4388 #: dh_installxfonts:39
4390 "See L<update-fonts-alias(8)>, L<update-fonts-scale(8)>, and "
4391 "L<update-fonts-dir(8)> for more information about X font installation."
4395 #: dh_installxfonts:42
4397 "See Debian policy, section 11.8.5. for details about doing fonts the Debian "
4403 msgid "dh_link - create symlinks in package build directories"
4409 "B<dh_link> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] [S<I<source "
4410 "destination ...>>]"
4416 "dh_link is a debhelper program that creates symlinks in package build "
4423 "dh_link accepts a list of pairs of source and destination files. The source "
4424 "files are the already existing files that will be symlinked from. The "
4425 "destination files are the symlinks that will be created. There B<must> be an "
4426 "equal number of source and destination files specified."
4432 "Be sure you B<do> specify the full filename to both the source and "
4433 "destination files (unlike you would do if you were using something like "
4440 "dh_link will generate symlinks that comply with debian policy - absolute "
4441 "when policy says they should be absolute, and relative links with as short a "
4442 "path as possible. It will also create any subdirectories it needs to to put "
4449 "dh_link also scans the package build tree for existing symlinks which do not "
4450 "conform to debian policy, and corrects them (v4 or later)."
4455 msgid "debian/I<package>.links"
4461 "Lists pairs of source and destination files to be symlinked. Each pair "
4462 "should be put on its own line, with the source and destination separated by "
4469 "Create any links specified by command line parameters in ALL packages acted "
4470 "on, not just the first."
4476 "Do not correct symlinks that contain \"item\" anywhere in their filename "
4477 "from being corrected to comply with debian policy."
4482 msgid "I<source destination ...>"
4488 "Create a file named \"destination\" as a link to a file named \"source\". Do "
4489 "this in the package build directory of the first package acted on. (Or in "
4490 "all packages if -A is specified.)"
4497 " dh_link usr/share/man/man1/foo.1 usr/share/man/man1/bar.1\n"
4503 msgid "Make bar.1 be a symlink to foo.1"
4510 " dh_link var/lib/foo usr/lib/foo \\\n"
4511 " usr/share/man/man1/foo.1 usr/share/man/man1/bar.1\n"
4518 "Make /usr/lib/foo/ be a link to /var/lib/foo/, and bar.1 be a symlink to the "
4524 msgid "dh_lintian - install lintian override files into package build directories"
4529 msgid "B<dh_lintian> [S<I<debhelper options>>]"
4535 "dh_lintian is a debhelper program that is responsible for installing "
4536 "override files used by lintian into package build directories."
4541 msgid "debian/I<package>.lintian-overrides"
4547 "Installed into usr/share/lintian/overrides/I<package> in the package build "
4548 "directory. This file is used to suppress erroneous lintian diagnostics."
4553 msgid "debian/source.lintian-overrides"
4559 "These files are not installed, but will be scanned by lintian to provide "
4560 "overrides for the source package."
4565 msgid "L<lintian(1)>"
4570 msgid "Steve Robbins <smr@debian.org>"
4574 #: dh_listpackages:5
4575 msgid "dh_listpackages - list binary packages debhelper will act on"
4579 #: dh_listpackages:14
4580 msgid "B<dh_listpackages> [S<I<debhelper options>>]"
4584 #: dh_listpackages:18
4586 "dh_listpackages is a debhelper program that outputs a list of all binary "
4587 "packages debhelper commands will act on. If you pass it some options, it "
4588 "will change the list to match the packages other debhelper commands would "
4589 "act on if passed the same options."
4594 msgid "dh_makeshlibs - automatically create shlibs file and call dpkg-gensymbols"
4600 "B<dh_makeshlibs> [S<I<debhelper options>>] [B<-m>I<major>] "
4601 "[B<-V>I<[dependencies]>] [B<-n>] [B<-X>I<item>] [S<B<--> I<params>>]"
4607 "dh_makeshlibs is a debhelper program that automatically scans for shared "
4608 "libraries, and generates a shlibs file for the libraries it finds."
4614 "It also adds a call to ldconfig in the postinst and postrm scripts (in V3 "
4615 "mode and above only) to any packages in which it finds shared libraries."
4620 msgid "debian/I<package>.symbols"
4625 msgid "debian/I<package>.symbols.I<arch>"
4631 "These symbols files, if present, are passed to L<dpkg-gensymbols(1)> to be "
4632 "processed and installed. Use the I<arch> specific names if you need to "
4633 "provide different symbols files for different architectures."
4638 msgid "B<-m>I<major>, B<--major=>I<major>"
4644 "Instead of trying to guess the major number of the library with objdump, use "
4645 "the major number specified after the -m parameter. This is much less useful "
4646 "than it used to be, back in the bad old days when this program looked at "
4647 "library filenames rather than using objdump."
4652 msgid "B<-V>, B<-V>I<dependencies>"
4657 msgid "B<--version-info>, B<--version-info=>I<dependencies>"
4663 "By default, the shlibs file generated by this program does not make packages "
4664 "depend on any particular version of the package containing the shared "
4665 "library. It may be necessary for you to add some version dependancy "
4666 "information to the shlibs file. If -V is specified with no dependency "
4667 "information, the current upstream version of the package is plugged into a "
4668 "dependency that looks like \"packagename (>= packageversion)\". Note that in "
4669 "debhelper compatibility levels before v4, the debian part of the package "
4670 "version number is also included. If -V is specified with parameters, the "
4671 "parameters can be used to specify the exact dependency information needed "
4672 "(be sure to include the package name)."
4678 "Beware of using -V without any parameters; this is a conservative setting "
4679 "that always ensures that other packages' shared library dependencies are at "
4680 "least as tight as they need to be (unless your library is prone to changing "
4681 "ABI without updating the upstream version number), so that if the maintainer "
4682 "screws up then they won't break. The flip side is that packages might end up "
4683 "with dependencies that are too tight and so find it harder to be upgraded."
4689 "Exclude files that contain \"item\" anywhere in their filename or directory "
4690 "from being treated as shared libraries."
4695 msgid "B<--add-udeb=>I<udeb>"
4701 "Create an additional line for udebs in the shlibs file and use \"udeb\" as "
4702 "the package name for udebs to depend on instead of the regular library "
4708 msgid "Pass \"params\" to L<dpkg-gensymbols(1)>."
4713 msgid "dh_makeshlibs"
4720 "Assuming this is a package named libfoobar1, generates a shlibs file that\n"
4721 "looks something like:\n"
4722 " libfoobar 1 libfoobar1\n"
4727 #: dh_makeshlibs:102
4728 msgid "dh_makeshlibs -V"
4732 #: dh_makeshlibs:104
4735 "Assuming the current version of the package is 1.1-3, generates a shlibs\n"
4736 "file that looks something like:\n"
4737 " libfoobar 1 libfoobar1 (>= 1.1)\n"
4742 #: dh_makeshlibs:108
4743 msgid "dh_makeshlibs -V 'libfoobar1 (>= 1.0)'"
4747 #: dh_makeshlibs:110
4750 "Generates a shlibs file that looks something like:\n"
4751 " libfoobar 1 libfoobar1 (>= 1.0)\n"
4757 msgid "dh_md5sums - generate DEBIAN/md5sums file"
4763 "B<dh_md5sums> [S<I<debhelper options>>] [B<-x>] [B<-X>I<item>] "
4764 "[B<--include-conffiles>]"
4770 "dh_md5sums is a debhelper program that is responsible for generating a "
4771 "DEBIAN/md5sums file, which lists the md5sums of each file in the package. "
4772 "These files are used by the debsums package."
4778 "All files in DEBIAN/ are omitted from the md5sums file, as are all conffiles "
4779 "(unless you use the --include-conffiles switch)."
4784 msgid "The md5sums file is installed with proper permissions and ownerships."
4789 msgid "B<-x>, B<--include-conffiles>"
4795 "Include conffiles in the md5sums list. Note that this information is "
4796 "redundant since it is included elsewhere in debian packages."
4802 "Exclude files that contain \"item\" anywhere in their filename from being "
4803 "listed in the md5sums file."
4808 msgid "dh_movefiles - move files out of debian/tmp into subpackages"
4814 "B<dh_movefiles> [S<I<debhelper options>>] [B<--sourcedir=>I<dir>] "
4815 "[B<-X>I<item>] S<I<file ...>>]"
4821 "dh_movefiles is a debhelper program that is responsible for moving files out "
4822 "of debian/tmp or some other directory and into other package build "
4823 "directories. This may be useful if your package has a Makefile that installs "
4824 "everything into debian/tmp, and you need to break that up into subpackages."
4830 "Note: dh_install is a much better program, and you are recommended to use it "
4831 "instead of dh_movefiles."
4836 msgid "debian/I<package>.files"
4842 "Lists the files to be moved into a package, separated by whitespace. The "
4843 "filenames listed should be relative to debian/tmp/. You can also list "
4844 "directory names, and the whole directory will be moved."
4849 msgid "B<--sourcedir=>I<dir>"
4855 "Instead of moving files out of debian/tmp (the default), this option makes "
4856 "it move files out of some other directory. Since the entire contents of the "
4857 "sourcedir is moved, specifying something like --sourcedir=/ is very unsafe, "
4858 "so to prevent mistakes, the sourcedir must be a relative filename; it cannot "
4865 "Lists files to move. The filenames listed should be relative to "
4866 "debian/tmp/. You can also list directory names, and the whole directory will "
4867 "be moved. It is an error to list files here unless you use -p, -i, or -a to "
4868 "tell dh_movefiles which subpackage to put them in."
4874 "Note that files are always moved out of debian/tmp by default (even if you "
4875 "have instructed debhelper to use a compatibility level higher than one, "
4876 "which does not otherwise use debian/tmp for anything at all). The idea "
4877 "behind this is that the package that is being built can be told to install "
4878 "into debian/tmp, and then files can be moved by dh_movefiles from that "
4879 "directory. Any files or directories that remain are ignored, and get deleted "
4880 "by dh_clean later."
4885 msgid "dh_perl - calculates perl dependencies and cleans up after MakeMaker"
4890 msgid "B<dh_perl> [S<I<debhelper options>>] [B<-d>] [S<I<library dirs ...>>]"
4896 "dh_perl is a debhelper program that is responsible for generating the "
4897 "${perl:Depends} substitutions and adding them to substvars files."
4903 "The program will look at perl scripts and modules in your package, and will "
4904 "use this information to generate a dependency on perl or perlapi. The "
4905 "dependency will be substituted into your package's control file wherever you "
4906 "place the token \"${perl:Depends}\"."
4912 "dh_perl also cleans up empty directories that MakeMaker can generate when "
4913 "installing perl modules."
4924 "In some specific cases you may want to depend on perl-base rather than the "
4925 "full perl package. If so, you can pass the -d option to make dh_perl "
4926 "generate a dependency on the correct base package. This is only necessary "
4927 "for some packages that are included in the base system."
4933 "Note that this flag may cause no dependency on perl-base to be generated at "
4934 "all. perl-base is Essential, so its dependency can be left out, unless a "
4935 "versioned dependency is needed."
4946 "By default, scripts and architecture independent modules don't depend on any "
4947 "specific version of perl. The -V option causes the current version of the "
4948 "perl (or perl-base with -d) package to be specified."
4953 msgid "I<library dirs>"
4959 "If your package installs perl modules in non-standard directories, you can "
4960 "make dh_perl check those directories by passing their names on the command "
4961 "line. It will only check the vendorlib and vendorarch directories by "
4967 msgid "Debian policy, version 3.8.3"
4972 msgid "Perl policy, version 1.20"
4977 msgid "Brendan O'Dea <bod@debian.org>"
4982 msgid "dh_prep - perform cleanups in preparation for building a binary package"
4987 msgid "B<dh_prep> [S<I<debhelper options>>] [B<-X>I<item>]"
4993 "dh_prep is a debhelper program that performs some file cleanups in "
4994 "preparation for building a binary package. (This is what dh_clean -k used to "
4995 "do.) It removes the package build directories, debian/tmp, and some temp "
4996 "files that are generated when building a binary package."
5002 "It is typically run at the top of the binary-arch and binary-indep targets, "
5003 "or at the top of a target such as install that they depend on."
5009 "dh_python - calculates python dependencies and adds postinst and prerm "
5010 "python scripts (deprecated)"
5016 "B<dh_python> [S<I<debhelper options>>] [B<-n>] [B<-V> I<version>] "
5017 "[S<I<module dirs ...>>]"
5023 "Note: This program is deprecated. You should use dh_pysupport or "
5024 "dh_pycentral instead. This program will do nothing if debian/pycompat or a "
5025 "Python-Version control file field exists."
5031 "dh_python is a debhelper program that is responsible for generating the "
5032 "${python:Depends} substitutions and adding them to substvars files. It will "
5033 "also add a postinst and a prerm script if required."
5039 "The program will look at python scripts and modules in your package, and "
5040 "will use this information to generate a dependency on python, with the "
5041 "current major version, or on pythonX.Y if your scripts or modules need a "
5042 "specific python version. The dependency will be substituted into your "
5043 "package's control file wherever you place the token \"${python:Depends}\"."
5049 "If some modules need to be byte-compiled at install time, appropriate "
5050 "postinst and prerm scripts will be generated. If already byte-compiled "
5051 "modules are found, they are removed."
5056 msgid "If you use this program, your package should build-depend on python."
5061 msgid "I<module dirs>"
5067 "If your package installs python modules in non-standard directories, you can "
5068 "make dh_python check those directories by passing their names on the command "
5069 "line. By default, it will check /usr/lib/site-python, /usr/lib/$PACKAGE, "
5070 "/usr/share/$PACKAGE, /usr/lib/games/$PACKAGE, /usr/share/games/$PACKAGE and "
5071 "/usr/lib/python?.?/site-packages."
5077 "Note: only /usr/lib/site-python, /usr/lib/python?.?/site-packages and the "
5078 "extra names on the command line are searched for binary (.so) modules."
5083 msgid "B<-V> I<version>"
5089 "If the .py files your package ships are meant to be used by a specific "
5090 "pythonX.Y version, you can use this option to specify the desired version, "
5091 "such as 2.3. Do not use if you ship modules in /usr/lib/site-python."
5096 msgid "Debian policy, version 3.5.7"
5101 msgid "Python policy, version 0.3.7"
5106 msgid "Josselin Mouette <joss@debian.org>"
5111 msgid "most ideas stolen from Brendan O'Dea <bod@debian.org>"
5115 #: dh_scrollkeeper:5
5116 msgid "dh_scrollkeeper - deprecated no-op"
5120 #: dh_scrollkeeper:14
5121 msgid "B<dh_scrollkeeper> [S<I<debhelper options>>] [B<-n>] [S<I<directory>>]"
5125 #: dh_scrollkeeper:18
5127 "dh_scrollkeeper was a debhelper program that handled registering OMF files "
5128 "for ScrollKeeper. However, it no longer does anything, and is now "
5134 msgid "dh_shlibdeps - calculate shared library dependencies"
5140 "B<dh_shlibdeps> [S<I<debhelper options>>] [B<-L>I<package>] "
5141 "[B<-l>I<directory>] [B<-X>I<item>] [S<B<--> I<params>>]"
5147 "dh_shlibdeps is a debhelper program that is responsible for calculating "
5148 "shared library dependencies for packages."
5154 "This program is merely a wrapper around L<dpkg-shlibdeps(1)> that calls it "
5155 "once for each package listed in the control file, passing it a list of ELF "
5156 "executables and shared libraries it has found."
5162 "Exclude files that contain \"item\" anywhere in their filename from being "
5163 "passed to dpkg-shlibdeps. This will make their dependencies be ignored. "
5164 "This may be useful in some situations, but use it with caution. This option "
5165 "may be used more than once to exclude more than one thing."
5170 msgid "Pass \"params\" to L<dpkg-shlibdeps(1)>."
5175 msgid "B<-u>I<params>, B<--dpkg-shlibdeps-params=>I<params>"
5180 msgid "B<-l>I<directory>[:directory:directory:..]"
5185 msgid "With recent versions of dpkg-shlibdeps, this option is generally not needed."
5191 "Before dpkg-shlibdeps is run, LD_LIBRARY_PATH will have added to it the "
5192 "specified directory (or directories -- separate with colons). With recent "
5193 "versions of dpkg-shlibdeps, this is mostly only useful for packages that "
5194 "build multiple flavors of the same library, or other situations where the "
5195 "library is installed into a directory not on the regular library search "
5201 msgid "B<-L>I<package>, B<--libpackage=>I<package>"
5207 "With recent versions of dpkg-shlibdeps, this option is generally not needed, "
5208 "unless your package builds multiple flavors of the same library."
5214 "It tells dpkg-shlibdeps (via its -S parameter) to look first in the package "
5215 "build directory for the specified package, when searching for libraries, "
5216 "symbol files, and shlibs files."
5222 "Suppose that your source package produces libfoo1, libfoo-dev, and "
5223 "libfoo-bin binary packages. libfoo-bin links against libfoo1, and should "
5224 "depend on it. In your rules file, first run dh_makeshlibs, then "
5240 "This will have the effect of generating automatically a shlibs file for "
5241 "libfoo1, and using that file and the libfoo1 library in the "
5242 "debian/libfoo1/usr/lib directory to calculate shared library dependency "
5249 "If a libbar1 package is also produced, that is an alternate build of libfoo, "
5250 "and is installed into /usr/lib/bar/, you can make libfoo-bin depend on "
5251 "libbar1 as follows:"
5258 "\tdh_shlibdeps -Llibbar1 -l/usr/lib/bar\n"
5264 msgid "L<debhelper(7)>, L<dpkg-shlibdeps(1)>"
5269 msgid "dh_strip - strip executables, shared libraries, and some static libraries"
5275 "B<dh_strip> [S<I<debhelper options>>] [B<-X>I<item>] [--dbg-package=package] "
5282 "dh_strip is a debhelper program that is responsible for stripping "
5283 "executables, shared libraries, and static libraries that are not used for "
5290 "This program examines your package build directories and works out what to "
5291 "strip on its own. It uses L<file(1)> and file permissions and filenames to "
5292 "figure out what files are shared libraries (*.so), executable binaries, and "
5293 "static (lib*.a) and debugging libraries (lib*_g.a, debug/*.so), and strips "
5294 "each as much as is possible. (Which is not at all for debugging libraries.) "
5295 "In general it seems to make very good guesses, and will do the right thing "
5296 "in almost all cases."
5302 "Since it is very hard to automatically guess if a file is a module, and hard "
5303 "to determine how to strip a module, dh_strip does not currently deal with "
5304 "stripping binary modules such as .o files."
5310 "Exclude files that contain \"item\" anywhere in their filename from being "
5311 "stripped. You may use this option multiple times to build up a list of "
5312 "things to exclude."
5317 msgid "B<--dbg-package=>I<package>"
5323 "Causes dh_strip to save debug symbols stripped from the packages it acts on "
5324 "as independent files in the package build directory of the specified "
5325 "debugging package."
5331 "For example, if your packages are libfoo and foo and you want to include a "
5332 "foo-dbg package with debugging symbols, use dh_strip --dbg-package=foo-dbg."
5338 "Note that this option behaves significantly different in debhelper "
5339 "compatibility levels 4 and below. Instead of specifying the name of a debug "
5340 "package to put symbols in, it specifies a package (or packages) which should "
5341 "have separated debug symbols, and the separated symbols are placed in "
5342 "packages with \"-dbg\" added to their name."
5347 msgid "B<-k>, B<--keep-debug>"
5353 "Debug symbols will be retained, but split into an independent file in "
5354 "usr/lib/debug/ in the package build directory. --dbg-package is easier to "
5355 "use than this option, but this option is more flexible."
5361 "If the DEB_BUILD_OPTIONS environment variable contains \"nostrip\", nothing "
5362 "will be stripped, in accordance with Debian policy (section 10.1 "
5368 msgid "Debian policy, version 3.0.1"
5372 #: dh_suidregister:5
5373 msgid "dh_suidregister - suid registration program (deprecated)"
5377 #: dh_suidregister:9 dh_undocumented:14
5382 #: dh_suidregister:13
5384 "This program used to register suid and sgid files with L<suidregister(1)>, "
5385 "but with the introduction of L<dpkg-statoverride(8)>, registration of files "
5386 "in this way is unnecessary, and even harmful, so this program is deprecated "
5387 "and should not be used."
5391 #: dh_suidregister:18
5392 msgid "CONVERTING TO STATOVERRIDE"
5396 #: dh_suidregister:20
5398 "Converting a package that uses this program to use the new statoverride "
5399 "mechanism is easy. Just remove the call to dh_suidregister from "
5400 "debian/rules, and add a versioned conflicts into your control file, as "
5405 #: dh_suidregister:25
5408 " Conflicts: suidmanager (<< 0.50)\n"
5413 #: dh_suidregister:27
5415 "The conflicts is only necessary if your package used to register things with "
5416 "suidmanager; if it did not, you can just remove the call to this program "
5417 "from your rules file."
5422 msgid "dh_testdir - test directory before building debian package"
5427 msgid "B<dh_testdir> [S<I<debhelper options>>] [S<I<file ...>>]"
5433 "dh_testdir tries to make sure that you are in the correct directory when "
5434 "building a debian package. It makes sure that the file debian/control "
5435 "exists, as well as any other files you specify. If not, it exits with an "
5441 msgid "Test for the existence of these files too."
5446 msgid "dh_testroot - ensure that a package is built as root"
5451 msgid "B<dh_testroot> [S<I<debhelper options>>]"
5457 "dh_testroot simply checks to see if you are root. If not, it exits with an "
5458 "error. Debian packages must be built as root, though you can use "
5465 "dh_testversion - ensure that the correct version of debhelper is installed "
5470 #: dh_testversion:14
5471 msgid "B<dh_testversion> [S<I<debhelper options>>] [I<operator>] [I<version>]"
5475 #: dh_testversion:18
5476 msgid "Note: This program is deprecated. You should use build dependencies instead."
5480 #: dh_testversion:21
5482 "dh_testversion compares the version of debhelper against the version you "
5483 "specify, and if the condition is not met, exits with an error message."
5487 #: dh_testversion:24
5489 "You can use this in your debian/rules files if a new debhelper feature is "
5490 "introduced, and your package requires that feature to build correctly. Use "
5491 "debhelper's changelog to figure out the version you need."
5495 #: dh_testversion:28
5497 "Be sure not to overuse dh_testversion. If debhelper version 9.5 introduces a "
5498 "new dh_autofixbugs command, and your package uses it, then if someone tries "
5499 "to build it with debhelper 1.0, the build will fail anyway when "
5500 "dh_autofixbugs cannot be found, so there is no need for you to use "
5505 #: dh_testversion:38
5510 #: dh_testversion:40
5512 "Optional comparison operator used in comparing the versions. If not "
5513 "specified, \">=\" is used. For descriptions of the comparison operators, see "
5518 #: dh_testversion:44
5523 #: dh_testversion:46
5525 "Version number to compare against the current version of debhelper. If not "
5526 "specified, dh_testversion does nothing."
5530 #: dh_undocumented:5
5531 msgid "dh_undocumented - undocumented.7 symlink program (deprecated no-op)"
5535 #: dh_undocumented:18
5537 "This program used to make symlinks to the undocumented.7 man page for man "
5538 "pages not present in a package. Debian policy now frowns on use of the "
5539 "undocumented.7 man page, and so this program does nothing, and should not be "
5545 msgid "dh_usrlocal - migrate usr/local directories to maintainer scripts"
5550 msgid "B<dh_usrlocal> [S<I<debhelper options>>] [B<-n>]"
5556 "dh_usrlocal is a debhelper program that can be used for building packages "
5557 "that will provide a subdirectory in /usr/local when installed."
5563 "It finds subdirectories of usr/local in the package build directory, and "
5564 "removes them, replacing them with maintainer script snippets (unless B<-n> "
5565 "is used) to create the directories at install time, and remove them when the "
5566 "package is removed, in a manner compliant with Debian policy. These snippets "
5567 "are inserted into the maintainer scripts by dh_installdeb. See "
5568 "L<dh_installdeb(1)> for an explanation of Debhelper maintainer script "
5575 "If the directories found in the build tree have unusual owners, groups, or "
5576 "permissions, then those values will be preserved in the directories made by "
5577 "the postinst script. However, as a special exception, if a directory is "
5578 "owned by root.root, it will be treated as if it is owned by root.staff and "
5579 "is mode 2775. This is useful, since that is the group and mode policy "
5580 "recommends for directories in /usr/local."
5585 msgid "Do not modify F<postinst>/F<prerm> scripts."
5590 msgid "Debian policy, version 2.2"
5595 msgid "Andrew Stribblehill <ads@debian.org>"