Index: bin/hostname/hostname.1
===================================================================
--- bin/hostname/hostname.1
+++ bin/hostname/hostname.1
@@ -66,6 +66,25 @@
 .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