]> git.donarmstrong.com Git - debhelper.git/blob - man/po4a/po/debhelper.pot
releasing version 8.9.10
[debhelper.git] / man / po4a / po / debhelper.pot
1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Free Software Foundation, Inc.
3 # This file is distributed under the same license as the PACKAGE package.
4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
5 #
6 #, fuzzy
7 msgid ""
8 msgstr ""
9 "Project-Id-Version: PACKAGE VERSION\n"
10 "POT-Creation-Date: 2011-11-16 11:55-0400\n"
11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13 "Language-Team: LANGUAGE <LL@li.org>\n"
14 "Language: \n"
15 "MIME-Version: 1.0\n"
16 "Content-Type: text/plain; charset=CHARSET\n"
17 "Content-Transfer-Encoding: 8bit\n"
18
19 #. type: =head1
20 #: debhelper.pod:1 dh:3 dh_auto_build:3 dh_auto_clean:3 dh_auto_configure:3 dh_auto_install:3 dh_auto_test:3 dh_bugfiles:3 dh_builddeb:3 dh_clean:3 dh_compress:3 dh_desktop:3 dh_fixperms:3 dh_gconf:3 dh_gencontrol:3 dh_icons:3 dh_install:3 dh_installcatalogs:3 dh_installchangelogs:3 dh_installcron:3 dh_installdeb:3 dh_installdebconf:3 dh_installdirs:3 dh_installdocs:3 dh_installemacsen:3 dh_installexamples:3 dh_installifupdown:3 dh_installinfo:3 dh_installinit:3 dh_installlogcheck:3 dh_installlogrotate:3 dh_installman:3 dh_installmanpages:3 dh_installmenu:3 dh_installmime:3 dh_installmodules:3 dh_installpam:3 dh_installppp:3 dh_installudev:3 dh_installwm:3 dh_installxfonts:3 dh_link:3 dh_lintian:3 dh_listpackages:3 dh_makeshlibs:3 dh_md5sums:3 dh_movefiles:3 dh_perl:3 dh_prep:3 dh_python:3 dh_scrollkeeper:3 dh_shlibdeps:3 dh_strip:3 dh_suidregister:3 dh_testdir:3 dh_testroot:3 dh_undocumented:3 dh_usrlocal:3
21 msgid "NAME"
22 msgstr ""
23
24 #. type: textblock
25 #: debhelper.pod:3
26 msgid "debhelper - the debhelper tool suite"
27 msgstr ""
28
29 #. type: =head1
30 #: debhelper.pod:5 dh:12 dh_auto_build:12 dh_auto_clean:13 dh_auto_configure:12 dh_auto_install:15 dh_auto_test:13 dh_bugfiles:12 dh_builddeb:12 dh_clean:12 dh_compress:13 dh_desktop:12 dh_fixperms:12 dh_gconf:12 dh_gencontrol:12 dh_icons:13 dh_install:13 dh_installcatalogs:14 dh_installchangelogs:12 dh_installcron:12 dh_installdeb:12 dh_installdebconf:12 dh_installdirs:12 dh_installdocs:12 dh_installemacsen:12 dh_installexamples:12 dh_installifupdown:12 dh_installinfo:12 dh_installinit:12 dh_installlogcheck:12 dh_installlogrotate:12 dh_installman:13 dh_installmanpages:13 dh_installmenu:12 dh_installmime:12 dh_installmodules:14 dh_installpam:12 dh_installppp:12 dh_installudev:13 dh_installwm:12 dh_installxfonts:12 dh_link:13 dh_lintian:12 dh_listpackages:12 dh_makeshlibs:12 dh_md5sums:13 dh_movefiles:12 dh_perl:14 dh_prep:12 dh_python:13 dh_scrollkeeper:12 dh_shlibdeps:13 dh_strip:13 dh_suidregister:7 dh_testdir:12 dh_testroot:7 dh_undocumented:12 dh_usrlocal:15
31 msgid "SYNOPSIS"
32 msgstr ""
33
34 #. type: textblock
35 #: debhelper.pod:7
36 msgid ""
37 "B<dh_>I<*> [B<-v>] [B<-a>] [B<-i>] [B<-s>] [B<--no-act>] [B<-p>I<package>] "
38 "[B<-N>I<package>] [B<-P>I<tmpdir>]"
39 msgstr ""
40
41 #. type: =head1
42 #: debhelper.pod:9 dh:16 dh_auto_build:16 dh_auto_clean:17 dh_auto_configure:16 dh_auto_install:19 dh_auto_test:17 dh_bugfiles:16 dh_builddeb:16 dh_clean:16 dh_compress:17 dh_desktop:16 dh_fixperms:16 dh_gconf:16 dh_gencontrol:16 dh_icons:17 dh_install:17 dh_installcatalogs:18 dh_installchangelogs:16 dh_installcron:16 dh_installdeb:16 dh_installdebconf:16 dh_installdirs:16 dh_installdocs:16 dh_installemacsen:16 dh_installexamples:16 dh_installifupdown:16 dh_installinfo:16 dh_installinit:16 dh_installlogcheck:16 dh_installlogrotate:16 dh_installman:17 dh_installmanpages:17 dh_installmenu:16 dh_installmime:16 dh_installmodules:18 dh_installpam:16 dh_installppp:16 dh_installudev:17 dh_installwm:16 dh_installxfonts:16 dh_link:17 dh_lintian:16 dh_listpackages:16 dh_makeshlibs:16 dh_md5sums:17 dh_movefiles:16 dh_perl:18 dh_prep:16 dh_python:17 dh_scrollkeeper:16 dh_shlibdeps:17 dh_strip:17 dh_suidregister:11 dh_testdir:16 dh_testroot:11 dh_undocumented:16 dh_usrlocal:19
43 msgid "DESCRIPTION"
44 msgstr ""
45
46 #. type: textblock
47 #: debhelper.pod:11
48 msgid ""
49 "Debhelper is used to help you build a Debian package. The philosophy behind "
50 "debhelper is to provide a collection of small, simple, and easily understood "
51 "tools that are used in F<debian/rules> to automate various common aspects of "
52 "building a package. This means less work for you, the packager.  It also, to "
53 "some degree means that these tools can be changed if Debian policy changes, "
54 "and packages that use them will require only a rebuild to comply with the "
55 "new policy."
56 msgstr ""
57
58 #. type: textblock
59 #: debhelper.pod:19
60 msgid ""
61 "A typical F<debian/rules> file that uses debhelper will call several "
62 "debhelper commands in sequence, or use L<dh(1)> to automate this "
63 "process. Examples of rules files that use debhelper are in "
64 "F</usr/share/doc/debhelper/examples/>"
65 msgstr ""
66
67 #. type: textblock
68 #: debhelper.pod:23
69 msgid ""
70 "To create a new Debian package using debhelper, you can just copy one of the "
71 "sample rules files and edit it by hand. Or you can try the B<dh-make> "
72 "package, which contains a L<dh_make|dh_make(1)> command that partially "
73 "automates the process. For a more gentle introduction, the B<maint-guide> "
74 "Debian package contains a tutorial about making your first package using "
75 "debhelper."
76 msgstr ""
77
78 #. type: =head1
79 #: debhelper.pod:29
80 msgid "DEBHELPER COMMANDS"
81 msgstr ""
82
83 #. type: textblock
84 #: debhelper.pod:31
85 msgid ""
86 "Here is the list of debhelper commands you can use. See their man pages for "
87 "additional documentation."
88 msgstr ""
89
90 #. type: textblock
91 #: debhelper.pod:36
92 msgid "#LIST#"
93 msgstr ""
94
95 #. type: =head2
96 #: debhelper.pod:40
97 msgid "Deprecated Commands"
98 msgstr ""
99
100 #. type: textblock
101 #: debhelper.pod:42
102 msgid "A few debhelper commands are deprecated and should not be used."
103 msgstr ""
104
105 #. type: textblock
106 #: debhelper.pod:46
107 msgid "#LIST_DEPRECATED#"
108 msgstr ""
109
110 #. type: =head2
111 #: debhelper.pod:50
112 msgid "Other Commands"
113 msgstr ""
114
115 #. type: textblock
116 #: debhelper.pod:52
117 msgid ""
118 "If a program's name starts with B<dh_>, and the program is not on the above "
119 "lists, then it is not part of the debhelper package, but it should still "
120 "work like the other programs described on this page."
121 msgstr ""
122
123 #. type: =head1
124 #: debhelper.pod:56
125 msgid "DEBHELPER CONFIG FILES"
126 msgstr ""
127
128 #. type: textblock
129 #: debhelper.pod:58
130 msgid ""
131 "Many debhelper commands make use of files in F<debian/> to control what they "
132 "do. Besides the common F<debian/changelog> and F<debian/control>, which are "
133 "in all packages, not just those using debhelper, some additional files can "
134 "be used to configure the behavior of specific debhelper commands. These "
135 "files are typically named debian/I<package>.foo (where I<package> of course, "
136 "is replaced with the package that is being acted on)."
137 msgstr ""
138
139 #. type: textblock
140 #: debhelper.pod:65
141 msgid ""
142 "For example, B<dh_installdocs> uses files named F<debian/package.docs> to "
143 "list the documentation files it will install. See the man pages of "
144 "individual commands for details about the names and formats of the files "
145 "they use.  Generally, these files will list files to act on, one file per "
146 "line. Some programs in debhelper use pairs of files and destinations or "
147 "slightly more complicated formats."
148 msgstr ""
149
150 #. type: textblock
151 #: debhelper.pod:72
152 msgid ""
153 "Note that if a package is the first (or only) binary package listed in "
154 "F<debian/control>, debhelper will use F<debian/foo> if no "
155 "F<debian/package.foo> file can be found."
156 msgstr ""
157
158 #. type: textblock
159 #: debhelper.pod:76
160 msgid ""
161 "In some rare cases, you may want to have different versions of these files "
162 "for different architectures or OSes. If files named "
163 "debian/I<package>.foo.I<ARCH> or debian/I<package>.foo.I<OS> exist, where "
164 "I<ARCH> and I<OS> are the same as the output of \"B<dpkg-architecture "
165 "-qDEB_HOST_ARCH>\" / \"B<dpkg-architecture -qDEB_HOST_ARCH_OS>\", then they "
166 "will be used in preference to other, more general files."
167 msgstr ""
168
169 #. type: textblock
170 #: debhelper.pod:83
171 msgid ""
172 "In many cases, these config files are used to specify various types of "
173 "files. Documentation or example files to install, files to move, and so on.  "
174 "When appropriate, in cases like these, you can use standard shell wildcard "
175 "characters (B<?> and B<*> and B<[>I<..>B<]> character classes) in the files."
176 msgstr ""
177
178 #. type: textblock
179 #: debhelper.pod:88
180 msgid ""
181 "You can also put comments in these files; lines beginning with B<#> are "
182 "ignored."
183 msgstr ""
184
185 #. type: =head1
186 #: debhelper.pod:91
187 msgid "SHARED DEBHELPER OPTIONS"
188 msgstr ""
189
190 #. type: textblock
191 #: debhelper.pod:93
192 msgid "The following command line options are supported by all debhelper programs."
193 msgstr ""
194
195 #. type: =item
196 #: debhelper.pod:97
197 msgid "B<-v>, B<--verbose>"
198 msgstr ""
199
200 #. type: textblock
201 #: debhelper.pod:99
202 msgid "Verbose mode: show all commands that modify the package build directory."
203 msgstr ""
204
205 #. type: =item
206 #: debhelper.pod:101 dh:64
207 msgid "B<--no-act>"
208 msgstr ""
209
210 #. type: textblock
211 #: debhelper.pod:103
212 msgid ""
213 "Do not really do anything. If used with -v, the result is that the command "
214 "will output what it would have done."
215 msgstr ""
216
217 #. type: =item
218 #: debhelper.pod:106
219 msgid "B<-a>, B<--arch>"
220 msgstr ""
221
222 #. type: textblock
223 #: debhelper.pod:108
224 msgid ""
225 "Act on architecture dependent packages that should be built for the build "
226 "architecture."
227 msgstr ""
228
229 #. type: =item
230 #: debhelper.pod:111
231 msgid "B<-i>, B<--indep>"
232 msgstr ""
233
234 #. type: textblock
235 #: debhelper.pod:113
236 msgid "Act on all architecture independent packages."
237 msgstr ""
238
239 #. type: =item
240 #: debhelper.pod:115
241 msgid "B<-p>I<package>, B<--package=>I<package>"
242 msgstr ""
243
244 #. type: textblock
245 #: debhelper.pod:117
246 msgid ""
247 "Act on the package named I<package>. This option may be specified multiple "
248 "times to make debhelper operate on a given set of packages."
249 msgstr ""
250
251 #. type: =item
252 #: debhelper.pod:120
253 msgid "B<-s>, B<--same-arch>"
254 msgstr ""
255
256 #. type: textblock
257 #: debhelper.pod:122
258 msgid ""
259 "This used to be a smarter version of the B<-a> flag, but the B<-a> flag is "
260 "now equally smart."
261 msgstr ""
262
263 #. type: =item
264 #: debhelper.pod:125
265 msgid "B<-N>I<package>, B<--no-package=>I<package>"
266 msgstr ""
267
268 #. type: textblock
269 #: debhelper.pod:127
270 msgid ""
271 "Do not act on the specified package even if an B<-a>, B<-i>, or B<-p> option "
272 "lists the package as one that should be acted on."
273 msgstr ""
274
275 #. type: =item
276 #: debhelper.pod:130
277 msgid "B<--remaining-packages>"
278 msgstr ""
279
280 #. type: textblock
281 #: debhelper.pod:132
282 msgid ""
283 "Do not act on the packages which have already been acted on by this "
284 "debhelper command earlier (i.e. if the command is present in the package "
285 "debhelper log).  For example, if you need to call the command with special "
286 "options only for a couple of binary packages, pass this option to the last "
287 "call of the command to process the rest of packages with default settings."
288 msgstr ""
289
290 #. type: =item
291 #: debhelper.pod:138
292 msgid "B<--ignore=>I<file>"
293 msgstr ""
294
295 #. type: textblock
296 #: debhelper.pod:140
297 msgid ""
298 "Ignore the specified file. This can be used if F<debian/> contains a "
299 "debhelper config file that a debhelper command should not act on. Note that "
300 "F<debian/compat>, F<debian/control>, and F<debian/changelog> can't be "
301 "ignored, but then, there should never be a reason to ignore those files."
302 msgstr ""
303
304 #. type: textblock
305 #: debhelper.pod:145
306 msgid ""
307 "For example, if upstream ships a F<debian/init> that you don't want "
308 "B<dh_installinit> to install, use B<--ignore=debian/init>"
309 msgstr ""
310
311 #. type: =item
312 #: debhelper.pod:148
313 msgid "B<-P>I<tmpdir>, B<--tmpdir=>I<tmpdir>"
314 msgstr ""
315
316 #. type: textblock
317 #: debhelper.pod:150
318 msgid "Use I<tmpdir> for package build directory. The default is debian/I<package>"
319 msgstr ""
320
321 #. type: =item
322 #: debhelper.pod:152
323 msgid "B<--mainpackage=>I<package>"
324 msgstr ""
325
326 #. type: textblock
327 #: debhelper.pod:154
328 msgid ""
329 "This little-used option changes the package which debhelper considers the "
330 "\"main package\", that is, the first one listed in F<debian/control>, and "
331 "the one for which F<debian/foo> files can be used instead of the usual "
332 "F<debian/package.foo> files."
333 msgstr ""
334
335 #. type: =item
336 #: debhelper.pod:159
337 msgid "B<-O=>I<option>|I<bundle>"
338 msgstr ""
339
340 #. type: textblock
341 #: debhelper.pod:161
342 msgid ""
343 "This is used by L<dh(1)> when passing user-specified options to all the "
344 "commands it runs. If the command supports the specified option or option "
345 "bundle, it will take effect. If the command does not support the option (or "
346 "any part of an option bundle), it will be ignored."
347 msgstr ""
348
349 #. type: =head1
350 #: debhelper.pod:168
351 msgid "COMMON DEBHELPER OPTIONS"
352 msgstr ""
353
354 #. type: textblock
355 #: debhelper.pod:170
356 msgid ""
357 "The following command line options are supported by some debhelper "
358 "programs.  See the man page of each program for a complete explanation of "
359 "what each option does."
360 msgstr ""
361
362 #. type: =item
363 #: debhelper.pod:176
364 msgid "B<-n>"
365 msgstr ""
366
367 #. type: textblock
368 #: debhelper.pod:178
369 msgid "Do not modify F<postinst>, F<postrm>, etc. scripts."
370 msgstr ""
371
372 #. type: =item
373 #: debhelper.pod:180 dh_compress:52 dh_install:76 dh_installchangelogs:68 dh_installdocs:75 dh_installexamples:41 dh_link:60 dh_makeshlibs:81 dh_md5sums:37 dh_shlibdeps:30 dh_strip:39
374 msgid "B<-X>I<item>, B<--exclude=>I<item>"
375 msgstr ""
376
377 #. type: textblock
378 #: debhelper.pod:182
379 msgid ""
380 "Exclude an item from processing. This option may be used multiple times, to "
381 "exclude more than one thing."
382 msgstr ""
383
384 #. type: =item
385 #: debhelper.pod:185 dh_bugfiles:54 dh_compress:59 dh_installdirs:35 dh_installdocs:70 dh_installexamples:36 dh_installinfo:35 dh_installman:64 dh_link:55
386 msgid "B<-A>, B<--all>"
387 msgstr ""
388
389 #. type: textblock
390 #: debhelper.pod:187
391 msgid ""
392 "Makes files or other items that are specified on the command line take "
393 "effect in ALL packages acted on, not just the first."
394 msgstr ""
395
396 #. type: =head1
397 #: debhelper.pod:192
398 msgid "BUILD SYSTEM OPTIONS"
399 msgstr ""
400
401 #. type: textblock
402 #: debhelper.pod:194
403 msgid ""
404 "The following command line options are supported by all of the "
405 "B<dh_auto_>I<*> debhelper programs. These programs support a variety of "
406 "build systems, and normally heuristically determine which to use, and how to "
407 "use them.  You can use these command line options to override the default "
408 "behavior.  Typically these are passed to L<dh(1)>, which then passes them to "
409 "all the B<dh_auto_>I<*> programs."
410 msgstr ""
411
412 #. type: =item
413 #: debhelper.pod:203
414 msgid "B<-S>I<buildsystem>, B<--buildsystem=>I<buildsystem>"
415 msgstr ""
416
417 #. type: textblock
418 #: debhelper.pod:205
419 msgid ""
420 "Force use of the specified I<buildsystem>, instead of trying to auto-select "
421 "one which might be applicable for the package."
422 msgstr ""
423
424 #. type: =item
425 #: debhelper.pod:208
426 msgid "B<-D>I<directory>, B<--sourcedirectory=>I<directory>"
427 msgstr ""
428
429 #. type: textblock
430 #: debhelper.pod:210
431 msgid ""
432 "Assume that the original package source tree is at the specified "
433 "I<directory> rather than the top level directory of the Debian source "
434 "package tree."
435 msgstr ""
436
437 #. type: =item
438 #: debhelper.pod:214
439 msgid "B<-B>[I<directory>], B<--builddirectory=>[I<directory>]"
440 msgstr ""
441
442 #. type: textblock
443 #: debhelper.pod:216
444 msgid ""
445 "Enable out of source building and use the specified I<directory> as the "
446 "build directory. If I<directory> parameter is omitted, a default build "
447 "directory will chosen."
448 msgstr ""
449
450 #. type: textblock
451 #: debhelper.pod:220
452 msgid ""
453 "If this option is not specified, building will be done in source by default "
454 "unless the build system requires or prefers out of source tree building.  In "
455 "such a case, the default build directory will be used even if "
456 "B<--builddirectory> is not specified."
457 msgstr ""
458
459 #. type: textblock
460 #: debhelper.pod:225
461 msgid ""
462 "If the build system prefers out of source tree building but still allows in "
463 "source building, the latter can be re-enabled by passing a build directory "
464 "path that is the same as the source directory path."
465 msgstr ""
466
467 #. type: =item
468 #: debhelper.pod:229
469 msgid "B<--parallel>"
470 msgstr ""
471
472 #. type: textblock
473 #: debhelper.pod:231
474 msgid ""
475 "Enable parallel builds if underlying build system supports them.  The number "
476 "of parallel jobs is controlled by the B<DEB_BUILD_OPTIONS> environment "
477 "variable (L<Debian Policy, section 4.9.1>) at build time. It might also be "
478 "subject to a build system specific limit."
479 msgstr ""
480
481 #. type: textblock
482 #: debhelper.pod:236
483 msgid ""
484 "If this option is not specified, debhelper currently defaults to not "
485 "allowing parallel package builds."
486 msgstr ""
487
488 #. type: =item
489 #: debhelper.pod:239
490 msgid "B<--max-parallel=>I<maximum>"
491 msgstr ""
492
493 #. type: textblock
494 #: debhelper.pod:241
495 msgid ""
496 "This option implies B<--parallel> and allows further limiting the number of "
497 "jobs that can be used in a parallel build. If the package build is known to "
498 "only work with certain levels of concurrency, you can set this to the "
499 "maximum level that is known to work, or that you wish to support."
500 msgstr ""
501
502 #. type: =item
503 #: debhelper.pod:246 dh:60
504 msgid "B<--list>, B<-l>"
505 msgstr ""
506
507 #. type: textblock
508 #: debhelper.pod:248
509 msgid ""
510 "List all build systems supported by debhelper on this system. The list "
511 "includes both default and third party build systems (marked as such). Also "
512 "shows which build system would be automatically selected, or which one is "
513 "manually specified with the B<--buildsystem> option."
514 msgstr ""
515
516 #. type: =head1
517 #: debhelper.pod:255
518 msgid "COMPATABILITY LEVELS"
519 msgstr ""
520
521 #. type: textblock
522 #: debhelper.pod:257
523 msgid ""
524 "From time to time, major non-backwards-compatible changes need to be made to "
525 "debhelper, to keep it clean and well-designed as needs change and its author "
526 "gains more experience. To prevent such major changes from breaking existing "
527 "packages, the concept of debhelper compatibility levels was introduced. You "
528 "tell debhelper which compatibility level it should use, and it modifies its "
529 "behavior in various ways."
530 msgstr ""
531
532 #. type: textblock
533 #: debhelper.pod:264
534 msgid ""
535 "Tell debhelper what compatibility level to use by writing a number to "
536 "F<debian/compat>. For example, to turn on v8 mode:"
537 msgstr ""
538
539 #. type: verbatim
540 #: debhelper.pod:267
541 #, no-wrap
542 msgid ""
543 "  % echo 8 > debian/compat\n"
544 "\n"
545 msgstr ""
546
547 #. type: textblock
548 #: debhelper.pod:269
549 msgid ""
550 "Unless otherwise indicated, all debhelper documentation assumes that you are "
551 "using the most recent compatibility level, and in most cases does not "
552 "indicate if the behavior is different in an earlier compatibility level, so "
553 "if you are not using the most recent compatibility level, you're advised to "
554 "read below for notes about what is different in earlier compatibility "
555 "levels."
556 msgstr ""
557
558 #. type: textblock
559 #: debhelper.pod:276
560 msgid "These are the available compatibility levels:"
561 msgstr ""
562
563 #. type: =item
564 #: debhelper.pod:280
565 msgid "v1"
566 msgstr ""
567
568 #. type: textblock
569 #: debhelper.pod:282
570 msgid ""
571 "This is the original debhelper compatibility level, and so it is the default "
572 "one. In this mode, debhelper will use F<debian/tmp> as the package tree "
573 "directory for the first binary package listed in the control file, while "
574 "using debian/I<package> for all other packages listed in the F<control> "
575 "file."
576 msgstr ""
577
578 #. type: textblock
579 #: debhelper.pod:287 debhelper.pod:294 debhelper.pod:317 debhelper.pod:346
580 msgid "This mode is deprecated."
581 msgstr ""
582
583 #. type: =item
584 #: debhelper.pod:289
585 msgid "v2"
586 msgstr ""
587
588 #. type: textblock
589 #: debhelper.pod:291
590 msgid ""
591 "In this mode, debhelper will consistently use debian/I<package> as the "
592 "package tree directory for every package that is built."
593 msgstr ""
594
595 #. type: =item
596 #: debhelper.pod:296
597 msgid "v3"
598 msgstr ""
599
600 #. type: textblock
601 #: debhelper.pod:298
602 msgid "This mode works like v2, with the following additions:"
603 msgstr ""
604
605 #. type: =item
606 #: debhelper.pod:302 debhelper.pod:307 debhelper.pod:311 debhelper.pod:325 debhelper.pod:330 debhelper.pod:335 debhelper.pod:340 debhelper.pod:354 debhelper.pod:358 debhelper.pod:363 debhelper.pod:367 debhelper.pod:379 debhelper.pod:384 debhelper.pod:390 debhelper.pod:396 debhelper.pod:409 debhelper.pod:416 debhelper.pod:420 debhelper.pod:424 debhelper.pod:439 debhelper.pod:443 debhelper.pod:451 debhelper.pod:456 debhelper.pod:470 debhelper.pod:475 debhelper.pod:482 debhelper.pod:487 debhelper.pod:492 debhelper.pod:496 debhelper.pod:502
607 msgid "-"
608 msgstr ""
609
610 #. type: textblock
611 #: debhelper.pod:304
612 msgid ""
613 "Debhelper config files support globbing via B<*> and B<?>, when "
614 "appropriate. To turn this off and use those characters raw, just prefix with "
615 "a backslash."
616 msgstr ""
617
618 #. type: textblock
619 #: debhelper.pod:309
620 msgid ""
621 "B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call "
622 "B<ldconfig>."
623 msgstr ""
624
625 #. type: textblock
626 #: debhelper.pod:313
627 msgid ""
628 "Every file in F<etc/> is automatically flagged as a conffile by "
629 "B<dh_installdeb>."
630 msgstr ""
631
632 #. type: =item
633 #: debhelper.pod:319
634 msgid "v4"
635 msgstr ""
636
637 #. type: textblock
638 #: debhelper.pod:321
639 msgid "Changes from v3 are:"
640 msgstr ""
641
642 #. type: textblock
643 #: debhelper.pod:327
644 msgid ""
645 "B<dh_makeshlibs -V> will not include the Debian part of the version number "
646 "in the generated dependency line in the shlibs file."
647 msgstr ""
648
649 #. type: textblock
650 #: debhelper.pod:332
651 msgid ""
652 "You are encouraged to put the new B<${misc:Depends}> into F<debian/control> "
653 "to supplement the B<${shlibs:Depends}> field."
654 msgstr ""
655
656 #. type: textblock
657 #: debhelper.pod:337
658 msgid ""
659 "B<dh_fixperms> will make all files in F<bin/> directories and in "
660 "F<etc/init.d> executable."
661 msgstr ""
662
663 #. type: textblock
664 #: debhelper.pod:342
665 msgid "B<dh_link> will correct existing links to conform with policy."
666 msgstr ""
667
668 #. type: =item
669 #: debhelper.pod:348
670 msgid "v5"
671 msgstr ""
672
673 #. type: textblock
674 #: debhelper.pod:350
675 msgid "Changes from v4 are:"
676 msgstr ""
677
678 #. type: textblock
679 #: debhelper.pod:356
680 msgid "Comments are ignored in debhelper config files."
681 msgstr ""
682
683 #. type: textblock
684 #: debhelper.pod:360
685 msgid ""
686 "B<dh_strip --dbg-package> now specifies the name of a package to put "
687 "debugging symbols in, not the packages to take the symbols from."
688 msgstr ""
689
690 #. type: textblock
691 #: debhelper.pod:365
692 msgid "B<dh_installdocs> skips installing empty files."
693 msgstr ""
694
695 #. type: textblock
696 #: debhelper.pod:369
697 msgid "B<dh_install> errors out if wildcards expand to nothing."
698 msgstr ""
699
700 #. type: =item
701 #: debhelper.pod:373
702 msgid "v6"
703 msgstr ""
704
705 #. type: textblock
706 #: debhelper.pod:375
707 msgid "Changes from v5 are:"
708 msgstr ""
709
710 #. type: textblock
711 #: debhelper.pod:381
712 msgid ""
713 "Commands that generate maintainer script fragments will order the fragments "
714 "in reverse order for the F<prerm> and F<postrm> scripts."
715 msgstr ""
716
717 #. type: textblock
718 #: debhelper.pod:386
719 msgid ""
720 "B<dh_installwm> will install a slave manpage link for "
721 "F<x-window-manager.1.gz>, if it sees the man page in F<usr/share/man/man1> "
722 "in the package build directory."
723 msgstr ""
724
725 #. type: textblock
726 #: debhelper.pod:392
727 msgid ""
728 "B<dh_builddeb> did not previously delete everything matching "
729 "B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as "
730 "B<CVS:.svn:.git>. Now it does."
731 msgstr ""
732
733 #. type: textblock
734 #: debhelper.pod:398
735 msgid ""
736 "B<dh_installman> allows overwriting existing man pages in the package build "
737 "directory. In previous compatibility levels it silently refuses to do this."
738 msgstr ""
739
740 #. type: =item
741 #: debhelper.pod:403
742 msgid "v7"
743 msgstr ""
744
745 #. type: textblock
746 #: debhelper.pod:405
747 msgid "Changes from v6 are:"
748 msgstr ""
749
750 #. type: textblock
751 #: debhelper.pod:411
752 msgid ""
753 "B<dh_install>, will fall back to looking for files in F<debian/tmp> if it "
754 "doesn't find them in the current directory (or wherever you tell it look "
755 "using B<--sourcedir>). This allows B<dh_install> to interoperate with "
756 "B<dh_auto_install>, which installs to F<debian/tmp>, without needing any "
757 "special parameters."
758 msgstr ""
759
760 #. type: textblock
761 #: debhelper.pod:418
762 msgid "B<dh_clean> will read F<debian/clean> and delete files listed there."
763 msgstr ""
764
765 #. type: textblock
766 #: debhelper.pod:422
767 msgid "B<dh_clean> will delete toplevel F<*-stamp> files."
768 msgstr ""
769
770 #. type: textblock
771 #: debhelper.pod:426
772 msgid ""
773 "B<dh_installchangelogs> will guess at what file is the upstream changelog if "
774 "none is specified."
775 msgstr ""
776
777 #. type: =item
778 #: debhelper.pod:431
779 msgid "v8"
780 msgstr ""
781
782 #. type: textblock
783 #: debhelper.pod:433
784 msgid "This is the recommended mode of operation."
785 msgstr ""
786
787 #. type: textblock
788 #: debhelper.pod:435
789 msgid "Changes from v7 are:"
790 msgstr ""
791
792 #. type: textblock
793 #: debhelper.pod:441
794 msgid "Commands will fail rather than warning when they are passed unknown options."
795 msgstr ""
796
797 #. type: textblock
798 #: debhelper.pod:445
799 msgid ""
800 "B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it "
801 "generates shlibs files for. So B<-X> can be used to exclude libraries.  "
802 "Also, libraries in unusual locations that B<dpkg-gensymbols> would not have "
803 "processed before will be passed to it, a behavior change that can cause some "
804 "packages to fail to build."
805 msgstr ""
806
807 #. type: textblock
808 #: debhelper.pod:453
809 msgid ""
810 "B<dh> requires the sequence to run be specified as the first parameter, and "
811 "any switches come after it. Ie, use \"B<dh $@ --foo>\", not \"B<dh --foo "
812 "$@>\"."
813 msgstr ""
814
815 #. type: textblock
816 #: debhelper.pod:458
817 msgid ""
818 "B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to "
819 "F<Makefile.PL>."
820 msgstr ""
821
822 #. type: =item
823 #: debhelper.pod:462
824 msgid "v9"
825 msgstr ""
826
827 #. type: textblock
828 #: debhelper.pod:464
829 msgid "This compatibility level is still open for development; use with caution."
830 msgstr ""
831
832 #. type: textblock
833 #: debhelper.pod:466
834 msgid "Changes from v8 are:"
835 msgstr ""
836
837 #. type: textblock
838 #: debhelper.pod:472
839 msgid ""
840 "Multiarch support. In particular, B<dh_auto_configure> passes multiarch "
841 "directories to autoconf in --libdir and --libexecdir."
842 msgstr ""
843
844 #. type: textblock
845 #: debhelper.pod:477
846 msgid ""
847 "dh is aware of the usual dependencies between targets in debian/rules.  So, "
848 "\"dh binary\" will run any build, build-arch, build-indep, install, etc "
849 "targets that exist in the rules file. There's no need to define an explicit "
850 "binary target with explicit dependencies on the other targets."
851 msgstr ""
852
853 #. type: textblock
854 #: debhelper.pod:484
855 msgid ""
856 "B<dh_strip> compresses debugging symbol files to reduce the installed size "
857 "of -dbg packages."
858 msgstr ""
859
860 #. type: textblock
861 #: debhelper.pod:489
862 msgid ""
863 "B<dh_auto_configure> does not include the source package name in "
864 "--libexecdir when using autoconf."
865 msgstr ""
866
867 #. type: textblock
868 #: debhelper.pod:494
869 msgid "B<dh> does not default to enabling --with=python-support"
870 msgstr ""
871
872 #. type: textblock
873 #: debhelper.pod:498
874 msgid ""
875 "All of the B<dh_auto_>I<*> debhelper programs and B<dh> set environment "
876 "variables listed by B<dpkg-buildflags>, unless they are already set. They "
877 "support DEB_BUILD_OPTIONS=noopt too."
878 msgstr ""
879
880 #. type: textblock
881 #: debhelper.pod:504
882 msgid "B<dh_auto_configure> passes CFLAGS to perl F<Makefile.PL> and F<Build.PL>"
883 msgstr ""
884
885 #. type: =head1
886 #: debhelper.pod:511 dh_auto_test:45 dh_installcatalogs:59 dh_installdocs:116 dh_installemacsen:67 dh_installexamples:53 dh_installinit:133 dh_installman:81 dh_installmime:51 dh_installmodules:60 dh_installudev:55 dh_installwm:54 dh_installxfonts:37 dh_movefiles:64 dh_strip:68 dh_usrlocal:49
887 msgid "NOTES"
888 msgstr ""
889
890 #. type: =head2
891 #: debhelper.pod:513
892 msgid "Multiple binary package support"
893 msgstr ""
894
895 #. type: textblock
896 #: debhelper.pod:515
897 msgid ""
898 "If your source package generates more than one binary package, debhelper "
899 "programs will default to acting on all binary packages when run. If your "
900 "source package happens to generate one architecture dependent package, and "
901 "another architecture independent package, this is not the correct behavior, "
902 "because you need to generate the architecture dependent packages in the "
903 "binary-arch F<debian/rules> target, and the architecture independent "
904 "packages in the binary-indep F<debian/rules> target."
905 msgstr ""
906
907 #. type: textblock
908 #: debhelper.pod:523
909 msgid ""
910 "To facilitate this, as well as give you more control over which packages are "
911 "acted on by debhelper programs, all debhelper programs accept the B<-a>, "
912 "B<-i>, B<-p>, and B<-s> parameters. These parameters are cumulative.  If "
913 "none are given, debhelper programs default to acting on all packages listed "
914 "in the control file."
915 msgstr ""
916
917 #. type: =head2
918 #: debhelper.pod:529
919 msgid "Automatic generation of Debian install scripts"
920 msgstr ""
921
922 #. type: textblock
923 #: debhelper.pod:531
924 msgid ""
925 "Some debhelper commands will automatically generate parts of Debian "
926 "maintainer scripts. If you want these automatically generated things "
927 "included in your existing Debian maintainer scripts, then you need to add "
928 "B<#DEBHELPER#> to your scripts, in the place the code should be added.  "
929 "B<#DEBHELPER#> will be replaced by any auto-generated code when you run "
930 "B<dh_installdeb>."
931 msgstr ""
932
933 #. type: textblock
934 #: debhelper.pod:538
935 msgid ""
936 "If a script does not exist at all and debhelper needs to add something to "
937 "it, then debhelper will create the complete script."
938 msgstr ""
939
940 #. type: textblock
941 #: debhelper.pod:541
942 msgid ""
943 "All debhelper commands that automatically generate code in this way let it "
944 "be disabled by the -n parameter (see above)."
945 msgstr ""
946
947 #. type: textblock
948 #: debhelper.pod:544
949 msgid ""
950 "Note that the inserted code will be shell code, so you cannot directly use "
951 "it in a Perl script. If you would like to embed it into a Perl script, here "
952 "is one way to do that (note that I made sure that $1, $2, etc are set with "
953 "the set command):"
954 msgstr ""
955
956 #. type: verbatim
957 #: debhelper.pod:549
958 #, no-wrap
959 msgid ""
960 "  my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n"
961 "  #DEBHELPER#\n"
962 "  EOF\n"
963 "  system ($temp) / 256 == 0\n"
964 "  \tor die \"Problem with debhelper scripts: $!\";\n"
965 "\n"
966 msgstr ""
967
968 #. type: =head2
969 #: debhelper.pod:555
970 msgid "Automatic generation of miscellaneous dependencies."
971 msgstr ""
972
973 #. type: textblock
974 #: debhelper.pod:557
975 msgid ""
976 "Some debhelper commands may make the generated package need to depend on "
977 "some other packages. For example, if you use L<dh_installdebconf(1)>, your "
978 "package will generally need to depend on debconf. Or if you use "
979 "L<dh_installxfonts(1)>, your package will generally need to depend on a "
980 "particular version of xutils. Keeping track of these miscellaneous "
981 "dependencies can be annoying since they are dependent on how debhelper does "
982 "things, so debhelper offers a way to automate it."
983 msgstr ""
984
985 #. type: textblock
986 #: debhelper.pod:565
987 msgid ""
988 "All commands of this type, besides documenting what dependencies may be "
989 "needed on their man pages, will automatically generate a substvar called "
990 "B<${misc:Depends}>. If you put that token into your F<debian/control> file, "
991 "it will be expanded to the dependencies debhelper figures you need."
992 msgstr ""
993
994 #. type: textblock
995 #: debhelper.pod:570
996 msgid ""
997 "This is entirely independent of the standard B<${shlibs:Depends}> generated "
998 "by L<dh_makeshlibs(1)>, and the B<${perl:Depends}> generated by "
999 "L<dh_perl(1)>.  You can choose not to use any of these, if debhelper's "
1000 "guesses don't match reality."
1001 msgstr ""
1002
1003 #. type: =head2
1004 #: debhelper.pod:575
1005 msgid "Package build directories"
1006 msgstr ""
1007
1008 #. type: textblock
1009 #: debhelper.pod:577
1010 msgid ""
1011 "By default, all debhelper programs assume that the temporary directory used "
1012 "for assembling the tree of files in a package is debian/I<package>."
1013 msgstr ""
1014
1015 #. type: textblock
1016 #: debhelper.pod:580
1017 msgid ""
1018 "Sometimes, you might want to use some other temporary directory. This is "
1019 "supported by the B<-P> flag. For example, \"B<dh_installdocs "
1020 "-Pdebian/tmp>\", will use B<debian/tmp> as the temporary directory. Note "
1021 "that if you use B<-P>, the debhelper programs can only be acting on a single "
1022 "package at a time. So if you have a package that builds many binary "
1023 "packages, you will need to also use the B<-p> flag to specify which binary "
1024 "package the debhelper program will act on."
1025 msgstr ""
1026
1027 #. type: =head2
1028 #: debhelper.pod:588
1029 msgid "udebs"
1030 msgstr ""
1031
1032 #. type: textblock
1033 #: debhelper.pod:590
1034 msgid ""
1035 "Debhelper includes support for udebs. To create a udeb with debhelper, add "
1036 "\"B<Package-Type: udeb>\" to the package's stanza in F<debian/control>, and "
1037 "build-depend on debhelper (>= 4.2). Debhelper will try to create udebs that "
1038 "comply with debian-installer policy, by making the generated package files "
1039 "end in F<.udeb>, not installing any documentation into a udeb, skipping over "
1040 "F<preinst>, F<postrm>, F<prerm>, and F<config> scripts, etc."
1041 msgstr ""
1042
1043 #. type: =head2
1044 #: debhelper.pod:597
1045 msgid "Build depends"
1046 msgstr ""
1047
1048 #. type: textblock
1049 #: debhelper.pod:599
1050 msgid ""
1051 "Once your package uses debhelper to build, be sure to add debhelper to your "
1052 "Build-Depends line in F<debian/control>. You should build-depend on a "
1053 "version of debhelper equal to (or greater than) the debhelper compatibility "
1054 "level your package uses. So if your package used compatibility level 7:"
1055 msgstr ""
1056
1057 #. type: verbatim
1058 #: debhelper.pod:605
1059 #, no-wrap
1060 msgid ""
1061 "  Build-Depends: debhelper (>= 7)\n"
1062 "\n"
1063 msgstr ""
1064
1065 #. type: =head1
1066 #: debhelper.pod:607
1067 msgid "ENVIRONMENT"
1068 msgstr ""
1069
1070 #. type: =item
1071 #: debhelper.pod:611
1072 msgid "B<DH_VERBOSE>"
1073 msgstr ""
1074
1075 #. type: textblock
1076 #: debhelper.pod:613
1077 msgid ""
1078 "Set to B<1> to enable verbose mode. Debhelper will output every command it "
1079 "runs that modifies files on the build system."
1080 msgstr ""
1081
1082 #. type: =item
1083 #: debhelper.pod:616
1084 msgid "B<DH_COMPAT>"
1085 msgstr ""
1086
1087 #. type: textblock
1088 #: debhelper.pod:618
1089 msgid ""
1090 "Temporarily specifies what compatibility level debhelper should run at, "
1091 "overriding any value in F<debian/compat>."
1092 msgstr ""
1093
1094 #. type: =item
1095 #: debhelper.pod:621
1096 msgid "B<DH_NO_ACT>"
1097 msgstr ""
1098
1099 #. type: textblock
1100 #: debhelper.pod:623
1101 msgid "Set to B<1> to enable no-act mode."
1102 msgstr ""
1103
1104 #. type: =item
1105 #: debhelper.pod:625
1106 msgid "B<DH_OPTIONS>"
1107 msgstr ""
1108
1109 #. type: textblock
1110 #: debhelper.pod:627
1111 msgid ""
1112 "Anything in this variable will be prepended to the command line arguments of "
1113 "all debhelper commands."
1114 msgstr ""
1115
1116 #. type: textblock
1117 #: debhelper.pod:630
1118 msgid ""
1119 "When using L<dh(1)>, it can be passed options that will be passed on to each "
1120 "debhelper command, which is generally better than using DH_OPTIONS."
1121 msgstr ""
1122
1123 #. type: =item
1124 #: debhelper.pod:633
1125 msgid "B<DH_ALWAYS_EXCLUDE>"
1126 msgstr ""
1127
1128 #. type: textblock
1129 #: debhelper.pod:635
1130 msgid ""
1131 "If set, this adds the value the variable is set to to the B<-X> options of "
1132 "all commands that support the B<-X> option. Moreover, B<dh_builddeb> will "
1133 "B<rm -rf> anything that matches the value in your package build tree."
1134 msgstr ""
1135
1136 #. type: textblock
1137 #: debhelper.pod:639
1138 msgid ""
1139 "This can be useful if you are doing a build from a CVS source tree, in which "
1140 "case setting B<DH_ALWAYS_EXCLUDE=CVS> will prevent any CVS directories from "
1141 "sneaking into the package you build. Or, if a package has a source tarball "
1142 "that (unwisely) includes CVS directories, you might want to export "
1143 "B<DH_ALWAYS_EXCLUDE=CVS> in F<debian/rules>, to make it take effect wherever "
1144 "your package is built."
1145 msgstr ""
1146
1147 #. type: textblock
1148 #: debhelper.pod:646
1149 msgid ""
1150 "Multiple things to exclude can be separated with colons, as in "
1151 "B<DH_ALWAYS_EXCLUDE=CVS:.svn>"
1152 msgstr ""
1153
1154 #. type: =head1
1155 #: debhelper.pod:651 dh:890 dh_auto_build:47 dh_auto_clean:50 dh_auto_configure:52 dh_auto_install:85 dh_auto_test:59 dh_bugfiles:122 dh_builddeb:120 dh_clean:142 dh_compress:206 dh_desktop:31 dh_fixperms:127 dh_gconf:99 dh_gencontrol:82 dh_icons:65 dh_install:279 dh_installcatalogs:116 dh_installchangelogs:171 dh_installcron:77 dh_installdeb:144 dh_installdebconf:126 dh_installdirs:86 dh_installdocs:307 dh_installemacsen:124 dh_installexamples:106 dh_installifupdown:69 dh_installinfo:77 dh_installinit:275 dh_installlogcheck:78 dh_installlogrotate:50 dh_installman:259 dh_installmanpages:197 dh_installmenu:87 dh_installmime:95 dh_installmodules:124 dh_installpam:59 dh_installppp:65 dh_installudev:115 dh_installwm:108 dh_installxfonts:87 dh_link:226 dh_lintian:57 dh_listpackages:30 dh_makeshlibs:258 dh_md5sums:90 dh_movefiles:170 dh_perl:146 dh_prep:60 dh_python:280 dh_scrollkeeper:28 dh_shlibdeps:171 dh_strip:235 dh_suidregister:117 dh_testdir:44 dh_testroot:27 dh_undocumented:28 dh_usrlocal:114
1156 msgid "SEE ALSO"
1157 msgstr ""
1158
1159 #. type: =item
1160 #: debhelper.pod:655
1161 msgid "F</usr/share/doc/debhelper/examples/>"
1162 msgstr ""
1163
1164 #. type: textblock
1165 #: debhelper.pod:657
1166 msgid "A set of example F<debian/rules> files that use debhelper."
1167 msgstr ""
1168
1169 #. type: =item
1170 #: debhelper.pod:659
1171 msgid "L<http://kitenet.net/~joey/code/debhelper/>"
1172 msgstr ""
1173
1174 #. type: textblock
1175 #: debhelper.pod:661
1176 msgid "Debhelper web site."
1177 msgstr ""
1178
1179 #. type: =head1
1180 #: debhelper.pod:665 dh:896 dh_auto_build:53 dh_auto_clean:56 dh_auto_configure:58 dh_auto_install:91 dh_auto_test:65 dh_bugfiles:130 dh_builddeb:126 dh_clean:148 dh_compress:212 dh_desktop:37 dh_fixperms:133 dh_gconf:105 dh_gencontrol:88 dh_icons:71 dh_install:285 dh_installcatalogs:122 dh_installchangelogs:177 dh_installcron:83 dh_installdeb:150 dh_installdebconf:132 dh_installdirs:92 dh_installdocs:313 dh_installemacsen:130 dh_installexamples:112 dh_installifupdown:75 dh_installinfo:83 dh_installlogcheck:84 dh_installlogrotate:56 dh_installman:265 dh_installmanpages:203 dh_installmenu:95 dh_installmime:101 dh_installmodules:130 dh_installpam:65 dh_installppp:71 dh_installudev:121 dh_installwm:114 dh_installxfonts:93 dh_link:232 dh_lintian:65 dh_listpackages:36 dh_makeshlibs:264 dh_md5sums:96 dh_movefiles:176 dh_perl:152 dh_prep:66 dh_python:286 dh_scrollkeeper:34 dh_shlibdeps:177 dh_strip:241 dh_suidregister:123 dh_testdir:50 dh_testroot:33 dh_undocumented:34 dh_usrlocal:120
1181 msgid "AUTHOR"
1182 msgstr ""
1183
1184 #. type: textblock
1185 #: debhelper.pod:667 dh:898 dh_auto_build:55 dh_auto_clean:58 dh_auto_configure:60 dh_auto_install:93 dh_auto_test:67 dh_builddeb:128 dh_clean:150 dh_compress:214 dh_fixperms:135 dh_gencontrol:90 dh_install:287 dh_installchangelogs:179 dh_installcron:85 dh_installdeb:152 dh_installdebconf:134 dh_installdirs:94 dh_installdocs:315 dh_installemacsen:132 dh_installexamples:114 dh_installifupdown:77 dh_installinfo:85 dh_installinit:283 dh_installlogrotate:58 dh_installman:267 dh_installmanpages:205 dh_installmenu:97 dh_installmime:103 dh_installmodules:132 dh_installpam:67 dh_installppp:73 dh_installudev:123 dh_installwm:116 dh_installxfonts:95 dh_link:234 dh_listpackages:38 dh_makeshlibs:266 dh_md5sums:98 dh_movefiles:178 dh_prep:68 dh_shlibdeps:179 dh_strip:243 dh_suidregister:125 dh_testdir:52 dh_testroot:35 dh_undocumented:36
1186 msgid "Joey Hess <joeyh@debian.org>"
1187 msgstr ""
1188
1189 #. type: textblock
1190 #: dh:5
1191 msgid "dh - debhelper command sequencer"
1192 msgstr ""
1193
1194 #. type: textblock
1195 #: dh:14
1196 msgid ""
1197 "B<dh> I<sequence> [B<--with> I<addon>[B<,>I<addon> ...]] [B<--list>] "
1198 "[S<I<debhelper options>>]"
1199 msgstr ""
1200
1201 #. type: textblock
1202 #: dh:18
1203 msgid ""
1204 "B<dh> runs a sequence of debhelper commands. The supported I<sequence>s "
1205 "correspond to the targets of a F<debian/rules> file: B<build-arch>, "
1206 "B<build-indep>, B<build>, B<clean>, B<install-indep>, B<install-arch>, "
1207 "B<install>, B<binary-arch>, B<binary-indep>, and B<binary>."
1208 msgstr ""
1209
1210 #. type: =head1
1211 #: dh:23
1212 msgid "OVERRIDE TARGETS"
1213 msgstr ""
1214
1215 #. type: textblock
1216 #: dh:25
1217 msgid ""
1218 "A F<debian/rules> file using B<dh> can override the command that is run at "
1219 "any step in a sequence, by defining an override target."
1220 msgstr ""
1221
1222 #. type: textblock
1223 #: dh:28
1224 msgid ""
1225 "To override I<dh_command>, add a target named B<override_>I<dh_command> to "
1226 "the rules file. When it would normally run I<dh_command>, B<dh> will instead "
1227 "call that target. The override target can then run the command with "
1228 "additional options, or run entirely different commands instead. See examples "
1229 "below.  (Note that to use this feature, you should Build-Depend on debhelper "
1230 "7.0.50 or above.)"
1231 msgstr ""
1232
1233 #. type: textblock
1234 #: dh:36
1235 msgid ""
1236 "Override targets can also be defined to run only when building architecture "
1237 "dependent or architecture independent packages.  Use targets with names like "
1238 "B<override_>I<dh_command>B<-arch> and B<override_>I<dh_command>B<-indep>.  "
1239 "(Note that to use this feature, you should Build-Depend on debhelper 8.9.7 "
1240 "or above.)"
1241 msgstr ""
1242
1243 #. type: =head1
1244 #: dh:43 dh_auto_build:28 dh_auto_clean:30 dh_auto_configure:31 dh_auto_install:43 dh_auto_test:31 dh_bugfiles:50 dh_builddeb:21 dh_clean:41 dh_compress:48 dh_fixperms:31 dh_gconf:39 dh_gencontrol:26 dh_icons:25 dh_install:54 dh_installcatalogs:49 dh_installchangelogs:56 dh_installcron:40 dh_installdebconf:61 dh_installdirs:31 dh_installdocs:66 dh_installemacsen:48 dh_installexamples:32 dh_installifupdown:39 dh_installinfo:31 dh_installinit:48 dh_installlogcheck:42 dh_installlogrotate:22 dh_installman:60 dh_installmanpages:40 dh_installmenu:41 dh_installmime:41 dh_installmodules:44 dh_installpam:31 dh_installppp:35 dh_installudev:35 dh_installwm:34 dh_link:51 dh_makeshlibs:43 dh_md5sums:28 dh_movefiles:38 dh_perl:31 dh_prep:26 dh_python:39 dh_shlibdeps:26 dh_strip:35 dh_testdir:23 dh_usrlocal:39
1245 msgid "OPTIONS"
1246 msgstr ""
1247
1248 #. type: =item
1249 #: dh:47
1250 msgid "B<--with> I<addon>[B<,>I<addon> ...]"
1251 msgstr ""
1252
1253 #. type: textblock
1254 #: dh:49
1255 msgid ""
1256 "Add the debhelper commands specified by the given addon to appropriate "
1257 "places in the sequence of commands that is run. This option can be repeated "
1258 "more than once, or multiple addons can be listed, separated by commas.  This "
1259 "is used when there is a third-party package that provides debhelper "
1260 "commands. See the F<PROGRAMMING> file for documentation about the sequence "
1261 "addon interface."
1262 msgstr ""
1263
1264 #. type: =item
1265 #: dh:56
1266 msgid "B<--without> I<addon>"
1267 msgstr ""
1268
1269 #. type: textblock
1270 #: dh:58
1271 msgid "The inverse of B<--with>, disables using the given addon."
1272 msgstr ""
1273
1274 #. type: textblock
1275 #: dh:62
1276 msgid "List all available addons."
1277 msgstr ""
1278
1279 #. type: textblock
1280 #: dh:66
1281 msgid "Prints commands that would run for a given sequence, but does not run them."
1282 msgstr ""
1283
1284 #. type: textblock
1285 #: dh:70
1286 msgid ""
1287 "Other options passed to B<dh> are passed on to each command it runs. This "
1288 "can be used to set an option like B<-v> or B<-X> or B<-N>, as well as for "
1289 "more specialised options."
1290 msgstr ""
1291
1292 #. type: =head1
1293 #: dh:74 dh_installdocs:105 dh_link:73 dh_makeshlibs:97 dh_shlibdeps:69
1294 msgid "EXAMPLES"
1295 msgstr ""
1296
1297 #. type: textblock
1298 #: dh:76
1299 msgid ""
1300 "To see what commands are included in a sequence, without actually doing "
1301 "anything:"
1302 msgstr ""
1303
1304 #. type: verbatim
1305 #: dh:79
1306 #, no-wrap
1307 msgid ""
1308 "\tdh binary-arch --no-act\n"
1309 "\n"
1310 msgstr ""
1311
1312 #. type: textblock
1313 #: dh:81
1314 msgid ""
1315 "This is a very simple rules file, for packages where the default sequences "
1316 "of commands work with no additional options."
1317 msgstr ""
1318
1319 #. type: verbatim
1320 #: dh:84 dh:105 dh:118
1321 #, no-wrap
1322 msgid ""
1323 "\t#!/usr/bin/make -f\n"
1324 "\t%:\n"
1325 "\t\tdh $@\n"
1326 "\n"
1327 msgstr ""
1328
1329 #. type: textblock
1330 #: dh:88
1331 msgid ""
1332 "Often you'll want to pass an option to a specific debhelper command. The "
1333 "easy way to do with is by adding an override target for that command."
1334 msgstr ""
1335
1336 #. type: verbatim
1337 #: dh:91 dh:176 dh:187
1338 #, no-wrap
1339 msgid ""
1340 "\t#!/usr/bin/make -f\n"
1341 "\t%:\n"
1342 "\t\tdh $@\n"
1343 "\t\n"
1344 msgstr ""
1345
1346 #. type: verbatim
1347 #: dh:95
1348 #, no-wrap
1349 msgid ""
1350 "\toverride_dh_strip:\n"
1351 "\t\tdh_strip -Xfoo\n"
1352 "\t\n"
1353 msgstr ""
1354
1355 #. type: verbatim
1356 #: dh:98
1357 #, no-wrap
1358 msgid ""
1359 "\toverride_dh_auto_configure:\n"
1360 "\t\tdh_auto_configure -- --with-foo --disable-bar\n"
1361 "\n"
1362 msgstr ""
1363
1364 #. type: textblock
1365 #: dh:101
1366 msgid ""
1367 "Sometimes the automated L<dh_auto_configure(1)> and L<dh_auto_build(1)> "
1368 "can't guess what to do for a strange package. Here's how to avoid running "
1369 "either and instead run your own commands."
1370 msgstr ""
1371
1372 #. type: verbatim
1373 #: dh:109
1374 #, no-wrap
1375 msgid ""
1376 "\toverride_dh_auto_configure:\n"
1377 "\t\t./mondoconfig\n"
1378 "\n"
1379 msgstr ""
1380
1381 #. type: verbatim
1382 #: dh:112
1383 #, no-wrap
1384 msgid ""
1385 "\toverride_dh_auto_build:\n"
1386 "\t\tmake universe-explode-in-delight\n"
1387 "\n"
1388 msgstr ""
1389
1390 #. type: textblock
1391 #: dh:115
1392 msgid ""
1393 "Another common case is wanting to do something manually before or after a "
1394 "particular debhelper command is run."
1395 msgstr ""
1396
1397 #. type: verbatim
1398 #: dh:122
1399 #, no-wrap
1400 msgid ""
1401 "\toverride_dh_fixperms:\n"
1402 "\t\tdh_fixperms\n"
1403 "\t\tchmod 4755 debian/foo/usr/bin/foo\n"
1404 "\n"
1405 msgstr ""
1406
1407 #. type: textblock
1408 #: dh:126
1409 msgid ""
1410 "If your package uses autotools and you want to freshen F<config.sub> and "
1411 "F<config.guess> with newer versions from the B<autotools-dev> package at "
1412 "build time, you can use some commands provided in B<autotools-dev> that "
1413 "automate it, like this."
1414 msgstr ""
1415
1416 #. type: verbatim
1417 #: dh:131
1418 #, no-wrap
1419 msgid ""
1420 "\t#!/usr/bin/make -f\n"
1421 "\t%:\n"
1422 "\t\tdh $@ --with autotools_dev\n"
1423 "\n"
1424 msgstr ""
1425
1426 #. type: textblock
1427 #: dh:135
1428 msgid ""
1429 "Python tools are not run by dh by default, due to the continual change in "
1430 "that area. (Before compatability level v9, dh does run B<dh_pysupport>.)  "
1431 "Here is how to use B<dh_python2>."
1432 msgstr ""
1433
1434 #. type: verbatim
1435 #: dh:139
1436 #, no-wrap
1437 msgid ""
1438 "\t#!/usr/bin/make -f\n"
1439 "\t%:\n"
1440 "\t\tdh $@ --with python2\n"
1441 "\n"
1442 msgstr ""
1443
1444 #. type: textblock
1445 #: dh:143
1446 msgid ""
1447 "Here is how to force use of Perl's B<Module::Build> build system, which can "
1448 "be necessary if debhelper wrongly detects that the package uses MakeMaker."
1449 msgstr ""
1450
1451 #. type: verbatim
1452 #: dh:147
1453 #, no-wrap
1454 msgid ""
1455 "\t#!/usr/bin/make -f\n"
1456 "\t%:\n"
1457 "\t\tdh $@ --buildsystem=perl_build\n"
1458 "\n"
1459 msgstr ""
1460
1461 #. type: textblock
1462 #: dh:151
1463 msgid ""
1464 "Here is an example of overriding where the B<dh_auto_>I<*> commands find the "
1465 "package's source, for a package where the source is located in a "
1466 "subdirectory."
1467 msgstr ""
1468
1469 #. type: verbatim
1470 #: dh:155
1471 #, no-wrap
1472 msgid ""
1473 "\t#!/usr/bin/make -f\n"
1474 "\t%:\n"
1475 "\t\tdh $@ --sourcedirectory=src\n"
1476 "\n"
1477 msgstr ""
1478
1479 #. type: textblock
1480 #: dh:159
1481 msgid ""
1482 "And here is an example of how to tell the B<dh_auto_>I<*> commands to build "
1483 "in a subdirectory, which will be removed on B<clean>."
1484 msgstr ""
1485
1486 #. type: verbatim
1487 #: dh:162
1488 #, no-wrap
1489 msgid ""
1490 "\t#!/usr/bin/make -f\n"
1491 "\t%:\n"
1492 "\t\tdh $@ --builddirectory=build\n"
1493 "\n"
1494 msgstr ""
1495
1496 #. type: textblock
1497 #: dh:166
1498 msgid ""
1499 "If your package can be built in parallel, you can support parallel building "
1500 "as follows. Then B<dpkg-buildpackage -j> will work."
1501 msgstr ""
1502
1503 #. type: verbatim
1504 #: dh:169
1505 #, no-wrap
1506 msgid ""
1507 "\t#!/usr/bin/make -f\n"
1508 "\t%:\n"
1509 "\t\tdh $@ --parallel\n"
1510 "\n"
1511 msgstr ""
1512
1513 #. type: textblock
1514 #: dh:173
1515 msgid ""
1516 "Here is a way to prevent B<dh> from running several commands that you don't "
1517 "want it to run, by defining empty override targets for each command."
1518 msgstr ""
1519
1520 #. type: verbatim
1521 #: dh:180
1522 #, no-wrap
1523 msgid ""
1524 "\t# Commands not to run:\n"
1525 "\toverride_dh_auto_test override_dh_compress override_dh_fixperms:\n"
1526 "\n"
1527 msgstr ""
1528
1529 #. type: textblock
1530 #: dh:183
1531 msgid ""
1532 "A long build process for a separate documentation package can be separated "
1533 "out using architecture independent overrides.  These will be skipped when "
1534 "running build-arch and binary-arch sequences."
1535 msgstr ""
1536
1537 #. type: verbatim
1538 #: dh:191
1539 #, no-wrap
1540 msgid ""
1541 "\toverride_dh_auto_build-indep:\n"
1542 "\t\t$(MAKE) -C docs\n"
1543 "\n"
1544 msgstr ""
1545
1546 #. type: verbatim
1547 #: dh:194
1548 #, no-wrap
1549 msgid ""
1550 "\t# No tests needed for docs\n"
1551 "\toverride_dh_auto_test-indep:\n"
1552 "\n"
1553 msgstr ""
1554
1555 #. type: verbatim
1556 #: dh:197
1557 #, no-wrap
1558 msgid ""
1559 "\toverride_dh_auto_install-indep:\n"
1560 "\t\t$(MAKE) -C docs install\n"
1561 "\n"
1562 msgstr ""
1563
1564 #. type: textblock
1565 #: dh:200
1566 msgid ""
1567 "Adding to the example above, suppose you need to chmod a file, but only when "
1568 "building the architecture dependent package, as it's not present when "
1569 "building only documentation."
1570 msgstr ""
1571
1572 #. type: verbatim
1573 #: dh:204
1574 #, no-wrap
1575 msgid ""
1576 "\toverride_dh_fixperms-arch:\n"
1577 "\t\tdh_fixperms\n"
1578 "\t\tchmod 4755 debian/foo/usr/bin/foo\n"
1579 "\n"
1580 msgstr ""
1581
1582 #. type: =head1
1583 #: dh:208
1584 msgid "INTERNALS"
1585 msgstr ""
1586
1587 #. type: textblock
1588 #: dh:210
1589 msgid ""
1590 "If you're curious about B<dh>'s internals, here's how it works under the "
1591 "hood."
1592 msgstr ""
1593
1594 #. type: textblock
1595 #: dh:212
1596 msgid ""
1597 "Each debhelper command will record when it's successfully run in "
1598 "F<debian/package.debhelper.log>. (Which B<dh_clean> deletes.) So B<dh> can "
1599 "tell which commands have already been run, for which packages, and skip "
1600 "running those commands again."
1601 msgstr ""
1602
1603 #. type: textblock
1604 #: dh:217
1605 msgid ""
1606 "Each time B<dh> is run, it examines the log, and finds the last logged "
1607 "command that is in the specified sequence. It then continues with the next "
1608 "command in the sequence. The B<--until>, B<--before>, B<--after>, and "
1609 "B<--remaining> options can override this behavior."
1610 msgstr ""
1611
1612 #. type: textblock
1613 #: dh:222
1614 msgid ""
1615 "A sequence can also run dependent targets in debian/rules.  For example, the "
1616 "\"binary\" sequence runs the \"install\" target."
1617 msgstr ""
1618
1619 #. type: textblock
1620 #: dh:225
1621 msgid ""
1622 "B<dh> uses the B<DH_INTERNAL_OPTIONS> environment variable to pass "
1623 "information through to debhelper commands that are run inside override "
1624 "targets. The contents (and indeed, existence) of this environment variable, "
1625 "as the name might suggest, is subject to change at any time."
1626 msgstr ""
1627
1628 #. type: textblock
1629 #: dh:230
1630 msgid ""
1631 "Commands in the B<build-indep>, B<install-indep> and B<binary-indep> "
1632 "sequences are passed the B<-i> option to ensure they only work on "
1633 "architecture independent packages, and commands in the B<build-arch>, "
1634 "B<install-arch> and B<binary-arch> sequences are passed the B<-a> option to "
1635 "ensure they only work on architecture dependent packages."
1636 msgstr ""
1637
1638 #. type: =head1
1639 #: dh:236
1640 msgid "DEPRECATED OPTIONS"
1641 msgstr ""
1642
1643 #. type: textblock
1644 #: dh:238
1645 msgid ""
1646 "The following options are deprecated. It's much better to use override "
1647 "targets instead."
1648 msgstr ""
1649
1650 #. type: =item
1651 #: dh:243
1652 msgid "B<--until> I<cmd>"
1653 msgstr ""
1654
1655 #. type: textblock
1656 #: dh:245
1657 msgid "Run commands in the sequence until and including I<cmd>, then stop."
1658 msgstr ""
1659
1660 #. type: =item
1661 #: dh:247
1662 msgid "B<--before> I<cmd>"
1663 msgstr ""
1664
1665 #. type: textblock
1666 #: dh:249
1667 msgid "Run commands in the sequence before I<cmd>, then stop."
1668 msgstr ""
1669
1670 #. type: =item
1671 #: dh:251
1672 msgid "B<--after> I<cmd>"
1673 msgstr ""
1674
1675 #. type: textblock
1676 #: dh:253
1677 msgid "Run commands in the sequence that come after I<cmd>."
1678 msgstr ""
1679
1680 #. type: =item
1681 #: dh:255
1682 msgid "B<--remaining>"
1683 msgstr ""
1684
1685 #. type: textblock
1686 #: dh:257
1687 msgid "Run all commands in the sequence that have yet to be run."
1688 msgstr ""
1689
1690 #. type: textblock
1691 #: dh:261
1692 msgid ""
1693 "In the above options, I<cmd> can be a full name of a debhelper command, or a "
1694 "substring. It'll first search for a command in the sequence exactly matching "
1695 "the name, to avoid any ambiguity. If there are multiple substring matches, "
1696 "the last one in the sequence will be used."
1697 msgstr ""
1698
1699 #. type: textblock
1700 #: dh:892 dh_auto_build:49 dh_auto_clean:52 dh_auto_configure:54 dh_auto_install:87 dh_auto_test:61 dh_builddeb:122 dh_clean:144 dh_compress:208 dh_fixperms:129 dh_gconf:101 dh_gencontrol:84 dh_install:281 dh_installcatalogs:118 dh_installchangelogs:173 dh_installcron:79 dh_installdeb:146 dh_installdebconf:128 dh_installdirs:88 dh_installdocs:309 dh_installemacsen:126 dh_installexamples:108 dh_installifupdown:71 dh_installinfo:79 dh_installinit:277 dh_installlogcheck:80 dh_installlogrotate:52 dh_installman:261 dh_installmanpages:199 dh_installmime:97 dh_installmodules:126 dh_installpam:61 dh_installppp:67 dh_installudev:117 dh_installwm:110 dh_installxfonts:89 dh_link:228 dh_listpackages:32 dh_makeshlibs:260 dh_md5sums:92 dh_movefiles:172 dh_perl:148 dh_prep:62 dh_python:282 dh_strip:237 dh_suidregister:119 dh_testdir:46 dh_testroot:29 dh_undocumented:30 dh_usrlocal:116
1701 msgid "L<debhelper(7)>"
1702 msgstr ""
1703
1704 #. type: textblock
1705 #: dh:894 dh_auto_build:51 dh_auto_clean:54 dh_auto_configure:56 dh_auto_install:89 dh_auto_test:63 dh_bugfiles:128 dh_builddeb:124 dh_clean:146 dh_compress:210 dh_desktop:35 dh_fixperms:131 dh_gconf:103 dh_gencontrol:86 dh_icons:69 dh_install:283 dh_installchangelogs:175 dh_installcron:81 dh_installdeb:148 dh_installdebconf:130 dh_installdirs:90 dh_installdocs:311 dh_installemacsen:128 dh_installexamples:110 dh_installifupdown:73 dh_installinfo:81 dh_installinit:279 dh_installlogrotate:54 dh_installman:263 dh_installmanpages:201 dh_installmenu:93 dh_installmime:99 dh_installmodules:128 dh_installpam:63 dh_installppp:69 dh_installudev:119 dh_installwm:112 dh_installxfonts:91 dh_link:230 dh_lintian:61 dh_listpackages:34 dh_makeshlibs:262 dh_md5sums:94 dh_movefiles:174 dh_perl:150 dh_prep:64 dh_python:284 dh_scrollkeeper:32 dh_shlibdeps:175 dh_strip:239 dh_suidregister:121 dh_testdir:48 dh_testroot:31 dh_undocumented:32 dh_usrlocal:118
1706 msgid "This program is a part of debhelper."
1707 msgstr ""
1708
1709 #. type: textblock
1710 #: dh_auto_build:5
1711 msgid "dh_auto_build - automatically builds a package"
1712 msgstr ""
1713
1714 #. type: textblock
1715 #: dh_auto_build:14
1716 msgid ""
1717 "B<dh_auto_build> [S<I<build system options>>] [S<I<debhelper options>>] "
1718 "[S<B<--> I<params>>]"
1719 msgstr ""
1720
1721 #. type: textblock
1722 #: dh_auto_build:18
1723 msgid ""
1724 "B<dh_auto_build> is a debhelper program that tries to automatically build a "
1725 "package. It does so by running the appropriate command for the build system "
1726 "it detects the package uses. For example, if a F<Makefile> is found, this is "
1727 "done by running B<make> (or B<MAKE>, if the environment variable is set). If "
1728 "there's a F<setup.py>, or F<Build.PL>, it is run to build the package."
1729 msgstr ""
1730
1731 #. type: textblock
1732 #: dh_auto_build:24
1733 msgid ""
1734 "This is intended to work for about 90% of packages. If it doesn't work, "
1735 "you're encouraged to skip using B<dh_auto_build> at all, and just run the "
1736 "build process manually."
1737 msgstr ""
1738
1739 #. type: textblock
1740 #: dh_auto_build:30 dh_auto_clean:32 dh_auto_configure:33 dh_auto_install:45 dh_auto_test:33
1741 msgid ""
1742 "See L<debhelper(7)/B<BUILD SYSTEM OPTIONS>> for a list of common build "
1743 "system selection and control options."
1744 msgstr ""
1745
1746 #. type: =item
1747 #: dh_auto_build:35 dh_auto_clean:37 dh_auto_configure:38 dh_auto_install:56 dh_auto_test:38 dh_builddeb:35 dh_gencontrol:30 dh_installdebconf:69 dh_installinit:99 dh_makeshlibs:91 dh_shlibdeps:37
1748 msgid "B<--> I<params>"
1749 msgstr ""
1750
1751 #. type: textblock
1752 #: dh_auto_build:37
1753 msgid ""
1754 "Pass I<params> to the program that is run, after the parameters that "
1755 "B<dh_auto_build> usually passes."
1756 msgstr ""
1757
1758 #. type: textblock
1759 #: dh_auto_clean:5
1760 msgid "dh_auto_clean - automatically cleans up after a build"
1761 msgstr ""
1762
1763 #. type: textblock
1764 #: dh_auto_clean:15
1765 msgid ""
1766 "B<dh_auto_clean> [S<I<build system options>>] [S<I<debhelper options>>] "
1767 "[S<B<--> I<params>>]"
1768 msgstr ""
1769
1770 #. type: textblock
1771 #: dh_auto_clean:19
1772 msgid ""
1773 "B<dh_auto_clean> is a debhelper program that tries to automatically clean up "
1774 "after a package build. It does so by running the appropriate command for the "
1775 "build system it detects the package uses. For example, if there's a "
1776 "F<Makefile> and it contains a B<distclean>, B<realclean>, or B<clean> "
1777 "target, then this is done by running B<make> (or B<MAKE>, if the environment "
1778 "variable is set). If there is a F<setup.py> or F<Build.PL>, it is run to "
1779 "clean the package."
1780 msgstr ""
1781
1782 #. type: textblock
1783 #: dh_auto_clean:26
1784 msgid ""
1785 "This is intended to work for about 90% of packages. If it doesn't work, or "
1786 "tries to use the wrong clean target, you're encouraged to skip using "
1787 "B<dh_auto_clean> at all, and just run B<make clean> manually."
1788 msgstr ""
1789
1790 #. type: textblock
1791 #: dh_auto_clean:39
1792 msgid ""
1793 "Pass I<params> to the program that is run, after the parameters that "
1794 "B<dh_auto_clean> usually passes."
1795 msgstr ""
1796
1797 #. type: textblock
1798 #: dh_auto_configure:5
1799 msgid "dh_auto_configure - automatically configure a package prior to building"
1800 msgstr ""
1801
1802 #. type: textblock
1803 #: dh_auto_configure:14
1804 msgid ""
1805 "B<dh_auto_configure> [S<I<build system options>>] [S<I<debhelper options>>] "
1806 "[S<B<--> I<params>>]"
1807 msgstr ""
1808
1809 #. type: textblock
1810 #: dh_auto_configure:18
1811 msgid ""
1812 "B<dh_auto_configure> is a debhelper program that tries to automatically "
1813 "configure a package prior to building. It does so by running the appropriate "
1814 "command for the build system it detects the package uses.  For example, it "
1815 "looks for and runs a F<./configure> script, F<Makefile.PL>, F<Build.PL>, or "
1816 "F<cmake>. A standard set of parameters is determined and passed to the "
1817 "program that is run. Some build systems, such as make, do not need a "
1818 "configure step; for these B<dh_auto_configure> will exit without doing "
1819 "anything."
1820 msgstr ""
1821
1822 #. type: textblock
1823 #: dh_auto_configure:27
1824 msgid ""
1825 "This is intended to work for about 90% of packages. If it doesn't work, "
1826 "you're encouraged to skip using B<dh_auto_configure> at all, and just run "
1827 "F<./configure> or its equivalent manually."
1828 msgstr ""
1829
1830 #. type: textblock
1831 #: dh_auto_configure:40
1832 msgid ""
1833 "Pass I<params> to the program that is run, after the parameters that "
1834 "B<dh_auto_configure> usually passes. For example:"
1835 msgstr ""
1836
1837 #. type: verbatim
1838 #: dh_auto_configure:43
1839 #, no-wrap
1840 msgid ""
1841 "  dh_auto_configure -- --with-foo --enable-bar\n"
1842 "\n"
1843 msgstr ""
1844
1845 #. type: textblock
1846 #: dh_auto_install:5
1847 msgid "dh_auto_install - automatically runs make install or similar"
1848 msgstr ""
1849
1850 #. type: textblock
1851 #: dh_auto_install:17
1852 msgid ""
1853 "B<dh_auto_install> [S<I<build system options>>] [S<I<debhelper options>>] "
1854 "[S<B<--> I<params>>]"
1855 msgstr ""
1856
1857 #. type: textblock
1858 #: dh_auto_install:21
1859 msgid ""
1860 "B<dh_auto_install> is a debhelper program that tries to automatically "
1861 "install built files. It does so by running the appropriate command for the "
1862 "build system it detects the package uses. For example, if there's a "
1863 "F<Makefile> and it contains a B<install> target, then this is done by "
1864 "running B<make> (or B<MAKE>, if the environment variable is set). If there "
1865 "is a F<setup.py> or F<Build.PL>, it is used. Note that the Ant build system "
1866 "does not support installation, so B<dh_auto_install> will not install files "
1867 "built using Ant."
1868 msgstr ""
1869
1870 #. type: textblock
1871 #: dh_auto_install:29
1872 msgid ""
1873 "Unless B<--destdir> option is specified, the files are installed into "
1874 "debian/I<package>/ if there is only one binary package. In the multiple "
1875 "binary package case, the files are instead installed into F<debian/tmp/>, "
1876 "and should be moved from there to the appropriate package build directory "
1877 "using L<dh_install(1)>."
1878 msgstr ""
1879
1880 #. type: textblock
1881 #: dh_auto_install:35
1882 msgid ""
1883 "B<DESTDIR> is used to tell make where to install the files.  If the Makefile "
1884 "was generated by MakeMaker from a F<Makefile.PL>, it will automatically set "
1885 "B<PREFIX=/usr> too, since such Makefiles need that."
1886 msgstr ""
1887
1888 #. type: textblock
1889 #: dh_auto_install:39
1890 msgid ""
1891 "This is intended to work for about 90% of packages. If it doesn't work, or "
1892 "tries to use the wrong install target, you're encouraged to skip using "
1893 "B<dh_auto_install> at all, and just run make install manually."
1894 msgstr ""
1895
1896 #. type: =item
1897 #: dh_auto_install:50 dh_builddeb:25
1898 msgid "B<--destdir=>I<directory>"
1899 msgstr ""
1900
1901 #. type: textblock
1902 #: dh_auto_install:52
1903 msgid ""
1904 "Install files into the specified I<directory>. If this option is not "
1905 "specified, destination directory is determined automatically as described in "
1906 "the L</B<DESCRIPTION>> section."
1907 msgstr ""
1908
1909 #. type: textblock
1910 #: dh_auto_install:58
1911 msgid ""
1912 "Pass I<params> to the program that is run, after the parameters that "
1913 "B<dh_auto_install> usually passes."
1914 msgstr ""
1915
1916 #. type: textblock
1917 #: dh_auto_test:5
1918 msgid "dh_auto_test - automatically runs a package's test suites"
1919 msgstr ""
1920
1921 #. type: textblock
1922 #: dh_auto_test:15
1923 msgid ""
1924 "B<dh_auto_test> [S<I<build system options>>] [S<I<debhelper options>>] "
1925 "[S<B<--> I<params>>]"
1926 msgstr ""
1927
1928 #. type: textblock
1929 #: dh_auto_test:19
1930 msgid ""
1931 "B<dh_auto_test> is a debhelper program that tries to automatically run a "
1932 "package's test suite. It does so by running the appropriate command for the "
1933 "build system it detects the package uses. For example, if there's a Makefile "
1934 "and it contains a B<test> or B<check> target, then this is done by running "
1935 "B<make> (or B<MAKE>, if the environment variable is set). If the test suite "
1936 "fails, the command will exit nonzero. If there's no test suite, it will exit "
1937 "zero without doing anything."
1938 msgstr ""
1939
1940 #. type: textblock
1941 #: dh_auto_test:27
1942 msgid ""
1943 "This is intended to work for about 90% of packages with a test suite. If it "
1944 "doesn't work, you're encouraged to skip using B<dh_auto_test> at all, and "
1945 "just run the test suite manually."
1946 msgstr ""
1947
1948 #. type: textblock
1949 #: dh_auto_test:40
1950 msgid ""
1951 "Pass I<params> to the program that is run, after the parameters that "
1952 "B<dh_auto_test> usually passes."
1953 msgstr ""
1954
1955 #. type: textblock
1956 #: dh_auto_test:47
1957 msgid ""
1958 "If the B<DEB_BUILD_OPTIONS> environment variable contains B<nocheck>, no "
1959 "tests will be performed."
1960 msgstr ""
1961
1962 #. type: textblock
1963 #: dh_bugfiles:5
1964 msgid ""
1965 "dh_bugfiles - install bug reporting customization files into package build "
1966 "directories"
1967 msgstr ""
1968
1969 #. type: textblock
1970 #: dh_bugfiles:14
1971 msgid "B<dh_bugfiles> [B<-A>] [S<I<debhelper options>>]"
1972 msgstr ""
1973
1974 #. type: textblock
1975 #: dh_bugfiles:18
1976 msgid ""
1977 "B<dh_bugfiles> is a debhelper program that is responsible for installing bug "
1978 "reporting customization files (bug scripts and/or bug control files and/or "
1979 "presubj files) into package build directories."
1980 msgstr ""
1981
1982 #. type: =head1
1983 #: dh_bugfiles:22 dh_clean:31 dh_compress:31 dh_gconf:23 dh_install:38 dh_installcatalogs:35 dh_installchangelogs:32 dh_installcron:21 dh_installdeb:22 dh_installdebconf:34 dh_installdirs:21 dh_installdocs:21 dh_installemacsen:27 dh_installexamples:22 dh_installifupdown:22 dh_installinfo:21 dh_installinit:27 dh_installlogcheck:21 dh_installman:50 dh_installmenu:25 dh_installmime:25 dh_installmodules:29 dh_installpam:21 dh_installppp:21 dh_installudev:25 dh_installwm:24 dh_link:39 dh_lintian:21 dh_makeshlibs:29 dh_movefiles:26
1984 msgid "FILES"
1985 msgstr ""
1986
1987 #. type: =item
1988 #: dh_bugfiles:26
1989 msgid "debian/I<package>.bug-script"
1990 msgstr ""
1991
1992 #. type: textblock
1993 #: dh_bugfiles:28
1994 msgid ""
1995 "This is the script to be run by the bug reporting program for generating a "
1996 "bug report template. This file is installed as F<usr/share/bug/package> in "
1997 "the package build directory if no other types of bug reporting customization "
1998 "files are going to be installed for the package in question. Otherwise, this "
1999 "file is installed as F<usr/share/bug/package/script>. Finally, the installed "
2000 "script is given execute permissions."
2001 msgstr ""
2002
2003 #. type: =item
2004 #: dh_bugfiles:35
2005 msgid "debian/I<package>.bug-control"
2006 msgstr ""
2007
2008 #. type: textblock
2009 #: dh_bugfiles:37
2010 msgid ""
2011 "It is the bug control file containing some directions for the bug reporting "
2012 "tool. This file is installed as F<usr/share/bug/package/control> in the "
2013 "package build directory."
2014 msgstr ""
2015
2016 #. type: =item
2017 #: dh_bugfiles:41
2018 msgid "debian/I<package>.bug-presubj"
2019 msgstr ""
2020
2021 #. type: textblock
2022 #: dh_bugfiles:43
2023 msgid ""
2024 "The contents of this file are displayed to the user by the bug reporting "
2025 "tool before allowing the user to write a bug report on the package to the "
2026 "Debian Bug Tracking System. This file is installed as "
2027 "F<usr/share/bug/package/presubj> in the package build directory."
2028 msgstr ""
2029
2030 #. type: textblock
2031 #: dh_bugfiles:56
2032 msgid ""
2033 "Install F<debian/bug-*> files to ALL packages acted on when respective "
2034 "F<debian/package.bug-*> files do not exist. Normally, F<debian/bug-*> will "
2035 "be installed to the first package only."
2036 msgstr ""
2037
2038 #. type: textblock
2039 #: dh_bugfiles:124
2040 msgid "F</usr/share/doc/reportbug/README.developers.gz>"
2041 msgstr ""
2042
2043 #. type: textblock
2044 #: dh_bugfiles:126 dh_lintian:59
2045 msgid "L<debhelper(1)>"
2046 msgstr ""
2047
2048 #. type: textblock
2049 #: dh_bugfiles:132
2050 msgid "Modestas Vainius <modestas@vainius.eu>"
2051 msgstr ""
2052
2053 #. type: textblock
2054 #: dh_builddeb:5
2055 msgid "dh_builddeb - build Debian binary packages"
2056 msgstr ""
2057
2058 #. type: textblock
2059 #: dh_builddeb:14
2060 msgid ""
2061 "B<dh_builddeb> [S<I<debhelper options>>] [B<--destdir=>I<directory>] "
2062 "[B<--filename=>I<name>] [S<B<--> I<params>>]"
2063 msgstr ""
2064
2065 #. type: textblock
2066 #: dh_builddeb:18
2067 msgid ""
2068 "B<dh_builddeb> simply calls L<dpkg-deb(1)> to build a Debian package or "
2069 "packages."
2070 msgstr ""
2071
2072 #. type: textblock
2073 #: dh_builddeb:27
2074 msgid ""
2075 "Use this if you want the generated F<.deb> files to be put in a directory "
2076 "other than the default of \"F<..>\"."
2077 msgstr ""
2078
2079 #. type: =item
2080 #: dh_builddeb:30
2081 msgid "B<--filename=>I<name>"
2082 msgstr ""
2083
2084 #. type: textblock
2085 #: dh_builddeb:32
2086 msgid ""
2087 "Use this if you want to force the generated .deb file to have a particular "
2088 "file name. Does not work well if more than one .deb is generated!"
2089 msgstr ""
2090
2091 #. type: textblock
2092 #: dh_builddeb:37
2093 msgid "Pass I<params> to L<dpkg-deb(1)> when it is used to build the package."
2094 msgstr ""
2095
2096 #. type: =item
2097 #: dh_builddeb:40
2098 msgid "B<-u>I<params>"
2099 msgstr ""
2100
2101 #. type: textblock
2102 #: dh_builddeb:42
2103 msgid ""
2104 "This is another way to pass I<params> to L<dpkg-deb(1)>.  It is deprecated; "
2105 "use B<--> instead."
2106 msgstr ""
2107
2108 #. type: textblock
2109 #: dh_clean:5
2110 msgid "dh_clean - clean up package build directories"
2111 msgstr ""
2112
2113 #. type: textblock
2114 #: dh_clean:14
2115 msgid ""
2116 "B<dh_clean> [S<I<debhelper options>>] [B<-k>] [B<-d>] [B<-X>I<item>] "
2117 "[S<I<file> ...>]"
2118 msgstr ""
2119
2120 #. type: verbatim
2121 #: dh_clean:18
2122 #, no-wrap
2123 msgid ""
2124 "B<dh_clean> is a debhelper program that is responsible for cleaning up after "
2125 "a\n"
2126 "package is built. It removes the package build directories, and removes "
2127 "some\n"
2128 "other files including F<debian/files>, and any detritus left behind by "
2129 "other\n"
2130 "debhelper commands. It also removes common files that should not appear in "
2131 "a\n"
2132 "Debian diff:\n"
2133 "  #*# *~ DEADJOE *.orig *.rej *.SUMS TAGS .deps/* *.P *-stamp\n"
2134 "\n"
2135 msgstr ""
2136
2137 #. type: textblock
2138 #: dh_clean:25
2139 msgid ""
2140 "It does not run \"make clean\" to clean up after the build process. Use "
2141 "L<dh_auto_clean(1)> to do things like that."
2142 msgstr ""
2143
2144 #. type: textblock
2145 #: dh_clean:28
2146 msgid ""
2147 "B<dh_clean> (or \"B<dh clean>\") should be the last debhelper command run in "
2148 "the B<clean> target in F<debian/rules>."
2149 msgstr ""
2150
2151 #. type: =item
2152 #: dh_clean:35
2153 msgid "F<debian/clean>"
2154 msgstr ""
2155
2156 #. type: textblock
2157 #: dh_clean:37
2158 msgid "Can list other files to be removed."
2159 msgstr ""
2160
2161 #. type: =item
2162 #: dh_clean:45 dh_installchangelogs:60
2163 msgid "B<-k>, B<--keep>"
2164 msgstr ""
2165
2166 #. type: textblock
2167 #: dh_clean:47
2168 msgid "This is deprecated, use L<dh_prep(1)> instead."
2169 msgstr ""
2170
2171 #. type: =item
2172 #: dh_clean:49
2173 msgid "B<-d>, B<--dirs-only>"
2174 msgstr ""
2175
2176 #. type: textblock
2177 #: dh_clean:51
2178 msgid ""
2179 "Only clean the package build directories, do not clean up any other files at "
2180 "all."
2181 msgstr ""
2182
2183 #. type: =item
2184 #: dh_clean:54 dh_prep:30
2185 msgid "B<-X>I<item> B<--exclude=>I<item>"
2186 msgstr ""
2187
2188 #. type: textblock
2189 #: dh_clean:56
2190 msgid ""
2191 "Exclude files that contain I<item> anywhere in their filename from being "
2192 "deleted, even if they would normally be deleted. You may use this option "
2193 "multiple times to build up a list of things to exclude."
2194 msgstr ""
2195
2196 #. type: =item
2197 #: dh_clean:60 dh_compress:64 dh_installdocs:98 dh_installexamples:46 dh_installinfo:40 dh_installmanpages:44 dh_movefiles:55 dh_testdir:27
2198 msgid "I<file> ..."
2199 msgstr ""
2200
2201 #. type: textblock
2202 #: dh_clean:62
2203 msgid "Delete these I<file>s too."
2204 msgstr ""
2205
2206 #. type: textblock
2207 #: dh_compress:5
2208 msgid "dh_compress - compress files and fix symlinks in package build directories"
2209 msgstr ""
2210
2211 #. type: textblock
2212 #: dh_compress:15
2213 msgid ""
2214 "B<dh_compress> [S<I<debhelper options>>] [B<-X>I<item>] [B<-A>] [S<I<file> "
2215 "...>]"
2216 msgstr ""
2217
2218 #. type: textblock
2219 #: dh_compress:19
2220 msgid ""
2221 "B<dh_compress> is a debhelper program that is responsible for compressing "
2222 "the files in package build directories, and makes sure that any symlinks "
2223 "that pointed to the files before they were compressed are updated to point "
2224 "to the new files."
2225 msgstr ""
2226
2227 #. type: textblock
2228 #: dh_compress:24
2229 msgid ""
2230 "By default, B<dh_compress> compresses files that Debian policy mandates "
2231 "should be compressed, namely all files in F<usr/share/info>, "
2232 "F<usr/share/man>, files in F<usr/share/doc> that are larger than 4k in size, "
2233 "(except the F<copyright> file, F<.html> and other web files, image files, "
2234 "and files that appear to be already compressed based on their extensions), "
2235 "and all F<changelog> files. Plus PCF fonts underneath "
2236 "F<usr/share/fonts/X11/>"
2237 msgstr ""
2238
2239 #. type: =item
2240 #: dh_compress:35
2241 msgid "debian/I<package>.compress"
2242 msgstr ""
2243
2244 #. type: textblock
2245 #: dh_compress:37
2246 msgid "These files are deprecated."
2247 msgstr ""
2248
2249 #. type: textblock
2250 #: dh_compress:39
2251 msgid ""
2252 "If this file exists, the default files are not compressed. Instead, the file "
2253 "is ran as a shell script, and all filenames that the shell script outputs "
2254 "will be compressed. The shell script will be run from inside the package "
2255 "build directory. Note though that using B<-X> is a much better idea in "
2256 "general; you should only use a F<debian/package.compress> file if you really "
2257 "need to."
2258 msgstr ""
2259
2260 #. type: textblock
2261 #: dh_compress:54
2262 msgid ""
2263 "Exclude files that contain F<item> anywhere in their filename from being "
2264 "compressed. For example, B<-X.tiff> will exclude TIFF files from "
2265 "compression.  You may use this option multiple times to build up a list of "
2266 "things to exclude."
2267 msgstr ""
2268
2269 #. type: textblock
2270 #: dh_compress:61
2271 msgid ""
2272 "Compress all files specified by command line parameters in ALL packages "
2273 "acted on."
2274 msgstr ""
2275
2276 #. type: textblock
2277 #: dh_compress:66
2278 msgid "Add these files to the list of files to compress."
2279 msgstr ""
2280
2281 #. type: =head1
2282 #: dh_compress:70 dh_perl:61 dh_python:66 dh_strip:74 dh_usrlocal:55
2283 msgid "CONFORMS TO"
2284 msgstr ""
2285
2286 #. type: textblock
2287 #: dh_compress:72
2288 msgid "Debian policy, version 3.0"
2289 msgstr ""
2290
2291 #. type: textblock
2292 #: dh_desktop:5
2293 msgid "dh_desktop - deprecated no-op"
2294 msgstr ""
2295
2296 #. type: textblock
2297 #: dh_desktop:14
2298 msgid "B<dh_desktop> [S<I<debhelper options>>]"
2299 msgstr ""
2300
2301 #. type: textblock
2302 #: dh_desktop:18
2303 msgid ""
2304 "B<dh_desktop> was a debhelper program that registers F<.desktop> files.  "
2305 "However, it no longer does anything, and is now deprecated."
2306 msgstr ""
2307
2308 #. type: textblock
2309 #: dh_desktop:21
2310 msgid ""
2311 "If a package ships F<desktop> files, they just need to be installed in the "
2312 "correct location (F</usr/share/applications>) and they will be registered by "
2313 "the appropriate tools for the corresponding desktop environments."
2314 msgstr ""
2315
2316 #. type: textblock
2317 #: dh_desktop:33 dh_icons:67 dh_scrollkeeper:30
2318 msgid "L<debhelper>"
2319 msgstr ""
2320
2321 #. type: textblock
2322 #: dh_desktop:39 dh_scrollkeeper:36
2323 msgid "Ross Burton <ross@burtonini.com>"
2324 msgstr ""
2325
2326 #. type: textblock
2327 #: dh_fixperms:5
2328 msgid "dh_fixperms - fix permissions of files in package build directories"
2329 msgstr ""
2330
2331 #. type: textblock
2332 #: dh_fixperms:14
2333 msgid "B<dh_fixperms> [S<I<debhelper options>>] [B<-X>I<item>]"
2334 msgstr ""
2335
2336 #. type: textblock
2337 #: dh_fixperms:18
2338 msgid ""
2339 "B<dh_fixperms> is a debhelper program that is responsible for setting the "
2340 "permissions of files and directories in package build directories to a sane "
2341 "state -- a state that complies with Debian policy."
2342 msgstr ""
2343
2344 #. type: textblock
2345 #: dh_fixperms:22
2346 msgid ""
2347 "B<dh_fixperms> makes all files in F<usr/share/doc> in the package build "
2348 "directory (excluding files in the F<examples/> directory) be mode 644. It "
2349 "also changes the permissions of all man pages to mode 644. It makes all "
2350 "files be owned by root, and it removes group and other write permission from "
2351 "all files. It removes execute permissions from any libraries, headers, Perl "
2352 "modules, or desktop files that have it set. It makes all files in the "
2353 "standard F<bin> and F<sbin> directories, F<usr/games/> and F<etc/init.d> "
2354 "executable (since v4). Finally, it removes the setuid and setgid bits from "
2355 "all files in the package."
2356 msgstr ""
2357
2358 #. type: =item
2359 #: dh_fixperms:35
2360 msgid "B<-X>I<item>, B<--exclude> I<item>"
2361 msgstr ""
2362
2363 #. type: textblock
2364 #: dh_fixperms:37
2365 msgid ""
2366 "Exclude files that contain I<item> anywhere in their filename from having "
2367 "their permissions changed. You may use this option multiple times to build "
2368 "up a list of things to exclude."
2369 msgstr ""
2370
2371 #. type: textblock
2372 #: dh_gconf:5
2373 msgid "dh_gconf - install GConf defaults files and register schemas"
2374 msgstr ""
2375
2376 #. type: textblock
2377 #: dh_gconf:14
2378 msgid "B<dh_gconf> [S<I<debhelper options>>] [B<--priority=>I<priority>]"
2379 msgstr ""
2380
2381 #. type: textblock
2382 #: dh_gconf:18
2383 msgid ""
2384 "B<dh_gconf> is a debhelper program that is responsible for installing GConf "
2385 "defaults files and registering GConf schemas."
2386 msgstr ""
2387
2388 #. type: textblock
2389 #: dh_gconf:21
2390 msgid "An appropriate dependency on gconf2 will be generated in B<${misc:Depends}>."
2391 msgstr ""
2392
2393 #. type: =item
2394 #: dh_gconf:27
2395 msgid "debian/I<package>.gconf-defaults"
2396 msgstr ""
2397
2398 #. type: textblock
2399 #: dh_gconf:29
2400 msgid ""
2401 "Installed into F<usr/share/gconf/defaults/10_package> in the package build "
2402 "directory, with I<package> replaced by the package name."
2403 msgstr ""
2404
2405 #. type: =item
2406 #: dh_gconf:32
2407 msgid "debian/I<package>.gconf-mandatory"
2408 msgstr ""
2409
2410 #. type: textblock
2411 #: dh_gconf:34
2412 msgid ""
2413 "Installed into F<usr/share/gconf/mandatory/10_package> in the package build "
2414 "directory, with I<package> replaced by the package name."
2415 msgstr ""
2416
2417 #. type: =item
2418 #: dh_gconf:43
2419 msgid "B<--priority> I<priority>"
2420 msgstr ""
2421
2422 #. type: textblock
2423 #: dh_gconf:45
2424 msgid ""
2425 "Use I<priority> (which should be a 2-digit number) as the defaults priority "
2426 "instead of B<10>. Higher values than ten can be used by derived "
2427 "distributions (B<20>), CDD distributions (B<50>), or site-specific packages "
2428 "(B<90>)."
2429 msgstr ""
2430
2431 #. type: textblock
2432 #: dh_gconf:107
2433 msgid "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>"
2434 msgstr ""
2435
2436 #. type: textblock
2437 #: dh_gencontrol:5
2438 msgid "dh_gencontrol - generate and install control file"
2439 msgstr ""
2440
2441 #. type: textblock
2442 #: dh_gencontrol:14
2443 msgid "B<dh_gencontrol> [S<I<debhelper options>>] [S<B<--> I<params>>]"
2444 msgstr ""
2445
2446 #. type: textblock
2447 #: dh_gencontrol:18
2448 msgid ""
2449 "B<dh_gencontrol> is a debhelper program that is responsible for generating "
2450 "control files, and installing them into the I<DEBIAN> directory with the "
2451 "proper permissions."
2452 msgstr ""
2453
2454 #. type: textblock
2455 #: dh_gencontrol:22
2456 msgid ""
2457 "This program is merely a wrapper around L<dpkg-gencontrol(1)>, which calls "
2458 "it once for each package being acted on, and passes in some additional "
2459 "useful flags."
2460 msgstr ""
2461
2462 #. type: textblock
2463 #: dh_gencontrol:32
2464 msgid "Pass I<params> to L<dpkg-gencontrol(1)>."
2465 msgstr ""
2466
2467 #. type: =item
2468 #: dh_gencontrol:34
2469 msgid "B<-u>I<params>, B<--dpkg-gencontrol-params=>I<params>"
2470 msgstr ""
2471
2472 #. type: textblock
2473 #: dh_gencontrol:36
2474 msgid ""
2475 "This is another way to pass I<params> to L<dpkg-gencontrol(1)>.  It is "
2476 "deprecated; use B<--> instead."
2477 msgstr ""
2478
2479 #. type: textblock
2480 #: dh_icons:5
2481 msgid "dh_icons - Update Freedesktop icon caches"
2482 msgstr ""
2483
2484 #. type: textblock
2485 #: dh_icons:15
2486 msgid "B<dh_icons> [S<I<debhelper options>>] [B<-n>]"
2487 msgstr ""
2488
2489 #. type: textblock
2490 #: dh_icons:19
2491 msgid ""
2492 "B<dh_icons> is a debhelper program that updates Freedesktop icon caches when "
2493 "needed, using the B<update-icon-caches> program provided by GTK+2.12.  "
2494 "Currently this program does not handle installation of the files, though it "
2495 "may do so at a later date. It takes care of adding maintainer script "
2496 "fragments to call B<update-icon-caches>."
2497 msgstr ""
2498
2499 #. type: =item
2500 #: dh_icons:29 dh_installcatalogs:53 dh_installdebconf:65 dh_installemacsen:52 dh_installinit:52 dh_installmenu:45 dh_installmime:45 dh_installmodules:48 dh_installudev:49 dh_installwm:44 dh_makeshlibs:77 dh_python:60 dh_usrlocal:43
2501 msgid "B<-n>, B<--noscripts>"
2502 msgstr ""
2503
2504 #. type: textblock
2505 #: dh_icons:31
2506 msgid "Do not modify maintainer scripts."
2507 msgstr ""
2508
2509 #. type: textblock
2510 #: dh_icons:73
2511 msgid ""
2512 "Ross Burton <ross@burtonini.com> Jordi Mallach <jordi@debian.org> Josselin "
2513 "Mouette <joss@debian.org>"
2514 msgstr ""
2515
2516 #. type: textblock
2517 #: dh_install:5
2518 msgid "dh_install - install files into package build directories"
2519 msgstr ""
2520
2521 #. type: textblock
2522 #: dh_install:15
2523 msgid ""
2524 "B<dh_install> [B<-X>I<item>] [B<--autodest>] [B<--sourcedir=>I<dir>] "
2525 "[S<I<debhelper options>>] [S<I<file> ... I<dest>>]"
2526 msgstr ""
2527
2528 #. type: textblock
2529 #: dh_install:19
2530 msgid ""
2531 "B<dh_install> is a debhelper program that handles installing files into "
2532 "package build directories. There are many B<dh_install>I<*> commands that "
2533 "handle installing specific types of files such as documentation, examples, "
2534 "man pages, and so on, and they should be used when possible as they often "
2535 "have extra intelligence for those particular tasks. B<dh_install>, then, is "
2536 "useful for installing everything else, for which no particular intelligence "
2537 "is needed. It is a replacement for the old B<dh_movefiles> command."
2538 msgstr ""
2539
2540 #. type: textblock
2541 #: dh_install:27
2542 msgid ""
2543 "This program may be used in one of two ways. If you just have a file or two "
2544 "that the upstream Makefile does not install for you, you can run "
2545 "B<dh_install> on them to move them into place. On the other hand, maybe you "
2546 "have a large package that builds multiple binary packages. You can use the "
2547 "upstream F<Makefile> to install it all into F<debian/tmp>, and then use "
2548 "B<dh_install> to copy directories and files from there into the proper "
2549 "package build directories."
2550 msgstr ""
2551
2552 #. type: textblock
2553 #: dh_install:34
2554 msgid ""
2555 "From debhelper compatibility level 7 on, B<dh_install> will fall back to "
2556 "looking in F<debian/tmp> for files, if it doesn't find them in the current "
2557 "directory (or whereever you've told it to look using B<--sourcedir>)."
2558 msgstr ""
2559
2560 #. type: =item
2561 #: dh_install:42
2562 msgid "debian/I<package>.install"
2563 msgstr ""
2564
2565 #. type: textblock
2566 #: dh_install:44
2567 msgid ""
2568 "List the files to install into each package and the directory they should be "
2569 "installed to. The format is a set of lines, where each line lists a file or "
2570 "files to install, and at the end of the line tells the directory it should "
2571 "be installed in. The name of the files (or directories) to install should be "
2572 "given relative to the current directory, while the installation directory is "
2573 "given relative to the package build directory. You may use wildcards in the "
2574 "names of the files to install (in v3 mode and above)."
2575 msgstr ""
2576
2577 #. type: =item
2578 #: dh_install:58
2579 msgid "B<--list-missing>"
2580 msgstr ""
2581
2582 #. type: textblock
2583 #: dh_install:60
2584 msgid ""
2585 "This option makes B<dh_install> keep track of the files it installs, and "
2586 "then at the end, compare that list with the files in the source "
2587 "directory. If any of the files (and symlinks) in the source directory were "
2588 "not installed to somewhere, it will warn on stderr about that."
2589 msgstr ""
2590
2591 #. type: textblock
2592 #: dh_install:65
2593 msgid ""
2594 "This may be useful if you have a large package and want to make sure that "
2595 "you don't miss installing newly added files in new upstream releases."
2596 msgstr ""
2597
2598 #. type: textblock
2599 #: dh_install:68
2600 msgid ""
2601 "Note that files that are excluded from being moved via the B<-X> option are "
2602 "not warned about."
2603 msgstr ""
2604
2605 #. type: =item
2606 #: dh_install:71
2607 msgid "B<--fail-missing>"
2608 msgstr ""
2609
2610 #. type: textblock
2611 #: dh_install:73
2612 msgid ""
2613 "This option is like B<--list-missing>, except if a file was missed, it will "
2614 "not only list the missing files, but also fail with a nonzero exit code."
2615 msgstr ""
2616
2617 #. type: textblock
2618 #: dh_install:78 dh_installexamples:43
2619 msgid ""
2620 "Exclude files that contain I<item> anywhere in their filename from being "
2621 "installed."
2622 msgstr ""
2623
2624 #. type: =item
2625 #: dh_install:81 dh_movefiles:42
2626 msgid "B<--sourcedir=>I<dir>"
2627 msgstr ""
2628
2629 #. type: textblock
2630 #: dh_install:83
2631 msgid "Look in the specified directory for files to be installed."
2632 msgstr ""
2633
2634 #. type: textblock
2635 #: dh_install:85
2636 msgid ""
2637 "Note that this is not the same as the B<--sourcedirectory> option used by "
2638 "the B<dh_auto_>I<*> commands. You rarely need to use this option, since "
2639 "B<dh_install> automatically looks for files in F<debian/tmp> in debhelper "
2640 "compatibility level 7 and above."
2641 msgstr ""
2642
2643 #. type: =item
2644 #: dh_install:90
2645 msgid "B<--autodest>"
2646 msgstr ""
2647
2648 #. type: textblock
2649 #: dh_install:92
2650 msgid ""
2651 "Guess as the destination directory to install things to. If this is "
2652 "specified, you should not list destination directories in "
2653 "F<debian/package.install> files or on the command line. Instead, "
2654 "B<dh_install> will guess as follows:"
2655 msgstr ""
2656
2657 #. type: textblock
2658 #: dh_install:97
2659 msgid ""
2660 "Strip off F<debian/tmp> (or the sourcedir if one is given) from the front of "
2661 "the filename, if it is present, and install into the dirname of the "
2662 "filename. So if the filename is F<debian/tmp/usr/bin>, then that directory "
2663 "will be copied to F<debian/package/usr/>. If the filename is "
2664 "F<debian/tmp/etc/passwd>, it will be copied to F<debian/package/etc/>."
2665 msgstr ""
2666
2667 #. type: textblock
2668 #: dh_install:103
2669 msgid ""
2670 "Note that if you list exactly one filename or wildcard-pattern on a line by "
2671 "itself in a F<debian/package.install> file, with no explicit destination, "
2672 "then B<dh_install> will automatically guess the destination even if this "
2673 "flag is not set."
2674 msgstr ""
2675
2676 #. type: =item
2677 #: dh_install:108
2678 msgid "I<file> ... I<dest>"
2679 msgstr ""
2680
2681 #. type: textblock
2682 #: dh_install:110
2683 msgid ""
2684 "Lists files (or directories) to install and where to install them to.  The "
2685 "files will be installed into the first package F<dh_install> acts on."
2686 msgstr ""
2687
2688 #. type: =head1
2689 #: dh_install:252
2690 msgid "EXAMPLE"
2691 msgstr ""
2692
2693 #. type: textblock
2694 #: dh_install:254
2695 msgid ""
2696 "Suppose your package's upstream F<Makefile> installs a binary, a man page, "
2697 "and a library into appropriate subdirectories of F<debian/tmp>. You want to "
2698 "put the library into package libfoo, and the rest into package foo. Your "
2699 "rules file will run \"B<dh_install --sourcedir=debian/tmp>\". Make "
2700 "F<debian/foo.install> contain:"
2701 msgstr ""
2702
2703 #. type: verbatim
2704 #: dh_install:260
2705 #, no-wrap
2706 msgid ""
2707 "  usr/bin\n"
2708 "  usr/share/man/man1\n"
2709 "\n"
2710 msgstr ""
2711
2712 #. type: textblock
2713 #: dh_install:263
2714 msgid "While F<debian/libfoo.install> contains:"
2715 msgstr ""
2716
2717 #. type: verbatim
2718 #: dh_install:265
2719 #, no-wrap
2720 msgid ""
2721 "  usr/lib/libfoo*.so.*\n"
2722 "\n"
2723 msgstr ""
2724
2725 #. type: textblock
2726 #: dh_install:267
2727 msgid ""
2728 "If you want a libfoo-dev package too, F<debian/libfoo-dev.install> might "
2729 "contain:"
2730 msgstr ""
2731
2732 #. type: verbatim
2733 #: dh_install:269
2734 #, no-wrap
2735 msgid ""
2736 "  usr/include\n"
2737 "  usr/lib/libfoo*.so\n"
2738 "  usr/share/man/man3\n"
2739 "\n"
2740 msgstr ""
2741
2742 #. type: =head1
2743 #: dh_install:273
2744 msgid "LIMITATIONS"
2745 msgstr ""
2746
2747 #. type: verbatim
2748 #: dh_install:275
2749 #, no-wrap
2750 msgid ""
2751 "B<dh_install> cannot rename files or directories, it can only install them\n"
2752 "with the names they already have into wherever you want in the package\n"
2753 "build tree.\n"
2754 "  \n"
2755 msgstr ""
2756
2757 #. type: textblock
2758 #: dh_installcatalogs:5
2759 msgid "dh_installcatalogs - install and register SGML Catalogs"
2760 msgstr ""
2761
2762 #. type: textblock
2763 #: dh_installcatalogs:16
2764 msgid "B<dh_installcatalogs> [S<I<debhelper options>>] [B<-n>]"
2765 msgstr ""
2766
2767 #. type: textblock
2768 #: dh_installcatalogs:20
2769 msgid ""
2770 "B<dh_installcatalogs> is a debhelper program that installs and registers "
2771 "SGML catalogs. It complies with the Debian XML/SGML policy."
2772 msgstr ""
2773
2774 #. type: textblock
2775 #: dh_installcatalogs:23
2776 msgid ""
2777 "Catalogs will be registered in a supercatalog, in "
2778 "F</etc/sgml/I<package>.cat>."
2779 msgstr ""
2780
2781 #. type: textblock
2782 #: dh_installcatalogs:26
2783 msgid ""
2784 "This command automatically adds maintainer script snippets for registering "
2785 "and unregistering the catalogs and supercatalogs (unless B<-n> is "
2786 "used). These snippets are inserted into the maintainer scripts by "
2787 "B<dh_installdeb>; see L<dh_installdeb(1)> for an explanation of Debhelper "
2788 "maintainer script snippets."
2789 msgstr ""
2790
2791 #. type: textblock
2792 #: dh_installcatalogs:32
2793 msgid ""
2794 "A dependency on B<sgml-base> will be added to B<${misc:Depends}>, so be sure "
2795 "your package uses that variable in F<debian/control>."
2796 msgstr ""
2797
2798 #. type: =item
2799 #: dh_installcatalogs:39
2800 msgid "debian/I<package>.sgmlcatalogs"
2801 msgstr ""
2802
2803 #. type: textblock
2804 #: dh_installcatalogs:41
2805 msgid ""
2806 "Lists the catalogs to be installed per package. Each line in that file "
2807 "should be of the form C<I<source> I<dest>>, where I<source> indicates where "
2808 "the catalog resides in the source tree, and I<dest> indicates the "
2809 "destination location for the catalog under the package build area. I<dest> "
2810 "should start with F</usr/share/sgml/>."
2811 msgstr ""
2812
2813 #. type: textblock
2814 #: dh_installcatalogs:55 dh_installinit:54
2815 msgid "Do not modify F<postinst>/F<postrm>/F<prerm> scripts."
2816 msgstr ""
2817
2818 #. type: textblock
2819 #: dh_installcatalogs:61 dh_installdocs:122 dh_installemacsen:69 dh_installinit:135 dh_installmime:53 dh_installmodules:62 dh_installudev:57 dh_installwm:56 dh_usrlocal:51
2820 msgid ""
2821 "Note that this command is not idempotent. L<dh_prep(1)> should be called "
2822 "between invocations of this command. Otherwise, it may cause multiple "
2823 "instances of the same text to be added to maintainer scripts."
2824 msgstr ""
2825
2826 #. type: textblock
2827 #: dh_installcatalogs:120
2828 msgid "F</usr/share/doc/sgml-base-doc/>"
2829 msgstr ""
2830
2831 #. type: textblock
2832 #: dh_installcatalogs:124
2833 msgid "Adam Di Carlo <aph@debian.org>"
2834 msgstr ""
2835
2836 #. type: textblock
2837 #: dh_installchangelogs:5
2838 msgid "dh_installchangelogs - install changelogs into package build directories"
2839 msgstr ""
2840
2841 #. type: textblock
2842 #: dh_installchangelogs:14
2843 msgid ""
2844 "B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] "
2845 "[I<upstream>]"
2846 msgstr ""
2847
2848 #. type: textblock
2849 #: dh_installchangelogs:18
2850 msgid ""
2851 "B<dh_installchangelogs> is a debhelper program that is responsible for "
2852 "installing changelogs into package build directories."
2853 msgstr ""
2854
2855 #. type: textblock
2856 #: dh_installchangelogs:21
2857 msgid ""
2858 "An upstream F<changelog> file may be specified as an option. If none is "
2859 "specified, it looks for files with names that seem likely to be changelogs.  "
2860 "(In compatibility level 7 and above.)"
2861 msgstr ""
2862
2863 #. type: textblock
2864 #: dh_installchangelogs:25
2865 msgid ""
2866 "If there is an upstream F<changelog> file, it will be be installed as "
2867 "F<usr/share/doc/package/changelog> in the package build directory. If the "
2868 "changelog is a F<html> file (determined by file extension), it will be "
2869 "installed as F<usr/share/doc/package/changelog.html> instead, and will be "
2870 "converted to plain text with B<html2text> to generate "
2871 "F<usr/share/doc/package/changelog>."
2872 msgstr ""
2873
2874 #. type: =item
2875 #: dh_installchangelogs:36
2876 msgid "F<debian/changelog>"
2877 msgstr ""
2878
2879 #. type: =item
2880 #: dh_installchangelogs:38
2881 msgid "F<debian/NEWS>"
2882 msgstr ""
2883
2884 #. type: =item
2885 #: dh_installchangelogs:40
2886 msgid "debian/I<package>.changelog"
2887 msgstr ""
2888
2889 #. type: =item
2890 #: dh_installchangelogs:42
2891 msgid "debian/I<package>.NEWS"
2892 msgstr ""
2893
2894 #. type: textblock
2895 #: dh_installchangelogs:44
2896 msgid ""
2897 "Automatically installed into usr/share/doc/I<package>/ in the package build "
2898 "directory."
2899 msgstr ""
2900
2901 #. type: textblock
2902 #: dh_installchangelogs:47
2903 msgid ""
2904 "Use the package specific name if I<package> needs a different F<NEWS> or "
2905 "F<changelog> file."
2906 msgstr ""
2907
2908 #. type: textblock
2909 #: dh_installchangelogs:50
2910 msgid ""
2911 "The F<changelog> file is installed with a name of changelog for native "
2912 "packages, and F<changelog.Debian> for non-native packages.  The F<NEWS> file "
2913 "is always installed with a name of F<NEWS.Debian>."
2914 msgstr ""
2915
2916 #. type: textblock
2917 #: dh_installchangelogs:62
2918 msgid ""
2919 "Keep the original name of the upstream changelog. This will be accomplished "
2920 "by installing the upstream changelog as F<changelog>, and making a symlink "
2921 "from that to the original name of the F<changelog> file. This can be useful "
2922 "if the upstream changelog has an unusual name, or if other documentation in "
2923 "the package refers to the F<changelog> file."
2924 msgstr ""
2925
2926 #. type: textblock
2927 #: dh_installchangelogs:70
2928 msgid ""
2929 "Exclude upstream F<changelog> files that contain I<item> anywhere in their "
2930 "filename from being installed."
2931 msgstr ""
2932
2933 #. type: =item
2934 #: dh_installchangelogs:73
2935 msgid "I<upstream>"
2936 msgstr ""
2937
2938 #. type: textblock
2939 #: dh_installchangelogs:75
2940 msgid "Install this file as the upstream changelog."
2941 msgstr ""
2942
2943 #. type: textblock
2944 #: dh_installcron:5
2945 msgid "dh_installcron - install cron scripts into etc/cron.*"
2946 msgstr ""
2947
2948 #. type: textblock
2949 #: dh_installcron:14
2950 msgid "B<dh_installcron> [S<B<debhelper options>>] [B<--name=>I<name>]"
2951 msgstr ""
2952
2953 #. type: textblock
2954 #: dh_installcron:18
2955 msgid ""
2956 "B<dh_installcron> is a debhelper program that is responsible for installing "
2957 "cron scripts."
2958 msgstr ""
2959
2960 #. type: =item
2961 #: dh_installcron:25
2962 msgid "debian/I<package>.cron.daily"
2963 msgstr ""
2964
2965 #. type: =item
2966 #: dh_installcron:27
2967 msgid "debian/I<package>.cron.weekly"
2968 msgstr ""
2969
2970 #. type: =item
2971 #: dh_installcron:29
2972 msgid "debian/I<package>.cron.monthly"
2973 msgstr ""
2974
2975 #. type: =item
2976 #: dh_installcron:31
2977 msgid "debian/I<package>.cron.hourly"
2978 msgstr ""
2979
2980 #. type: =item
2981 #: dh_installcron:33
2982 msgid "debian/I<package>.cron.d"
2983 msgstr ""
2984
2985 #. type: textblock
2986 #: dh_installcron:35
2987 msgid ""
2988 "Installed into the appropriate F<etc/cron.*/> directory in the package build "
2989 "directory."
2990 msgstr ""
2991
2992 #. type: =item
2993 #: dh_installcron:44 dh_installifupdown:43 dh_installinit:104 dh_installlogcheck:46 dh_installlogrotate:26 dh_installmodules:52 dh_installpam:35 dh_installppp:39 dh_installudev:39
2994 msgid "B<--name=>I<name>"
2995 msgstr ""
2996
2997 #. type: textblock
2998 #: dh_installcron:46
2999 msgid ""
3000 "Look for files named F<debian/package.name.cron.*> and install them as "
3001 "F<etc/cron.*/name>, instead of using the usual files and installing them as "
3002 "the package name."
3003 msgstr ""
3004
3005 #. type: textblock
3006 #: dh_installdeb:5
3007 msgid "dh_installdeb - install files into the DEBIAN directory"
3008 msgstr ""
3009
3010 #. type: textblock
3011 #: dh_installdeb:14
3012 msgid "B<dh_installdeb> [S<I<debhelper options>>]"
3013 msgstr ""
3014
3015 #. type: textblock
3016 #: dh_installdeb:18
3017 msgid ""
3018 "B<dh_installdeb> is a debhelper program that is responsible for installing "
3019 "files into the F<DEBIAN> directories in package build directories with the "
3020 "correct permissions."
3021 msgstr ""
3022
3023 #. type: =item
3024 #: dh_installdeb:26
3025 msgid "I<package>.postinst"
3026 msgstr ""
3027
3028 #. type: =item
3029 #: dh_installdeb:28
3030 msgid "I<package>.preinst"
3031 msgstr ""
3032
3033 #. type: =item
3034 #: dh_installdeb:30
3035 msgid "I<package>.postrm"
3036 msgstr ""
3037
3038 #. type: =item
3039 #: dh_installdeb:32
3040 msgid "I<package>.prerm"
3041 msgstr ""
3042
3043 #. type: textblock
3044 #: dh_installdeb:34
3045 msgid "These maintainer scripts are installed into the F<DEBIAN> directory."
3046 msgstr ""
3047
3048 #. type: textblock
3049 #: dh_installdeb:36
3050 msgid ""
3051 "Inside the scripts, the token B<#DEBHELPER#> is replaced with shell script "
3052 "snippets generated by other debhelper commands."
3053 msgstr ""
3054
3055 #. type: =item
3056 #: dh_installdeb:39
3057 msgid "I<package>.triggers"
3058 msgstr ""
3059
3060 #. type: =item
3061 #: dh_installdeb:41
3062 msgid "I<package>.shlibs"
3063 msgstr ""
3064
3065 #. type: textblock
3066 #: dh_installdeb:43
3067 msgid "These control files are installed into the F<DEBIAN> directory."
3068 msgstr ""
3069
3070 #. type: =item
3071 #: dh_installdeb:45
3072 msgid "I<package>.conffiles"
3073 msgstr ""
3074
3075 #. type: textblock
3076 #: dh_installdeb:47
3077 msgid "This control file will be installed into the F<DEBIAN> directory."
3078 msgstr ""
3079
3080 #. type: textblock
3081 #: dh_installdeb:49
3082 msgid ""
3083 "In v3 compatibility mode and higher, all files in the F<etc/> directory in a "
3084 "package will automatically be flagged as conffiles by this program, so there "
3085 "is no need to list them manually here."
3086 msgstr ""
3087
3088 #. type: =item
3089 #: dh_installdeb:53
3090 msgid "I<package>.maintscript"
3091 msgstr ""
3092
3093 #. type: textblock
3094 #: dh_installdeb:55
3095 msgid ""
3096 "Lines in this file correspond to L<dpkg-maintscript-helper(1)> commands and "
3097 "parameters.  Any shell metacharacters will be escaped, so arbitrary shell "
3098 "code cannot be inserted here.  For example, a line such as C<mv_conffile "
3099 "/etc/oldconffile /etc/newconffile> will insert maintainer script snippets "
3100 "into all maintainer scripts sufficient to move that conffile."
3101 msgstr ""
3102
3103 #. type: textblock
3104 #: dh_installdeb:61
3105 msgid ""
3106 "A versioned Pre-Dependency on dpkg is needed to use "
3107 "L<dpkg-maintscript-helper(1)>. An appropriate Pre-Dependency is set in "
3108 "${misc:Pre-Depends} ; you should make sure to put that token into an "
3109 "appropriate place in your debian/control file."
3110 msgstr ""
3111
3112 #. type: textblock
3113 #: dh_installdebconf:5
3114 msgid ""
3115 "dh_installdebconf - install files used by debconf in package build "
3116 "directories"
3117 msgstr ""
3118
3119 #. type: textblock
3120 #: dh_installdebconf:14
3121 msgid "B<dh_installdebconf> [S<I<debhelper options>>] [B<-n>] [S<B<--> I<params>>]"
3122 msgstr ""
3123
3124 #. type: textblock
3125 #: dh_installdebconf:18
3126 msgid ""
3127 "B<dh_installdebconf> is a debhelper program that is responsible for "
3128 "installing files used by debconf into package build directories."
3129 msgstr ""
3130
3131 #. type: textblock
3132 #: dh_installdebconf:21
3133 msgid ""
3134 "It also automatically generates the F<postrm> commands needed to interface "
3135 "with debconf. The commands are added to the maintainer scripts by "
3136 "B<dh_installdeb>. See L<dh_installdeb(1)> for an explanation of how that "
3137 "works."
3138 msgstr ""
3139
3140 #. type: textblock
3141 #: dh_installdebconf:26
3142 msgid ""
3143 "Note that if you use debconf, your package probably needs to depend on it "
3144 "(it will be added to B<${misc:Depends}> by this program)."
3145 msgstr ""
3146
3147 #. type: textblock
3148 #: dh_installdebconf:29
3149 msgid ""
3150 "Note that for your config script to be called by B<dpkg>, your F<postinst> "
3151 "needs to source debconf's confmodule. B<dh_installdebconf> does not install "
3152 "this statement into the F<postinst> automatically as it it too hard to do it "
3153 "right."
3154 msgstr ""
3155
3156 #. type: =item
3157 #: dh_installdebconf:38
3158 msgid "debian/I<package>.config"
3159 msgstr ""
3160
3161 #. type: textblock
3162 #: dh_installdebconf:40
3163 msgid ""
3164 "This is the debconf F<config> script, and is installed into the F<DEBIAN> "
3165 "directory in the package build directory."
3166 msgstr ""
3167
3168 #. type: textblock
3169 #: dh_installdebconf:43
3170 msgid ""
3171 "Inside the script, the token B<#DEBHELPER#> is replaced with shell script "
3172 "snippets generated by other debhelper commands."
3173 msgstr ""
3174
3175 #. type: =item
3176 #: dh_installdebconf:46
3177 msgid "debian/I<package>.templates"
3178 msgstr ""
3179
3180 #. type: textblock
3181 #: dh_installdebconf:48
3182 msgid ""
3183 "This is the debconf F<templates> file, and is installed into the F<DEBIAN> "
3184 "directory in the package build directory."
3185 msgstr ""
3186
3187 #. type: =item
3188 #: dh_installdebconf:51
3189 msgid "F<debian/po/>"
3190 msgstr ""
3191
3192 #. type: textblock
3193 #: dh_installdebconf:53
3194 msgid ""
3195 "If this directory is present, this program will automatically use "
3196 "L<po2debconf(1)> to generate merged templates files that include the "
3197 "translations from there."
3198 msgstr ""
3199
3200 #. type: textblock
3201 #: dh_installdebconf:57
3202 msgid "For this to work, your package should build-depend on F<po-debconf>."
3203 msgstr ""
3204
3205 #. type: textblock
3206 #: dh_installdebconf:67
3207 msgid "Do not modify F<postrm> script."
3208 msgstr ""
3209
3210 #. type: textblock
3211 #: dh_installdebconf:71
3212 msgid "Pass the params to B<po2debconf>."
3213 msgstr ""
3214
3215 #. type: textblock
3216 #: dh_installdirs:5
3217 msgid "dh_installdirs - create subdirectories in package build directories"
3218 msgstr ""
3219
3220 #. type: textblock
3221 #: dh_installdirs:14
3222 msgid "B<dh_installdirs> [S<I<debhelper options>>] [B<-A>] [S<I<dir> ...>]"
3223 msgstr ""
3224
3225 #. type: textblock
3226 #: dh_installdirs:18
3227 msgid ""
3228 "B<dh_installdirs> is a debhelper program that is responsible for creating "
3229 "subdirectories in package build directories."
3230 msgstr ""
3231
3232 #. type: =item
3233 #: dh_installdirs:25
3234 msgid "debian/I<package>.dirs"
3235 msgstr ""
3236
3237 #. type: textblock
3238 #: dh_installdirs:27
3239 msgid "Lists directories to be created in I<package>."
3240 msgstr ""
3241
3242 #. type: textblock
3243 #: dh_installdirs:37
3244 msgid ""
3245 "Create any directories specified by command line parameters in ALL packages "
3246 "acted on, not just the first."
3247 msgstr ""
3248
3249 #. type: =item
3250 #: dh_installdirs:40
3251 msgid "I<dir> ..."
3252 msgstr ""
3253
3254 #. type: textblock
3255 #: dh_installdirs:42
3256 msgid ""
3257 "Create these directories in the package build directory of the first package "
3258 "acted on. (Or in all packages if B<-A> is specified.)"
3259 msgstr ""
3260
3261 #. type: textblock
3262 #: dh_installdocs:5
3263 msgid "dh_installdocs - install documentation into package build directories"
3264 msgstr ""
3265
3266 #. type: textblock
3267 #: dh_installdocs:14
3268 msgid ""
3269 "B<dh_installdocs> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] "
3270 "[S<I<file> ...>]"
3271 msgstr ""
3272
3273 #. type: textblock
3274 #: dh_installdocs:18
3275 msgid ""
3276 "B<dh_installdocs> is a debhelper program that is responsible for installing "
3277 "documentation into F<usr/share/doc/package> in package build directories."
3278 msgstr ""
3279
3280 #. type: =item
3281 #: dh_installdocs:25
3282 msgid "debian/I<package>.docs"
3283 msgstr ""
3284
3285 #. type: textblock
3286 #: dh_installdocs:27
3287 msgid "List documentation files to be installed into I<package>."
3288 msgstr ""
3289
3290 #. type: =item
3291 #: dh_installdocs:29
3292 msgid "F<debian/copyright>"
3293 msgstr ""
3294
3295 #. type: textblock
3296 #: dh_installdocs:31
3297 msgid ""
3298 "The copyright file is installed into all packages, unless a more specific "
3299 "copyright file is available."
3300 msgstr ""
3301
3302 #. type: =item
3303 #: dh_installdocs:34
3304 msgid "debian/I<package>.copyright"
3305 msgstr ""
3306
3307 #. type: =item
3308 #: dh_installdocs:36
3309 msgid "debian/I<package>.README.Debian"
3310 msgstr ""
3311
3312 #. type: =item
3313 #: dh_installdocs:38
3314 msgid "debian/I<package>.TODO"
3315 msgstr ""
3316
3317 #. type: textblock
3318 #: dh_installdocs:40
3319 msgid "Each of these files is automatically installed if present for a I<package>."
3320 msgstr ""
3321
3322 #. type: =item
3323 #: dh_installdocs:43
3324 msgid "F<debian/README.Debian>"
3325 msgstr ""
3326
3327 #. type: =item
3328 #: dh_installdocs:45
3329 msgid "F<debian/TODO>"
3330 msgstr ""
3331
3332 #. type: textblock
3333 #: dh_installdocs:47
3334 msgid ""
3335 "These files are installed into the first binary package listed in "
3336 "debian/control."
3337 msgstr ""
3338
3339 #. type: textblock
3340 #: dh_installdocs:50
3341 msgid ""
3342 "Note that F<README.debian> files are also installed as F<README.Debian>, and "
3343 "F<TODO> files will be installed as F<TODO.Debian> in non-native packages."
3344 msgstr ""
3345
3346 #. type: =item
3347 #: dh_installdocs:53
3348 msgid "debian/I<package>.doc-base"
3349 msgstr ""
3350
3351 #. type: textblock
3352 #: dh_installdocs:55
3353 msgid ""
3354 "Installed as doc-base control files. Note that the doc-id will be determined "
3355 "from the B<Document:> entry in the doc-base control file in question."
3356 msgstr ""
3357
3358 #. type: =item
3359 #: dh_installdocs:59
3360 msgid "debian/I<package>.doc-base.*"
3361 msgstr ""
3362
3363 #. type: textblock
3364 #: dh_installdocs:61
3365 msgid ""
3366 "If your package needs to register more than one document, you need multiple "
3367 "doc-base files, and can name them like this."
3368 msgstr ""
3369
3370 #. type: textblock
3371 #: dh_installdocs:72 dh_installinfo:37 dh_installman:66
3372 msgid ""
3373 "Install all files specified by command line parameters in ALL packages acted "
3374 "on."
3375 msgstr ""
3376
3377 #. type: textblock
3378 #: dh_installdocs:77
3379 msgid ""
3380 "Exclude files that contain I<item> anywhere in their filename from being "
3381 "installed. Note that this includes doc-base files."
3382 msgstr ""
3383
3384 #. type: =item
3385 #: dh_installdocs:80
3386 msgid "B<--link-doc=>I<package>"
3387 msgstr ""
3388
3389 #. type: textblock
3390 #: dh_installdocs:82
3391 msgid ""
3392 "Make the documentation directory of all packages acted on be a symlink to "
3393 "the documentation directory of I<package>. This has no effect when acting on "
3394 "I<package> itself, or if the documentation directory to be created already "
3395 "exists when B<dh_installdocs> is run. To comply with policy, I<package> must "
3396 "be a binary package that comes from the same source package."
3397 msgstr ""
3398
3399 #. type: textblock
3400 #: dh_installdocs:88
3401 msgid ""
3402 "debhelper will try to avoid installing files into linked documentation "
3403 "directories that would cause conflicts with the linked package. The B<-A> "
3404 "option will have no effect on packages with linked documentation "
3405 "directories, and F<copyright>, F<changelog>, F<README.Debian>, and F<TODO> "
3406 "files will not be installed."
3407 msgstr ""
3408
3409 #. type: textblock
3410 #: dh_installdocs:94
3411 msgid ""
3412 "(An older method to accomplish the same thing, which is still supported, is "
3413 "to make the documentation directory of a package be a dangling symlink, "
3414 "before calling B<dh_installdocs>.)"
3415 msgstr ""
3416
3417 #. type: textblock
3418 #: dh_installdocs:100
3419 msgid ""
3420 "Install these files as documentation into the first package acted on. (Or in "
3421 "all packages if B<-A> is specified)."
3422 msgstr ""
3423
3424 #. type: textblock
3425 #: dh_installdocs:107
3426 msgid "This is an example of a F<debian/package.docs> file:"
3427 msgstr ""
3428
3429 #. type: verbatim
3430 #: dh_installdocs:109
3431 #, no-wrap
3432 msgid ""
3433 "  README\n"
3434 "  TODO\n"
3435 "  debian/notes-for-maintainers.txt\n"
3436 "  docs/manual.txt\n"
3437 "  docs/manual.pdf\n"
3438 "  docs/manual-html/\n"
3439 "\n"
3440 msgstr ""
3441
3442 #. type: textblock
3443 #: dh_installdocs:118
3444 msgid ""
3445 "Note that B<dh_installdocs> will happily copy entire directory hierarchies "
3446 "if you ask it to (similar to B<cp -a>). If it is asked to install a "
3447 "directory, it will install the complete contents of the directory."
3448 msgstr ""
3449
3450 #. type: textblock
3451 #: dh_installemacsen:5
3452 msgid "dh_installemacsen - register an Emacs add on package"
3453 msgstr ""
3454
3455 #. type: textblock
3456 #: dh_installemacsen:14
3457 msgid ""
3458 "B<dh_installemacsen> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] "
3459 "[B<--flavor=>I<foo>]"
3460 msgstr ""
3461
3462 #. type: textblock
3463 #: dh_installemacsen:18
3464 msgid ""
3465 "B<dh_installemacsen> is a debhelper program that is responsible for "
3466 "installing files used by the Debian B<emacsen-common> package into package "
3467 "build directories."
3468 msgstr ""
3469
3470 #. type: textblock
3471 #: dh_installemacsen:22
3472 msgid ""
3473 "It also automatically generates the F<postinst> and F<prerm> commands needed "
3474 "to register a package as an Emacs add on package. The commands are added to "
3475 "the maintainer scripts by B<dh_installdeb>. See L<dh_installdeb(1)> for an "
3476 "explanation of how this works."
3477 msgstr ""
3478
3479 #. type: =item
3480 #: dh_installemacsen:31
3481 msgid "debian/I<package>.emacsen-install"
3482 msgstr ""
3483
3484 #. type: textblock
3485 #: dh_installemacsen:33
3486 msgid ""
3487 "Installed into F<usr/lib/emacsen-common/packages/install/package> in the "
3488 "package build directory."
3489 msgstr ""
3490
3491 #. type: =item
3492 #: dh_installemacsen:36
3493 msgid "debian/I<package>.emacsen-remove"
3494 msgstr ""
3495
3496 #. type: textblock
3497 #: dh_installemacsen:38
3498 msgid ""
3499 "Installed into F<usr/lib/emacsen-common/packages/remove/package> in the "
3500 "package build directory."
3501 msgstr ""
3502
3503 #. type: =item
3504 #: dh_installemacsen:41
3505 msgid "debian/I<package>.emacsen-startup"
3506 msgstr ""
3507
3508 #. type: textblock
3509 #: dh_installemacsen:43
3510 msgid ""
3511 "Installed into etc/emacs/site-start.d/50I<package>.el in the package build "
3512 "directory. Use B<--priority> to use a different priority than 50."
3513 msgstr ""
3514
3515 #. type: textblock
3516 #: dh_installemacsen:54 dh_python:62 dh_usrlocal:45
3517 msgid "Do not modify F<postinst>/F<prerm> scripts."
3518 msgstr ""
3519
3520 #. type: =item
3521 #: dh_installemacsen:56 dh_installwm:38
3522 msgid "B<--priority=>I<n>"
3523 msgstr ""
3524
3525 #. type: textblock
3526 #: dh_installemacsen:58
3527 msgid "Sets the priority number of a F<site-start.d> file. Default is 50."
3528 msgstr ""
3529
3530 #. type: =item
3531 #: dh_installemacsen:60
3532 msgid "B<--flavor=>I<foo>"
3533 msgstr ""
3534
3535 #. type: textblock
3536 #: dh_installemacsen:62
3537 msgid ""
3538 "Sets the flavor a F<site-start.d> file will be installed in. Default is "
3539 "B<emacs>, alternatives include B<xemacs> and B<emacs20>."
3540 msgstr ""
3541
3542 #. type: textblock
3543 #: dh_installexamples:5
3544 msgid "dh_installexamples - install example files into package build directories"
3545 msgstr ""
3546
3547 #. type: textblock
3548 #: dh_installexamples:14
3549 msgid ""
3550 "B<dh_installexamples> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] "
3551 "[S<I<file> ...>]"
3552 msgstr ""
3553
3554 #. type: textblock
3555 #: dh_installexamples:18
3556 msgid ""
3557 "B<dh_installexamples> is a debhelper program that is responsible for "
3558 "installing examples into F<usr/share/doc/package/examples> in package build "
3559 "directories."
3560 msgstr ""
3561
3562 #. type: =item
3563 #: dh_installexamples:26
3564 msgid "debian/I<package>.examples"
3565 msgstr ""
3566
3567 #. type: textblock
3568 #: dh_installexamples:28
3569 msgid "Lists example files or directories to be installed."
3570 msgstr ""
3571
3572 #. type: textblock
3573 #: dh_installexamples:38
3574 msgid ""
3575 "Install any files specified by command line parameters in ALL packages acted "
3576 "on."
3577 msgstr ""
3578
3579 #. type: textblock
3580 #: dh_installexamples:48
3581 msgid ""
3582 "Install these files (or directories) as examples into the first package "
3583 "acted on. (Or into all packages if B<-A> is specified.)"
3584 msgstr ""
3585
3586 #. type: textblock
3587 #: dh_installexamples:55
3588 msgid ""
3589 "Note that B<dh_installexamples> will happily copy entire directory "
3590 "hierarchies if you ask it to (similar to B<cp -a>). If it is asked to "
3591 "install a directory, it will install the complete contents of the directory."
3592 msgstr ""
3593
3594 #. type: textblock
3595 #: dh_installifupdown:5
3596 msgid "dh_installifupdown - install if-up and if-down hooks"
3597 msgstr ""
3598
3599 #. type: textblock
3600 #: dh_installifupdown:14
3601 msgid "B<dh_installifupdown> [S<I<debhelper options>>] [B<--name=>I<name>]"
3602 msgstr ""
3603
3604 #. type: textblock
3605 #: dh_installifupdown:18
3606 msgid ""
3607 "B<dh_installifupdown> is a debhelper program that is responsible for "
3608 "installing F<if-up>, F<if-down>, F<if-pre-up>, and F<if-post-down> hook "
3609 "scripts into package build directories."
3610 msgstr ""
3611
3612 #. type: =item
3613 #: dh_installifupdown:26
3614 msgid "debian/I<package>.if-up"
3615 msgstr ""
3616
3617 #. type: =item
3618 #: dh_installifupdown:28
3619 msgid "debian/I<package>.if-down"
3620 msgstr ""
3621
3622 #. type: =item
3623 #: dh_installifupdown:30
3624 msgid "debian/I<package>.if-pre-up"
3625 msgstr ""
3626
3627 #. type: =item
3628 #: dh_installifupdown:32
3629 msgid "debian/I<package>.if-post-down"
3630 msgstr ""
3631
3632 #. type: textblock
3633 #: dh_installifupdown:34
3634 msgid ""
3635 "These files are installed into etc/network/if-*.d/I<package> in the package "
3636 "build directory."
3637 msgstr ""
3638
3639 #. type: textblock
3640 #: dh_installifupdown:45
3641 msgid ""
3642 "Look for files named F<debian/package.name.if-*> and install them as "
3643 "F<etc/network/if-*/name>, instead of using the usual files and installing "
3644 "them as the package name."
3645 msgstr ""
3646
3647 #. type: textblock
3648 #: dh_installinfo:5
3649 msgid "dh_installinfo - install info files"
3650 msgstr ""
3651
3652 #. type: textblock
3653 #: dh_installinfo:14
3654 msgid "B<dh_installinfo> [S<I<debhelper options>>] [B<-A>] [S<I<file> ...>]"
3655 msgstr ""
3656
3657 #. type: textblock
3658 #: dh_installinfo:18
3659 msgid ""
3660 "B<dh_installinfo> is a debhelper program that is responsible for installing "
3661 "info files into F<usr/share/info> in the package build directory."
3662 msgstr ""
3663
3664 #. type: =item
3665 #: dh_installinfo:25
3666 msgid "debian/I<package>.info"
3667 msgstr ""
3668
3669 #. type: textblock
3670 #: dh_installinfo:27
3671 msgid "List info files to be installed."
3672 msgstr ""
3673
3674 #. type: textblock
3675 #: dh_installinfo:42
3676 msgid ""
3677 "Install these info files into the first package acted on. (Or in all "
3678 "packages if B<-A> is specified)."
3679 msgstr ""
3680
3681 #. type: textblock
3682 #: dh_installinit:5
3683 msgid ""
3684 "dh_installinit - install upstart jobs or init scripts into package build "
3685 "directories"
3686 msgstr ""
3687
3688 #. type: textblock
3689 #: dh_installinit:14
3690 msgid ""
3691 "B<dh_installinit> [S<I<debhelper options>>] [B<--name=>I<name>] [B<-n>] "
3692 "[B<-R>] [B<-r>] [B<-d>] [S<B<--> I<params>>]"
3693 msgstr ""
3694
3695 #. type: textblock
3696 #: dh_installinit:18
3697 msgid ""
3698 "B<dh_installinit> is a debhelper program that is responsible for installing "
3699 "upstart job files or init scripts with associated defaults files into "
3700 "package build directories, and in the former case providing compatibility "
3701 "handling for non-upstart systems."
3702 msgstr ""
3703
3704 #. type: textblock
3705 #: dh_installinit:23
3706 msgid ""
3707 "It also automatically generates the F<postinst> and F<postrm> and F<prerm> "
3708 "commands needed to set up the symlinks in F</etc/rc*.d/> and to start and "
3709 "stop the init scripts."
3710 msgstr ""
3711
3712 #. type: =item
3713 #: dh_installinit:31
3714 msgid "debian/I<package>.upstart"
3715 msgstr ""
3716
3717 #. type: textblock
3718 #: dh_installinit:33
3719 msgid ""
3720 "If this exists, it is installed into etc/init/I<package>.conf in the package "
3721 "build directory."
3722 msgstr ""
3723
3724 #. type: =item
3725 #: dh_installinit:36
3726 msgid "debian/I<package>.init"
3727 msgstr ""
3728
3729 #. type: textblock
3730 #: dh_installinit:38
3731 msgid ""
3732 "Otherwise, if this exists, it is installed into etc/init.d/I<package> in the "
3733 "package build directory."
3734 msgstr ""
3735
3736 #. type: =item
3737 #: dh_installinit:41
3738 msgid "debian/I<package>.default"
3739 msgstr ""
3740
3741 #. type: textblock
3742 #: dh_installinit:43
3743 msgid ""
3744 "If this exists, it is installed into etc/default/I<package> in the package "
3745 "build directory."
3746 msgstr ""
3747
3748 #. type: =item
3749 #: dh_installinit:56
3750 msgid "B<-o>, B<--onlyscripts>"
3751 msgstr ""
3752
3753 #. type: textblock
3754 #: dh_installinit:58
3755 msgid ""
3756 "Only modify F<postinst>/F<postrm>/F<prerm> scripts, do not actually install "
3757 "any init script, default files, or upstart job. May be useful if the init "
3758 "script or upstart job is shipped and/or installed by upstream in a way that "
3759 "doesn't make it easy to let B<dh_installinit> find it."
3760 msgstr ""
3761
3762 #. type: textblock
3763 #: dh_installinit:63
3764 msgid ""
3765 "If no upstart job file is installed in the target directory when "
3766 "B<dh_installinit --onlyscripts> is called, this program will assume that an "
3767 "init script is being installed and not provide the compatibility symlinks or "
3768 "upstart dependencies."
3769 msgstr ""
3770
3771 #. type: =item
3772 #: dh_installinit:68
3773 msgid "B<-R>, B<--restart-after-upgrade>"
3774 msgstr ""
3775
3776 #. type: textblock
3777 #: dh_installinit:70
3778 msgid ""
3779 "Do not stop the init script until after the package upgrade has been "
3780 "completed. This is different than the default behavior, which stops the "
3781 "script in the F<prerm>, and starts it again in the F<postinst>."
3782 msgstr ""
3783
3784 #. type: textblock
3785 #: dh_installinit:74
3786 msgid ""
3787 "This can be useful for daemons that should not have a possibly long downtime "
3788 "during upgrade. But you should make sure that the daemon will not get "
3789 "confused by the package being upgraded while it's running before using this "
3790 "option."
3791 msgstr ""
3792
3793 #. type: =item
3794 #: dh_installinit:79
3795 msgid "B<-r>, B<--no-restart-on-upgrade>"
3796 msgstr ""
3797
3798 #. type: textblock
3799 #: dh_installinit:81
3800 msgid "Do not stop init script on upgrade."
3801 msgstr ""
3802
3803 #. type: =item
3804 #: dh_installinit:83
3805 msgid "B<--no-start>"
3806 msgstr ""
3807
3808 #. type: textblock
3809 #: dh_installinit:85
3810 msgid ""
3811 "Do not start the init script on install or upgrade, or stop it on removal.  "
3812 "Only call B<update-rc.d>. Useful for rcS scripts."
3813 msgstr ""
3814
3815 #. type: =item
3816 #: dh_installinit:88
3817 msgid "B<-d>, B<--remove-d>"
3818 msgstr ""
3819
3820 #. type: textblock
3821 #: dh_installinit:90
3822 msgid ""
3823 "Remove trailing B<d> from the name of the package, and use the result for "
3824 "the filename the upstart job file is installed as in F<etc/init/> , or for "
3825 "the filename the init script is installed as in etc/init.d and the default "
3826 "file is installed as in F<etc/default/> . This may be useful for daemons "
3827 "with names ending in B<d>. (Note: this takes precedence over the "
3828 "B<--init-script> parameter described below.)"
3829 msgstr ""
3830
3831 #. type: =item
3832 #: dh_installinit:97
3833 msgid "B<-u>I<params> B<--update-rcd-params=>I<params>"
3834 msgstr ""
3835
3836 #. type: textblock
3837 #: dh_installinit:101
3838 msgid ""
3839 "Pass I<params> to L<update-rc.d(8)>. If not specified, B<defaults> will be "
3840 "passed to L<update-rc.d(8)>."
3841 msgstr ""
3842
3843 #. type: textblock
3844 #: dh_installinit:106
3845 msgid ""
3846 "Install the upstart job file or the init script (and default file) using the "
3847 "filename I<name> instead of the default filename, which is the package "
3848 "name.  When this parameter is used, B<dh_installinit> looks for and installs "
3849 "files named F<debian/package.name.upstart>, F<debian/package.name.init> and "
3850 "F<debian/package.name.default>, instead of the usual "
3851 "F<debian/package.upstart>, F<debian/package.init> and "
3852 "F<debian/package.default>."
3853 msgstr ""
3854
3855 #. type: =item
3856 #: dh_installinit:113
3857 msgid "B<--init-script=>I<scriptname>"
3858 msgstr ""
3859
3860 #. type: textblock
3861 #: dh_installinit:115
3862 msgid ""
3863 "Use I<scriptname> as the filename the init script is installed as in "
3864 "F<etc/init.d/> (and also use it as the filename for the defaults file, if it "
3865 "is installed). If you use this parameter, B<dh_installinit> will look to see "
3866 "if a file in the F<debian/> directory exists that looks like "
3867 "F<package.scriptname> and if so will install it as the init script in "
3868 "preference to the files it normally installs."
3869 msgstr ""
3870
3871 #. type: textblock
3872 #: dh_installinit:122
3873 msgid ""
3874 "This parameter is deprecated, use the B<--name> parameter instead. This "
3875 "parameter will be ignored completely for upstart jobs."
3876 msgstr ""
3877
3878 #. type: =item
3879 #: dh_installinit:125
3880 msgid "B<--error-handler=>I<function>"
3881 msgstr ""
3882
3883 #. type: textblock
3884 #: dh_installinit:127
3885 msgid ""
3886 "Call the named shell I<function> if running the init script fails. The "
3887 "function should be provided in the F<prerm> and F<postinst> scripts, before "
3888 "the B<#DEBHELPER#> token."
3889 msgstr ""
3890
3891 #. type: =head1
3892 #: dh_installinit:281
3893 msgid "AUTHORS"
3894 msgstr ""
3895
3896 #. type: textblock
3897 #: dh_installinit:285
3898 msgid "Steve Langasek <steve.langasek@canonical.com>"
3899 msgstr ""
3900
3901 #. type: textblock
3902 #: dh_installlogcheck:5
3903 msgid "dh_installlogcheck - install logcheck rulefiles into etc/logcheck/"
3904 msgstr ""
3905
3906 #. type: textblock
3907 #: dh_installlogcheck:14
3908 msgid "B<dh_installlogcheck> [S<I<debhelper options>>]"
3909 msgstr ""
3910
3911 #. type: textblock
3912 #: dh_installlogcheck:18
3913 msgid ""
3914 "B<dh_installlogcheck> is a debhelper program that is responsible for "
3915 "installing logcheck rule files."
3916 msgstr ""
3917
3918 #. type: =item
3919 #: dh_installlogcheck:25
3920 msgid "debian/I<package>.logcheck.cracking"
3921 msgstr ""
3922
3923 #. type: =item
3924 #: dh_installlogcheck:27
3925 msgid "debian/I<package>.logcheck.violations"
3926 msgstr ""
3927
3928 #. type: =item
3929 #: dh_installlogcheck:29
3930 msgid "debian/I<package>.logcheck.violations.ignore"
3931 msgstr ""
3932
3933 #. type: =item
3934 #: dh_installlogcheck:31
3935 msgid "debian/I<package>.logcheck.ignore.workstation"
3936 msgstr ""
3937
3938 #. type: =item
3939 #: dh_installlogcheck:33
3940 msgid "debian/I<package>.logcheck.ignore.server"
3941 msgstr ""
3942
3943 #. type: =item
3944 #: dh_installlogcheck:35
3945 msgid "debian/I<package>.logcheck.ignore.paranoid"
3946 msgstr ""
3947
3948 #. type: textblock
3949 #: dh_installlogcheck:37
3950 msgid ""
3951 "Each of these files, if present, are installed into corresponding "
3952 "subdirectories of F<etc/logcheck/> in package build directories."
3953 msgstr ""
3954
3955 #. type: textblock
3956 #: dh_installlogcheck:48
3957 msgid ""
3958 "Look for files named F<debian/package.name.logcheck.*> and install them into "
3959 "the corresponding subdirectories of F<etc/logcheck/>, but use the specified "
3960 "name instead of that of the package."
3961 msgstr ""
3962
3963 #. type: verbatim
3964 #: dh_installlogcheck:82
3965 #, no-wrap
3966 msgid ""
3967 "This program is a part of debhelper.\n"
3968 "    \n"
3969 msgstr ""
3970
3971 #. type: textblock
3972 #: dh_installlogcheck:86
3973 msgid "Jon Middleton <jjm@debian.org>"
3974 msgstr ""
3975
3976 #. type: textblock
3977 #: dh_installlogrotate:5
3978 msgid "dh_installlogrotate - install logrotate config files"
3979 msgstr ""
3980
3981 #. type: textblock
3982 #: dh_installlogrotate:14
3983 msgid "B<dh_installlogrotate> [S<I<debhelper options>>] [B<--name=>I<name>]"
3984 msgstr ""
3985
3986 #. type: textblock
3987 #: dh_installlogrotate:18
3988 msgid ""
3989 "B<dh_installlogrotate> is a debhelper program that is responsible for "
3990 "installing logrotate config files into F<etc/logrotate.d> in package build "
3991 "directories.  Files named F<debian/package.logrotate> are installed."
3992 msgstr ""
3993
3994 #. type: textblock
3995 #: dh_installlogrotate:28
3996 msgid ""
3997 "Look for files named F<debian/package.name.logrotate> and install them as "
3998 "F<etc/logrotate.d/name>, instead of using the usual files and installing "
3999 "them as the package name."
4000 msgstr ""
4001
4002 #. type: textblock
4003 #: dh_installman:5
4004 msgid "dh_installman - install man pages into package build directories"
4005 msgstr ""
4006
4007 #. type: textblock
4008 #: dh_installman:15
4009 msgid "B<dh_installman> [S<I<debhelper options>>] [S<I<manpage> ...>]"
4010 msgstr ""
4011
4012 #. type: textblock
4013 #: dh_installman:19
4014 msgid ""
4015 "B<dh_installman> is a debhelper program that handles installing man pages "
4016 "into the correct locations in package build directories. You tell it what "
4017 "man pages go in your packages, and it figures out where to install them "
4018 "based on the section field in their B<.TH> line. If you have a properly "
4019 "formatted B<.TH> line, your man page will be installed into the right "
4020 "directory, with the right name (this includes proper handling of pages with "
4021 "a subsection, like B<3perl>, which are placed in F<man3>, and given an "
4022 "extension of F<.3perl>). If your B<.TH> line is incorrect or missing, the "
4023 "program may guess wrong based on the file extension."
4024 msgstr ""
4025
4026 #. type: textblock
4027 #: dh_installman:29
4028 msgid ""
4029 "It also supports translated man pages, by looking for extensions like "
4030 "F<.ll.8> and F<.ll_LL.8>, or by use of the B<--language> switch."
4031 msgstr ""
4032
4033 #. type: textblock
4034 #: dh_installman:32
4035 msgid ""
4036 "If B<dh_installman> seems to install a man page into the wrong section or "
4037 "with the wrong extension, this is because the man page has the wrong section "
4038 "listed in its B<.TH> line. Edit the man page and correct the section, and "
4039 "B<dh_installman> will follow suit. See L<man(7)> for details about the "
4040 "B<.TH> section. If B<dh_installman> seems to install a man page into a "
4041 "directory like F</usr/share/man/pl/man1/>, that is because your program has "
4042 "a name like F<foo.pl>, and B<dh_installman> assumes that means it is "
4043 "translated into Polish. Use B<--language=C> to avoid this."
4044 msgstr ""
4045
4046 #. type: textblock
4047 #: dh_installman:41
4048 msgid ""
4049 "After the man page installation step, B<dh_installman> will check to see if "
4050 "any of the man pages in the temporary directories of any of the packages it "
4051 "is acting on contain F<.so> links. If so, it changes them to symlinks."
4052 msgstr ""
4053
4054 #. type: textblock
4055 #: dh_installman:45
4056 msgid ""
4057 "Also, B<dh_installman> will use man to guess the character encoding of each "
4058 "manual page and convert it to UTF-8. If the guesswork fails for some reason, "
4059 "you can override it using an encoding declaration. See L<manconv(1)> for "
4060 "details."
4061 msgstr ""
4062
4063 #. type: =item
4064 #: dh_installman:54
4065 msgid "debian/I<package>.manpages"
4066 msgstr ""
4067
4068 #. type: textblock
4069 #: dh_installman:56
4070 msgid "Lists man pages to be installed."
4071 msgstr ""
4072
4073 #. type: =item
4074 #: dh_installman:69
4075 msgid "B<--language=>I<ll>"
4076 msgstr ""
4077
4078 #. type: textblock
4079 #: dh_installman:71
4080 msgid ""
4081 "Use this to specify that the man pages being acted on are written in the "
4082 "specified language."
4083 msgstr ""
4084
4085 #. type: =item
4086 #: dh_installman:74
4087 msgid "I<manpage> ..."
4088 msgstr ""
4089
4090 #. type: textblock
4091 #: dh_installman:76
4092 msgid ""
4093 "Install these man pages into the first package acted on. (Or in all packages "
4094 "if B<-A> is specified)."
4095 msgstr ""
4096
4097 #. type: textblock
4098 #: dh_installman:83
4099 msgid ""
4100 "An older version of this program, L<dh_installmanpages(1)>, is still used by "
4101 "some packages, and so is still included in debhelper.  It is, however, "
4102 "deprecated, due to its counterintuitive and inconsistent interface. Use this "
4103 "program instead."
4104 msgstr ""
4105
4106 #. type: textblock
4107 #: dh_installmanpages:5
4108 msgid "dh_installmanpages - old-style man page installer (deprecated)"
4109 msgstr ""
4110
4111 #. type: textblock
4112 #: dh_installmanpages:15
4113 msgid "B<dh_installmanpages> [S<I<debhelper options>>] [S<I<file> ...>]"
4114 msgstr ""
4115
4116 #. type: textblock
4117 #: dh_installmanpages:19
4118 msgid ""
4119 "B<dh_installmanpages> is a debhelper program that is responsible for "
4120 "automatically installing man pages into F<usr/share/man/> in package build "
4121 "directories."
4122 msgstr ""
4123
4124 #. type: textblock
4125 #: dh_installmanpages:23
4126 msgid ""
4127 "This is a DWIM-style program, with an interface unlike the rest of "
4128 "debhelper. It is deprecated, and you are encouraged to use "
4129 "L<dh_installman(1)> instead."
4130 msgstr ""
4131
4132 #. type: textblock
4133 #: dh_installmanpages:27
4134 msgid ""
4135 "B<dh_installmanpages> scans the current directory and all subdirectories for "
4136 "filenames that look like man pages. (Note that only real files are looked "
4137 "at; symlinks are ignored.) It uses L<file(1)> to verify that the files are "
4138 "in the correct format. Then, based on the files' extensions, it installs "
4139 "them into the correct man directory."
4140 msgstr ""
4141
4142 #. type: textblock
4143 #: dh_installmanpages:33
4144 msgid ""
4145 "All filenames specified as parameters will be skipped by "
4146 "B<dh_installmanpages>.  This is useful if by default it installs some man "
4147 "pages that you do not want to be installed."
4148 msgstr ""
4149
4150 #. type: textblock
4151 #: dh_installmanpages:37
4152 msgid ""
4153 "After the man page installation step, B<dh_installmanpages> will check to "
4154 "see if any of the man pages are F<.so> links. If so, it changes them to "
4155 "symlinks."
4156 msgstr ""
4157
4158 #. type: textblock
4159 #: dh_installmanpages:46
4160 msgid ""
4161 "Do not install these files as man pages, even if they look like valid man "
4162 "pages."
4163 msgstr ""
4164
4165 #. type: =head1
4166 #: dh_installmanpages:51
4167 msgid "BUGS"
4168 msgstr ""
4169
4170 #. type: textblock
4171 #: dh_installmanpages:53
4172 msgid ""
4173 "B<dh_installmanpages> will install the man pages it finds into B<all> "
4174 "packages you tell it to act on, since it can't tell what package the man "
4175 "pages belong in. This is almost never what you really want (use B<-p> to "
4176 "work around this, or use the much better L<dh_installman(1)> program "
4177 "instead)."
4178 msgstr ""
4179
4180 #. type: textblock
4181 #: dh_installmanpages:58
4182 msgid "Files ending in F<.man> will be ignored."
4183 msgstr ""
4184
4185 #. type: textblock
4186 #: dh_installmanpages:60
4187 msgid ""
4188 "Files specified as parameters that contain spaces in their filenames will "
4189 "not be processed properly."
4190 msgstr ""
4191
4192 #. type: textblock
4193 #: dh_installmenu:5
4194 msgid "dh_installmenu - install Debian menu files into package build directories"
4195 msgstr ""
4196
4197 #. type: textblock
4198 #: dh_installmenu:14
4199 msgid "B<dh_installmenu> [S<B<debhelper options>>] [B<-n>]"
4200 msgstr ""
4201
4202 #. type: textblock
4203 #: dh_installmenu:18
4204 msgid ""
4205 "B<dh_installmenu> is a debhelper program that is responsible for installing "
4206 "files used by the Debian B<menu> package into package build directories."
4207 msgstr ""
4208
4209 #. type: textblock
4210 #: dh_installmenu:21
4211 msgid ""
4212 "It also automatically generates the F<postinst> and F<postrm> commands "
4213 "needed to interface with the Debian B<menu> package. These commands are "
4214 "inserted into the maintainer scripts by L<dh_installdeb(1)>."
4215 msgstr ""
4216
4217 #. type: =item
4218 #: dh_installmenu:29
4219 msgid "debian/I<package>.menu"
4220 msgstr ""
4221
4222 #. type: textblock
4223 #: dh_installmenu:31
4224 msgid ""
4225 "Debian menu files, installed into usr/share/menu/I<package> in the package "
4226 "build directory. See L<menufile(5)> for its format."
4227 msgstr ""
4228
4229 #. type: =item
4230 #: dh_installmenu:34
4231 msgid "debian/I<package>.menu-method"
4232 msgstr ""
4233
4234 #. type: textblock
4235 #: dh_installmenu:36
4236 msgid ""
4237 "Debian menu method files, installed into etc/menu-methods/I<package> in the "
4238 "package build directory."
4239 msgstr ""
4240
4241 #. type: textblock
4242 #: dh_installmenu:47 dh_installmime:47 dh_makeshlibs:79
4243 msgid "Do not modify F<postinst>/F<postrm> scripts."
4244 msgstr ""
4245
4246 #. type: textblock
4247 #: dh_installmenu:89
4248 msgid "L<debhelper(7)> L<update-menus(1)> L<menufile(5)>"
4249 msgstr ""
4250
4251 #. type: textblock
4252 #: dh_installmime:5
4253 msgid "dh_installmime - install mime files into package build directories"
4254 msgstr ""
4255
4256 #. type: textblock
4257 #: dh_installmime:14
4258 msgid "B<dh_installmime> [S<I<debhelper options>>] [B<-n>]"
4259 msgstr ""
4260
4261 #. type: textblock
4262 #: dh_installmime:18
4263 msgid ""
4264 "B<dh_installmime> is a debhelper program that is responsible for installing "
4265 "mime files into package build directories."
4266 msgstr ""
4267
4268 #. type: textblock
4269 #: dh_installmime:21
4270 msgid ""
4271 "It also automatically generates the F<postinst> and F<postrm> commands "
4272 "needed to interface with the debian B<mime-support> and B<shared-mime-info> "
4273 "packages. These commands are inserted into the maintainer scripts by "
4274 "L<dh_installdeb(1)>."
4275 msgstr ""
4276
4277 #. type: =item
4278 #: dh_installmime:29
4279 msgid "debian/I<package>.mime"
4280 msgstr ""
4281
4282 #. type: textblock
4283 #: dh_installmime:31
4284 msgid ""
4285 "Installed into usr/lib/mime/packages/I<package> in the package build "
4286 "directory."
4287 msgstr ""
4288
4289 #. type: =item
4290 #: dh_installmime:34
4291 msgid "debian/I<package>.sharedmimeinfo"
4292 msgstr ""
4293
4294 #. type: textblock
4295 #: dh_installmime:36
4296 msgid ""
4297 "Installed into /usr/share/mime/packages/I<package>.xml in the package build "
4298 "directory."
4299 msgstr ""
4300
4301 #. type: textblock
4302 #: dh_installmodules:5
4303 msgid "dh_installmodules - register modules with modutils"
4304 msgstr ""
4305
4306 #. type: textblock
4307 #: dh_installmodules:16
4308 msgid "B<dh_installmodules> [S<I<debhelper options>>] [B<-n>] [B<--name=>I<name>]"
4309 msgstr ""
4310
4311 #. type: textblock
4312 #: dh_installmodules:20
4313 msgid ""
4314 "B<dh_installmodules> is a debhelper program that is responsible for "
4315 "registering kernel modules."
4316 msgstr ""
4317
4318 #. type: textblock
4319 #: dh_installmodules:23
4320 msgid ""
4321 "Kernel modules are searched for in the package build directory and if found, "
4322 "F<preinst>, F<postinst> and F<postrm> commands are automatically generated "
4323 "to run B<depmod> and register the modules when the package is installed.  "
4324 "These commands are inserted into the maintainer scripts by "
4325 "L<dh_installdeb(1)>."
4326 msgstr ""
4327
4328 #. type: =item
4329 #: dh_installmodules:33
4330 msgid "debian/I<package>.modprobe"
4331 msgstr ""
4332
4333 #. type: textblock
4334 #: dh_installmodules:35
4335 msgid "Installed to etc/modprobe.d/I<package>.conf in the package build directory."
4336 msgstr ""
4337
4338 #. type: =item
4339 #: dh_installmodules:37
4340 msgid "debian/I<package>.modules"
4341 msgstr ""
4342
4343 #. type: textblock
4344 #: dh_installmodules:39
4345 msgid ""
4346 "These files were installed for use by modutils, but are now not used and "
4347 "B<dh_installmodules> will warn if these files are present."
4348 msgstr ""
4349
4350 #. type: textblock
4351 #: dh_installmodules:50
4352 msgid "Do not modify F<preinst>/F<postinst>/F<postrm> scripts."
4353 msgstr ""
4354
4355 #. type: textblock
4356 #: dh_installmodules:54
4357 msgid ""
4358 "When this parameter is used, B<dh_installmodules> looks for and installs "
4359 "files named debian/I<package>.I<name>.modprobe instead of the usual "
4360 "debian/I<package>.modprobe"
4361 msgstr ""
4362
4363 #. type: textblock
4364 #: dh_installpam:5
4365 msgid "dh_installpam - install pam support files"
4366 msgstr ""
4367
4368 #. type: textblock
4369 #: dh_installpam:14
4370 msgid "B<dh_installpam> [S<I<debhelper options>>] [B<--name=>I<name>]"
4371 msgstr ""
4372
4373 #. type: textblock
4374 #: dh_installpam:18
4375 msgid ""
4376 "B<dh_installpam> is a debhelper program that is responsible for installing "
4377 "files used by PAM into package build directories."
4378 msgstr ""
4379
4380 #. type: =item
4381 #: dh_installpam:25
4382 msgid "debian/I<package>.pam"
4383 msgstr ""
4384
4385 #. type: textblock
4386 #: dh_installpam:27
4387 msgid "Installed into etc/pam.d/I<package> in the package build directory."
4388 msgstr ""
4389
4390 #. type: textblock
4391 #: dh_installpam:37
4392 msgid ""
4393 "Look for files named debian/I<package>.I<name>.pam and install them as "
4394 "etc/pam.d/I<name>, instead of using the usual files and installing them "
4395 "using the package name."
4396 msgstr ""
4397
4398 #. type: textblock
4399 #: dh_installppp:5
4400 msgid "dh_installppp - install ppp ip-up and ip-down files"
4401 msgstr ""
4402
4403 #. type: textblock
4404 #: dh_installppp:14
4405 msgid "B<dh_installppp> [S<I<debhelper options>>] [B<--name=>I<name>]"
4406 msgstr ""
4407
4408 #. type: textblock
4409 #: dh_installppp:18
4410 msgid ""
4411 "B<dh_installppp> is a debhelper program that is responsible for installing "
4412 "ppp ip-up and ip-down scripts into package build directories."
4413 msgstr ""
4414
4415 #. type: =item
4416 #: dh_installppp:25
4417 msgid "debian/I<package>.ppp.ip-up"
4418 msgstr ""
4419
4420 #. type: textblock
4421 #: dh_installppp:27
4422 msgid "Installed into etc/ppp/ip-up.d/I<package> in the package build directory."
4423 msgstr ""
4424
4425 #. type: =item
4426 #: dh_installppp:29
4427 msgid "debian/I<package>.ppp.ip-down"
4428 msgstr ""
4429
4430 #. type: textblock
4431 #: dh_installppp:31
4432 msgid "Installed into etc/ppp/ip-down.d/I<package> in the package build directory."
4433 msgstr ""
4434
4435 #. type: textblock
4436 #: dh_installppp:41
4437 msgid ""
4438 "Look for files named F<debian/package.name.ppp.ip-*> and install them as "
4439 "F<etc/ppp/ip-*/name>, instead of using the usual files and installing them "
4440 "as the package name."
4441 msgstr ""
4442
4443 #. type: textblock
4444 #: dh_installudev:5
4445 msgid "dh_installudev - install udev rules files"
4446 msgstr ""
4447
4448 #. type: textblock
4449 #: dh_installudev:15
4450 msgid ""
4451 "B<dh_installudev> [S<I<debhelper options>>] [B<-n>] [B<--name=>I<name>] "
4452 "[B<--priority=>I<priority>]"
4453 msgstr ""
4454
4455 #. type: textblock
4456 #: dh_installudev:19
4457 msgid ""
4458 "B<dh_installudev> is a debhelper program that is responsible for installing "
4459 "B<udev> rules files."
4460 msgstr ""
4461
4462 #. type: textblock
4463 #: dh_installudev:22
4464 msgid ""
4465 "Code is added to the F<preinst> and F<postinst> to handle the upgrade from "
4466 "the old B<udev> rules file location."
4467 msgstr ""
4468
4469 #. type: =item
4470 #: dh_installudev:29
4471 msgid "debian/I<package>.udev"
4472 msgstr ""
4473
4474 #. type: textblock
4475 #: dh_installudev:31
4476 msgid "Installed into F<lib/udev/rules.d/> in the package build directory."
4477 msgstr ""
4478
4479 #. type: textblock
4480 #: dh_installudev:41
4481 msgid ""
4482 "When this parameter is used, B<dh_installudev> looks for and installs files "
4483 "named debian/I<package>.I<name>.udev instead of the usual "
4484 "debian/I<package>.udev."
4485 msgstr ""
4486
4487 #. type: =item
4488 #: dh_installudev:45
4489 msgid "B<--priority=>I<priority>"
4490 msgstr ""
4491
4492 #. type: textblock
4493 #: dh_installudev:47
4494 msgid "Sets the priority string of the F<rules.d> symlink. Default is 60."
4495 msgstr ""
4496
4497 #. type: textblock
4498 #: dh_installudev:51
4499 msgid "Do not modify F<preinst>/F<postinst> scripts."
4500 msgstr ""
4501
4502 #. type: textblock
4503 #: dh_installwm:5
4504 msgid "dh_installwm - register a window manager"
4505 msgstr ""
4506
4507 #. type: textblock
4508 #: dh_installwm:14
4509 msgid ""
4510 "B<dh_installwm> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] "
4511 "[S<I<wm> ...>]"
4512 msgstr ""
4513
4514 #. type: textblock
4515 #: dh_installwm:18
4516 msgid ""
4517 "B<dh_installwm> is a debhelper program that is responsible for generating "
4518 "the F<postinst> and F<prerm> commands that register a window manager with "
4519 "L<update-alternatives(8)>. The window manager's man page is also registered "
4520 "as a slave symlink (in v6 mode and up), if it is found in "
4521 "F<usr/share/man/man1/> in the package build directory."
4522 msgstr ""
4523
4524 #. type: =item
4525 #: dh_installwm:28
4526 msgid "debian/I<package>.wm"
4527 msgstr ""
4528
4529 #. type: textblock
4530 #: dh_installwm:30
4531 msgid "List window manager programs to register."
4532 msgstr ""
4533
4534 #. type: textblock
4535 #: dh_installwm:40
4536 msgid ""
4537 "Set the priority of the window manager. Default is 20, which is too low for "
4538 "most window managers; see the Debian Policy document for instructions on "
4539 "calculating the correct value."
4540 msgstr ""
4541
4542 #. type: textblock
4543 #: dh_installwm:46
4544 msgid "Do not modify F<postinst>/F<prerm> scripts. Turns this command into a no-op."
4545 msgstr ""
4546
4547 #. type: =item
4548 #: dh_installwm:48
4549 msgid "I<wm> ..."
4550 msgstr ""
4551
4552 #. type: textblock
4553 #: dh_installwm:50
4554 msgid "Window manager programs to register."
4555 msgstr ""
4556
4557 #. type: textblock
4558 #: dh_installxfonts:5
4559 msgid "dh_installxfonts - register X fonts"
4560 msgstr ""
4561
4562 #. type: textblock
4563 #: dh_installxfonts:14
4564 msgid "B<dh_installxfonts> [S<I<debhelper options>>]"
4565 msgstr ""
4566
4567 #. type: textblock
4568 #: dh_installxfonts:18
4569 msgid ""
4570 "B<dh_installxfonts> is a debhelper program that is responsible for "
4571 "registering X fonts, so their corresponding F<fonts.dir>, F<fonts.alias>, "
4572 "and F<fonts.scale> be rebuilt properly at install time."
4573 msgstr ""
4574
4575 #. type: textblock
4576 #: dh_installxfonts:22
4577 msgid ""
4578 "Before calling this program, you should have installed any X fonts provided "
4579 "by your package into the appropriate location in the package build "
4580 "directory, and if you have F<fonts.alias> or F<fonts.scale> files, you "
4581 "should install them into the correct location under F<etc/X11/fonts> in your "
4582 "package build directory."
4583 msgstr ""
4584
4585 #. type: textblock
4586 #: dh_installxfonts:28
4587 msgid ""
4588 "Your package should depend on B<xfonts-utils> so that the "
4589 "B<update-fonts->I<*> commands are available. (This program adds that "
4590 "dependency to B<${misc:Depends}>.)"
4591 msgstr ""
4592
4593 #. type: textblock
4594 #: dh_installxfonts:32
4595 msgid ""
4596 "This program automatically generates the F<postinst> and F<postrm> commands "
4597 "needed to register X fonts. These commands are inserted into the maintainer "
4598 "scripts by B<dh_installdeb>. See L<dh_installdeb(1)> for an explanation of "
4599 "how this works."
4600 msgstr ""
4601
4602 #. type: textblock
4603 #: dh_installxfonts:39
4604 msgid ""
4605 "See L<update-fonts-alias(8)>, L<update-fonts-scale(8)>, and "
4606 "L<update-fonts-dir(8)> for more information about X font installation."
4607 msgstr ""
4608
4609 #. type: textblock
4610 #: dh_installxfonts:42
4611 msgid ""
4612 "See Debian policy, section 11.8.5. for details about doing fonts the Debian "
4613 "way."
4614 msgstr ""
4615
4616 #. type: textblock
4617 #: dh_link:5
4618 msgid "dh_link - create symlinks in package build directories"
4619 msgstr ""
4620
4621 #. type: textblock
4622 #: dh_link:15
4623 msgid ""
4624 "B<dh_link> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] [S<I<source "
4625 "destination> ...>]"
4626 msgstr ""
4627
4628 #. type: textblock
4629 #: dh_link:19
4630 msgid ""
4631 "B<dh_link> is a debhelper program that creates symlinks in package build "
4632 "directories."
4633 msgstr ""
4634
4635 #. type: textblock
4636 #: dh_link:22
4637 msgid ""
4638 "B<dh_link> accepts a list of pairs of source and destination files. The "
4639 "source files are the already existing files that will be symlinked from. The "
4640 "destination files are the symlinks that will be created. There B<must> be an "
4641 "equal number of source and destination files specified."
4642 msgstr ""
4643
4644 #. type: textblock
4645 #: dh_link:27
4646 msgid ""
4647 "Be sure you B<do> specify the full filename to both the source and "
4648 "destination files (unlike you would do if you were using something like "
4649 "L<ln(1)>)."
4650 msgstr ""
4651
4652 #. type: textblock
4653 #: dh_link:31
4654 msgid ""
4655 "B<dh_link> will generate symlinks that comply with Debian policy - absolute "
4656 "when policy says they should be absolute, and relative links with as short a "
4657 "path as possible. It will also create any subdirectories it needs to to put "
4658 "the symlinks in."
4659 msgstr ""
4660
4661 #. type: textblock
4662 #: dh_link:36
4663 msgid ""
4664 "B<dh_link> also scans the package build tree for existing symlinks which do "
4665 "not conform to Debian policy, and corrects them (v4 or later)."
4666 msgstr ""
4667
4668 #. type: =item
4669 #: dh_link:43
4670 msgid "debian/I<package>.links"
4671 msgstr ""
4672
4673 #. type: textblock
4674 #: dh_link:45
4675 msgid ""
4676 "Lists pairs of source and destination files to be symlinked. Each pair "
4677 "should be put on its own line, with the source and destination separated by "
4678 "whitespace."
4679 msgstr ""
4680
4681 #. type: textblock
4682 #: dh_link:57
4683 msgid ""
4684 "Create any links specified by command line parameters in ALL packages acted "
4685 "on, not just the first."
4686 msgstr ""
4687
4688 #. type: textblock
4689 #: dh_link:62
4690 msgid ""
4691 "Exclude symlinks that contain I<item> anywhere in their filename from being "
4692 "corrected to comply with Debian policy."
4693 msgstr ""
4694
4695 #. type: =item
4696 #: dh_link:65
4697 msgid "I<source destination> ..."
4698 msgstr ""
4699
4700 #. type: textblock
4701 #: dh_link:67
4702 msgid ""
4703 "Create a file named I<destination> as a link to a file named I<source>. Do "
4704 "this in the package build directory of the first package acted on.  (Or in "
4705 "all packages if B<-A> is specified.)"
4706 msgstr ""
4707
4708 #. type: verbatim
4709 #: dh_link:75
4710 #, no-wrap
4711 msgid ""
4712 " dh_link usr/share/man/man1/foo.1 usr/share/man/man1/bar.1\n"
4713 "\n"
4714 msgstr ""
4715
4716 #. type: textblock
4717 #: dh_link:77
4718 msgid "Make F<bar.1> be a symlink to F<foo.1>"
4719 msgstr ""
4720
4721 #. type: verbatim
4722 #: dh_link:79
4723 #, no-wrap
4724 msgid ""
4725 " dh_link var/lib/foo usr/lib/foo \\\n"
4726 "   usr/share/man/man1/foo.1 usr/share/man/man1/bar.1\n"
4727 "\n"
4728 msgstr ""
4729
4730 #. type: textblock
4731 #: dh_link:82
4732 msgid ""
4733 "Make F</usr/lib/foo/> be a link to F</var/lib/foo/>, and F<bar.1> be a "
4734 "symlink to the F<foo.1>"
4735 msgstr ""
4736
4737 #. type: textblock
4738 #: dh_lintian:5
4739 msgid "dh_lintian - install lintian override files into package build directories"
4740 msgstr ""
4741
4742 #. type: textblock
4743 #: dh_lintian:14
4744 msgid "B<dh_lintian> [S<I<debhelper options>>]"
4745 msgstr ""
4746
4747 #. type: textblock
4748 #: dh_lintian:18
4749 msgid ""
4750 "B<dh_lintian> is a debhelper program that is responsible for installing "
4751 "override files used by lintian into package build directories."
4752 msgstr ""
4753
4754 #. type: =item
4755 #: dh_lintian:25
4756 msgid "debian/I<package>.lintian-overrides"
4757 msgstr ""
4758
4759 #. type: textblock
4760 #: dh_lintian:27
4761 msgid ""
4762 "Installed into usr/share/lintian/overrides/I<package> in the package build "
4763 "directory. This file is used to suppress erroneous lintian diagnostics."
4764 msgstr ""
4765
4766 #. type: =item
4767 #: dh_lintian:31
4768 msgid "F<debian/source.lintian-overrides>"
4769 msgstr ""
4770
4771 #. type: textblock
4772 #: dh_lintian:33
4773 msgid ""
4774 "These files are not installed, but will be scanned by lintian to provide "
4775 "overrides for the source package."
4776 msgstr ""
4777
4778 #. type: textblock
4779 #: dh_lintian:63
4780 msgid "L<lintian(1)>"
4781 msgstr ""
4782
4783 #. type: textblock
4784 #: dh_lintian:67
4785 msgid "Steve Robbins <smr@debian.org>"
4786 msgstr ""
4787
4788 #. type: textblock
4789 #: dh_listpackages:5
4790 msgid "dh_listpackages - list binary packages debhelper will act on"
4791 msgstr ""
4792
4793 #. type: textblock
4794 #: dh_listpackages:14
4795 msgid "B<dh_listpackages> [S<I<debhelper options>>]"
4796 msgstr ""
4797
4798 #. type: textblock
4799 #: dh_listpackages:18
4800 msgid ""
4801 "B<dh_listpackages> is a debhelper program that outputs a list of all binary "
4802 "packages debhelper commands will act on. If you pass it some options, it "
4803 "will change the list to match the packages other debhelper commands would "
4804 "act on if passed the same options."
4805 msgstr ""
4806
4807 #. type: textblock
4808 #: dh_makeshlibs:5
4809 msgid "dh_makeshlibs - automatically create shlibs file and call dpkg-gensymbols"
4810 msgstr ""
4811
4812 #. type: textblock
4813 #: dh_makeshlibs:14
4814 msgid ""
4815 "B<dh_makeshlibs> [S<I<debhelper options>>] [B<-m>I<major>] "
4816 "[B<-V>I<[dependencies]>] [B<-n>] [B<-X>I<item>] [S<B<--> I<params>>]"
4817 msgstr ""
4818
4819 #. type: textblock
4820 #: dh_makeshlibs:18
4821 msgid ""
4822 "B<dh_makeshlibs> is a debhelper program that automatically scans for shared "
4823 "libraries, and generates a shlibs file for the libraries it finds."
4824 msgstr ""
4825
4826 #. type: textblock
4827 #: dh_makeshlibs:21
4828 msgid ""
4829 "It also adds a call to ldconfig in the F<postinst> and F<postrm> scripts (in "
4830 "v3 mode and above only) to any packages in which it finds shared libraries."
4831 msgstr ""
4832
4833 #. type: textblock
4834 #: dh_makeshlibs:24
4835 msgid ""
4836 "Packages that support multiarch are detected, and a Pre-Dependency on "
4837 "multiarch-support is set in ${misc:Pre-Depends} ; you should make sure to "
4838 "put that token into an appropriate place in your debian/control file for "
4839 "packages supporting multiarch."
4840 msgstr ""
4841
4842 #. type: =item
4843 #: dh_makeshlibs:33
4844 msgid "debian/I<package>.symbols"
4845 msgstr ""
4846
4847 #. type: =item
4848 #: dh_makeshlibs:35
4849 msgid "debian/I<package>.symbols.I<arch>"
4850 msgstr ""
4851
4852 #. type: textblock
4853 #: dh_makeshlibs:37
4854 msgid ""
4855 "These symbols files, if present, are passed to L<dpkg-gensymbols(1)> to be "
4856 "processed and installed. Use the I<arch> specific names if you need to "
4857 "provide different symbols files for different architectures."
4858 msgstr ""
4859
4860 #. type: =item
4861 #: dh_makeshlibs:47
4862 msgid "B<-m>I<major>, B<--major=>I<major>"
4863 msgstr ""
4864
4865 #. type: textblock
4866 #: dh_makeshlibs:49
4867 msgid ""
4868 "Instead of trying to guess the major number of the library with objdump, use "
4869 "the major number specified after the -m parameter. This is much less useful "
4870 "than it used to be, back in the bad old days when this program looked at "
4871 "library filenames rather than using objdump."
4872 msgstr ""
4873
4874 #. type: =item
4875 #: dh_makeshlibs:54
4876 msgid "B<-V>, B<-V>I<dependencies>"
4877 msgstr ""
4878
4879 #. type: =item
4880 #: dh_makeshlibs:56
4881 msgid "B<--version-info>, B<--version-info=>I<dependencies>"
4882 msgstr ""
4883
4884 #. type: textblock
4885 #: dh_makeshlibs:58
4886 msgid ""
4887 "By default, the shlibs file generated by this program does not make packages "
4888 "depend on any particular version of the package containing the shared "
4889 "library. It may be necessary for you to add some version dependency "
4890 "information to the shlibs file. If B<-V> is specified with no dependency "
4891 "information, the current upstream version of the package is plugged into a "
4892 "dependency that looks like \"I<packagename> B<(E<gt>>= "
4893 "I<packageversion>B<)>\". Note that in debhelper compatibility levels before "
4894 "v4, the Debian part of the package version number is also included. If B<-V> "
4895 "is specified with parameters, the parameters can be used to specify the "
4896 "exact dependency information needed (be sure to include the package name)."
4897 msgstr ""
4898
4899 #. type: textblock
4900 #: dh_makeshlibs:69
4901 msgid ""
4902 "Beware of using B<-V> without any parameters; this is a conservative setting "
4903 "that always ensures that other packages' shared library dependencies are at "
4904 "least as tight as they need to be (unless your library is prone to changing "
4905 "ABI without updating the upstream version number), so that if the maintainer "
4906 "screws up then they won't break. The flip side is that packages might end up "
4907 "with dependencies that are too tight and so find it harder to be upgraded."
4908 msgstr ""
4909
4910 #. type: textblock
4911 #: dh_makeshlibs:83
4912 msgid ""
4913 "Exclude files that contain I<item> anywhere in their filename or directory "
4914 "from being treated as shared libraries."
4915 msgstr ""
4916
4917 #. type: =item
4918 #: dh_makeshlibs:86
4919 msgid "B<--add-udeb=>I<udeb>"
4920 msgstr ""
4921
4922 #. type: textblock
4923 #: dh_makeshlibs:88
4924 msgid ""
4925 "Create an additional line for udebs in the shlibs file and use I<udeb> as "
4926 "the package name for udebs to depend on instead of the regular library "
4927 "package."
4928 msgstr ""
4929
4930 #. type: textblock
4931 #: dh_makeshlibs:93
4932 msgid "Pass I<params> to L<dpkg-gensymbols(1)>."
4933 msgstr ""
4934
4935 #. type: =item
4936 #: dh_makeshlibs:101
4937 msgid "B<dh_makeshlibs>"
4938 msgstr ""
4939
4940 #. type: verbatim
4941 #: dh_makeshlibs:103
4942 #, no-wrap
4943 msgid ""
4944 "Assuming this is a package named F<libfoobar1>, generates a shlibs file "
4945 "that\n"
4946 "looks something like:\n"
4947 " libfoobar 1 libfoobar1\n"
4948 "\n"
4949 msgstr ""
4950
4951 #. type: =item
4952 #: dh_makeshlibs:107
4953 msgid "B<dh_makeshlibs -V>"
4954 msgstr ""
4955
4956 #. type: verbatim
4957 #: dh_makeshlibs:109
4958 #, no-wrap
4959 msgid ""
4960 "Assuming the current version of the package is 1.1-3, generates a shlibs\n"
4961 "file that looks something like:\n"
4962 " libfoobar 1 libfoobar1 (>= 1.1)\n"
4963 "\n"
4964 msgstr ""
4965
4966 #. type: =item
4967 #: dh_makeshlibs:113
4968 msgid "B<dh_makeshlibs -V 'libfoobar1 (E<gt>= 1.0)'>"
4969 msgstr ""
4970
4971 #. type: verbatim
4972 #: dh_makeshlibs:115
4973 #, no-wrap
4974 msgid ""
4975 "Generates a shlibs file that looks something like:\n"
4976 "  libfoobar 1 libfoobar1 (>= 1.0)\n"
4977 "\n"
4978 msgstr ""
4979
4980 #. type: textblock
4981 #: dh_md5sums:5
4982 msgid "dh_md5sums - generate DEBIAN/md5sums file"
4983 msgstr ""
4984
4985 #. type: textblock
4986 #: dh_md5sums:15
4987 msgid ""
4988 "B<dh_md5sums> [S<I<debhelper options>>] [B<-x>] [B<-X>I<item>] "
4989 "[B<--include-conffiles>]"
4990 msgstr ""
4991
4992 #. type: textblock
4993 #: dh_md5sums:19
4994 msgid ""
4995 "B<dh_md5sums> is a debhelper program that is responsible for generating a "
4996 "F<DEBIAN/md5sums> file, which lists the md5sums of each file in the "
4997 "package.  These files are used by the B<debsums> package."
4998 msgstr ""
4999
5000 #. type: textblock
5001 #: dh_md5sums:23
5002 msgid ""
5003 "All files in F<DEBIAN/> are omitted from the F<md5sums> file, as are all "
5004 "conffiles (unless you use the B<--include-conffiles> switch)."
5005 msgstr ""
5006
5007 #. type: textblock
5008 #: dh_md5sums:26
5009 msgid "The md5sums file is installed with proper permissions and ownerships."
5010 msgstr ""
5011
5012 #. type: =item
5013 #: dh_md5sums:32
5014 msgid "B<-x>, B<--include-conffiles>"
5015 msgstr ""
5016
5017 #. type: textblock
5018 #: dh_md5sums:34
5019 msgid ""
5020 "Include conffiles in the md5sums list. Note that this information is "
5021 "redundant since it is included elsewhere in Debian packages."
5022 msgstr ""
5023
5024 #. type: textblock
5025 #: dh_md5sums:39
5026 msgid ""
5027 "Exclude files that contain I<item> anywhere in their filename from being "
5028 "listed in the md5sums file."
5029 msgstr ""
5030
5031 #. type: textblock
5032 #: dh_movefiles:5
5033 msgid "dh_movefiles - move files out of debian/tmp into subpackages"
5034 msgstr ""
5035
5036 #. type: textblock
5037 #: dh_movefiles:14
5038 msgid ""
5039 "B<dh_movefiles> [S<I<debhelper options>>] [B<--sourcedir=>I<dir>] "
5040 "[B<-X>I<item>] S<I<file> ...>]"
5041 msgstr ""
5042
5043 #. type: textblock
5044 #: dh_movefiles:18
5045 msgid ""
5046 "B<dh_movefiles> is a debhelper program that is responsible for moving files "
5047 "out of F<debian/tmp> or some other directory and into other package build "
5048 "directories. This may be useful if your package has a F<Makefile> that "
5049 "installs everything into F<debian/tmp>, and you need to break that up into "
5050 "subpackages."
5051 msgstr ""
5052
5053 #. type: textblock
5054 #: dh_movefiles:23
5055 msgid ""
5056 "Note: B<dh_install> is a much better program, and you are recommended to use "
5057 "it instead of B<dh_movefiles>."
5058 msgstr ""
5059
5060 #. type: =item
5061 #: dh_movefiles:30
5062 msgid "debian/I<package>.files"
5063 msgstr ""
5064
5065 #. type: textblock
5066 #: dh_movefiles:32
5067 msgid ""
5068 "Lists the files to be moved into a package, separated by whitespace. The "
5069 "filenames listed should be relative to F<debian/tmp/>. You can also list "
5070 "directory names, and the whole directory will be moved."
5071 msgstr ""
5072
5073 #. type: textblock
5074 #: dh_movefiles:44
5075 msgid ""
5076 "Instead of moving files out of F<debian/tmp> (the default), this option "
5077 "makes it move files out of some other directory. Since the entire contents "
5078 "of the sourcedir is moved, specifying something like B<--sourcedir=/> is "
5079 "very unsafe, so to prevent mistakes, the sourcedir must be a relative "
5080 "filename; it cannot begin with a `B</>'."
5081 msgstr ""
5082
5083 #. type: =item
5084 #: dh_movefiles:50
5085 msgid "B<-Xitem>, B<--exclude=item>"
5086 msgstr ""
5087
5088 #. type: textblock
5089 #: dh_movefiles:52
5090 msgid ""
5091 "Exclude files that contain B<item> anywhere in their filename from being "
5092 "installed."
5093 msgstr ""
5094
5095 #. type: textblock
5096 #: dh_movefiles:57
5097 msgid ""
5098 "Lists files to move. The filenames listed should be relative to "
5099 "F<debian/tmp/>. You can also list directory names, and the whole directory "
5100 "will be moved. It is an error to list files here unless you use B<-p>, "
5101 "B<-i>, or B<-a> to tell B<dh_movefiles> which subpackage to put them in."
5102 msgstr ""
5103
5104 #. type: textblock
5105 #: dh_movefiles:66
5106 msgid ""
5107 "Note that files are always moved out of F<debian/tmp> by default (even if "
5108 "you have instructed debhelper to use a compatibility level higher than one, "
5109 "which does not otherwise use debian/tmp for anything at all). The idea "
5110 "behind this is that the package that is being built can be told to install "
5111 "into F<debian/tmp>, and then files can be moved by B<dh_movefiles> from that "
5112 "directory. Any files or directories that remain are ignored, and get deleted "
5113 "by B<dh_clean> later."
5114 msgstr ""
5115
5116 #. type: textblock
5117 #: dh_perl:5
5118 msgid "dh_perl - calculates Perl dependencies and cleans up after MakeMaker"
5119 msgstr ""
5120
5121 #. type: textblock
5122 #: dh_perl:16
5123 msgid "B<dh_perl> [S<I<debhelper options>>] [B<-d>] [S<I<library dirs> ...>]"
5124 msgstr ""
5125
5126 #. type: textblock
5127 #: dh_perl:20
5128 msgid ""
5129 "B<dh_perl> is a debhelper program that is responsible for generating the "
5130 "B<${perl:Depends}> substitutions and adding them to substvars files."
5131 msgstr ""
5132
5133 #. type: textblock
5134 #: dh_perl:23
5135 msgid ""
5136 "The program will look at Perl scripts and modules in your package, and will "
5137 "use this information to generate a dependency on B<perl> or B<perlapi>. The "
5138 "dependency will be substituted into your package's F<control> file wherever "
5139 "you place the token B<${perl:Depends}>."
5140 msgstr ""
5141
5142 #. type: textblock
5143 #: dh_perl:28
5144 msgid ""
5145 "B<dh_perl> also cleans up empty directories that MakeMaker can generate when "
5146 "installing Perl modules."
5147 msgstr ""
5148
5149 #. type: =item
5150 #: dh_perl:35
5151 msgid "B<-d>"
5152 msgstr ""
5153
5154 #. type: textblock
5155 #: dh_perl:37
5156 msgid ""
5157 "In some specific cases you may want to depend on B<perl-base> rather than "
5158 "the full B<perl> package. If so, you can pass the -d option to make "
5159 "B<dh_perl> generate a dependency on the correct base package. This is only "
5160 "necessary for some packages that are included in the base system."
5161 msgstr ""
5162
5163 #. type: textblock
5164 #: dh_perl:42
5165 msgid ""
5166 "Note that this flag may cause no dependency on B<perl-base> to be generated "
5167 "at all. B<perl-base> is Essential, so its dependency can be left out, unless "
5168 "a versioned dependency is needed."
5169 msgstr ""
5170
5171 #. type: =item
5172 #: dh_perl:46
5173 msgid "B<-V>"
5174 msgstr ""
5175
5176 #. type: textblock
5177 #: dh_perl:48
5178 msgid ""
5179 "By default, scripts and architecture independent modules don't depend on any "
5180 "specific version of B<perl>. The B<-V> option causes the current version of "
5181 "the B<perl> (or B<perl-base> with B<-d>) package to be specified."
5182 msgstr ""
5183
5184 #. type: =item
5185 #: dh_perl:52
5186 msgid "I<library dirs>"
5187 msgstr ""
5188
5189 #. type: textblock
5190 #: dh_perl:54
5191 msgid ""
5192 "If your package installs Perl modules in non-standard directories, you can "
5193 "make B<dh_perl> check those directories by passing their names on the "
5194 "command line. It will only check the F<vendorlib> and F<vendorarch> "
5195 "directories by default."
5196 msgstr ""
5197
5198 #. type: textblock
5199 #: dh_perl:63
5200 msgid "Debian policy, version 3.8.3"
5201 msgstr ""
5202
5203 #. type: textblock
5204 #: dh_perl:65
5205 msgid "Perl policy, version 1.20"
5206 msgstr ""
5207
5208 #. type: textblock
5209 #: dh_perl:154
5210 msgid "Brendan O'Dea <bod@debian.org>"
5211 msgstr ""
5212
5213 #. type: textblock
5214 #: dh_prep:5
5215 msgid "dh_prep - perform cleanups in preparation for building a binary package"
5216 msgstr ""
5217
5218 #. type: textblock
5219 #: dh_prep:14
5220 msgid "B<dh_prep> [S<I<debhelper options>>] [B<-X>I<item>]"
5221 msgstr ""
5222
5223 #. type: textblock
5224 #: dh_prep:18
5225 msgid ""
5226 "B<dh_prep> is a debhelper program that performs some file cleanups in "
5227 "preparation for building a binary package. (This is what B<dh_clean -k> used "
5228 "to do.) It removes the package build directories, F<debian/tmp>, and some "
5229 "temp files that are generated when building a binary package."
5230 msgstr ""
5231
5232 #. type: textblock
5233 #: dh_prep:23
5234 msgid ""
5235 "It is typically run at the top of the B<binary-arch> and B<binary-indep> "
5236 "targets, or at the top of a target such as install that they depend on."
5237 msgstr ""
5238
5239 #. type: textblock
5240 #: dh_prep:32
5241 msgid ""
5242 "Exclude files that contain F<item> anywhere in their filename from being "
5243 "deleted, even if they would normally be deleted. You may use this option "
5244 "multiple times to build up a list of things to exclude."
5245 msgstr ""
5246
5247 #. type: textblock
5248 #: dh_python:5
5249 msgid ""
5250 "dh_python - calculates Python dependencies and adds postinst and prerm "
5251 "Python scripts (deprecated)"
5252 msgstr ""
5253
5254 #. type: textblock
5255 #: dh_python:15
5256 msgid ""
5257 "B<dh_python> [S<I<debhelper options>>] [B<-n>] [B<-V> I<version>] "
5258 "[S<I<module dirs> ...>]"
5259 msgstr ""
5260
5261 #. type: textblock
5262 #: dh_python:19
5263 msgid ""
5264 "Note: This program is deprecated. You should use B<dh_python2> instead.  "
5265 "This program will do nothing if F<debian/pycompat> or a B<Python-Version> "
5266 "F<control> file field exists."
5267 msgstr ""
5268
5269 #. type: textblock
5270 #: dh_python:23
5271 msgid ""
5272 "B<dh_python> is a debhelper program that is responsible for generating the "
5273 "B<${python:Depends}> substitutions and adding them to substvars files. It "
5274 "will also add a F<postinst> and a F<prerm> script if required."
5275 msgstr ""
5276
5277 #. type: textblock
5278 #: dh_python:27
5279 msgid ""
5280 "The program will look at Python scripts and modules in your package, and "
5281 "will use this information to generate a dependency on B<python>, with the "
5282 "current major version, or on B<python>I<X>B<.>I<Y> if your scripts or "
5283 "modules need a specific B<python> version. The dependency will be "
5284 "substituted into your package's F<control> file wherever you place the token "
5285 "B<${python:Depends}>."
5286 msgstr ""
5287
5288 #. type: textblock
5289 #: dh_python:33
5290 msgid ""
5291 "If some modules need to be byte-compiled at install time, appropriate "
5292 "F<postinst> and F<prerm> scripts will be generated. If already byte-compiled "
5293 "modules are found, they are removed."
5294 msgstr ""
5295
5296 #. type: textblock
5297 #: dh_python:37
5298 msgid "If you use this program, your package should build-depend on B<python>."
5299 msgstr ""
5300
5301 #. type: =item
5302 #: dh_python:43
5303 msgid "I<module dirs>"
5304 msgstr ""
5305
5306 #. type: textblock
5307 #: dh_python:45
5308 msgid ""
5309 "If your package installs Python modules in non-standard directories, you can "
5310 "make F<dh_python> check those directories by passing their names on the "
5311 "command line. By default, it will check F</usr/lib/site-python, "
5312 "/usr/lib/$PACKAGE>, F</usr/share/$PACKAGE>, F</usr/lib/games/$PACKAGE>, "
5313 "F</usr/share/games/$PACKAGE> and F</usr/lib/python?.?/site-packages>."
5314 msgstr ""
5315
5316 #. type: textblock
5317 #: dh_python:51
5318 msgid ""
5319 "Note: only F</usr/lib/site-python>, F</usr/lib/python?.?/site-packages> and "
5320 "the extra names on the command line are searched for binary (F<.so>) "
5321 "modules."
5322 msgstr ""
5323
5324 #. type: =item
5325 #: dh_python:54
5326 msgid "B<-V> I<version>"
5327 msgstr ""
5328
5329 #. type: textblock
5330 #: dh_python:56
5331 msgid ""
5332 "If the F<.py> files your package ships are meant to be used by a specific "
5333 "B<python>I<X>B<.>I<Y> version, you can use this option to specify the "
5334 "desired version, such as B<2.3>. Do not use if you ship modules in "
5335 "F</usr/lib/site-python>."
5336 msgstr ""
5337
5338 #. type: textblock
5339 #: dh_python:68
5340 msgid "Debian policy, version 3.5.7"
5341 msgstr ""
5342
5343 #. type: textblock
5344 #: dh_python:70
5345 msgid "Python policy, version 0.3.7"
5346 msgstr ""
5347
5348 #. type: textblock
5349 #: dh_python:288
5350 msgid "Josselin Mouette <joss@debian.org>"
5351 msgstr ""
5352
5353 #. type: textblock
5354 #: dh_python:290
5355 msgid "most ideas stolen from Brendan O'Dea <bod@debian.org>"
5356 msgstr ""
5357
5358 #. type: textblock
5359 #: dh_scrollkeeper:5
5360 msgid "dh_scrollkeeper - deprecated no-op"
5361 msgstr ""
5362
5363 #. type: textblock
5364 #: dh_scrollkeeper:14
5365 msgid "B<dh_scrollkeeper> [S<I<debhelper options>>] [B<-n>] [S<I<directory>>]"
5366 msgstr ""
5367
5368 #. type: textblock
5369 #: dh_scrollkeeper:18
5370 msgid ""
5371 "B<dh_scrollkeeper> was a debhelper program that handled registering OMF "
5372 "files for ScrollKeeper. However, it no longer does anything, and is now "
5373 "deprecated."
5374 msgstr ""
5375
5376 #. type: textblock
5377 #: dh_shlibdeps:5
5378 msgid "dh_shlibdeps - calculate shared library dependencies"
5379 msgstr ""
5380
5381 #. type: textblock
5382 #: dh_shlibdeps:15
5383 msgid ""
5384 "B<dh_shlibdeps> [S<I<debhelper options>>] [B<-L>I<package>] "
5385 "[B<-l>I<directory>] [B<-X>I<item>] [S<B<--> I<params>>]"
5386 msgstr ""
5387
5388 #. type: textblock
5389 #: dh_shlibdeps:19
5390 msgid ""
5391 "B<dh_shlibdeps> is a debhelper program that is responsible for calculating "
5392 "shared library dependencies for packages."
5393 msgstr ""
5394
5395 #. type: textblock
5396 #: dh_shlibdeps:22
5397 msgid ""
5398 "This program is merely a wrapper around L<dpkg-shlibdeps(1)> that calls it "
5399 "once for each package listed in the F<control> file, passing it a list of "
5400 "ELF executables and shared libraries it has found."
5401 msgstr ""
5402
5403 #. type: textblock
5404 #: dh_shlibdeps:32
5405 msgid ""
5406 "Exclude files that contain F<item> anywhere in their filename from being "
5407 "passed to B<dpkg-shlibdeps>. This will make their dependencies be ignored.  "
5408 "This may be useful in some situations, but use it with caution. This option "
5409 "may be used more than once to exclude more than one thing."
5410 msgstr ""
5411
5412 #. type: textblock
5413 #: dh_shlibdeps:39
5414 msgid "Pass I<params> to L<dpkg-shlibdeps(1)>."
5415 msgstr ""
5416
5417 #. type: =item
5418 #: dh_shlibdeps:41
5419 msgid "B<-u>I<params>, B<--dpkg-shlibdeps-params=>I<params>"
5420 msgstr ""
5421
5422 #. type: textblock
5423 #: dh_shlibdeps:43
5424 msgid ""
5425 "This is another way to pass I<params> to L<dpkg-shlibdeps(1)>.  It is "
5426 "deprecated; use B<--> instead."
5427 msgstr ""
5428
5429 #. type: =item
5430 #: dh_shlibdeps:46
5431 msgid "B<-l>I<directory>[B<:>I<directory> ...]"
5432 msgstr ""
5433
5434 #. type: textblock
5435 #: dh_shlibdeps:48
5436 msgid ""
5437 "With recent versions of B<dpkg-shlibdeps>, this option is generally not "
5438 "needed."
5439 msgstr ""
5440
5441 #. type: textblock
5442 #: dh_shlibdeps:51
5443 msgid ""
5444 "Before B<dpkg-shlibdeps> is run, B<LD_LIBRARY_PATH> will have added to it "
5445 "the specified directory (or directories -- separate with colons). With "
5446 "recent versions of B<dpkg-shlibdeps>, this is mostly only useful for "
5447 "packages that build multiple flavors of the same library, or other "
5448 "situations where the library is installed into a directory not on the "
5449 "regular library search path."
5450 msgstr ""
5451
5452 #. type: =item
5453 #: dh_shlibdeps:58
5454 msgid "B<-L>I<package>, B<--libpackage=>I<package>"
5455 msgstr ""
5456
5457 #. type: textblock
5458 #: dh_shlibdeps:60
5459 msgid ""
5460 "With recent versions of B<dpkg-shlibdeps>, this option is generally not "
5461 "needed, unless your package builds multiple flavors of the same library."
5462 msgstr ""
5463
5464 #. type: textblock
5465 #: dh_shlibdeps:63
5466 msgid ""
5467 "It tells B<dpkg-shlibdeps> (via its B<-S> parameter) to look first in the "
5468 "package build directory for the specified package, when searching for "
5469 "libraries, symbol files, and shlibs files."
5470 msgstr ""
5471
5472 #. type: textblock
5473 #: dh_shlibdeps:71
5474 msgid ""
5475 "Suppose that your source package produces libfoo1, libfoo-dev, and "
5476 "libfoo-bin binary packages. libfoo-bin links against libfoo1, and should "
5477 "depend on it. In your rules file, first run B<dh_makeshlibs>, then "
5478 "B<dh_shlibdeps>:"
5479 msgstr ""
5480
5481 #. type: verbatim
5482 #: dh_shlibdeps:75
5483 #, no-wrap
5484 msgid ""
5485 "\tdh_makeshlibs\n"
5486 "\tdh_shlibdeps\n"
5487 "\n"
5488 msgstr ""
5489
5490 #. type: textblock
5491 #: dh_shlibdeps:78
5492 msgid ""
5493 "This will have the effect of generating automatically a shlibs file for "
5494 "libfoo1, and using that file and the libfoo1 library in the "
5495 "F<debian/libfoo1/usr/lib> directory to calculate shared library dependency "
5496 "information."
5497 msgstr ""
5498
5499 #. type: textblock
5500 #: dh_shlibdeps:83
5501 msgid ""
5502 "If a libbar1 package is also produced, that is an alternate build of libfoo, "
5503 "and is installed into F</usr/lib/bar/>, you can make libfoo-bin depend on "
5504 "libbar1 as follows:"
5505 msgstr ""
5506
5507 #. type: verbatim
5508 #: dh_shlibdeps:87
5509 #, no-wrap
5510 msgid ""
5511 "\tdh_shlibdeps -Llibbar1 -l/usr/lib/bar\n"
5512 "\t\n"
5513 msgstr ""
5514
5515 #. type: textblock
5516 #: dh_shlibdeps:173
5517 msgid "L<debhelper(7)>, L<dpkg-shlibdeps(1)>"
5518 msgstr ""
5519
5520 #. type: textblock
5521 #: dh_strip:5
5522 msgid "dh_strip - strip executables, shared libraries, and some static libraries"
5523 msgstr ""
5524
5525 #. type: textblock
5526 #: dh_strip:15
5527 msgid ""
5528 "B<dh_strip> [S<I<debhelper options>>] [B<-X>I<item>] "
5529 "[B<--dbg-package=>I<package>] [B<--keep-debug>]"
5530 msgstr ""
5531
5532 #. type: textblock
5533 #: dh_strip:19
5534 msgid ""
5535 "B<dh_strip> is a debhelper program that is responsible for stripping "
5536 "executables, shared libraries, and static libraries that are not used for "
5537 "debugging."
5538 msgstr ""
5539
5540 #. type: textblock
5541 #: dh_strip:23
5542 msgid ""
5543 "This program examines your package build directories and works out what to "
5544 "strip on its own. It uses L<file(1)> and file permissions and filenames to "
5545 "figure out what files are shared libraries (F<*.so>), executable binaries, "
5546 "and static (F<lib*.a>) and debugging libraries (F<lib*_g.a>, F<debug/*.so>), "
5547 "and strips each as much as is possible. (Which is not at all for debugging "
5548 "libraries.) In general it seems to make very good guesses, and will do the "
5549 "right thing in almost all cases."
5550 msgstr ""
5551
5552 #. type: textblock
5553 #: dh_strip:31
5554 msgid ""
5555 "Since it is very hard to automatically guess if a file is a module, and hard "
5556 "to determine how to strip a module, B<dh_strip> does not currently deal with "
5557 "stripping binary modules such as F<.o> files."
5558 msgstr ""
5559
5560 #. type: textblock
5561 #: dh_strip:41
5562 msgid ""
5563 "Exclude files that contain I<item> anywhere in their filename from being "
5564 "stripped. You may use this option multiple times to build up a list of "
5565 "things to exclude."
5566 msgstr ""
5567
5568 #. type: =item
5569 #: dh_strip:45
5570 msgid "B<--dbg-package=>I<package>"
5571 msgstr ""
5572
5573 #. type: textblock
5574 #: dh_strip:47
5575 msgid ""
5576 "Causes B<dh_strip> to save debug symbols stripped from the packages it acts "
5577 "on as independent files in the package build directory of the specified "
5578 "debugging package."
5579 msgstr ""
5580
5581 #. type: textblock
5582 #: dh_strip:51
5583 msgid ""
5584 "For example, if your packages are libfoo and foo and you want to include a "
5585 "I<foo-dbg> package with debugging symbols, use B<dh_strip "
5586 "--dbg-package=>I<foo-dbg>."
5587 msgstr ""
5588
5589 #. type: textblock
5590 #: dh_strip:54
5591 msgid ""
5592 "Note that this option behaves significantly different in debhelper "
5593 "compatibility levels 4 and below. Instead of specifying the name of a debug "
5594 "package to put symbols in, it specifies a package (or packages) which should "
5595 "have separated debug symbols, and the separated symbols are placed in "
5596 "packages with B<-dbg> added to their name."
5597 msgstr ""
5598
5599 #. type: =item
5600 #: dh_strip:60
5601 msgid "B<-k>, B<--keep-debug>"
5602 msgstr ""
5603
5604 #. type: textblock
5605 #: dh_strip:62
5606 msgid ""
5607 "Debug symbols will be retained, but split into an independent file in "
5608 "F<usr/lib/debug/> in the package build directory. B<--dbg-package> is easier "
5609 "to use than this option, but this option is more flexible."
5610 msgstr ""
5611
5612 #. type: textblock
5613 #: dh_strip:70
5614 msgid ""
5615 "If the B<DEB_BUILD_OPTIONS> environment variable contains B<nostrip>, "
5616 "nothing will be stripped, in accordance with Debian policy (section 10.1 "
5617 "\"Binaries\")."
5618 msgstr ""
5619
5620 #. type: textblock
5621 #: dh_strip:76
5622 msgid "Debian policy, version 3.0.1"
5623 msgstr ""
5624
5625 #. type: textblock
5626 #: dh_suidregister:5
5627 msgid "dh_suidregister - suid registration program (deprecated)"
5628 msgstr ""
5629
5630 #. type: textblock
5631 #: dh_suidregister:9 dh_undocumented:14
5632 msgid "Do not run!"
5633 msgstr ""
5634
5635 #. type: textblock
5636 #: dh_suidregister:13
5637 msgid ""
5638 "This program used to register suid and sgid files with L<suidregister(1)>, "
5639 "but with the introduction of L<dpkg-statoverride(8)>, registration of files "
5640 "in this way is unnecessary, and even harmful, so this program is deprecated "
5641 "and should not be used."
5642 msgstr ""
5643
5644 #. type: =head1
5645 #: dh_suidregister:18
5646 msgid "CONVERTING TO STATOVERRIDE"
5647 msgstr ""
5648
5649 #. type: textblock
5650 #: dh_suidregister:20
5651 msgid ""
5652 "Converting a package that uses this program to use the new statoverride "
5653 "mechanism is easy. Just remove the call to B<dh_suidregister> from "
5654 "F<debian/rules>, and add a versioned conflicts into your F<control> file, as "
5655 "follows:"
5656 msgstr ""
5657
5658 #. type: verbatim
5659 #: dh_suidregister:25
5660 #, no-wrap
5661 msgid ""
5662 "  Conflicts: suidmanager (<< 0.50)\n"
5663 "\n"
5664 msgstr ""
5665
5666 #. type: textblock
5667 #: dh_suidregister:27
5668 msgid ""
5669 "The conflicts is only necessary if your package used to register things with "
5670 "suidmanager; if it did not, you can just remove the call to this program "
5671 "from your rules file."
5672 msgstr ""
5673
5674 #. type: textblock
5675 #: dh_testdir:5
5676 msgid "dh_testdir - test directory before building Debian package"
5677 msgstr ""
5678
5679 #. type: textblock
5680 #: dh_testdir:14
5681 msgid "B<dh_testdir> [S<I<debhelper options>>] [S<I<file> ...>]"
5682 msgstr ""
5683
5684 #. type: textblock
5685 #: dh_testdir:18
5686 msgid ""
5687 "B<dh_testdir> tries to make sure that you are in the correct directory when "
5688 "building a Debian package. It makes sure that the file F<debian/control> "
5689 "exists, as well as any other files you specify. If not, it exits with an "
5690 "error."
5691 msgstr ""
5692
5693 #. type: textblock
5694 #: dh_testdir:29
5695 msgid "Test for the existence of these files too."
5696 msgstr ""
5697
5698 #. type: textblock
5699 #: dh_testroot:5
5700 msgid "dh_testroot - ensure that a package is built as root"
5701 msgstr ""
5702
5703 #. type: textblock
5704 #: dh_testroot:9
5705 msgid "B<dh_testroot> [S<I<debhelper options>>]"
5706 msgstr ""
5707
5708 #. type: textblock
5709 #: dh_testroot:13
5710 msgid ""
5711 "B<dh_testroot> simply checks to see if you are root. If not, it exits with "
5712 "an error. Debian packages must be built as root, though you can use "
5713 "L<fakeroot(1)>"
5714 msgstr ""
5715
5716 #. type: textblock
5717 #: dh_undocumented:5
5718 msgid "dh_undocumented - undocumented.7 symlink program (deprecated no-op)"
5719 msgstr ""
5720
5721 #. type: textblock
5722 #: dh_undocumented:18
5723 msgid ""
5724 "This program used to make symlinks to the F<undocumented.7> man page for man "
5725 "pages not present in a package. Debian policy now frowns on use of the "
5726 "F<undocumented.7> man page, and so this program does nothing, and should not "
5727 "be used."
5728 msgstr ""
5729
5730 #. type: textblock
5731 #: dh_usrlocal:5
5732 msgid "dh_usrlocal - migrate usr/local directories to maintainer scripts"
5733 msgstr ""
5734
5735 #. type: textblock
5736 #: dh_usrlocal:17
5737 msgid "B<dh_usrlocal> [S<I<debhelper options>>] [B<-n>]"
5738 msgstr ""
5739
5740 #. type: textblock
5741 #: dh_usrlocal:21
5742 msgid ""
5743 "B<dh_usrlocal> is a debhelper program that can be used for building packages "
5744 "that will provide a subdirectory in F</usr/local> when installed."
5745 msgstr ""
5746
5747 #. type: textblock
5748 #: dh_usrlocal:24
5749 msgid ""
5750 "It finds subdirectories of F<usr/local> in the package build directory, and "
5751 "removes them, replacing them with maintainer script snippets (unless B<-n> "
5752 "is used) to create the directories at install time, and remove them when the "
5753 "package is removed, in a manner compliant with Debian policy. These snippets "
5754 "are inserted into the maintainer scripts by B<dh_installdeb>. See "
5755 "L<dh_installdeb(1)> for an explanation of debhelper maintainer script "
5756 "snippets."
5757 msgstr ""
5758
5759 #. type: textblock
5760 #: dh_usrlocal:32
5761 msgid ""
5762 "If the directories found in the build tree have unusual owners, groups, or "
5763 "permissions, then those values will be preserved in the directories made by "
5764 "the F<postinst> script. However, as a special exception, if a directory is "
5765 "owned by root.root, it will be treated as if it is owned by root.staff and "
5766 "is mode 2775. This is useful, since that is the group and mode policy "
5767 "recommends for directories in F</usr/local>."
5768 msgstr ""
5769
5770 #. type: textblock
5771 #: dh_usrlocal:57
5772 msgid "Debian policy, version 2.2"
5773 msgstr ""
5774
5775 #. type: textblock
5776 #: dh_usrlocal:122
5777 msgid "Andrew Stribblehill <ads@debian.org>"
5778 msgstr ""