From cfe5e3905201349e9cf3f95d52ff4bd100bde37d Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 14 Apr 2024 21:10:49 +0200 Subject: Adding upstream version 2.39.3. Signed-off-by: Daniel Baumann --- man-common/Makemodule.am | 10 +++++++ man-common/bugreports.adoc | 3 ++ man-common/colors.adoc | 17 +++++++++++ man-common/footer-config.adoc | 4 +++ man-common/footer-lib.adoc | 4 +++ man-common/footer.adoc | 4 +++ man-common/help-version.adoc | 5 ++++ man-common/in-bytes.adoc | 7 +++++ man-common/manpage-stub.adoc | 66 +++++++++++++++++++++++++++++++++++++++++++ man-common/translation.adoc | 12 ++++++++ 10 files changed, 132 insertions(+) create mode 100644 man-common/Makemodule.am create mode 100644 man-common/bugreports.adoc create mode 100644 man-common/colors.adoc create mode 100644 man-common/footer-config.adoc create mode 100644 man-common/footer-lib.adoc create mode 100644 man-common/footer.adoc create mode 100644 man-common/help-version.adoc create mode 100644 man-common/in-bytes.adoc create mode 100644 man-common/manpage-stub.adoc create mode 100644 man-common/translation.adoc (limited to 'man-common') diff --git a/man-common/Makemodule.am b/man-common/Makemodule.am new file mode 100644 index 0000000..c999ee7 --- /dev/null +++ b/man-common/Makemodule.am @@ -0,0 +1,10 @@ +ADOCFILES_COMMON += \ + man-common/bugreports.adoc \ + man-common/colors.adoc \ + man-common/footer.adoc \ + man-common/footer-config.adoc \ + man-common/footer-lib.adoc \ + man-common/help-version.adoc \ + man-common/in-bytes.adoc \ + man-common/manpage-stub.adoc \ + man-common/translation.adoc diff --git a/man-common/bugreports.adoc b/man-common/bugreports.adoc new file mode 100644 index 0000000..0801bd2 --- /dev/null +++ b/man-common/bugreports.adoc @@ -0,0 +1,3 @@ +== REPORTING BUGS + +For bug reports, use the issue tracker at https://github.com/util-linux/util-linux/issues. diff --git a/man-common/colors.adoc b/man-common/colors.adoc new file mode 100644 index 0000000..a693f87 --- /dev/null +++ b/man-common/colors.adoc @@ -0,0 +1,17 @@ +== COLORS + +The output colorization is implemented by *terminal-colors.d*(5) functionality. +Implicit coloring can be disabled by an empty file +____ +_/etc/terminal-colors.d/{command}.disable_ +____ +for the *{command}* command or for all tools by +____ +_/etc/terminal-colors.d/disable_ +____ +The user-specific _$XDG_CONFIG_HOME/terminal-colors.d_ +or _$HOME/.config/terminal-colors.d_ overrides the global setting. + +Note that the output colorization may be enabled by default, and in this case +_terminal-colors.d_ directories do not have to exist yet. + diff --git a/man-common/footer-config.adoc b/man-common/footer-config.adoc new file mode 100644 index 0000000..b016c53 --- /dev/null +++ b/man-common/footer-config.adoc @@ -0,0 +1,4 @@ +== AVAILABILITY + +// TRANSLATORS: Keep *{configfile}* untranslated, it will be replaced with the name of the configuration file. +*{configfile}* is part of the util-linux package which can be downloaded from https://www.kernel.org/pub/linux/utils/util-linux/[Linux Kernel Archive]. diff --git a/man-common/footer-lib.adoc b/man-common/footer-lib.adoc new file mode 100644 index 0000000..451ca07 --- /dev/null +++ b/man-common/footer-lib.adoc @@ -0,0 +1,4 @@ +== AVAILABILITY + +// TRANSLATORS: Keep *{lib}* and {firstversion} untranslated, will be replaced with the library name and the version of util-linux where the library appeared for the first time. +The *{lib}* library is part of the util-linux package since version {firstversion}. It can be downloaded from https://www.kernel.org/pub/linux/utils/util-linux/[Linux Kernel Archive]. diff --git a/man-common/footer.adoc b/man-common/footer.adoc new file mode 100644 index 0000000..c448f8c --- /dev/null +++ b/man-common/footer.adoc @@ -0,0 +1,4 @@ +== AVAILABILITY + +// TRANSLATORS: Keep *{command}* untranslated, it will be replaced with the command name. +The *{command}* command is part of the util-linux package which can be downloaded from https://www.kernel.org/pub/linux/utils/util-linux/[Linux Kernel Archive]. diff --git a/man-common/help-version.adoc b/man-common/help-version.adoc new file mode 100644 index 0000000..7a3c04f --- /dev/null +++ b/man-common/help-version.adoc @@ -0,0 +1,5 @@ +*-h*, *--help*:: +Display help text and exit. + +*-V*, *--version*:: +Print version and exit. diff --git a/man-common/in-bytes.adoc b/man-common/in-bytes.adoc new file mode 100644 index 0000000..3a69c6e --- /dev/null +++ b/man-common/in-bytes.adoc @@ -0,0 +1,7 @@ +Print the sizes in bytes rather than in a human-readable format. ++ +By default, the unit, sizes are expressed in, is byte, and unit prefixes are in +power of 2^10 (1024). Abbreviations of symbols are exhibited truncated in order +to reach a better readability, by exhibiting alone the first letter of them; +examples: "1 KiB" and "1 MiB" are respectively exhibited as "1 K" and "1 M", +then omitting on purpose the mention "iB", which is part of these abbreviations. diff --git a/man-common/manpage-stub.adoc b/man-common/manpage-stub.adoc new file mode 100644 index 0000000..833f785 --- /dev/null +++ b/man-common/manpage-stub.adoc @@ -0,0 +1,66 @@ +//po4a: entry man manual +//// +Please don't treat this file as a real man page! We provide it only to show how +things should be formatted. Besides this example file, see the existing .adoc +files for many more formatting options. +The first line above is a hint for po4a that the :man manual: entry needs +to be translated. +As you can see here, use //// to write comment blocks. For a single comment +line, just use //. +Please don't wrap lines within a paragraph. Our translation tool po4a behaves +a bit unpredictable in such cases. +We also urgently recommend to test the creation of the *roff file to see possible +issues. +//// += foobar(1) +:doctype: manpage +:man manual: User commands +:man source: util-linux {release-version} +:page-layout: base +:command: foobar + +== NAME + +foobar - do nothing + +== SYNOPSIS + +*foobar* _options_ _file_ + +== DESCRIPTION + +Describe *foobar* briefly. + +== OPTIONS + +//Format options bold and values italic: +*-o*, *--option* _value_:: +This option has a value. ++ +For empty lines within a description (to keep the indentation) you can use the "plus" character at the beginning of an otherwise empty line. + +//Last but not least, don't forget the common options: +include::man-common/help-version.adoc[] + +== NOTES + +Put your notes here which don't match any other paragraph. + +== AUTHORS + +// Format mail addresses as follows: +mailto:john.doe@example.com[John Doe] +// If you need more than one address, use a comma-separated list or leave empty lines between the entries. + +== SEE ALSO + +*foo*(1), +*bar*(1) + +include::man-common/bugreports.adoc[] + +include::man-common/footer.adoc[] + +ifdef::translation[] +include::man-common/translation.adoc[] +endif::[] diff --git a/man-common/translation.adoc b/man-common/translation.adoc new file mode 100644 index 0000000..4b54fc4 --- /dev/null +++ b/man-common/translation.adoc @@ -0,0 +1,12 @@ +== TRANSLATION + +For the authors of this translation, see the header of the corresponding +*.po file at GNU TP: +https://translationproject.org/domain/util-linux-man.html + +//// +TRANSLATORS: Please replace %1 with the address of the mailing list of your +translation team. +//// +Report man page translation bugs to: +<%1> -- cgit v1.2.3