comparison libinterp/usage.h @ 29949:f254c302bb9c

remove JIT compiler from Octave sources As stated in the NEWS file entry added with this changeset, no one has ever seriously taken on further development of the JIT compiler in Octave since it was first added as part of a Google Summer of Code project in 2012 and it still does nothing significant. It is out of date with the default interpreter that walks the parse tree. Even though we have fixed the configure script to disable it by default, people still ask questions about how to build it, but it doesn’t seem that they are doing that to work on it but because they think it will make Octave code run faster (it never did, except for some extremely simple bits of code as examples for demonstration purposes only). * NEWS: Note change. * configure.ac, acinclude.m4: Eliminate checks and macros related to the JIT compiler and LLVM. * basics.txi, install.txi, octave.texi, vectorize.txi: Remove mention of JIT compiler and LLVM. * jit-ir.cc, jit-ir.h, jit-typeinfo.cc, jit-typeinfo.h, jit-util.cc, jit-util.h, pt-jit.cc, pt-jit.h: Delete. * libinterp/parse-tree/module.mk: Update. * Array-jit.cc: Delete. * libinterp/template-inst/module.mk: Update. * test/jit.tst: Delete. * test/module.mk: Update. * interpreter.cc (interpreter::interpreter): Don't check options for debug_jit or jit_compiler. * toplev.cc (F__octave_config_info__): Remove JIT compiler and LLVM info from struct. * ov-base.h (octave_base_value::grab, octave_base_value::release): Delete. * ov-builtin.h, ov-builtin.cc (octave_builtin::to_jit, octave_builtin::stash_jit): Delete. (octave_builtin::m_jtype): Delete data member and all uses. * ov-usr-fcn.h, ov-usr-fcn.cc (octave_user_function::m_jit_info): Delete data member and all uses. (octave_user_function::get_info, octave_user_function::stash_info): Delete. * options.h (DEBUG_JIT_OPTION, JIT_COMPILER_OPTION): Delete macro definitions and all uses. * octave.h, octave.cc (cmdline_options::cmdline_options): Don't handle DEBUG_JIT_OPTION, JIT_COMPILER_OPTION): Delete. (cmdline_options::debug_jit, cmdline_options::jit_compiler): Delete functions and all uses. (cmdline_options::m_debug_jit, cmdline_options::m_jit_compiler): Delete data members and all uses. (octave_getopt_options long_opts): Remove "debug-jit" and "jit-compiler" from the list. * pt-eval.cc (tree_evaluator::visit_simple_for_command, tree_evaluator::visit_complex_for_command, tree_evaluator::visit_while_command, tree_evaluator::execute_user_function): Eliminate JIT compiler code. * pt-loop.h, pt-loop.cc (tree_while_command::get_info, tree_while_command::stash_info, tree_simple_for_command::get_info, tree_simple_for_command::stash_info): Delete functions and all uses. (tree_while_command::m_compiled, tree_simple_for_command::m_compiled): Delete member variable and all uses. * usage.h (usage_string, octave_print_verbose_usage_and_exit): Remove [--debug-jit] and [--jit-compiler] from the message. * Array.h (Array<T>::Array): Remove constructor that was only intended to be used by the JIT compiler. (Array<T>::jit_ref_count, Array<T>::jit_slice_data, Array<T>::jit_dimensions, Array<T>::jit_array_rep): Delete. * Marray.h (MArray<T>::MArray): Remove constructor that was only intended to be used by the JIT compiler. * NDArray.h (NDArray::NDarray): Remove constructor that was only intended to be used by the JIT compiler. * dim-vector.h (dim_vector::to_jit): Delete. (dim_vector::dim_vector): Remove constructor that was only intended to be used by the JIT compiler. * codeql-analysis.yaml, make.yaml: Don't require llvm-dev. * subst-config-vals.in.sh, subst-cross-config-vals.in.sh: Don't substitute OCTAVE_CONF_LLVM_CPPFLAGS, OCTAVE_CONF_LLVM_LDFLAGS, or OCTAVE_CONF_LLVM_LIBS. * Doxyfile.in: Don't define HAVE_LLVM. * aspell-octave.en.pws: Eliminate jit, JIT, and LLVM from the list of spelling exceptions. * build-env.h, build-env.in.cc (LLVM_CPPFLAGS, LLVM_LDFLAGS, LLVM_LIBS): Delete variables and all uses. * libinterp/corefcn/module.mk (%canon_reldir%_libcorefcn_la_CPPFLAGS): Remove $(LLVM_CPPFLAGS) from the list. * libinterp/parse-tree/module.mk (%canon_reldir%_libparse_tree_la_CPPFLAGS): Remove $(LLVM_CPPFLAGS) from the list.
author John W. Eaton <jwe@octave.org>
date Tue, 10 Aug 2021 16:42:29 -0400
parents 853e4b7ae0d5
children 796f54d4ddbf
comparison
equal deleted inserted replaced
29948:c92a4ebaa777 29949:f254c302bb9c
32 32
33 #include "version.h" 33 #include "version.h"
34 34
35 // Usage message 35 // Usage message
36 static const char *usage_string = 36 static const char *usage_string =
37 "octave [-HVWdfhiqvx] [--debug] [--debug-jit] [--doc-cache-file file]\n\ 37 "octave [-HVWdfhiqvx] [--debug] [--doc-cache-file file] [--echo-commands]\n\
38 [--echo-commands] [--eval CODE] [--exec-path path]\n\ 38 [--eval CODE] [--exec-path path] [--experimental-terminal-widget]\n\
39 [--experimental-terminal-widget] [--gui] [--help] [--image-path path]\n\ 39 [--gui] [--help] [--image-path path] [--info-file file]\n\
40 [--info-file file] [--info-program prog] [--interactive]\n\ 40 [--info-program prog] [--interactive] [--line-editing] [--no-gui]\n\
41 [--jit-compiler] [--line-editing] [--no-gui] [--no-history]\n\ 41 [--no-history] [--no-init-file] [--no-init-path] [--no-line-editing]\n\
42 [--no-init-file] [--no-init-path] [--no-line-editing]\n\
43 [--no-site-file] [--no-window-system] [--norc] [-p path]\n\ 42 [--no-site-file] [--no-window-system] [--norc] [-p path]\n\
44 [--path path] [--persist] [--server] [--silent] [--traditional]\n\ 43 [--path path] [--persist] [--server] [--silent] [--traditional]\n\
45 [--verbose] [--version] [file]"; 44 [--verbose] [--version] [file]";
46 45
47 // Usage message with extra help. 46 // Usage message with extra help.
56 \n\ 55 \n\
57 Options:\n\ 56 Options:\n\
58 \n\ 57 \n\
59 --built-in-docstrings-file FILE Use docs for built-ins from FILE.\n\ 58 --built-in-docstrings-file FILE Use docs for built-ins from FILE.\n\
60 --debug, -d Enter parser debugging mode.\n\ 59 --debug, -d Enter parser debugging mode.\n\
61 --debug-jit Enable JIT compiler debugging/tracing.\n\
62 --doc-cache-file FILE Use doc cache file FILE.\n\ 60 --doc-cache-file FILE Use doc cache file FILE.\n\
63 --echo-commands, -x Echo commands as they are executed.\n\ 61 --echo-commands, -x Echo commands as they are executed.\n\
64 --eval CODE Evaluate CODE. Exit when done unless --persist.\n\ 62 --eval CODE Evaluate CODE. Exit when done unless --persist.\n\
65 --exec-path PATH Set path for executing subprograms.\n\ 63 --exec-path PATH Set path for executing subprograms.\n\
66 --experimental-terminal-widget\n\ 64 --experimental-terminal-widget\n\
69 --help, -h, Print short help message and exit.\n\ 67 --help, -h, Print short help message and exit.\n\
70 --image-path PATH Add PATH to head of image search path.\n\ 68 --image-path PATH Add PATH to head of image search path.\n\
71 --info-file FILE Use top-level info file FILE.\n\ 69 --info-file FILE Use top-level info file FILE.\n\
72 --info-program PROGRAM Use PROGRAM for reading info files.\n\ 70 --info-program PROGRAM Use PROGRAM for reading info files.\n\
73 --interactive, -i Force interactive behavior.\n\ 71 --interactive, -i Force interactive behavior.\n\
74 --jit-compiler Enable the JIT compiler.\n\
75 --line-editing Force readline use for command-line editing.\n\ 72 --line-editing Force readline use for command-line editing.\n\
76 --no-gui Disable the graphical user interface.\n\ 73 --no-gui Disable the graphical user interface.\n\
77 --no-history, -H Don't save commands to the history list\n\ 74 --no-history, -H Don't save commands to the history list\n\
78 --no-init-file Don't read the ~/.octaverc or .octaverc files.\n\ 75 --no-init-file Don't read the ~/.octaverc or .octaverc files.\n\
79 --no-init-path Don't initialize function search path.\n\ 76 --no-init-path Don't initialize function search path.\n\