From 97c8162543659f3de5fa13ef78476518ecbd1b2c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fernando=20Apestegu=C3=ADa?= <fernape@FreeBSD.org>
Date: Thu, 10 Dec 2020 18:34:15 +0000
Subject: [PATCH] id(1): Add EXAMPLES section

Add some examples covering the flags: G, n, P, p, u

Add reference to groups(1)

Approved by:	manpages (gbe@)
Differential Revision:		https://reviews.freebsd.org/D27539
---
 usr.bin/id/id.1 | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/usr.bin/id/id.1 b/usr.bin/id/id.1
index 049614a1c67e..a7225846cfaf 100644
--- a/usr.bin/id/id.1
+++ b/usr.bin/id/id.1
@@ -136,7 +136,43 @@ Display the effective user ID as a number.
 .El
 .Sh EXIT STATUS
 .Ex -std
+.Sh EXAMPLES
+Show information for the user
+.Ql bob
+as a password file entry:
+.Bd -literal -offset indent
+$ id -P bob
+bob:*:0:0::0:0:Robert:/bob:/usr/local/bin/bash
+.Ed
+.Pp
+Same output as
+.Xr groups 1 for the root user:
+.Bd -literal -offset indent
+$ id -Gn root
+wheel operator
+.Ed
+.Pp
+Show human readable information about
+.Ql alice :
+.Bd -literal -offset indent
+$ id -p alice
+uid     alice
+groups  alice webcamd vboxusers
+.Ed
+.Pp
+Assuming the user
+.Ql bob
+executed
+.Dq Nm su Fl l
+to simulate a root login, compare the result of the following commands:
+.Bd -literal -offset indent
+# id -un
+root
+# who am i
+bob          pts/5        Dec  4 19:51
+.Ed
 .Sh SEE ALSO
+.Xr groups 1 ,
 .Xr who 1
 .Sh STANDARDS
 The