Mercurial > octave-nkf
annotate src/octave.cc @ 8923:d47290508a55
document --doc-cache-file option
| author | John W. Eaton <jwe@octave.org> |
|---|---|
| date | Sat, 07 Mar 2009 11:35:31 -0500 |
| parents | eb63fbe60fab |
| children | da58ec8f62e8 |
| rev | line source |
|---|---|
| 1 | 1 /* |
| 2 | |
| 7017 | 3 Copyright (C) 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, |
| 8920 | 4 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 John W. Eaton |
| 1 | 5 |
| 6 This file is part of Octave. | |
| 7 | |
| 8 Octave is free software; you can redistribute it and/or modify it | |
| 9 under the terms of the GNU General Public License as published by the | |
| 7016 | 10 Free Software Foundation; either version 3 of the License, or (at your |
| 11 option) any later version. | |
| 1 | 12 |
| 13 Octave is distributed in the hope that it will be useful, but WITHOUT | |
| 14 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
| 15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
| 16 for more details. | |
| 17 | |
| 18 You should have received a copy of the GNU General Public License | |
| 7016 | 19 along with Octave; see the file COPYING. If not, see |
| 20 <http://www.gnu.org/licenses/>. | |
| 1 | 21 |
| 22 */ | |
| 23 | |
| 24 // Born February 20, 1992. | |
| 25 | |
| 240 | 26 #ifdef HAVE_CONFIG_H |
| 1192 | 27 #include <config.h> |
| 1 | 28 #endif |
| 29 | |
| 1355 | 30 #include <cassert> |
| 31 #include <cstdlib> | |
| 32 #include <cstring> | |
| 33 #include <ctime> | |
| 34 | |
| 3503 | 35 #include <fstream> |
| 36 #include <iostream> | |
| 1355 | 37 |
| 38 #ifdef HAVE_UNISTD_H | |
| 2442 | 39 #ifdef HAVE_SYS_TYPES_H |
| 1 | 40 #include <sys/types.h> |
| 2442 | 41 #endif |
| 139 | 42 #include <unistd.h> |
| 43 #endif | |
| 1355 | 44 |
| 2926 | 45 #include "cmd-edit.h" |
| 3690 | 46 #include "f77-fcn.h" |
| 4097 | 47 #include "file-ops.h" |
| 2926 | 48 #include "file-stat.h" |
| 240 | 49 #include "lo-error.h" |
| 2926 | 50 #include "oct-env.h" |
| 3019 | 51 #include "pathsearch.h" |
| 1907 | 52 #include "str-vec.h" |
| 223 | 53 |
| 2492 | 54 #include <defaults.h> |
| 3933 | 55 #include "Cell.h" |
| 1355 | 56 #include "defun.h" |
| 57 #include "error.h" | |
| 58 #include "file-io.h" | |
| 1 | 59 #include "input.h" |
| 60 #include "lex.h" | |
| 5832 | 61 #include "load-path.h" |
| 4113 | 62 #include "octave.h" |
| 1742 | 63 #include "oct-hist.h" |
| 5654 | 64 #include "oct-map.h" |
| 3195 | 65 #include "oct-obj.h" |
| 2375 | 66 #include "ops.h" |
| 1670 | 67 #include "toplev.h" |
| 1 | 68 #include "parse.h" |
| 562 | 69 #include "procstream.h" |
| 1817 | 70 #include "prog-args.h" |
| 1355 | 71 #include "sighandlers.h" |
| 72 #include "sysdep.h" | |
| 2375 | 73 #include "ov.h" |
| 1 | 74 #include "unwind-prot.h" |
| 1355 | 75 #include "utils.h" |
| 76 #include "variables.h" | |
| 2492 | 77 #include <version.h> |
| 1 | 78 |
| 4159 | 79 // Kluge. |
| 5990 | 80 extern "C" F77_RET_T |
| 81 F77_FUNC (xerbla, XERBLA) (F77_CONST_CHAR_ARG_DECL, const octave_idx_type& | |
| 82 F77_CHAR_ARG_LEN_DECL); | |
| 4159 | 83 |
| 2910 | 84 extern void install_builtins (void); |
| 85 | |
| 1704 | 86 #if !defined (HAVE_ATEXIT) && defined (HAVE_ON_EXIT) |
| 87 extern "C" int on_exit (); | |
| 88 #define atexit on_exit | |
| 89 #endif | |
| 90 | |
| 1907 | 91 // The command-line options. |
| 92 static string_vector octave_argv; | |
| 1 | 93 |
| 5780 | 94 // The name used to invoke Octave. |
| 95 static std::string | |
| 96 octave_program_invocation_name; | |
| 97 | |
| 98 // The last component of octave_program_invocation_name. | |
| 99 static std::string octave_program_name; | |
| 100 | |
| 2239 | 101 // TRUE means we read ~/.octaverc and ./.octaverc. |
| 102 // (--norc; --no-init-file; -f) | |
| 103 static bool read_init_files = true; | |
| 104 | |
| 105 // TRUE means we read the site-wide octaverc files. | |
| 106 // (--norc; --no-site-file; -f) | |
| 2240 | 107 static bool read_site_files = true; |
| 1 | 108 |
| 6365 | 109 // TRUE means we set the initial path to configured defaults. |
| 110 // (--no-initial-path) | |
| 111 static bool set_initial_path = true; | |
| 112 | |
| 3019 | 113 // TRUE means we don't print the usual startup message. |
| 616 | 114 // (--quiet; --silent; -q) |
| 2239 | 115 static bool inhibit_startup_message = false; |
| 1 | 116 |
| 3019 | 117 // TRUE means we turn on compatibility options. |
| 1410 | 118 // (--traditional) |
| 2239 | 119 static bool traditional = false; |
| 1410 | 120 |
| 3019 | 121 // If TRUE, print verbose info in some cases. |
| 1825 | 122 // (--verbose; -V) |
| 2239 | 123 static bool verbose_flag = false; |
| 1825 | 124 |
| 1 | 125 // Usage message |
| 139 | 126 static const char *usage_string = |
| 5189 | 127 "octave [-?HVdfhiqvx] [--debug] [--echo-commands] [--eval CODE]\n\ |
| 5814 | 128 [--exec-path path] [--help] [--image-path path] [--info-file file]\n\ |
| 6938 | 129 [--info-program prog] [--interactive] [--line-editing] [--no-history] [--no-init-file]\n\ |
| 6365 | 130 [--no-line-editing] [--no-site-file] [--no-init-path] [-p path]\n\ |
| 131 [--path path] [--silent] [--traditional] [--verbose] [--version] [file]"; | |
| 1 | 132 |
| 1358 | 133 // This is here so that it's more likely that the usage message and |
| 1410 | 134 // the real set of options will agree. Note: the `+' must come first |
| 135 // to prevent getopt from permuting arguments! | |
| 3180 | 136 static const char *short_opts = "+?HVdfhip:qvx"; |
| 139 | 137 |
| 5189 | 138 // The code to evaluate at startup (--eval CODE) |
| 139 static std::string code_to_eval; | |
| 140 | |
| 141 // If TRUE, don't exit after evaluating code given by --eval option. | |
| 142 static bool persist = false; | |
| 4356 | 143 |
| 1103 | 144 // Long options. See the comments in getopt.h for the meanings of the |
| 145 // fields in this structure. | |
| 8861 | 146 #define DOC_CACHE_FILE_OPTION 1 |
| 147 #define EVAL_OPTION 2 | |
| 148 #define EXEC_PATH_OPTION 3 | |
| 149 #define IMAGE_PATH_OPTION 4 | |
| 150 #define INFO_FILE_OPTION 5 | |
| 151 #define INFO_PROG_OPTION 6 | |
| 152 #define NO_INIT_FILE_OPTION 7 | |
| 153 #define NO_LINE_EDITING_OPTION 8 | |
| 154 #define NO_SITE_FILE_OPTION 9 | |
| 155 #define NO_INITIAL_PATH_OPTION 10 | |
| 156 #define PERSIST_OPTION 11 | |
| 157 #define TRADITIONAL_OPTION 12 | |
| 158 #define LINE_EDITING_OPTION 13 | |
| 1817 | 159 long_options long_opts[] = |
| 139 | 160 { |
| 1855 | 161 { "debug", prog_args::no_arg, 0, 'd' }, |
| 2277 | 162 { "braindead", prog_args::no_arg, 0, TRADITIONAL_OPTION }, |
| 8861 | 163 { "doc-cache-file", prog_args::required_arg, 0, DOC_CACHE_FILE_OPTION }, |
| 1855 | 164 { "echo-commands", prog_args::no_arg, 0, 'x' }, |
| 5189 | 165 { "eval", prog_args::required_arg, 0, EVAL_OPTION }, |
| 1855 | 166 { "exec-path", prog_args::required_arg, 0, EXEC_PATH_OPTION }, |
| 167 { "help", prog_args::no_arg, 0, 'h' }, | |
| 5814 | 168 { "image-path", prog_args::required_arg, 0, IMAGE_PATH_OPTION }, |
| 1855 | 169 { "info-file", prog_args::required_arg, 0, INFO_FILE_OPTION }, |
| 170 { "info-program", prog_args::required_arg, 0, INFO_PROG_OPTION }, | |
| 171 { "interactive", prog_args::no_arg, 0, 'i' }, | |
| 6938 | 172 { "line-editing", prog_args::no_arg, 0, LINE_EDITING_OPTION }, |
| 3180 | 173 { "no-history", prog_args::no_arg, 0, 'H' }, |
| 2239 | 174 { "no-init-file", prog_args::no_arg, 0, NO_INIT_FILE_OPTION }, |
| 1855 | 175 { "no-line-editing", prog_args::no_arg, 0, NO_LINE_EDITING_OPTION }, |
| 2239 | 176 { "no-site-file", prog_args::no_arg, 0, NO_SITE_FILE_OPTION }, |
| 6365 | 177 { "no-initial-path", prog_args::no_arg, 0, NO_INITIAL_PATH_OPTION }, |
| 1855 | 178 { "norc", prog_args::no_arg, 0, 'f' }, |
| 179 { "path", prog_args::required_arg, 0, 'p' }, | |
| 5189 | 180 { "persist", prog_args::no_arg, 0, PERSIST_OPTION }, |
| 1855 | 181 { "quiet", prog_args::no_arg, 0, 'q' }, |
| 182 { "silent", prog_args::no_arg, 0, 'q' }, | |
| 183 { "traditional", prog_args::no_arg, 0, TRADITIONAL_OPTION }, | |
| 184 { "verbose", prog_args::no_arg, 0, 'V' }, | |
| 185 { "version", prog_args::no_arg, 0, 'v' }, | |
| 3019 | 186 { 0, 0, 0, 0 } |
| 139 | 187 }; |
| 1 | 188 |
| 1355 | 189 // Store the command-line options for later use. |
| 190 | |
| 191 static void | |
| 192 intern_argv (int argc, char **argv) | |
| 193 { | |
|
7752
40c428ea3408
initial implementation of dbup and dbdown
John W. Eaton <jwe@octave.org>
parents:
7715
diff
changeset
|
194 assert (symbol_table::at_top_level ()); |
| 4892 | 195 |
|
7752
40c428ea3408
initial implementation of dbup and dbdown
John W. Eaton <jwe@octave.org>
parents:
7715
diff
changeset
|
196 symbol_table::varref (".nargin.") = argc - 1; |
|
40c428ea3408
initial implementation of dbup and dbdown
John W. Eaton <jwe@octave.org>
parents:
7715
diff
changeset
|
197 |
|
40c428ea3408
initial implementation of dbup and dbdown
John W. Eaton <jwe@octave.org>
parents:
7715
diff
changeset
|
198 symbol_table::mark_hidden (".nargin."); |
| 3195 | 199 |
| 1355 | 200 if (argc > 1) |
| 201 { | |
| 7336 | 202 octave_argv.resize (argc - 1); |
| 3933 | 203 |
| 2495 | 204 // Skip program name in argv. |
| 3933 | 205 int i = argc; |
| 206 while (--i > 0) | |
| 5780 | 207 octave_argv[i-1] = *(argv+i); |
| 1355 | 208 } |
| 209 } | |
| 210 | |
| 1792 | 211 static void |
| 212 initialize_pathsearch (void) | |
| 213 { | |
| 214 // This may seem odd, but doing it this way means that we don't have | |
| 215 // to modify the kpathsea library... | |
| 216 | |
| 3523 | 217 std::string odb = octave_env::getenv ("OCTAVE_DB_PATH"); |
| 3141 | 218 |
| 219 // For backward compatibility. | |
| 1792 | 220 |
| 2926 | 221 if (odb.empty ()) |
| 3141 | 222 odb = octave_env::getenv ("OCTAVE_DB_DIR"); |
| 1792 | 223 |
| 3141 | 224 if (odb.empty ()) |
|
8007
a2ab20ba78f7
make file_ops a proper singleton class
John W. Eaton <jwe@octave.org>
parents:
7752
diff
changeset
|
225 odb = Vdata_dir + file_ops::dir_sep_str () + "octave:" |
|
a2ab20ba78f7
make file_ops a proper singleton class
John W. Eaton <jwe@octave.org>
parents:
7752
diff
changeset
|
226 + Vlibexec_dir + file_ops::dir_sep_str () + "octave"; |
| 1792 | 227 } |
| 228 | |
| 5654 | 229 DEFUN (__version_info__, args, , |
| 230 "-*- texinfo -*-\n\ | |
| 6678 | 231 @deftypefn {Built-in Function} {retval =} __version_info__ (@var{name}, @var{version}, @var{release}, @var{date})\n\ |
| 6945 | 232 Undocumented internal function.\n\ |
| 5654 | 233 @end deftypefn") |
| 234 { | |
| 235 octave_value retval; | |
| 236 | |
| 237 static Octave_map vinfo; | |
| 238 | |
| 239 int nargin = args.length (); | |
| 240 | |
| 5658 | 241 if (nargin == 4) |
| 5654 | 242 { |
| 6639 | 243 if (vinfo.nfields () == 0) |
| 5781 | 244 { |
| 245 vinfo.assign ("Name", args (0)); | |
| 246 vinfo.assign ("Version", args (1)); | |
| 247 vinfo.assign ("Release", args (2)); | |
| 248 vinfo.assign ("Date", args (3)); | |
| 249 } | |
| 250 else | |
| 251 { | |
| 252 octave_idx_type n = vinfo.numel () + 1; | |
| 5654 | 253 |
| 5781 | 254 vinfo.resize (dim_vector (n, 1)); |
| 255 | |
| 256 octave_value idx (n); | |
| 257 | |
| 258 vinfo.assign (idx, "Name", Cell (octave_value (args (0)))); | |
| 259 vinfo.assign (idx, "Version", Cell (octave_value (args (1)))); | |
| 260 vinfo.assign (idx, "Release", Cell (octave_value (args (2)))); | |
| 261 vinfo.assign (idx, "Date", Cell (octave_value (args (3)))); | |
| 262 } | |
| 5654 | 263 } |
| 264 else if (nargin == 0) | |
| 265 retval = vinfo; | |
| 266 else | |
| 5823 | 267 print_usage (); |
| 5654 | 268 |
| 269 return retval; | |
| 270 } | |
| 271 | |
| 272 static void | |
| 273 initialize_version_info (void) | |
| 274 { | |
| 275 octave_value_list args; | |
| 276 | |
| 5658 | 277 args(3) = OCTAVE_RELEASE_DATE; |
| 278 args(2) = OCTAVE_RELEASE; | |
| 5654 | 279 args(1) = OCTAVE_VERSION; |
| 280 args(0) = "GNU Octave"; | |
| 281 | |
| 282 F__version_info__ (args, 0); | |
| 283 } | |
| 284 | |
| 581 | 285 // Initialize by reading startup files. |
| 286 | |
| 1 | 287 static void |
| 288 execute_startup_files (void) | |
| 289 { | |
| 2985 | 290 unwind_protect::begin_frame ("execute_startup_files"); |
| 315 | 291 |
| 3019 | 292 unwind_protect_bool (input_from_startup_file); |
| 1651 | 293 |
| 3019 | 294 input_from_startup_file = true; |
| 315 | 295 |
|
7715
5b4d278ec828
parse scripts completely before executing
John W. Eaton <jwe@octave.org>
parents:
7481
diff
changeset
|
296 std::string context; |
|
5b4d278ec828
parse scripts completely before executing
John W. Eaton <jwe@octave.org>
parents:
7481
diff
changeset
|
297 |
|
5b4d278ec828
parse scripts completely before executing
John W. Eaton <jwe@octave.org>
parents:
7481
diff
changeset
|
298 bool verbose = (verbose_flag && ! inhibit_startup_message); |
|
5b4d278ec828
parse scripts completely before executing
John W. Eaton <jwe@octave.org>
parents:
7481
diff
changeset
|
299 |
|
5b4d278ec828
parse scripts completely before executing
John W. Eaton <jwe@octave.org>
parents:
7481
diff
changeset
|
300 bool require_file = false; |
| 578 | 301 |
| 2239 | 302 if (read_site_files) |
| 1 | 303 { |
| 2239 | 304 // Execute commands from the site-wide configuration file. |
| 305 // First from the file $(prefix)/lib/octave/site/m/octaverc | |
| 306 // (if it exists), then from the file | |
| 3597 | 307 // $(prefix)/share/octave/$(version)/m/octaverc (if it exists). |
| 1755 | 308 |
|
7715
5b4d278ec828
parse scripts completely before executing
John W. Eaton <jwe@octave.org>
parents:
7481
diff
changeset
|
309 source_file (Vlocal_site_defaults_file, context, verbose, require_file); |
| 1755 | 310 |
|
7715
5b4d278ec828
parse scripts completely before executing
John W. Eaton <jwe@octave.org>
parents:
7481
diff
changeset
|
311 source_file (Vsite_defaults_file, context, verbose, require_file); |
| 1 | 312 } |
| 313 | |
| 2239 | 314 if (read_init_files) |
| 315 { | |
| 2512 | 316 // Try to execute commands from $HOME/$OCTAVE_INITFILE and |
| 317 // $OCTAVE_INITFILE. If $OCTAVE_INITFILE is not set, .octaverc | |
| 318 // is assumed. | |
| 2239 | 319 |
| 4804 | 320 bool home_rc_already_executed = false; |
| 2512 | 321 |
| 3523 | 322 std::string initfile = octave_env::getenv ("OCTAVE_INITFILE"); |
| 2512 | 323 |
| 2926 | 324 if (initfile.empty ()) |
| 2512 | 325 initfile = ".octaverc"; |
| 326 | |
| 3523 | 327 std::string home_dir = octave_env::get_home_directory (); |
| 2926 | 328 |
| 4804 | 329 std::string home_rc = octave_env::make_absolute (initfile, home_dir); |
| 330 | |
| 331 std::string local_rc; | |
| 2239 | 332 |
| 5781 | 333 if (! home_rc.empty ()) |
| 2239 | 334 { |
|
7715
5b4d278ec828
parse scripts completely before executing
John W. Eaton <jwe@octave.org>
parents:
7481
diff
changeset
|
335 source_file (home_rc, context, verbose, require_file); |
| 2239 | 336 |
| 337 // Names alone are not enough. | |
| 338 | |
| 339 file_stat fs_home_rc (home_rc); | |
| 340 | |
| 341 if (fs_home_rc) | |
| 342 { | |
| 4804 | 343 // We want to check for curr_dir after executing home_rc |
| 344 // because doing that may change the working directory. | |
| 345 | |
| 346 std::string curr_dir = octave_env::getcwd (); | |
| 347 | |
| 348 local_rc = octave_env::make_absolute (initfile, curr_dir); | |
| 349 | |
| 6598 | 350 home_rc_already_executed = same_file (home_rc, local_rc); |
| 2239 | 351 } |
| 352 } | |
| 353 | |
| 354 if (! home_rc_already_executed) | |
| 4804 | 355 { |
| 356 if (local_rc.empty ()) | |
| 357 { | |
| 358 std::string curr_dir = octave_env::getcwd (); | |
| 359 | |
| 360 local_rc = octave_env::make_absolute (initfile, curr_dir); | |
| 361 } | |
| 362 | |
|
7715
5b4d278ec828
parse scripts completely before executing
John W. Eaton <jwe@octave.org>
parents:
7481
diff
changeset
|
363 source_file (local_rc, context, verbose, require_file); |
| 4804 | 364 } |
| 2239 | 365 } |
| 315 | 366 |
| 2985 | 367 unwind_protect::run_frame ("execute_startup_files"); |
| 1 | 368 } |
| 369 | |
| 5189 | 370 static int |
| 371 execute_eval_option_code (const std::string& code) | |
| 372 { | |
| 373 unwind_protect::begin_frame ("execute_eval_option_code"); | |
| 374 | |
| 7202 | 375 octave_save_signal_mask (); |
| 376 | |
| 377 can_interrupt = true; | |
| 378 | |
| 379 octave_signal_hook = octave_signal_handler; | |
| 380 octave_interrupt_hook = unwind_protect::run_all; | |
| 381 octave_bad_alloc_hook = unwind_protect::run_all; | |
| 382 | |
| 383 octave_catch_interrupts (); | |
| 384 | |
| 385 octave_initialized = true; | |
| 386 | |
| 5189 | 387 unwind_protect_bool (interactive); |
| 388 | |
| 389 interactive = false; | |
| 390 | |
| 391 int parse_status = 0; | |
| 392 | |
| 6487 | 393 try |
| 394 { | |
| 395 eval_string (code, false, parse_status, 0); | |
| 396 } | |
| 7202 | 397 catch (octave_interrupt_exception) |
| 398 { | |
| 399 recover_from_exception (); | |
| 400 octave_stdout << "\n"; | |
| 401 } | |
| 6487 | 402 catch (std::bad_alloc) |
| 403 { | |
| 6680 | 404 std::cerr << "error: memory exhausted or requested size too large for range of Octave's index type -- eval failed" |
| 405 << std::endl; | |
| 6487 | 406 } |
| 5189 | 407 |
| 408 unwind_protect::run_frame ("execute_eval_option_code"); | |
| 409 | |
| 410 return parse_status; | |
| 411 } | |
| 412 | |
| 413 static void | |
| 414 execute_command_line_file (const std::string& fname) | |
| 415 { | |
| 416 unwind_protect::begin_frame ("execute_command_line_file"); | |
| 417 | |
| 7202 | 418 octave_save_signal_mask (); |
| 419 | |
| 420 can_interrupt = true; | |
| 421 | |
| 422 octave_signal_hook = octave_signal_handler; | |
| 423 octave_interrupt_hook = unwind_protect::run_all; | |
| 424 octave_bad_alloc_hook = unwind_protect::run_all; | |
| 425 | |
| 426 octave_catch_interrupts (); | |
| 427 | |
| 428 octave_initialized = true; | |
| 429 | |
| 5189 | 430 unwind_protect_bool (interactive); |
| 431 unwind_protect_bool (reading_script_file); | |
| 432 unwind_protect_bool (input_from_command_line_file); | |
| 433 | |
| 434 unwind_protect_str (curr_fcn_file_name); | |
| 435 unwind_protect_str (curr_fcn_file_full_name); | |
| 436 | |
| 5780 | 437 unwind_protect_str (octave_program_invocation_name); |
| 438 unwind_protect_str (octave_program_name); | |
| 5189 | 439 |
| 440 interactive = false; | |
| 441 reading_script_file = true; | |
| 442 input_from_command_line_file = true; | |
| 443 | |
| 444 curr_fcn_file_name = fname; | |
| 445 curr_fcn_file_full_name = curr_fcn_file_name; | |
| 446 | |
| 5780 | 447 octave_program_invocation_name = curr_fcn_file_name; |
| 5189 | 448 |
|
8007
a2ab20ba78f7
make file_ops a proper singleton class
John W. Eaton <jwe@octave.org>
parents:
7752
diff
changeset
|
449 size_t pos = curr_fcn_file_name.find_last_of (file_ops::dir_sep_chars ()); |
| 5189 | 450 |
| 8021 | 451 std::string tmp = (pos != std::string::npos) |
| 5189 | 452 ? curr_fcn_file_name.substr (pos+1) : curr_fcn_file_name; |
| 453 | |
| 5780 | 454 octave_program_name = tmp; |
| 5189 | 455 |
| 6504 | 456 try |
| 457 { | |
|
7715
5b4d278ec828
parse scripts completely before executing
John W. Eaton <jwe@octave.org>
parents:
7481
diff
changeset
|
458 std::string context; |
|
5b4d278ec828
parse scripts completely before executing
John W. Eaton <jwe@octave.org>
parents:
7481
diff
changeset
|
459 bool verbose = false; |
|
5b4d278ec828
parse scripts completely before executing
John W. Eaton <jwe@octave.org>
parents:
7481
diff
changeset
|
460 bool require_file = true; |
|
5b4d278ec828
parse scripts completely before executing
John W. Eaton <jwe@octave.org>
parents:
7481
diff
changeset
|
461 |
|
5b4d278ec828
parse scripts completely before executing
John W. Eaton <jwe@octave.org>
parents:
7481
diff
changeset
|
462 source_file (fname, context, verbose, require_file, "octave"); |
| 6504 | 463 } |
| 7202 | 464 catch (octave_interrupt_exception) |
| 465 { | |
| 466 recover_from_exception (); | |
| 467 octave_stdout << "\n"; | |
| 468 } | |
| 6504 | 469 catch (std::bad_alloc) |
| 470 { | |
| 6680 | 471 std::cerr << "error: memory exhausted or requested size too large for range of Octave's index type -- execution of " |
| 472 << fname << " failed" << std::endl; | |
| 6504 | 473 } |
| 5189 | 474 |
| 475 unwind_protect::run_frame ("execute_command_line_file"); | |
| 476 } | |
| 477 | |
| 581 | 478 // Usage message with extra help. |
| 479 | |
| 1 | 480 static void |
| 481 verbose_usage (void) | |
| 482 { | |
| 3922 | 483 std::cout << OCTAVE_NAME_VERSION_COPYRIGHT_COPYING_AND_WARRANTY "\n\ |
| 1613 | 484 \n\ |
| 485 Usage: octave [options]\n\ | |
| 486 \n\ | |
| 487 Options:\n\ | |
| 1119 | 488 \n\ |
| 3180 | 489 --debug, -d Enter parser debugging mode.\n\ |
|
8923
d47290508a55
document --doc-cache-file option
John W. Eaton <jwe@octave.org>
parents:
8920
diff
changeset
|
490 --doc-cache-file FILE Use doc cache file FILE.\n\ |
| 3180 | 491 --echo-commands, -x Echo commands as they are executed.\n\ |
| 5191 | 492 --eval CODE Evaluate CODE. Exit when done unless --persist.\n\ |
| 1613 | 493 --exec-path PATH Set path for executing subprograms.\n\ |
| 3180 | 494 --help, -h, -? Print short help message and exit.\n\ |
| 6615 | 495 --image-path PATH Set initial IMAGE_PATH to PATH.\n\ |
| 1613 | 496 --info-file FILE Use top-level info file FILE.\n\ |
| 497 --info-program PROGRAM Use PROGRAM for reading info files.\n\ | |
| 3180 | 498 --interactive, -i Force interactive behavior.\n\ |
| 6938 | 499 --line-editing Force readline use for command-line editing.\n\ |
| 3180 | 500 --no-history, -H Don't save commands to the history list\n\ |
| 2470 | 501 --no-init-file Don't read the ~/.octaverc or .octaverc files.\n\ |
| 2212 | 502 --no-line-editing Don't use readline for command-line editing.\n\ |
| 2470 | 503 --no-site-file Don't read the site-wide octaverc file.\n\ |
| 3238 | 504 --norc, -f Don't read any initialization files.\n\ |
| 5814 | 505 --path PATH, -p PATH Set initial function search path to PATH.\n\ |
| 5189 | 506 --persist Go interactive after --eval or reading from FILE.\n\ |
| 3180 | 507 --silent, -q Don't print message at startup.\n\ |
| 1613 | 508 --traditional Set compatibility variables.\n\ |
| 3180 | 509 --verbose, -V Enable verbose output in some cases.\n\ |
| 510 --version, -v Print version number and exit.\n\ | |
| 1119 | 511 \n\ |
| 5190 | 512 FILE Execute commands from FILE. Exit when done\n\ |
| 5191 | 513 unless --persist is also specified.\n\ |
| 4829 | 514 \n" |
| 515 OCTAVE_WWW_STATEMENT "\n\ | |
| 4356 | 516 \n" |
| 517 OCTAVE_CONTRIB_STATEMENT "\n\ | |
| 518 \n" | |
| 519 OCTAVE_BUGS_STATEMENT "\n"; | |
| 285 | 520 |
| 613 | 521 exit (0); |
| 1 | 522 } |
| 523 | |
| 581 | 524 // Terse usage messsage. |
| 525 | |
| 1 | 526 static void |
| 527 usage (void) | |
| 528 { | |
| 3531 | 529 std::cerr << "usage: " << usage_string << "\n"; |
| 1 | 530 exit (1); |
| 531 } | |
| 532 | |
| 533 static void | |
| 534 print_version_and_exit (void) | |
| 535 { | |
| 3922 | 536 std::cout << OCTAVE_NAME_VERSION_COPYRIGHT_COPYING_WARRANTY_AND_BUGS "\n"; |
| 1 | 537 exit (0); |
| 538 } | |
| 539 | |
| 721 | 540 static void |
|
7481
78f3811155f7
use exceptions in liboctave error handler
John W. Eaton <jwe@octave.org>
parents:
7336
diff
changeset
|
541 lo_error_handler (const char *fmt, ...) |
|
78f3811155f7
use exceptions in liboctave error handler
John W. Eaton <jwe@octave.org>
parents:
7336
diff
changeset
|
542 { |
|
78f3811155f7
use exceptions in liboctave error handler
John W. Eaton <jwe@octave.org>
parents:
7336
diff
changeset
|
543 va_list args; |
|
78f3811155f7
use exceptions in liboctave error handler
John W. Eaton <jwe@octave.org>
parents:
7336
diff
changeset
|
544 va_start (args, fmt); |
|
78f3811155f7
use exceptions in liboctave error handler
John W. Eaton <jwe@octave.org>
parents:
7336
diff
changeset
|
545 verror (fmt, args); |
|
78f3811155f7
use exceptions in liboctave error handler
John W. Eaton <jwe@octave.org>
parents:
7336
diff
changeset
|
546 va_end (args); |
|
78f3811155f7
use exceptions in liboctave error handler
John W. Eaton <jwe@octave.org>
parents:
7336
diff
changeset
|
547 |
|
78f3811155f7
use exceptions in liboctave error handler
John W. Eaton <jwe@octave.org>
parents:
7336
diff
changeset
|
548 octave_throw_execution_exception (); |
|
78f3811155f7
use exceptions in liboctave error handler
John W. Eaton <jwe@octave.org>
parents:
7336
diff
changeset
|
549 } |
|
78f3811155f7
use exceptions in liboctave error handler
John W. Eaton <jwe@octave.org>
parents:
7336
diff
changeset
|
550 |
|
78f3811155f7
use exceptions in liboctave error handler
John W. Eaton <jwe@octave.org>
parents:
7336
diff
changeset
|
551 static void |
| 721 | 552 initialize_error_handlers () |
| 553 { | |
|
7481
78f3811155f7
use exceptions in liboctave error handler
John W. Eaton <jwe@octave.org>
parents:
7336
diff
changeset
|
554 set_liboctave_error_handler (lo_error_handler); |
| 3325 | 555 set_liboctave_warning_handler (warning); |
| 5781 | 556 set_liboctave_warning_with_id_handler (warning_with_id); |
| 721 | 557 } |
| 558 | |
| 1410 | 559 // What happens on --traditional. |
| 560 | |
| 561 static void | |
| 562 maximum_braindamage (void) | |
| 563 { | |
| 5189 | 564 persist = true; |
| 565 | |
| 5794 | 566 bind_internal_variable ("PS1", ">> "); |
| 567 bind_internal_variable ("PS2", ""); | |
| 568 bind_internal_variable ("beep_on_error", true); | |
|
8473
4dd0213bb883
octave.cc (maximum_braindamage): set confirm_recursive_rmdir to false
John W. Eaton <jwe@octave.org>
parents:
8347
diff
changeset
|
569 bind_internal_variable ("confirm_recursive_rmdir", false); |
| 5794 | 570 bind_internal_variable ("crash_dumps_octave_core", false); |
| 571 bind_internal_variable ("default_save_options", "-mat-binary"); | |
| 572 bind_internal_variable ("fixed_point_format", true); | |
| 573 bind_internal_variable ("history_timestamp_format_string", | |
| 5305 | 574 "%%-- %D %I:%M %p --%%"); |
| 5794 | 575 bind_internal_variable ("page_screen_output", false); |
| 576 bind_internal_variable ("print_empty_dimensions", false); | |
| 5904 | 577 |
| 6159 | 578 disable_warning ("Octave:fopen-file-in-path"); |
| 5904 | 579 disable_warning ("Octave:function-name-clash"); |
| 6159 | 580 disable_warning ("Octave:load-file-in-path"); |
| 1410 | 581 } |
| 582 | |
| 581 | 583 // You guessed it. |
| 584 | |
| 1 | 585 int |
| 4368 | 586 octave_main (int argc, char **argv, int embedded) |
| 1 | 587 { |
| 3019 | 588 octave_env::set_program_name (argv[0]); |
| 589 | |
| 5780 | 590 octave_program_invocation_name = octave_env::get_program_invocation_name (); |
| 591 octave_program_name = octave_env::get_program_name (); | |
| 592 | |
| 2205 | 593 // The order of these calls is important. The call to |
| 2926 | 594 // install_defaults must come before install_builtins because |
| 3019 | 595 // default variable values must be available for the variables to be |
| 2205 | 596 // installed, and the call to install_builtins must come before the |
| 597 // options are processed because some command line options override | |
| 5794 | 598 // defaults by calling bind_internal_variable. |
| 721 | 599 |
| 5844 | 600 init_signals (); |
| 601 | |
| 1 | 602 sysdep_init (); |
| 603 | |
| 4159 | 604 // The idea here is to force xerbla to be referenced so that we will |
| 605 // link to our own version instead of the one provided by the BLAS | |
| 606 // library. But octave_NaN should never be -1, so we should never | |
| 607 // actually call xerbla. | |
| 608 | |
| 609 if (octave_NaN == -1) | |
| 610 F77_FUNC (xerbla, XERBLA) ("octave", 13, 6L); | |
| 611 | |
| 721 | 612 initialize_error_handlers (); |
| 223 | 613 |
| 5794 | 614 initialize_default_warning_state (); |
| 615 | |
| 2926 | 616 install_defaults (); |
| 1 | 617 |
| 1792 | 618 initialize_pathsearch (); |
| 1744 | 619 |
| 4368 | 620 if (! embedded) |
| 621 install_signal_handlers (); | |
| 2205 | 622 |
| 623 initialize_file_io (); | |
| 624 | |
| 2375 | 625 install_types (); |
| 626 | |
| 627 install_ops (); | |
| 2205 | 628 |
| 629 install_builtins (); | |
| 630 | |
| 1817 | 631 prog_args args (argc, argv, short_opts, long_opts); |
| 632 | |
| 6938 | 633 bool forced_line_editing = false; |
| 634 | |
|
8273
2c1ba965b486
skip reading history file with --no-history option
John W. Eaton <jwe@octave.org>
parents:
8099
diff
changeset
|
635 bool read_history_file = true; |
|
2c1ba965b486
skip reading history file with --no-history option
John W. Eaton <jwe@octave.org>
parents:
8099
diff
changeset
|
636 |
| 139 | 637 int optc; |
| 1817 | 638 while ((optc = args.getopt ()) != EOF) |
| 1 | 639 { |
| 139 | 640 switch (optc) |
| 1 | 641 { |
| 3180 | 642 case 'H': |
|
8273
2c1ba965b486
skip reading history file with --no-history option
John W. Eaton <jwe@octave.org>
parents:
8099
diff
changeset
|
643 read_history_file = false; |
| 5794 | 644 bind_internal_variable ("saving_history", false); |
| 3180 | 645 break; |
| 646 | |
| 793 | 647 case 'V': |
| 2239 | 648 verbose_flag = true; |
| 793 | 649 break; |
| 650 | |
| 1 | 651 case 'd': |
| 4753 | 652 // This is the same as yydebug in parse.y. |
| 653 octave_debug++; | |
| 1 | 654 break; |
| 777 | 655 |
| 1 | 656 case 'f': |
| 2239 | 657 read_init_files = false; |
| 658 read_site_files = false; | |
| 1 | 659 break; |
| 777 | 660 |
| 1 | 661 case 'h': |
| 662 case '?': | |
| 663 verbose_usage (); | |
| 664 break; | |
| 777 | 665 |
| 1 | 666 case 'i': |
| 3019 | 667 forced_interactive = true; |
| 1 | 668 break; |
| 777 | 669 |
| 1 | 670 case 'p': |
| 1817 | 671 if (args.optarg ()) |
| 5832 | 672 load_path::set_command_line_path (args.optarg ()); |
| 1 | 673 break; |
| 777 | 674 |
| 1 | 675 case 'q': |
| 2239 | 676 inhibit_startup_message = true; |
| 1 | 677 break; |
| 777 | 678 |
| 1 | 679 case 'x': |
| 2205 | 680 { |
| 681 double tmp = (ECHO_SCRIPTS | ECHO_FUNCTIONS | ECHO_CMD_LINE); | |
| 5794 | 682 bind_internal_variable ("echo_executing_commands", tmp); |
| 2205 | 683 } |
| 1 | 684 break; |
| 777 | 685 |
| 1 | 686 case 'v': |
| 687 print_version_and_exit (); | |
| 688 break; | |
| 777 | 689 |
| 8861 | 690 case DOC_CACHE_FILE_OPTION: |
| 691 if (args.optarg ()) | |
| 692 bind_internal_variable ("doc_cache_file", args.optarg ()); | |
| 693 break; | |
| 694 | |
| 5189 | 695 case EVAL_OPTION: |
| 696 if (args.optarg ()) | |
| 5193 | 697 { |
| 698 if (code_to_eval.empty ()) | |
| 699 code_to_eval = args.optarg (); | |
| 700 else | |
| 701 code_to_eval += std::string (" ") + args.optarg (); | |
| 702 } | |
| 5189 | 703 break; |
| 704 | |
| 1613 | 705 case EXEC_PATH_OPTION: |
| 1817 | 706 if (args.optarg ()) |
| 5814 | 707 set_exec_path (args.optarg ()); |
| 708 break; | |
| 709 | |
| 710 case IMAGE_PATH_OPTION: | |
| 711 if (args.optarg ()) | |
| 712 set_image_path (args.optarg ()); | |
| 1613 | 713 break; |
| 714 | |
| 186 | 715 case INFO_FILE_OPTION: |
| 1817 | 716 if (args.optarg ()) |
| 5794 | 717 bind_internal_variable ("info_file", args.optarg ()); |
| 186 | 718 break; |
| 777 | 719 |
| 1613 | 720 case INFO_PROG_OPTION: |
| 1817 | 721 if (args.optarg ()) |
| 5794 | 722 bind_internal_variable ("info_program", args.optarg ()); |
| 1613 | 723 break; |
| 724 | |
| 6938 | 725 case LINE_EDITING_OPTION: |
| 726 forced_line_editing = true; | |
| 727 break; | |
| 728 | |
| 2239 | 729 case NO_INIT_FILE_OPTION: |
| 730 read_init_files = false; | |
| 731 break; | |
| 732 | |
| 1821 | 733 case NO_LINE_EDITING_OPTION: |
| 3019 | 734 line_editing = false; |
| 2239 | 735 break; |
| 736 | |
| 737 case NO_SITE_FILE_OPTION: | |
| 738 read_site_files = 0; | |
| 1821 | 739 break; |
| 740 | |
| 6365 | 741 case NO_INITIAL_PATH_OPTION: |
| 742 set_initial_path = false; | |
| 743 break; | |
| 744 | |
| 1410 | 745 case TRADITIONAL_OPTION: |
| 2239 | 746 traditional = true; |
| 1410 | 747 break; |
| 748 | |
| 5189 | 749 case PERSIST_OPTION: |
| 750 persist = true; | |
| 751 break; | |
| 752 | |
| 1 | 753 default: |
| 754 usage (); | |
| 755 break; | |
| 756 } | |
| 757 } | |
| 758 | |
| 1651 | 759 #if defined (HAVE_ATEXIT) || defined (HAVE_ON_EXIT) |
| 2077 | 760 // Make sure we clean up when we exit. Also allow users to register |
| 761 // functions. If we don't have atexit or on_exit, we're going to | |
| 762 // leave some junk files around if we exit abnormally. | |
| 763 | |
| 764 atexit (do_octave_atexit); | |
| 318 | 765 #endif |
| 1 | 766 |
| 1358 | 767 // These can come after command line args since none of them set any |
| 768 // defaults that might be changed by command line options. | |
| 581 | 769 |
| 2926 | 770 initialize_command_input (); |
| 315 | 771 |
| 578 | 772 if (! inhibit_startup_message) |
| 3538 | 773 std::cout << OCTAVE_STARTUP_MESSAGE "\n" << std::endl; |
| 578 | 774 |
| 1410 | 775 if (traditional) |
| 776 maximum_braindamage (); | |
| 777 | |
| 4217 | 778 octave_interpreter_ready = true; |
| 779 | |
| 5654 | 780 initialize_version_info (); |
| 781 | |
|
8099
e0a6e54f5a19
octave.cc (octave_main): make all command-line arguments available to startup scripts
John W. Eaton <jwe@octave.org>
parents:
8021
diff
changeset
|
782 // Make all command-line arguments available to startup files, |
|
e0a6e54f5a19
octave.cc (octave_main): make all command-line arguments available to startup scripts
John W. Eaton <jwe@octave.org>
parents:
8021
diff
changeset
|
783 // including PKG_ADD files. |
|
e0a6e54f5a19
octave.cc (octave_main): make all command-line arguments available to startup scripts
John W. Eaton <jwe@octave.org>
parents:
8021
diff
changeset
|
784 |
|
e0a6e54f5a19
octave.cc (octave_main): make all command-line arguments available to startup scripts
John W. Eaton <jwe@octave.org>
parents:
8021
diff
changeset
|
785 intern_argv (argc, argv); |
|
e0a6e54f5a19
octave.cc (octave_main): make all command-line arguments available to startup scripts
John W. Eaton <jwe@octave.org>
parents:
8021
diff
changeset
|
786 |
| 6365 | 787 load_path::initialize (set_initial_path); |
| 4217 | 788 |
| 2239 | 789 execute_startup_files (); |
| 1651 | 790 |
|
8273
2c1ba965b486
skip reading history file with --no-history option
John W. Eaton <jwe@octave.org>
parents:
8099
diff
changeset
|
791 initialize_history (read_history_file); |
| 1 | 792 |
| 578 | 793 if (! inhibit_startup_message && reading_startup_message_printed) |
| 3538 | 794 std::cout << std::endl; |
| 578 | 795 |
| 5189 | 796 // Is input coming from a terminal? If so, we are probably |
| 797 // interactive. | |
| 1358 | 798 |
| 5189 | 799 interactive = (! embedded |
| 800 && isatty (fileno (stdin)) && isatty (fileno (stdout))); | |
| 801 | |
| 6938 | 802 if (! interactive && ! forced_line_editing) |
| 5189 | 803 line_editing = false; |
| 1 | 804 |
| 1358 | 805 // If there is an extra argument, see if it names a file to read. |
| 806 // Additional arguments are taken as command line options for the | |
| 807 // script. | |
| 1 | 808 |
| 1817 | 809 int last_arg_idx = args.optind (); |
| 3019 | 810 |
| 1817 | 811 int remaining_args = argc - last_arg_idx; |
| 3019 | 812 |
| 5189 | 813 if (! code_to_eval.empty ()) |
| 149 | 814 { |
| 5189 | 815 int parse_status = execute_eval_option_code (code_to_eval); |
| 816 | |
| 5242 | 817 if (! (persist || remaining_args > 0)) |
| 5502 | 818 clean_up_and_exit (parse_status || error_state ? 1 : 0); |
| 1 | 819 } |
| 820 | |
| 5189 | 821 if (remaining_args > 0) |
| 822 { | |
| 823 // If we are running an executable script (#! /bin/octave) then | |
| 824 // we should only see the args passed to the script. | |
| 825 | |
| 826 intern_argv (remaining_args, argv+last_arg_idx); | |
| 827 | |
| 828 execute_command_line_file (argv[last_arg_idx]); | |
| 829 | |
| 830 if (! persist) | |
| 5502 | 831 clean_up_and_exit (error_state ? 1 : 0); |
| 5189 | 832 } |
| 833 | |
| 834 // Avoid counting commands executed from startup files. | |
| 835 | |
| 836 command_editor::reset_current_command_number (1); | |
| 837 | |
| 838 // Now argv should have the full set of args. | |
| 839 intern_argv (argc, argv); | |
| 840 | |
| 841 if (! embedded) | |
| 842 switch_to_buffer (create_buffer (get_input_from_stdin ())); | |
| 843 | |
| 1358 | 844 // Force input to be echoed if not really interactive, but the user |
| 845 // has forced interactive behavior. | |
| 1 | 846 |
| 1907 | 847 if (! interactive && forced_interactive) |
| 287 | 848 { |
| 2926 | 849 command_editor::blink_matching_paren (false); |
| 1588 | 850 |
| 5775 | 851 // FIXME -- is this the right thing to do? |
| 1588 | 852 |
| 5794 | 853 bind_internal_variable ("echo_executing_commands", ECHO_CMD_LINE); |
| 287 | 854 } |
| 1 | 855 |
| 4368 | 856 if (embedded) |
| 5502 | 857 { |
| 5775 | 858 // FIXME -- do we need to do any cleanup here before |
| 5502 | 859 // returning? If we don't, what will happen to Octave functions |
| 860 // that have been registered to execute with atexit, for example? | |
| 861 | |
| 862 return 1; | |
| 863 } | |
| 4368 | 864 |
| 5189 | 865 int retval = main_loop (); |
| 1 | 866 |
| 1005 | 867 if (retval == 1 && ! error_state) |
| 868 retval = 0; | |
| 869 | |
| 1 | 870 clean_up_and_exit (retval); |
| 4247 | 871 |
| 872 return 0; | |
| 1 | 873 } |
| 874 | |
| 5780 | 875 DEFUN (argv, args, , |
| 876 "-*- texinfo -*-\n\ | |
| 877 @deftypefn {Built-in Function} {} argv ()\n\ | |
| 878 Return the command line arguments passed to Octave. For example,\n\ | |
| 879 if you invoked Octave using the command\n\ | |
| 880 \n\ | |
| 881 @example\n\ | |
| 882 octave --no-line-editing --silent\n\ | |
| 883 @end example\n\ | |
| 884 \n\ | |
| 885 @noindent\n\ | |
| 886 @code{argv} would return a cell array of strings with the elements\n\ | |
| 887 @code{--no-line-editing} and @code{--silent}.\n\ | |
| 888 \n\ | |
| 889 If you write an executable Octave script, @code{argv} will return the\n\ | |
| 890 list of arguments passed to the script. @xref{Executable Octave Programs},\n\ | |
| 891 for an example of how to create an executable Octave script.\n\ | |
| 892 @end deftypefn") | |
| 893 { | |
| 894 octave_value retval; | |
| 895 | |
| 896 if (args.length () == 0) | |
| 897 retval = Cell (octave_argv); | |
| 898 else | |
| 5823 | 899 print_usage (); |
| 5780 | 900 |
| 901 return retval; | |
| 902 } | |
| 903 | |
| 904 DEFUN (program_invocation_name, args, , | |
| 905 "-*- texinfo -*-\n\ | |
| 906 @deftypefn {Built-in Function} program_invocation_name ()\n\ | |
| 907 Return the name that was typed at the shell prompt to run Octave.\n\ | |
| 908 \n\ | |
| 909 If executing a script from the command line (e.g., @code{octave foo.m})\n\ | |
| 910 or using an executable Octave script, the program name is set to the\n\ | |
| 911 name of the script. @xref{Executable Octave Programs}, for an example of\n\ | |
| 912 how to create an executable Octave script.\n\ | |
| 913 @seealso{program_name}\n\ | |
| 914 @end deftypefn") | |
| 915 { | |
| 916 octave_value retval; | |
| 917 | |
| 918 if (args.length () == 0) | |
| 919 retval = octave_program_invocation_name; | |
| 920 else | |
| 5823 | 921 print_usage (); |
| 5780 | 922 |
| 923 return retval; | |
| 924 } | |
| 925 | |
| 926 DEFUN (program_name, args, , | |
| 927 "-*- texinfo -*-\n\ | |
| 928 @deftypefn {Built-in Function} {} program_name ()\n\ | |
|
8347
fa78cb8d8a5c
corrections for typos
Brian Gough<bjg@network-theory.co.uk>
parents:
8273
diff
changeset
|
929 Return the last component of the value returned by\n\ |
| 5780 | 930 @code{program_invocation_name}.\n\ |
| 931 @seealso{program_invocation_name}\n\ | |
| 932 @end deftypefn") | |
| 933 { | |
| 934 octave_value retval; | |
| 935 | |
| 936 if (args.length () == 0) | |
| 937 retval = octave_program_name; | |
| 938 else | |
| 5823 | 939 print_usage (); |
| 5780 | 940 |
| 941 return retval; | |
| 942 } | |
| 943 | |
| 560 | 944 /* |
| 1 | 945 ;;; Local Variables: *** |
| 946 ;;; mode: C++ *** | |
| 947 ;;; End: *** | |
| 948 */ |