1 files changed, 14 insertions, 0 deletions
diff --git a/README.rst b/README.rst
index b45fb59..601b124 100644
--- a/README.rst
+++ b/README.rst
@@ -80,6 +80,20 @@ issue with strict POSIX® conformance.
 * NetBSD does not recognise _-prefixed POSIX2 variables.
 
 
+hostname(1)
+```````````
+
+The hostname(1) utility returns the current host and/or domain name for the
+presently running operating environment.  It additionally allows a superuser
+to set the host and/or domain name.
+
+This utility is not present in POSIX®, but is needed for setting the host
+name on Adélie system startup, and is generally useful.
+
+This implementation has been tested on Linux and Darwin.  It has most of the
+Linux net-tools short flags, but does not presently support long flags.
+
+
 localedef(1)
 ````````````