From 64e352c6dfdb60e27ffc727033d7eda2faafb78f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fernando=20Apestegu=C3=ADa?= <fernape@FreeBSD.org>
Date: Sat, 24 Oct 2020 16:42:35 +0000
Subject: [PATCH] pwd(1): Add EXAMPLES section

Small EXAMPLES section.

Add reference to realpath(1) due to similarity.

Approved by:	manpages (gbe@)
Differential Revision:		https://reviews.freebsd.org/D26862
---
 bin/pwd/pwd.1 | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/bin/pwd/pwd.1 b/bin/pwd/pwd.1
index 9ef469ef3905..2c27fcff9467 100644
--- a/bin/pwd/pwd.1
+++ b/bin/pwd/pwd.1
@@ -32,7 +32,7 @@
 .\"     @(#)pwd.1	8.2 (Berkeley) 4/28/95
 .\" $FreeBSD$
 .\"
-.Dd October 5, 2016
+.Dd October 24, 2020
 .Dt PWD 1
 .Os
 .Sh NAME
@@ -74,10 +74,30 @@ Logical current working directory.
 .El
 .Sh EXIT STATUS
 .Ex -std
+.Sh EXAMPLES
+Show current working directory with symbolic links resolved:
+.Bd -literal -offset indent
+$ /bin/pwd
+/usr/home/fernape
+.Ed
+.Pp
+Show the logical current directory.
+Then use
+.Xr file 1
+to inspect the
+.Pa /home
+directory:
+.Bd -literal -offset indent
+$ /bin/pwd -L
+/home/fernape
+$ file /home
+/home: symbolic link to usr/home
+.Ed
 .Sh SEE ALSO
 .Xr builtin 1 ,
 .Xr cd 1 ,
 .Xr csh 1 ,
+.Xr realpath 1 ,
 .Xr sh 1 ,
 .Xr getcwd 3
 .Sh STANDARDS