[dpkg] 05/05: man: Avoid redundant action list in dpkg invoke hook description
This is an automated email from the git hooks/post-receive script. guillem pushed a commit to branch main in repository dpkg. View the commit online: https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=c312f3a69fa3aaf067c7d819d2532f428cd0bba1 commit c312f3a69fa3aaf067c7d819d2532f428cd0bba1 (HEAD -> main) Author: Guillem Jover AuthorDate: Fri Oct 20 03:20:31 2023 +0200 man: Avoid redundant action list in dpkg invoke hook description Instead of listing all actions then stating when all got added and when some were added later, just attach the versions to the respective lists w/o needing to repeat the actions. --- man/dpkg.pod | 12 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/man/dpkg.pod b/man/dpkg.pod index 5149b12c0..8594e8e71 100644 --- a/man/dpkg.pod +++ b/man/dpkg.pod @@ -970,10 +970,14 @@ co-installable instances with the same version, but different architecture. Set an invoke hook I to be run via “sh -c” before or after the B run for the I, I, I, -I, I, I, I and -I B actions (since dpkg 1.15.4; -I and I actions -since dpkg 1.17.19). This +I, +I and +I +actions (since dpkg 1.15.4), and +I and +I +actions (since dpkg 1.17.19). +This option can be specified multiple times. The order the options are specified is preserved, with the ones from the configuration files taking precedence. The environment variable B is set for the hooks to the -- Dpkg.Org's dpkg
[dpkg] 01/05: man: Use L<> for manual page references
This is an automated email from the git hooks/post-receive script. guillem pushed a commit to branch main in repository dpkg. View the commit online: https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=f9f715c3e75a30bb237a37ab9ba3c01deefde39e commit f9f715c3e75a30bb237a37ab9ba3c01deefde39e Author: Guillem Jover AuthorDate: Fri Oct 20 01:55:17 2023 +0200 man: Use L<> for manual page references This marks few more man page references that got missed due to containing characters not used in the search. Fixes: commit 1af074cf4b2b344e996c52cfdd34d0a6a90efbc1 Changelog: silent --- man/deb-src-symbols.pod | 2 +- man/dpkg-maintscript-helper.pod | 4 ++-- man/dpkg.pod| 2 +- man/dselect.pod | 2 +- man/start-stop-daemon.pod | 2 +- 5 files changed, 6 insertions(+), 6 deletions(-) diff --git a/man/deb-src-symbols.pod b/man/deb-src-symbols.pod index dcea7ab25..bcd21255b 100644 --- a/man/deb-src-symbols.pod +++ b/man/deb-src-symbols.pod @@ -229,7 +229,7 @@ At the moment, B supports three basic pattern types: =item B This pattern is denoted by the I tag. It matches only C++ symbols by -their demangled symbol name (as emitted by B(1) utility). This +their demangled symbol name (as emitted by L utility). This pattern is very handy for matching symbols which mangled names might vary across different architectures while their demangled names remain the same. One group of such symbols is I which have architecture diff --git a/man/dpkg-maintscript-helper.pod b/man/dpkg-maintscript-helper.pod index e9079c914..1ac039da8 100644 --- a/man/dpkg-maintscript-helper.pod +++ b/man/dpkg-maintscript-helper.pod @@ -273,7 +273,7 @@ IB<.dpkg-backup> back to I if required. When using a packaging helper, please check if it has native B integration, which might make your life -easier. See for example B(1). +easier. See for example L. Given that B is used in the B, using it unconditionally requires a pre-dependency to ensure that the @@ -329,4 +329,4 @@ B. =head1 SEE ALSO -B(1). +L. diff --git a/man/dpkg.pod b/man/dpkg.pod index 5146b70ac..89a957427 100644 --- a/man/dpkg.pod +++ b/man/dpkg.pod @@ -1577,7 +1577,7 @@ L, L, L, L, -B(5), +L, and L. diff --git a/man/dselect.pod b/man/dselect.pod index 2c11acfbd..9f309074e 100644 --- a/man/dselect.pod +++ b/man/dselect.pod @@ -671,5 +671,5 @@ broken, it is also much more flexible than the built in access methods. L, L, -B(5), +L, L. diff --git a/man/start-stop-daemon.pod b/man/start-stop-daemon.pod index 25aaa1a12..639f5b38f 100644 --- a/man/start-stop-daemon.pod +++ b/man/start-stop-daemon.pod @@ -317,7 +317,7 @@ code for them to do this themselves. Wait for the background process to send a readiness notification before considering the service started (since version 1.19.3). This implements parts of the systemd readiness protocol, as specified -in the B(3) manual page. +in the L manual page. The following variables are supported: =over -- Dpkg.Org's dpkg
[dpkg] 02/05: doc, man: Use media discs instead of CD-ROM
This is an automated email from the git hooks/post-receive script. guillem pushed a commit to branch main in repository dpkg. View the commit online: https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=3efb9004bea9492ad03396f0f9718cf3f382dbf8 commit 3efb9004bea9492ad03396f0f9718cf3f382dbf8 Author: Guillem Jover AuthorDate: Fri Oct 20 02:57:43 2023 +0200 doc, man: Use media discs instead of CD-ROM The former is more generic and includes any new technology in use, while CD-ROM is very specific and a format that is in disuse. --- dselect/methods/file/setup.sh | 2 +- man/dpkg-scanpackages.pod | 2 +- man/dpkg.pod | 2 +- man/dselect.pod | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/dselect/methods/file/setup.sh b/dselect/methods/file/setup.sh index a7212f49e..027c8c8c0 100755 --- a/dselect/methods/file/setup.sh +++ b/dselect/methods/file/setup.sh @@ -240,7 +240,7 @@ If you overlooked it when downloading you should do get it now and return to this installation procedure when you have done so: you will find one Packages file and one Packages.gz file -- either will do -- in the 'binary-$iarch' subdirectory of each area on the FTP sites and -CD-ROMs. Alternatively (and this will be rather slow) the packages in +media discs. Alternatively (and this will be rather slow) the packages in the distribution area can be scanned - say 'scan' if you want to do so. You need a separate Packages file from each of the distribution areas diff --git a/man/dpkg-scanpackages.pod b/man/dpkg-scanpackages.pod index e0f6f4643..6ed0463c4 100644 --- a/man/dpkg-scanpackages.pod +++ b/man/dpkg-scanpackages.pod @@ -42,7 +42,7 @@ L, L, etc, to tell the user what packages are available for installation. These Packages files are the same as those found on Debian archive sites -and CD-ROMs. You might use +and media discs. You might use B yourself if making a directory of local packages to install on a cluster of machines. diff --git a/man/dpkg.pod b/man/dpkg.pod index 89a957427..d2c01a855 100644 --- a/man/dpkg.pod +++ b/man/dpkg.pod @@ -1506,7 +1506,7 @@ To remove an installed elvis package: =back To install a package, you first need to find it in an archive or -CDROM. The I file shows that the vim package is in section +media disc. The I file shows that the vim package is in section B: =over diff --git a/man/dselect.pod b/man/dselect.pod index 9f309074e..4c815d2b8 100644 --- a/man/dselect.pod +++ b/man/dselect.pod @@ -64,7 +64,7 @@ privileges, packages can be installed, upgraded and removed. Various access methods can be configured to retrieve available package version information and installable packages from package repositories. Depending on the used access method, these repositories can be public -archive servers on the internet, local archive servers or CD-ROMs. +archive servers on the internet, local archive servers or media discs. The recommended access method is I, which is provided by the package L. -- Dpkg.Org's dpkg
[dpkg] branch main updated (8cfadc5a7 -> c312f3a69)
This is an automated email from the git hooks/post-receive script. guillem pushed a change to branch main in repository dpkg. from 8cfadc5a7 po: Update German man pages translation new f9f715c3e man: Use L<> for manual page references new 3efb9004b doc, man: Use media discs instead of CD-ROM new 0c32d5f69 man: Use /media/bdrom instead of /media/cdrom new 4bec54e58 man: Fix grammar in dpkg --force-confdef description new c312f3a69 man: Avoid redundant action list in dpkg invoke hook description The 5 revisions listed above as "new" are entirely new to this repository and will be described in separate emails. The revisions listed as "add" were already present in the repository and have only been added to this reference. Summary of changes: dselect/methods/file/setup.sh | 2 +- man/deb-src-symbols.pod | 2 +- man/dpkg-maintscript-helper.pod | 4 ++-- man/dpkg-scanpackages.pod | 2 +- man/dpkg.pod| 20 man/dselect.pod | 4 ++-- man/start-stop-daemon.pod | 2 +- 7 files changed, 20 insertions(+), 16 deletions(-) -- Dpkg.Org's dpkg
[dpkg] 03/05: man: Use /media/bdrom instead of /media/cdrom
This is an automated email from the git hooks/post-receive script. guillem pushed a commit to branch main in repository dpkg. View the commit online: https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=0c32d5f69198b791eb304156de270014635dfc0c commit 0c32d5f69198b791eb304156de270014635dfc0c Author: Guillem Jover AuthorDate: Fri Oct 20 02:58:51 2023 +0200 man: Use /media/bdrom instead of /media/cdrom Let's keep up with the times. --- man/dpkg.pod | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/man/dpkg.pod b/man/dpkg.pod index d2c01a855..e66779cd6 100644 --- a/man/dpkg.pod +++ b/man/dpkg.pod @@ -1511,7 +1511,7 @@ B: =over - cd /media/cdrom/pool/main/v/vim + cd /media/bdrom/pool/main/v/vim dpkg -i vim_4.5-3.deb =back -- Dpkg.Org's dpkg
[dpkg] 04/05: man: Fix grammar in dpkg --force-confdef description
This is an automated email from the git hooks/post-receive script. guillem pushed a commit to branch main in repository dpkg. View the commit online: https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=4bec54e58883051ab1c0054362c88c0a53217dd1 commit 4bec54e58883051ab1c0054362c88c0a53217dd1 Author: Guillem Jover AuthorDate: Fri Oct 20 03:18:21 2023 +0200 man: Fix grammar in dpkg --force-confdef description --- man/dpkg.pod | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/man/dpkg.pod b/man/dpkg.pod index e66779cd6..5149b12c0 100644 --- a/man/dpkg.pod +++ b/man/dpkg.pod @@ -812,7 +812,7 @@ action is preferred. If a conffile has been modified and the version in the package did change, always choose the default action without prompting. If there is no default action it will stop to ask the user unless B<--force-confnew> or -B<--force-confold> is also been given, in which case it will use +B<--force-confold> is also given, in which case it will use that to decide the final action. =item B: -- Dpkg.Org's dpkg
[dpkg] branch main updated: po: Update German man pages translation
This is an automated email from the git hooks/post-receive script. kreutzm pushed a commit to branch main in repository dpkg. View the commit online: https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=8cfadc5a71eb57e24dacd5874983843debd02e64 The following commit(s) were added to refs/heads/main by this push: new 8cfadc5a7 po: Update German man pages translation 8cfadc5a7 is described below commit 8cfadc5a71eb57e24dacd5874983843debd02e64 Author: Helge Kreutzmann AuthorDate: Thu Oct 19 21:14:21 2023 +0200 po: Update German man pages translation --- man/po/de.po | 1091 +- 1 file changed, 701 insertions(+), 390 deletions(-) diff --git a/man/po/de.po b/man/po/de.po index 09f6e846d..1bbacd666 100644 --- a/man/po/de.po +++ b/man/po/de.po @@ -13,8 +13,8 @@ msgid "" msgstr "" "Project-Id-Version: dpkg-man 1.22.0\n" "Report-Msgid-Bugs-To: debian-d...@lists.debian.org\n" -"POT-Creation-Date: 2023-10-18 15:43+0200\n" -"PO-Revision-Date: 2023-10-18 16:31+0200\n" +"POT-Creation-Date: 2023-10-19 18:20+0200\n" +"PO-Revision-Date: 2023-10-19 21:11+0200\n" "Last-Translator: Helge Kreutzmann \n" "Language-Team: German \n" "Language: de\n" @@ -265,12 +265,12 @@ msgid "" "Typically, this is the original package's version number in whatever form " "the program's author uses. It may also include a Debian revision number " "(for non-native packages). The exact format and sorting algorithm are " -"described in B(7)." +"described in L." msgstr "" "Typischerweise ist das die Original-Paketversionsnummer, in der Form, die " "der Programmautor verwendet. Es kann auch eine Debian-Revisionsnummer " "enthalten (für nicht aus Debian stammende Pakete). Das genaue Format und der " -"Sortieralgorithmus sind in B(7) beschrieben." +"Sortieralgorithmus sind in L beschrieben." #. type: =item #: deb-buildinfo.pod @@ -384,10 +384,10 @@ msgstr "B I" #: deb-buildinfo.pod msgid "" "The date the package was built. It must be in the same format as the date " -"in a B(5) entry." +"in a L entry." msgstr "" "Das Datum, an dem das Paket letztmalig gebaut wurde. Es muss im gleichen " -"Format wie in einem Eintrag bei B(5) sein." +"Format wie in einem Eintrag bei L sein." #. type: =item #: deb-buildinfo.pod @@ -654,9 +654,9 @@ msgstr "SIEHE AUCH" #. type: textblock #: deb-buildinfo.pod msgid "" -"L, B(5), B(7), B(1)." +"L, L, L, L." msgstr "" -"L, B(5), B(7), B(1)." +"L, L, L, L." #. type: textblock #: deb-changelog.pod @@ -706,7 +706,7 @@ msgid "" " [optional blank line(s), stripped]\n" " * I\n" "I\n" -" [blank line(s), included in B(1) output]\n" +" [blank line(s), included in L output]\n" " * I\n" " [optional blank line(s), stripped]\n" " -- I > I\n" @@ -717,7 +717,7 @@ msgstr "" " [optionale leere Zeile(n), entfernt, stripped]\n" " * I<Änderungsdetails>\n" "I\n" -" [leere Zeile(n), in der Ausgabe von B(1) enthalten]\n" +" [leere Zeile(n), in der Ausgabe von L enthalten]\n" " * I\n" " [optionale leere Zeile(n), entfernt]\n" " -- I > I\n" @@ -751,13 +751,13 @@ msgstr "" msgid "" "I lists zero or more comma-separated I=I items. " "Each keyword can contain only minus and case insensitive alphanumeric " -"characters, as they need to be mapped to B(5) field names. The only " +"characters, as they need to be mapped to L field names. The only " "Is currently supported by B are:" msgstr "" "I listet eine oder mehrere durch Kommata getrennte " "I=I-Objekte auf. Jeder Schlüssel darf nur Minus und " "alphanumerische Zeichen (Groß-/Kleinschreibung egal) enthalten, da diese auf " -"B(5)-Feldnamen abgebildet werden müssen. Die einzigen von B " +"L-Feldnamen abgebildet werden müssen. Die einzigen von B " "derzeit verstandenen I sind:" #. type: =item @@ -1139,11 +1139,11 @@ msgstr "" #. type: textblock #: deb-changelog.pod msgid "" -"B(5), B(7), B(5), B(1)." +"L, L, L, L." msgstr "" -"B(5), B(7), B(5), B(1)." +"L, L, L, L." #. type: textblock #: deb-changes.pod @@ -1210,10 +1210,10 @@ msgstr "B I (verpflichtend)" #: deb-changes.pod msgid "" "The date the package was built or last edited. It must be in the same " -"format as the date in a B(5) entry." +"format as the date in a L entry." msgstr "" "Das Datum, an dem das Paket letztmalig gebaut oder bearbeitet wurde. Es muss " -"im gleichen Format wie in einem Eintrag bei B(5) sein." +"im gleichen Format wie in einem Eintrag bei L sein." #. type: textblock #: deb-changes.pod @@ -1515,8 +1515,8 @@ msgstr "" #. type: textblock #: deb-changes.pod -msgid "L, B(5), B(7)." -msgstr "L, B(5), B(7)." +msgid "L, L, L." +msgstr "L, L, L." #. type: textblock #: deb-conffiles.pod @@ -1602,8 +1602,8 @@ msgstr "" #. type: textblock #: deb-conffiles.pod -msgid "B(1), B(1)." -msgstr "B(1), B(1)." +msgid "L, L." +msgstr "L, L." #. type: textblock #: deb-control.pod @@ -1621,11 +162
[dpkg] 05/09: doc, man: Use L markup for inter link references
This is an automated email from the git hooks/post-receive script. guillem pushed a commit to branch main in repository dpkg. View the commit online: https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=e3c37b23062db8707dae0cbda7fce41595e19821 commit e3c37b23062db8707dae0cbda7fce41595e19821 Author: Guillem Jover AuthorDate: Sun Sep 17 23:27:30 2023 +0200 doc, man: Use L markup for inter link references This is used to refer to a section within the same or an external manual page. --- man/deb-src-symbols.pod | 12 ++-- man/dpkg-buildflags.pod | 8 man/dpkg-source.pod | 2 +- man/dpkg.pod| 2 +- man/update-alternatives.pod | 2 +- scripts/Dpkg/Changelog.pm | 4 ++-- 6 files changed, 15 insertions(+), 15 deletions(-) diff --git a/man/deb-src-symbols.pod b/man/deb-src-symbols.pod index 0d729e08a..d69b44772 100644 --- a/man/deb-src-symbols.pod +++ b/man/deb-src-symbols.pod @@ -40,7 +40,7 @@ see L. Comments are supported in template symbol files. Any line with ‘#’ as the first character is a comment except if it starts with ‘#include’ -(see section B). +(see section L). Lines starting with ‘#MISSING:’ are special comments documenting symbols that have disappeared. @@ -59,7 +59,7 @@ Symbol tagging is useful for marking symbols that are special in some way. Any symbol can have an arbitrary number of tags associated with it. While all tags are parsed and stored, only some of them are understood by B and trigger special handling of the symbols. See -subsection B for reference of these tags. +subsection L for reference of these tags. Tag specification comes right before the symbol name (no whitespace is allowed in between). It always starts with an opening bracket B<(>, ends with a @@ -183,17 +183,17 @@ supported since dpkg 1.15.3). =item B -Denotes I symbol pattern. See B subsection +Denotes I symbol pattern. See L subsection below. =item B -Denotes I (symbol version) symbol pattern. See B (symbol version) symbol pattern. See L subsection below. =item B -Denotes I symbol pattern. See B subsection +Denotes I symbol pattern. See L subsection below. =back @@ -213,7 +213,7 @@ higher level. However, if the failure is undesired, the pattern may be marked with the I tag. Then if the pattern does not match anything, it will only appear in the diff as MISSING. Moreover, like any symbol, the pattern may be limited to the specific architectures with the I tag. Please -refer to B subsection above for more information. +refer to L subsection above for more information. Patterns are an extension of the B(5) format hence they are only valid in symbol file templates. Pattern specification syntax is not any diff --git a/man/dpkg-buildflags.pod b/man/dpkg-buildflags.pod index 2c382cdfc..45f5eaf38 100644 --- a/man/dpkg-buildflags.pod +++ b/man/dpkg-buildflags.pod @@ -50,12 +50,12 @@ where B<$XDG_CONFIG_HOME> defaults to B<$HOME/.config>; =item 3. temporarily by the user with environment variables (see section -B); +L); =item 4. dynamically by the package maintainer with environment variables set via -B (see section B). +B (see section L). =back @@ -103,7 +103,7 @@ one flag per line separated from its value by an equal sign =item B<--list> Print the list of flags supported by the current vendor -(one per line). See the B section for more +(one per line). See the L section for more information about them. =item B<--status> @@ -745,7 +745,7 @@ These variables can be used by a user or maintainer to disable/enable various area features that affect build flags. The B variable overrides any setting in the B feature areas. -See the B section for details. +See the L section for details. =item B diff --git a/man/dpkg-source.pod b/man/dpkg-source.pod index 2997c0d66..1e969b591 100644 --- a/man/dpkg-source.pod +++ b/man/dpkg-source.pod @@ -91,7 +91,7 @@ the format indicated in B, “1.0”. The fallback to “1.0” is deprecated and will be removed at some point in the future, you should always document the desired source format -in B. See section B +in B. See section L for an extensive description of the various source package formats. =item B<--print-format> I diff --git a/man/dpkg.pod b/man/dpkg.pod index b7d056fab..f7391303e 100644 --- a/man/dpkg.pod +++ b/man/dpkg.pod @@ -1434,7 +1434,7 @@ List of available packages. Statuses of available packages. This file contains information about whether a package is marked for removing or not, whether it is -installed or not, etc. See section B +installed or not, etc. See section L for more info. The status file is backed up daily in I<%BACKUPSDIR%>. It can be diff --git a/man/update-alternatives.pod b/man/update-alternatives.pod index c30bdad28..7a6321e3f 100644 --- a/man/update-alternatives.pod +++ b/man/update-alternatives.pod @@ -361,7 +361,7 @@ them accordingly (since version 1.15.0). Display information about the link group like B<
[dpkg] 06/09: doc: Use name() POD syntax instead of C<>, B<> or L<> for function names
This is an automated email from the git hooks/post-receive script. guillem pushed a commit to branch main in repository dpkg. View the commit online: https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=d130b0a6464fb18b6e97270845cecee0a10531b1 commit d130b0a6464fb18b6e97270845cecee0a10531b1 Author: Guillem Jover AuthorDate: Sun Sep 17 23:37:35 2023 +0200 doc: Use name() POD syntax instead of C<>, B<> or L<> for function names The POD parsers know what to do automatically for this kind of syntax, and the markup is unnecessary. --- scripts/Dpkg/Changelog.pm | 4 ++-- scripts/Dpkg/Compression.pm| 12 ++-- scripts/Dpkg/Compression/FileHandle.pm | 16 scripts/Dpkg/Compression/Process.pm| 20 ++-- 4 files changed, 26 insertions(+), 26 deletions(-) diff --git a/scripts/Dpkg/Changelog.pm b/scripts/Dpkg/Changelog.pm index 121509d17..8a925c5ec 100644 --- a/scripts/Dpkg/Changelog.pm +++ b/scripts/Dpkg/Changelog.pm @@ -107,7 +107,7 @@ Returns the number of changelog entries that have been parsed with success. =item $c->reset_parse_errors() Can be used to delete all information about errors occurred during -previous L runs. +previous parse() runs. =cut @@ -139,7 +139,7 @@ sub parse_error { =item $c->get_parse_errors() -Returns all error messages from the last L run. +Returns all error messages from the last parse() run. If called in scalar context returns a human readable string representation. If called in list context returns an array of arrays. Each of these arrays contains diff --git a/scripts/Dpkg/Compression.pm b/scripts/Dpkg/Compression.pm index de58e336c..9e6074d18 100644 --- a/scripts/Dpkg/Compression.pm +++ b/scripts/Dpkg/Compression.pm @@ -207,7 +207,7 @@ sub compression_get_file_extension { =item $comp = compression_get_default() Return the default compression method. It is "xz" unless -C has been used to change it. +compression_set_default() has been used to change it. =cut @@ -235,7 +235,7 @@ Return the global default compression level used when compressing data if it has been set, otherwise the default level for the default compressor. It's "9" for "gzip" and "bzip2", "6" for "xz" and "lzma", unless -C has been used to change it. +compression_set_default_level() has been used to change it. =cut @@ -251,7 +251,7 @@ sub compression_get_default_level { Change the global default compression level. Passing undef as the level will reset it to the global default compressor specific default, otherwise errors -out if the level is not valid (see C). +out if the level is not valid (see compression_is_valid_level()). =cut @@ -286,7 +286,7 @@ sub compression_get_level { Change the compression level for a specific compressor. Passing undef as the level will reset it to the specific default compressor level, otherwise -errors out if the level is not valid (see C). +errors out if the level is not valid (see compression_is_valid_level()). =cut @@ -341,7 +341,7 @@ sub compression_set_threads { =item @exec = compression_get_cmdline_compress($comp) -Returns a list ready to be passed to C, its first element is the +Returns a list ready to be passed to exec(), its first element is the program name for compression and the following elements are parameters for the program. @@ -384,7 +384,7 @@ sub compression_get_cmdline_compress { =item @exec = compression_get_cmdline_decompress($comp) -Returns a list ready to be passed to C, its first element is the +Returns a list ready to be passed to exec(), its first element is the program name for decompression and the following elements are parameters for the program. diff --git a/scripts/Dpkg/Compression/FileHandle.pm b/scripts/Dpkg/Compression/FileHandle.pm index b29e0ecec..6141ed881 100644 --- a/scripts/Dpkg/Compression/FileHandle.pm +++ b/scripts/Dpkg/Compression/FileHandle.pm @@ -59,11 +59,11 @@ Dpkg::Compression::FileHandle - class dealing transparently with file compressio Dpkg::Compression::FileHandle is a class that can be used like any filehandle and that deals transparently with compressed files. By default, the compression scheme is guessed from the filename -but you can override this behavior with the method C. +but you can override this behavior with the method set_compression(). If you don't open the file explicitly, it will be auto-opened on the first read or write operation based on the filename set at creation time -(or later with the C method). +(or later with the set_filename() method). Once a file has been opened, the filehandle must be closed before being able to open another file. @@ -92,11 +92,11 @@ use parent qw(IO::File Tie::Handle); The standard functions acting on filehandles should accept a Dpkg::Compression::FileHandle object transparently including -C (only when using the variant with 3 parameters), C, -C, C, C, C, C, C, C, -C, C, C, C, C, C, C. +open() (only when using the var
[dpkg] 08/09: doc: Simplify references in CHANGES sections
This is an automated email from the git hooks/post-receive script. guillem pushed a commit to branch main in repository dpkg. View the commit online: https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=a8aca8bc17e617c5308bf408a94f3296d4da0918 commit a8aca8bc17e617c5308bf408a94f3296d4da0918 Author: Guillem Jover AuthorDate: Thu Oct 19 09:38:58 2023 +0200 doc: Simplify references in CHANGES sections Remove unneeded module namespace, or replace it with an actual variable, as it is done in the rest of the documentation for methods. --- scripts/Dpkg/Deps.pm| 12 ++-- scripts/Dpkg/Deps/KnownFacts.pm | 4 ++-- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/scripts/Dpkg/Deps.pm b/scripts/Dpkg/Deps.pm index e6ea91017..340f6f227 100644 --- a/scripts/Dpkg/Deps.pm +++ b/scripts/Dpkg/Deps.pm @@ -453,28 +453,28 @@ provide. =head2 Version 1.07 (dpkg 1.20.0) -New option: Add virtual option to Dpkg::Deps::deps_parse(). +New option: Add virtual option to deps_parse(). =head2 Version 1.06 (dpkg 1.18.7; module version bumped on dpkg 1.18.24) -New option: Add tests_dep option to Dpkg::Deps::deps_parse(). +New option: Add tests_dep option to deps_parse(). =head2 Version 1.05 (dpkg 1.17.14) -New function: Dpkg::Deps::deps_iterate(). +New function: deps_iterate(). =head2 Version 1.04 (dpkg 1.17.10) New options: Add use_profiles, build_profiles, reduce_profiles and -reduce_restrictions to Dpkg::Deps::deps_parse(). +reduce_restrictions to deps_parse(). =head2 Version 1.03 (dpkg 1.17.0) -New option: Add build_arch option to Dpkg::Deps::deps_parse(). +New option: Add build_arch option to deps_parse(). =head2 Version 1.02 (dpkg 1.17.0) -New function: Dpkg::Deps::deps_concat() +New function: deps_concat() =head2 Version 1.01 (dpkg 1.16.1) diff --git a/scripts/Dpkg/Deps/KnownFacts.pm b/scripts/Dpkg/Deps/KnownFacts.pm index 5ef7e7c69..6ca6d1fed 100644 --- a/scripts/Dpkg/Deps/KnownFacts.pm +++ b/scripts/Dpkg/Deps/KnownFacts.pm @@ -201,10 +201,10 @@ Remove method: $facts->check_package(). =head2 Version 1.01 (dpkg 1.16.1) -New option: Dpkg::Deps::KnownFacts->add_installed_package() now accepts 2 +New option: $facts->add_installed_package() now accepts 2 supplementary parameters ($arch and $multiarch). -Deprecated method: Dpkg::Deps::KnownFacts->check_package() is obsolete, +Deprecated method: $facts->check_package() is obsolete, it should not have been part of the public API. =head2 Version 1.00 (dpkg 1.15.6) -- Dpkg.Org's dpkg
[dpkg] 07/09: doc: Use name() POD syntax instead of a bare function name
This is an automated email from the git hooks/post-receive script. guillem pushed a commit to branch main in repository dpkg. View the commit online: https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=94abc18c8310a40415384bd42fc8cdae865f168b commit 94abc18c8310a40415384bd42fc8cdae865f168b Author: Guillem Jover AuthorDate: Thu Oct 19 01:19:40 2023 +0200 doc: Use name() POD syntax instead of a bare function name The POD parsers know what to do automatically for this kind of syntax. --- scripts/Dpkg/Changelog.pm| 2 +- scripts/Dpkg/Control/HashCore.pm | 2 +- scripts/Dpkg/Control/HashCore/Tie.pm | 2 +- scripts/Dpkg/Deps/AND.pm | 2 +- scripts/Dpkg/Deps/OR.pm | 2 +- scripts/Dpkg/Deps/Union.pm | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/scripts/Dpkg/Changelog.pm b/scripts/Dpkg/Changelog.pm index 8a925c5ec..4a5631183 100644 --- a/scripts/Dpkg/Changelog.pm +++ b/scripts/Dpkg/Changelog.pm @@ -24,7 +24,7 @@ Dpkg::Changelog - base class to implement a changelog parser Dpkg::Changelog is a class representing a changelog file as an array of changelog entries (Dpkg::Changelog::Entry). -By deriving this class and implementing its parse method, you +By deriving this class and implementing its parse() method, you add the ability to fill this object with changelog entries. =cut diff --git a/scripts/Dpkg/Control/HashCore.pm b/scripts/Dpkg/Control/HashCore.pm index dd6ac80e9..f66a088ee 100644 --- a/scripts/Dpkg/Control/HashCore.pm +++ b/scripts/Dpkg/Control/HashCore.pm @@ -24,7 +24,7 @@ Dpkg::Control::HashCore - parse and manipulate a stanza of deb822 fields The Dpkg::Control::Hash class is a hash-like representation of a set of RFC822-like fields. The fields names are case insensitive and are always -capitalized the same when output (see field_capitalize function in +capitalized the same when output (see field_capitalize() function in Dpkg::Control::Fields). The order in which fields have been set is remembered and is used to be able to dump back the same content. The output order can also be diff --git a/scripts/Dpkg/Control/HashCore/Tie.pm b/scripts/Dpkg/Control/HashCore/Tie.pm index 7b75e7d42..c7ec999b6 100644 --- a/scripts/Dpkg/Control/HashCore/Tie.pm +++ b/scripts/Dpkg/Control/HashCore/Tie.pm @@ -24,7 +24,7 @@ Dpkg::Control::HashCore::Tie - ties a Dpkg::Control::Hash object This module provides a class that is used to tie a hash. It implements hash-like functions by normalizing the name of fields received -in keys (using Dpkg::Control::Fields::field_capitalize). +in keys (using Dpkg::Control::Fields::field_capitalize()). It also stores the order in which fields have been added in order to be able to dump them in the same order. But the order information is stored in a parent object of type Dpkg::Control. diff --git a/scripts/Dpkg/Deps/AND.pm b/scripts/Dpkg/Deps/AND.pm index 49bef7e41..7c7ed6474 100644 --- a/scripts/Dpkg/Deps/AND.pm +++ b/scripts/Dpkg/Deps/AND.pm @@ -45,7 +45,7 @@ use parent qw(Dpkg::Deps::Multiple); =item $dep->output([$fh]) -The output method uses ", " to join the list of sub-dependencies. +The output() method uses ", " to join the list of sub-dependencies. =cut diff --git a/scripts/Dpkg/Deps/OR.pm b/scripts/Dpkg/Deps/OR.pm index 2a0d32da0..a65398260 100644 --- a/scripts/Dpkg/Deps/OR.pm +++ b/scripts/Dpkg/Deps/OR.pm @@ -45,7 +45,7 @@ use parent qw(Dpkg::Deps::Multiple); =item $dep->output([$fh]) -The output method uses " | " to join the list of sub-dependencies. +The output() method uses " | " to join the list of sub-dependencies. =cut diff --git a/scripts/Dpkg/Deps/Union.pm b/scripts/Dpkg/Deps/Union.pm index cc480eb1b..5b18f106e 100644 --- a/scripts/Dpkg/Deps/Union.pm +++ b/scripts/Dpkg/Deps/Union.pm @@ -45,7 +45,7 @@ use parent qw(Dpkg::Deps::Multiple); =item $dep->output([$fh]) -The output method uses ", " to join the list of relationships. +The output() method uses ", " to join the list of relationships. =cut -- Dpkg.Org's dpkg
[dpkg] branch main updated (2d87ed673 -> 1af074cf4)
This is an automated email from the git hooks/post-receive script. guillem pushed a change to branch main in repository dpkg. from 2d87ed673 po: Update German programs translation new 013efc084 doc, man: Use manual page instead of manpage new 6a2e7711d doc, man: Use field name or field-name instead of fieldname new 644a779f0 man: Use web interface instead of both terms concatenated new 73a94823e man: Hyphenate 32-bit and 64-bit new e3c37b230 doc, man: Use L markup for inter link references new d130b0a64 doc: Use name() POD syntax instead of C<>, B<> or L<> for function names new 94abc18c8 doc: Use name() POD syntax instead of a bare function name new a8aca8bc1 doc: Simplify references in CHANGES sections new 1af074cf4 doc, man: Use L<> for manual page references The 9 revisions listed above as "new" are entirely new to this repository and will be described in separate emails. The revisions listed as "add" were already present in the repository and have only been added to this reference. Summary of changes: TODO | 2 +- debian/README.bug-usertags | 2 +- man/deb-buildinfo.pod | 10 +++ man/deb-changelog.pod | 12 man/deb-changes.pod| 8 +++--- man/deb-conffiles.pod | 4 +-- man/deb-control.pod| 16 +-- man/deb-extra-override.pod | 6 ++-- man/deb-md5sums.pod| 6 ++-- man/deb-old.pod| 8 +++--- man/deb-origin.pod | 2 +- man/deb-override.pod | 6 ++-- man/deb-postinst.pod | 2 +- man/deb-postrm.pod | 2 +- man/deb-preinst.pod| 2 +- man/deb-prerm.pod | 2 +- man/deb-shlibs.pod | 8 +++--- man/deb-split.pod | 4 +-- man/deb-src-control.pod| 36 +++ man/deb-src-files.pod | 4 +-- man/deb-src-rules.pod | 16 +-- man/deb-src-symbols.pod| 30 ++-- man/deb-substvars.pod | 22 +++--- man/deb-symbols.pod| 8 +++--- man/deb-triggers.pod | 4 +-- man/deb-version.pod| 6 ++-- man/deb.pod| 26 - man/deb822.pod | 2 +- man/dpkg-architecture.pod | 8 +++--- man/dpkg-build-api.pod | 2 +- man/dpkg-buildflags.pod| 10 +++ man/dpkg-buildpackage.pod | 18 ++-- man/dpkg-deb.pod | 18 ++-- man/dpkg-distaddfile.pod | 2 +- man/dpkg-divert.pod| 6 ++-- man/dpkg-genbuildinfo.pod | 4 +-- man/dpkg-genchanges.pod| 14 - man/dpkg-gencontrol.pod| 12 man/dpkg-gensymbols.pod| 16 +-- man/dpkg-mergechangelogs.pod | 2 +- man/dpkg-name.pod | 14 - man/dpkg-parsechangelog.pod| 8 +++--- man/dpkg-query.pod | 4 +-- man/dpkg-scanpackages.pod | 28 +- man/dpkg-scansources.pod | 16 +-- man/dpkg-shlibdeps.pod | 12 man/dpkg-source.pod| 26 - man/dpkg-split.pod | 10 +++ man/dpkg-statoverride.pod | 4 +-- man/dpkg-trigger.pod | 4 +-- man/dpkg-vendor.pod| 2 +- man/dpkg.cfg.pod | 2 +- man/dpkg.pod | 52 +- man/dsc.pod| 14 - man/dselect.cfg.pod| 2 +- man/dselect.pod| 24 man/start-stop-daemon.pod | 4 +-- man/update-alternatives.pod| 12 scripts/Dpkg/Arch.pm | 2 +- scripts/Dpkg/Build/Info.pm | 4 +-- scripts/Dpkg/BuildAPI.pm | 2 +- scripts/Dpkg/BuildFlags.pm | 6 ++-- scripts/Dpkg/Changelog.pm | 34 +++--- scripts/Dpkg/Changelog/Debian.pm | 10 +++ scripts/Dpkg/Changelog/Entry.pm| 4 +-- scripts/Dpkg/Changelog/Entry/Debian.pm | 6 ++-- scripts/Dpkg/Changelog/Parse.pm| 4 +-- scripts/Dpkg/Checksums.pm | 6 ++-- scripts/Dpkg/Compression.pm| 12 scripts/Dpkg/Compression/FileHandle.pm | 20 ++--- scripts/Dpkg/Compression/Process.pm| 24 scripts/Dpkg/Control.pm| 4 +-- scripts/Dpkg/Control/Changelog.pm | 2 +- scripts/Dpkg/Control/Fields.pm | 6 ++--
[dpkg] 01/09: doc, man: Use manual page instead of manpage
This is an automated email from the git hooks/post-receive script. guillem pushed a commit to branch main in repository dpkg. View the commit online: https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=013efc0843cb776f16ab5aa325e690f42842d3ec commit 013efc0843cb776f16ab5aa325e690f42842d3ec Author: Guillem Jover AuthorDate: Sun Sep 17 04:07:22 2023 +0200 doc, man: Use manual page instead of manpage --- TODO| 2 +- debian/README.bug-usertags | 2 +- man/deb-src-control.pod | 2 +- man/dsc.pod | 2 +- man/dselect.pod | 2 +- man/update-alternatives.pod | 2 +- utils/start-stop-daemon.c | 2 +- 7 files changed, 7 insertions(+), 7 deletions(-) diff --git a/TODO b/TODO index 1b789389b..8f4647964 100644 --- a/TODO +++ b/TODO @@ -61,7 +61,7 @@ Tasks - Add fnmatch, IRIX5 doesn't have it. * Man pages: - - Add example to dpkg-scanfoo manpages? + - Add example to dpkg-scanfoo manual pages? - Merge synopsis lines in dpkg-triggers. - Check all command vs action. - Check usage of '|' instead of ', '. diff --git a/debian/README.bug-usertags b/debian/README.bug-usertags index eee63cf30..68ea1efdc 100644 --- a/debian/README.bug-usertags +++ b/debian/README.bug-usertags @@ -39,7 +39,7 @@ l10n New or updated translations and bugs affecting translation. Include the language code in the tag, e.g. [INTL:cy_GB]. docDocumentation bugs, including --help, program output - and manpages. + and manual pages. Program tags diff --git a/man/deb-src-control.pod b/man/deb-src-control.pod index b68273ad1..7e1d69f6a 100644 --- a/man/deb-src-control.pod +++ b/man/deb-src-control.pod @@ -411,7 +411,7 @@ package. These fields declare relationships between packages. They are discussed in the B(5) -manpage. +manual page. When these fields are found in I they can also end with a trailing comma (since dpkg 1.10.14), have architecture specifications and restriction formulas which will all get reduced when generating the fields diff --git a/man/dsc.pod b/man/dsc.pod index 03c417565..9faf33569 100644 --- a/man/dsc.pod +++ b/man/dsc.pod @@ -201,7 +201,7 @@ test dependencies, each source package would need to be unpacked. These fields declare relationships between the source package and packages used to build it. -They are discussed in the B(5) manpage. +They are discussed in the B(5) manual page. =item B diff --git a/man/dselect.pod b/man/dselect.pod index e704a1bbe..425864265 100644 --- a/man/dselect.pod +++ b/man/dselect.pod @@ -303,7 +303,7 @@ at easing package management and administration, it is only instrumental in doing so and cannot be assumed to be a sufficient substitute for administrator skill and understanding. The user is required to be familiar with the concepts underlying the Debian packaging system. -In case of doubt, consult the B(1) manpage and the distribution +In case of doubt, consult the B(1) manual page and the distribution policy. Unless B is run in expert diff --git a/man/update-alternatives.pod b/man/update-alternatives.pod index 47a36df2c..c30bdad28 100644 --- a/man/update-alternatives.pod +++ b/man/update-alternatives.pod @@ -602,7 +602,7 @@ if you do not find them so, please report this as a bug. There are several packages which provide a text editor compatible with B, for example B and B. Which one is used is controlled by the link group B, which includes links for the -program itself and the associated manpage. +program itself and the associated manual page. To display the available packages which provide B and the current setting for it, use the B<--display> action: diff --git a/utils/start-stop-daemon.c b/utils/start-stop-daemon.c index 2fd41ebcb..743afeee9 100644 --- a/utils/start-stop-daemon.c +++ b/utils/start-stop-daemon.c @@ -1872,7 +1872,7 @@ pid_is_exec(pid_t pid, const struct stat *esb) else { /* Tests indicate that this never happens, since * kvm_getargv itself cuts of tailing stuff. This is -* not what the manpage says, however. */ +* not what the manual page says, however. */ strncpy(buf, *pid_argv_p, (end_argv_0_p - start_argv_0_p)); buf[(end_argv_0_p - start_argv_0_p) + 1] = '\0'; start_argv_0_p = buf; -- Dpkg.Org's dpkg
[dpkg] 02/09: doc, man: Use field name or field-name instead of fieldname
This is an automated email from the git hooks/post-receive script. guillem pushed a commit to branch main in repository dpkg. View the commit online: https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=6a2e7711d25e1e17c218f98e004b38396ba67181 commit 6a2e7711d25e1e17c218f98e004b38396ba67181 Author: Guillem Jover AuthorDate: Sun Sep 17 04:10:30 2023 +0200 doc, man: Use field name or field-name instead of fieldname For symbols in code fieldname is appropriate, but for documentation let's write the more correct «field name» instead. --- man/deb-src-control.pod| 4 ++-- man/deb-substvars.pod | 8 scripts/Dpkg/Control/Fields.pm | 4 ++-- scripts/Dpkg/Control/FieldsCore.pm | 2 +- 4 files changed, 9 insertions(+), 9 deletions(-) diff --git a/man/deb-src-control.pod b/man/deb-src-control.pod index 7e1d69f6a..18b0da233 100644 --- a/man/deb-src-control.pod +++ b/man/deb-src-control.pod @@ -37,11 +37,11 @@ This file contains at least 2 stanzas, separated by a blank line. The first stanza lists all information about the source package in general, while each following stanza describes exactly one binary package. Each stanza consists of at least one field. -A field starts with a fieldname, such as B or B +A field starts with a field name, such as B or B (case insensitive), followed by a colon, the body of the field (case sensitive unless stated otherwise) and a newline. Multi-line fields are also allowed, but each supplementary line, without a -fieldname, should start with at least one space. The content of the multi-line +field name, should start with at least one space. The content of the multi-line fields is generally joined to a single line by the tools (except in the case of the B diff --git a/man/deb-substvars.pod b/man/deb-substvars.pod index 5b74c5df8..a8d98efb4 100644 --- a/man/deb-substvars.pod +++ b/man/deb-substvars.pod @@ -184,19 +184,19 @@ is copied into the B control file field. -=item BI +=item BI The value of the source stanza field -I +I (which must be given in the canonical capitalization; since dpkg 1.18.11). Setting these variables has no effect other than on places where they are expanded explicitly. These variables are only available when generating binary control files. -=item BI +=item BI The value of the output field -I +I (which must be given in the canonical capitalization). Setting these variables has no effect other than on places where they are expanded explicitly. diff --git a/scripts/Dpkg/Control/Fields.pm b/scripts/Dpkg/Control/Fields.pm index 8743dc976..a58356699 100644 --- a/scripts/Dpkg/Control/Fields.pm +++ b/scripts/Dpkg/Control/Fields.pm @@ -21,9 +21,9 @@ Dpkg::Control::Fields - manage (list of official) control fields =head1 DESCRIPTION -The module contains a list of vendor-neutral and vendor-specific fieldnames +The module contains a list of vendor-neutral and vendor-specific field names with associated meta-data explaining in which type of control information -they are allowed. The vendor-neutral fieldnames and all functions are +they are allowed. The vendor-neutral field names and all functions are inherited from Dpkg::Control::FieldsCore. =cut diff --git a/scripts/Dpkg/Control/FieldsCore.pm b/scripts/Dpkg/Control/FieldsCore.pm index 32f2c1041..4e213e294 100644 --- a/scripts/Dpkg/Control/FieldsCore.pm +++ b/scripts/Dpkg/Control/FieldsCore.pm @@ -21,7 +21,7 @@ Dpkg::Control::FieldsCore - manage (list of official) control fields =head1 DESCRIPTION -The modules contains a list of fieldnames with associated meta-data explaining +The modules contains a list of field names with associated meta-data explaining in which type of control information they are allowed. The types are the CTRL_* constants exported by Dpkg::Control. -- Dpkg.Org's dpkg
[dpkg] 04/09: man: Hyphenate 32-bit and 64-bit
This is an automated email from the git hooks/post-receive script. guillem pushed a commit to branch main in repository dpkg. View the commit online: https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=73a94823ea1a2d7428294606a151aab684cbc6a3 commit 73a94823ea1a2d7428294606a151aab684cbc6a3 Author: Guillem Jover AuthorDate: Sun Sep 17 04:14:26 2023 +0200 man: Hyphenate 32-bit and 64-bit --- man/deb-src-symbols.pod | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/man/deb-src-symbols.pod b/man/deb-src-symbols.pod index a5c957703..0d729e08a 100644 --- a/man/deb-src-symbols.pod +++ b/man/deb-src-symbols.pod @@ -236,7 +236,7 @@ group of such symbols is I which have architecture specific offsets embedded in their mangled names. A common instance of this case is a virtual destructor which under diamond inheritance needs a non-virtual thunk symbol. For example, even if _ZThn8_N3NSB6ClassDD1Ev@Base on -32bit architectures will probably be _ZThn16_N3NSB6ClassDD1Ev@Base on 64bit +32-bit architectures will probably be _ZThn16_N3NSB6ClassDD1Ev@Base on 64-bit ones, it can be matched with a single I pattern: libdummy.so.1 libdummy1 #MINVER# @@ -357,8 +357,8 @@ to create a common I.symbols file which includes architecture specific symbol files: common_symbol1@Base 1.0 - (arch=amd64 ia64 alpha)#include "package.symbols.64bit" - (arch=!amd64 !ia64 !alpha)#include "package.symbols.32bit" + (arch=amd64 ia64 alpha)#include "package.symbols.64-bit" + (arch=!amd64 !ia64 !alpha)#include "package.symbols.32-bit" common_symbol2@Base 1.0 =back -- Dpkg.Org's dpkg
[dpkg] 03/09: man: Use web interface instead of both terms concatenated
This is an automated email from the git hooks/post-receive script. guillem pushed a commit to branch main in repository dpkg. View the commit online: https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=644a779f034ad47cd581da04e65e2953a072a63c commit 644a779f034ad47cd581da04e65e2953a072a63c Author: Guillem Jover AuthorDate: Sun Sep 17 04:11:46 2023 +0200 man: Use web interface instead of both terms concatenated --- man/deb-src-control.pod | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/man/deb-src-control.pod b/man/deb-src-control.pod index 18b0da233..c559689e7 100644 --- a/man/deb-src-control.pod +++ b/man/deb-src-control.pod @@ -170,7 +170,7 @@ of the package, such as the main branch or the trunk. =item B I -The I of a webinterface to browse the Version Control System +The I of a web interface to browse the Version Control System repository. =item B I -- Dpkg.Org's dpkg