diff options
| author | EuAndreh <eu@euandre.org> | 2025-05-09 05:21:33 -0300 |
|---|---|---|
| committer | EuAndreh <eu@euandre.org> | 2025-05-09 10:27:21 -0300 |
| commit | b90a8152cb5d0731a670a36e396c07c1b00de58c (patch) | |
| tree | 23418b4dfac0ad8fdd94816c6c8de50d0dbcedb8 /po | |
| parent | Support UUIDv7, with -vN for choosing (diff) | |
| download | uuid-b90a8152cb5d0731a670a36e396c07c1b00de58c.tar.gz uuid-b90a8152cb5d0731a670a36e396c07c1b00de58c.tar.xz | |
doc/: Add uuid.en.{0,3,7.{CHANGELOG,README,TODOs,recipes,tutorial,why}}.adoc
Diffstat (limited to 'po')
| -rw-r--r-- | po/de.po | 254 | ||||
| -rw-r--r-- | po/eo.po | 254 | ||||
| -rw-r--r-- | po/es.po | 254 | ||||
| -rw-r--r-- | po/fr.po | 254 | ||||
| -rw-r--r-- | po/po4a.cfg | 9 | ||||
| -rw-r--r-- | po/pt.po | 254 | ||||
| -rw-r--r-- | po/uuid.pot | 252 |
7 files changed, 1194 insertions, 337 deletions
@@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2025-05-04 09:15-0300\n" +"POT-Creation-Date: 2025-05-09 10:10-0300\n" "PO-Revision-Date: 2025-05-04 09:15-0300\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -17,20 +17,46 @@ msgstr "" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #. type: Title = -#: doc/uuid.en.1.adoc:1 +#: doc/uuid.en.0.adoc:1 #, no-wrap -msgid "uuid(1)" +msgid "uuid(0)" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:5 +#: doc/uuid.en.0.adoc:5 doc/uuid.en.1.adoc:5 doc/uuid.en.3.adoc:3 +#: doc/uuid.en.7CHANGELOG.adoc:3 doc/uuid.en.7README.adoc:3 +#: doc/uuid.en.7recipes.adoc:3 doc/uuid.en.7tutorial.adoc:3 +#: doc/uuid.en.7why.adoc:3 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text +#: doc/uuid.en.0.adoc:8 +msgid "uuid - generate or parse UUID values." +msgstr "" + +#. type: Title == +#: doc/uuid.en.0.adoc:11 doc/uuid.en.1.adoc:60 doc/uuid.en.7CHANGELOG.adoc:7 +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: Plain text +#: doc/uuid.en.0.adoc:13 +msgid "" +"*uuid* generates UUID of version 4 or version 7, or validate a given UUID." +msgstr "" + +#. type: Title = +#: doc/uuid.en.1.adoc:1 +#, no-wrap +msgid "uuid(1)" +msgstr "" + +#. type: Plain text #: doc/uuid.en.1.adoc:8 -msgid "uuid - generate or validate a UUIDv4" +msgid "uuid - generate a UUID version 4 or 7, or validate a UUID string." msgstr "" #. type: Title == @@ -40,24 +66,24 @@ msgid "SYNOPSYS" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:14 -msgid "*uuid* [_STRING_]" +#: doc/uuid.en.1.adoc:15 +msgid "*uuid* [-v (4|7)] *uuid* [_STRING_]" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:17 +#: doc/uuid.en.1.adoc:18 #, no-wrap msgid "EXAMPLES" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:20 +#: doc/uuid.en.1.adoc:21 #, no-wrap -msgid "Print a UUID on the terminal" +msgid "Print a (version 4) UUID on the terminal" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:25 +#: doc/uuid.en.1.adoc:27 #, no-wrap msgid "" "$ uuid\n" @@ -65,25 +91,39 @@ msgid "" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:28 +#: doc/uuid.en.1.adoc:30 +#, no-wrap +msgid "Print a verson 7 UUID on the terminal" +msgstr "" + +#. type: delimited block . +#: doc/uuid.en.1.adoc:36 +#, no-wrap +msgid "" +"$ uuid -v 7\n" +"d3891787-c952-af17-d697-0df3b85981e1\n" +msgstr "" + +#. type: Title === +#: doc/uuid.en.1.adoc:39 #, no-wrap msgid "Create a new UUID as part of a path" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:32 +#: doc/uuid.en.1.adoc:44 #, no-wrap msgid "dir=\"$PWD\"/\"$(uuid)\"/data\n" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:35 +#: doc/uuid.en.1.adoc:47 #, no-wrap msgid "Validate a given UUID" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:43 +#: doc/uuid.en.1.adoc:56 #, no-wrap msgid "" "ID=\"$(basename -- \"$directory\")\"\n" @@ -93,212 +133,314 @@ msgid "" "fi\n" msgstr "" +#. type: Plain text +#: doc/uuid.en.1.adoc:65 +msgid "" +"The *uuid* utility generates a new UUID when no _STRING_ is given and write " +"it to _stdout_. If a _STRING_ is given, *uuid* validates it and exits, and " +"produces no output." +msgstr "" + +#. type: Plain text +#: doc/uuid.en.1.adoc:69 +msgid "" +"The *-v* option allows for choosing which type of UUID to be emitted, either " +"version 4 (\"the random one\") or version 7 (\"the sortable one\"). When " +"omitted, version 4 is chosen as default." +msgstr "" + #. type: Title == -#: doc/uuid.en.1.adoc:47 +#: doc/uuid.en.1.adoc:72 #, no-wrap -msgid "DESCRIPTION" +msgid "OPTIONS" +msgstr "" + +#. type: Labeled list +#: doc/uuid.en.1.adoc:74 +#, no-wrap +msgid "*-v NUMBER*" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:52 +#: doc/uuid.en.1.adoc:76 msgid "" -"The *uuid* utility generates a new UUID when no _STRING_ is given and write " -"it to _stdout_. If a _STRING_ is given, *uuid* validates it and exits, and " -"produces no output." +"Choose the UUID version *NUMBER* to be generated. Supported values are 4 " +"(the default) and 7." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:55 +#: doc/uuid.en.1.adoc:79 #, no-wrap msgid "OPERANDS" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:57 +#: doc/uuid.en.1.adoc:81 #, no-wrap msgid "_STRING_" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:58 +#: doc/uuid.en.1.adoc:82 msgid "If it is" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:59 +#: doc/uuid.en.1.adoc:83 #, no-wrap msgid "*not given*" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:61 +#: doc/uuid.en.1.adoc:85 msgid "" "generate a brand new random UUIDv4, print it to _stdout_ and exit normally;" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:61 +#: doc/uuid.en.1.adoc:85 #, no-wrap msgid "*given*" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:62 +#: doc/uuid.en.1.adoc:86 msgid "test if it is a valid UUIDv4 and exit normally if so." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:65 +#: doc/uuid.en.1.adoc:89 #, no-wrap msgid "IO" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:68 +#: doc/uuid.en.1.adoc:92 #, no-wrap msgid "STDIN" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:71 doc/uuid.en.1.adoc:92 +#: doc/uuid.en.1.adoc:95 msgid "Not used." msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:73 +#: doc/uuid.en.1.adoc:97 #, no-wrap msgid "STDOUT" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:77 +#: doc/uuid.en.1.adoc:101 msgid "" "The UUIDv4 format is made of byte blocks encoded as hexadecimals, using a " "<hyphen-minus>('`-`') as the block separator:" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:80 +#: doc/uuid.en.1.adoc:105 #, no-wrap msgid "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX\n" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:83 +#: doc/uuid.en.1.adoc:108 msgid "An example output is:" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:86 +#: doc/uuid.en.1.adoc:112 #, no-wrap msgid "cb46d0c0-b2aa-4a6c-a119-8deace2544a2\n" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:89 +#: doc/uuid.en.1.adoc:115 #, no-wrap msgid "STDERR" msgstr "" +#. type: Plain text +#: doc/uuid.en.1.adoc:118 +msgid "" +"Errors on UUID validation are sent to the standard error. For instance:" +msgstr "" + +#. type: delimited block . +#: doc/uuid.en.1.adoc:123 +#, no-wrap +msgid "" +"$ uuid not-a-uuid-123 1>/dev/null\n" +"uuid: str isn't of the correct length\n" +msgstr "" + +#. type: Plain text +#: doc/uuid.en.1.adoc:126 +msgid "When valid, validation emits nothing and exits with 0." +msgstr "" + #. type: Title === -#: doc/uuid.en.1.adoc:94 +#: doc/uuid.en.1.adoc:128 #, no-wrap msgid "INPUT FILES" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:97 doc/uuid.en.1.adoc:102 +#: doc/uuid.en.1.adoc:131 doc/uuid.en.1.adoc:136 msgid "None." msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:99 +#: doc/uuid.en.1.adoc:133 #, no-wrap msgid "OUTPUT FILES" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:105 +#: doc/uuid.en.1.adoc:139 #, no-wrap msgid "EXIT STATUS" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:107 +#: doc/uuid.en.1.adoc:141 #, no-wrap msgid "0" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:108 +#: doc/uuid.en.1.adoc:142 msgid "Generating or validating a UUID was successfull." msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:108 +#: doc/uuid.en.1.adoc:142 #, no-wrap msgid "3" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:109 +#: doc/uuid.en.1.adoc:143 msgid "UUID validation failed." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:112 +#: doc/uuid.en.1.adoc:146 #, no-wrap msgid "CONFORMING TO" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:115 -msgid "The v4 UUID defined in *RFC 9562*." +#: doc/uuid.en.1.adoc:149 +msgid "The versions 4 and 7 of the UUID defined in *RFC 9562*." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:118 +#: doc/uuid.en.1.adoc:152 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:122 +#: doc/uuid.en.1.adoc:156 #, no-wrap msgid "AUTHORS" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:125 +#: doc/uuid.en.1.adoc:159 msgid "mailto:eu@euandre.org[EuAndreh] and contributors." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:128 +#: doc/uuid.en.1.adoc:162 #, no-wrap msgid "BUGS" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:132 +#: doc/uuid.en.1.adoc:166 msgid "" "Report bugs to the mailto:~euandreh/public-inbox@lists.sr.ht[mailing list]. " "Use the subject \"[uuid] BUG or TASK: <description>\"." msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:133 +#: doc/uuid.en.1.adoc:167 msgid "Browse bugs https://euandre.org/git/uuid/TODOs.html[online]." msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:134 +#: doc/uuid.en.1.adoc:168 msgid "https://euandre.org/git/uuid/[Homepage]." msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:134 +#: doc/uuid.en.1.adoc:168 msgid "" "https://lists.sr.ht/~euandreh/public-inbox?search=%5Buuid%5D[Comments and " "discussions]." msgstr "" + +#. type: Title = +#: doc/uuid.en.3.adoc:1 +#, no-wrap +msgid "uuid(3)" +msgstr "" + +#. type: Plain text +#: doc/uuid.en.3.adoc:5 doc/uuid.en.7CHANGELOG.adoc:6 +#: doc/uuid.en.7README.adoc:5 doc/uuid.en.7recipes.adoc:5 +#: doc/uuid.en.7tutorial.adoc:5 doc/uuid.en.7why.adoc:5 +msgid "uuid - ." +msgstr "" + +#. type: Title = +#: doc/uuid.en.7CHANGELOG.adoc:1 +#, no-wrap +msgid "uuid(7CHANGELOG)" +msgstr "" + +#. Entry template: +#. == Unreleased +#. === Added +#. === Changed +#. === Deprecated +#. === Removed +#. === Fixed +#. === Security +#. type: Plain text +#: doc/uuid.en.7CHANGELOG.adoc:21 +msgid "Changelog for https://euandre.org/s/uuid/en/[uuid]." +msgstr "" + +#. type: Title == +#: doc/uuid.en.7CHANGELOG.adoc:22 +#, no-wrap +msgid "Unreleased" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7README.adoc:1 +#, no-wrap +msgid "uuid(7README)" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7recipes.adoc:1 +#, no-wrap +msgid "uuid(7recipes)" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7tutorial.adoc:1 +#, no-wrap +msgid "uuid(7tutorial)" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7why.adoc:1 +#, no-wrap +msgid "uuid(7why)" +msgstr "" @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2025-05-04 09:15-0300\n" +"POT-Creation-Date: 2025-05-09 10:10-0300\n" "PO-Revision-Date: 2025-05-04 09:15-0300\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -17,20 +17,46 @@ msgstr "" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #. type: Title = -#: doc/uuid.en.1.adoc:1 +#: doc/uuid.en.0.adoc:1 #, no-wrap -msgid "uuid(1)" +msgid "uuid(0)" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:5 +#: doc/uuid.en.0.adoc:5 doc/uuid.en.1.adoc:5 doc/uuid.en.3.adoc:3 +#: doc/uuid.en.7CHANGELOG.adoc:3 doc/uuid.en.7README.adoc:3 +#: doc/uuid.en.7recipes.adoc:3 doc/uuid.en.7tutorial.adoc:3 +#: doc/uuid.en.7why.adoc:3 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text +#: doc/uuid.en.0.adoc:8 +msgid "uuid - generate or parse UUID values." +msgstr "" + +#. type: Title == +#: doc/uuid.en.0.adoc:11 doc/uuid.en.1.adoc:60 doc/uuid.en.7CHANGELOG.adoc:7 +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: Plain text +#: doc/uuid.en.0.adoc:13 +msgid "" +"*uuid* generates UUID of version 4 or version 7, or validate a given UUID." +msgstr "" + +#. type: Title = +#: doc/uuid.en.1.adoc:1 +#, no-wrap +msgid "uuid(1)" +msgstr "" + +#. type: Plain text #: doc/uuid.en.1.adoc:8 -msgid "uuid - generate or validate a UUIDv4" +msgid "uuid - generate a UUID version 4 or 7, or validate a UUID string." msgstr "" #. type: Title == @@ -40,24 +66,24 @@ msgid "SYNOPSYS" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:14 -msgid "*uuid* [_STRING_]" +#: doc/uuid.en.1.adoc:15 +msgid "*uuid* [-v (4|7)] *uuid* [_STRING_]" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:17 +#: doc/uuid.en.1.adoc:18 #, no-wrap msgid "EXAMPLES" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:20 +#: doc/uuid.en.1.adoc:21 #, no-wrap -msgid "Print a UUID on the terminal" +msgid "Print a (version 4) UUID on the terminal" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:25 +#: doc/uuid.en.1.adoc:27 #, no-wrap msgid "" "$ uuid\n" @@ -65,25 +91,39 @@ msgid "" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:28 +#: doc/uuid.en.1.adoc:30 +#, no-wrap +msgid "Print a verson 7 UUID on the terminal" +msgstr "" + +#. type: delimited block . +#: doc/uuid.en.1.adoc:36 +#, no-wrap +msgid "" +"$ uuid -v 7\n" +"d3891787-c952-af17-d697-0df3b85981e1\n" +msgstr "" + +#. type: Title === +#: doc/uuid.en.1.adoc:39 #, no-wrap msgid "Create a new UUID as part of a path" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:32 +#: doc/uuid.en.1.adoc:44 #, no-wrap msgid "dir=\"$PWD\"/\"$(uuid)\"/data\n" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:35 +#: doc/uuid.en.1.adoc:47 #, no-wrap msgid "Validate a given UUID" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:43 +#: doc/uuid.en.1.adoc:56 #, no-wrap msgid "" "ID=\"$(basename -- \"$directory\")\"\n" @@ -93,212 +133,314 @@ msgid "" "fi\n" msgstr "" +#. type: Plain text +#: doc/uuid.en.1.adoc:65 +msgid "" +"The *uuid* utility generates a new UUID when no _STRING_ is given and write " +"it to _stdout_. If a _STRING_ is given, *uuid* validates it and exits, and " +"produces no output." +msgstr "" + +#. type: Plain text +#: doc/uuid.en.1.adoc:69 +msgid "" +"The *-v* option allows for choosing which type of UUID to be emitted, either " +"version 4 (\"the random one\") or version 7 (\"the sortable one\"). When " +"omitted, version 4 is chosen as default." +msgstr "" + #. type: Title == -#: doc/uuid.en.1.adoc:47 +#: doc/uuid.en.1.adoc:72 #, no-wrap -msgid "DESCRIPTION" +msgid "OPTIONS" +msgstr "" + +#. type: Labeled list +#: doc/uuid.en.1.adoc:74 +#, no-wrap +msgid "*-v NUMBER*" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:52 +#: doc/uuid.en.1.adoc:76 msgid "" -"The *uuid* utility generates a new UUID when no _STRING_ is given and write " -"it to _stdout_. If a _STRING_ is given, *uuid* validates it and exits, and " -"produces no output." +"Choose the UUID version *NUMBER* to be generated. Supported values are 4 " +"(the default) and 7." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:55 +#: doc/uuid.en.1.adoc:79 #, no-wrap msgid "OPERANDS" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:57 +#: doc/uuid.en.1.adoc:81 #, no-wrap msgid "_STRING_" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:58 +#: doc/uuid.en.1.adoc:82 msgid "If it is" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:59 +#: doc/uuid.en.1.adoc:83 #, no-wrap msgid "*not given*" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:61 +#: doc/uuid.en.1.adoc:85 msgid "" "generate a brand new random UUIDv4, print it to _stdout_ and exit normally;" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:61 +#: doc/uuid.en.1.adoc:85 #, no-wrap msgid "*given*" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:62 +#: doc/uuid.en.1.adoc:86 msgid "test if it is a valid UUIDv4 and exit normally if so." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:65 +#: doc/uuid.en.1.adoc:89 #, no-wrap msgid "IO" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:68 +#: doc/uuid.en.1.adoc:92 #, no-wrap msgid "STDIN" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:71 doc/uuid.en.1.adoc:92 +#: doc/uuid.en.1.adoc:95 msgid "Not used." msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:73 +#: doc/uuid.en.1.adoc:97 #, no-wrap msgid "STDOUT" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:77 +#: doc/uuid.en.1.adoc:101 msgid "" "The UUIDv4 format is made of byte blocks encoded as hexadecimals, using a " "<hyphen-minus>('`-`') as the block separator:" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:80 +#: doc/uuid.en.1.adoc:105 #, no-wrap msgid "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX\n" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:83 +#: doc/uuid.en.1.adoc:108 msgid "An example output is:" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:86 +#: doc/uuid.en.1.adoc:112 #, no-wrap msgid "cb46d0c0-b2aa-4a6c-a119-8deace2544a2\n" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:89 +#: doc/uuid.en.1.adoc:115 #, no-wrap msgid "STDERR" msgstr "" +#. type: Plain text +#: doc/uuid.en.1.adoc:118 +msgid "" +"Errors on UUID validation are sent to the standard error. For instance:" +msgstr "" + +#. type: delimited block . +#: doc/uuid.en.1.adoc:123 +#, no-wrap +msgid "" +"$ uuid not-a-uuid-123 1>/dev/null\n" +"uuid: str isn't of the correct length\n" +msgstr "" + +#. type: Plain text +#: doc/uuid.en.1.adoc:126 +msgid "When valid, validation emits nothing and exits with 0." +msgstr "" + #. type: Title === -#: doc/uuid.en.1.adoc:94 +#: doc/uuid.en.1.adoc:128 #, no-wrap msgid "INPUT FILES" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:97 doc/uuid.en.1.adoc:102 +#: doc/uuid.en.1.adoc:131 doc/uuid.en.1.adoc:136 msgid "None." msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:99 +#: doc/uuid.en.1.adoc:133 #, no-wrap msgid "OUTPUT FILES" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:105 +#: doc/uuid.en.1.adoc:139 #, no-wrap msgid "EXIT STATUS" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:107 +#: doc/uuid.en.1.adoc:141 #, no-wrap msgid "0" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:108 +#: doc/uuid.en.1.adoc:142 msgid "Generating or validating a UUID was successfull." msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:108 +#: doc/uuid.en.1.adoc:142 #, no-wrap msgid "3" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:109 +#: doc/uuid.en.1.adoc:143 msgid "UUID validation failed." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:112 +#: doc/uuid.en.1.adoc:146 #, no-wrap msgid "CONFORMING TO" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:115 -msgid "The v4 UUID defined in *RFC 9562*." +#: doc/uuid.en.1.adoc:149 +msgid "The versions 4 and 7 of the UUID defined in *RFC 9562*." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:118 +#: doc/uuid.en.1.adoc:152 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:122 +#: doc/uuid.en.1.adoc:156 #, no-wrap msgid "AUTHORS" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:125 +#: doc/uuid.en.1.adoc:159 msgid "mailto:eu@euandre.org[EuAndreh] and contributors." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:128 +#: doc/uuid.en.1.adoc:162 #, no-wrap msgid "BUGS" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:132 +#: doc/uuid.en.1.adoc:166 msgid "" "Report bugs to the mailto:~euandreh/public-inbox@lists.sr.ht[mailing list]. " "Use the subject \"[uuid] BUG or TASK: <description>\"." msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:133 +#: doc/uuid.en.1.adoc:167 msgid "Browse bugs https://euandre.org/git/uuid/TODOs.html[online]." msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:134 +#: doc/uuid.en.1.adoc:168 msgid "https://euandre.org/git/uuid/[Homepage]." msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:134 +#: doc/uuid.en.1.adoc:168 msgid "" "https://lists.sr.ht/~euandreh/public-inbox?search=%5Buuid%5D[Comments and " "discussions]." msgstr "" + +#. type: Title = +#: doc/uuid.en.3.adoc:1 +#, no-wrap +msgid "uuid(3)" +msgstr "" + +#. type: Plain text +#: doc/uuid.en.3.adoc:5 doc/uuid.en.7CHANGELOG.adoc:6 +#: doc/uuid.en.7README.adoc:5 doc/uuid.en.7recipes.adoc:5 +#: doc/uuid.en.7tutorial.adoc:5 doc/uuid.en.7why.adoc:5 +msgid "uuid - ." +msgstr "" + +#. type: Title = +#: doc/uuid.en.7CHANGELOG.adoc:1 +#, no-wrap +msgid "uuid(7CHANGELOG)" +msgstr "" + +#. Entry template: +#. == Unreleased +#. === Added +#. === Changed +#. === Deprecated +#. === Removed +#. === Fixed +#. === Security +#. type: Plain text +#: doc/uuid.en.7CHANGELOG.adoc:21 +msgid "Changelog for https://euandre.org/s/uuid/en/[uuid]." +msgstr "" + +#. type: Title == +#: doc/uuid.en.7CHANGELOG.adoc:22 +#, no-wrap +msgid "Unreleased" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7README.adoc:1 +#, no-wrap +msgid "uuid(7README)" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7recipes.adoc:1 +#, no-wrap +msgid "uuid(7recipes)" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7tutorial.adoc:1 +#, no-wrap +msgid "uuid(7tutorial)" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7why.adoc:1 +#, no-wrap +msgid "uuid(7why)" +msgstr "" @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2025-05-04 09:15-0300\n" +"POT-Creation-Date: 2025-05-09 10:10-0300\n" "PO-Revision-Date: 2025-05-04 09:15-0300\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -17,20 +17,46 @@ msgstr "" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #. type: Title = -#: doc/uuid.en.1.adoc:1 +#: doc/uuid.en.0.adoc:1 #, no-wrap -msgid "uuid(1)" +msgid "uuid(0)" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:5 +#: doc/uuid.en.0.adoc:5 doc/uuid.en.1.adoc:5 doc/uuid.en.3.adoc:3 +#: doc/uuid.en.7CHANGELOG.adoc:3 doc/uuid.en.7README.adoc:3 +#: doc/uuid.en.7recipes.adoc:3 doc/uuid.en.7tutorial.adoc:3 +#: doc/uuid.en.7why.adoc:3 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text +#: doc/uuid.en.0.adoc:8 +msgid "uuid - generate or parse UUID values." +msgstr "" + +#. type: Title == +#: doc/uuid.en.0.adoc:11 doc/uuid.en.1.adoc:60 doc/uuid.en.7CHANGELOG.adoc:7 +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: Plain text +#: doc/uuid.en.0.adoc:13 +msgid "" +"*uuid* generates UUID of version 4 or version 7, or validate a given UUID." +msgstr "" + +#. type: Title = +#: doc/uuid.en.1.adoc:1 +#, no-wrap +msgid "uuid(1)" +msgstr "" + +#. type: Plain text #: doc/uuid.en.1.adoc:8 -msgid "uuid - generate or validate a UUIDv4" +msgid "uuid - generate a UUID version 4 or 7, or validate a UUID string." msgstr "" #. type: Title == @@ -40,24 +66,24 @@ msgid "SYNOPSYS" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:14 -msgid "*uuid* [_STRING_]" +#: doc/uuid.en.1.adoc:15 +msgid "*uuid* [-v (4|7)] *uuid* [_STRING_]" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:17 +#: doc/uuid.en.1.adoc:18 #, no-wrap msgid "EXAMPLES" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:20 +#: doc/uuid.en.1.adoc:21 #, no-wrap -msgid "Print a UUID on the terminal" +msgid "Print a (version 4) UUID on the terminal" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:25 +#: doc/uuid.en.1.adoc:27 #, no-wrap msgid "" "$ uuid\n" @@ -65,25 +91,39 @@ msgid "" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:28 +#: doc/uuid.en.1.adoc:30 +#, no-wrap +msgid "Print a verson 7 UUID on the terminal" +msgstr "" + +#. type: delimited block . +#: doc/uuid.en.1.adoc:36 +#, no-wrap +msgid "" +"$ uuid -v 7\n" +"d3891787-c952-af17-d697-0df3b85981e1\n" +msgstr "" + +#. type: Title === +#: doc/uuid.en.1.adoc:39 #, no-wrap msgid "Create a new UUID as part of a path" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:32 +#: doc/uuid.en.1.adoc:44 #, no-wrap msgid "dir=\"$PWD\"/\"$(uuid)\"/data\n" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:35 +#: doc/uuid.en.1.adoc:47 #, no-wrap msgid "Validate a given UUID" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:43 +#: doc/uuid.en.1.adoc:56 #, no-wrap msgid "" "ID=\"$(basename -- \"$directory\")\"\n" @@ -93,212 +133,314 @@ msgid "" "fi\n" msgstr "" +#. type: Plain text +#: doc/uuid.en.1.adoc:65 +msgid "" +"The *uuid* utility generates a new UUID when no _STRING_ is given and write " +"it to _stdout_. If a _STRING_ is given, *uuid* validates it and exits, and " +"produces no output." +msgstr "" + +#. type: Plain text +#: doc/uuid.en.1.adoc:69 +msgid "" +"The *-v* option allows for choosing which type of UUID to be emitted, either " +"version 4 (\"the random one\") or version 7 (\"the sortable one\"). When " +"omitted, version 4 is chosen as default." +msgstr "" + #. type: Title == -#: doc/uuid.en.1.adoc:47 +#: doc/uuid.en.1.adoc:72 #, no-wrap -msgid "DESCRIPTION" +msgid "OPTIONS" +msgstr "" + +#. type: Labeled list +#: doc/uuid.en.1.adoc:74 +#, no-wrap +msgid "*-v NUMBER*" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:52 +#: doc/uuid.en.1.adoc:76 msgid "" -"The *uuid* utility generates a new UUID when no _STRING_ is given and write " -"it to _stdout_. If a _STRING_ is given, *uuid* validates it and exits, and " -"produces no output." +"Choose the UUID version *NUMBER* to be generated. Supported values are 4 " +"(the default) and 7." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:55 +#: doc/uuid.en.1.adoc:79 #, no-wrap msgid "OPERANDS" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:57 +#: doc/uuid.en.1.adoc:81 #, no-wrap msgid "_STRING_" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:58 +#: doc/uuid.en.1.adoc:82 msgid "If it is" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:59 +#: doc/uuid.en.1.adoc:83 #, no-wrap msgid "*not given*" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:61 +#: doc/uuid.en.1.adoc:85 msgid "" "generate a brand new random UUIDv4, print it to _stdout_ and exit normally;" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:61 +#: doc/uuid.en.1.adoc:85 #, no-wrap msgid "*given*" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:62 +#: doc/uuid.en.1.adoc:86 msgid "test if it is a valid UUIDv4 and exit normally if so." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:65 +#: doc/uuid.en.1.adoc:89 #, no-wrap msgid "IO" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:68 +#: doc/uuid.en.1.adoc:92 #, no-wrap msgid "STDIN" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:71 doc/uuid.en.1.adoc:92 +#: doc/uuid.en.1.adoc:95 msgid "Not used." msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:73 +#: doc/uuid.en.1.adoc:97 #, no-wrap msgid "STDOUT" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:77 +#: doc/uuid.en.1.adoc:101 msgid "" "The UUIDv4 format is made of byte blocks encoded as hexadecimals, using a " "<hyphen-minus>('`-`') as the block separator:" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:80 +#: doc/uuid.en.1.adoc:105 #, no-wrap msgid "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX\n" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:83 +#: doc/uuid.en.1.adoc:108 msgid "An example output is:" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:86 +#: doc/uuid.en.1.adoc:112 #, no-wrap msgid "cb46d0c0-b2aa-4a6c-a119-8deace2544a2\n" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:89 +#: doc/uuid.en.1.adoc:115 #, no-wrap msgid "STDERR" msgstr "" +#. type: Plain text +#: doc/uuid.en.1.adoc:118 +msgid "" +"Errors on UUID validation are sent to the standard error. For instance:" +msgstr "" + +#. type: delimited block . +#: doc/uuid.en.1.adoc:123 +#, no-wrap +msgid "" +"$ uuid not-a-uuid-123 1>/dev/null\n" +"uuid: str isn't of the correct length\n" +msgstr "" + +#. type: Plain text +#: doc/uuid.en.1.adoc:126 +msgid "When valid, validation emits nothing and exits with 0." +msgstr "" + #. type: Title === -#: doc/uuid.en.1.adoc:94 +#: doc/uuid.en.1.adoc:128 #, no-wrap msgid "INPUT FILES" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:97 doc/uuid.en.1.adoc:102 +#: doc/uuid.en.1.adoc:131 doc/uuid.en.1.adoc:136 msgid "None." msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:99 +#: doc/uuid.en.1.adoc:133 #, no-wrap msgid "OUTPUT FILES" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:105 +#: doc/uuid.en.1.adoc:139 #, no-wrap msgid "EXIT STATUS" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:107 +#: doc/uuid.en.1.adoc:141 #, no-wrap msgid "0" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:108 +#: doc/uuid.en.1.adoc:142 msgid "Generating or validating a UUID was successfull." msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:108 +#: doc/uuid.en.1.adoc:142 #, no-wrap msgid "3" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:109 +#: doc/uuid.en.1.adoc:143 msgid "UUID validation failed." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:112 +#: doc/uuid.en.1.adoc:146 #, no-wrap msgid "CONFORMING TO" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:115 -msgid "The v4 UUID defined in *RFC 9562*." +#: doc/uuid.en.1.adoc:149 +msgid "The versions 4 and 7 of the UUID defined in *RFC 9562*." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:118 +#: doc/uuid.en.1.adoc:152 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:122 +#: doc/uuid.en.1.adoc:156 #, no-wrap msgid "AUTHORS" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:125 +#: doc/uuid.en.1.adoc:159 msgid "mailto:eu@euandre.org[EuAndreh] and contributors." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:128 +#: doc/uuid.en.1.adoc:162 #, no-wrap msgid "BUGS" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:132 +#: doc/uuid.en.1.adoc:166 msgid "" "Report bugs to the mailto:~euandreh/public-inbox@lists.sr.ht[mailing list]. " "Use the subject \"[uuid] BUG or TASK: <description>\"." msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:133 +#: doc/uuid.en.1.adoc:167 msgid "Browse bugs https://euandre.org/git/uuid/TODOs.html[online]." msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:134 +#: doc/uuid.en.1.adoc:168 msgid "https://euandre.org/git/uuid/[Homepage]." msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:134 +#: doc/uuid.en.1.adoc:168 msgid "" "https://lists.sr.ht/~euandreh/public-inbox?search=%5Buuid%5D[Comments and " "discussions]." msgstr "" + +#. type: Title = +#: doc/uuid.en.3.adoc:1 +#, no-wrap +msgid "uuid(3)" +msgstr "" + +#. type: Plain text +#: doc/uuid.en.3.adoc:5 doc/uuid.en.7CHANGELOG.adoc:6 +#: doc/uuid.en.7README.adoc:5 doc/uuid.en.7recipes.adoc:5 +#: doc/uuid.en.7tutorial.adoc:5 doc/uuid.en.7why.adoc:5 +msgid "uuid - ." +msgstr "" + +#. type: Title = +#: doc/uuid.en.7CHANGELOG.adoc:1 +#, no-wrap +msgid "uuid(7CHANGELOG)" +msgstr "" + +#. Entry template: +#. == Unreleased +#. === Added +#. === Changed +#. === Deprecated +#. === Removed +#. === Fixed +#. === Security +#. type: Plain text +#: doc/uuid.en.7CHANGELOG.adoc:21 +msgid "Changelog for https://euandre.org/s/uuid/en/[uuid]." +msgstr "" + +#. type: Title == +#: doc/uuid.en.7CHANGELOG.adoc:22 +#, no-wrap +msgid "Unreleased" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7README.adoc:1 +#, no-wrap +msgid "uuid(7README)" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7recipes.adoc:1 +#, no-wrap +msgid "uuid(7recipes)" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7tutorial.adoc:1 +#, no-wrap +msgid "uuid(7tutorial)" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7why.adoc:1 +#, no-wrap +msgid "uuid(7why)" +msgstr "" @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2025-05-04 09:15-0300\n" +"POT-Creation-Date: 2025-05-09 10:10-0300\n" "PO-Revision-Date: 2025-05-04 09:15-0300\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -17,20 +17,46 @@ msgstr "" "Plural-Forms: nplurals=2; plural=(n > 1);\n" #. type: Title = -#: doc/uuid.en.1.adoc:1 +#: doc/uuid.en.0.adoc:1 #, no-wrap -msgid "uuid(1)" +msgid "uuid(0)" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:5 +#: doc/uuid.en.0.adoc:5 doc/uuid.en.1.adoc:5 doc/uuid.en.3.adoc:3 +#: doc/uuid.en.7CHANGELOG.adoc:3 doc/uuid.en.7README.adoc:3 +#: doc/uuid.en.7recipes.adoc:3 doc/uuid.en.7tutorial.adoc:3 +#: doc/uuid.en.7why.adoc:3 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text +#: doc/uuid.en.0.adoc:8 +msgid "uuid - generate or parse UUID values." +msgstr "" + +#. type: Title == +#: doc/uuid.en.0.adoc:11 doc/uuid.en.1.adoc:60 doc/uuid.en.7CHANGELOG.adoc:7 +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: Plain text +#: doc/uuid.en.0.adoc:13 +msgid "" +"*uuid* generates UUID of version 4 or version 7, or validate a given UUID." +msgstr "" + +#. type: Title = +#: doc/uuid.en.1.adoc:1 +#, no-wrap +msgid "uuid(1)" +msgstr "" + +#. type: Plain text #: doc/uuid.en.1.adoc:8 -msgid "uuid - generate or validate a UUIDv4" +msgid "uuid - generate a UUID version 4 or 7, or validate a UUID string." msgstr "" #. type: Title == @@ -40,24 +66,24 @@ msgid "SYNOPSYS" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:14 -msgid "*uuid* [_STRING_]" +#: doc/uuid.en.1.adoc:15 +msgid "*uuid* [-v (4|7)] *uuid* [_STRING_]" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:17 +#: doc/uuid.en.1.adoc:18 #, no-wrap msgid "EXAMPLES" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:20 +#: doc/uuid.en.1.adoc:21 #, no-wrap -msgid "Print a UUID on the terminal" +msgid "Print a (version 4) UUID on the terminal" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:25 +#: doc/uuid.en.1.adoc:27 #, no-wrap msgid "" "$ uuid\n" @@ -65,25 +91,39 @@ msgid "" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:28 +#: doc/uuid.en.1.adoc:30 +#, no-wrap +msgid "Print a verson 7 UUID on the terminal" +msgstr "" + +#. type: delimited block . +#: doc/uuid.en.1.adoc:36 +#, no-wrap +msgid "" +"$ uuid -v 7\n" +"d3891787-c952-af17-d697-0df3b85981e1\n" +msgstr "" + +#. type: Title === +#: doc/uuid.en.1.adoc:39 #, no-wrap msgid "Create a new UUID as part of a path" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:32 +#: doc/uuid.en.1.adoc:44 #, no-wrap msgid "dir=\"$PWD\"/\"$(uuid)\"/data\n" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:35 +#: doc/uuid.en.1.adoc:47 #, no-wrap msgid "Validate a given UUID" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:43 +#: doc/uuid.en.1.adoc:56 #, no-wrap msgid "" "ID=\"$(basename -- \"$directory\")\"\n" @@ -93,212 +133,314 @@ msgid "" "fi\n" msgstr "" +#. type: Plain text +#: doc/uuid.en.1.adoc:65 +msgid "" +"The *uuid* utility generates a new UUID when no _STRING_ is given and write " +"it to _stdout_. If a _STRING_ is given, *uuid* validates it and exits, and " +"produces no output." +msgstr "" + +#. type: Plain text +#: doc/uuid.en.1.adoc:69 +msgid "" +"The *-v* option allows for choosing which type of UUID to be emitted, either " +"version 4 (\"the random one\") or version 7 (\"the sortable one\"). When " +"omitted, version 4 is chosen as default." +msgstr "" + #. type: Title == -#: doc/uuid.en.1.adoc:47 +#: doc/uuid.en.1.adoc:72 #, no-wrap -msgid "DESCRIPTION" +msgid "OPTIONS" +msgstr "" + +#. type: Labeled list +#: doc/uuid.en.1.adoc:74 +#, no-wrap +msgid "*-v NUMBER*" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:52 +#: doc/uuid.en.1.adoc:76 msgid "" -"The *uuid* utility generates a new UUID when no _STRING_ is given and write " -"it to _stdout_. If a _STRING_ is given, *uuid* validates it and exits, and " -"produces no output." +"Choose the UUID version *NUMBER* to be generated. Supported values are 4 " +"(the default) and 7." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:55 +#: doc/uuid.en.1.adoc:79 #, no-wrap msgid "OPERANDS" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:57 +#: doc/uuid.en.1.adoc:81 #, no-wrap msgid "_STRING_" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:58 +#: doc/uuid.en.1.adoc:82 msgid "If it is" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:59 +#: doc/uuid.en.1.adoc:83 #, no-wrap msgid "*not given*" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:61 +#: doc/uuid.en.1.adoc:85 msgid "" "generate a brand new random UUIDv4, print it to _stdout_ and exit normally;" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:61 +#: doc/uuid.en.1.adoc:85 #, no-wrap msgid "*given*" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:62 +#: doc/uuid.en.1.adoc:86 msgid "test if it is a valid UUIDv4 and exit normally if so." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:65 +#: doc/uuid.en.1.adoc:89 #, no-wrap msgid "IO" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:68 +#: doc/uuid.en.1.adoc:92 #, no-wrap msgid "STDIN" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:71 doc/uuid.en.1.adoc:92 +#: doc/uuid.en.1.adoc:95 msgid "Not used." msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:73 +#: doc/uuid.en.1.adoc:97 #, no-wrap msgid "STDOUT" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:77 +#: doc/uuid.en.1.adoc:101 msgid "" "The UUIDv4 format is made of byte blocks encoded as hexadecimals, using a " "<hyphen-minus>('`-`') as the block separator:" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:80 +#: doc/uuid.en.1.adoc:105 #, no-wrap msgid "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX\n" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:83 +#: doc/uuid.en.1.adoc:108 msgid "An example output is:" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:86 +#: doc/uuid.en.1.adoc:112 #, no-wrap msgid "cb46d0c0-b2aa-4a6c-a119-8deace2544a2\n" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:89 +#: doc/uuid.en.1.adoc:115 #, no-wrap msgid "STDERR" msgstr "" +#. type: Plain text +#: doc/uuid.en.1.adoc:118 +msgid "" +"Errors on UUID validation are sent to the standard error. For instance:" +msgstr "" + +#. type: delimited block . +#: doc/uuid.en.1.adoc:123 +#, no-wrap +msgid "" +"$ uuid not-a-uuid-123 1>/dev/null\n" +"uuid: str isn't of the correct length\n" +msgstr "" + +#. type: Plain text +#: doc/uuid.en.1.adoc:126 +msgid "When valid, validation emits nothing and exits with 0." +msgstr "" + #. type: Title === -#: doc/uuid.en.1.adoc:94 +#: doc/uuid.en.1.adoc:128 #, no-wrap msgid "INPUT FILES" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:97 doc/uuid.en.1.adoc:102 +#: doc/uuid.en.1.adoc:131 doc/uuid.en.1.adoc:136 msgid "None." msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:99 +#: doc/uuid.en.1.adoc:133 #, no-wrap msgid "OUTPUT FILES" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:105 +#: doc/uuid.en.1.adoc:139 #, no-wrap msgid "EXIT STATUS" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:107 +#: doc/uuid.en.1.adoc:141 #, no-wrap msgid "0" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:108 +#: doc/uuid.en.1.adoc:142 msgid "Generating or validating a UUID was successfull." msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:108 +#: doc/uuid.en.1.adoc:142 #, no-wrap msgid "3" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:109 +#: doc/uuid.en.1.adoc:143 msgid "UUID validation failed." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:112 +#: doc/uuid.en.1.adoc:146 #, no-wrap msgid "CONFORMING TO" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:115 -msgid "The v4 UUID defined in *RFC 9562*." +#: doc/uuid.en.1.adoc:149 +msgid "The versions 4 and 7 of the UUID defined in *RFC 9562*." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:118 +#: doc/uuid.en.1.adoc:152 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:122 +#: doc/uuid.en.1.adoc:156 #, no-wrap msgid "AUTHORS" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:125 +#: doc/uuid.en.1.adoc:159 msgid "mailto:eu@euandre.org[EuAndreh] and contributors." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:128 +#: doc/uuid.en.1.adoc:162 #, no-wrap msgid "BUGS" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:132 +#: doc/uuid.en.1.adoc:166 msgid "" "Report bugs to the mailto:~euandreh/public-inbox@lists.sr.ht[mailing list]. " "Use the subject \"[uuid] BUG or TASK: <description>\"." msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:133 +#: doc/uuid.en.1.adoc:167 msgid "Browse bugs https://euandre.org/git/uuid/TODOs.html[online]." msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:134 +#: doc/uuid.en.1.adoc:168 msgid "https://euandre.org/git/uuid/[Homepage]." msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:134 +#: doc/uuid.en.1.adoc:168 msgid "" "https://lists.sr.ht/~euandreh/public-inbox?search=%5Buuid%5D[Comments and " "discussions]." msgstr "" + +#. type: Title = +#: doc/uuid.en.3.adoc:1 +#, no-wrap +msgid "uuid(3)" +msgstr "" + +#. type: Plain text +#: doc/uuid.en.3.adoc:5 doc/uuid.en.7CHANGELOG.adoc:6 +#: doc/uuid.en.7README.adoc:5 doc/uuid.en.7recipes.adoc:5 +#: doc/uuid.en.7tutorial.adoc:5 doc/uuid.en.7why.adoc:5 +msgid "uuid - ." +msgstr "" + +#. type: Title = +#: doc/uuid.en.7CHANGELOG.adoc:1 +#, no-wrap +msgid "uuid(7CHANGELOG)" +msgstr "" + +#. Entry template: +#. == Unreleased +#. === Added +#. === Changed +#. === Deprecated +#. === Removed +#. === Fixed +#. === Security +#. type: Plain text +#: doc/uuid.en.7CHANGELOG.adoc:21 +msgid "Changelog for https://euandre.org/s/uuid/en/[uuid]." +msgstr "" + +#. type: Title == +#: doc/uuid.en.7CHANGELOG.adoc:22 +#, no-wrap +msgid "Unreleased" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7README.adoc:1 +#, no-wrap +msgid "uuid(7README)" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7recipes.adoc:1 +#, no-wrap +msgid "uuid(7recipes)" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7tutorial.adoc:1 +#, no-wrap +msgid "uuid(7tutorial)" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7why.adoc:1 +#, no-wrap +msgid "uuid(7why)" +msgstr "" diff --git a/po/po4a.cfg b/po/po4a.cfg index 3a2afdc..1a592c1 100644 --- a/po/po4a.cfg +++ b/po/po4a.cfg @@ -2,4 +2,11 @@ [po_directory] po -[type: asciidoc] doc/uuid.en.1.adoc $lang:doc/uuid.$lang.1.adoc +[type: asciidoc] doc/uuid.en.0.adoc $lang:doc/uuid.$lang.0.adoc +[type: asciidoc] doc/uuid.en.1.adoc $lang:doc/uuid.$lang.1.adoc +[type: asciidoc] doc/uuid.en.3.adoc $lang:doc/uuid.$lang.3.adoc +[type: asciidoc] doc/uuid.en.7CHANGELOG.adoc $lang:doc/uuid.$lang.7CHANGELOG.adoc +[type: asciidoc] doc/uuid.en.7README.adoc $lang:doc/uuid.$lang.7README.adoc +[type: asciidoc] doc/uuid.en.7recipes.adoc $lang:doc/uuid.$lang.7recipes.adoc +[type: asciidoc] doc/uuid.en.7tutorial.adoc $lang:doc/uuid.$lang.7tutorial.adoc +[type: asciidoc] doc/uuid.en.7why.adoc $lang:doc/uuid.$lang.7why.adoc @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2025-05-04 09:15-0300\n" +"POT-Creation-Date: 2025-05-09 10:10-0300\n" "PO-Revision-Date: 2025-05-04 09:15-0300\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -17,20 +17,46 @@ msgstr "" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #. type: Title = -#: doc/uuid.en.1.adoc:1 +#: doc/uuid.en.0.adoc:1 #, no-wrap -msgid "uuid(1)" +msgid "uuid(0)" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:5 +#: doc/uuid.en.0.adoc:5 doc/uuid.en.1.adoc:5 doc/uuid.en.3.adoc:3 +#: doc/uuid.en.7CHANGELOG.adoc:3 doc/uuid.en.7README.adoc:3 +#: doc/uuid.en.7recipes.adoc:3 doc/uuid.en.7tutorial.adoc:3 +#: doc/uuid.en.7why.adoc:3 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text +#: doc/uuid.en.0.adoc:8 +msgid "uuid - generate or parse UUID values." +msgstr "" + +#. type: Title == +#: doc/uuid.en.0.adoc:11 doc/uuid.en.1.adoc:60 doc/uuid.en.7CHANGELOG.adoc:7 +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: Plain text +#: doc/uuid.en.0.adoc:13 +msgid "" +"*uuid* generates UUID of version 4 or version 7, or validate a given UUID." +msgstr "" + +#. type: Title = +#: doc/uuid.en.1.adoc:1 +#, no-wrap +msgid "uuid(1)" +msgstr "" + +#. type: Plain text #: doc/uuid.en.1.adoc:8 -msgid "uuid - generate or validate a UUIDv4" +msgid "uuid - generate a UUID version 4 or 7, or validate a UUID string." msgstr "" #. type: Title == @@ -40,24 +66,24 @@ msgid "SYNOPSYS" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:14 -msgid "*uuid* [_STRING_]" +#: doc/uuid.en.1.adoc:15 +msgid "*uuid* [-v (4|7)] *uuid* [_STRING_]" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:17 +#: doc/uuid.en.1.adoc:18 #, no-wrap msgid "EXAMPLES" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:20 +#: doc/uuid.en.1.adoc:21 #, no-wrap -msgid "Print a UUID on the terminal" +msgid "Print a (version 4) UUID on the terminal" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:25 +#: doc/uuid.en.1.adoc:27 #, no-wrap msgid "" "$ uuid\n" @@ -65,25 +91,39 @@ msgid "" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:28 +#: doc/uuid.en.1.adoc:30 +#, no-wrap +msgid "Print a verson 7 UUID on the terminal" +msgstr "" + +#. type: delimited block . +#: doc/uuid.en.1.adoc:36 +#, no-wrap +msgid "" +"$ uuid -v 7\n" +"d3891787-c952-af17-d697-0df3b85981e1\n" +msgstr "" + +#. type: Title === +#: doc/uuid.en.1.adoc:39 #, no-wrap msgid "Create a new UUID as part of a path" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:32 +#: doc/uuid.en.1.adoc:44 #, no-wrap msgid "dir=\"$PWD\"/\"$(uuid)\"/data\n" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:35 +#: doc/uuid.en.1.adoc:47 #, no-wrap msgid "Validate a given UUID" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:43 +#: doc/uuid.en.1.adoc:56 #, no-wrap msgid "" "ID=\"$(basename -- \"$directory\")\"\n" @@ -93,212 +133,314 @@ msgid "" "fi\n" msgstr "" +#. type: Plain text +#: doc/uuid.en.1.adoc:65 +msgid "" +"The *uuid* utility generates a new UUID when no _STRING_ is given and write " +"it to _stdout_. If a _STRING_ is given, *uuid* validates it and exits, and " +"produces no output." +msgstr "" + +#. type: Plain text +#: doc/uuid.en.1.adoc:69 +msgid "" +"The *-v* option allows for choosing which type of UUID to be emitted, either " +"version 4 (\"the random one\") or version 7 (\"the sortable one\"). When " +"omitted, version 4 is chosen as default." +msgstr "" + #. type: Title == -#: doc/uuid.en.1.adoc:47 +#: doc/uuid.en.1.adoc:72 #, no-wrap -msgid "DESCRIPTION" +msgid "OPTIONS" +msgstr "" + +#. type: Labeled list +#: doc/uuid.en.1.adoc:74 +#, no-wrap +msgid "*-v NUMBER*" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:52 +#: doc/uuid.en.1.adoc:76 msgid "" -"The *uuid* utility generates a new UUID when no _STRING_ is given and write " -"it to _stdout_. If a _STRING_ is given, *uuid* validates it and exits, and " -"produces no output." +"Choose the UUID version *NUMBER* to be generated. Supported values are 4 " +"(the default) and 7." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:55 +#: doc/uuid.en.1.adoc:79 #, no-wrap msgid "OPERANDS" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:57 +#: doc/uuid.en.1.adoc:81 #, no-wrap msgid "_STRING_" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:58 +#: doc/uuid.en.1.adoc:82 msgid "If it is" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:59 +#: doc/uuid.en.1.adoc:83 #, no-wrap msgid "*not given*" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:61 +#: doc/uuid.en.1.adoc:85 msgid "" "generate a brand new random UUIDv4, print it to _stdout_ and exit normally;" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:61 +#: doc/uuid.en.1.adoc:85 #, no-wrap msgid "*given*" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:62 +#: doc/uuid.en.1.adoc:86 msgid "test if it is a valid UUIDv4 and exit normally if so." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:65 +#: doc/uuid.en.1.adoc:89 #, no-wrap msgid "IO" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:68 +#: doc/uuid.en.1.adoc:92 #, no-wrap msgid "STDIN" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:71 doc/uuid.en.1.adoc:92 +#: doc/uuid.en.1.adoc:95 msgid "Not used." msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:73 +#: doc/uuid.en.1.adoc:97 #, no-wrap msgid "STDOUT" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:77 +#: doc/uuid.en.1.adoc:101 msgid "" "The UUIDv4 format is made of byte blocks encoded as hexadecimals, using a " "<hyphen-minus>('`-`') as the block separator:" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:80 +#: doc/uuid.en.1.adoc:105 #, no-wrap msgid "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX\n" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:83 +#: doc/uuid.en.1.adoc:108 msgid "An example output is:" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:86 +#: doc/uuid.en.1.adoc:112 #, no-wrap msgid "cb46d0c0-b2aa-4a6c-a119-8deace2544a2\n" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:89 +#: doc/uuid.en.1.adoc:115 #, no-wrap msgid "STDERR" msgstr "" +#. type: Plain text +#: doc/uuid.en.1.adoc:118 +msgid "" +"Errors on UUID validation are sent to the standard error. For instance:" +msgstr "" + +#. type: delimited block . +#: doc/uuid.en.1.adoc:123 +#, no-wrap +msgid "" +"$ uuid not-a-uuid-123 1>/dev/null\n" +"uuid: str isn't of the correct length\n" +msgstr "" + +#. type: Plain text +#: doc/uuid.en.1.adoc:126 +msgid "When valid, validation emits nothing and exits with 0." +msgstr "" + #. type: Title === -#: doc/uuid.en.1.adoc:94 +#: doc/uuid.en.1.adoc:128 #, no-wrap msgid "INPUT FILES" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:97 doc/uuid.en.1.adoc:102 +#: doc/uuid.en.1.adoc:131 doc/uuid.en.1.adoc:136 msgid "None." msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:99 +#: doc/uuid.en.1.adoc:133 #, no-wrap msgid "OUTPUT FILES" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:105 +#: doc/uuid.en.1.adoc:139 #, no-wrap msgid "EXIT STATUS" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:107 +#: doc/uuid.en.1.adoc:141 #, no-wrap msgid "0" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:108 +#: doc/uuid.en.1.adoc:142 msgid "Generating or validating a UUID was successfull." msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:108 +#: doc/uuid.en.1.adoc:142 #, no-wrap msgid "3" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:109 +#: doc/uuid.en.1.adoc:143 msgid "UUID validation failed." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:112 +#: doc/uuid.en.1.adoc:146 #, no-wrap msgid "CONFORMING TO" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:115 -msgid "The v4 UUID defined in *RFC 9562*." +#: doc/uuid.en.1.adoc:149 +msgid "The versions 4 and 7 of the UUID defined in *RFC 9562*." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:118 +#: doc/uuid.en.1.adoc:152 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:122 +#: doc/uuid.en.1.adoc:156 #, no-wrap msgid "AUTHORS" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:125 +#: doc/uuid.en.1.adoc:159 msgid "mailto:eu@euandre.org[EuAndreh] and contributors." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:128 +#: doc/uuid.en.1.adoc:162 #, no-wrap msgid "BUGS" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:132 +#: doc/uuid.en.1.adoc:166 msgid "" "Report bugs to the mailto:~euandreh/public-inbox@lists.sr.ht[mailing list]. " "Use the subject \"[uuid] BUG or TASK: <description>\"." msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:133 +#: doc/uuid.en.1.adoc:167 msgid "Browse bugs https://euandre.org/git/uuid/TODOs.html[online]." msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:134 +#: doc/uuid.en.1.adoc:168 msgid "https://euandre.org/git/uuid/[Homepage]." msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:134 +#: doc/uuid.en.1.adoc:168 msgid "" "https://lists.sr.ht/~euandreh/public-inbox?search=%5Buuid%5D[Comments and " "discussions]." msgstr "" + +#. type: Title = +#: doc/uuid.en.3.adoc:1 +#, no-wrap +msgid "uuid(3)" +msgstr "" + +#. type: Plain text +#: doc/uuid.en.3.adoc:5 doc/uuid.en.7CHANGELOG.adoc:6 +#: doc/uuid.en.7README.adoc:5 doc/uuid.en.7recipes.adoc:5 +#: doc/uuid.en.7tutorial.adoc:5 doc/uuid.en.7why.adoc:5 +msgid "uuid - ." +msgstr "" + +#. type: Title = +#: doc/uuid.en.7CHANGELOG.adoc:1 +#, no-wrap +msgid "uuid(7CHANGELOG)" +msgstr "" + +#. Entry template: +#. == Unreleased +#. === Added +#. === Changed +#. === Deprecated +#. === Removed +#. === Fixed +#. === Security +#. type: Plain text +#: doc/uuid.en.7CHANGELOG.adoc:21 +msgid "Changelog for https://euandre.org/s/uuid/en/[uuid]." +msgstr "" + +#. type: Title == +#: doc/uuid.en.7CHANGELOG.adoc:22 +#, no-wrap +msgid "Unreleased" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7README.adoc:1 +#, no-wrap +msgid "uuid(7README)" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7recipes.adoc:1 +#, no-wrap +msgid "uuid(7recipes)" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7tutorial.adoc:1 +#, no-wrap +msgid "uuid(7tutorial)" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7why.adoc:1 +#, no-wrap +msgid "uuid(7why)" +msgstr "" diff --git a/po/uuid.pot b/po/uuid.pot index da2a106..60e398b 100644 --- a/po/uuid.pot +++ b/po/uuid.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2025-05-04 09:15-0300\n" +"POT-Creation-Date: 2025-05-09 10:10-0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -17,20 +17,45 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" #. type: Title = -#: doc/uuid.en.1.adoc:1 +#: doc/uuid.en.0.adoc:1 #, no-wrap -msgid "uuid(1)" +msgid "uuid(0)" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:5 +#: doc/uuid.en.0.adoc:5 doc/uuid.en.1.adoc:5 doc/uuid.en.3.adoc:3 +#: doc/uuid.en.7CHANGELOG.adoc:3 doc/uuid.en.7README.adoc:3 +#: doc/uuid.en.7recipes.adoc:3 doc/uuid.en.7tutorial.adoc:3 +#: doc/uuid.en.7why.adoc:3 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text +#: doc/uuid.en.0.adoc:8 +msgid "uuid - generate or parse UUID values." +msgstr "" + +#. type: Title == +#: doc/uuid.en.0.adoc:11 doc/uuid.en.1.adoc:60 doc/uuid.en.7CHANGELOG.adoc:7 +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: Plain text +#: doc/uuid.en.0.adoc:13 +msgid "*uuid* generates UUID of version 4 or version 7, or validate a given UUID." +msgstr "" + +#. type: Title = +#: doc/uuid.en.1.adoc:1 +#, no-wrap +msgid "uuid(1)" +msgstr "" + +#. type: Plain text #: doc/uuid.en.1.adoc:8 -msgid "uuid - generate or validate a UUIDv4" +msgid "uuid - generate a UUID version 4 or 7, or validate a UUID string." msgstr "" #. type: Title == @@ -40,24 +65,24 @@ msgid "SYNOPSYS" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:14 -msgid "*uuid* [_STRING_]" +#: doc/uuid.en.1.adoc:15 +msgid "*uuid* [-v (4|7)] *uuid* [_STRING_]" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:17 +#: doc/uuid.en.1.adoc:18 #, no-wrap msgid "EXAMPLES" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:20 +#: doc/uuid.en.1.adoc:21 #, no-wrap -msgid "Print a UUID on the terminal" +msgid "Print a (version 4) UUID on the terminal" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:25 +#: doc/uuid.en.1.adoc:27 #, no-wrap msgid "" "$ uuid\n" @@ -65,25 +90,39 @@ msgid "" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:28 +#: doc/uuid.en.1.adoc:30 +#, no-wrap +msgid "Print a verson 7 UUID on the terminal" +msgstr "" + +#. type: delimited block . +#: doc/uuid.en.1.adoc:36 +#, no-wrap +msgid "" +"$ uuid -v 7\n" +"d3891787-c952-af17-d697-0df3b85981e1\n" +msgstr "" + +#. type: Title === +#: doc/uuid.en.1.adoc:39 #, no-wrap msgid "Create a new UUID as part of a path" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:32 +#: doc/uuid.en.1.adoc:44 #, no-wrap msgid "dir=\"$PWD\"/\"$(uuid)\"/data\n" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:35 +#: doc/uuid.en.1.adoc:47 #, no-wrap msgid "Validate a given UUID" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:43 +#: doc/uuid.en.1.adoc:56 #, no-wrap msgid "" "ID=\"$(basename -- \"$directory\")\"\n" @@ -93,211 +132,312 @@ msgid "" "fi\n" msgstr "" +#. type: Plain text +#: doc/uuid.en.1.adoc:65 +msgid "" +"The *uuid* utility generates a new UUID when no _STRING_ is given and write " +"it to _stdout_. If a _STRING_ is given, *uuid* validates it and exits, and " +"produces no output." +msgstr "" + +#. type: Plain text +#: doc/uuid.en.1.adoc:69 +msgid "" +"The *-v* option allows for choosing which type of UUID to be emitted, either " +"version 4 (\"the random one\") or version 7 (\"the sortable one\"). When " +"omitted, version 4 is chosen as default." +msgstr "" + #. type: Title == -#: doc/uuid.en.1.adoc:47 +#: doc/uuid.en.1.adoc:72 #, no-wrap -msgid "DESCRIPTION" +msgid "OPTIONS" +msgstr "" + +#. type: Labeled list +#: doc/uuid.en.1.adoc:74 +#, no-wrap +msgid "*-v NUMBER*" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:52 +#: doc/uuid.en.1.adoc:76 msgid "" -"The *uuid* utility generates a new UUID when no _STRING_ is given and write " -"it to _stdout_. If a _STRING_ is given, *uuid* validates it and exits, and " -"produces no output." +"Choose the UUID version *NUMBER* to be generated. Supported values are 4 " +"(the default) and 7." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:55 +#: doc/uuid.en.1.adoc:79 #, no-wrap msgid "OPERANDS" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:57 +#: doc/uuid.en.1.adoc:81 #, no-wrap msgid "_STRING_" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:58 +#: doc/uuid.en.1.adoc:82 msgid "If it is" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:59 +#: doc/uuid.en.1.adoc:83 #, no-wrap msgid "*not given*" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:61 +#: doc/uuid.en.1.adoc:85 msgid "generate a brand new random UUIDv4, print it to _stdout_ and exit normally;" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:61 +#: doc/uuid.en.1.adoc:85 #, no-wrap msgid "*given*" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:62 +#: doc/uuid.en.1.adoc:86 msgid "test if it is a valid UUIDv4 and exit normally if so." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:65 +#: doc/uuid.en.1.adoc:89 #, no-wrap msgid "IO" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:68 +#: doc/uuid.en.1.adoc:92 #, no-wrap msgid "STDIN" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:71 doc/uuid.en.1.adoc:92 +#: doc/uuid.en.1.adoc:95 msgid "Not used." msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:73 +#: doc/uuid.en.1.adoc:97 #, no-wrap msgid "STDOUT" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:77 +#: doc/uuid.en.1.adoc:101 msgid "" "The UUIDv4 format is made of byte blocks encoded as hexadecimals, using a " "<hyphen-minus>('`-`') as the block separator:" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:80 +#: doc/uuid.en.1.adoc:105 #, no-wrap msgid "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX\n" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:83 +#: doc/uuid.en.1.adoc:108 msgid "An example output is:" msgstr "" #. type: delimited block . -#: doc/uuid.en.1.adoc:86 +#: doc/uuid.en.1.adoc:112 #, no-wrap msgid "cb46d0c0-b2aa-4a6c-a119-8deace2544a2\n" msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:89 +#: doc/uuid.en.1.adoc:115 #, no-wrap msgid "STDERR" msgstr "" +#. type: Plain text +#: doc/uuid.en.1.adoc:118 +msgid "Errors on UUID validation are sent to the standard error. For instance:" +msgstr "" + +#. type: delimited block . +#: doc/uuid.en.1.adoc:123 +#, no-wrap +msgid "" +"$ uuid not-a-uuid-123 1>/dev/null\n" +"uuid: str isn't of the correct length\n" +msgstr "" + +#. type: Plain text +#: doc/uuid.en.1.adoc:126 +msgid "When valid, validation emits nothing and exits with 0." +msgstr "" + #. type: Title === -#: doc/uuid.en.1.adoc:94 +#: doc/uuid.en.1.adoc:128 #, no-wrap msgid "INPUT FILES" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:97 doc/uuid.en.1.adoc:102 +#: doc/uuid.en.1.adoc:131 doc/uuid.en.1.adoc:136 msgid "None." msgstr "" #. type: Title === -#: doc/uuid.en.1.adoc:99 +#: doc/uuid.en.1.adoc:133 #, no-wrap msgid "OUTPUT FILES" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:105 +#: doc/uuid.en.1.adoc:139 #, no-wrap msgid "EXIT STATUS" msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:107 +#: doc/uuid.en.1.adoc:141 #, no-wrap msgid "0" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:108 +#: doc/uuid.en.1.adoc:142 msgid "Generating or validating a UUID was successfull." msgstr "" #. type: Labeled list -#: doc/uuid.en.1.adoc:108 +#: doc/uuid.en.1.adoc:142 #, no-wrap msgid "3" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:109 +#: doc/uuid.en.1.adoc:143 msgid "UUID validation failed." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:112 +#: doc/uuid.en.1.adoc:146 #, no-wrap msgid "CONFORMING TO" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:115 -msgid "The v4 UUID defined in *RFC 9562*." +#: doc/uuid.en.1.adoc:149 +msgid "The versions 4 and 7 of the UUID defined in *RFC 9562*." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:118 +#: doc/uuid.en.1.adoc:152 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:122 +#: doc/uuid.en.1.adoc:156 #, no-wrap msgid "AUTHORS" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:125 +#: doc/uuid.en.1.adoc:159 msgid "mailto:eu@euandre.org[EuAndreh] and contributors." msgstr "" #. type: Title == -#: doc/uuid.en.1.adoc:128 +#: doc/uuid.en.1.adoc:162 #, no-wrap msgid "BUGS" msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:132 +#: doc/uuid.en.1.adoc:166 msgid "" "Report bugs to the mailto:~euandreh/public-inbox@lists.sr.ht[mailing list]. " "Use the subject \"[uuid] BUG or TASK: <description>\"." msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:133 +#: doc/uuid.en.1.adoc:167 msgid "Browse bugs https://euandre.org/git/uuid/TODOs.html[online]." msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:134 +#: doc/uuid.en.1.adoc:168 msgid "https://euandre.org/git/uuid/[Homepage]." msgstr "" #. type: Plain text -#: doc/uuid.en.1.adoc:134 +#: doc/uuid.en.1.adoc:168 msgid "" "https://lists.sr.ht/~euandreh/public-inbox?search=%5Buuid%5D[Comments and " "discussions]." msgstr "" + +#. type: Title = +#: doc/uuid.en.3.adoc:1 +#, no-wrap +msgid "uuid(3)" +msgstr "" + +#. type: Plain text +#: doc/uuid.en.3.adoc:5 doc/uuid.en.7CHANGELOG.adoc:6 +#: doc/uuid.en.7README.adoc:5 doc/uuid.en.7recipes.adoc:5 +#: doc/uuid.en.7tutorial.adoc:5 doc/uuid.en.7why.adoc:5 +msgid "uuid - ." +msgstr "" + +#. type: Title = +#: doc/uuid.en.7CHANGELOG.adoc:1 +#, no-wrap +msgid "uuid(7CHANGELOG)" +msgstr "" + +#. Entry template: +#. == Unreleased +#. === Added +#. === Changed +#. === Deprecated +#. === Removed +#. === Fixed +#. === Security +#. type: Plain text +#: doc/uuid.en.7CHANGELOG.adoc:21 +msgid "Changelog for https://euandre.org/s/uuid/en/[uuid]." +msgstr "" + +#. type: Title == +#: doc/uuid.en.7CHANGELOG.adoc:22 +#, no-wrap +msgid "Unreleased" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7README.adoc:1 +#, no-wrap +msgid "uuid(7README)" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7recipes.adoc:1 +#, no-wrap +msgid "uuid(7recipes)" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7tutorial.adoc:1 +#, no-wrap +msgid "uuid(7tutorial)" +msgstr "" + +#. type: Title = +#: doc/uuid.en.7why.adoc:1 +#, no-wrap +msgid "uuid(7why)" +msgstr "" |