Like all good rules, there are many exceptions....
diff --git a/docs/manual.xml b/docs/manual.xml
index 907466f..2f20d71 100644
--- a/docs/manual.xml
+++ b/docs/manual.xml
@@ -30,7 +30,7 @@
E
- 2003,2004,2005,2006,2009
+ 2003,2004,2005,2006,2009,2011
Michael E. Smoot
@@ -987,6 +987,41 @@ and test12.cpp in the examples directory.
+
+I want to use Windows-style flags like "/x" and "/y"...
+
+It is traditional in Posix environments that the "-" and "--" strings are used to signify
+the beginning of argument flags and long argument names. However, other environments,
+namely Windows, use different strings. TCLAP allows you to
+control which strings are used with #define directives. This allows
+you to use different strings based on your operating environment. Here is an example:
+
+
+//
+// This illustrates how to change the flag and name start strings for
+// Windows, otherwise the defaults are used.
+//
+// Note that these defines need to happen *before* tclap is included!
+//
+#ifdef WINDOWS
+#define TCLAP_NAMESTARTSTRING "~~"
+#define TCLAP_FLAGSTARTSTRING "/"
+#endif
+
+#include "tclap/CmdLine.h"
+
+using namespace TCLAP;
+using namespace std;
+
+int main(int argc, char** argv)
+{
+ // Everything else is identical!
+ ...
+
+
+
+
+
diff --git a/examples/Makefile.am b/examples/Makefile.am
index d3ee708..1dd898c 100644
--- a/examples/Makefile.am
+++ b/examples/Makefile.am
@@ -1,7 +1,7 @@
noinst_PROGRAMS = test1 test2 test3 test4 test5 test6 test7 test8 test9 \
test10 test11 test12 test13 test14 test15 test16 \
- test17 test18 test19 test20
+ test17 test18 test19 test20 test21
test1_SOURCES = test1.cpp
test2_SOURCES = test2.cpp
@@ -23,6 +23,7 @@ test17_SOURCES = test17.cpp test17-a.cpp
test18_SOURCES = test18.cpp
test19_SOURCES = test19.cpp
test20_SOURCES = test20.cpp
+test21_SOURCES = test21.cpp
AM_CPPFLAGS = -I$(top_srcdir)/include
diff --git a/examples/test21.cpp b/examples/test21.cpp
new file mode 100644
index 0000000..1d49cd2
--- /dev/null
+++ b/examples/test21.cpp
@@ -0,0 +1,52 @@
+
+// This illustrates how to change the flag and name start strings.
+// Note that these defines need to happen *before* tclap is included!
+#define TCLAP_NAMESTARTSTRING "~~"
+#define TCLAP_FLAGSTARTSTRING "/"
+
+#include
+#include
+#include
+#include "tclap/CmdLine.h"
+
+using namespace TCLAP;
+using namespace std;
+
+int main(int argc, char** argv)
+{
+ // Wrap everything in a try block. Do this every time,
+ // because exceptions will be thrown for problems.
+ try {
+
+ // Define the command line object.
+ CmdLine cmd("Command description message", ' ', "0.9");
+
+ // Define a value argument and add it to the command line.
+ ValueArg nameArg("n","name","Name to print",true,"homer","string");
+ cmd.add( nameArg );
+
+ // Define a switch and add it to the command line.
+ SwitchArg reverseSwitch("r","reverse","Print name backwards", false);
+ cmd.add( reverseSwitch );
+
+ // Parse the args.
+ cmd.parse( argc, argv );
+
+ // Get the value parsed by each arg.
+ string name = nameArg.getValue();
+ bool reverseName = reverseSwitch.getValue();
+
+ // Do what you intend too...
+ if ( reverseName )
+ {
+ reverse(name.begin(),name.end());
+ cout << "My name (spelled backwards) is: " << name << endl;
+ }
+ else
+ cout << "My name is: " << name << endl;
+
+
+ } catch (ArgException &e) // catch any exceptions
+ { cerr << "error: " << e.error() << " for arg " << e.argId() << endl; }
+}
+
diff --git a/tests/Makefile.am b/tests/Makefile.am
index fae1c74..4c0f409 100644
--- a/tests/Makefile.am
+++ b/tests/Makefile.am
@@ -76,7 +76,8 @@ TESTS = test1.sh \
test74.sh \
test75.sh \
test76.sh \
- test77.sh
+ test77.sh \
+ test78.sh
EXTRA_DIST = $(TESTS) \
test1.out \
@@ -155,6 +156,7 @@ EXTRA_DIST = $(TESTS) \
test74.out \
test75.out \
test76.out \
- test77.out
+ test77.out \
+ test78.out
CLEANFILES = tmp.out
diff --git a/tests/test78.out b/tests/test78.out
new file mode 100644
index 0000000..6c0e533
--- /dev/null
+++ b/tests/test78.out
@@ -0,0 +1 @@
+My name (spelled backwards) is: ekim
diff --git a/tests/test78.sh b/tests/test78.sh
new file mode 100755
index 0000000..b02ff4d
--- /dev/null
+++ b/tests/test78.sh
@@ -0,0 +1,11 @@
+#!/bin/sh
+
+# success
+../examples/test21 ~~reverse /n mike > tmp.out 2>&1
+
+if cmp -s tmp.out $srcdir/test78.out; then
+ exit 0
+else
+ exit 1
+fi
+