diff --git a/xCAT-client/pods/man8/makehosts.8.pod b/xCAT-client/pods/man8/makehosts.8.pod
index 563d817b7..e27344959 100644
--- a/xCAT-client/pods/man8/makehosts.8.pod
+++ b/xCAT-client/pods/man8/makehosts.8.pod
@@ -10,10 +10,19 @@ B<makehosts> {B<-h>|B<--help>}
 
 =head1 DESCRIPTION
 
-B<makehosts> updates the /etc/hosts file based on entries in the hosts table in the xCAT database.
-If your node hostnames and IP addresses follow a regular pattern, you can use just a few regular expressions
-in the hosts table and then easily generate /etc/hosts using makehosts.
-
+B<makehosts> updates the /etc/hosts file based on information stored in the 
+xCAT database object definitions.
+
+The main three bits of information needed are: node hostname, node ip and network domain name.
+
+The hostname and ip address are specified as part of the node definition.
+
+The domain value is taken either from the xCAT network definition associated with the node or from the cluster site definition.  If you are using multiple domains in the cluster you should add the domain names to the appropriate xCAT network definition.
+
+Note: If your node hostnames and IP addresses follow a regular pattern, you can use just a few regular expressions to generate /etc/hosts using makehosts. For details on using regular expressions see the "xcatdb" man page.
+
+If you specify additional network interfaces in your xCAT node definitions they will also be added to the /etc/hosts file.  You can specify additional network interface information (NICs) using the following node attributes: nicips, nichostnamesuffixes, nictypes, niccustomscripts, nicnetworks.  You can get a description of these attributes by running "lsdef -t node -h | more" or "man nics".
+
 =head1 OPTIONS
 
 =over 6
@@ -35,7 +44,7 @@ from the mac address stored in mac table.
 
 =item B<-d>
 
-Delete rather than create records.
+Delete rather than create records. This will also delete any additional network interfaces (NICs) included in the node definitions.
 
 =back
 
@@ -43,6 +52,12 @@ Delete rather than create records.
 
 =over 2
 
+=item *
+
+Add entries to /etc/hosts for all nodes included in the xCAT node group called "compute".
+
+  makehosts compute
+
 =item *
 
 If the xCAT hosts table contains: