updated for new test1

docs/manual.html

@@ -104,9 +104,12 @@ calls to the <i>getValue()</i> methods of the argument objects.<br />
 Here is a simple <a href="test1.cpp">example</a> ...
 <br/>
 <pre>
-#include &lt; string &gt;
+#include &lt;string&gt;
-#include &lt; iostream &gt;
+#include &lt;iostream&gt;
-#include &lt; tclap/CmdLine.h &gt;
+#include &lt;algorithm&gt;
+#include &lt;tclap/CmdLine.h&gt;
+
+using namespace TCLAP;
 using namespace std;
 
 int main(int argc, char** argv)
@@ -118,77 +121,74 @@ int main(int argc, char** argv)
 	// Define the command line object.
 	CmdLine cmd("Command description message", ' ', "0.9");
 
-        // (deprecated, but still functional)
-        // CmdLine cmd(argv[0], "Command description message", "0.9"); 
-
 	// Define a value argument and add it to the command line.
-        ValueArg &lt; string &gt;  nameArg("n","name","Name to print",true,"homer",
+	ValueArg&lt;string&gt; nameArg("n","name","Name to print",true,"homer","string");
-                                     "nameString");
 	cmd.add( nameArg );
 
 	// Define a switch and add it to the command line.
-        SwitchArg caseSwitch("u","upperCase","Print in upper case", false);
+	SwitchArg reverseSwitch("r","reverse","Print name backwards", false);
-        cmd.add( caseSwitch );
+	cmd.add( reverseSwitch );
 
 	// Parse the args.
 	cmd.parse( argc, argv );
 
 	// Get the value parsed by each arg. 
 	string name = nameArg.getValue();
-        bool upperCase = caseSwitch.getValue();
+	bool reverseName = reverseSwitch.getValue();
 
-        // Do what you intend to...
+	// Do what you intend too...
-        if ( upperCase )
+	if ( reverseName )
-                transform(name.begin(),name.end(),name.begin(),::toupper);
+	{
+		reverse(name.begin(),name.end());
+		cout &lt;&lt; "My name (spelled backwards) is: " &lt;&lt; name &lt;&lt; endl;
+	}
 	else
-                transform(name.begin(),name.end(),name.begin(),::tolower);
+		cout &lt;&lt; "My name is: " &lt;&lt; name &lt;&lt; endl;
 
-        cout &lt;&lt; "My name is " &lt;&lt; name &lt;&lt; endl;
 
-        } catch (ArgException e)  // catch any exceptions
+	} catch (ArgException &e)  // catch any exceptions
 	{ cerr &lt;&lt; "error: " &lt;&lt; e.error() &lt;&lt; " for arg " &lt;&lt; e.argId() &lt;&lt; endl; }
 }
 </pre>
+
 <br />
 The output should look like:<br />
 <br />
 <pre>
 
-% tester -u -n mike
+% test1 -n mike
-My name is MIKE
+My name is: mike
 
-% tester -n mike -u
+% test1 -n mike -r
-My name is MIKE
+My name (spelled backwards) is: ekim
 
-% tester -n mike
+% test1 -r -n mike
-My name is mike
+My name (spelled backwards) is: ekim
 
-% tester -n MIKE
+% test1 -r
-My name is mike
-
-% tester
 PARSE ERROR:
              One or more required arguments missing!
 
 Brief USAGE:
-        tester  [-u] -n &lt; string &gt; [--] [-v] [-h]
+   test1  [-r] -n &lt;string&gt; [--] [-v] [-h]
 
 For complete USAGE and HELP type:
-        tester --help
+   test1 --help
 
-% tester --help
+
+% test1 --help
 
 USAGE:
 
-   tester  [-u] -n &lt; string &gt; [--] [-v] [-h]
+   test1  [-r] -n &lt;string&gt; [--] [-v] [-h]
 
 
 Where:
 
-   -u,  --upperCase
+   -r,  --reverse
-     Print in upper case
+     Print name backwards
 
-   -n &lt; string &gt;,  --name &lt; string &gt;
+   -n &lt;string&gt;  --name &lt;string&gt;
      (required)  (value required)  Name to print
 
    --,  --ignore_rest