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: 2009-08-26 17:10-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_builddeb:3 dh_clean:3 dh_compress:3 dh_desktop:3 dh_fixperms:3 dh_gconf:3 dh_gencontrol:3 dh_installcatalogs:3 dh_installchangelogs:3 dh_installcron:3 dh_installdebconf:3 dh_installdeb:3 dh_installdirs:3 dh_installdocs:3 dh_installemacsen:3 dh_installexamples:3 dh_installinfo:3 dh_installinit:3 dh_installlogcheck:3 dh_installlogrotate:3 dh_installmanpages:3 dh_installman:3 dh_installmenu:3 dh_installmime:3 dh_installmodules:3 dh_installpam:3 dh_install:3 dh_installppp:3 dh_installwm:3 dh_installxfonts:3 dh_link:3 dh_listpackages:3 dh_makeshlibs:3 dh_md5sums:3 dh_movefiles:3 dh_perl: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_builddeb:12 dh_clean:12 dh_compress:13 dh_desktop:12 dh_fixperms:12 dh_gconf:12 dh_gencontrol:12 dh_installcatalogs:14 dh_installchangelogs:12 dh_installcron:12 dh_installdebconf:12 dh_installdeb:12 dh_installdirs:12 dh_installdocs:12 dh_installemacsen:12 dh_installexamples:12 dh_installinfo:12 dh_installinit:12 dh_installlogcheck:12 dh_installlogrotate:12 dh_installmanpages:13 dh_installman:13 dh_installmenu:12 dh_installmime:12 dh_installmodules:14 dh_installpam:12 dh_install:13 dh_installppp:12 dh_installwm:12 dh_installxfonts:12 dh_link:13 dh_listpackages:12 dh_makeshlibs:12 dh_md5sums:13 dh_movefiles:12 dh_perl:14 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_builddeb:16 dh_clean:16 dh_compress:17 dh_desktop:16 dh_fixperms:16 dh_gconf:16 dh_gencontrol:16 dh_installcatalogs:18 dh_installchangelogs:16 dh_installcron:16 dh_installdebconf:16 dh_installdeb:16 dh_installdirs:16 dh_installdocs:16 dh_installemacsen:16 dh_installexamples:16 dh_installinfo:16 dh_installinit:16 dh_installlogcheck:16 dh_installlogrotate:16 dh_installmanpages:17 dh_installman:17 dh_installmenu:16 dh_installmime:16 dh_installmodules:18 dh_installpam:16 dh_install:17 dh_installppp:16 dh_installwm:16 dh_installxfonts:16 dh_link:17 dh_listpackages:16 dh_makeshlibs:16 dh_md5sums:17 dh_movefiles:16 dh_perl:18 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 complete list of available debhelper commands. See their man "
84 "pages for additional documentation."
95 "If a program's name starts with \"dh_\", and the program is not on the above "
96 "list, then it is not part of the debhelper package, but it should still work "
97 "like the other programs described on this page."
102 msgid "DEBHELPER CONFIG FILES"
108 "Many debhelper commands make use of files in F<debian/> to control what they "
109 "do. Besides the common F<debian/changelog> and F<debian/control>, which are "
110 "in all packages, not just those using debhelper, some additional files can "
111 "be used to configure the behavior of specific debhelper commands. These "
112 "files are typically named debian/package.foo (where \"package\" of course, "
113 "is replaced with the package that is being acted on)."
119 "For example, dh_installdocs uses files named debian/package.docs to list the "
120 "documentation files it will install. See the man pages of individual "
121 "commands for details about the names and formats of the files they use. "
122 "Generally, these files will list files to act on, one file per line. Some "
123 "programs in debhelper use pairs of files and destinations or slightly more "
124 "complicated formats."
130 "Note that if a package is the first (or only) binary package listed in "
131 "debian/control, debhelper will use debian/foo if no debian/package.foo file "
138 "In some rare cases, you may want to have different versions of these files "
139 "for different architectures or OSes. If files named debian/package.foo.ARCH "
140 "or debian/package.foo.OS exist, where \"ARCH\" and \"OS\" are the same as "
141 "the output of \"dpkg-architecture -qDEB_HOST_ARCH\" / \"dpkg-architecture "
142 "-qDEB_HOST_ARCH_OS\", then they will be used in preference to other, more "
149 "In many cases, these config files are used to specify various types of "
150 "files. Documentation or example files to install, files to move, and so on. "
151 "When appropriate, in cases like these, you can use standard shell wildcard "
152 "characters ('?' and '*' and '[..]' character classes) in the files."
158 "You can also put comments in these files; lines beginning with \"#\" are "
164 msgid "SHARED DEBHELPER OPTIONS"
169 msgid "The following command line options are supported by all debhelper programs."
174 msgid "B<-v>, B<--verbose>"
179 msgid "Verbose mode: show all commands that modify the package build directory."
190 "Do not really do anything. If used with -v, the result is that the command "
191 "will output what it would have done."
196 msgid "B<-a>, B<--arch>"
201 msgid "Act on all architecture dependent packages."
206 msgid "B<-i>, B<--indep>"
211 msgid "Act on all architecture independent packages."
216 msgid "B<->I<ppackage>, B<--package=>I<package>"
222 "Act on the package named \"package\". This option may be specified multiple "
223 "times to make debhelper operate on a given set of packages."
228 msgid "B<-s>, B<--same-arch>"
234 "This is a smarter version of the -a flag, that is used in some rare "
235 "circumstances. It understands that if the control file lists \"Architecture: "
236 "i386\" for the package, the package should not be acted on on other "
237 "architectures. So this flag makes the command act on all \"Architecture: "
238 "any\" packages, as well as on any packages that have the current "
239 "architecture explicitly specified. Contrast to the -a flag, which makes the "
240 "command work on all packages that are not architecture independent."
245 msgid "B<-N>I<package>, B<--no-package=>I<package>"
251 "Do not act on the specified package even if an -a, -i, or -p option lists "
252 "the package as one that should be acted on."
257 msgid "B<--remaining-packages>"
263 "Do not act on the packages which have already been acted on by this "
264 "debhelper command earlier (i.e. if the command is present in the package "
265 "debhelper log). For example, if you need to call the command with special "
266 "options only for a couple of binary packages, pass this option to the last "
267 "call of the command to process the rest of packages with default settings."
272 msgid "B<--ignore=>I<file>"
278 "Ignore the specified file. This can be used if debian/ contains a debhelper "
279 "config file that a debhelper command should not act on. Note that "
280 "debian/compat, debian/control, and debian/changelog can't be ignored, but "
281 "then, there should never be a reason to ignore those files."
287 "For example, if upstream ships a debian/init that you don't want "
288 "dh_installinit to install, use --ignore=debian/init"
293 msgid "B<-P>I<tmpdir>, B<--tmpdir=>I<tmpdir>"
298 msgid "Use \"tmpdir\" for package build directory. The default is debian/<package>"
303 msgid "B<--mainpackage=>I<package>"
309 "This little-used option changes the package which debhelper considers the "
310 "\"main package\", that is, the first one listed in debian/control, and the "
311 "one for which debian/foo files can be used instead of the usual "
312 "debian/package.foo files."
317 msgid "COMMON DEBHELPER OPTIONS"
323 "The following command line options are supported by some debhelper "
324 "programs. See the man page of each program for a complete explanation of "
325 "what each option does."
335 msgid "Do not modify postinst/postrm/etc scripts."
339 #: debhelper.pod:165 dh_compress:43 dh_makeshlibs:66 dh_md5sums:37 dh_shlibdeps:36 dh_strip:39
340 msgid "B<-X>I<item>, B<--exclude=>I<item>"
346 "Exclude an item from processing. This option may be used multiple times, to "
347 "exclude more than one thing."
351 #: debhelper.pod:170 dh_compress:51 dh_installdirs:32 dh_installdocs:53 dh_installexamples:33 dh_installinfo:32 dh_installman:62 dh_link:52
352 msgid "B<-A>, B<--all>"
358 "Makes files or other items that are specified on the command line take "
359 "effect in ALL packages acted on, not just the first."
364 msgid "BUILD SYSTEM OPTIONS"
370 "The following command line options are supported by all of the dh_auto_* "
371 "debhelper programs. These programs support a variety of build systems, and "
372 "normally heuristically determine which to use, and how to use them. You can "
373 "use these command line options to override the default behavior."
378 msgid "B<-S>I<buildsystem>, B<--buildsystem=>I<buildsystem>"
384 "Force use of the specified I<buildsystem>, instead of trying to auto-select "
385 "one which might be applicable for the package."
390 msgid "B<-D>I<directory>, B<--sourcedirectory=>I<directory>"
396 "Assume that the original package source tree is at the specified "
397 "I<directory> rather than the top level directory of the Debian source "
403 msgid "B<-B>[I<directory>], B<--builddirectory>=[I<directory>]"
409 "Enable out of source building and use the specified I<directory> as the "
410 "build directory. If I<directory> parameter is omitted, a default build "
411 "directory will chosen."
417 "If this option is not specified, building will be done in source by default "
418 "unless the build system requires or prefers out of source tree building. In "
419 "such a case, the default build directory will be used even if "
420 "L<--builddirectory> is not specified."
426 "If the build system prefers out of source tree building but still allows in "
427 "source building, the latter can be re-enabled by passing a build directory "
428 "path that is the same as the source directory path."
433 msgid "B<--list>, B<-l>"
439 "List all build systems supported by debhelper on this system. The list "
440 "includes both default and third party build systems (marked as such). Also "
441 "shows which build system would be automatically selected, or which one is "
442 "manually specified with the I<--buildsystem> option."
446 #: debhelper.pod:221 dh_installcatalogs:52 dh_installdocs:81 dh_installemacsen:54 dh_installexamples:50 dh_installinit:110 dh_installman:79 dh_installmime:41 dh_installmodules:60 dh_installwm:53 dh_installxfonts:37 dh_movefiles:58 dh_strip:68 dh_usrlocal:49
452 msgid "Multiple binary package support"
458 "If your source package generates more than one binary package, debhelper "
459 "programs will default to acting on all binary packages when run. If your "
460 "source package happens to generate one architecture dependent package, and "
461 "another architecture independent package, this is not the correct behavior, "
462 "because you need to generate the architecture dependent packages in the "
463 "binary-arch debian/rules target, and the architecture independent packages "
464 "in the binary-indep debian/rules target."
470 "To facilitate this, as well as give you more control over which packages are "
471 "acted on by debhelper programs, all debhelper programs accept the B<-a>, "
472 "B<-i>, B<-p>, and B<-s> parameters. These parameters are cumulative. If "
473 "none are given, debhelper programs default to acting on all packages listed "
474 "in the control file."
479 msgid "Automatic generation of debian install scripts"
485 "Some debhelper commands will automatically generate parts of debian "
486 "maintainer scripts. If you want these automatically generated things "
487 "included in your existing debian maintainer scripts, then you need to add "
488 "\"#DEBHELPER#\" to your scripts, in the place the code should be added. "
489 "\"#DEBHELPER#\" will be replaced by any auto-generated code when you run "
496 "If a script does not exist at all and debhelper needs to add something to "
497 "it, then debhelper will create the complete script."
503 "All debhelper commands that automatically generate code in this way let it "
504 "be disabled by the -n parameter (see above)."
510 "Note that the inserted code will be shell code, so you cannot directly use "
511 "it in a perl script. If you would like to embed it into a perl script, here "
512 "is one way to do that (note that I made sure that $1, $2, etc are set with "
520 " my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n"
523 " system ($temp) / 256 == 0\n"
524 " \tor die \"Problem with debhelper scripts: $!\";\n"
530 msgid "Automatic generation of miscellaneous dependencies."
536 "Some debhelper commands may make the generated package need to depend on "
537 "some other packages. For example, if you use L<dh_installdebconf(1)>, your "
538 "package will generally need to depend on debconf. Or if you use "
539 "L<dh_installxfonts(1)>, your package will generally need to depend on a "
540 "particular version of xutils. Keeping track of these miscellaneous "
541 "dependencies can be annoying since they are dependant on how debhelper does "
542 "things, so debhelper offers a way to automate it."
548 "All commands of this type, besides documenting what dependencies may be "
549 "needed on their man pages, will automatically generate a substvar called "
550 "${misc:Depends}. If you put that token into your debian/control file, it "
551 "will be expanded to the dependencies debhelper figures you need."
557 "This is entirely independent of the standard ${shlibs:Depends} generated by "
558 "L<dh_makeshlibs(1)>, and the ${perl:Depends} generated by L<dh_perl(1)>. "
559 "You can choose not to use any of these, if debhelper's guesses don't match "
565 msgid "Package build directories"
571 "By default, all debhelper programs assume that the temporary directory used "
572 "for assembling the tree of files in a package is debian/<package>."
578 "Sometimes, you might want to use some other temporary directory. This is "
579 "supported by the -P flag. For example, \"dh_installdocs -Pdebian/tmp\", will "
580 "use debian/tmp as the temporary directory. Note that if you use -P, the "
581 "debhelper programs can only be acting on a single package at a time. So if "
582 "you have a package that builds many binary packages, you will need to also "
583 "use the -p flag to specify which binary package the debhelper program will "
589 msgid "Debhelper compatibility levels"
595 "From time to time, major non-backwards-compatible changes need to be made to "
596 "debhelper, to keep it clean and well-designed as needs change and its author "
597 "gains more experience. To prevent such major changes from breaking existing "
598 "packages, the concept of debhelper compatibility levels was introduced. You "
599 "tell debhelper which compatibility level it should use, and it modifies its "
600 "behavior in various ways."
606 "Tell debhelper what compatibility level to use by writing a number to "
607 "debian/compat. For example, to turn on V7 mode:"
614 " % echo 7 > debian/compat\n"
621 "Unless otherwise indicated, all debhelper documentation assumes that you are "
622 "using the most recent compatibility level, and in most cases does not "
623 "indicate if the behavior is different in an earlier compatibility level, so "
624 "if you are not using the most recent compatibility level, you're advised to "
625 "read below for notes about what is different in earlier compatibility "
631 msgid "These are the available compatibility levels:"
642 "This is the original debhelper compatibility level, and so it is the default "
643 "one. In this mode, debhelper will use debian/tmp as the package tree "
644 "directory for the first binary package listed in the control file, while "
645 "using debian/<package> for all other packages listed in the control file."
649 #: debhelper.pod:330 debhelper.pod:337 debhelper.pod:360 debhelper.pod:389
650 msgid "This mode is deprecated."
661 "In this mode, debhelper will consistently use debian/<package> as the "
662 "package tree directory for every package that is built."
672 msgid "This mode works like V2, with the following additions:"
676 #: debhelper.pod:345 debhelper.pod:350 debhelper.pod:354 debhelper.pod:368 debhelper.pod:373 debhelper.pod:378 debhelper.pod:383 debhelper.pod:397 debhelper.pod:401 debhelper.pod:406 debhelper.pod:410 debhelper.pod:422 debhelper.pod:427 debhelper.pod:433 debhelper.pod:439 debhelper.pod:454 debhelper.pod:461 debhelper.pod:465 debhelper.pod:469
683 "Debhelper config files support globbing via * and ?, when appropriate. To "
684 "turn this off and use those characters raw, just prefix with a backslash."
689 msgid "dh_makeshlibs makes the postinst and postrm scripts call ldconfig."
694 msgid "Every file in etc/ is automatically flagged as a conffile by dh_installdeb."
704 msgid "Changes from V3 are:"
710 "dh_makeshlibs -V will not include the debian part of the version number in "
711 "the generated dependency line in the shlibs file."
717 "You are encouraged to put the new ${misc:Depends} into debian/control to "
718 "supplement the ${shlibs:Depends} field."
724 "dh_fixperms will make all files in bin/ directories and in etc/init.d "
730 msgid "dh_link will correct existing links to conform with policy."
740 msgid "Changes from V4 are:"
745 msgid "Comments are ignored in debhelper config files."
751 "dh_strip --dbg-package now specifies the name of a package to put debugging "
752 "symbols in, not the packages to take the symbols from."
757 msgid "dh_installdocs skips installing empty files."
762 msgid "dh_install errors out if wildcards expand to nothing."
772 msgid "Changes from V5 are:"
778 "Commands that generate maintainer script fragments will order the fragments "
779 "in reverse order for the prerm and postrm scripts."
785 "dh_installwm will install a slave manpage link for x-window-manager.1.gz, if "
786 "it sees the man page in usr/share/man/man1 in the package build directory."
792 "dh_builddeb did not previously delete everything matching DH_ALWAYS_EXCLUDE, "
793 "if it was set to a list of things to exclude, such as \"CVS:.svn:.git\". Now "
800 "dh_installman allows overwriting existing man pages in the package build "
801 "directory. In previous compatibility levels it silently refuses to do this."
811 msgid "This is the recommended mode of operation."
816 msgid "Changes from V6 are:"
822 "dh_install, will fall back to looking for files in debian/tmp if it doesn't "
823 "find them in the current directory (or wherever you tell it look using "
824 "--sourcedir). This allows dh_install to interoperate with dh_auto_install, "
825 "which installs to debian/tmp, without needing any special parameters."
830 msgid "dh_clean will read debian/clean and delete files listed there."
835 msgid "dh_clean will delete toplevel *-stamp files."
841 "dh_installchangelogs will guess at what file is the upstream changelog if "
847 msgid "Doc directory symlinks"
853 "Sometimes it is useful to make a package not contain a "
854 "/usr/share/doc/package directory at all, instead placing just a dangling "
855 "symlink in the binary package, that points to some other doc "
856 "directory. Policy says this is ok if your package depends on the package "
857 "whose doc directory it uses. To accomplish this, just don't tell debhelper "
858 "to install any documentation files into the package, and use dh_link to set "
859 "up the symlink (or do it by hand), and debhelper should do the right thing: "
860 "notice it is a dangling symlink and not try to install a copyright file or "
872 "Debhelper includes support for udebs. To create a udeb with debhelper, add "
873 "\"XC-Package-Type: udeb\" to the package's stanza in debian/control, and "
874 "build-depend on debhelper (>= 4.2). Debhelper will try to create udebs that "
875 "comply with debian-installer policy, by making the generated package files "
876 "end in \".udeb\", not installing any documentation into a udeb, skipping "
877 "over preinst, postrm, prerm, and config scripts, etc."
888 "In general, if any debhelper program needs a directory to exist under "
889 "debian/, it will create it. I haven't bothered to document this in all the "
890 "man pages, but for example, dh_installdeb knows to make "
891 "debian/<package>/DEBIAN/ before trying to put files there, dh_installmenu "
892 "knows you need a debian/<package>/usr/share/menu/ before installing the menu "
899 "Once your package uses debhelper to build, be sure to add debhelper to your "
900 "Build-Depends line in debian/control. You should build-depend on a version "
901 "of debhelper equal to (or greater than) the debhelper compatibility level "
902 "your package uses. So if your package used compatibility level 7:"
909 " Build-Depends: debhelper (>= 7)\n"
926 "Set to 1 to enable verbose mode. Debhelper will output every command it runs "
927 "that modifies files on the build system."
938 "Temporarily specifies what compatibility level debhelper should run at, "
939 "overriding any value in debian/compat."
949 msgid "Set to 1 to enable no-act mode."
960 "Anything in this variable will be prepended to the command line arguments of "
961 "all debhelper commands. Command-specific options will be ignored by commands "
962 "that do not support them."
968 "This is useful in some situations, for example, if you need to pass -p to "
969 "all debhelper commands that will be run. One good way to set DH_OPTIONS is "
970 "by using \"Target-specific Variable Values\" in your debian/rules file. See "
971 "the make documentation for details on doing this."
976 msgid "DH_ALWAYS_EXCLUDE"
982 "If set, this adds the value the variable is set to to the -X options of all "
983 "commands that support the -X option. Moreover, dh_builddeb will rm -rf "
984 "anything that matches the value in your package build tree."
990 "This can be useful if you are doing a build from a CVS source tree, in which "
991 "case setting DH_ALWAYS_EXCLUDE=CVS will prevent any CVS directories from "
992 "sneaking into the package you build. Or, if a package has a source tarball "
993 "that (unwisely) includes CVS directories, you might want to export "
994 "DH_ALWAYS_EXCLUDE=CVS in debian/rules, to make it take effect wherever your "
1001 "Multiple things to exclude can be separated with colons, as in "
1002 "DH_ALWAYS_EXCLUDE=CVS:.svn"
1006 #: debhelper.pod:561 dh_builddeb:88 dh_clean:130 dh_compress:192 dh_desktop:31 dh_fixperms:122 dh_gconf:104 dh_gencontrol:79 dh_installcatalogs:109 dh_installchangelogs:147 dh_installcron:61 dh_installdebconf:118 dh_installdeb:97 dh_installdirs:83 dh_installdocs:224 dh_installemacsen:111 dh_installexamples:103 dh_installinfo:74 dh_installinit:224 dh_installlogcheck:51 dh_installlogrotate:50 dh_installmanpages:197 dh_installman:251 dh_installmenu:80 dh_installmime:85 dh_installmodules:124 dh_installpam:52 dh_install:267 dh_installppp:56 dh_installwm:107 dh_installxfonts:86 dh_link:223 dh_listpackages:29 dh_makeshlibs:227 dh_md5sums:89 dh_movefiles:164 dh_perl:145 dh_python:282 dh_scrollkeeper:28 dh_shlibdeps:168 dh_strip:227 dh_suidregister:117 dh_testdir:44 dh_testroot:27 dh_testversion:75 dh_undocumented:28 dh_usrlocal:114
1011 #: debhelper.pod:565
1012 msgid "F</usr/share/doc/debhelper/examples/>"
1016 #: debhelper.pod:567
1017 msgid "A set of example debian/rules files that use debhelper."
1021 #: debhelper.pod:569
1022 msgid "L<http://kitenet.net/~joey/code/debhelper/>"
1026 #: debhelper.pod:571
1027 msgid "Debhelper web site."
1031 #: debhelper.pod:575 dh_builddeb:94 dh_clean:136 dh_compress:198 dh_desktop:37 dh_fixperms:128 dh_gconf:110 dh_gencontrol:85 dh_installcatalogs:115 dh_installchangelogs:153 dh_installcron:67 dh_installdebconf:124 dh_installdeb:103 dh_installdirs:89 dh_installdocs:230 dh_installemacsen:117 dh_installexamples:109 dh_installinfo:80 dh_installinit:230 dh_installlogcheck:57 dh_installlogrotate:56 dh_installmanpages:203 dh_installman:257 dh_installmenu:88 dh_installmime:91 dh_installmodules:130 dh_installpam:58 dh_install:273 dh_installppp:62 dh_installwm:113 dh_installxfonts:92 dh_link:229 dh_listpackages:35 dh_makeshlibs:233 dh_md5sums:95 dh_movefiles:170 dh_perl:151 dh_python:288 dh_scrollkeeper:34 dh_shlibdeps:174 dh_strip:233 dh_suidregister:123 dh_testdir:50 dh_testroot:33 dh_testversion:81 dh_undocumented:34 dh_usrlocal:120
1036 #: debhelper.pod:577 dh_builddeb:96 dh_clean:138 dh_compress:200 dh_fixperms:130 dh_gencontrol:87 dh_installchangelogs:155 dh_installcron:69 dh_installdebconf:126 dh_installdeb:105 dh_installdirs:91 dh_installdocs:232 dh_installemacsen:119 dh_installexamples:111 dh_installinfo:82 dh_installinit:232 dh_installlogrotate:58 dh_installmanpages:205 dh_installman:259 dh_installmenu:90 dh_installmime:93 dh_installmodules:132 dh_installpam:60 dh_install:275 dh_installppp:64 dh_installwm:115 dh_installxfonts:94 dh_link:231 dh_listpackages:37 dh_makeshlibs:235 dh_md5sums:97 dh_movefiles:172 dh_shlibdeps:176 dh_strip:235 dh_suidregister:125 dh_testdir:52 dh_testroot:35 dh_testversion:83 dh_undocumented:36
1037 msgid "Joey Hess <joeyh@debian.org>"
1042 msgid "dh_builddeb - build debian binary packages"
1048 "B<dh_builddeb> [S<I<debhelper options>>] [B<--destdir=>I<directory>] "
1049 "[B<--filename=>I<name>] [S<B<--> I<params>>]"
1055 "dh_builddeb simply calls L<dpkg-deb(1)> to build a debian package or "
1060 #: dh_builddeb:21 dh_clean:33 dh_compress:39 dh_fixperms:31 dh_gconf:39 dh_gencontrol:26 dh_installcatalogs:42 dh_installchangelogs:44 dh_installcron:24 dh_installdebconf:50 dh_installdirs:28 dh_installdocs:49 dh_installemacsen:35 dh_installexamples:29 dh_installinfo:28 dh_installinit:33 dh_installlogrotate:22 dh_installmanpages:40 dh_installman:58 dh_installmenu:34 dh_installmime:31 dh_installmodules:43 dh_installpam:24 dh_install:47 dh_installppp:26 dh_installwm:32 dh_link:48 dh_makeshlibs:28 dh_md5sums:28 dh_movefiles:32 dh_perl:31 dh_python:39 dh_shlibdeps:26 dh_strip:35 dh_testdir:23 dh_testversion:34 dh_usrlocal:39
1066 msgid "B<--destdir=>I<directory>"
1072 "Use this if you want the generated .deb files to be put in a directory other "
1073 "than the default of \"..\""
1078 msgid "B<--filename=>I<name>"
1084 "Use this if you want to force the generated .deb file to have a particular "
1085 "file name. Does not work well if more than one .deb is generated!"
1090 msgid "B<-u>I<params>"
1094 #: dh_builddeb:37 dh_gencontrol:32 dh_installdebconf:58 dh_installinit:78 dh_makeshlibs:76 dh_shlibdeps:32
1095 msgid "B<--> I<params>"
1100 msgid "Pass I<params> to L<dpkg-deb(1)> when it is used to build the package."
1104 #: dh_builddeb:90 dh_clean:132 dh_compress:194 dh_fixperms:124 dh_gconf:106 dh_gencontrol:81 dh_installcatalogs:111 dh_installchangelogs:149 dh_installcron:63 dh_installdebconf:120 dh_installdeb:99 dh_installdirs:85 dh_installdocs:226 dh_installemacsen:113 dh_installexamples:105 dh_installinfo:76 dh_installinit:226 dh_installlogcheck:53 dh_installlogrotate:52 dh_installmanpages:199 dh_installman:253 dh_installmime:87 dh_installmodules:126 dh_installpam:54 dh_install:269 dh_installppp:58 dh_installwm:109 dh_installxfonts:88 dh_link:225 dh_listpackages:31 dh_makeshlibs:229 dh_md5sums:91 dh_movefiles:166 dh_perl:147 dh_python:284 dh_strip:229 dh_suidregister:119 dh_testdir:46 dh_testroot:29 dh_testversion:77 dh_undocumented:30 dh_usrlocal:116
1105 msgid "L<debhelper(7)>"
1109 #: dh_builddeb:92 dh_clean:134 dh_compress:196 dh_desktop:35 dh_fixperms:126 dh_gconf:108 dh_gencontrol:83 dh_installchangelogs:151 dh_installcron:65 dh_installdebconf:122 dh_installdeb:101 dh_installdirs:87 dh_installdocs:228 dh_installemacsen:115 dh_installexamples:107 dh_installinfo:78 dh_installinit:228 dh_installlogrotate:54 dh_installmanpages:201 dh_installman:255 dh_installmenu:86 dh_installmime:89 dh_installmodules:128 dh_installpam:56 dh_install:271 dh_installppp:60 dh_installwm:111 dh_installxfonts:90 dh_link:227 dh_listpackages:33 dh_makeshlibs:231 dh_md5sums:93 dh_movefiles:168 dh_perl:149 dh_python:286 dh_scrollkeeper:32 dh_shlibdeps:172 dh_strip:231 dh_suidregister:121 dh_testdir:48 dh_testroot:31 dh_testversion:79 dh_undocumented:32 dh_usrlocal:118
1110 msgid "This program is a part of debhelper."
1115 msgid "dh_clean - clean up package build directories"
1121 "B<dh_clean> [S<I<debhelper options>>] [B<-k>] [B<-d>] [B<-X>I<item>] "
1129 "dh_clean is a debhelper program that is responsible for cleaning up after "
1131 "package is built. It removes the package build directories, and removes "
1133 "other files including debian/files, and any detritus left behind by other\n"
1134 "debhelper commands. It also removes common files that should not appear in "
1137 " #*# *~ DEADJOE *.orig *.rej *.SUMS TAGS .deps/* *.P *-stamp\n"
1143 msgid "The debian/clean file can list other files to be removed."
1149 "It does not run \"make clean\" to clean up after the build process. Use "
1150 "L<dh_auto_clean(1)> to do things like that."
1156 "dh_clean (or \"dh clean\") should be the last debhelper command run in the "
1157 "clean target in debian/rules."
1161 #: dh_clean:37 dh_installchangelogs:48
1162 msgid "B<-k>, B<--keep>"
1167 msgid "This is deprecated, use L<dh_prep(1)> instead."
1172 msgid "B<-d>, B<--dirs-only>"
1178 "Only clean the package build directories, do not clean up any other files at "
1184 msgid "B<-X>I<item> B<--exclude=>I<item>"
1190 "Exclude files that contain \"item\" anywhere in their filename from being "
1191 "deleted, even if they would normally be deleted. You may use this option "
1192 "multiple times to build up a list of things to exclude."
1196 #: dh_clean:52 dh_compress:56 dh_installdocs:63 dh_installexamples:38 dh_installinfo:37 dh_installmanpages:44 dh_movefiles:49 dh_testdir:27
1202 msgid "Delete these files too."
1207 msgid "dh_compress - compress files and fix symlinks in package build directories"
1213 "B<dh_compress> [S<I<debhelper options>>] [B<-X>I<item>] [B<-A>] [S<I<file "
1220 "dh_compress is a debhelper program that is responsible for compressing the "
1221 "files in package build directories, and makes sure that any symlinks that "
1222 "pointed to the files before they were compressed are updated to point to the "
1229 "By default, dh_compress compresses files that debian policy mandates should "
1230 "be compressed, namely all files in usr/share/info, usr/share/man, "
1231 "usr/X11R6/man, files in usr/share/doc that are larger than 4k in size, "
1232 "(except the copyright file, .html and .css files, image files, and files "
1233 "that appear to be already compressed based on their extensions), and all "
1234 "changelog files. Plus PCF fonts underneath usr/X11R6/lib/X11/fonts/ and "
1235 "usr/share/fonts/X11/"
1241 "If a debian/package.compress file exists, the default files are not "
1242 "compressed. Instead, the debian/packages.compress is ran as a shell script, "
1243 "and all filenames that the shell script outputs will be compressed. The "
1244 "shell script will be run from inside the package build directory. Note "
1245 "though that using -X is a much better idea in general; you should only use a "
1246 "debian/package.compress file if you really need to."
1252 "Exclude files that contain \"item\" anywhere in their filename from being "
1253 "compressed. For example, -X.tiff will exclude tiff files from compression. "
1254 "You may use this option multiple times to build up a list of things to "
1255 "exclude. You can accomplish the same thing by using a debian/compress file, "
1256 "but this is easier."
1262 "Compress all files specified by command line parameters in ALL packages "
1268 msgid "Add these files to the list of files to compress."
1272 #: dh_compress:62 dh_perl:61 dh_python:66 dh_strip:74 dh_usrlocal:55
1278 msgid "Debian policy, version 3.0"
1283 msgid "dh_desktop - deprecated no-op"
1288 msgid "B<dh_desktop> [S<I<debhelper options>>]"
1294 "dh_desktop was a debhelper program that registers .desktop files. However, "
1295 "it no longer does anything, and is now deprecated."
1301 "If a package ships desktop files, they just need to be installed in the "
1302 "correct location (/usr/share/applications) and they will be registered by "
1303 "the appropriate tools for the corresponding desktop environments."
1307 #: dh_desktop:33 dh_scrollkeeper:30
1308 msgid "L<debhelper>"
1312 #: dh_desktop:39 dh_scrollkeeper:36
1313 msgid "Ross Burton <ross@burtonini.com>"
1318 msgid "dh_fixperms - fix permissions of files in package build directories"
1323 msgid "B<dh_fixperms> [S<I<debhelper options>>] [B<-X>I<item>]"
1329 "dh_fixperms is a debhelper program that is responsible for setting the "
1330 "permissions of files and directories in package build directories to a sane "
1331 "state -- a state that complies with Debian policy."
1337 "dh_fixperms makes all files in usr/share/doc in the package build directory "
1338 "(excluding files in the examples/ directory) be mode 644. It also changes "
1339 "the permissions of all man pages to mode 644. It makes all files be owned by "
1340 "root, and it removes group and other write permission from all files. It "
1341 "removes execute permissions from any libraries, headers, perl modules, or "
1342 "desktop files that have it set. It makes all files in the standard bin and "
1343 "sbin directories, usr/games/ and etc/init.d executable (since v4). Finally, "
1344 "it removes the setuid and setgid bits from all files in the package."
1349 msgid "B<-X>I<item>, B<--exclude> I<item>"
1355 "Exclude files that contain \"item\" anywhere in their filename from having "
1356 "their permissions changed. You may use this option multiple times to build "
1357 "up a list of things to exclude."
1362 msgid "dh_gconf - generate GConf schema registration scripts"
1367 msgid "B<dh_gconf> [S<I<debhelper options>>] [B<--priority=<number>>]"
1373 "dh_gconf is a debhelper program that is responsible for registering GConf "
1380 "It automatically generates the postinst and prerm fragments needed to "
1381 "register and unregister the schemas in usr/share/gconf/schemas, using "
1388 "If a file named debian/package.gconf-defaults exists, then it is installed "
1389 "into usr/share/gconf/defaults/10_package in the package build directory, "
1390 "with \"package\" replaced by the package name. Some postinst and postrm "
1391 "fragments will be generated to launch update-gconf-defaults."
1397 "If a file named debian/package.gconf-mandatory exists, then it is installed "
1398 "into usr/share/gconf/mandatory/10_package in the package build directory, "
1399 "with \"package\" replaced by the package name, and similar postinst and "
1400 "postrm fragments will be generated."
1406 "The gconf-schemas and update-gconf-defaults scripts are provided by the "
1407 "gconf2 package. An appropriate dependency will be generated in "
1413 msgid "B<--priority> I<priority>"
1419 "Use I<priority> (which should be a 2-digit number) as the defaults priority "
1420 "instead of 10. Higher values than ten can be used by derived distributions "
1421 "(20), CDD distributions (50), or site-specific packages (90)."
1426 msgid "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>"
1431 msgid "dh_gencontrol - generate and install control file"
1436 msgid "B<dh_gencontrol> [S<I<debhelper options>>] [S<B<--> I<params>>]"
1442 "dh_gencontrol is a debhelper program that is responsible for generating "
1443 "control files, and installing them into the DEBIAN directory with the proper "
1450 "This program is merely a wrapper around L<dpkg-gencontrol(1)>, which calls "
1451 "it once for each package being acted on, and passes in some additional "
1457 msgid "B<-u>I<params>, B<--dpkg-gencontrol-params>=I<params>"
1462 msgid "Pass \"params\" to L<dpkg-gencontrol(1)>."
1466 #: dh_installcatalogs:5
1467 msgid "dh_installcatalogs - install and register SGML Catalogs"
1471 #: dh_installcatalogs:16
1472 msgid "B<dh_installcatalogs> [S<I<debhelper options>>] [B<-n>]"
1476 #: dh_installcatalogs:20
1478 "dh_installcatalogs is a debhelper program that installs and registers SGML "
1479 "catalogs. It complies with the Debian XML/SGML policy."
1483 #: dh_installcatalogs:23
1485 "The file F<debian/I<package>.sgmlcatalogs> contains the catalogs to be "
1486 "installed per package. Each line in that file should be of the form "
1487 "C<source dest>, where C<source> indicates where the catalog resides in the "
1488 "source tree, and C<dest> indicates the destination location for the catalog "
1489 "under the package build area. C<dest> should start with "
1490 "F</usr/share/sgml/>."
1494 #: dh_installcatalogs:30
1496 "Catalogs will be registered in a supercatalog, in "
1497 "F</etc/sgml/I<package>.cat>."
1501 #: dh_installcatalogs:33
1503 "This command automatically adds maintainer script snippets for registering "
1504 "and unregistering the catalogs and \"supercatalogs\" (unless B<-n> is "
1505 "used). These snippets are inserted into the maintainer scripts by "
1506 "dh_installdeb; see L<dh_installdeb(1)> for an explanation of Debhelper "
1507 "maintainer script snippets."
1511 #: dh_installcatalogs:39
1513 "A dependency on B<sgml-base> will be added to C<${misc:Depends}>, so be sure "
1514 "your package uses that variable in F<debian/control>."
1518 #: dh_installcatalogs:46 dh_installdebconf:54 dh_installemacsen:39 dh_installinit:37 dh_installmenu:38 dh_installmime:35 dh_installmodules:47 dh_installwm:42 dh_makeshlibs:62 dh_python:60 dh_usrlocal:43
1519 msgid "B<-n>, B<--noscripts>"
1523 #: dh_installcatalogs:48
1524 msgid "Do not modify F<postinst>/F<postrm>/F<prerm> scripts."
1528 #: dh_installcatalogs:54 dh_installdocs:87 dh_installemacsen:56 dh_installinit:112 dh_installmime:43 dh_installmodules:62 dh_installwm:55 dh_usrlocal:51
1530 "Note that this command is not idempotent. L<dh_prep(1)> should be called "
1531 "between invocations of this command. Otherwise, it may cause multiple "
1532 "instances of the same text to be added to maintainer scripts."
1536 #: dh_installcatalogs:113
1537 msgid "F</usr/share/doc/sgml-base-doc/>"
1541 #: dh_installcatalogs:117
1542 msgid "Adam Di Carlo <aph@debian.org>"
1546 #: dh_installchangelogs:5
1547 msgid "dh_installchangelogs - install changelogs into package build directories"
1551 #: dh_installchangelogs:14
1553 "B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] "
1558 #: dh_installchangelogs:18
1560 "dh_installchangelogs is a debhelper program that is responsible for "
1561 "installing changelogs into package build directories."
1565 #: dh_installchangelogs:21
1567 "dh_installchangelogs determines if the package is a debian native package, "
1568 "and if so, it installs debian/changelog into usr/share/doc/package/changelog "
1569 "in the package build directory. Otherwise, it installs debian/changelog into "
1570 "usr/share/doc/package/changelog.Debian in the package build directory. (If "
1571 "files named debian/package.changelog exist, they will be used in preference "
1572 "to debian/changelog.)"
1576 #: dh_installchangelogs:28
1578 "Parallelling the debian changelog handling, this program also takes care of "
1579 "NEWS.Debian files. If there is a debian/NEWS file, it is installed as "
1580 "usr/share/doc/package/NEWS.Debian. debian/package.NEWS files can also be "
1585 #: dh_installchangelogs:33
1587 "An upstream changelog file may be specified as an option. If none is "
1588 "specified, a few common filenames are tried. (In compatibility level 7 and "
1593 #: dh_installchangelogs:37
1595 "If there is an upstream changelog file, it will be be installed as "
1596 "usr/share/doc/package/changelog in the package build directory. If the "
1597 "changelog is a html file (determined by file extension), it will be "
1598 "installed as usr/share/doc/package/changelog.html instead, and will be "
1599 "converted to plain text with html2text to generate "
1600 "usr/share/doc/package/changelog."
1604 #: dh_installchangelogs:50
1606 "Keep the original name of the upstream changelog. This will be accomplished "
1607 "by installing the upstream changelog as \"changelog\", and making a symlink "
1608 "from that to the original name of the changelog file. This can be useful if "
1609 "the upstream changelog has an unusual name, or if other documentation in the "
1610 "package refers to the changelog file."
1614 #: dh_installchangelogs:56 dh_installdocs:58 dh_installexamples:43 dh_install:69 dh_link:57 dh_movefiles:44
1615 msgid "B<-Xitem>, B<--exclude=item>"
1619 #: dh_installchangelogs:58
1621 "Exclude upstream changelog files that contain \"item\" anywhere in their "
1622 "filename from being installed."
1626 #: dh_installchangelogs:61
1631 #: dh_installchangelogs:63
1632 msgid "Install this file as the upstream changelog."
1637 msgid "dh_installcron - install cron scripts into etc/cron.*"
1641 #: dh_installcron:14
1642 msgid "B<dh_installcron> [S<B<debhelper options>>] [B<--name=>I<name>]"
1646 #: dh_installcron:18
1648 "dh_installcron is a debhelper program that is responsible for installing "
1649 "cron scripts into etc/cron.*/ in package build directories. The files "
1650 "debian/package.cron.daily, debian/package.cron.weekly, "
1651 "debian/package.cron.monthly, debian/package.cron.hourly, and "
1652 "debian/package.cron.d are installed."
1656 #: dh_installcron:28 dh_installinit:83 dh_installlogrotate:26 dh_installmodules:51 dh_installpam:28 dh_installppp:30
1657 msgid "B<--name=>I<name>"
1661 #: dh_installcron:30
1663 "Look for files named debian/package.name.cron.* and install them as "
1664 "etc/cron.*/name, instead of using the usual files and installing them as the "
1669 #: dh_installdebconf:5
1671 "dh_installdebconf - install files used by debconf in package build "
1676 #: dh_installdebconf:14
1677 msgid "B<dh_installdebconf> [S<I<debhelper options>>] [B<-n>] [S<B<--> I<params>>]"
1681 #: dh_installdebconf:18
1683 "dh_installdebconf is a debhelper program that is responsible for installing "
1684 "files used by the debconf package into package build directories."
1688 #: dh_installdebconf:21
1690 "It also automatically generates the postrm commands needed to interface with "
1691 "debconf. The commands are added to the maintainer scripts by "
1692 "dh_installdeb. See L<dh_installdeb(1)> for an explanation of how that works."
1696 #: dh_installdebconf:26
1698 "Files named debian/package.config and debian/package.templates are installed "
1699 "into the DEBIAN directory in the package build directory. If a file named "
1700 "debian/package.config.debhelper exists, the contents of that file are merged "
1701 "into the config script as follows: If the script exists, then anywhere in it "
1702 "that \"#DEBHELPER#\" appears, the text of the .debhelper file is "
1703 "inserted. If the script does not exist, then a script is generated from the "
1704 ".debhelper file. The .debhelper files may be created by other debhelper "
1705 "programs, and are shell script fragments."
1709 #: dh_installdebconf:35
1711 "Note that if you use debconf, your package probably needs to depend on it "
1712 "(it will be added to ${misc:Depends} by this program)."
1716 #: dh_installdebconf:38
1718 "Note that for your config script to be called by dpkg, your postinst needs "
1719 "to source debconf's confmodule. dh_installdebconf does not install this "
1720 "statement into postinst automatically as it it too hard to do it right."
1724 #: dh_installdebconf:43
1725 msgid "LOCALIZED TEMPLATE FILES"
1729 #: dh_installdebconf:45
1731 "This program will look to see if you have a debian/po directory and if so "
1732 "will automatically call L<po2debconf(1)> to generate a merged templates file "
1733 "containing the translations. For this to work, your package should "
1734 "build-depend on po-debconf."
1738 #: dh_installdebconf:56
1739 msgid "Do not modify postrm script."
1743 #: dh_installdebconf:60
1744 msgid "Pass the params to po2debconf."
1749 msgid "dh_installdeb - install files into the DEBIAN directory"
1754 msgid "B<dh_installdeb> [S<I<debhelper options>>]"
1760 "dh_installdeb is a debhelper program that is responsible for installing "
1761 "files into the DEBIAN directories in package build directories with the "
1762 "correct permissions."
1769 "dh_installdeb automatically installs the following files from debian/ into\n"
1770 "the DEBIAN directory:\n"
1771 " package.postinst\n"
1772 " package.preinst\n"
1776 " package.conffiles\n"
1777 " package.triggers\n"
1784 "The postinst, preinst, postrm, and prerm are handled specially: If a "
1785 "corresponding file named debian/package.script.debhelper exists, the "
1786 "contents of that file are merged into the script as follows: If the script "
1787 "exists, then anywhere in it that \"#DEBHELPER#\" appears, the text of the "
1788 ".debhelper file is inserted. If the script does not exist, then a script is "
1789 "generated from the .debhelper file. The .debhelper files are created by "
1790 "other debhelper programs, such as L<dh_installmenu(1)>, and are shell script "
1797 "In V3 compatibility mode and higher, all files in the etc/ directory in a "
1798 "package will automatically be flagged as conffiles by this program, so there "
1799 "is no need to list them manually in package.conffiles."
1804 msgid "dh_installdirs - create subdirectories in package build directories"
1808 #: dh_installdirs:14
1809 msgid "B<dh_installdirs> [S<I<debhelper options>>] [B<-A>] [S<I<dir ...>>]"
1813 #: dh_installdirs:18
1815 "dh_installdirs is a debhelper program that is responsible for creating "
1816 "subdirectories in package build directories."
1820 #: dh_installdirs:21
1821 msgid "A file named debian/package.dirs can list directories to be created."
1825 #: dh_installdirs:23
1827 "Any directory names specified as parameters will be created in the package "
1828 "build directory of the first package dh_installdirs is told to act on. By "
1829 "default, this is the first binary package in debian/control, but if you use "
1830 "-p, -i, or -a flags, it will be the first package specified by those flags."
1834 #: dh_installdirs:34
1836 "Create any directories specified by command line parameters in ALL packages "
1837 "acted on, not just the first."
1841 #: dh_installdirs:37
1846 #: dh_installdirs:39
1848 "Create these directories in the package build directory of the first package "
1849 "acted on. (Or in all packages if -A is specified.)"
1854 msgid "dh_installdocs - install documentation into package build directories"
1858 #: dh_installdocs:14
1860 "B<dh_installdocs> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] [S<I<file "
1865 #: dh_installdocs:18
1867 "dh_installdocs is a debhelper program that is responsible for installing "
1868 "documentation into usr/share/doc/package in package build directories."
1872 #: dh_installdocs:21
1874 "dh_installdocs automatically installs debian/copyright if it exists. If "
1875 "dh_installdocs is acting on multiple packages, debian/copyright files will "
1876 "be installed into all packages. However, if you need to have separate "
1877 "copyright files for different binary packages, you can use files named "
1878 "debian/package.copyright."
1882 #: dh_installdocs:27
1884 "Any filenames specified as parameters will be installed into the first "
1885 "package dh_installdocs is told to act on. By default, this is the first "
1886 "binary package in debian/control, but if you use B<-p>, B<-i>, or B<-a> "
1887 "flags, it will be the first package specified by those flags."
1891 #: dh_installdocs:32
1893 "Also, debian/README.Debian (or debian/README.debian) and debian/TODO, if "
1894 "they exist, will be installed into the first binary package listed in "
1895 "debian/control, if dh_installdocs is acting on that package. Note that "
1896 "debian/TODO will be installed named TODO.Debian, if the package is not a "
1897 "debian native package. Also note that README.debian is installed as "
1898 "README.Debian, for consistency. Note that debian/package.README.Debian and "
1899 "debian/package.TODO can be used to specify files for subpackages."
1903 #: dh_installdocs:40
1904 msgid "Files named debian/package.docs can list other files to be installed."
1908 #: dh_installdocs:42
1910 "Files named debian/package.doc-base, will be installed as doc-base control "
1911 "files. Note that the doc-id will be determined from the \"Document:\" entry "
1912 "in the doc-base control file in question."
1916 #: dh_installdocs:46
1918 "If your package needs to register more than one document, you need multiple "
1919 "files. To accomplish this, you can use files named debian/package.doc-base.*"
1923 #: dh_installdocs:55 dh_installinfo:34 dh_installman:64
1925 "Install all files specified by command line parameters in ALL packages acted "
1930 #: dh_installdocs:60
1932 "Exclude files that contain \"item\" anywhere in their filename from being "
1933 "installed. Note that this includes doc-base files."
1937 #: dh_installdocs:65
1939 "Install these files as documentation into the first package acted on. (Or in "
1940 "all packages if B<-A> is specified)."
1944 #: dh_installdocs:70 dh_link:70 dh_makeshlibs:82 dh_shlibdeps:66
1949 #: dh_installdocs:72
1950 msgid "This is an example of a debian/package.docs file:"
1954 #: dh_installdocs:74
1959 " debian/notes-for-maintainers.txt\n"
1960 " docs/manual.txt\n"
1961 " docs/manual.pdf\n"
1962 " docs/manual-html/\n"
1967 #: dh_installdocs:83
1969 "Note that dh_installdocs will happily copy entire directory hierarchies if "
1970 "you ask it to (similar to cp -a). If it is asked to install a directory, it "
1971 "will install the complete contents of the directory."
1975 #: dh_installemacsen:5
1976 msgid "dh_installemacsen - register an emacs add on package"
1980 #: dh_installemacsen:14
1982 "B<dh_installemacsen> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] "
1983 "[B<--flavor=>I<foo>]"
1987 #: dh_installemacsen:18
1989 "dh_installemacsen is a debhelper program that is responsible for installing "
1990 "files used by the debian emacsen-common package into package build "
1995 #: dh_installemacsen:22
1997 "It also automatically generates the postinst and prerm commands needed to "
1998 "register a package as an emacs add on package. The commands are added to the "
1999 "maintainer scripts by dh_installdeb. See L<dh_installdeb(1)> for an "
2000 "explanation of how this works."
2004 #: dh_installemacsen:27
2006 "If a file named debian/package.emacsen-install exists, then it is installed "
2007 "into usr/lib/emacsen-common/packages/install/package in the package build "
2008 "directory. Similarly, debian/package.emacsen-remove is installed into "
2009 "usr/lib/emacsen-common/packages/remove/package . And similarly, "
2010 "debian/package.emacsen-startup is installed into "
2011 "etc/emacs/site-start.d/50<package>.el (by default)."
2015 #: dh_installemacsen:41
2016 msgid "Do not modify postinst/prerm scripts."
2020 #: dh_installemacsen:43 dh_installwm:36
2021 msgid "B<--priority=>I<n>"
2025 #: dh_installemacsen:45
2026 msgid "Sets the priority number of a site-start.d file. Default is 50."
2030 #: dh_installemacsen:47
2031 msgid "B<--flavor=>I<foo>"
2035 #: dh_installemacsen:49
2037 "Sets the flavor a site-start.d file will be installed in. Default is "
2038 "\"emacs\", alternatives include \"xemacs\" and \"emacs20\"."
2042 #: dh_installexamples:5
2043 msgid "dh_installexamples - install example files into package build directories"
2047 #: dh_installexamples:14
2049 "B<dh_installexamples> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] "
2054 #: dh_installexamples:18
2056 "dh_installexamples is a debhelper program that is responsible for installing "
2057 "examples into usr/share/doc/package/examples in package build directories."
2061 #: dh_installexamples:22
2063 "Any file names specified as parameters will be installed into the first "
2064 "package dh_installexamples is told to act on. By default, this is the first "
2065 "binary package in debian/control, but if you use -p, -i, or -a flags, it "
2066 "will be the first package specified by those flags."
2070 #: dh_installexamples:27
2071 msgid "Files named debian/package.examples can list other files to be installed."
2075 #: dh_installexamples:35
2077 "Install any files specified by command line parameters in ALL packages acted "
2082 #: dh_installexamples:40
2084 "Install these files as examples into the first package acted on. (Or into "
2085 "all packages if -A is specified.)"
2089 #: dh_installexamples:45 dh_install:71 dh_movefiles:46
2091 "Exclude files that contain \"item\" anywhere in their filename from being "
2096 #: dh_installexamples:52
2098 "Note that dh_installexamples will happily copy entire directory hierarchies "
2099 "if you ask it to (similar to cp -a). If it is asked to install a directory, "
2100 "it will install the complete contents of the directory."
2105 msgid "dh_installinfo - install info files"
2109 #: dh_installinfo:14
2110 msgid "B<dh_installinfo> [S<I<debhelper options>>] [B<-A>] [S<I<file ...>>]"
2114 #: dh_installinfo:18
2116 "dh_installinfo is a debhelper program that is responsible for installing "
2117 "info files into usr/share/info in the package build directory."
2121 #: dh_installinfo:21
2123 "Any filenames specified as parameters will be installed into the first "
2124 "package dh_installinfo is told to act on. By default, this is the first "
2125 "binary package in debian/control, but if you use -p, -i, or -a flags, it "
2126 "will be the first package specified by those flags."
2130 #: dh_installinfo:26
2131 msgid "Files named debian/package.info can list other files to be installed."
2135 #: dh_installinfo:39
2137 "Install these info files into the first package acted on. (Or in all "
2138 "packages if -A is specified)."
2143 msgid "dh_installinit - install init scripts into package build directories"
2147 #: dh_installinit:14
2149 "B<dh_installinit> [S<I<debhelper options>>] [B<--name=>I<name>] [B<-n>] "
2150 "[B<-R>] [B<-r>] [B<-d>] [S<B<--> I<params>>]"
2154 #: dh_installinit:18
2156 "dh_installinit is a debhelper program that is responsible for installing "
2157 "init scripts and associated defaults files into package build directories."
2161 #: dh_installinit:21
2163 "It also automatically generates the postinst and postrm and prerm commands "
2164 "needed to set up the symlinks in /etc/rc*.d/ and to start and stop the init "
2169 #: dh_installinit:25
2171 "If a file named debian/package.init exists, then it is installed into "
2172 "etc/init.d/package in the package build directory, with \"package\" replaced "
2173 "by the package name."
2177 #: dh_installinit:29
2179 "If a file named debian/package.default exists, then it is installed into "
2180 "etc/default/package in the package build directory, with \"package\" "
2181 "replaced by the package name."
2185 #: dh_installinit:39
2186 msgid "Do not modify postinst/postrm/prerm scripts."
2190 #: dh_installinit:41
2191 msgid "B<-o>, B<--onlyscripts>"
2195 #: dh_installinit:43
2197 "Only modify postinst/postrm/prerm scripts, do not actually install any init "
2198 "script or default files. May be useful if the init script is shipped and/or "
2199 "installed by upstream in a way that doesn't make it easy to let "
2200 "dh_installinit find it."
2204 #: dh_installinit:48
2205 msgid "B<-R>, B<--restart-after-upgrade>"
2209 #: dh_installinit:50
2211 "Do not stop the init script until after the package upgrade has been "
2212 "completed. This is different than the default behavior, which stops the "
2213 "script in the prerm, and starts it again in the postinst."
2217 #: dh_installinit:54
2219 "This can be useful for daemons that should not have a possibly long downtime "
2220 "during upgrade. But you should make sure that the daemon will not get "
2221 "confused by the package being upgraded while it's running before using this "
2226 #: dh_installinit:59
2227 msgid "B<-r>, B<--no-restart-on-upgrade>"
2231 #: dh_installinit:61
2232 msgid "Do not stop init script on upgrade."
2236 #: dh_installinit:63
2237 msgid "B<--no-start>"
2241 #: dh_installinit:65
2243 "Do not start the init script on install or upgrade, or stop it on removal. "
2244 "Only call update-rc.d. Useful for rcS scripts."
2248 #: dh_installinit:68
2249 msgid "B<-d>, B<--remove-d>"
2253 #: dh_installinit:70
2255 "Remove trailing \"d\" from the name of the package, and use the result for "
2256 "the filename the init script is installed as in etc/init.d/ , and the "
2257 "default file is installed as in etc/default/ . This may be useful for "
2258 "daemons with names ending in \"d\". (Note: this takes precedence over the "
2259 "--init-script parameter described below.)"
2263 #: dh_installinit:76
2264 msgid "B<-u>I<params> B<--update-rcd-params=>I<params>"
2268 #: dh_installinit:80
2270 "Pass \"params\" to L<update-rc.d(8)>. If not specified, \"defaults\" will be "
2271 "passed to L<update-rc.d(8)>."
2275 #: dh_installinit:85
2277 "Install the init script (and default file) using the filename I<name> "
2278 "instead of the default filename, which is the package name. When this "
2279 "parameter is used, dh_installinit looks for and installs files named "
2280 "debian/package.name.init and debian/package.name.default, instead of the "
2281 "usual debian/package.init and debian/package.default."
2285 #: dh_installinit:91
2286 msgid "B<--init-script=>I<scriptname>"
2290 #: dh_installinit:93
2292 "Use \"scriptname\" as the filename the init script is installed as in "
2293 "etc/init.d/ (and also use it as the filename for the defaults file, if it is "
2294 "installed). If you use this parameter, dh_installinit will look to see if a "
2295 "file in the debian/ directory exists that looks like \"package.scriptname\" "
2296 "and if so will install it as the init script in preference to the files it "
2297 "normally installs."
2301 #: dh_installinit:100
2302 msgid "This parameter is deprecated, use the --name parameter instead."
2306 #: dh_installinit:102
2307 msgid "B<--error-handler=>I<function>"
2311 #: dh_installinit:104
2313 "Call the named shell function if running the init script fails. The function "
2314 "should be provided in the prerm and postinst scripts, before the #DEBHELPER# "
2319 #: dh_installlogcheck:5
2320 msgid "dh_installlogcheck - install logcheck rulefiles into etc/logcheck/"
2324 #: dh_installlogcheck:14
2325 msgid "B<dh_installlogcheck> [S<B<debhelper options>>]"
2329 #: dh_installlogcheck:18
2331 "dh_installlogcheck is a debhelper program that is responsible for installing "
2332 "logcheck rule files into subdirectories of etc/logcheck/ in package build "
2333 "directories. The files debian/package.logcheck.cracking, "
2334 "debian/package.logcheck.violations, "
2335 "debian/package.logcheck.violations.ignore, "
2336 "debian/package.logcheck.ignore.workstation, "
2337 "debian/package.logcheck.ignore.server and "
2338 "debian/package.logcheck.ignore.paranoid are installed if present."
2342 #: dh_installlogcheck:55
2345 "This program is a part of debhelper.\n"
2350 #: dh_installlogcheck:59
2351 msgid "Jon Middleton <jjm@debian.org>"
2355 #: dh_installlogrotate:5
2356 msgid "dh_installlogrotate - install logrotate config files"
2360 #: dh_installlogrotate:14
2361 msgid "B<dh_installlogrotate> [S<I<debhelper options>>] [B<--name=>I<name>]"
2365 #: dh_installlogrotate:18
2367 "dh_installlogrotate is a debhelper program that is responsible for "
2368 "installing logrotate config files into etc/logrotate.d in package build "
2369 "directories. Files named debian/package.logrotate are installed."
2373 #: dh_installlogrotate:28
2375 "Look for files named debian/package.name.logrotate and install them as "
2376 "etc/logrotate.d/name, instead of using the usual files and installing them "
2377 "as the package name."
2381 #: dh_installmanpages:5
2382 msgid "dh_installmanpages - old-style man page installer"
2386 #: dh_installmanpages:15
2387 msgid "B<dh_installmanpages> [S<I<debhelper options>>] [S<I<file ...>>]"
2391 #: dh_installmanpages:19
2393 "dh_installmanpages is a debhelper program that is responsible for "
2394 "automatically installing man pages into usr/share/man/ and usr/X11R6/man/ in "
2395 "package build directories."
2399 #: dh_installmanpages:23
2401 "This is a DWIM-style program, with an interface unlike the rest of "
2402 "debhelper. It is deprecated, and you are encouraged to use "
2403 "L<dh_installman(1)> instead."
2407 #: dh_installmanpages:27
2409 "dh_installmanpages scans the current directory and all subdirectories for "
2410 "filenames that look like man pages. (Note that only real files are looked "
2411 "at; symlinks are ignored.) It uses L<file(1)> to verify that the files are "
2412 "in the correct format. Then, based on the files' extensions, it installs "
2413 "them into the correct man directory."
2417 #: dh_installmanpages:33
2419 "All filenames specified as parameters will be skipped by "
2420 "dh_installmanpages. This is useful if by default it installs some man pages "
2421 "that you do not want to be installed."
2425 #: dh_installmanpages:37
2427 "After the man page installation step, dh_installmanpages will check to see "
2428 "if any of the man pages are \".so\" links. If so, it changes them to "
2433 #: dh_installmanpages:46
2435 "Do not install these files as man pages, even if they look like valid man "
2440 #: dh_installmanpages:51
2445 #: dh_installmanpages:53
2447 "dh_installmanpages will install the man pages it finds into B<all> packages "
2448 "you tell it to act on, since it can't tell what package the man pages belong "
2449 "in. This is almost never what you really want (use -p to work around this, "
2450 "or use the much better L<dh_installman(1)> program instead)."
2454 #: dh_installmanpages:58
2455 msgid "Files ending in I<.man> will be ignored."
2459 #: dh_installmanpages:60
2461 "Files specified as parameters that contain spaces in their filenames will "
2462 "not be processed properly."
2467 msgid "dh_installman - install man pages into package build directories"
2472 msgid "B<dh_installman> [S<I<debhelper options>>] [S<I<manpage ...>>]"
2478 "dh_installman is a debhelper program that handles installing man pages into "
2479 "the correct locations in package build directories. You tell it what man "
2480 "pages go in your packages, and it figures out where to install them based on "
2481 "the section field in their .TH line. If you have a properly formatted .TH "
2482 "line, your man page will be installed into the right directory, with the "
2483 "right name (this includes proper handling of pages with a subsection, like "
2484 "\"3perl\", which are placed in man3, and given an extension of "
2485 "\".3perl\"). If your .TH line is incorrect or missing, the program may guess "
2486 "wrong based on the file extension."
2492 "It also supports translated man pages, by looking for extensions like .ll.8 "
2493 "and .ll_LL.8, or by use of the --language switch."
2499 "If dh_installman seems to install a man page into the wrong section or with "
2500 "the wrong extension, this is because the man page has the wrong section "
2501 "listed in its .TH line. Edit the man page and correct the section, and "
2502 "dh_installman will follow suit. See L<man(7)> for details about the .TH "
2503 "section. If dh_installman seems to install a man page into a directory like "
2504 "/usr/share/man/pl/man1/, that is because your program has a name like "
2505 "\"foo.pl\", and dh_installman assumes that means it is translated into "
2506 "Polish. Use --language=C to avoid this."
2512 "Any man page filenames specified as parameters will be installed into the "
2513 "first package dh_installman is told to act on. By default, this is the first "
2514 "binary package in debian/control, but if you use -p, -i, or -a flags, it "
2515 "will be the first package specified by those flags."
2521 "Files named debian/package.manpages can list other man pages to be "
2528 "After the man page installation step, dh_installman will check to see if any "
2529 "of the man pages in the temporary directories of any of the packages it is "
2530 "acting on contain \".so\" links. If so, it changes them to symlinks."
2536 "Also, dh_installman will use man to guess the character encoding of each "
2537 "manual page and convert it to UTF-8. If the guesswork fails for some reason, "
2538 "you can override it using an encoding declaration. See L<manconv(1)> for "
2544 msgid "B<--language>=ll"
2550 "Use this to specify that the man pages being acted on are written in the "
2551 "specified language."
2556 msgid "I<manpage ...>"
2562 "Install these man pages into the first package acted on. (Or in all packages "
2563 "if -A is specified)."
2569 "An older version of this program, L<dh_installmanpages(1)>, is still used by "
2570 "some packages, and so is still included in debhelper. It is, however, "
2571 "deprecated, due to its counterintuitive and inconsistent interface. Use this "
2577 msgid "dh_installmenu - install debian menu files into package build directories"
2581 #: dh_installmenu:14
2582 msgid "B<dh_installmenu> [S<B<debhelper options>>] [B<-n>]"
2586 #: dh_installmenu:18
2588 "dh_installmenu is a debhelper program that is responsible for installing "
2589 "files used by the debian menu package into package build directories."
2593 #: dh_installmenu:21
2595 "It also automatically generates the postinst and postrm commands needed to "
2596 "interface with the debian menu package. These commands are inserted into the "
2597 "maintainer scripts by dh_installdeb. See L<dh_installdeb(1)> for an "
2598 "explanation of how this works."
2602 #: dh_installmenu:26
2604 "If a file named debian/package.menu exists, then it is installed into "
2605 "usr/share/menu/package in the package build directory. This is a debian menu "
2606 "file. See L<menufile(5)> for its format."
2610 #: dh_installmenu:30
2612 "If a file named debian/package.menu-method exits, then it is installed into "
2613 "etc/menu-methods/package in the package build directory. This is a debian "
2618 #: dh_installmenu:40 dh_installmime:37 dh_installmodules:49 dh_makeshlibs:64 dh_python:62
2619 msgid "Do not modify postinst/postrm scripts."
2623 #: dh_installmenu:82
2624 msgid "L<debhelper(7)> L<update-menus(1)> L<menufile(5)>"
2629 msgid "dh_installmime - install mime files into package build directories"
2633 #: dh_installmime:14
2634 msgid "B<dh_installmime> [S<I<debhelper options>>] [B<-n>]"
2638 #: dh_installmime:18
2640 "dh_installmime is a debhelper program that is responsible for installing "
2641 "mime files into package build directories."
2645 #: dh_installmime:21
2647 "It also automatically generates the postinst and postrm commands needed to "
2648 "interface with the debian mime-support and shared-mime-info packages. These "
2649 "commands are inserted into the maintainer scripts by dh_installdeb. See "
2650 "L<dh_installdeb(1)> for an explanation of how this works."
2654 #: dh_installmime:26
2656 "If files named debian/package.mime or debian/package.sharedmimeinfo exist, "
2657 "then they are installed into usr/lib/mime/packages/package and "
2658 "/usr/share/mime/packages/package.xml (respectively) in the package build "
2663 #: dh_installmodules:5
2664 msgid "dh_installmodules - register modules with modutils"
2668 #: dh_installmodules:16
2669 msgid "B<dh_installmodules> [S<I<debhelper options>>] [B<-n>] [B<--name=>I<name>]"
2673 #: dh_installmodules:20
2675 "dh_installmodules is a debhelper program that is responsible for registering "
2680 #: dh_installmodules:23
2682 "Files named debian/package.modprobe will be installed in "
2683 "etc/modprobe.d/package.conf in the package build directory, to be used by "
2684 "module-init-tools's version of modprobe."
2688 #: dh_installmodules:27
2690 "Kernel modules are searched for in the package build directory and if found, "
2691 "postinst and postrm commands are automatically generated to run depmod and "
2692 "register the modules when the package is installed. These commands are "
2693 "inserted into the maintainer scripts by dh_installdeb. See "
2694 "L<dh_installdeb(1)> for an explanation of how this works."
2698 #: dh_installmodules:33
2700 "Previous versions of dh_installmodules installed files named "
2701 "etc/modprobe.d/package, code is added to the preinst and postinst to handle "
2702 "the upgrade from the old location."
2706 #: dh_installmodules:37
2708 "Previous versions of dh_installmodules also supported files named "
2709 "debian/package.modules, which were installed into etc/modutils/package in "
2710 "the package build directory. This was for use by modutils, which is no "
2711 "longer in Debian. dh_installmodules will warn about such files now."
2715 #: dh_installmodules:53
2717 "When this parameter is used, dh_installmodules looks for and installs files "
2718 "named debian/package.name.modules and debian/package.name.modprobe instead "
2719 "of the usual debian/package.modules and debian/package.modprobe"
2724 msgid "dh_installpam - install pam support files"
2729 msgid "B<dh_installpam> [S<I<debhelper options>>] [B<--name=>I<name>]"
2735 "dh_installpam is a debhelper program that is responsible for installing "
2736 "files used by PAM into package build directories."
2742 "If a file named debian/package.pam exists, then it is installed into "
2743 "etc/pam.d/package in the package build directory."
2749 "Look for files named debian/package.name.pam and install them as "
2750 "etc/pam.d/name, instead of using the usual files and installing them as the "
2756 msgid "dh_install - install files into package build directories"
2762 "B<dh_install> [B<-X>I<item>] [B<--autodest>] [B<--sourcedir=>I<dir>] "
2763 "[S<I<debhelper options>>] [S<I<file [...] dest>>]"
2769 "dh_install is a debhelper program that handles installing files into package "
2770 "build directories. There are many dh_install* commands that handle "
2771 "installing specific types of files such as documentation, examples, man "
2772 "pages, and so on, and they should be used when possible as they often have "
2773 "extra intelligence for those particular tasks. dh_install, then, is useful "
2774 "for installing everything else, for which no particular intelligence is "
2775 "needed. It is a replacement for the old dh_movefiles command."
2781 "Files named debian/package.install list the files to install into each "
2782 "package and the directory they should be installed to. The format is a set "
2783 "of lines, where each line lists a file or files to install, and at the end "
2784 "of the line tells the directory it should be installed in. The name of the "
2785 "files (or directories) to install should be given relative to the current "
2786 "directory, while the installation directory is given relative to the package "
2787 "build directory. You may use wildcards in the names of the files to install "
2788 "(in v3 mode and above)."
2794 "This program may be used in one of two ways. If you just have a file or two "
2795 "that the upstream Makefile does not install for you, you can run dh_install "
2796 "on them to move them into place. On the other hand, maybe you have a large "
2797 "package that builds multiple binary packages. You can use the upstream "
2798 "Makefile to install it all into debian/tmp, and then use dh_install to copy "
2799 "directories and files from there into the proper package build directories."
2805 "From debhelper compatibility level 7 on, dh_install will fall back to "
2806 "looking in debian/tmp for files, if it doesn't find them in the current "
2807 "directory (or whereever you've told it to look using --sourcedir)."
2812 msgid "B<--list-missing>"
2818 "This option makes dh_install keep track of the files it installs, and then "
2819 "at the end, compare that list with the files in the source directory. If any "
2820 "of the files (and symlinks) in the source directory were not installed to "
2821 "somewhere, it will warn on stderr about that."
2827 "This may be useful if you have a large package and want to make sure that "
2828 "you don't miss installing newly added files in new upstream releases."
2834 "Note that files that are excluded from being moved via the -X option are not "
2840 msgid "B<--fail-missing>"
2846 "This option is like --list-missing, except if a file was missed, it will not "
2847 "only list the missing files, but also fail with a nonzero exit code."
2852 msgid "B<--sourcedir=dir>"
2857 msgid "Look in the specified directory for files to be installed."
2863 "Note that this is not the same as the --sourcedirectory option used by the "
2864 "dh_auto_* commands. You rarely need to use this option, since dh_install "
2865 "automatically looks for files in debian/tmp in debhelper compatibility level "
2871 msgid "B<--autodest>"
2877 "Guess as the destination directory to install things to. If this is "
2878 "specified, you should not list destination directories in "
2879 "debian/package.install files or on the command line. Instead, dh_install "
2880 "will guess as follows:"
2886 "Strip off debian/tmp (or the sourcedir if one is given) from the front of "
2887 "the filename, if it is present, and install into the dirname of the "
2888 "filename. So if the filename is debian/tmp/usr/bin, then that directory will "
2889 "be copied to debian/package/usr/. If the filename is debian/tmp/etc/passwd, "
2890 "it will be copied to debian/package/etc/."
2896 "Note that if you list exactly one filename or wildcard-pattern on a line by "
2897 "itself in a debian/package.install file, with no explicit destination, then "
2898 "dh_install will automatically guess the destination even if this flag is not "
2904 msgid "I<file [...] dest>"
2910 "Lists files (or directories) to install and where to install them to. The "
2911 "files will be installed into the first package dh_install acts on."
2922 "Suppose your package's upstream Makefile installs a binary, a man page, and "
2923 "a library into appropriate subdirectories of debian/tmp. You want to put the "
2924 "library into package libfoo, and the rest into package foo. Your rules file "
2925 "will run \"dh_install --sourcedir=debian/tmp\". Make debian/foo.install "
2934 " usr/share/man/man1\n"
2940 msgid "While debian/libfoo.install contains:"
2947 " usr/lib/libfoo*.so.*\n"
2954 "If you want a libfoo-dev package too, debian/libfoo-dev.install might "
2963 " usr/lib/libfoo*.so\n"
2964 " usr/share/man/man3\n"
2977 "dh_install cannot rename files or directories, it can only install them\n"
2978 "with the names they already have into wherever you want in the package\n"
2985 msgid "dh_installppp - install ppp ip-up and ip-down files"
2990 msgid "B<dh_installppp> [S<I<debhelper options>>] [B<--name=>I<name>]"
2996 "dh_installppp is a debhelper program that is responsible for installing ppp "
2997 "ip-up and ip-down scripts. into package build directories."
3003 "If a file named debian/package.ppp.ip-up exists, then it is installed into "
3004 "etc/ppp/ip-up.d/package in the package build directory. Files named "
3005 "debian/package.ppp.ip-down are installed to etc/ppp/ip-down.d/package"
3011 "Look for files named debian/package.name.ppp.ip-* and install them as "
3012 "etc/ppp/ip-*/name, instead of using the usual files and installing them as "
3018 msgid "dh_installwm - register a window manager"
3024 "B<dh_installwm> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] "
3031 "dh_installwm is a debhelper program that is responsible for generating the "
3032 "postinst and postrm commands that register a window manager with "
3033 "L<update-alternatives(8)>. The window manager's man page is also registered "
3034 "as a slave symlink (in v6 mode and up), if it is found in "
3035 "usr/share/man/man1/ in the package build directory."
3041 "Any window manager programs specified as parameters will be registered in "
3042 "the first package dh_installwm is told to act on. By default, this is the "
3043 "first binary package in debian/control, but if you use -p, -i, or -a flags, "
3044 "it will be the first package specified by those flags."
3050 "Files named debian/package.wm can list other window manager programs to "
3057 "Set the priority of the window manager. Default is 20, which is too low for "
3058 "most window managers; see the Debian Policy document for instructions on "
3059 "calculating the correct value."
3064 msgid "Do not modify postinst/postrm scripts. Turns this command into a no-op."
3075 "The commands used to run the window manager or window managers you want to "
3080 #: dh_installxfonts:5
3081 msgid "dh_installxfonts - register X fonts"
3085 #: dh_installxfonts:14
3086 msgid "B<dh_installxfonts> [S<I<debhelper options>>]"
3090 #: dh_installxfonts:18
3092 "dh_installxfonts is a debhelper program that is responsible for registering "
3093 "X fonts, so their corresponding fonts.dir, fonts.alias, and fonts.scale be "
3094 "rebuilt properly at install time."
3098 #: dh_installxfonts:22
3100 "Before calling this program, you should have installed any X fonts provided "
3101 "by your package into the appropriate location in the package build "
3102 "directory, and if you have fonts.alias or fonts.scale files, you should "
3103 "install them into the correct location under etc/X11/fonts in your package "
3108 #: dh_installxfonts:28
3110 "Your package should depend on xfonts-utils so that the update-fonts-* "
3111 "commands are available. (This program adds that dependency to "
3116 #: dh_installxfonts:32
3118 "This program automatically generates the postinst and postrm commands needed "
3119 "to register X fonts. These commands are inserted into the maintainer scripts "
3120 "by dh_installdeb. See L<dh_installdeb(1)> for an explanation of how this "
3125 #: dh_installxfonts:39
3127 "See L<update-fonts-alias(8)>, L<update-fonts-scale(8)>, and "
3128 "L<update-fonts-dir(8)> for more information about X font installation."
3132 #: dh_installxfonts:42
3134 "See Debian policy, section 11.8.5. for details about doing fonts the Debian "
3140 msgid "dh_link - create symlinks in package build directories"
3146 "B<dh_link> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] [S<I<source "
3147 "destination ...>>]"
3153 "dh_link is a debhelper program that creates symlinks in package build "
3160 "dh_link accepts a list of pairs of source and destination files. The source "
3161 "files are the already existing files that will be symlinked from. The "
3162 "destination files are the symlinks that will be created. There B<must> be an "
3163 "equal number of source and destination files specified."
3169 "The list can be specified in two ways. A file named debian/package.links can "
3170 "list pairs of files. If you use this file, you should put each pair of files "
3171 "on its own line, and separate the files within the pair with "
3172 "whitespace. Also, pairs of files can be specified as parameters - these "
3173 "pairs will only be created in the package build directory of the first "
3174 "package dh_link is told to act on. By default, this is the first binary "
3175 "package in debian/control, but if you use -p, -i, or -a flags, it will be "
3176 "the first package specified by those flags."
3182 "Be sure you B<do> specify the full filename to both the source and "
3183 "destination files (unlike you would do if you were using something like "
3190 "dh_link will generate symlinks that comply with debian policy - absolute "
3191 "when policy says they should be absolute, and relative links with as short a "
3192 "path as possible. It will also create any subdirectories it needs to to put "
3199 "dh_link also scans the package build tree for existing symlinks which do not "
3200 "conform to debian policy, and corrects them (v4 or later)."
3206 "Create any links specified by command line parameters in ALL packages acted "
3207 "on, not just the first."
3213 "Do not correct symlinks that contain \"item\" anywhere in their filename "
3214 "from being corrected to comply with debian policy."
3219 msgid "I<source destination ...>"
3225 "Create a file named \"destination\" as a link to a file named \"source\". Do "
3226 "this in the package build directory of the first package acted on. (Or in "
3227 "all packages if -A is specified.)"
3234 " dh_link usr/share/man/man1/foo.1 usr/share/man/man1/bar.1\n"
3240 msgid "Make bar.1 be a symlink to foo.1"
3247 " dh_link var/lib/foo usr/lib/foo \\\n"
3248 " usr/share/man/man1/foo.1 usr/share/man/man1/bar.1\n"
3255 "Make /usr/lib/foo/ be a link to /var/lib/foo/, and bar.1 be a symlink to the "
3260 #: dh_listpackages:5
3261 msgid "dh_listpackages - list binary packages debhelper will act on"
3265 #: dh_listpackages:14
3266 msgid "B<dh_listpackages> [S<I<debhelper options>>]"
3270 #: dh_listpackages:18
3272 "dh_listpackages is a debhelper program that outputs a list of all binary "
3273 "packages debhelper commands will act on. If you pass it some options, it "
3274 "will change the list to match the packages other debhelper commands would "
3275 "act on if passed the same options."
3280 msgid "dh_makeshlibs - automatically create shlibs file and call dpkg-gensymbols"
3286 "B<dh_makeshlibs> [S<I<debhelper options>>] [B<-m>I<major>] "
3287 "[B<-V>I<[dependencies]>] [B<-n>] [B<-X>I<item>] [S<B<--> I<params>>]"
3293 "dh_makeshlibs is a debhelper program that automatically scans for shared "
3294 "libraries, and generates a shlibs file for the libraries it finds."
3300 "It also adds a call to ldconfig in the postinst and postrm scripts (in V3 "
3301 "mode and above only) to any packages in which it finds shared libraries."
3307 "If a L<dpkg-gensymbols(1)> symbol file is found in debian/package.symbols "
3308 "(or debian/package.symbols.arch), dpkg-gensymbols will be called to process "
3309 "and install the symbols file."
3314 msgid "B<-m>I<major>, B<--major=>I<major>"
3320 "Instead of trying to guess the major number of the library with objdump, use "
3321 "the major number specified after the -m parameter. This is much less useful "
3322 "than it used to be, back in the bad old days when this program looked at "
3323 "library filenames rather than using objdump."
3328 msgid "B<-V>, B<-V>I<dependencies>"
3333 msgid "B<--version-info>, B<--version-info=>I<dependencies>"
3339 "By default, the shlibs file generated by this program does not make packages "
3340 "depend on any particular version of the package containing the shared "
3341 "library. It may be necessary for you to add some version dependancy "
3342 "information to the shlibs file. If -V is specified with no dependency "
3343 "information, the current upstream version of the package is plugged into a "
3344 "dependency that looks like \"packagename (>= packageversion)\". Note that in "
3345 "debhelper compatibility levels before v4, the debian part of the package "
3346 "version number is also included. If -V is specified with parameters, the "
3347 "parameters can be used to specify the exact dependency information needed "
3348 "(be sure to include the package name)."
3354 "Beware of using -V without any parameters; this is a conservative setting "
3355 "that always ensures that other packages' shared library dependencies are at "
3356 "least as tight as they need to be (unless your library is prone to changing "
3357 "ABI without updating the upstream version number), so that if the maintainer "
3358 "screws up then they won't break. The flip side is that packages might end up "
3359 "with dependencies that are too tight and so find it harder to be upgraded."
3365 "Exclude files that contain \"item\" anywhere in their filename or directory "
3366 "from being treated as shared libraries."
3371 msgid "B<--add-udeb=>I<udeb>"
3377 "Create an additional line for udebs in the shlibs file and use \"udeb\" as "
3378 "the package name for udebs to depend on instead of the regular library "
3384 msgid "Pass \"params\" to L<dpkg-gensymbols(1)>."
3389 msgid "dh_makeshlibs"
3396 "Assuming this is a package named libfoobar1, generates a shlibs file that\n"
3397 "looks something like:\n"
3398 " libfoobar 1 libfoobar1\n"
3404 msgid "dh_makeshlibs -V"
3411 "Assuming the current version of the package is 1.1-3, generates a shlibs\n"
3412 "file that looks something like:\n"
3413 " libfoobar 1 libfoobar1 (>= 1.1)\n"
3419 msgid "dh_makeshlibs -V 'libfoobar1 (>= 1.0)'"
3423 #: dh_makeshlibs:100
3426 "Generates a shlibs file that looks something like:\n"
3427 " libfoobar 1 libfoobar1 (>= 1.0)\n"
3433 msgid "dh_md5sums - generate DEBIAN/md5sums file"
3439 "B<dh_md5sums> [S<I<debhelper options>>] [B<-x>] [B<-X>I<item>] "
3440 "[B<--include-conffiles>]"
3446 "dh_md5sums is a debhelper program that is responsible for generating a "
3447 "DEBIAN/md5sums file, which lists the md5sums of each file in the package. "
3448 "These files are used by the debsums package."
3454 "All files in DEBIAN/ are omitted from the md5sums file, as are all conffiles "
3455 "(unless you use the --include-conffiles switch)."
3460 msgid "The md5sums file is installed with proper permissions and ownerships."
3465 msgid "B<-x>, B<--include-conffiles>"
3471 "Include conffiles in the md5sums list. Note that this information is "
3472 "redundant since it is included elsewhere in debian packages."
3478 "Exclude files that contain \"item\" anywhere in their filename from being "
3479 "listed in the md5sums file."
3484 msgid "dh_movefiles - move files out of debian/tmp into subpackages"
3490 "B<dh_movefiles> [S<I<debhelper options>>] [B<--sourcedir=>I<dir>] "
3491 "[B<-X>I<item>] S<I<file ...>>]"
3497 "dh_movefiles is a debhelper program that is responsible for moving files out "
3498 "of debian/tmp or some other directory and into other package build "
3499 "directories. This may be useful if your package has a Makefile that installs "
3500 "everything into debian/tmp, and you need to break that up into subpackages."
3506 "Files named debian/package.files list the files to be moved, separated by "
3507 "whitespace. The filenames listed should be relative to debian/tmp/. You can "
3508 "also list directory names, and the whole directory will be moved. If you "
3509 "prefer, you can list the files to move on the command line and this will "
3510 "apply to the first package dh_movefiles is told to act on."
3516 "Note: dh_install is a much better program, and you are recommended to use it "
3517 "instead of dh_movefiles."
3522 msgid "B<--sourcedir=>I<dir>"
3528 "Instead of moving files out of debian/tmp (the default), this option makes "
3529 "it move files out of some other directory. Since the entire contents of the "
3530 "sourcedir is moved, specifying something like --sourcedir=/ is very unsafe, "
3531 "so to prevent mistakes, the sourcedir must be a relative filename; it cannot "
3538 "Lists files to move. The filenames listed should be relative to "
3539 "debian/tmp/. You can also list directory names, and the whole directory will "
3540 "be moved. It is an error to list files here unless you use -p, -i, or -a to "
3541 "tell dh_movefiles which subpackage to put them in."
3547 "Note that files are always moved out of debian/tmp by default (even if you "
3548 "have instructed debhelper to use a compatibility level higher than one, "
3549 "which does not otherwise use debian/tmp for anything at all). The idea "
3550 "behind this is that the package that is being built can be told to install "
3551 "into debian/tmp, and then files can be moved by dh_movefiles from that "
3552 "directory. Any files or directories that remain are ignored, and get deleted "
3553 "by dh_clean later."
3558 msgid "dh_perl - calculates perl dependencies and cleans up after MakeMaker"
3563 msgid "B<dh_perl> [S<I<debhelper options>>] [B<-d>] [S<I<library dirs ...>>]"
3569 "dh_perl is a debhelper program that is responsible for generating the "
3570 "${perl:Depends} substitutions and adding them to substvars files."
3576 "The program will look at perl scripts and modules in your package, and will "
3577 "use this information to generate a dependency on perl or perlapi. The "
3578 "dependency will be substituted into your package's control file wherever you "
3579 "place the token \"${perl:Depends}\"."
3585 "dh_perl also cleans up empty directories that MakeMaker can generate when "
3586 "installing perl modules."
3597 "In some specific cases you may want to depend on perl-base rather than the "
3598 "full perl package. If so, you can pass the -d option to make dh_perl "
3599 "generate a dependency on the correct base package. This is only necessary "
3600 "for some packages that are included in the base system."
3606 "Note that this flag may cause no dependency on perl-base to be generated at "
3607 "all. perl-base is Essential, so its dependency can be left out, unless a "
3608 "versioned dependency is needed."
3619 "By default, scripts and architecture independent modules don't depend on any "
3620 "specific version of perl. The -V option causes the current version of the "
3621 "perl (or perl-base with -d) package to be specified."
3626 msgid "I<library dirs>"
3632 "If your package installs perl modules in non-standard directories, you can "
3633 "make dh_perl check those directories by passing their names on the command "
3634 "line. It will only check the vendorlib and vendorarch directories by "
3640 msgid "Debian policy, version 3.8.3"
3645 msgid "Perl policy, version 1.20"
3650 msgid "Brendan O'Dea <bod@debian.org>"
3656 "dh_python - calculates python dependencies and adds postinst and prerm "
3663 "B<dh_python> [S<I<debhelper options>>] [B<-n>] [B<-V> I<version>] "
3664 "[S<I<module dirs ...>>]"
3670 "Note: This program is deprecated. You should use dh_pysupport or "
3671 "dh_pycentral instead. This program will do nothing if debian/pycompat or a "
3672 "Python-Version control file field exists."
3678 "dh_python is a debhelper program that is responsible for generating the "
3679 "${python:Depends} substitutions and adding them to substvars files. It will "
3680 "also add a postinst and a prerm script if required."
3686 "The program will look at python scripts and modules in your package, and "
3687 "will use this information to generate a dependency on python, with the "
3688 "current major version, or on pythonX.Y if your scripts or modules need a "
3689 "specific python version. The dependency will be substituted into your "
3690 "package's control file wherever you place the token \"${python:Depends}\"."
3696 "If some modules need to be byte-compiled at install time, appropriate "
3697 "postinst and prerm scripts will be generated. If already byte-compiled "
3698 "modules are found, they are removed."
3703 msgid "If you use this program, your package should build-depend on python."
3708 msgid "I<module dirs>"
3714 "If your package installs python modules in non-standard directories, you can "
3715 "make dh_python check those directories by passing their names on the command "
3716 "line. By default, it will check /usr/lib/site-python, /usr/lib/$PACKAGE, "
3717 "/usr/share/$PACKAGE, /usr/lib/games/$PACKAGE, /usr/share/games/$PACKAGE and "
3718 "/usr/lib/python?.?/site-packages."
3724 "Note: only /usr/lib/site-python, /usr/lib/python?.?/site-packages and the "
3725 "extra names on the command line are searched for binary (.so) modules."
3730 msgid "B<-V> I<version>"
3736 "If the .py files your package ships are meant to be used by a specific "
3737 "pythonX.Y version, you can use this option to specify the desired version, "
3738 "such as 2.3. Do not use if you ship modules in /usr/lib/site-python."
3743 msgid "Debian policy, version 3.5.7"
3748 msgid "Python policy, version 0.3.7"
3753 msgid "Josselin Mouette <joss@debian.org>"
3758 msgid "most ideas stolen from Brendan O'Dea <bod@debian.org>"
3762 #: dh_scrollkeeper:5
3763 msgid "dh_scrollkeeper - deprecated no-op"
3767 #: dh_scrollkeeper:14
3768 msgid "B<dh_scrollkeeper> [S<I<debhelper options>>] [B<-n>] [S<I<directory>>]"
3772 #: dh_scrollkeeper:18
3774 "dh_scrollkeeper was a debhelper program that handled registering OMF files "
3775 "for ScrollKeeper. However, it no longer does anything, and is now "
3781 msgid "dh_shlibdeps - calculate shared library dependencies"
3787 "B<dh_shlibdeps> [S<I<debhelper options>>] [B<-L>I<package>] "
3788 "[B<-l>I<directory>] [B<-X>I<item>] [S<B<--> I<params>>]"
3794 "dh_shlibdeps is a debhelper program that is responsible for calculating "
3795 "shared library dependencies for packages."
3801 "This program is merely a wrapper around L<dpkg-shlibdeps(1)> that calls it "
3802 "once for each package listed in the control file, passing it a list of ELF "
3803 "executables and shared libraries it has found."
3808 msgid "B<-u>I<params>, B<--dpkg-shlibdeps-params=>I<params>"
3813 msgid "Pass \"params\" to L<dpkg-shlibdeps(1)>."
3819 "Exclude files that contain \"item\" anywhere in their filename from being "
3820 "passed to dpkg-shlibdeps. This will make their dependencies be ignored. "
3821 "This may be useful in some situations, but use it with caution. This option "
3822 "may be used more than once to exclude more than one thing."
3827 msgid "B<-l>I<directory>[:directory:directory:..]"
3832 msgid "With recent versions of dpkg-shlibdeps, this option is generally not needed."
3838 "Before dpkg-shlibdeps is run, LD_LIBRARY_PATH will have added to it the "
3839 "specified directory (or directories -- separate with colons). With recent "
3840 "versions of dpkg-shlibdeps, this is mostly only useful for packages that "
3841 "build multiple flavors of the same library, or other situations where the "
3842 "library is installed into a directory not on the regular library search "
3848 msgid "B<-L>I<package>, B<--libpackage=>I<package>"
3854 "With recent versions of dpkg-shlibdeps, this option is generally not needed, "
3855 "unless your package builds multiple flavors of the same library."
3861 "It tells dpkg-shlibdeps (via its -S parameter) to look first in the package "
3862 "build directory for the specified package, when searching for libraries, "
3863 "symbol files, and shlibs files."
3869 "Suppose that your source package produces libfoo1, libfoo-dev, and "
3870 "libfoo-bin binary packages. libfoo-bin links against libfoo1, and should "
3871 "depend on it. In your rules file, first run dh_makeshlibs, then "
3887 "This will have the effect of generating automatically a shlibs file for "
3888 "libfoo1, and using that file and the libfoo1 library in the "
3889 "debian/libfoo1/usr/lib directory to calculate shared library dependency "
3896 "If a libbar1 package is also produced, that is an alternate build of libfoo, "
3897 "and is installed into /usr/lib/bar/, you can make libfoo-bin depend on "
3898 "libbar1 as follows:"
3905 "\tdh_shlibdeps -Llibbar1 -l/usr/lib/bar\n"
3911 msgid "L<debhelper(7)>, L<dpkg-shlibdeps(1)>"
3916 msgid "dh_strip - strip executables, shared libraries, and some static libraries"
3922 "B<dh_strip> [S<I<debhelper options>>] [B<-X>I<item>] [--dbg-package=package] "
3929 "dh_strip is a debhelper program that is responsible for stripping "
3930 "executables, shared libraries, and static libraries that are not used for "
3937 "This program examines your package build directories and works out what to "
3938 "strip on its own. It uses L<file(1)> and file permissions and filenames to "
3939 "figure out what files are shared libraries (*.so), executable binaries, and "
3940 "static (lib*.a) and debugging libraries (lib*_g.a, debug/*.so), and strips "
3941 "each as much as is possible. (Which is not at all for debugging libraries.) "
3942 "In general it seems to make very good guesses, and will do the right thing "
3943 "in almost all cases."
3949 "Since it is very hard to automatically guess if a file is a module, and hard "
3950 "to determine how to strip a module, dh_strip does not currently deal with "
3951 "stripping binary modules such as .o files."
3957 "Exclude files that contain \"item\" anywhere in their filename from being "
3958 "stripped. You may use this option multiple times to build up a list of "
3959 "things to exclude."
3964 msgid "B<--dbg-package=>I<package>"
3970 "Causes dh_strip to save debug symbols stripped from the packages it acts on "
3971 "as independent files in the package build directory of the specified "
3972 "debugging package."
3978 "For example, if your packages are libfoo and foo and you want to include a "
3979 "foo-dbg package with debugging symbols, use dh_strip --dbg-package=foo-dbg."
3985 "Note that this option behaves significantly different in debhelper "
3986 "compatibility levels 4 and below. Instead of specifying the name of a debug "
3987 "package to put symbols in, it specifies a package (or packages) which should "
3988 "have separated debug symbols, and the separated symbols are placed in "
3989 "packages with \"-dbg\" added to their name."
3994 msgid "B<-k>, B<--keep-debug>"
4000 "Debug symbols will be retained, but split into an independent file in "
4001 "usr/lib/debug/ in the package build directory. --dbg-package is easier to "
4002 "use than this option, but this option is more flexible."
4008 "If the DEB_BUILD_OPTIONS environment variable contains \"nostrip\", nothing "
4009 "will be stripped, in accordance with Debian policy (section 10.1 "
4015 msgid "Debian policy, version 3.0.1"
4019 #: dh_suidregister:5
4020 msgid "dh_suidregister - obsolete suid registration program"
4024 #: dh_suidregister:9 dh_undocumented:14
4029 #: dh_suidregister:13
4031 "This program used to register suid and sgid files with L<suidregister(1)>, "
4032 "but with the introduction of L<dpkg-statoverride(8)>, registration of files "
4033 "in this way is unnecessary, and even harmful, so this program should not be "
4038 #: dh_suidregister:18
4039 msgid "CONVERTING TO STATOVERRIDE"
4043 #: dh_suidregister:20
4045 "Converting a package that uses this program to use the new statoverride "
4046 "mechanism is easy. Just remove the call to dh_suidregister from "
4047 "debian/rules, and add a versioned conflicts into your control file, as "
4052 #: dh_suidregister:25
4055 " Conflicts: suidmanager (<< 0.50)\n"
4060 #: dh_suidregister:27
4062 "The conflicts is only necessary if your package used to register things with "
4063 "suidmanager; if it did not, you can just remove the call to this program "
4064 "from your rules file."
4069 msgid "dh_testdir - test directory before building debian package"
4074 msgid "B<dh_testdir> [S<I<debhelper options>>] [S<I<file ...>>]"
4080 "dh_testdir tries to make sure that you are in the correct directory when "
4081 "building a debian package. It makes sure that the file debian/control "
4082 "exists, as well as any other files you specify. If not, it exits with an "
4088 msgid "Test for the existence of these files too."
4093 msgid "dh_testroot - ensure that a package is built as root"
4098 msgid "B<dh_testroot> [S<I<debhelper options>>]"
4104 "dh_testroot simply checks to see if you are root. If not, it exits with an "
4105 "error. Debian packages must be built as root, though you can use "
4111 msgid "dh_testversion - ensure that the correct version of debhelper is installed"
4115 #: dh_testversion:14
4116 msgid "B<dh_testversion> [S<I<debhelper options>>] [I<operator>] [I<version>]"
4120 #: dh_testversion:18
4121 msgid "Note: This program is deprecated. You should use build dependencies instead."
4125 #: dh_testversion:21
4127 "dh_testversion compares the version of debhelper against the version you "
4128 "specify, and if the condition is not met, exits with an error message."
4132 #: dh_testversion:24
4134 "You can use this in your debian/rules files if a new debhelper feature is "
4135 "introduced, and your package requires that feature to build correctly. Use "
4136 "debhelper's changelog to figure out the version you need."
4140 #: dh_testversion:28
4142 "Be sure not to overuse dh_testversion. If debhelper version 9.5 introduces a "
4143 "new dh_autofixbugs command, and your package uses it, then if someone tries "
4144 "to build it with debhelper 1.0, the build will fail anyway when "
4145 "dh_autofixbugs cannot be found, so there is no need for you to use "
4150 #: dh_testversion:38
4155 #: dh_testversion:40
4157 "Optional comparison operator used in comparing the versions. If not "
4158 "specified, \">=\" is used. For descriptions of the comparison operators, see "
4163 #: dh_testversion:44
4168 #: dh_testversion:46
4170 "Version number to compare against the current version of debhelper. If not "
4171 "specified, dh_testversion does nothing."
4175 #: dh_undocumented:5
4176 msgid "dh_undocumented - obsolete undocumented.7 symlink program"
4180 #: dh_undocumented:18
4182 "This program used to make symlinks to the undocumented.7 man page for man "
4183 "pages not present in a package. Debian policy now frowns on use of the "
4184 "undocumented.7 man page, and so this program does nothing, and should not be "
4190 msgid "dh_usrlocal - migrate usr/local directories to maintainer scripts"
4195 msgid "B<dh_usrlocal> [S<I<debhelper options>>] [B<-n>]"
4201 "dh_usrlocal is a debhelper program that can be used for building packages "
4202 "that will provide a subdirectory in /usr/local when installed."
4208 "It finds subdirectories of usr/local in the package build directory, and "
4209 "removes them, replacing them with maintainer script snippets (unless B<-n> "
4210 "is used) to create the directories at install time, and remove them when the "
4211 "package is removed, in a manner compliant with Debian policy. These snippets "
4212 "are inserted into the maintainer scripts by dh_installdeb. See "
4213 "L<dh_installdeb(1)> for an explanation of Debhelper maintainer script "
4220 "If the directories found in the build tree have unusual owners, groups, or "
4221 "permissions, then those values will be preserved in the directories made by "
4222 "the postinst script. However, as a special exception, if a directory is "
4223 "owned by root.root, it will be treated as if it is owned by root.staff and "
4224 "is mode 2775. This is useful, since that is the group and mode policy "
4225 "recommends for directories in /usr/local."
4230 msgid "Do not modify F<postinst>/F<prerm> scripts."
4235 msgid "Debian policy, version 2.2"
4240 msgid "Andrew Stribblehill <ads@debian.org>"
projects / debhelper.git / blob