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 19de577e5120eed9c7ea428d8cc20695619c6377..596cdbf4feec07b0cfd5bd7e90fd5ed78be3f425 100644 (file)
--- 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