From b5be18fcb7c0d92541b15e18edcc6ad847206a09 Mon Sep 17 00:00:00 2001
From: bp-sawyers <bp-sawyers@8638fb3e-16cb-4fca-ae20-7b5d299a9bcd>
Date: Wed, 22 Jul 2009 13:59:21 +0000
Subject: [PATCH] Make it more obvious in the xcat cmd summary that cmds are
 grouped by section

git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@3859 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
---
 xCAT-client/xCAT-client.spec | 11 ++---------
 xCAT-client/xpod2man         |  3 ++-
 2 files changed, 4 insertions(+), 10 deletions(-)

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