git: 6e74b603fc02 - main - uuidgen(1): Add EXAMPLES to manual page

The branch main has been updated by fernape:

URL: https://cgit.FreeBSD.org/src/commit/?id=6e74b603fc021761c0a20e08f58b674f45ad5f04

commit 6e74b603fc021761c0a20e08f58b674f45ad5f04
Author:     Fernando Apesteguía <fernape@FreeBSD.org>
AuthorDate: 2023-09-07 15:17:38 +0000
Commit:     Fernando Apesteguía <fernape@FreeBSD.org>
CommitDate: 2024-04-27 18:53:59 +0000

    uuidgen(1): Add EXAMPLES to manual page
    
    Approved by:            manpages@ (gbe@)
    Reviewed by:            gbe@, pauamma
    Differential Revision:  https://reviews.freebsd.org/D43494
---
 bin/uuidgen/uuidgen.1 | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/bin/uuidgen/uuidgen.1 b/bin/uuidgen/uuidgen.1
index 51475c900bbc..1c2e7cce91d3 100644
--- a/bin/uuidgen/uuidgen.1
+++ b/bin/uuidgen/uuidgen.1
@@ -77,6 +77,30 @@ to each other, but operating system latency and processing time will be
 reflected in the distance between two successive identifiers.
 .Sh EXIT STATUS
 .Ex -std
+.Sh EXAMPLES
+Generate a batch of three UUIDs.
+Notice the similarity of the string before the first hyphen of the UUID
+(known as
+.Em time_low
+in
+.Em rfc4122
+):
+.Bd -literal -offset indent
+$ uuidgen -n3
+8bc44345-4d90-11ee-88c7-b42e991fc52e
+8bc44346-4d90-11ee-88c7-b42e991fc52e
+8bc44347-4d90-11ee-88c7-b42e991fc52e
+.Ed
+.Pp
+Generate a batch of random UUIDs without hyphens:
+.Bd -literal -offset indent
+$ uuidgen -r -c -n3
+5ad8b60a0f4e41f59c82d273202275f9
+6c41925486cd4bf59720a5bad85de2e4
+8144fdab63f648a1812d12453f975313
+.Ed
+.Pp
+Notice that the UUIDs are not similar to each other.
 .Sh SEE ALSO
 .Xr uuidgen 2 ,
 .Xr uuid 3