From 529151196effeaf6ae6423f36e18912bfa49ef12 Mon Sep 17 00:00:00 2001
From: fernape <fernape@FreeBSD.org>
Date: Mon, 5 Oct 2020 13:46:19 +0000
Subject: [PATCH] hostname(1): Add EXAMPLES to man page

Add a very simple set of examples

Approved by:	manpages (bcr@)
Differential Revision:	https://reviews.freebsd.org/D26663
---
 bin/hostname/hostname.1 | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/bin/hostname/hostname.1 b/bin/hostname/hostname.1
index d99b591fd8ad..45e5e14f4464 100644
--- a/bin/hostname/hostname.1
+++ b/bin/hostname/hostname.1
@@ -29,7 +29,7 @@
 .\"	@(#)hostname.1	8.2 (Berkeley) 4/28/95
 .\" $FreeBSD$
 .\"
-.Dd November 10, 2016
+.Dd October 5, 2020
 .Dt HOSTNAME 1
 .Os
 .Sh NAME
@@ -66,6 +66,25 @@ name.
 .It Fl d
 Only print domain information.
 .El
+.Sh EXAMPLES
+Set the host name of the machine and check the result:
+.Bd -literal -offset indent
+$ hostname beastie.localdomain.org
+$ hostname
+beastie.localdomain.org
+.Ed
+.Pp
+Do not show domain information:
+.Bd -literal -offset indent
+$ hostname -s
+beastie
+.Ed
+.Pp
+Show only domain information:
+.Bd -literal -offset indent
+$ hostname -d
+localdomain.org
+.Ed
 .Sh SEE ALSO
 .Xr gethostname 3 ,
 .Xr rc.conf 5