1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Free Software Foundation, Inc.
3 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
8 "Project-Id-Version: PACKAGE VERSION\n"
9 "POT-Creation-Date: 2005-11-02 14:25-0500\n"
10 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
11 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
12 "Language-Team: LANGUAGE <LL@li.org>\n"
14 "Content-Type: text/plain; charset=CHARSET\n"
15 "Content-Transfer-Encoding: ENCODING"
18 #: dh_installpam:3 dh_installemacsen:3 dh_installinfo:3 dh_strip:3 dh_installppp:3 dh_compress:3 dh_md5sums:3 dh_installexamples:3 dh_installcron:3 dh_installinit:3 dh_usrlocal:3 dh_gconf:3 dh_installmodules:3 dh_installmenu:3 dh_installlogrotate:3 debhelper.pod:1 dh_clean:3 dh_undocumented:3 dh_testversion:3 dh_testdir:3 dh_shlibdeps:3 dh_scrollkeeper:3 dh_installdirs:3 dh_link:3 dh_installdebconf:3 dh_installmime:3 dh_installwm:3 dh_installdeb:3 dh_builddeb:3 dh_gencontrol:3 dh_install:3 dh_makeshlibs:3 dh_perl:3 dh_fixperms:3 dh_listpackages:3 dh_installman:3 dh_testroot:3 dh_movefiles:3 dh_desktop:3 dh_suidregister:3 dh_installchangelogs:3 dh_python:3 dh_installdocs:3 dh_installcatalogs:3 dh_installmanpages:3 dh_installxfonts:3 dh_installlogcheck:3
24 msgid "dh_installpam - install pam support files"
28 #: dh_installpam:12 dh_installemacsen:12 dh_installinfo:12 dh_strip:13 dh_installppp:12 dh_compress:13 dh_md5sums:13 dh_installexamples:12 dh_installcron:12 dh_installinit:12 dh_usrlocal:15 dh_gconf:12 dh_installmodules:14 dh_installmenu:12 dh_installlogrotate:12 debhelper.pod:5 dh_clean:12 dh_undocumented:12 dh_testversion:12 dh_testdir:12 dh_shlibdeps:13 dh_scrollkeeper:12 dh_installdirs:12 dh_link:13 dh_installdebconf:12 dh_installmime:12 dh_installwm:12 dh_installdeb:12 dh_builddeb:12 dh_gencontrol:12 dh_install:13 dh_makeshlibs:12 dh_perl:14 dh_fixperms:12 dh_listpackages:12 dh_installman:13 dh_testroot:7 dh_movefiles:12 dh_desktop:12 dh_suidregister:7 dh_installchangelogs:12 dh_python:13 dh_installdocs:12 dh_installcatalogs:14 dh_installmanpages:13 dh_installxfonts:12 dh_installlogcheck:12
34 msgid "B<dh_installpam> [S<I<debhelper options>>] [B<--name=>I<name>]"
38 #: dh_installpam:16 dh_installemacsen:16 dh_installinfo:16 dh_strip:17 dh_installppp:16 dh_compress:17 dh_md5sums:17 dh_installexamples:16 dh_installcron:16 dh_installinit:16 dh_usrlocal:19 dh_gconf:16 dh_installmodules:18 dh_installmenu:16 dh_installlogrotate:16 debhelper.pod:9 dh_clean:16 dh_undocumented:16 dh_testversion:16 dh_testdir:16 dh_shlibdeps:17 dh_scrollkeeper:16 dh_installdirs:16 dh_link:17 dh_installdebconf:16 dh_installmime:16 dh_installwm:16 dh_installdeb:16 dh_builddeb:16 dh_gencontrol:16 dh_install:17 dh_makeshlibs:16 dh_perl:18 dh_fixperms:16 dh_listpackages:16 dh_installman:17 dh_testroot:11 dh_movefiles:16 dh_desktop:16 dh_suidregister:11 dh_installchangelogs:16 dh_python:17 dh_installdocs:16 dh_installcatalogs:18 dh_installmanpages:17 dh_installxfonts:16 dh_installlogcheck:16
45 "dh_installpam is a debhelper program that is responsible for installing "
46 "files used by PAM into package build directories."
52 "If a file named debian/package.pam exists, then it is installed into "
53 "etc/pam.d/package in the package build directory."
57 #: dh_installpam:24 dh_installemacsen:34 dh_installinfo:36 dh_strip:35 dh_installppp:26 dh_compress:38 dh_md5sums:28 dh_installexamples:29 dh_installcron:24 dh_installinit:33 dh_usrlocal:38 dh_installmodules:35 dh_installmenu:33 dh_installlogrotate:22 dh_clean:25 dh_testversion:34 dh_testdir:23 dh_shlibdeps:26 dh_scrollkeeper:31 dh_installdirs:32 dh_link:48 dh_installdebconf:59 dh_installmime:30 dh_installwm:30 dh_builddeb:21 dh_gencontrol:26 dh_install:43 dh_makeshlibs:24 dh_perl:28 dh_fixperms:31 dh_installman:54 dh_movefiles:32 dh_installchangelogs:40 dh_python:35 dh_installdocs:51 dh_installcatalogs:42 dh_installmanpages:40
62 #: dh_installpam:28 dh_installppp:30 dh_installcron:28 dh_installinit:65 dh_installmodules:43 dh_installlogrotate:26
63 msgid "B<--name=>I<name>"
69 "Look for files named debian/package.name.pam and install them as "
70 "etc/pam.d/name, instead of using the usual files and installing them as the "
75 #: dh_installpam:52 dh_installemacsen:108 dh_installinfo:122 dh_strip:221 dh_installppp:56 dh_compress:189 dh_md5sums:86 dh_installexamples:102 dh_installcron:61 dh_installinit:188 dh_usrlocal:113 dh_gconf:58 dh_installmodules:102 dh_installmenu:79 dh_installlogrotate:50 debhelper.pod:433 dh_clean:109 dh_undocumented:28 dh_testversion:74 dh_testdir:43 dh_shlibdeps:148 dh_scrollkeeper:75 dh_installdirs:87 dh_link:206 dh_installdebconf:135 dh_installmime:84 dh_installwm:94 dh_installdeb:93 dh_builddeb:78 dh_gencontrol:73 dh_install:251 dh_makeshlibs:183 dh_perl:140 dh_fixperms:107 dh_listpackages:28 dh_installman:210 dh_testroot:26 dh_movefiles:162 dh_desktop:43 dh_suidregister:117 dh_installchangelogs:125 dh_python:266 dh_installdocs:232 dh_installcatalogs:105 dh_installmanpages:197 dh_installxfonts:83 dh_installlogcheck:51
80 #: dh_installpam:54 dh_installemacsen:110 dh_installinfo:124 dh_strip:223 dh_installppp:58 dh_compress:191 dh_md5sums:88 dh_installexamples:104 dh_installcron:63 dh_installinit:190 dh_usrlocal:115 dh_gconf:60 dh_installmodules:104 dh_installlogrotate:52 dh_clean:111 dh_undocumented:30 dh_testversion:76 dh_testdir:45 dh_installdirs:89 dh_link:208 dh_installdebconf:137 dh_installmime:86 dh_installwm:96 dh_installdeb:95 dh_builddeb:80 dh_gencontrol:75 dh_install:253 dh_makeshlibs:185 dh_perl:142 dh_fixperms:109 dh_listpackages:30 dh_installman:212 dh_testroot:28 dh_movefiles:164 dh_suidregister:119 dh_installchangelogs:127 dh_python:268 dh_installdocs:234 dh_installcatalogs:107 dh_installmanpages:199 dh_installxfonts:85 dh_installlogcheck:53
81 msgid "L<debhelper(7)>"
85 #: dh_installpam:56 dh_installemacsen:112 dh_installinfo:126 dh_strip:225 dh_installppp:60 dh_compress:193 dh_md5sums:90 dh_installexamples:106 dh_installcron:65 dh_installinit:192 dh_usrlocal:117 dh_gconf:62 dh_installmodules:106 dh_installmenu:85 dh_installlogrotate:54 dh_clean:113 dh_undocumented:32 dh_testversion:78 dh_testdir:47 dh_shlibdeps:152 dh_scrollkeeper:79 dh_installdirs:91 dh_link:210 dh_installdebconf:139 dh_installmime:88 dh_installwm:98 dh_installdeb:97 dh_builddeb:82 dh_gencontrol:77 dh_install:255 dh_makeshlibs:187 dh_perl:144 dh_fixperms:111 dh_listpackages:32 dh_installman:214 dh_testroot:30 dh_movefiles:166 dh_desktop:47 dh_suidregister:121 dh_installchangelogs:129 dh_python:270 dh_installdocs:236 dh_installmanpages:201 dh_installxfonts:87
86 msgid "This program is a part of debhelper."
90 #: dh_installpam:58 dh_installemacsen:114 dh_installinfo:128 dh_strip:227 dh_installppp:62 dh_compress:195 dh_md5sums:92 dh_installexamples:108 dh_installcron:67 dh_installinit:194 dh_usrlocal:119 dh_gconf:64 dh_installmodules:108 dh_installmenu:87 dh_installlogrotate:56 debhelper.pod:447 dh_clean:115 dh_undocumented:34 dh_testversion:80 dh_testdir:49 dh_shlibdeps:154 dh_scrollkeeper:81 dh_installdirs:93 dh_link:212 dh_installdebconf:141 dh_installmime:90 dh_installwm:100 dh_installdeb:99 dh_builddeb:84 dh_gencontrol:79 dh_install:257 dh_makeshlibs:189 dh_perl:146 dh_fixperms:113 dh_listpackages:34 dh_installman:216 dh_testroot:32 dh_movefiles:168 dh_desktop:49 dh_suidregister:123 dh_installchangelogs:131 dh_python:272 dh_installdocs:238 dh_installcatalogs:111 dh_installmanpages:203 dh_installxfonts:89 dh_installlogcheck:57
95 #: dh_installpam:60 dh_installemacsen:116 dh_installinfo:130 dh_strip:229 dh_installppp:64 dh_compress:197 dh_md5sums:94 dh_installexamples:110 dh_installcron:69 dh_installinit:196 dh_installmodules:110 dh_installmenu:89 dh_installlogrotate:58 debhelper.pod:449 dh_clean:117 dh_undocumented:36 dh_testversion:82 dh_testdir:51 dh_shlibdeps:156 dh_installdirs:95 dh_link:214 dh_installdebconf:143 dh_installmime:92 dh_installwm:102 dh_installdeb:101 dh_builddeb:86 dh_gencontrol:81 dh_install:259 dh_makeshlibs:191 dh_fixperms:115 dh_listpackages:36 dh_installman:218 dh_testroot:34 dh_movefiles:170 dh_suidregister:125 dh_installchangelogs:133 dh_installdocs:240 dh_installmanpages:205 dh_installxfonts:91
96 msgid "Joey Hess <joeyh@debian.org>"
100 #: dh_installemacsen:5
101 msgid "dh_installemacsen - register an emacs add on package"
105 #: dh_installemacsen:14
107 "B<dh_installemacsen> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] "
108 "[B<--flavor=>I<foo>]"
112 #: dh_installemacsen:18
114 "dh_installemacsen is a debhelper program that is responsible for installing "
115 "files used by the debian emacsen-common package into package build "
120 #: dh_installemacsen:22
122 "It also automatically generates the postinst and prerm commands needed to "
123 "register a package as an emacs add on package. See L<dh_installdeb(1)> for "
124 "an explanation of how this works."
128 #: dh_installemacsen:26
130 "If a file named debian/package.emacsen-install exists, then it is installed "
131 "into usr/lib/emacsen-common/packages/install/package in the package build "
132 "directory. Similarly, debian/package.emacsen-remove is installed into "
133 "usr/lib/emacsen-common/packages/remove/package . And similarly, "
134 "debian/package.emacsen-startup is installed into "
135 "etc/emacs/site-start.d/50<package>.el (by default)."
139 #: dh_installemacsen:38 dh_installinfo:45 dh_installinit:37 dh_usrlocal:42 dh_installmodules:39 dh_installmenu:37 dh_scrollkeeper:35 dh_installdebconf:63 dh_installmime:34 dh_installwm:40 dh_makeshlibs:58 dh_python:56 dh_installdocs:60 dh_installcatalogs:46
140 msgid "B<-n>, B<--noscripts>"
144 #: dh_installemacsen:40 dh_installinfo:47 dh_installdocs:62
145 msgid "Do not modify postinst/prerm scripts."
149 #: dh_installemacsen:42 dh_installwm:34
150 msgid "B<--priority=>I<n>"
154 #: dh_installemacsen:44
155 msgid "Sets the priority number of a site-start.d file. Default is 50."
159 #: dh_installemacsen:46
160 msgid "B<--flavor=>I<foo>"
164 #: dh_installemacsen:48
166 "Sets the flavor a site-start.d file will be installed in. Default is "
167 "\"emacs\", alternatives include \"xemacs\" and \"emacs20\"."
171 #: dh_installemacsen:53 dh_installinfo:56 dh_strip:74 dh_installexamples:50 dh_installinit:92 dh_usrlocal:48 dh_installmodules:52 debhelper.pod:158 dh_scrollkeeper:41 dh_installmime:40 dh_installwm:49 dh_installman:70 dh_movefiles:58 dh_installdocs:87 dh_installcatalogs:52 dh_installxfonts:36
176 #: dh_installemacsen:55 dh_installinfo:58 dh_installinit:94 dh_usrlocal:50 dh_installmodules:54 dh_scrollkeeper:43 dh_installmime:42 dh_installwm:51 dh_installcatalogs:54
178 "Note that this command is not idempotent. \"dh_clean -k\" should be called "
179 "between invocations of this command. Otherwise, it may cause multiple "
180 "instances of the same text to be added to maintainer scripts."
185 msgid "dh_installinfo - install and register info files"
190 msgid "B<dh_installinfo> [S<I<debhelper options>>] [B<-A>] [B<-n>] [S<I<file ...>>]"
196 "dh_installinfo is a debhelper program that is responsible for installing "
197 "info files and registering the files it installs with install-info."
203 "It determines some information about the info files by parsing them, in "
204 "particular, it looks at the INFO-DIR-SECTION line to determine what section "
205 "the info file belongs in."
211 "Any filenames specified as parameters will be installed into the first "
212 "package dh_installinfo is told to act on. By default, this is the first "
213 "binary package in debian/control, but if you use -p, -i, or -a flags, it "
214 "will be the first package specified by those flags."
219 msgid "Files named debian/package.info can list other files to be installed."
225 "dh_installinfo will automatically generate the postinst and prerm commands "
226 "needed to interface with install-info, updating the info . See "
227 "L<dh_installdeb(1)> for an explanation of how this works."
231 #: dh_installinfo:40 dh_compress:50 dh_installexamples:33 debhelper.pod:151 dh_installdirs:36 dh_link:52 dh_installman:58 dh_installdocs:55
232 msgid "B<-A>, B<--all>"
236 #: dh_installinfo:42 dh_installman:60 dh_installdocs:57
238 "Install all files specified by command line parameters in ALL packages acted "
243 #: dh_installinfo:49 dh_compress:55 dh_installexamples:38 dh_clean:50 dh_testdir:27 dh_movefiles:49 dh_installdocs:69 dh_installmanpages:44
250 "Install these info files into the first package acted on. (Or in all "
251 "packages if -A is specified)."
256 msgid "dh_strip - strip executables, shared libraries, and some static libraries"
262 "B<dh_strip> [S<I<debhelper options>>] [B<-X>I<item>] [--dbg-package=package] "
269 "dh_strip is a debhelper program that is responsible for stripping "
270 "executables, shared libraries, and static libraries that are not used for "
277 "This program examines your package build directories and works out what to "
278 "strip on its own. It uses L<file(1)> and file permissions and filenames to "
279 "figure out what files are shared libraries (*.so), executable binaries, and "
280 "static (lib*.a) and debugging libraries (lib*_g.a, debug/*.so), and strips "
281 "each as much as is possible. (Which is not at all for debugging libraries.) "
282 "In general it seems to make very good guesses, and will do the right thing "
283 "in almost all cases."
289 "Since it is very hard to automatically guess if a file is a module, and hard "
290 "to determine how to strip a module, dh_strip does not currently deal with "
291 "stripping binary modules such as .o files."
295 #: dh_strip:39 dh_compress:42 dh_md5sums:37 debhelper.pod:146 dh_shlibdeps:36 dh_makeshlibs:62
296 msgid "B<-X>I<item>, B<--exclude=>I<item>"
302 "Exclude files that contain \"item\" anywhere in their filename from being "
303 "stripped. You may use this option multiple times to build up a list of "
309 msgid "B<--dbg-package=>I<package>"
315 "Causes dh_strip to save debug symbols stripped from the packages it acts on "
316 "as independent files in the package build directory of the specified "
323 "For example, if your packages are lifoo and foo and you want to include a "
324 "foo-dbg package with debugging symbols, use dh_strip --dbg-package=foo-dbg."
330 "Note that this option behaves significantly different in debhelper "
331 "compatibility levels 4 and below. Instead of specifying the name of a debug "
332 "package to put symbols in, it specifies a package (or packages) which should "
333 "have separated debug symbols, and the separated symbols are placed in "
334 "packages with \"-dbg\" added to their name."
340 "Note that if you use this option, your package should build-depend on "
341 "binutils (>= 2.14.90.0.7)."
346 msgid "B<-k>, B<--keep-debug>"
352 "Debug symbols will be retained, but split into an independent file in "
353 "usr/lib/debug/ in the package build directory. --dbg-package is easier to "
354 "use than this option, but this option is more flexible."
360 "Note that if you use this option, your package should build-depend on "
361 "binutils (>= 2.12.90.0.9)."
367 "If the DEB_BUILD_OPTIONS environment variable contains \"nostrip\", nothing "
368 "will be stripped, in accordance with Debian policy."
372 #: dh_strip:79 dh_compress:61 dh_usrlocal:54 dh_perl:58 dh_python:62
377 #: dh_strip:81 dh_perl:60
378 msgid "Debian policy, version 3.0.1"
383 msgid "dh_installppp - install ppp ip-up and ip-down files"
388 msgid "B<dh_installppp> [S<I<debhelper options>>] [B<--name=>I<name>]"
394 "dh_installppp is a debhelper program that is responsible for installing ppp "
395 "ip-up and ip-down scripts. into package build directories."
401 "If a file named debian/package.ppp.ip-up exists, then it is installed into "
402 "etc/ppp/ip-up.d/package in the package build directory. Files named "
403 "debian/package.ppp.ip-down are installed to etc/ppp/ip-down.d/package"
409 "Look for files named debian/package.name.ppp.ip-* and install them as "
410 "etc/ppp/ip-*/name, instead of using the usual files and installing them as "
416 msgid "dh_compress - compress files and fix symlinks in package build directories"
422 "B<dh_compress> [S<I<debhelper options>>] [B<-X>I<item>] [B<-A>] [S<I<file "
429 "dh_compress is a debhelper program that is responsible for compressing the "
430 "files in package build directories, and makes sure that any symlinks that "
431 "pointed to the files before they were compressed are updated to point to the "
438 "By default, dh_compress compresses files that debian policy mandates should "
439 "be compressed, namely all files in usr/share/info, usr/share/man, "
440 "usr/X11R6/man, files in usr/share/doc that are larger than 4k in size, "
441 "(except the copyright file, .html and .css files, and files that appear to "
442 "be already compressed based on their extensions), and all changelog "
443 "files. Plus PCF fonts underneath usr/X11R6/lib/X11/fonts/"
449 "If a debian/package.compress file exists, however, it will be ran as a shell "
450 "script, and all filenames that the shell script outputs will be compressed "
451 "instead of the default files. The shell script will be run from inside the "
452 "package build directory. Note though that using -X is a much better idea in "
453 "general; you should only use a debian/package.compress file if you really "
460 "Exclude files that contain \"item\" anywhere in their filename from being "
461 "compressed. For example, -X.jpeg will exclude jpeg files from compression. "
462 "You may use this option multiple times to build up a list of things to "
463 "exclude. You can accomplish the same thing by using a debian/compress file, "
464 "but this is easier."
470 "Compress all files specified by command line parameters in ALL packages "
476 msgid "Add these files to the list of files to compress."
481 msgid "Debian policy, version 3.0"
486 msgid "dh_md5sums - generate DEBIAN/md5sums file"
492 "B<dh_md5sums> [S<I<debhelper options>>] [B<-x>] [B<-X>I<item>] "
493 "[B<--include-conffiles>]"
499 "dh_md5sums is a debhelper program that is responsible for generating a "
500 "DEBIAN/md5sums file, which lists the md5sums of each file in the package. "
501 "These files are used by the debsums package."
507 "All files in DEBIAN/ are omitted from the md5sums file, as are all conffiles "
508 "(unless you use the --include-conffiles switch)."
513 msgid "The md5sums file is installed with proper permissions and ownerships."
518 msgid "B<-x>, B<--include-conffiles>"
524 "Include conffiles in the md5sums list. Note that this information is "
525 "redundant since it is included elsewhere in debian packages."
531 "Exclude files that contain \"item\" anywhere in their filename from being "
532 "listed in the md5sums file."
536 #: dh_installexamples:5
537 msgid "dh_installexamples - install example files into package build directories"
541 #: dh_installexamples:14
543 "B<dh_installexamples> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] "
548 #: dh_installexamples:18
550 "dh_installexamples is a debhelper program that is responsible for installing "
551 "examples into usr/share/doc/package/examples in package build directories."
555 #: dh_installexamples:22
557 "Any file names specified as parameters will be installed into the first "
558 "package dh_installexamples is told to act on. By default, this is the first "
559 "binary package in debian/control, but if you use -p, -i, or -a flags, it "
560 "will be the first package specified by those flags."
564 #: dh_installexamples:27
565 msgid "Files named debian/package.examples can list other files to be installed."
569 #: dh_installexamples:35
571 "Install any files specified by command line parameters in ALL packages acted "
576 #: dh_installexamples:40
578 "Install these files as examples into the first package acted on. (Or into "
579 "all packages if -A is specified.)"
583 #: dh_installexamples:43 dh_install:47 dh_movefiles:44 dh_installdocs:64
584 msgid "B<-Xitem>, B<--exclude=item>"
588 #: dh_installexamples:45 dh_install:49 dh_movefiles:46 dh_installdocs:66
590 "Exclude files that contain \"item\" anywhere in their filename from being "
595 #: dh_installexamples:52
597 "Note that dh_installexamples will happily copy entire directory hierarchies "
598 "if you ask it to (similar to cp -a). If it is asked to install a directory, "
599 "it will install the complete contents of the directory."
604 msgid "dh_installcron - install cron scripts into etc/cron.*"
609 msgid "B<dh_installcron> [S<B<debhelper options>>] [B<--name=>I<name>]"
615 "dh_installcron is a debhelper program that is responsible for installing "
616 "cron scripts into etc/cron.*/ in package build directories. The files "
617 "debian/package.cron.daily, debian/package.cron.weekly, "
618 "debian/package.cron.monthly, debian/package.cron.hourly, and "
619 "debian/package.cron.d are installed."
625 "Look for files named debian/package.name.cron.* and install them as "
626 "etc/cron.*/name, instead of using the usual files and installing them as the "
632 msgid "dh_installinit - install init scripts into package build directories"
638 "B<dh_installinit> [S<I<debhelper options>>] [B<--name=>I<name>] [B<-n>] "
639 "[B<-r>] [B<-d>] [S<B<--> I<params>>]"
645 "dh_installinit is a debhelper program that is responsible for installing "
646 "init scripts and associated defaults files into package build directories."
652 "It also automatically generates the postinst and postrm and prerm commands "
653 "needed to set up the symlinks in /etc/rc*.d/ and to start and stop the init "
660 "If a file named debian/package.init exists, then it is installed into "
661 "etc/init.d/package in the package build directory, with \"package\" replaced "
662 "by the package name."
668 "If a file named debian/package.default exists, then it is installed into "
669 "etc/default/package in the package build directory, with \"package\" "
670 "replaced by the package name."
675 msgid "Do not modify postinst/postrm/prerm scripts."
680 msgid "B<-r>, B<--no-restart-on-upgrade>"
685 msgid "Do not restart init script on upgrade."
690 msgid "B<--no-start>"
696 "Do not start the init script on install or upgrade, or stop it on removal. "
697 "Only call update-rc.d. Useful for rcS scripts."
702 msgid "B<-d>, B<--remove-d>"
708 "Remove trailing \"d\" from the name of the package, and use the result for "
709 "the filename the init script is installed as in etc/init.d/ , and the "
710 "default file is installed as in etc/default/ . This may be useful for "
711 "daemons with names ending in \"d\". (Note: this takes precedence over the "
712 "--init-script parameter described below.)"
717 msgid "B<-u>I<params> B<--update-rcd-params=>I<params>"
721 #: dh_installinit:60 dh_shlibdeps:32 dh_installdebconf:67 dh_builddeb:37 dh_gencontrol:32
722 msgid "B<--> I<params>"
728 "Pass \"params\" to L<update-rc.d(8)>. If not specified, \"defaults\" will be "
729 "passed to L<update-rc.d(8)>."
735 "Install the init script (and default file) using the filename I<name> "
736 "instead of the default filename, which is the package name. When this "
737 "parameter is used, dh_installinit looks for and installs files named "
738 "debian/package.name.init and debian/package.name.default, instead of the "
739 "usual debian/package.init and debian/package.default."
744 msgid "B<--init-script=>I<scriptname>"
750 "Use \"scriptname\" as the filename the init script is installed as in "
751 "etc/init.d/ (and also use it as the filename for the defaults file, if it is "
752 "installed). If you use this parameter, dh_installinit will look to see if a "
753 "file in the debian/ directory exists that looks like \"package.scriptname\" "
754 "and if so will install it as the init script in preference to the files it "
760 msgid "This parameter is deprecated, use the --name parameter instead."
765 msgid "B<--error-handler=>I<function>"
771 "Call the named shell function if running the init script fails. The function "
772 "should be provided in the prerm and postinst scripts, before the #DEBHELPER# "
778 msgid "dh_usrlocal - migrate usr/local directories to maintainer scripts"
783 msgid "B<dh_usrlocal> [S<I<debhelper options>>] [B<-n>]"
789 "dh_usrlocal is a debhelper program that can be used for building packages "
790 "that will provide a subdirectory in /usr/local when installed."
796 "It finds subdirectories of usr/local in the package build directory, and "
797 "removes them, replacing them with maintainer script snippets (unless B<-n> "
798 "is used) to create the directories at install time, and remove them when the "
799 "package is removed, in a manner compliant with Debian policy. See "
800 "L<dh_installdeb(1)> for an explanation of Debhelper maintainer script "
807 "If the directories found in the build tree have unusual owners, groups, or "
808 "permissions, then those values will be preserved in the directories made by "
809 "the postinst script. However, as a special exception, if a directory is "
810 "owned by root.root, it will be treated as if it is owned by root.staff and "
811 "is mode 2775. This is useful, since that is the group and mode policy "
812 "recommends for directories in /usr/local."
817 msgid "Do not modify F<postinst>/F<prerm> scripts."
822 msgid "Debian policy, version 2.2"
827 msgid "Andrew Stribblehill <ads@debian.org>"
832 msgid "dh_gconf - generate GConf schema registration scripts"
837 msgid "B<dh_gconf> [S<I<debhelper options>>] [B<-p<package>>]"
843 "dh_gconf is a debhelper program that is responsible for registering GConf "
850 "It automatically generates the postinst and prerm fragments needed to "
851 "register and unregister the schemas in usr/share/gconf/schemas. These "
852 "fragments will use gconftool-2, so the package should depend on gconf2. This "
853 "program will add an appropriate dependency to ${misc:Depends}."
859 "The postinst script will also signal gconfd-2 so that the newly installed "
860 "schemas are available straight away."
864 #: dh_gconf:66 dh_scrollkeeper:83 dh_desktop:51
865 msgid "Ross Burton <ross@burtonini.com>"
869 #: dh_installmodules:5
870 msgid "dh_installmodules - register modules with modutils"
874 #: dh_installmodules:16
875 msgid "B<dh_installmodules> [S<I<debhelper options>>] [B<-n>] [B<--name=>I<name>]"
879 #: dh_installmodules:20
881 "dh_installmodules is a debhelper program that is responsible for registering "
882 "kernel modules with modutils."
886 #: dh_installmodules:23
888 "Files named debian/package.modules will be installed as etc/modutils/package "
889 "in the package build directory. This is for use by modutils. Files named "
890 "debian/package.modprobe will be installed in etc/modprobe.d/package in the "
891 "package build directory, to be used by module-init-tools's version of "
896 #: dh_installmodules:29
898 "Then postinst and postrm commands are automatically generated to register "
899 "the modules when the package is installed. See L<dh_installdeb(1)> for an "
900 "explanation of how this works. Note that this will be done for any package "
901 "this program acts on which has either a package.modules file, or has .o or "
902 ".ko files in /lib/modules."
906 #: dh_installmodules:41 dh_installmenu:39 dh_installmime:36 dh_makeshlibs:60 dh_python:58
907 msgid "Do not modify postinst/postrm scripts."
911 #: dh_installmodules:45
913 "Use \"name\" as the filename the modules file is installed in "
914 "etc/modutils/. When this parameter is used, dh_installmodules looks for and "
915 "installs files named debian/package.name.modules instead of the usual "
916 "debian/package.modules."
921 msgid "dh_installmenu - install debian menu files into package build directories"
926 msgid "B<dh_installmenu> [S<B<debhelper options>>] [B<-n>]"
932 "dh_installmenu is a debhelper program that is responsible for installing "
933 "files used by the debian menu package into package build directories."
939 "It also automatically generates the postinst and postrm commands needed to "
940 "interface with the debian menu package. See L<dh_installdeb(1)> for an "
941 "explanation of how this works."
947 "If a file named debian/package.menu exists, then it is installed into "
948 "usr/share/menu/package in the package build directory. This is a debian menu "
949 "file. See L<menufile(5)> for its format."
955 "If a file named debian/package.menu-method exits, then it is installed into "
956 "etc/menu-methods/package in the package build directory. This is a debian "
962 msgid "L<debhelper(7)> L<update-menus(1)> L<menufile(5)>"
966 #: dh_installlogrotate:5
967 msgid "dh_installlogrotate - install logrotate config files"
971 #: dh_installlogrotate:14
972 msgid "B<dh_installlogrotate> [S<I<debhelper options>>] [B<--name=>I<name>]"
976 #: dh_installlogrotate:18
978 "dh_installlogrotate is a debhelper program that is responsible for "
979 "installing logrotate config files into etc/logrotate.d in package build "
980 "directories. Files named debian/package.logrotate are installed."
984 #: dh_installlogrotate:28
986 "Look for files named debian/package.name.logrotate and install them as "
987 "etc/logrotate.d/name, instead of using the usual files and installing them "
988 "as the package name."
993 msgid "debhelper - the debhelper tool suite"
999 "B<dh_>I<*> [B<-v>] [B<-a>] [B<-i>] [B<-s>] [B<--no-act>] [B<-ppackage>] "
1000 "[B<-Npackage] [-Ptmpdir>]"
1006 "Debhelper is used to help you build a debian package. The philosophy behind "
1007 "debhelper is to provide a collection of small, simple, and easily understood "
1008 "tools that are used in debian/rules to automate various common aspects of "
1009 "building a package. This means less work for you, the packager. It also, to "
1010 "some degree means that these tools can be changed if debian policy changes, "
1011 "and packages that use them will require only a rebuild to comply with the "
1018 "A typical debian/rules file that uses debhelper will call several debhelper "
1019 "commands in sequence. Debhelper commands are all named with a \"dh_\" "
1020 "prefix. Examples of rules files that use debhelper are in "
1021 "F</usr/share/doc/debhelper/examples/>"
1027 "To create a new debian package using debhelper, you can just copy one of the "
1028 "sample rules files and edit it by hand. Or you can try the dh-make package, "
1029 "which contains a L<dh_make|dh_make(1)> command that partially automates the "
1030 "process. For a more gentle introduction, the maint-guide debian package "
1031 "contains a tutorial about making your first package using debhelper."
1036 msgid "DEBHELPER COMMANDS"
1042 "Here is the complete list of available debhelper commands. See their man "
1043 "pages for additional documentation."
1054 "If a program's name starts with \"dh_\", and the program is not on the above "
1055 "list, then it is not part of the debhelper package, but it should still work "
1056 "like the other programs described on this page."
1061 msgid "DEBHELPER CONFIG FILES"
1067 "Many debhelper commands make use of files in F<debian/> to control what they "
1068 "do. Besides the common F<debian/changelog> and F<debian/control>, which are "
1069 "in all packages, not just those using debhelper, some additional files can "
1070 "be used to configure the behavior of specific debhelper commands. These "
1071 "files are typically named debian/package.foo (where \"package\" of course, "
1072 "is replaced with the package that is being acted on)."
1078 "For example, dh_installdocs uses files named debian/package.docs to list the "
1079 "documentation files it will install. See the man pages of individual "
1080 "commands for details about the names and formats of the files they use. "
1081 "Generally, these files will list files to act on, one file per line. Some "
1082 "programs in debhelper use pairs of files and destinations or slightly more "
1083 "complicated formats."
1089 "Note that if a package is the first (or only) binary package listed in "
1090 "debian/control, debhelper will use debian/foo if no debian/package.foo file "
1097 "In some rare cases, you may want to have different versions of these files "
1098 "for different architectures. If files named debian/package.foo.arch exist, "
1099 "where \"arch\" is the same as the output of \"dpkg --print-architecture\", "
1100 "then they will be used in preference to other, more general files."
1106 "In many cases, these config files are used to specify various types of "
1107 "files. Documentation or example files to install, files to move, and so on. "
1108 "When appropriate, in cases like these, you can use standard shell wildcard "
1109 "characters ('?' and '*' and '[..]' character classes) in the files."
1115 "You can also put comments in these files; lines beginning with \"#\" are "
1121 msgid "SHARED DEBHELPER OPTIONS"
1126 msgid "The following command line options are supported by all debhelper programs."
1131 msgid "B<-v>, B<--verbose>"
1136 msgid "Verbose mode: show all commands that modify the package build directory."
1147 "Do not really do anything. If used with -v, the result is that the command "
1148 "will output what it would have done."
1153 msgid "B<-a>, B<--arch>"
1158 msgid "Act on all architecture dependent packages."
1163 msgid "B<-i>, B<--indep>"
1168 msgid "Act on all architecture independent packages."
1172 #: debhelper.pod:101
1173 msgid "B<->I<ppackage>, B<--package=>I<package>"
1177 #: debhelper.pod:103
1179 "Act on the package named \"package\". This option may be specified multiple "
1180 "times to make debhelper operate on a given set of packages."
1184 #: debhelper.pod:106
1185 msgid "B<-s>, B<--same-arch>"
1189 #: debhelper.pod:108
1191 "This is a smarter version of the -a flag, that is used in some rare "
1192 "circumstances. It understands that if the control file lists \"Architecture: "
1193 "i386\" for the package, the package should not be acted on on other "
1194 "architectures. So this flag makes the command act on all \"Architecture: "
1195 "any\" packages, as well as on any packages that have the current "
1196 "architecture explicitly specified. Contrast to the -a flag, which makes the "
1197 "command work on all packages that are not architecture independent."
1201 #: debhelper.pod:116
1202 msgid "B<-N>I<package>, B<--no-package=>I<package>"
1206 #: debhelper.pod:118
1208 "Do not act on the specified package even if an -a, -i, or -p option lists "
1209 "the package as one that should be acted on."
1213 #: debhelper.pod:121
1214 msgid "B<-P>I<tmpdir>, B<--tmpdir=>I<tmpdir>"
1218 #: debhelper.pod:123
1219 msgid "Use \"tmpdir\" for package build directory. The default is debian/<package>"
1223 #: debhelper.pod:125
1224 msgid "B<--mainpackage=>I<package>"
1228 #: debhelper.pod:127
1230 "This little-used option changes the package which debhelper considers the "
1231 "\"main package\", that is, the first one listed in debian/control, and the "
1232 "one for which debian/foo files can be used instead of the usual "
1233 "debian/package.foo files."
1237 #: debhelper.pod:134
1238 msgid "COMMON DEBHELPER OPTIONS"
1242 #: debhelper.pod:136
1244 "The following command line options are supported by some debhelper "
1245 "programs. See the man page of each program for a complete explanation of "
1246 "what each option does."
1250 #: debhelper.pod:142
1255 #: debhelper.pod:144
1256 msgid "Do not modify postinst/postrm/etc scripts."
1260 #: debhelper.pod:148
1262 "Exclude an item from processing. This option may be used multiple times, to "
1263 "exclude more than one thing."
1267 #: debhelper.pod:153
1269 "Makes files or other items that are specified on the command line take "
1270 "effect in ALL packages acted on, not just the first."
1274 #: debhelper.pod:160
1275 msgid "Multiple binary package support"
1279 #: debhelper.pod:162
1281 "If your source package generates more than one binary package, debhelper "
1282 "programs will default to acting on all binary packages when run. If your "
1283 "source package happens to generate one architecture dependent package, and "
1284 "another architecture independent package, this is not the correct behavior, "
1285 "because you need to generate the architecture dependent packages in the "
1286 "binary-arch debian/rules target, and the architecture independent packages "
1287 "in the binary-indep debian/rules target."
1291 #: debhelper.pod:170
1293 "To facilitate this, as well as give you more control over which packages are "
1294 "acted on by debhelper programs, all debhelper programs accept the B<-a>, "
1295 "B<-i>, B<-p>, and B<-s> parameters. These parameters are cumulative. If "
1296 "none are given, debhelper programs default to acting on all packages listed "
1297 "in the control file."
1301 #: debhelper.pod:176
1303 "See F</usr/share/doc/debhelper/examples/rules.multi> for an example of how "
1304 "to use this in a package that generates multiple binary packages."
1308 #: debhelper.pod:179
1309 msgid "Automatic generation of debian install scripts"
1313 #: debhelper.pod:181
1315 "Some debhelper commands will automatically generate parts of debian "
1316 "maintainer scripts. If you want these automatically generated things "
1317 "included in your existing debian maintainer scripts, then you need to add "
1318 "\"#DEBHELPER#\" to your scripts, in the place the code should be added. "
1319 "\"#DEBHELPER#\" will be replaced by any auto-generated code when you run "
1324 #: debhelper.pod:188
1326 "If a script does not exist at all and debhelper needs to add something to "
1327 "it, then debhelper will create the complete script."
1331 #: debhelper.pod:191
1333 "All debhelper commands that automatically generate code in this way let it "
1334 "be disabled by the -n parameter (see above)."
1338 #: debhelper.pod:194
1340 "Note that the inserted code will be shell code, so you cannot directly use "
1341 "it in a perl script. If you would like to embed it into a perl script, here "
1342 "is one way to do that (note that I made sure that $1, $2, etc are set with "
1347 #: debhelper.pod:199
1350 " my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n"
1353 " system ($temp) / 256 == 0\n"
1354 " \tor die \"Problem with debhelper scripts: $!\";\n"
1359 #: debhelper.pod:205
1360 msgid "Automatic generation of miscellaneous dependencies."
1364 #: debhelper.pod:207
1366 "Some debhelper commands may make the generated package need to depend on "
1367 "some other packages. For example, if you use L<dh_installdebconf(1)>, your "
1368 "package will generally need to depend on debconf. Or if you use "
1369 "L<dh_installxfonts(1)>, your package will generally need to depend on a "
1370 "particular version of xutils. Keeping track of these miscellaneous "
1371 "dependencies can be annoying since they are dependant on how debhelper does "
1372 "things, so debhelper offers a way to automate it."
1376 #: debhelper.pod:215
1378 "All commands of this type, besides documenting what dependencies may be "
1379 "needed on their man pages, will automatically generate a substvar called "
1380 "${misc:Depends}. If you put that token into your debian/control file, it "
1381 "will be expanded to the dependencies debhelper figures you need."
1385 #: debhelper.pod:220
1387 "This is entirely independent of the standard ${shlibs:Depends} generated by "
1388 "L<dh_makeshlibs(1)>, and the ${perl:Depends} generated by L<dh_perl(1)>. "
1389 "You can choose not to use any of these, if debhelper's guesses don't match "
1394 #: debhelper.pod:225
1395 msgid "Package build directories"
1399 #: debhelper.pod:227
1401 "By default, all debhelper programs assume that the temporary directory used "
1402 "for assembling the tree of files in a package is debian/<package>."
1406 #: debhelper.pod:230
1408 "Sometimes, you might want to use some other temporary directory. This is "
1409 "supported by the -P flag. For example, \"dh_installdocs -Pdebian/tmp\", will "
1410 "use debian/tmp as the temporary directory. Note that if you use -P, the "
1411 "debhelper programs can only be acting on a single package at a time. So if "
1412 "you have a package that builds many binary packages, you will need to also "
1413 "use the -p flag to specify which binary package the debhelper program will "
1418 #: debhelper.pod:238
1419 msgid "Debhelper compatibility levels"
1423 #: debhelper.pod:240
1425 "From time to time, major non-backwards-compatible changes need to be made to "
1426 "debhelper, to keep it clean and well-designed as needs change and its author "
1427 "gains more experience. To prevent such major changes from breaking existing "
1428 "packages, the concept of debhelper compatibility levels was introduced. You "
1429 "tell debhelper which compatibility level it should use, and it modifies its "
1430 "behavior in various ways."
1434 #: debhelper.pod:247
1436 "Tell debhelper what compatibility level to use by writing a number to "
1437 "debian/compat. For example, to turn on V5 mode:"
1441 #: debhelper.pod:250
1444 " % echo 5 > debian/compat\n"
1449 #: debhelper.pod:252
1451 "Unless otherwise indicated, all debhelper documentation assumes that you are "
1452 "using the most recent compatability level, and in most cases does not "
1453 "indicate if the behavior is different in an earlier compatability level, so "
1454 "if you are not using the most recent compatability level, you're advised to "
1455 "read below for notes about what is different in earlier compatability "
1460 #: debhelper.pod:259
1461 msgid "These are the available compatibility levels:"
1465 #: debhelper.pod:263
1470 #: debhelper.pod:265
1472 "This is the original debhelper compatibility level, and so it is the default "
1473 "one. In this mode, debhelper will use debian/tmp as the package tree "
1474 "directory for the first binary package listed in the control file, while "
1475 "using debian/<package> for all other packages listed in the control file."
1479 #: debhelper.pod:270 debhelper.pod:277 debhelper.pod:300
1480 msgid "This mode is deprecated."
1484 #: debhelper.pod:272
1489 #: debhelper.pod:274
1491 "In this mode, debhelper will consistently use debian/<package> as the "
1492 "package tree directory for every package that is built."
1496 #: debhelper.pod:279
1501 #: debhelper.pod:281
1502 msgid "This mode works like V2, with the following additions:"
1506 #: debhelper.pod:285 debhelper.pod:290 debhelper.pod:294 debhelper.pod:308 debhelper.pod:313 debhelper.pod:318 debhelper.pod:323 debhelper.pod:336 debhelper.pod:340 debhelper.pod:345
1511 #: debhelper.pod:287
1513 "Debhelper config files support globbing via * and ?, when appropriate. To "
1514 "turn this off and use those characters raw, just prefix with a backslash."
1518 #: debhelper.pod:292
1519 msgid "dh_makeshlibs makes the postinst and postrm scripts call ldconfig."
1523 #: debhelper.pod:296
1524 msgid "Every file in etc/ is automatically flagged as a conffile by dh_installdeb."
1528 #: debhelper.pod:302
1533 #: debhelper.pod:304
1534 msgid "Changes from V3 are:"
1538 #: debhelper.pod:310
1540 "dh_makeshlibs -V will not include the debian part of the version number in "
1541 "the generated dependency line in the shlibs file."
1545 #: debhelper.pod:315
1547 "You are encouraged to put the new ${misc:Depends} into debian/control to "
1548 "supplement the ${shlibs:Depends} field."
1552 #: debhelper.pod:320
1554 "dh_fixperms will make all files in bin/ directories and in etc/init.d "
1559 #: debhelper.pod:325
1560 msgid "dh_link will correct existing links to conform with policy."
1564 #: debhelper.pod:329
1569 #: debhelper.pod:331
1570 msgid "This is the recommended mode of operation. It does everything V4 does, plus:"
1574 #: debhelper.pod:338
1575 msgid "Comments are ignored in debhelper config files."
1579 #: debhelper.pod:342
1581 "dh_strip --dbg-package now specifies the name of a package to put debugging "
1582 "symbols in, not the packages to take the symbols from."
1586 #: debhelper.pod:347
1587 msgid "dh_installdocs skips installing empty files."
1591 #: debhelper.pod:353
1592 msgid "Doc directory symlinks"
1596 #: debhelper.pod:355
1598 "Sometimes it is useful to make a package not contain a "
1599 "/usr/share/doc/package directory at all, instead placing just a dangling "
1600 "symlink in the binary package, that points to some other doc "
1601 "directory. Policy says this is ok if your package depends on the package "
1602 "whose doc directory it uses. To accomplish this, just don't tell debhelper "
1603 "to install any documentation files into the package, and use dh_link to set "
1604 "up the symlink (or do it by hand), and debhelper should do the right thing: "
1605 "notice it is a dangling symlink and not try to install a copyright file or "
1610 #: debhelper.pod:364
1615 #: debhelper.pod:366
1617 "Debhelper includes support for udebs. To create a udeb with debhelper, add "
1618 "\"XC-Package-Type: udeb\" to the package's stanza in debian/control, and "
1619 "build-depend on debhelper (>= 4.2). Debhelper will try to create udebs that "
1620 "comply with debian-installer policy, by making the generated package files "
1621 "end in \".udeb\", not installing any documentation into a udeb, skipping "
1622 "over preinst, postrm, prerm, and config scripts, etc."
1626 #: debhelper.pod:373
1631 #: debhelper.pod:375
1633 "In general, if any debhelper program needs a directory to exist under "
1634 "debian/, it will create it. I haven't bothered to document this in all the "
1635 "man pages, but for example, dh_installdeb knows to make "
1636 "debian/<package>/DEBIAN/ before trying to put files there, dh_installmenu "
1637 "knows you need a debian/<package>/usr/share/menu/ before installing the menu "
1642 #: debhelper.pod:381
1644 "Once your package uses debhelper to build, be sure to add debhelper to your "
1645 "Build-Depends line in debian/control. You should build-depend on a version "
1646 "of debhelper equal to (or greater than) the debhelper compatibility level "
1647 "your package uses. So if your package used compatibility level 5:"
1651 #: debhelper.pod:387
1654 " Build-Depends: debhelper (>= 5)\n"
1659 #: debhelper.pod:389
1664 #: debhelper.pod:393
1669 #: debhelper.pod:395
1671 "Set to 1 to enable verbose mode. Debhelper will output every command it runs "
1672 "that modifies files on the build system."
1676 #: debhelper.pod:398
1681 #: debhelper.pod:400
1683 "Temporarily specifies what compatibility level debhelper should run at, "
1684 "overriding any value in debian/compat."
1688 #: debhelper.pod:403
1693 #: debhelper.pod:405
1694 msgid "Set to 1 to enable no-act mode."
1698 #: debhelper.pod:407
1703 #: debhelper.pod:409
1705 "Anything in this variable will be prepended to the command line arguments of "
1706 "all debhelper commands. This is useful in some situations, for example, if "
1707 "you need to pass -p to all debhelper commands that will be run. One good way "
1708 "to set DH_OPTIONS is by using \"Target-specific Variable Values\" in your "
1709 "debian/rules file. See the make documentation for details on doing this."
1713 #: debhelper.pod:415
1714 msgid "DH_ALWAYS_EXCLUDE"
1718 #: debhelper.pod:417
1720 "If set, this adds the value the variable is set to to the -X options of all "
1721 "commands that support the -X option. Moreover, dh_builddeb will rm -rf "
1722 "anything that matches the value in your package build tree."
1726 #: debhelper.pod:421
1728 "This can be useful if you are doing a build from a CVS source tree, in which "
1729 "case setting DH_ALWAYS_EXCLUDE=CVS will prevent any CVS directories from "
1730 "sneaking into the package you build. Or, if a package has a source tarball "
1731 "that (unwisely) includes CVS directories, you might want to export "
1732 "DH_ALWAYS_EXCLUDE=CVS in debian/rules, to make it take effect wherever your "
1737 #: debhelper.pod:428
1739 "Multiple things to exclude can be separated with colons, as in "
1740 "DH_ALWAYS_EXCLUDE=CVS:.svn"
1744 #: debhelper.pod:437
1745 msgid "F</usr/share/doc/debhelper/examples/>"
1749 #: debhelper.pod:439
1750 msgid "A set of example debian/rules files that use debhelper."
1754 #: debhelper.pod:441
1755 msgid "L<http://kitenet.net/programs/debhelper/>"
1759 #: debhelper.pod:443
1760 msgid "Debhelper web site."
1765 msgid "dh_clean - clean up package build directories"
1771 "B<dh_clean> [S<I<debhelper options>>] [B<-k>] [B<-d>] [B<-X>I<item>] "
1779 "dh_clean is a debhelper program that is responsible for cleaning up after "
1781 "package is built. It removes the package build directories, and removes "
1783 "other files including debian/files, and any detritus left behind by other\n"
1784 "debhelper commands. It also removes common files that should not appear in "
1787 " #*# *~ DEADJOE *.orig *.rej *.SUMS TAGS core .deps/* *.P\n"
1792 #: dh_clean:29 dh_installchangelogs:44
1793 msgid "B<-k>, B<--keep>"
1799 "Do not delete debian/files. When do you want to use this? Anytime you have a "
1800 "debian/rules that has 2 binary targets that build different .deb packages; "
1801 "for example, one target is binary-arch, and the other is binary-indep, or "
1802 "one target builds the shared library, and the other the -dev package. If you "
1803 "didn't use -k in these cases, then debian/files would be deleted in the "
1804 "middle, and your changes file will only contain the last binary package that "
1810 msgid "B<-d>, B<--dirs-only>"
1816 "Only clean the package build directories, do not clean up any other files at "
1822 msgid "B<-X>I<item> B<--exclude=>I<item>"
1828 "Exclude files that contain \"item\" anywhere in their filename from being "
1829 "deleted, even if they would normally be deleted. You may use this option "
1830 "multiple times to build up a list of things to exclude."
1835 msgid "Delete these files too."
1839 #: dh_undocumented:5
1840 msgid "dh_undocumented - obsolete undocumented.7 symlink program"
1844 #: dh_undocumented:14 dh_suidregister:9
1849 #: dh_undocumented:18
1851 "This program used to make symlinks to the undocumented.7 man page for man "
1852 "pages not present in a package. Debian policy now frowns on use of the "
1853 "undocumented.7 man page, and so this program does nothing, and should not be "
1859 msgid "dh_testversion - ensure that the correct version of debhelper is installed"
1863 #: dh_testversion:14
1864 msgid "B<dh_testversion> [S<I<debhelper options>>] [I<operator>] [I<version>]"
1868 #: dh_testversion:18
1869 msgid "Note: This program is deprecated. You should use build dependencies instead."
1873 #: dh_testversion:21
1875 "dh_testversion compares the version of debhelper against the version you "
1876 "specify, and if the condition is not met, exits with an error message."
1880 #: dh_testversion:24
1882 "You can use this in your debian/rules files if a new debhelper feature is "
1883 "introduced, and your package requires that feature to build correctly. Use "
1884 "debhelper's changelog to figure out the version you need."
1888 #: dh_testversion:28
1890 "Be sure not to overuse dh_testversion. If debhelper version 9.5 introduces a "
1891 "new dh_autofixbugs command, and your package uses it, then if someone tries "
1892 "to build it with debhelper 1.0, the build will fail anyway when "
1893 "dh_autofixbugs cannot be found, so there is no need for you to use "
1898 #: dh_testversion:38
1903 #: dh_testversion:40
1905 "Optional comparison operator used in comparing the versions. If not "
1906 "specified, \">=\" is used. For descriptions of the comparison operators, see "
1911 #: dh_testversion:44
1916 #: dh_testversion:46
1918 "Version number to compare against the current version of debhelper. If not "
1919 "specified, dh_testversion does nothing."
1924 msgid "dh_testdir - test directory before building debian package"
1929 msgid "B<dh_testdir> [S<I<debhelper options>>] [S<I<file ...>>]"
1935 "dh_testdir tries to make sure that you are in the correct directory when "
1936 "building a debian package. It makes sure that the file debian/control "
1937 "exists, as well as any other files you specify. If not, it exits with an "
1943 msgid "Test for the existence of these files too."
1948 msgid "dh_shlibdeps - calculate shared library dependencies"
1954 "B<dh_shlibdeps> [S<I<debhelper options>>] [B<-L>I<package>] "
1955 "[B<-l>I<directory>] [B<-X>I<item>] [S<B<--> I<params>>]"
1961 "dh_shlibdeps is a debhelper program that is responsible for calculating "
1962 "shared library dependencies for packages."
1968 "This program is merely a wrapper around L<dpkg-shlibdeps(1)> that calls it "
1969 "once for each package listed in the control file, passing it a list of ELF "
1970 "executables and shared libraries it has found."
1975 msgid "B<-u>I<params>, B<--dpkg-shlibdeps-params=>I<params>"
1980 msgid "Pass \"params\" to L<dpkg-shlibdeps(1)>."
1986 "Exclude files that contain \"item\" anywhere in their filename from being "
1987 "passed to dpkg-shlibdeps. This will make their dependencies be ignored. "
1988 "This may be useful in some situations, but use it with caution. This option "
1989 "may be used more than once to exclude more than one thing."
1994 msgid "B<-l>I<directory>[:directory:directory:..]"
2000 "Before dpkg-shlibdeps is run, LD_LIBRARY_PATH will have added to it the "
2001 "specified directory (or directories -- separate with colons). This is useful "
2002 "for multi-binary packages where a library is built in one package and "
2003 "another package contains binaries linked against said library. Relative "
2004 "paths will be made absolute for the benefit of dpkg-shlibdeps."
2010 "Note that the directory given should be the complete or relative path to a "
2011 "directory that contains the library. See example below."
2016 msgid "B<-L>I<package>, B<--libpackage=>I<package>"
2022 "Use the shlibs file automatically generated by dh_makeshlibs for the named "
2023 "package as a kind of automatically generated shlibs.local file. You can use "
2024 "this switch in concert with the -l switch to make dpkg-shlibdeps find a "
2025 "library built as part of the current package, and get the shlibs "
2026 "information. See example below."
2030 #: dh_shlibdeps:65 dh_link:65 dh_makeshlibs:69 dh_installdocs:76
2037 "Suppose that your source package produces libfoo1, libfoo-dev, and "
2038 "libfoo-bin binary packages. libfoo-bin links against libfoo1, and should "
2039 "depend on it. In your rules file, first run dh_makeshlibs, then "
2048 "\tdh_shlibdeps -L libfoo1 -l debian/libfoo1/usr/lib\n"
2055 "This will have the effect of generating automatically a shlibs file for "
2056 "libfoo1, and using that file and the libfoo1 library in the "
2057 "debian/libfoo1/usr/lib directory to calculate shared library dependency "
2063 msgid "L<debhelper(7)>, L<dpkg-shlibdeps(1)>"
2067 #: dh_scrollkeeper:5
2068 msgid "dh_scrollkeeper - generate ScrollKeeper registration scripts"
2072 #: dh_scrollkeeper:14
2073 msgid "B<dh_scrollkeeper> [S<I<debhelper options>>] [B<-n>] [S<I<directory>>]"
2077 #: dh_scrollkeeper:18
2079 "B<dh_scrollkeeper> is a debhelper program that handles correctly registering "
2080 "OMF files that it finds in package build trees with ScrollKeeper."
2084 #: dh_scrollkeeper:22
2086 "This command automatically adds maintainer script snippets for registering "
2087 "and unregistering files with ScrollKeeper (unless B<-n> is used). See "
2088 "L<dh_installdeb(1)> for an explanation of Debhelper maintainer script "
2093 #: dh_scrollkeeper:27
2095 "It will also change any DTD declarations in the OMF and DocBook files to "
2096 "refer to local files instead of remote URLs. This change does not modify the "
2097 "source files, but the files in the package build tree."
2101 #: dh_scrollkeeper:37
2102 msgid "Do not modify F<postinst>/F<postrm> scripts."
2106 #: dh_scrollkeeper:77 dh_desktop:45
2107 msgid "L<debhelper>"
2112 msgid "dh_installdirs - create subdirectories in package build directories"
2116 #: dh_installdirs:14
2117 msgid "B<dh_installdirs> [S<I<debhelper options>>] [B<-A>] [S<I<dir ...>>]"
2121 #: dh_installdirs:18
2123 "dh_installdirs is a debhelper program that is responsible for creating "
2124 "subdirectories in package build directories."
2128 #: dh_installdirs:21
2130 "Any directory names specified as parameters will be created in the package "
2131 "build directory of the first package dh_installdirs is told to act on. By "
2132 "default, this is the first binary package in debian/control, but if you use "
2133 "-p, -i, or -a flags, it will be the first package specified by those flags."
2137 #: dh_installdirs:26
2139 "A file named debian/package.dirs can list other directories to be created. "
2140 "Separate the directory names with whitespace."
2144 #: dh_installdirs:29
2146 "Be sure to only use directory names relative to the package build "
2147 "directory. Ie, \"/usr/bin\" should not be used, use \"usr/bin\" instead."
2151 #: dh_installdirs:38
2153 "Create any directories specified by command line parameters in ALL packages "
2154 "acted on, not just the first."
2158 #: dh_installdirs:41
2163 #: dh_installdirs:43
2165 "Create these directories in the package build directory of the first package "
2166 "acted on. (Or in all packages if -A is specified.)"
2171 msgid "dh_link - create symlinks in package build directories"
2176 msgid "B<dh_link> [S<I<debhelper options>>] [B<-A>] [S<I<source destination ...>>]"
2182 "dh_link is a debhelper program that creates symlinks in package build "
2189 "dh_link accepts a list of pairs of source and destination files. The source "
2190 "files are the already existing files that will be symlinked from. The "
2191 "destination files are the symlinks that will be created. There B<must> be an "
2192 "equal number of source and destination files specified."
2198 "The list can be specified in two ways. A file named debian/package.links can "
2199 "list pairs of files. If you use this file, you should put each pair of files "
2200 "on its own line, and separate the files within the pair with "
2201 "whitespace. Also, pairs of files can be specified as parameters - these "
2202 "pairs will only be created in the package build directory of the first "
2203 "package dh_link is told to act on. By default, this is the first binary "
2204 "package in debian/control, but if you use -p, -i, or -a flags, it will be "
2205 "the first package specified by those flags."
2211 "Be sure you B<do> specify the full filename to both the source and "
2212 "destination files (unlike you would do if you were using something like "
2219 "dh_link will generate symlinks that comply with debian policy - absolute "
2220 "when policy says they should be absolute, and relative links with as short a "
2221 "path as possible. It will also create any subdirectories it needs to to put "
2228 "dh_link also scans the package build tree for existing symlinks which do not "
2229 "conform to debian policy, and corrects them (v4 only)."
2235 "Create any links specified by command line parameters in ALL packages acted "
2236 "on, not just the first."
2241 msgid "I<source destination ...>"
2247 "Create a file named \"destination\" as a link to a file named \"source\". Do "
2248 "this in the package build directory of the first package acted on. (Or in "
2249 "all packages if -A is specified.)"
2256 " dh_link usr/share/man/man1/foo.1 usr/share/man/man1/bar.1\n"
2262 msgid "Make bar.1 be a symlink to foo.1"
2269 " dh_link var/lib/foo usr/lib/foo \\\n"
2270 " usr/X11R6/man/man1/foo.1x usr/share/man/man1/bar.1\n"
2277 "Make /usr/lib/foo/ be a link to /var/lib/foo/, and bar.1 be a symlink to the "
2282 #: dh_installdebconf:5
2284 "dh_installdebconf - install files used by debconf in package build "
2289 #: dh_installdebconf:14
2290 msgid "B<dh_installdebconf> [S<I<debhelper options>>] [B<-n>] [S<B<--> I<params>>]"
2294 #: dh_installdebconf:18
2296 "dh_installdebconf is a debhelper program that is responsible for installing "
2297 "files used by the debconf package into package build directories."
2301 #: dh_installdebconf:21
2303 "It also automatically generates the postrm commands needed to interface with "
2304 "debconf. See L<dh_installdeb(1)> for an explanation of how that works."
2308 #: dh_installdebconf:25
2310 "Files named debian/package.config and debian/package.templates are installed "
2311 "into the DEBIAN directory in the package build directory. If a file named "
2312 "debian/package.config.debhelper exists, the contents of that file are merged "
2313 "into the config script as follows: If the script exists, then anywhere in it "
2314 "that \"#DEBHELPER#\" appears, the text of the .debhelper file is "
2315 "inserted. If the script does not exist, then a script is generated from the "
2316 ".debhelper file. The .debhelper files may be created by other debhelper "
2317 "programs, and are shell script fragments."
2321 #: dh_installdebconf:34
2323 "Note that if you use debconf, your package probably needs to depend on it "
2324 "(it will be added to ${misc:Depends} by this program)."
2328 #: dh_installdebconf:37
2330 "Note that for your config script to be called by dpkg, your postinst needs "
2331 "to source debconf's confmodule. dh_installdebconf does not install this "
2332 "statement into postinst automatically as it it too hard to do it right."
2336 #: dh_installdebconf:42
2337 msgid "LOCALIZED TEMPLATE FILES"
2341 #: dh_installdebconf:44
2343 "Debconf also supports localized template files, and this program has some "
2344 "support to aid is working with them. It is best to keep the translations in "
2345 ".po files under debian/po, and merge them only at build time. See "
2346 "L<po2debconf(1)> and L<debconf-getlang(1)> for details."
2350 #: dh_installdebconf:49
2352 "This program will look to see if you have a debian/po directory and if so "
2353 "will automatically call L<po2debconf(1)> to generate a merged templates "
2354 "file. Or if you have debian/templates.ll files, it will use the older "
2355 "L<debconf-mergetemplate(1)> program to merge those together."
2359 #: dh_installdebconf:54
2361 "Note that if your package has a debian/po directory it should build-depend "
2366 #: dh_installdebconf:56
2368 "For example, if you have a German translation, strings from debian/po/de.po "
2369 "are merged with debian/package.templates."
2373 #: dh_installdebconf:65
2374 msgid "Do not modify postrm script."
2378 #: dh_installdebconf:69
2380 "Pass the params to po2debconf, if it is run or debconf-mergetemplate, if it "
2386 msgid "dh_installmime - install mime files into package build directories"
2390 #: dh_installmime:14
2391 msgid "B<dh_installmime> [S<I<debhelper options>>] [B<-n>]"
2395 #: dh_installmime:18
2397 "dh_installmime is a debhelper program that is responsible for installing "
2398 "mime files into package build directories."
2402 #: dh_installmime:21
2404 "It also automatically generates the postinst and postrm commands needed to "
2405 "interface with the debian mime-support and shared-mime-info packages. See "
2406 "L<dh_installdeb(1)> for an explanation of how this works."
2410 #: dh_installmime:25
2412 "If files named debian/package.mime or debian/package.sharedmimeinfo exist, "
2413 "then they are installed into usr/lib/mime/packages/package and "
2414 "/usr/share/mime/packages/package.xml (respectively) in the package build "
2420 msgid "dh_installwm - register a window manager"
2426 "B<dh_installwm> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] "
2433 "dh_installwm is a debhelper program that is responsible for generating the "
2434 "postinst and postrm commands that register a window manager with "
2435 "L<update-alternatives(8)>"
2441 "Any window manager programs specified as parameters will be registered in "
2442 "the first package dh_installwm is told to act on. By default, this is the "
2443 "first binary package in debian/control, but if you use -p, -i, or -a flags, "
2444 "it will be the first package specified by those flags."
2450 "Files named debian/package.wm can list other window manager programs to "
2457 "Set the priority of the window manager. Default is 20, which is too low for "
2458 "most window managers; see the Debian Policy document for instructions on "
2459 "calculating the correct value."
2464 msgid "Do not modify postinst/postrm scripts. Turns this command into a no-op."
2475 "The commands used to run the window manager or window managers you want to "
2481 msgid "dh_installdeb - install files into the DEBIAN directory"
2486 msgid "B<dh_installdeb> [S<I<debhelper options>>]"
2492 "dh_installdeb is a debhelper program that is responsible for installing "
2493 "files into the DEBIAN directories in package build directories with the "
2494 "correct permissions."
2501 "dh_installdeb automatically installs the following files from debian/ into\n"
2502 "the DEBIAN directory:\n"
2503 " package.postinst\n"
2504 " package.preinst\n"
2508 " package.conffiles\n"
2515 "The postinst, preinst, postrm, and prerm are handled specially: If a "
2516 "corresponding file named debian/package.script.debhelper exists, the "
2517 "contents of that file are merged into the script as follows: If the script "
2518 "exists, then anywhere in it that \"#DEBHELPER#\" appears, the text of the "
2519 ".debhelper file is inserted. If the script does not exist, then a script is "
2520 "generated from the .debhelper file. The .debhelper files are created by "
2521 "other debhelper programs, such as L<dh_installmenu(1)>, and are shell script "
2528 "In V3 compatibility mode and higher, all files in the etc/ directory in a "
2529 "package will automatically be flagged as conffiles by this program, so there "
2530 "is no need to list them manually in package.conffiles."
2535 msgid "dh_builddeb - build debian packages"
2541 "B<dh_builddeb> [S<I<debhelper options>>] [B<--destdir=>I<directory>] "
2542 "[B<--filename=>I<name>] [S<B<--> I<params>>]"
2548 "dh_builddeb simply calls L<dpkg-deb(8)> to build a debian package or "
2554 msgid "B<--destdir=>I<directory>"
2560 "Use this if you want the generated .deb files to be put in a directory other "
2561 "than the default of \"..\""
2566 msgid "B<--filename=>I<name>"
2572 "Use this if you want to force the generated .deb file to have a particular "
2573 "file name. Does not work well if more than one .deb is generated!"
2578 msgid "B<-u>I<params>"
2583 msgid "Pass I<params> to L<dpkg-deb(1)> when it is used to build the package."
2588 msgid "dh_gencontrol - generate and install control file"
2593 msgid "B<dh_gencontrol> [S<I<debhelper options>>] [S<B<--> I<params>>]"
2599 "dh_gencontrol is a debhelper program that is responsible for generating "
2600 "control files, and installing them into the DEBIAN directory with the proper "
2607 "This program is merely a wrapper around L<dpkg-gencontrol(1)>, which calls "
2608 "it once for each package being acted on, and passes in some additional "
2609 "useful flags including \"-isp\"."
2614 msgid "B<-u>I<params>, B<--dpkg-gencontrol-params>I<params>"
2619 msgid "Pass \"params\" to L<dpkg-gencontrol(1)>."
2624 msgid "dh_install - install files into package build directories"
2630 "B<dh_install> [B<-X>I<item>] [B<--autodest>] [B<--sourcedir=>I<dir>] "
2631 "[S<I<debhelper options>>] [S<I<file [...] dest>>]"
2637 "dh_install is a debhelper program that handles installing files into package "
2638 "build directories. There are many dh_install* commands that handle "
2639 "installing specific types of files such as documentation, examples, man "
2640 "pages, and so on, and they should be used when possible as they often have "
2641 "extra intelligence for those particular tasks. dh_install, then, is useful "
2642 "for installing everything else, for which no particular intelligence is "
2643 "needed. It is a replacement for the old dh_movefiles command."
2649 "Files named debian/package.install list the files to install into each "
2650 "package and the directory they should be installed to. The format is a set "
2651 "of lines, where each line lists a file or files to install, and at the end "
2652 "of the line tells the directory it should be installed in. The name of the "
2653 "files (or directories) to install should be given relative to the current "
2654 "directory, while the installation directory is given relative to the package "
2655 "build directory. You may use wildcards in the names of the files to install "
2656 "(in v3 mode and above)."
2662 "This program may be used in one of two ways. If you just have a file or two "
2663 "that the upstream Makefile does not install for you, you can run dh_install "
2664 "on them to move them into place. On the other hand, maybe you have a large "
2665 "package that builds multiple binary packages. You can use the upstream "
2666 "Makefile to install it all into debian/tmp, and then use dh_install to copy "
2667 "directories and files from there into the proper package build directories."
2672 msgid "B<--autodest>"
2678 "Guess as the destination directory to install things to. If this is "
2679 "specified, you should not list destination directories in "
2680 "debian/package.install files or on the command line. Instead, dh_install "
2681 "will guess as follows:"
2687 "Strip off debian/tmp (or the sourcedir if one is given) from the front of "
2688 "the filename, if it is present, and install into the dirname of the "
2689 "filename. So if the filename is debian/tmp/usr/bin, then that directory will "
2690 "be copied to debian/package/usr/. If the filename is debian/tmp/etc/passwd, "
2691 "it will be copied to debian/package/etc/."
2697 "Note that if you list exactly one filename or wildcard-pattern on a line by "
2698 "itself in a debian/package.install file, with no explicit destination, then "
2699 "dh_install will automatically guess the destination even if this flag is not "
2705 msgid "B<--list-missing>"
2711 "This option makes dh_install keep track of the files it installs, and then "
2712 "at the end, compare that list with the files in the source directory. If any "
2713 "of the files (and symlinks) in the source directory were not installed to "
2714 "somewhere, it will warn on stderr about that."
2720 "This may be useful if you have a large package and want to make sure that "
2721 "you don't miss installing newly added files in new upstream releases."
2727 "Note that files that are excluded from being moved via the -X option are not "
2733 msgid "B<--fail-missing>"
2739 "This option is like --list-missing, except if a file was missed, it will not "
2740 "only list the missing files, but also fail with a nonzero exit code."
2745 msgid "B<--sourcedir=dir>"
2751 "Makes all source files be found under dir. If this is specified, it is akin "
2752 "to all the source filenames having \"dir/\" prepended to them."
2758 "To make dh_install behave like the old dh_movefiles, move your package.files "
2759 "file to package.install and call dh_install with \"--sourcedir=debian/tmp\" "
2760 "appended to the command. This will approximate dh_movefiles behaviour, "
2761 "except it will copy files instead of moving them."
2766 msgid "I<file [...] dest>"
2772 "Lists files (or directories) to install and where to install them to. The "
2773 "files will be installed into the first package dh_install acts on."
2784 "Suppose your package's upstream Makefile installs a binary, a man page, and "
2785 "a library into appropriate subdirectories of debian/tmp. You want to put the "
2786 "library into package libfoo, and the rest into package foo. Your rules file "
2787 "will run \"dh_install --sourcedir=debian/tmp\". Make debian/foo.install "
2796 " usr/share/man/man1\n"
2802 msgid "While debian/libfoo.install contains:"
2809 " usr/lib/libfoo*.so.*\n"
2816 "If you want a libfoo-dev package too, debian/libfoo-dev.install might "
2825 " usr/lib/libfoo*.so\n"
2826 " usr/share/man/man3\n"
2839 "dh_install cannot rename files or directories, it can only install them\n"
2840 "with the names they already have into wherever you want in the package\n"
2847 msgid "dh_makeshlibs - automatically create shlibs file"
2853 "B<dh_makeshlibs> [S<I<debhelper options>>] [B<-m>I<major>] "
2854 "[B<-V>I<[dependencies]>] [B<-n>] [B<-X>I<item>]"
2860 "dh_makeshlibs is a debhelper program that automatically scans for shared "
2861 "libraries, and generates a shlibs file for the libraries it finds."
2867 "It also adds a call to ldconfig in the postinst and postrm scripts (in V3 "
2868 "mode and above only) to any packages which it finds shared libraries in."
2873 msgid "B<-m>I<major>, B<--major=>I<major>"
2879 "Instead of trying to guess the major number of the library with objdump, use "
2880 "the major number specified after the -m parameter. This is much less useful "
2881 "than it used to be, back in the bad old days when this program looked at "
2882 "library filenames rather than using objdump."
2887 msgid "B<-V>, B<-V>I<dependencies>"
2892 msgid "B<--version-info>, B<--version-info=>I<dependencies>"
2898 "By default, the shlibs file generated by this program does not make packages "
2899 "depend on any particular version of the package containing the shared "
2900 "library. It may be necessary for you to add some version dependancy "
2901 "information to the shlibs file. If -V is specified with no dependency "
2902 "information, the current upstream version of the package is plugged into a "
2903 "dependency that looks like \"packagename (>= packageversion)\". Note that in "
2904 "debhelper compatibility levels before v4, the debian part of the package "
2905 "version number is also included. If -V is specified with parameters, the "
2906 "parameters can be used to specify the exact dependency information needed "
2907 "(be sure to include the package name)."
2913 "Beware of using -V without any parameters; this is a conservative setting "
2914 "that always ensures that other packages' shared library dependencies are at "
2915 "least as tight as they need to be (unless your library is prone to changing "
2916 "ABI without updating the upstream version number), so that if the maintainer "
2917 "screws up then they won't break. The flip side is that packages might end up "
2918 "with dependencies that are too tight and so find it harder to be upgraded."
2924 "Exclude files that contain \"item\" anywhere in their filename or directory "
2925 "from being treated as shared libraries."
2930 msgid "dh_makeshlibs"
2937 "Assuming this is a package named libfoobar1, generates a shlibs file that\n"
2938 "looks something like:\n"
2939 " libfoobar 1 libfoobar1\n"
2945 msgid "dh_makeshlibs -V"
2952 "Assuming the current version of the package is 1.1-3, generates a shlibs\n"
2953 "file that looks something like:\n"
2954 " libfoobar 1 libfoobar1 (>= 1.1)\n"
2960 msgid "dh_makeshlibs -V 'libfoobar1 (>= 1.0)'"
2967 "Generates a shlibs file that looks something like:\n"
2968 " libfoobar 1 libfoobar1 (>= 1.0)\n"
2974 msgid "dh_perl - calculates perl dependencies"
2979 msgid "B<dh_perl> [S<I<debhelper options>>] [B<-d>] [S<I<library dirs ...>>]"
2985 "dh_perl is a debhelper program that is responsible for generating the "
2986 "${perl:Depends} substitutions and adding them to substvars files."
2992 "The program will look at perl scripts and modules in your package, and will "
2993 "use this information to generate a dependency on perl or perlapi. The "
2994 "dependency will be substituted into your package's control file wherever you "
2995 "place the token \"${perl:Depends}\"."
3006 "In some specific cases you may want to depend on perl-base rather than the "
3007 "full perl package. If so, you can pass the -d option to make dh_perl "
3008 "generate a dependency on the correct base package. This is only necessary "
3009 "for some packages that are included in the base system."
3015 "Note that this flag may cause no dependency on perl-base to be generated at "
3016 "all. perl-base is Essential, so its dependency can be left out, unless a "
3017 "versioned dependency is needed."
3028 "By default, scripts and architecture independent modules don't depend on any "
3029 "specific version of perl. The -V option causes the current version of the "
3030 "perl (or perl-base with -d) package to be specified."
3035 msgid "I<library dirs>"
3041 "If your package installs perl modules in non-standard directories, you can "
3042 "make dh_perl check those directories by passing their names on the command "
3043 "line. It will only check the vendorlib and vendorarch directories by "
3049 msgid "Perl policy, version 1.18"
3054 msgid "Brendan O'Dea <bod@debian.org>"
3059 msgid "dh_fixperms - fix permissions of files in package build directories"
3064 msgid "B<dh_fixperms> [S<I<debhelper options>>] [B<-X>I<item>]"
3070 "dh_fixperms is a debhelper program that is responsible for setting the "
3071 "permissions of files and directories in package build directories to a sane "
3072 "state -- a state that complies with Debian policy."
3078 "dh_fixperms makes all files in usr/share/doc in the package build directory "
3079 "(excluding files in the examples/ directory) be mode 644. It also changes "
3080 "the permissions of all man pages to mode 644. It makes all files be owned by "
3081 "root, and it removes group and other write permission from all files. It "
3082 "removes execute permissions from any libraries that have it set. It makes "
3083 "all files in bin/ directories, /usr/games/ and etc/init.d executable (v4 "
3084 "only). Finally, it removes the setuid and setgid bits from all files in the "
3090 msgid "B<-X>I<item>, B<--exclude> I<item>"
3096 "Exclude files that contain \"item\" anywhere in their filename from having "
3097 "their permissions changed. You may use this option multiple times to build "
3098 "up a list of things to exclude."
3102 #: dh_listpackages:5
3103 msgid "dh_listpackages - list binary packages debhelper will act on"
3107 #: dh_listpackages:14
3108 msgid "B<dh_listpackages> [S<I<debhelper options>>]"
3112 #: dh_listpackages:18
3114 "dh_listpackages is a debhelper program that outputs a list of all binary "
3115 "packages debhelper commands will act on. If you pass it some options, it "
3116 "will change the list to match the packages other debhelper commands would "
3117 "act on if passed the same options."
3122 msgid "dh_installman - install man pages into package build directories"
3127 msgid "B<dh_installman> [S<I<debhelper options>>] [S<I<manpage ...>>]"
3133 "dh_installman is a debhelper program that handles installing man pages into "
3134 "the correct locations in package build directories. You tell it what man "
3135 "pages go in your packages, and it figures out where to install them based on "
3136 "the section field in their .TH line. If you have a properly formatted .TH "
3137 "line, your man page will be installed into the right directory, with the "
3138 "right name (this includes proper handling of pages with a subsection, like "
3139 "\"3perl\", which are placed in man3, and given an extension of "
3140 "\".3perl\"). If your .TH line is incorrect or missing, the program may guess "
3141 "wrong based on the file extension."
3147 "It also supports translated man pages, by looking for extensions like .ll.8 "
3154 "If dh_installman seems to install a man page into the wrong section or with "
3155 "the wrong extension, this is because the man page has the wrong section "
3156 "listed in its .TH line. Edit the man page and correct the section, and "
3157 "dh_installman will follow suit. See to L<man(7)> for details about the .TH "
3158 "section. If dh_installman seems to install a man page into a directory like "
3159 "/usr/share/man/pl/man1/, that is because your program has a name like "
3160 "\"foo.pl\", and dh_installman assumes that means it is translated into "
3161 "Polish. There is currently no support for resolving this ambiguity; programs "
3162 "in debian should probably not have extensions like that anyway."
3168 "Any man page filenames specified as parameters will be installed into the "
3169 "first package dh_installman is told to act on. By default, this is the first "
3170 "binary package in debian/control, but if you use -p, -i, or -a flags, it "
3171 "will be the first package specified by those flags."
3177 "Files named debian/package.manpages can list other man pages to be "
3184 "After the man page installation step, dh_installman will check to see if any "
3185 "of the man pages in the temporary directories of any of the packages it is "
3186 "acting on contain \".so\" links. If so, it changes them to symlinks."
3191 msgid "I<manpage ...>"
3197 "Install these man pages into the first package acted on. (Or in all packages "
3198 "if -A is specified)."
3204 "An older version of this program, L<dh_installmanpages(1)>, is still used by "
3205 "some packages, and so is still included in debhelper. It is, however, "
3206 "deprecated, due to its counterintuitive and inconsistent interface. Use this "
3212 msgid "dh_testroot - ensure that a package is built as root"
3217 msgid "B<dh_testroot> [S<I<debhelper options>>]"
3223 "dh_testroot simply checks to see if you are root. If not, it exits with an "
3224 "error. Debian packages must be built as root, though you can use "
3230 msgid "dh_movefiles - move files out of debian/tmp into subpackages"
3236 "B<dh_movefiles> [S<I<debhelper options>>] [B<--sourcedir=>I<dir>] "
3237 "[B<-X>I<item>] S<I<file ...>>]"
3243 "dh_movefiles is a debhelper program that is responsible for moving files out "
3244 "of debian/tmp or some other directory and into other package build "
3245 "directories. This may be useful if your package has a Makefile that installs "
3246 "everything into debian/tmp, and you need to break that up into subpackages."
3252 "Files named debian/package.files list the files to be moved, separated by "
3253 "whitespace. The filenames listed should be relative to debian/tmp/. You can "
3254 "also list directory names, and the whole directory will be moved. If you "
3255 "prefer, you can list the files to move on the command line and this will "
3256 "apply to the first package dh_movefiles is told to act on."
3262 "Note: dh_install is a much better program that can do everything this one "
3268 msgid "B<--sourcedir=>I<dir>"
3274 "Instead of moving files out of debian/tmp (the default), this option makes "
3275 "it move files out of some other directory. Since the entire contents of the "
3276 "sourcedir is moved, specifiying something like --sourcedir=/ is very unsafe, "
3277 "so to prevent mistakes, the sourcedir must be a relative filename; it cannot "
3284 "Lists files to move. The filenames listed should be relative to "
3285 "debian/tmp/. You can also list directory names, and the whole directory will "
3286 "be moved. It is an error to list files here unless you use -p, -i, or -a to "
3287 "tell dh_movefiles which subpackage to put them in."
3293 "Note that files are always moved out of debian/tmp by default (even if you "
3294 "have instructed debhelper to use a compatibility level higher than one, "
3295 "which does not otherwise use debian/tmp for anything at all). The idea "
3296 "behind this is that the package that is being built can be told to install "
3297 "into debian/tmp, and then files can be moved by dh_movefiles from that "
3298 "directory. Any files or directories that remain are ignored, and get deleted "
3299 "by dh_clean later."
3304 msgid "dh_desktop - Register .desktop files"
3309 msgid "B<dh_desktop> [S<I<debhelper options>>] [B<-p<package>>]"
3315 "dh_desktop is a debhelper program that registers .desktop files. Currently "
3316 "this program does not handle installation of the files, though it may do so "
3317 "at a later date. It takes care of adding maintainer script fragments to call "
3318 "F<update-desktop-database>."
3322 #: dh_suidregister:5
3323 msgid "dh_suidregister - obsolete suid registration program"
3327 #: dh_suidregister:13
3329 "This program used to register suid and sgid files with L<suidregister(1)>, "
3330 "but with the introduction of L<dpkg-statoverride(8)>, registration of files "
3331 "in this way is unnecessary, and even harmful, so this program should not be "
3336 #: dh_suidregister:18
3337 msgid "CONVERTING TO STATOVERRIDE"
3341 #: dh_suidregister:20
3343 "Converting a package that uses this program to use the new statoverride "
3344 "mechanism is easy. Just remove the call to dh_suidregister from "
3345 "debian/rules, and add a versioned conflicts into your control file, as "
3350 #: dh_suidregister:25
3353 " Conflicts: suidmanager (<< 0.50)\n"
3358 #: dh_suidregister:27
3360 "The conflicts is only necessary if your package used to register things with "
3361 "suidmanager; if it did not, you can just remove the call to this program "
3362 "from your rules file."
3366 #: dh_installchangelogs:5
3367 msgid "dh_installchangelogs - install changelogs into package build directories"
3371 #: dh_installchangelogs:14
3372 msgid "B<dh_installchangelogs> [<S<I<debhelper options>>] [B<-k>] [I<upstream>]"
3376 #: dh_installchangelogs:18
3378 "dh_installchangelogs is a debhelper program that is responsible for "
3379 "installing changelogs into package build directories."
3383 #: dh_installchangelogs:21
3385 "dh_installchangelogs determines if the package is a debian native package, "
3386 "and if so, it installs debian/changelog into usr/share/doc/package/changelog "
3387 "in the package build directory. Otherwise, it installs debian/changelog into "
3388 "usr/share/doc/package/changelog.Debian in the package build directory. (If "
3389 "files named debian/package.changelog exist, they will be used in preference "
3390 "to debian/changelog.)"
3394 #: dh_installchangelogs:28
3396 "Parallelling the debian changelog handling, this program also takes care of "
3397 "NEWS.Debian files. If there is a debian/NEWS file, it is installed as "
3398 "usr/share/doc/package/NEWS.Debian. debian/package.NEWS files can also be "
3403 #: dh_installchangelogs:33
3405 "If an upstream changelog file is specified as an option, then this upstream "
3406 "changelog will be installed as usr/share/doc/package/changelog in the "
3407 "package build directory. If the changelog is a html file (determined by file "
3408 "extension), it will be installed as usr/share/doc/package/changelog.html "
3409 "instead, and will be converted to plain text with html2text to generate "
3410 "usr/share/doc/package/changelog."
3414 #: dh_installchangelogs:46
3416 "Keep the original name of the upstream changelog. This will be accomplished "
3417 "by installing the upstream changelog as \"changelog\", and making a symlink "
3418 "from that to the original name of the changelog file. This can be useful if "
3419 "the upstream changelog has an unusual name, or if other documentation in the "
3420 "package refers to the changelog file."
3424 #: dh_installchangelogs:52
3429 #: dh_installchangelogs:54
3430 msgid "Install this file as the upstream changelog."
3436 "dh_python - calculates python dependencies and adds postinst and prerm "
3443 "B<dh_python> [S<I<debhelper options>>] [B<-n>] [B<-V> I<version>] "
3444 "[S<I<module dirs ...>>]"
3450 "dh_python is a debhelper program that is responsible for generating the "
3451 "${python:Depends} substitutions and adding them to substvars files. It will "
3452 "also add a postinst and a prerm script if required."
3458 "The program will look at python scripts and modules in your package, and "
3459 "will use this information to generate a dependency on python, with the "
3460 "current major version, or on pythonX.Y if your scripts or modules need a "
3461 "specific python version. The dependency will be substituted into your "
3462 "package's control file wherever you place the token \"${python:Depends}\"."
3468 "If some modules need to be byte-compiled at install time, appropriate "
3469 "postinst and prerm scripts will be generated. If already byte-compiled "
3470 "modules are found, they are removed."
3475 msgid "If you use this program, your package should build-depend on python."
3480 msgid "I<module dirs>"
3486 "If your package installs python modules in non-standard directories, you can "
3487 "make dh_python check those directories by passing their names on the command "
3488 "line. By default, it will check /usr/lib/site-python, /usr/lib/$PACKAGE, "
3489 "/usr/share/$PACKAGE, /usr/lib/games/$PACKAGE, /usr/share/games/$PACKAGE and "
3490 "/usr/lib/python?.?/site-packages."
3496 "Note: only /usr/lib/site-python, /usr/lib/python?.?/site-packages and the "
3497 "extra names on the command line are searched for binary (.so) modules."
3502 msgid "B<-V> I<version>"
3508 "If the .py files your package ships are meant to be used by a specific "
3509 "pythonX.Y version, you can use this option to specify the desired version, "
3510 "such as 2.3. Do not use if you ship modules in /usr/lib/site-python."
3515 msgid "Debian policy, version 3.5.7"
3520 msgid "Python policy, version 0.3.7"
3525 msgid "Josselin Mouette <joss@debian.org>"
3530 msgid "most ideas stolen from Brendan O'Dea <bod@debian.org>"
3535 msgid "dh_installdocs - install documentation into package build directories"
3539 #: dh_installdocs:14
3541 "B<dh_installdocs> [S<I<debhelper options>>] [B<-A>] [B<-n>] [B<-X>I<item>] "
3546 #: dh_installdocs:18
3548 "dh_installdocs is a debhelper program that is responsible for installing "
3549 "documentation into usr/share/doc/package in package build directories."
3553 #: dh_installdocs:21
3555 "dh_installdocs automatically installs debian/copyright if it exists. If "
3556 "dh_installdocs is acting on multiple packages, debian/copyright files will "
3557 "be installed into all packages. However, if you need to have separate "
3558 "copyright files for different binary packages, you can use files named "
3559 "debian/package.copyright."
3563 #: dh_installdocs:27
3565 "Any filenames specified as parameters will be installed into the first "
3566 "package dh_installdocs is told to act on. By default, this is the first "
3567 "binary package in debian/control, but if you use B<-p>, B<-i>, or B<-a> "
3568 "flags, it will be the first package specified by those flags."
3572 #: dh_installdocs:32
3574 "Also, debian/README.Debian (or debian/README.debian) and debian/TODO, if "
3575 "they exist, will be installed into the first binary package listed in "
3576 "debian/control, if dh_installdocs is acting on that package. Note that "
3577 "debian/TODO will be installed named TODO.Debian, if the package is not a "
3578 "debian native package. Also note that README.debian is installed as "
3579 "README.Debian, for consistency. Note that debian/package.README.Debian and "
3580 "debian/package.TODO can be used to specify files for subpackages."
3584 #: dh_installdocs:40
3585 msgid "Files named debian/package.docs can list other files to be installed."
3589 #: dh_installdocs:42
3591 "Files named debian/package.doc-base, will be installed as doc-base control "
3592 "files, and will make this program automatically generate the postinst and "
3593 "prerm commands needed to interface with the doc-base package. Note that the "
3594 "doc-id will be determined from the \"Document:\" entry in the doc-base "
3595 "control file in question."
3599 #: dh_installdocs:48
3601 "If your package needs to register more than one document, you need multiple "
3602 "files. To accomplish this, you can use files named debian/package.doc-base.*"
3606 #: dh_installdocs:71
3608 "Install these files as documentation into the first package acted on. (Or in "
3609 "all packages if B<-A> is specified)."
3613 #: dh_installdocs:78
3614 msgid "This is an example of a debian/package.docs file:"
3618 #: dh_installdocs:80
3623 " debian/notes-for-maintainers.txt\n"
3624 " docs/manual.txt\n"
3625 " docs/manual.pdf\n"
3626 " docs/manual-html/\n"
3631 #: dh_installdocs:89
3633 "Note that dh_installdocs will happily copy entire directory hierarchies if "
3634 "you ask it to (similar to cp -a). If it is asked to install a directory, it "
3635 "will install the complete contents of the directory."
3639 #: dh_installdocs:93
3641 "Note that this command is not idempotent. \"dh_clean B<-k>\" should be "
3642 "called between invocations of this command. Otherwise, it may cause multiple "
3643 "instances of the same text to be added to maintainer scripts."
3647 #: dh_installcatalogs:5
3648 msgid "dh_installcatalogs - install and register SGML Catalogs"
3652 #: dh_installcatalogs:16
3653 msgid "B<dh_installcatalogs> [S<I<debhelper options>>] [B<-n>]"
3657 #: dh_installcatalogs:20
3659 "dh_installcatalogs is a debhelper program that installs and registers SGML "
3660 "catalogs. (Note: it will be extended for XML catalog registration when "
3661 "xml-core is available.) It complies with the Debian XML/SGML policy."
3665 #: dh_installcatalogs:25
3667 "The file F<debian/I<package>.sgmlcatalogs> contains the catalogs to be "
3668 "installed per package. Each line in that file should be of the form "
3669 "C<source dest>, where C<source> indicates where the catalog resides in the "
3670 "source tree, and C<dest> indicates the destination location for the catalog "
3671 "under the package build area. C<dest> should start with "
3672 "F</usr/share/sgml/>."
3676 #: dh_installcatalogs:32
3678 "Catalogs will be registered in a supercatalog, in "
3679 "F</etc/sgml/I<package>.cat>."
3683 #: dh_installcatalogs:35
3685 "This command automatically adds maintainer script snippets for registering "
3686 "and unregistering the catalogs and \"supercatalogs\" (unless B<-n> is "
3687 "used). A dependency on B<sgml-base> will be added to C<${misc:Depends}>, so "
3688 "be sure your package uses that variable in F<debian/control>. See "
3689 "L<dh_installdeb(1)> for an explanation of Debhelper maintainer script "
3694 #: dh_installcatalogs:48
3695 msgid "Do not modify F<postinst>/F<postrm>/F<prerm> scripts."
3699 #: dh_installcatalogs:109
3700 msgid "F</usr/share/doc/sgml-base-doc/>"
3704 #: dh_installcatalogs:113
3705 msgid "Adam Di Carlo <aph@debian.org>"
3709 #: dh_installmanpages:5
3710 msgid "dh_installmanpages - old-style man page installer"
3714 #: dh_installmanpages:15
3715 msgid "B<dh_installmanpages> [S<I<debhelper options>>] [S<I<file ...>>]"
3719 #: dh_installmanpages:19
3721 "dh_installmanpages is a debhelper program that is responsible for "
3722 "automatically installing man pages into usr/share/man/ and usr/X11R6/man/ in "
3723 "package build directories."
3727 #: dh_installmanpages:23
3729 "This is a DWIM-style program, with an interface unlike the rest of "
3730 "debhelper. It is deprecated, and you are encouraged to use "
3731 "L<dh_installman(1)> instead."
3735 #: dh_installmanpages:27
3737 "dh_installmanpages scans the current directory and all subdirectories for "
3738 "filenames that look like man pages. (Note that only real files are looked "
3739 "at; symlinks are ignored.) It uses L<file(1)> to verify that the files are "
3740 "in the correct format. Then, based on the files' extensions, it installs "
3741 "them into the correct man directory."
3745 #: dh_installmanpages:33
3747 "All filenames specified as parameters will be skipped by "
3748 "dh_installmanpages. This is useful if by default it installs some man pages "
3749 "that you do not want to be installed."
3753 #: dh_installmanpages:37
3755 "After the man page installation step, dh_installmanpages will check to see "
3756 "if any of the man pages are \".so\" links. If so, it changes them to "
3761 #: dh_installmanpages:46
3763 "Do not install these files as man pages, even if they look like valid man "
3768 #: dh_installmanpages:51
3773 #: dh_installmanpages:53
3775 "dh_installmanpages will install the man pages it finds into B<all> packages "
3776 "you tell it to act on, since it can't tell what package the man pages belong "
3777 "in. This is almost never what you really want (use -p to work around this, "
3778 "or use the much better L<dh_installman(1)> program instead)."
3782 #: dh_installmanpages:58
3783 msgid "Files ending in I<.man> will be ignored."
3787 #: dh_installmanpages:60
3789 "Files specified as parameters that contain spaces in their filenames will "
3790 "not be processed properly."
3794 #: dh_installxfonts:5
3795 msgid "dh_installxfonts - register X fonts"
3799 #: dh_installxfonts:14
3800 msgid "B<dh_installxfonts> [S<I<debhelper options>>]"
3804 #: dh_installxfonts:18
3806 "dh_installxfonts is a debhelper program that is responsible for registering "
3807 "X fonts, so their corresponding fonts.dir, fonts.alias, and fonts.scale be "
3808 "rebuilt properly at install time."
3812 #: dh_installxfonts:22
3814 "Before calling this program, you should have installed any X fonts provided "
3815 "by your package into the appropriate location in the package build "
3816 "directory, and if you have fonts.alias or fonts.scale files, you should "
3817 "install them into the correct location under etc/X11/fonts in your package "
3822 #: dh_installxfonts:28
3824 "Your package should depend on xutils (>= 4.0.3) so that the update-fonts-* "
3825 "commands are available. (This program adds that dependency to "
3830 #: dh_installxfonts:32
3832 "This program automatically generates the postinst and postrm commands needed "
3833 "to register X fonts. See L<dh_installdeb(1)> for an explanation of how this "
3838 #: dh_installxfonts:38
3840 "See L<update-fonts-alias(8)>, L<update-fonts-scale(8)>, and "
3841 "L<update-fonts-dir(8)> for more information about X font installation."
3845 #: dh_installxfonts:41
3847 "See Debian policy, section 11.8.5. for details about doing fonts the Debian "
3852 #: dh_installlogcheck:5
3853 msgid "dh_installlogcheck - install logcheck rulefiles into etc/logcheck/"
3857 #: dh_installlogcheck:14
3858 msgid "B<dh_installlogcheck> [S<B<debhelper options>>]"
3862 #: dh_installlogcheck:18
3864 "dh_installlocgheck is a debhelper program that is responsible for installing "
3865 "logcheck rule files into subdirectories of etc/logcheck/ in package build "
3866 "directories. The files debian/package.logcheck.cracking, "
3867 "debian/package.logcheck.violations, "
3868 "debian/package.logcheck.violations.ignore, "
3869 "debian/package.logcheck.ignore.workstation, "
3870 "debian/package.logcheck.ignore.server and "
3871 "debian/package.logcheck.ignore.paranoid are installed if present."
3875 #: dh_installlogcheck:55
3878 "This program is a part of debhelper.\n"
3883 #: dh_installlogcheck:59
3884 msgid "Jon Middleton <jjm@debian.org>"
projects / debhelper.git / blob