Sort all includes in src/gromacs

[alexxy/gromacs.git] / src / gromacs / commandline / cmdlineparser.h

diff --git a/src/gromacs/commandline/cmdlineparser.h b/src/gromacs/commandline/cmdlineparser.h
index 4249dbb51115a64bfa03956cd8f8036fb25e6598..c497410e5077f8f6dc7cfc842286b115355c9245 100644 (file)
--- a/src/gromacs/commandline/cmdlineparser.h
+++ b/src/gromacs/commandline/cmdlineparser.h
@@ -1,10 +1,10 @@
 /*
  * This file is part of the GROMACS molecular simulation package.
  *
- * Copyright (c) 2010,2011,2012,2013, by the GROMACS development team, led by
- * David van der Spoel, Berk Hess, Erik Lindahl, and including many
- * others, as listed in the AUTHORS file in the top-level source
- * directory and at http://www.gromacs.org.
+ * Copyright (c) 2010,2011,2012,2013,2014, by the GROMACS development team, led by
+ * Mark Abraham, David van der Spoel, Berk Hess, and Erik Lindahl,
+ * and including many others, as listed in the AUTHORS file in the
+ * top-level source directory and at http://www.gromacs.org.
  *
  * GROMACS is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public License
@@ -46,7 +46,7 @@
 #include <string>
 #include <vector>
 
-#include "../utility/common.h"
+#include "gromacs/utility/common.h"
 
 namespace gmx
 {
@@ -80,6 +80,24 @@ class CommandLineParser
         CommandLineParser(Options *options);
         ~CommandLineParser();
 
+        /*! \brief
+         * Makes the parser skip unknown options and keep them in \c argv.
+         *
+         * \param[in] bEnabled  Whether to skip and keep unknown options.
+         * \returns   *this
+         *
+         * Setting this option to true has dual effect: unknown options are
+         * silently skipped, and all recognized options are removed from
+         * \c argc and \c argv in parse().  These effects should be easy to
+         * separate into different flags if there is need for it.
+         *
+         * The default is false: unknown options result in exceptions and
+         * \c argc and \c argv are not modified.
+         *
+         * Does not throw.
+         */
+        CommandLineParser &skipUnknown(bool bEnabled);
+
         /*! \brief
          * Parses the command line.
          *
@@ -89,9 +107,9 @@ class CommandLineParser
          * All command-line arguments are parsed, and an aggregate exception
          * with all the detected errors is thrown in the end.
          *
-         * Currently, the input parameters are not modified, but this may
-         * change if/when support for parsing only part of the options is
-         * implemented.
+         * If skipUnknown() is false, the input parameters are not modified.
+         * If skipUnknown() is true, recognized options and their values are
+         * removed from the argument list.  \c argv[0] is never modified.
          */
         void parse(int *argc, char *argv[]);