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