Mercurial > hg > octave-nkf
diff libinterp/options-usage.h @ 19705:bf27e21f0bfb
maint: Merge default to temporary audio-gsoc branch.
author | John W. Eaton <jwe@octave.org> |
---|---|
date | Wed, 31 Dec 2014 14:59:42 -0500 |
parents | 26e9312e6928 |
children | 4197fc428c7d |
line wrap: on
line diff
new file mode 100644 --- /dev/null +++ b/libinterp/options-usage.h @@ -0,0 +1,178 @@ +/* + +Copyright (C) 1993-2013 John W. Eaton + +This file is part of Octave. + +Octave is free software; you can redistribute it and/or modify it +under the terms of the GNU General Public License as published by the +Free Software Foundation; either version 3 of the License, or (at your +option) any later version. + +Octave is distributed in the hope that it will be useful, but WITHOUT +ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +for more details. + +You should have received a copy of the GNU General Public License +along with Octave; see the file COPYING. If not, see +<http://www.gnu.org/licenses/>. + +*/ + +#if !defined (octave_options_usage_h) +#define octave_options_usage_h 1 + +#include <iosfwd> + +#include "version.h" + +// Usage message +static const char *usage_string = + "octave [-HVWdfhiqvx] [--debug] [--debug-jit] [--doc-cache-file file]\n\ + [--echo-commands] [--eval CODE] [--exec-path path]\n\ + [--force-gui] [--help] [--image-path path]\n\ + [--info-file file] [--info-program prog] [--interactive]\n\ + [--jit-compiler] [--line-editing] [--no-gui] [--no-history]\n\ + [--no-init-file] [--no-init-path] [--no-line-editing]\n\ + [--no-site-file] [--no-window-system] [--norc] [-p path]\n\ + [--path path] [--persist] [--silent] [--traditional]\n\ + [--verbose] [--version] [file]"; + +// This is here so that it's more likely that the usage message and +// the real set of options will agree. Note: the '+' must come first +// to prevent getopt from permuting arguments! +static const char *short_opts = "+HWVdfhip:qvx"; + +// Long options. See the comments in getopt.h for the meanings of the +// fields in this structure. +#define BUILT_IN_DOCSTRINGS_FILE_OPTION 1 +#define DOC_CACHE_FILE_OPTION 2 +#define EVAL_OPTION 3 +#define EXEC_PATH_OPTION 4 +#define FORCE_GUI_OPTION 5 +#define IMAGE_PATH_OPTION 6 +#define INFO_FILE_OPTION 7 +#define INFO_PROG_OPTION 8 +#define DEBUG_JIT_OPTION 9 +#define JIT_COMPILER_OPTION 10 +#define LINE_EDITING_OPTION 11 +#define NO_GUI_OPTION 12 +#define NO_INIT_FILE_OPTION 13 +#define NO_INIT_PATH_OPTION 14 +#define NO_LINE_EDITING_OPTION 15 +#define NO_SITE_FILE_OPTION 16 +#define PERSIST_OPTION 17 +#define TEXI_MACROS_FILE_OPTION 18 +#define TRADITIONAL_OPTION 19 +struct option long_opts[] = { + { "braindead", no_argument, 0, TRADITIONAL_OPTION }, + { "built-in-docstrings-file", required_argument, 0, BUILT_IN_DOCSTRINGS_FILE_OPTION }, + { "debug", no_argument, 0, 'd' }, + { "debug-jit", no_argument, 0, DEBUG_JIT_OPTION }, + { "doc-cache-file", required_argument, 0, DOC_CACHE_FILE_OPTION }, + { "echo-commands", no_argument, 0, 'x' }, + { "eval", required_argument, 0, EVAL_OPTION }, + { "exec-path", required_argument, 0, EXEC_PATH_OPTION }, + { "force-gui", no_argument, 0, FORCE_GUI_OPTION }, + { "help", no_argument, 0, 'h' }, + { "image-path", required_argument, 0, IMAGE_PATH_OPTION }, + { "info-file", required_argument, 0, INFO_FILE_OPTION }, + { "info-program", required_argument, 0, INFO_PROG_OPTION }, + { "interactive", no_argument, 0, 'i' }, + { "jit-compiler", no_argument, 0, JIT_COMPILER_OPTION }, + { "line-editing", no_argument, 0, LINE_EDITING_OPTION }, + { "no-gui", no_argument, 0, NO_GUI_OPTION }, + { "no-history", no_argument, 0, 'H' }, + { "no-init-file", no_argument, 0, NO_INIT_FILE_OPTION }, + { "no-init-path", no_argument, 0, NO_INIT_PATH_OPTION }, + { "no-line-editing", no_argument, 0, NO_LINE_EDITING_OPTION }, + { "no-site-file", no_argument, 0, NO_SITE_FILE_OPTION }, + { "no-window-system", no_argument, 0, 'W' }, + { "norc", no_argument, 0, 'f' }, + { "path", required_argument, 0, 'p' }, + { "persist", no_argument, 0, PERSIST_OPTION }, + { "quiet", no_argument, 0, 'q' }, + { "silent", no_argument, 0, 'q' }, + { "texi-macros-file", required_argument, 0, TEXI_MACROS_FILE_OPTION }, + { "traditional", no_argument, 0, TRADITIONAL_OPTION }, + { "verbose", no_argument, 0, 'V' }, + { "version", no_argument, 0, 'v' }, + { 0, 0, 0, 0 } +}; + +// Usage message with extra help. + +static void +octave_print_verbose_usage_and_exit (void) +{ + std::cout << octave_name_version_copyright_copying_and_warranty () + << "\n\ +\n\ +Usage: octave [options] [FILE]\n\ +\n\ +Options:\n\ +\n\ + --built-in-docstrings-file FILE Use docs for built-ins from FILE.\n\ + --debug, -d Enter parser debugging mode.\n\ + --debug-jit Enable JIT compiler debugging/tracing.\n\ + --doc-cache-file FILE Use doc cache file FILE.\n\ + --echo-commands, -x Echo commands as they are executed.\n\ + --eval CODE Evaluate CODE. Exit when done unless --persist.\n\ + --exec-path PATH Set path for executing subprograms.\n\ + --force-gui Force graphical user interface to start.\n\ + --help, -h, Print short help message and exit.\n\ + --image-path PATH Add PATH to head of image search path.\n\ + --info-file FILE Use top-level info file FILE.\n\ + --info-program PROGRAM Use PROGRAM for reading info files.\n\ + --interactive, -i Force interactive behavior.\n\ + --jit-compiler Enable the JIT compiler.\n\ + --line-editing Force readline use for command-line editing.\n\ + --no-gui Disable the graphical user interface.\n\ + --no-history, -H Don't save commands to the history list\n\ + --no-init-file Don't read the ~/.octaverc or .octaverc files.\n\ + --no-init-path Don't initialize function search path.\n\ + --no-line-editing Don't use readline for command-line editing.\n\ + --no-site-file Don't read the site-wide octaverc file.\n\ + --no-window-system, -W Disable window system, including graphics.\n\ + --norc, -f Don't read any initialization files.\n\ + --path PATH, -p PATH Add PATH to head of function search path.\n\ + --persist Go interactive after --eval or reading from FILE.\n\ + --silent, --quiet, -q Don't print message at startup.\n\ + --texi-macros-file FILE Use Texinfo macros in FILE for makeinfo command.\n\ + --traditional Set variables for closer MATLAB compatibility.\n\ + --verbose, -V Enable verbose output in some cases.\n\ + --version, -v Print version number and exit.\n\ +\n\ + FILE Execute commands from FILE. Exit when done\n\ + unless --persist is also specified.\n\ +\n" + << octave_www_statement () + << "\n\n" + << octave_contrib_statement () + << "\n\n" + << octave_bugs_statement () + << "\n"; + + exit (0); +} + +// Terse usage messsage. + +static void +octave_print_terse_usage_and_exit (void) +{ + std::cerr << "\nusage: " << usage_string << "\n\n"; + + exit (1); +} + +static void +octave_print_version_and_exit (void) +{ + std::cout << octave_name_version_copyright_copying_warranty_and_bugs () + << "\n"; + exit (0); +} + +#endif