summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorEuAndreh <eu@euandre.org>2025-05-14 17:17:50 -0300
committerEuAndreh <eu@euandre.org>2025-05-14 17:36:00 -0300
commit07276d16b83d2fd78ac8948da89820337160e278 (patch)
tree2baa874af86357e9760f1f977e7d6870e313cbed /doc
parentdoc/: Add uuid.en.{0,3,7.{CHANGELOG,README,TODOs,recipes,tutorial,why}}.adoc (diff)
downloaduuid-07276d16b83d2fd78ac8948da89820337160e278.tar.gz
uuid-07276d16b83d2fd78ac8948da89820337160e278.tar.xz
Revamp i18n: use gotext
Diffstat (limited to 'doc')
-rw-r--r--doc/uuid.de.0.adoc13
-rw-r--r--doc/uuid.de.1.adoc159
-rw-r--r--doc/uuid.de.3.adoc5
-rw-r--r--doc/uuid.de.7CHANGELOG.adoc22
-rw-r--r--doc/uuid.de.7README.adoc5
-rw-r--r--doc/uuid.de.7recipes.adoc5
-rw-r--r--doc/uuid.de.7tutorial.adoc5
-rw-r--r--doc/uuid.de.7why.adoc5
-rw-r--r--doc/uuid.eo.0.adoc13
-rw-r--r--doc/uuid.eo.1.adoc159
-rw-r--r--doc/uuid.eo.3.adoc5
-rw-r--r--doc/uuid.eo.7CHANGELOG.adoc22
-rw-r--r--doc/uuid.eo.7README.adoc5
-rw-r--r--doc/uuid.eo.7recipes.adoc5
-rw-r--r--doc/uuid.eo.7tutorial.adoc5
-rw-r--r--doc/uuid.eo.7why.adoc5
-rw-r--r--doc/uuid.es.0.adoc13
-rw-r--r--doc/uuid.es.1.adoc159
-rw-r--r--doc/uuid.es.3.adoc5
-rw-r--r--doc/uuid.es.7CHANGELOG.adoc22
-rw-r--r--doc/uuid.es.7README.adoc5
-rw-r--r--doc/uuid.es.7recipes.adoc5
-rw-r--r--doc/uuid.es.7tutorial.adoc5
-rw-r--r--doc/uuid.es.7why.adoc5
-rw-r--r--doc/uuid.fr.0.adoc13
-rw-r--r--doc/uuid.fr.1.adoc159
-rw-r--r--doc/uuid.fr.3.adoc5
-rw-r--r--doc/uuid.fr.7CHANGELOG.adoc22
-rw-r--r--doc/uuid.fr.7README.adoc5
-rw-r--r--doc/uuid.fr.7recipes.adoc5
-rw-r--r--doc/uuid.fr.7tutorial.adoc5
-rw-r--r--doc/uuid.fr.7why.adoc5
-rw-r--r--doc/uuid.pt.0.adoc13
-rw-r--r--doc/uuid.pt.1.adoc159
-rw-r--r--doc/uuid.pt.3.adoc5
-rw-r--r--doc/uuid.pt.7CHANGELOG.adoc22
-rw-r--r--doc/uuid.pt.7README.adoc5
-rw-r--r--doc/uuid.pt.7recipes.adoc5
-rw-r--r--doc/uuid.pt.7tutorial.adoc5
-rw-r--r--doc/uuid.pt.7why.adoc5
40 files changed, 0 insertions, 1095 deletions
diff --git a/doc/uuid.de.0.adoc b/doc/uuid.de.0.adoc
deleted file mode 100644
index 1670ad5..0000000
--- a/doc/uuid.de.0.adoc
+++ /dev/null
@@ -1,13 +0,0 @@
-= uuid(0)
-
-
-
-== NAME
-
-uuid - generate or parse UUID values.
-
-
-
-== DESCRIPTION
-
-*uuid* generates UUID of version 4 or version 7, or validate a given UUID.
diff --git a/doc/uuid.de.1.adoc b/doc/uuid.de.1.adoc
deleted file mode 100644
index e64c665..0000000
--- a/doc/uuid.de.1.adoc
+++ /dev/null
@@ -1,159 +0,0 @@
-= uuid(1)
-
-
-
-== NAME
-
-uuid - generate a UUID version 4 or 7, or validate a UUID string.
-
-
-
-== SYNOPSYS
-
-*uuid* [-v (4|7)] *uuid* [_STRING_]
-
-
-
-== EXAMPLES
-
-
-=== Print a (version 4) UUID on the terminal
-
-[source, sh]
-....
-$ uuid
-d3891787-c952-af17-d697-0df3b85981e1
-....
-
-
-=== Print a verson 7 UUID on the terminal
-
-[source, sh]
-....
-$ uuid -v 7
-d3891787-c952-af17-d697-0df3b85981e1
-....
-
-
-=== Create a new UUID as part of a path
-
-[source, sh]
-....
-dir="$PWD"/"$(uuid)"/data
-....
-
-
-=== Validate a given UUID
-
-[source, sh]
-....
-ID="$(basename -- "$directory")"
-if ! uuid "$ID"; then
- echo "Bad UUID in directory: $ID" >&2
- exit 1
-fi
-....
-
-
-
-== DESCRIPTION
-
-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.
-
-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.
-
-
-
-== OPTIONS
-
-*-v NUMBER*:: Choose the UUID version *NUMBER* to be generated. Supported values are 4 (the default) and 7.
-
-
-
-== OPERANDS
-
-_STRING_:: If it is
-
- *not given*::: generate a brand new random UUIDv4, print it to _stdout_ and exit normally;
- *given*::: test if it is a valid UUIDv4 and exit normally if so.
-
-
-
-== IO
-
-
-=== STDIN
-
-Not used.
-
-
-=== STDOUT
-
-The UUIDv4 format is made of byte blocks encoded as hexadecimals, using a <hyphen-minus>('`-`') as the block separator:
-
-[source, sh]
-....
-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
-....
-
-An example output is:
-
-[source, sh]
-....
-cb46d0c0-b2aa-4a6c-a119-8deace2544a2
-....
-
-
-=== STDERR
-
-Errors on UUID validation are sent to the standard error. For instance:
-
-[source, sh]
-....
-$ uuid not-a-uuid-123 1>/dev/null
-uuid: str isn't of the correct length
-....
-
-When valid, validation emits nothing and exits with 0.
-
-
-=== INPUT FILES
-
-None.
-
-
-=== OUTPUT FILES
-
-None.
-
-
-
-== EXIT STATUS
-
-0:: Generating or validating a UUID was successfull.
-3:: UUID validation failed.
-
-
-
-== CONFORMING TO
-
-The versions 4 and 7 of the UUID defined in *RFC 9562*.
-
-
-
-== SEE ALSO
-
-
-
-== AUTHORS
-
-mailto:eu@euandre.org[EuAndreh] and contributors.
-
-
-
-== BUGS
-
-* Report bugs to the mailto:~euandreh/public-inbox@lists.sr.ht[mailing list]. Use the subject "[uuid] BUG or TASK: <description>".
-* Browse bugs https://euandre.org/git/uuid/TODOs.html[online].
-* https://euandre.org/git/uuid/[Homepage].
-* https://lists.sr.ht/~euandreh/public-inbox?search=%5Buuid%5D[Comments and discussions].
diff --git a/doc/uuid.de.3.adoc b/doc/uuid.de.3.adoc
deleted file mode 100644
index 24fcde5..0000000
--- a/doc/uuid.de.3.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(3)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.de.7CHANGELOG.adoc b/doc/uuid.de.7CHANGELOG.adoc
deleted file mode 100644
index e1b6975..0000000
--- a/doc/uuid.de.7CHANGELOG.adoc
+++ /dev/null
@@ -1,22 +0,0 @@
-= uuid(7CHANGELOG)
-
-== NAME
-
-uuid - .
-
-== DESCRIPTION
-
-////
-Entry template:
-== Unreleased
-=== Added
-=== Changed
-=== Deprecated
-=== Removed
-=== Fixed
-=== Security
-////
-
-Changelog for https://euandre.org/s/uuid/en/[uuid].
-
-== Unreleased
diff --git a/doc/uuid.de.7README.adoc b/doc/uuid.de.7README.adoc
deleted file mode 100644
index 3def718..0000000
--- a/doc/uuid.de.7README.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(7README)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.de.7recipes.adoc b/doc/uuid.de.7recipes.adoc
deleted file mode 100644
index 2f20a16..0000000
--- a/doc/uuid.de.7recipes.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(7recipes)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.de.7tutorial.adoc b/doc/uuid.de.7tutorial.adoc
deleted file mode 100644
index 1a77799..0000000
--- a/doc/uuid.de.7tutorial.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(7tutorial)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.de.7why.adoc b/doc/uuid.de.7why.adoc
deleted file mode 100644
index 51096c1..0000000
--- a/doc/uuid.de.7why.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(7why)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.eo.0.adoc b/doc/uuid.eo.0.adoc
deleted file mode 100644
index 1670ad5..0000000
--- a/doc/uuid.eo.0.adoc
+++ /dev/null
@@ -1,13 +0,0 @@
-= uuid(0)
-
-
-
-== NAME
-
-uuid - generate or parse UUID values.
-
-
-
-== DESCRIPTION
-
-*uuid* generates UUID of version 4 or version 7, or validate a given UUID.
diff --git a/doc/uuid.eo.1.adoc b/doc/uuid.eo.1.adoc
deleted file mode 100644
index e64c665..0000000
--- a/doc/uuid.eo.1.adoc
+++ /dev/null
@@ -1,159 +0,0 @@
-= uuid(1)
-
-
-
-== NAME
-
-uuid - generate a UUID version 4 or 7, or validate a UUID string.
-
-
-
-== SYNOPSYS
-
-*uuid* [-v (4|7)] *uuid* [_STRING_]
-
-
-
-== EXAMPLES
-
-
-=== Print a (version 4) UUID on the terminal
-
-[source, sh]
-....
-$ uuid
-d3891787-c952-af17-d697-0df3b85981e1
-....
-
-
-=== Print a verson 7 UUID on the terminal
-
-[source, sh]
-....
-$ uuid -v 7
-d3891787-c952-af17-d697-0df3b85981e1
-....
-
-
-=== Create a new UUID as part of a path
-
-[source, sh]
-....
-dir="$PWD"/"$(uuid)"/data
-....
-
-
-=== Validate a given UUID
-
-[source, sh]
-....
-ID="$(basename -- "$directory")"
-if ! uuid "$ID"; then
- echo "Bad UUID in directory: $ID" >&2
- exit 1
-fi
-....
-
-
-
-== DESCRIPTION
-
-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.
-
-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.
-
-
-
-== OPTIONS
-
-*-v NUMBER*:: Choose the UUID version *NUMBER* to be generated. Supported values are 4 (the default) and 7.
-
-
-
-== OPERANDS
-
-_STRING_:: If it is
-
- *not given*::: generate a brand new random UUIDv4, print it to _stdout_ and exit normally;
- *given*::: test if it is a valid UUIDv4 and exit normally if so.
-
-
-
-== IO
-
-
-=== STDIN
-
-Not used.
-
-
-=== STDOUT
-
-The UUIDv4 format is made of byte blocks encoded as hexadecimals, using a <hyphen-minus>('`-`') as the block separator:
-
-[source, sh]
-....
-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
-....
-
-An example output is:
-
-[source, sh]
-....
-cb46d0c0-b2aa-4a6c-a119-8deace2544a2
-....
-
-
-=== STDERR
-
-Errors on UUID validation are sent to the standard error. For instance:
-
-[source, sh]
-....
-$ uuid not-a-uuid-123 1>/dev/null
-uuid: str isn't of the correct length
-....
-
-When valid, validation emits nothing and exits with 0.
-
-
-=== INPUT FILES
-
-None.
-
-
-=== OUTPUT FILES
-
-None.
-
-
-
-== EXIT STATUS
-
-0:: Generating or validating a UUID was successfull.
-3:: UUID validation failed.
-
-
-
-== CONFORMING TO
-
-The versions 4 and 7 of the UUID defined in *RFC 9562*.
-
-
-
-== SEE ALSO
-
-
-
-== AUTHORS
-
-mailto:eu@euandre.org[EuAndreh] and contributors.
-
-
-
-== BUGS
-
-* Report bugs to the mailto:~euandreh/public-inbox@lists.sr.ht[mailing list]. Use the subject "[uuid] BUG or TASK: <description>".
-* Browse bugs https://euandre.org/git/uuid/TODOs.html[online].
-* https://euandre.org/git/uuid/[Homepage].
-* https://lists.sr.ht/~euandreh/public-inbox?search=%5Buuid%5D[Comments and discussions].
diff --git a/doc/uuid.eo.3.adoc b/doc/uuid.eo.3.adoc
deleted file mode 100644
index 24fcde5..0000000
--- a/doc/uuid.eo.3.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(3)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.eo.7CHANGELOG.adoc b/doc/uuid.eo.7CHANGELOG.adoc
deleted file mode 100644
index e1b6975..0000000
--- a/doc/uuid.eo.7CHANGELOG.adoc
+++ /dev/null
@@ -1,22 +0,0 @@
-= uuid(7CHANGELOG)
-
-== NAME
-
-uuid - .
-
-== DESCRIPTION
-
-////
-Entry template:
-== Unreleased
-=== Added
-=== Changed
-=== Deprecated
-=== Removed
-=== Fixed
-=== Security
-////
-
-Changelog for https://euandre.org/s/uuid/en/[uuid].
-
-== Unreleased
diff --git a/doc/uuid.eo.7README.adoc b/doc/uuid.eo.7README.adoc
deleted file mode 100644
index 3def718..0000000
--- a/doc/uuid.eo.7README.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(7README)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.eo.7recipes.adoc b/doc/uuid.eo.7recipes.adoc
deleted file mode 100644
index 2f20a16..0000000
--- a/doc/uuid.eo.7recipes.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(7recipes)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.eo.7tutorial.adoc b/doc/uuid.eo.7tutorial.adoc
deleted file mode 100644
index 1a77799..0000000
--- a/doc/uuid.eo.7tutorial.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(7tutorial)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.eo.7why.adoc b/doc/uuid.eo.7why.adoc
deleted file mode 100644
index 51096c1..0000000
--- a/doc/uuid.eo.7why.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(7why)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.es.0.adoc b/doc/uuid.es.0.adoc
deleted file mode 100644
index 1670ad5..0000000
--- a/doc/uuid.es.0.adoc
+++ /dev/null
@@ -1,13 +0,0 @@
-= uuid(0)
-
-
-
-== NAME
-
-uuid - generate or parse UUID values.
-
-
-
-== DESCRIPTION
-
-*uuid* generates UUID of version 4 or version 7, or validate a given UUID.
diff --git a/doc/uuid.es.1.adoc b/doc/uuid.es.1.adoc
deleted file mode 100644
index e64c665..0000000
--- a/doc/uuid.es.1.adoc
+++ /dev/null
@@ -1,159 +0,0 @@
-= uuid(1)
-
-
-
-== NAME
-
-uuid - generate a UUID version 4 or 7, or validate a UUID string.
-
-
-
-== SYNOPSYS
-
-*uuid* [-v (4|7)] *uuid* [_STRING_]
-
-
-
-== EXAMPLES
-
-
-=== Print a (version 4) UUID on the terminal
-
-[source, sh]
-....
-$ uuid
-d3891787-c952-af17-d697-0df3b85981e1
-....
-
-
-=== Print a verson 7 UUID on the terminal
-
-[source, sh]
-....
-$ uuid -v 7
-d3891787-c952-af17-d697-0df3b85981e1
-....
-
-
-=== Create a new UUID as part of a path
-
-[source, sh]
-....
-dir="$PWD"/"$(uuid)"/data
-....
-
-
-=== Validate a given UUID
-
-[source, sh]
-....
-ID="$(basename -- "$directory")"
-if ! uuid "$ID"; then
- echo "Bad UUID in directory: $ID" >&2
- exit 1
-fi
-....
-
-
-
-== DESCRIPTION
-
-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.
-
-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.
-
-
-
-== OPTIONS
-
-*-v NUMBER*:: Choose the UUID version *NUMBER* to be generated. Supported values are 4 (the default) and 7.
-
-
-
-== OPERANDS
-
-_STRING_:: If it is
-
- *not given*::: generate a brand new random UUIDv4, print it to _stdout_ and exit normally;
- *given*::: test if it is a valid UUIDv4 and exit normally if so.
-
-
-
-== IO
-
-
-=== STDIN
-
-Not used.
-
-
-=== STDOUT
-
-The UUIDv4 format is made of byte blocks encoded as hexadecimals, using a <hyphen-minus>('`-`') as the block separator:
-
-[source, sh]
-....
-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
-....
-
-An example output is:
-
-[source, sh]
-....
-cb46d0c0-b2aa-4a6c-a119-8deace2544a2
-....
-
-
-=== STDERR
-
-Errors on UUID validation are sent to the standard error. For instance:
-
-[source, sh]
-....
-$ uuid not-a-uuid-123 1>/dev/null
-uuid: str isn't of the correct length
-....
-
-When valid, validation emits nothing and exits with 0.
-
-
-=== INPUT FILES
-
-None.
-
-
-=== OUTPUT FILES
-
-None.
-
-
-
-== EXIT STATUS
-
-0:: Generating or validating a UUID was successfull.
-3:: UUID validation failed.
-
-
-
-== CONFORMING TO
-
-The versions 4 and 7 of the UUID defined in *RFC 9562*.
-
-
-
-== SEE ALSO
-
-
-
-== AUTHORS
-
-mailto:eu@euandre.org[EuAndreh] and contributors.
-
-
-
-== BUGS
-
-* Report bugs to the mailto:~euandreh/public-inbox@lists.sr.ht[mailing list]. Use the subject "[uuid] BUG or TASK: <description>".
-* Browse bugs https://euandre.org/git/uuid/TODOs.html[online].
-* https://euandre.org/git/uuid/[Homepage].
-* https://lists.sr.ht/~euandreh/public-inbox?search=%5Buuid%5D[Comments and discussions].
diff --git a/doc/uuid.es.3.adoc b/doc/uuid.es.3.adoc
deleted file mode 100644
index 24fcde5..0000000
--- a/doc/uuid.es.3.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(3)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.es.7CHANGELOG.adoc b/doc/uuid.es.7CHANGELOG.adoc
deleted file mode 100644
index e1b6975..0000000
--- a/doc/uuid.es.7CHANGELOG.adoc
+++ /dev/null
@@ -1,22 +0,0 @@
-= uuid(7CHANGELOG)
-
-== NAME
-
-uuid - .
-
-== DESCRIPTION
-
-////
-Entry template:
-== Unreleased
-=== Added
-=== Changed
-=== Deprecated
-=== Removed
-=== Fixed
-=== Security
-////
-
-Changelog for https://euandre.org/s/uuid/en/[uuid].
-
-== Unreleased
diff --git a/doc/uuid.es.7README.adoc b/doc/uuid.es.7README.adoc
deleted file mode 100644
index 3def718..0000000
--- a/doc/uuid.es.7README.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(7README)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.es.7recipes.adoc b/doc/uuid.es.7recipes.adoc
deleted file mode 100644
index 2f20a16..0000000
--- a/doc/uuid.es.7recipes.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(7recipes)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.es.7tutorial.adoc b/doc/uuid.es.7tutorial.adoc
deleted file mode 100644
index 1a77799..0000000
--- a/doc/uuid.es.7tutorial.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(7tutorial)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.es.7why.adoc b/doc/uuid.es.7why.adoc
deleted file mode 100644
index 51096c1..0000000
--- a/doc/uuid.es.7why.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(7why)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.fr.0.adoc b/doc/uuid.fr.0.adoc
deleted file mode 100644
index 1670ad5..0000000
--- a/doc/uuid.fr.0.adoc
+++ /dev/null
@@ -1,13 +0,0 @@
-= uuid(0)
-
-
-
-== NAME
-
-uuid - generate or parse UUID values.
-
-
-
-== DESCRIPTION
-
-*uuid* generates UUID of version 4 or version 7, or validate a given UUID.
diff --git a/doc/uuid.fr.1.adoc b/doc/uuid.fr.1.adoc
deleted file mode 100644
index e64c665..0000000
--- a/doc/uuid.fr.1.adoc
+++ /dev/null
@@ -1,159 +0,0 @@
-= uuid(1)
-
-
-
-== NAME
-
-uuid - generate a UUID version 4 or 7, or validate a UUID string.
-
-
-
-== SYNOPSYS
-
-*uuid* [-v (4|7)] *uuid* [_STRING_]
-
-
-
-== EXAMPLES
-
-
-=== Print a (version 4) UUID on the terminal
-
-[source, sh]
-....
-$ uuid
-d3891787-c952-af17-d697-0df3b85981e1
-....
-
-
-=== Print a verson 7 UUID on the terminal
-
-[source, sh]
-....
-$ uuid -v 7
-d3891787-c952-af17-d697-0df3b85981e1
-....
-
-
-=== Create a new UUID as part of a path
-
-[source, sh]
-....
-dir="$PWD"/"$(uuid)"/data
-....
-
-
-=== Validate a given UUID
-
-[source, sh]
-....
-ID="$(basename -- "$directory")"
-if ! uuid "$ID"; then
- echo "Bad UUID in directory: $ID" >&2
- exit 1
-fi
-....
-
-
-
-== DESCRIPTION
-
-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.
-
-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.
-
-
-
-== OPTIONS
-
-*-v NUMBER*:: Choose the UUID version *NUMBER* to be generated. Supported values are 4 (the default) and 7.
-
-
-
-== OPERANDS
-
-_STRING_:: If it is
-
- *not given*::: generate a brand new random UUIDv4, print it to _stdout_ and exit normally;
- *given*::: test if it is a valid UUIDv4 and exit normally if so.
-
-
-
-== IO
-
-
-=== STDIN
-
-Not used.
-
-
-=== STDOUT
-
-The UUIDv4 format is made of byte blocks encoded as hexadecimals, using a <hyphen-minus>('`-`') as the block separator:
-
-[source, sh]
-....
-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
-....
-
-An example output is:
-
-[source, sh]
-....
-cb46d0c0-b2aa-4a6c-a119-8deace2544a2
-....
-
-
-=== STDERR
-
-Errors on UUID validation are sent to the standard error. For instance:
-
-[source, sh]
-....
-$ uuid not-a-uuid-123 1>/dev/null
-uuid: str isn't of the correct length
-....
-
-When valid, validation emits nothing and exits with 0.
-
-
-=== INPUT FILES
-
-None.
-
-
-=== OUTPUT FILES
-
-None.
-
-
-
-== EXIT STATUS
-
-0:: Generating or validating a UUID was successfull.
-3:: UUID validation failed.
-
-
-
-== CONFORMING TO
-
-The versions 4 and 7 of the UUID defined in *RFC 9562*.
-
-
-
-== SEE ALSO
-
-
-
-== AUTHORS
-
-mailto:eu@euandre.org[EuAndreh] and contributors.
-
-
-
-== BUGS
-
-* Report bugs to the mailto:~euandreh/public-inbox@lists.sr.ht[mailing list]. Use the subject "[uuid] BUG or TASK: <description>".
-* Browse bugs https://euandre.org/git/uuid/TODOs.html[online].
-* https://euandre.org/git/uuid/[Homepage].
-* https://lists.sr.ht/~euandreh/public-inbox?search=%5Buuid%5D[Comments and discussions].
diff --git a/doc/uuid.fr.3.adoc b/doc/uuid.fr.3.adoc
deleted file mode 100644
index 24fcde5..0000000
--- a/doc/uuid.fr.3.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(3)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.fr.7CHANGELOG.adoc b/doc/uuid.fr.7CHANGELOG.adoc
deleted file mode 100644
index e1b6975..0000000
--- a/doc/uuid.fr.7CHANGELOG.adoc
+++ /dev/null
@@ -1,22 +0,0 @@
-= uuid(7CHANGELOG)
-
-== NAME
-
-uuid - .
-
-== DESCRIPTION
-
-////
-Entry template:
-== Unreleased
-=== Added
-=== Changed
-=== Deprecated
-=== Removed
-=== Fixed
-=== Security
-////
-
-Changelog for https://euandre.org/s/uuid/en/[uuid].
-
-== Unreleased
diff --git a/doc/uuid.fr.7README.adoc b/doc/uuid.fr.7README.adoc
deleted file mode 100644
index 3def718..0000000
--- a/doc/uuid.fr.7README.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(7README)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.fr.7recipes.adoc b/doc/uuid.fr.7recipes.adoc
deleted file mode 100644
index 2f20a16..0000000
--- a/doc/uuid.fr.7recipes.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(7recipes)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.fr.7tutorial.adoc b/doc/uuid.fr.7tutorial.adoc
deleted file mode 100644
index 1a77799..0000000
--- a/doc/uuid.fr.7tutorial.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(7tutorial)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.fr.7why.adoc b/doc/uuid.fr.7why.adoc
deleted file mode 100644
index 51096c1..0000000
--- a/doc/uuid.fr.7why.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(7why)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.pt.0.adoc b/doc/uuid.pt.0.adoc
deleted file mode 100644
index 1670ad5..0000000
--- a/doc/uuid.pt.0.adoc
+++ /dev/null
@@ -1,13 +0,0 @@
-= uuid(0)
-
-
-
-== NAME
-
-uuid - generate or parse UUID values.
-
-
-
-== DESCRIPTION
-
-*uuid* generates UUID of version 4 or version 7, or validate a given UUID.
diff --git a/doc/uuid.pt.1.adoc b/doc/uuid.pt.1.adoc
deleted file mode 100644
index e64c665..0000000
--- a/doc/uuid.pt.1.adoc
+++ /dev/null
@@ -1,159 +0,0 @@
-= uuid(1)
-
-
-
-== NAME
-
-uuid - generate a UUID version 4 or 7, or validate a UUID string.
-
-
-
-== SYNOPSYS
-
-*uuid* [-v (4|7)] *uuid* [_STRING_]
-
-
-
-== EXAMPLES
-
-
-=== Print a (version 4) UUID on the terminal
-
-[source, sh]
-....
-$ uuid
-d3891787-c952-af17-d697-0df3b85981e1
-....
-
-
-=== Print a verson 7 UUID on the terminal
-
-[source, sh]
-....
-$ uuid -v 7
-d3891787-c952-af17-d697-0df3b85981e1
-....
-
-
-=== Create a new UUID as part of a path
-
-[source, sh]
-....
-dir="$PWD"/"$(uuid)"/data
-....
-
-
-=== Validate a given UUID
-
-[source, sh]
-....
-ID="$(basename -- "$directory")"
-if ! uuid "$ID"; then
- echo "Bad UUID in directory: $ID" >&2
- exit 1
-fi
-....
-
-
-
-== DESCRIPTION
-
-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.
-
-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.
-
-
-
-== OPTIONS
-
-*-v NUMBER*:: Choose the UUID version *NUMBER* to be generated. Supported values are 4 (the default) and 7.
-
-
-
-== OPERANDS
-
-_STRING_:: If it is
-
- *not given*::: generate a brand new random UUIDv4, print it to _stdout_ and exit normally;
- *given*::: test if it is a valid UUIDv4 and exit normally if so.
-
-
-
-== IO
-
-
-=== STDIN
-
-Not used.
-
-
-=== STDOUT
-
-The UUIDv4 format is made of byte blocks encoded as hexadecimals, using a <hyphen-minus>('`-`') as the block separator:
-
-[source, sh]
-....
-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
-....
-
-An example output is:
-
-[source, sh]
-....
-cb46d0c0-b2aa-4a6c-a119-8deace2544a2
-....
-
-
-=== STDERR
-
-Errors on UUID validation are sent to the standard error. For instance:
-
-[source, sh]
-....
-$ uuid not-a-uuid-123 1>/dev/null
-uuid: str isn't of the correct length
-....
-
-When valid, validation emits nothing and exits with 0.
-
-
-=== INPUT FILES
-
-None.
-
-
-=== OUTPUT FILES
-
-None.
-
-
-
-== EXIT STATUS
-
-0:: Generating or validating a UUID was successfull.
-3:: UUID validation failed.
-
-
-
-== CONFORMING TO
-
-The versions 4 and 7 of the UUID defined in *RFC 9562*.
-
-
-
-== SEE ALSO
-
-
-
-== AUTHORS
-
-mailto:eu@euandre.org[EuAndreh] and contributors.
-
-
-
-== BUGS
-
-* Report bugs to the mailto:~euandreh/public-inbox@lists.sr.ht[mailing list]. Use the subject "[uuid] BUG or TASK: <description>".
-* Browse bugs https://euandre.org/git/uuid/TODOs.html[online].
-* https://euandre.org/git/uuid/[Homepage].
-* https://lists.sr.ht/~euandreh/public-inbox?search=%5Buuid%5D[Comments and discussions].
diff --git a/doc/uuid.pt.3.adoc b/doc/uuid.pt.3.adoc
deleted file mode 100644
index 24fcde5..0000000
--- a/doc/uuid.pt.3.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(3)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.pt.7CHANGELOG.adoc b/doc/uuid.pt.7CHANGELOG.adoc
deleted file mode 100644
index e1b6975..0000000
--- a/doc/uuid.pt.7CHANGELOG.adoc
+++ /dev/null
@@ -1,22 +0,0 @@
-= uuid(7CHANGELOG)
-
-== NAME
-
-uuid - .
-
-== DESCRIPTION
-
-////
-Entry template:
-== Unreleased
-=== Added
-=== Changed
-=== Deprecated
-=== Removed
-=== Fixed
-=== Security
-////
-
-Changelog for https://euandre.org/s/uuid/en/[uuid].
-
-== Unreleased
diff --git a/doc/uuid.pt.7README.adoc b/doc/uuid.pt.7README.adoc
deleted file mode 100644
index 3def718..0000000
--- a/doc/uuid.pt.7README.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(7README)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.pt.7recipes.adoc b/doc/uuid.pt.7recipes.adoc
deleted file mode 100644
index 2f20a16..0000000
--- a/doc/uuid.pt.7recipes.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(7recipes)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.pt.7tutorial.adoc b/doc/uuid.pt.7tutorial.adoc
deleted file mode 100644
index 1a77799..0000000
--- a/doc/uuid.pt.7tutorial.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(7tutorial)
-
-== NAME
-
-uuid - .
diff --git a/doc/uuid.pt.7why.adoc b/doc/uuid.pt.7why.adoc
deleted file mode 100644
index 51096c1..0000000
--- a/doc/uuid.pt.7why.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-= uuid(7why)
-
-== NAME
-
-uuid - .