diff --git a/xCAT-client/xCAT-client.spec b/xCAT-client/xCAT-client.spec
index 2ada11bde..40638b5f2 100644
--- a/xCAT-client/xCAT-client.spec
+++ b/xCAT-client/xCAT-client.spec
@@ -19,7 +19,7 @@ BuildArch: noarch
 
 Provides: xCAT-client = %{version}
 
-# fping is needed by pping (in case xCAT-client is installed by itself on a remote client)
+# fping or nmap is needed by pping (in case xCAT-client is installed by itself on a remote client)
 %ifos linux
 Requires: nmap
 %else
@@ -27,7 +27,7 @@ Requires: expat
 %endif
 
 %description
-xCAT-client provides the fundamental xCAT commands (chtab, chnode, rpower, etc) helpful in administrating systems at scale, with particular attention paid to large HPC clusters.
+xCAT-client provides the xCAT commands (chtab, chnode, rpower, etc) helpful in administrating systems at scale, with particular attention paid to large HPC clusters.
 
 %prep
 %setup -q -n xCAT-client
@@ -36,13 +36,6 @@ xCAT-client provides the fundamental xCAT commands (chtab, chnode, rpower, etc)
 # All of the tarball source has been unpacked there and is in the same file structure
 # as it is in svn.
 
-# Convert pods to man pages, e.g.:  pod2man pods/man1/tabdump.1.pod share/man/man1/tabdump.1
-# for i in pods/*/*.pod; do
-#   man="share/man${i#pods}"         # the substitute form is not supported on aix:  ${i/pods/share\/man}
-#   mkdir -p ${man%/*}
-#   pod2man $i ${man%.pod}
-# done
-
 # Convert pods to man pages and html pages
 ./xpod2man
 
diff --git a/xCAT-client/xpod2man b/xCAT-client/xpod2man
index 82740db01..c0d1c51f2 100755
--- a/xCAT-client/xpod2man
+++ b/xCAT-client/xpod2man
@@ -114,7 +114,8 @@ descriptions of every table in the database.
 =head1 XCAT COMMANDS
 
 What follows is a short description of each xCAT command.  To get more information about a particular
-command, see its man page.
+command, see its man page.  Note that the commands are listed in alphabetical order B<within each section>,
+i.e. all the commands in section 1, then the commands in section 3, etc.
 
 =over 12
 EOS1