From df965a6829f058b7a9999c39bc229616520645c2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fernando=20Apestegu=C3=ADa?= <fernape@FreeBSD.org>
Date: Sat, 9 Jan 2021 17:55:21 +0100
Subject: [PATCH] man(1): Add EXAMPLES section

Add some examples showing the use of the flags: a, k, P, w

Reviewed by: gbe@, yuripv@
Approved by: manpages (gbe@)
Differential Revision: https://reviews.freebsd.org/D27545
---
 usr.bin/man/man.1 | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/usr.bin/man/man.1 b/usr.bin/man/man.1
index 89bef50d718a..79821c405416 100644
--- a/usr.bin/man/man.1
+++ b/usr.bin/man/man.1
@@ -357,6 +357,41 @@ Local configuration files.
 .El
 .Sh EXIT STATUS
 .Ex -std
+.Sh EXAMPLES
+Show the manual page for
+.Xr stat 2 :
+.Bd -literal -offset indent
+$ man 2 stat
+.Ed
+.Pp
+Show all manual pages for
+.Ql stat .
+.Bd -literal -offset indent
+$ man -a stat
+.Ed
+.Pp
+List manual pages which match the regular expression either in the title or in
+the body:
+.Bd -literal -offset indent
+$ man -k '\e<copy\e>.*archive'
+.Ed
+.Pp
+Show the manual page for
+.Xr ls 1
+and use
+.Xr cat 1
+as pager:
+.Bd -literal -offset indent
+$ man -P cat ls
+.Ed
+.Pp
+Show the location of the
+.Xr ls 1
+manual page:
+.Bd -literal -offset indent
+$ man -w ls
+.Ed
+.Pp
 .Sh SEE ALSO
 .Xr apropos 1 ,
 .Xr intro 1 ,