From: Pádraig Brady <P@draigBrady.com>
Date: Sun, 10 Aug 2025 15:15:37 +0000 (+0100)
Subject: doc: --base58: add example usage to info
X-Git-Tag: v9.8~112
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=192e09042fad51f417f801c376c772552517e112;p=thirdparty%2Fcoreutils.git

doc: --base58: add example usage to info

* doc/coreutils.texi (basenc invocation): Add an example
using --base58 to generate a unique ID.  This also demonstrates
compound usage of the basenc command, to convert to/from binary.
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 19de577e51..596cdbf4fe 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -2378,6 +2378,10 @@ The format conforms to
 Base58 draft}.
 This encoding is useful for transcription as the output avoids
 visually similar characters.  It's best suited to smaller amounts of data.
+For example this generates a unique 128 bit ID in 22 bytes:
+@example
+uuidgen | basenc --base16 -di | basenc --base58
+@end example
 
 @item --base32
 @opindex --base32