# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2024-06-17 11:59+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: =head1 #: debhelper.pod:3 debhelper-compat-upgrade-checklist.pod:3 #: debhelper-obsolete-compat.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:5 dh_clean:3 dh_compress:3 dh_dwz:3 dh_fixperms: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:5 dh_installemacsen:3 dh_installexamples:5 #: dh_installifupdown:3 dh_installinfo:3 dh_installinit:3 dh_installinitramfs: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_shlibdeps:3 dh_strip:3 #: dh_testdir:3 dh_testroot:5 dh_usrlocal:5 dh_systemd_enable:3 #: dh_systemd_start:3 msgid "NAME" msgstr "" #. type: textblock #: debhelper.pod:5 msgid "debhelper - the debhelper tool suite" msgstr "" #. type: =head1 #: debhelper.pod:7 debhelper-compat-upgrade-checklist.pod:7 #: debhelper-obsolete-compat.pod:5 dh:22 dh_auto_build:16 dh_auto_clean:16 #: dh_auto_configure:16 dh_auto_install:18 dh_auto_test:16 dh_bugfiles:15 #: dh_builddeb:17 dh_clean:15 dh_compress:17 dh_dwz:16 dh_fixperms:16 #: dh_gencontrol:15 dh_icons:16 dh_install:15 dh_installcatalogs:17 #: dh_installchangelogs:16 dh_installcron:15 dh_installdeb:15 #: dh_installdebconf:15 dh_installdirs:15 dh_installdocs:17 #: dh_installemacsen:15 dh_installexamples:17 dh_installifupdown:15 #: dh_installinfo:15 dh_installinit:16 dh_installinitramfs:15 #: dh_installlogcheck:15 dh_installlogrotate:15 dh_installman:16 #: dh_installmanpages:16 dh_installmenu:15 dh_installmime:15 #: dh_installmodules:16 dh_installpam:15 dh_installppp:15 dh_installudev:15 #: dh_installwm:15 dh_installxfonts:15 dh_link:16 dh_lintian:15 #: dh_listpackages:15 dh_makeshlibs:15 dh_md5sums:16 dh_movefiles:15 dh_perl:18 #: dh_prep:15 dh_shlibdeps:17 dh_strip:16 dh_testdir:15 dh_testroot:9 #: dh_usrlocal:19 dh_systemd_enable:16 dh_systemd_start:17 msgid "SYNOPSIS" msgstr "" #. type: textblock #: debhelper.pod:9 msgid "" "BI<*> [B<-v>] [B<-a>] [B<-i>] [B<--no-act>] [B<-p>I] " "[B<-N>I] [B<-P>I]" msgstr "" #. type: =head1 #: debhelper.pod:11 debhelper-compat-upgrade-checklist.pod:17 dh:26 #: dh_auto_build:20 dh_auto_clean:20 dh_auto_configure:20 dh_auto_install:22 #: dh_auto_test:20 dh_bugfiles:19 dh_builddeb:21 dh_clean:19 dh_compress:21 #: dh_dwz:20 dh_fixperms:20 dh_gencontrol:19 dh_icons:20 dh_install:19 #: dh_installcatalogs:21 dh_installchangelogs:20 dh_installcron:19 #: dh_installdeb:19 dh_installdebconf:19 dh_installdirs:19 dh_installdocs:21 #: dh_installemacsen:19 dh_installexamples:21 dh_installifupdown:19 #: dh_installinfo:19 dh_installinit:20 dh_installinitramfs:19 #: dh_installlogcheck:19 dh_installlogrotate:19 dh_installman:20 #: dh_installmanpages:20 dh_installmenu:19 dh_installmime:19 #: dh_installmodules:20 dh_installpam:19 dh_installppp:19 dh_installudev:19 #: dh_installwm:19 dh_installxfonts:19 dh_link:20 dh_lintian:19 #: dh_listpackages:19 dh_makeshlibs:19 dh_md5sums:20 dh_movefiles:19 dh_perl:22 #: dh_prep:19 dh_shlibdeps:21 dh_strip:20 dh_testdir:19 dh_testroot:13 #: dh_usrlocal:23 dh_systemd_enable:20 dh_systemd_start:21 msgid "DESCRIPTION" msgstr "" #. type: textblock #: debhelper.pod:13 msgid "" "Debhelper is used to help you build a Debian package. The philosophy behind " "debhelper is to provide a collection of small, simple, and easily understood " "tools that are used in F to automate various common aspects of " "building a package. This means less work for you, the packager. It also, to " "some degree means that these tools can be changed if Debian policy changes, " "and packages that use them will require only a rebuild to comply with the " "new policy." msgstr "" #. type: textblock #: debhelper.pod:21 msgid "" "A typical F file that uses debhelper will call several " "debhelper commands in sequence, or use L to automate this " "process. Examples of rules files that use debhelper are in " "F" msgstr "" #. type: textblock #: debhelper.pod:25 msgid "" "To create a new Debian package using debhelper, you can just copy one of the " "sample rules files and edit it by hand. Or you can try the B " "package, which contains a L command that partially " "automates the process. For a more gentle introduction, the B " "Debian package contains a tutorial about making your first package using " "debhelper." msgstr "" #. type: textblock #: debhelper.pod:31 msgid "" "Except where the tool explicitly denotes otherwise, all of the debhelper " "tools assume that they run from the root directory of an unpacked source " "package. This is so they can locate find files like F when " "needed." msgstr "" #. type: =head1 #: debhelper.pod:36 msgid "DEBHELPER COMMANDS" msgstr "" #. type: textblock #: debhelper.pod:38 msgid "" "Here is the list of debhelper commands you can use. See their man pages for " "additional documentation." msgstr "" #. type: textblock #: debhelper.pod:43 msgid "#LIST#" msgstr "" #. type: =head2 #: debhelper.pod:47 msgid "Deprecated Commands" msgstr "" #. type: textblock #: debhelper.pod:49 msgid "A few debhelper commands are deprecated and should not be used." msgstr "" #. type: textblock #: debhelper.pod:53 msgid "#LIST_DEPRECATED#" msgstr "" #. type: =head2 #: debhelper.pod:57 msgid "Other Commands" msgstr "" #. type: textblock #: debhelper.pod:59 msgid "" "If a program's name starts with B, and the program is not on the above " "lists, then it is not part of the debhelper package, but it should still " "work like the other programs described on this page." msgstr "" #. type: =head1 #: debhelper.pod:63 msgid "DEBHELPER CONFIG FILES" msgstr "" #. type: textblock #: debhelper.pod:65 msgid "" "Many debhelper commands make use of files in F to control what they " "do. Besides the common F and F, which are " "in all packages, not just those using debhelper, some additional files can " "be used to configure the behavior of specific debhelper commands. These " "files are typically named debian/I.foo (where I of course, " "is replaced with the package that is being acted on)." msgstr "" #. type: textblock #: debhelper.pod:72 msgid "" "For example, B uses files named F to " "list the documentation files it will install. See the man pages of " "individual commands for details about the names and formats of the files " "they use. Generally, these files will list files to act on, one file per " "line. Some programs in debhelper use pairs of files and destinations or " "slightly more complicated formats." msgstr "" #. type: textblock #: debhelper.pod:79 msgid "" "Note if there is only one binary package listed in F, then " "debhelper will use F when there's no F.foo> " "file. In compat levels before compat 15, this fallback also occurs for the " "first binary package listed in F when there are multiple " "binary packages. However, it is often a good idea to keep the F.> " "prefix as it is more explicit and also required when upgrading to compat 15." msgstr "" #. type: textblock #: debhelper.pod:86 msgid "" "Additionally, there are some special cases where debhelper will always " "fallback to a prefix-less version. These are cases such as " "F and F, where the files are generally " "used and needed for all binary packages." msgstr "" #. type: textblock #: debhelper.pod:91 msgid "" "In some rare cases, you may want to have different versions of these files " "for different architectures or OSes. If files named " "debian/I.foo.I or debian/I.foo.I exist, where " "I and I are the same as the output of \"B\" / \"B\", then they " "will be used in preference to other, more general files." msgstr "" #. type: textblock #: debhelper.pod:98 msgid "" "Mostly, these config files are used to specify lists of various types of " "files. Documentation or example files to install, files to move, and so on. " "When appropriate, in cases like these, you can use standard shell wildcard " "characters (B and B<*> and B<[>I<..>B<]> character classes) in the " "files. You can also put comments in these files; lines beginning with B<#> " "are ignored." msgstr "" #. type: textblock #: debhelper.pod:105 msgid "" "The syntax of these files is intentionally kept very simple to make them " "easy to read, understand, and modify." msgstr "" #. type: =head2 #: debhelper.pod:108 msgid "Substitutions in debhelper config files" msgstr "" #. type: textblock #: debhelper.pod:110 msgid "" "In compatibility level 13 and later, it is possible to use simple " "substitutions in debhelper config files for the following tools:" msgstr "" #. type: =item #: debhelper.pod:115 debhelper.pod:119 debhelper.pod:123 debhelper.pod:127 #: debhelper.pod:131 debhelper.pod:135 debhelper.pod:139 debhelper.pod:143 #: debhelper.pod:147 debhelper.pod:151 debhelper.pod:155 debhelper.pod:159 #: debhelper.pod:163 debhelper.pod:262 debhelper.pod:267 msgid "*" msgstr "" #. type: textblock #: debhelper.pod:117 msgid "dh_clean" msgstr "" #. type: textblock #: debhelper.pod:121 msgid "dh_install" msgstr "" #. type: textblock #: debhelper.pod:125 msgid "dh_installcatalogs" msgstr "" #. type: textblock #: debhelper.pod:129 msgid "dh_installdeb" msgstr "" #. type: textblock #: debhelper.pod:133 msgid "dh_installdirs" msgstr "" #. type: textblock #: debhelper.pod:137 msgid "dh_installdocs" msgstr "" #. type: textblock #: debhelper.pod:141 msgid "dh_installexamples" msgstr "" #. type: textblock #: debhelper.pod:145 msgid "dh_installinfo" msgstr "" #. type: textblock #: debhelper.pod:149 msgid "dh_installman" msgstr "" #. type: textblock #: debhelper.pod:153 msgid "dh_installwm" msgstr "" #. type: textblock #: debhelper.pod:157 msgid "dh_link" msgstr "" #. type: textblock #: debhelper.pod:161 msgid "dh_missing" msgstr "" #. type: textblock #: debhelper.pod:165 msgid "dh_ucf" msgstr "" #. type: textblock #: debhelper.pod:169 msgid "" "All substitution variables are of the form I<${foo}> and the braces are " "mandatory. Variable names are case-sensitive and consist of alphanumerics " "(a-zA-Z0-9), hyphens (-), underscores (_), and colons (:). The first " "character must be an alphanumeric." msgstr "" #. type: textblock #: debhelper.pod:174 msgid "" "If you need a literal dollar sign that cannot trigger a substitution, you " "can either use the B<${Dollar}> substitution or the sequence B<${}>." msgstr "" #. type: textblock #: debhelper.pod:177 msgid "The following expansions are available:" msgstr "" #. type: =item #: debhelper.pod:181 msgid "B, B, B" msgstr "" #. type: textblock #: debhelper.pod:183 msgid "" "Expands to the relevant L value (similar to " "I)." msgstr "" #. type: textblock #: debhelper.pod:186 msgid "" "When in doubt, the B variant is the one that will work both for " "native and cross builds." msgstr "" #. type: textblock #: debhelper.pod:189 msgid "" "For performance reasons, debhelper will attempt to resolve these names from " "the environment first before consulting L. This is " "mostly mentioned for completeness as it will not matter for most cases." msgstr "" #. type: =item #: debhelper.pod:194 msgid "B" msgstr "" #. type: textblock #: debhelper.pod:196 msgid "" "Expands to a single literal B<$>-symbol. This symbol will I be " "considered part of a substitution variable. That is:" msgstr "" #. type: verbatim #: debhelper.pod:199 #, no-wrap msgid "" " # Triggers an error\n" " ${NO_SUCH_TOKEN}\n" " # Expands to the literal value \"${NO_SUCH_TOKEN}\"\n" " ${Dollar}{NO_SUCH_TOKEN}\n" "\n" msgstr "" #. type: textblock #: debhelper.pod:204 msgid "" "This variable equivalent to the sequence B<${}> and the two can be used " "interchangeably." msgstr "" #. type: =item #: debhelper.pod:207 msgid "B, B, B" msgstr "" #. type: textblock #: debhelper.pod:209 msgid "Expands to a single ASCII newline, space and tab respectively." msgstr "" #. type: textblock #: debhelper.pod:211 msgid "" "This can be useful if you need to include a literal whitespace character " "(e.g. space) where it would otherwise be stripped or used as a separator." msgstr "" #. type: =item #: debhelper.pod:215 msgid "B<< env:I >>" msgstr "" #. type: textblock #: debhelper.pod:217 msgid "" "Expands to the environment variable I. The environment variable must " "be set (but can be set to the empty string)." msgstr "" #. type: textblock #: debhelper.pod:222 msgid "" "Note that all variables must expand to a defined value. As an example, if " "debhelper sees I<${env:FOO}>, then it will insist that the environment " "variable I is set (it can be set to the empty string)." msgstr "" #. type: =head3 #: debhelper.pod:226 msgid "Substitution limits" msgstr "" #. type: textblock #: debhelper.pod:228 msgid "" "To avoid infinite loops and resource exhaustion, debhelper will stop with an " "error if the text contains many substitution variables (50) or they expand " "beyond a certain size (4096 characters or 3x length of the original input - " "whichever is bigger)." msgstr "" #. type: =head3 #: debhelper.pod:233 msgid "Substitution limitations: filtering" msgstr "" #. type: textblock #: debhelper.pod:235 msgid "" "The built-in substitution cannot be used to \"filter\" out content. Attempts " "to create \"comments\" or \"empty lines\" via substitution will result in " "those variables being considered a token in its own right with the content " "given." msgstr "" #. type: textblock #: debhelper.pod:239 msgid "" "If you want filtering, consider using an executable debhelper config file " "with B as interpreter. The B tool supports several " "features out of the box. Though keep in mind that B has its own " "substitution logic that can feature interact with the one from debhelper." msgstr "" #. type: =head2 #: debhelper.pod:244 msgid "Executable debhelper config files" msgstr "" #. type: textblock #: debhelper.pod:246 msgid "" "If you need additional flexibility, many of the debhelper tools " "(e.g. L) support executing a config file as a script." msgstr "" #. type: textblock #: debhelper.pod:249 msgid "" "To use this feature, simply mark the config file as executable (e.g. B<< " "chmod +x debian/I.install >>) and the tool will attempt to execute " "it and use the output of the script. In many cases, you can use " "L as interpreter of the config file to retain most of the " "original syntax while getting the additional flexibility you need." msgstr "" #. type: textblock #: debhelper.pod:257 msgid "" "When using executable debhelper config files, please be aware of the " "following:" msgstr "" #. type: textblock #: debhelper.pod:264 msgid "" "The executable config file B exit with success (i.e. its return code " "should indicate success)." msgstr "" #. type: textblock #: debhelper.pod:269 msgid "" "In compatibility level 13+, the output will be subject to substitutions (see " "L) where the tool support these. " "Remember to be careful if your generator I provides substitutions as " "this can cause unnecessary confusion. Notably, the commonly used B " "tool has its own substitution support." msgstr "" #. type: textblock #: debhelper.pod:275 msgid "" "Otherwise, the output will be used exactly as-is. Notably, debhelper will " "I expand wildcards or strip comments or strip whitespace in the output " "it reads. The B tool has an output filter on by default that will " "prune these things out." msgstr "" #. type: textblock #: debhelper.pod:282 msgid "" "If you need the package to build on a file system where you cannot disable " "the executable bit, then you can use L and its B " "script." msgstr "" #. type: =head1 #: debhelper.pod:286 msgid "SHARED DEBHELPER OPTIONS" msgstr "" #. type: textblock #: debhelper.pod:288 msgid "The following command line options are supported by all debhelper programs." msgstr "" #. type: =item #: debhelper.pod:292 msgid "B<-v>, B<--verbose>" msgstr "" #. type: textblock #: debhelper.pod:294 msgid "Verbose mode: show commands that modify the package build directory." msgstr "" #. type: textblock #: debhelper.pod:296 msgid "" "Note that verbose mode may also output other \"internal\" commands that do " "not directly affect the package build directory." msgstr "" #. type: =item #: debhelper.pod:299 dh:307 msgid "B<--no-act>" msgstr "" #. type: textblock #: debhelper.pod:301 msgid "" "Do not really do anything. If used with -v, the result is that the command " "will output what it would have done." msgstr "" #. type: =item #: debhelper.pod:304 msgid "B<-a>, B<--arch>" msgstr "" #. type: textblock #: debhelper.pod:306 msgid "" "Act on architecture dependent packages that should be built for the " "B architecture." msgstr "" #. type: =item #: debhelper.pod:309 msgid "B<-i>, B<--indep>" msgstr "" #. type: textblock #: debhelper.pod:311 msgid "Act on all architecture independent packages." msgstr "" #. type: =item #: debhelper.pod:313 msgid "B<-p>I, B<--package=>I" msgstr "" #. type: textblock #: debhelper.pod:315 msgid "" "Act on the package named I. This option may be specified multiple " "times to make debhelper operate on a given set of packages." msgstr "" #. type: =item #: debhelper.pod:318 msgid "B<-s>, B<--same-arch>" msgstr "" #. type: textblock #: debhelper.pod:320 msgid "Deprecated alias of B<-a>." msgstr "" #. type: textblock #: debhelper.pod:322 dh_install:80 dh_install:89 msgid "This option is removed in compat 12." msgstr "" #. type: =item #: debhelper.pod:324 msgid "B<-N>I, B<--no-package=>I" msgstr "" #. type: textblock #: debhelper.pod:326 msgid "" "Do not act on the specified package even if an B<-a>, B<-i>, or B<-p> option " "lists the package as one that should be acted on." msgstr "" #. type: =item #: debhelper.pod:329 msgid "B<--remaining-packages>" msgstr "" #. type: textblock #: debhelper.pod:331 msgid "" "Do not act on the packages which have already been acted on by this " "debhelper command earlier (i.e. if the command is present in the package " "debhelper log). For example, if you need to call the command with special " "options only for a couple of binary packages, pass this option to the last " "call of the command to process the rest of packages with default settings." msgstr "" #. type: =item #: debhelper.pod:337 msgid "B<-P>I, B<--tmpdir=>I" msgstr "" #. type: textblock #: debhelper.pod:339 msgid "Use I for package build directory. The default is debian/I" msgstr "" #. type: =item #: debhelper.pod:341 msgid "B<--mainpackage=>I" msgstr "" #. type: textblock #: debhelper.pod:343 msgid "" "B: This option has no practical use in compat 15 or later as the " "behaviour it affects is removed in compat 15." msgstr "" #. type: textblock #: debhelper.pod:346 msgid "" "This little-used option changes the package which debhelper considers the " "\"main package\", that is, the first one listed in F, and " "the one for which F files can be used instead of the usual " "F files." msgstr "" #. type: =item #: debhelper.pod:351 msgid "B<-O=>I