From 63280725b2039ebb616adb2e29173de4f179144c Mon Sep 17 00:00:00 2001
From: =?utf8?q?Fernando=20Apestegu=C3=ADa?= <fernape@FreeBSD.org>
Date: Tue, 23 Jun 2020 07:48:48 +0000
Subject: [PATCH] od(1): Add EXAMPLES section

 * Add two small examples showing the use of -a, -c, -j and -N
 * While here, remove obsolete .Tn reported by mandoc(1)

Approved by:	0mp@
Differential Revision:	https://reviews.freebsd.org/D25372
---
 usr.bin/hexdump/od.1 | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/usr.bin/hexdump/od.1 b/usr.bin/hexdump/od.1
index b78b4fda2b9..e063717a4ac 100644
--- a/usr.bin/hexdump/od.1
+++ b/usr.bin/hexdump/od.1
@@ -143,7 +143,7 @@ is a string containing one or more of the following kinds of type specifiers:
 .Bl -tag -width indent
 .It Cm a
 Named characters
-.Pq Tn ASCII .
+.Pq ASCII .
 Control characters are displayed using the following names:
 .Bl -column "000 NUL" "001 SOH" "002 STX" "003 ETX" "004 EOT" "005 ENQ"
 .It "000 NUL	001 SOH	002 STX	003 ETX	004 EOT	005 ENQ"
@@ -243,6 +243,24 @@ as described in
 .Xr environ 7 .
 .Sh EXIT STATUS
 .Ex -std
+.Sh EXAMPLES
+Dump stdin and show the output using named characters and C-style escaped
+characters:
+.Bd -literal -offset indent
+$ echo "FreeBSD: The power to serve" | od -a -c
+0000000    F   r   e   e   B   S   D   :  sp   T   h   e  sp   p   o   w
+           F   r   e   e   B   S   D   :       T   h   e       p   o   w
+0000020    e   r  sp   t   o  sp   s   e   r   v   e  nl
+           e   r       t   o       s   e   r   v   e  \en
+0000034
+.Ed
+.Pp
+Dump stdin skipping the first 13 bytes using named characters and dumping no
+more than 5 bytes:
+.Bd -literal -offset indent
+$ echo "FreeBSD: The power to serve" | od -An -a -j 13 -N 5
+           p   o   w   e   r
+.Ed
 .Sh COMPATIBILITY
 The traditional
 .Fl s
-- 
2.45.0