mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-10 00:00:39 -08:00
Code Issues Projects Releases Wiki Activity

better doc

Browse source
This commit is contained in:
Andrea Corallo 2019-11-10 18:50:34 +01:00
parent c9f3679506
commit 00c493f017
1 changed files with 16 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

27
lisp/emacs-lisp/comp.el
View file

@ -38,26 +38,31 @@
"Emacs Lisp native compiler." "Emacs Lisp native compiler."
:group 'lisp) :group 'lisp)
(defcustom comp-speed 2 (defcustom comp-speed 0
"Compiler optimization level. From 0 to 3." "Compiler optimization level. From 0 to 3.
- 0 no otimizations are performed, compile time is favored.
- 1 lite optimizations.
- 2 heavy optimizations.
- 3 max optimization level, to be used only when necessary.
The compiler can inline within the compilation unit..."
:type 'number :type 'number
:group 'comp) :group 'comp)
(defcustom comp-debug 0 (defcustom comp-debug 0
"Compiler debug level. From 0 to 3. "Compiler debug level. From 0 to 3.
- 0 no debug facility - 0 no debug facility.
- 1 emit debug symbols and dump pseudo C code - 1 emit debug symbols and dump pseudo C code.
- 2 dump gcc passes and libgccjit log file - 2 dump gcc passes and libgccjit log file.
- 3 dump libgccjit reproducer" - 3 dump libgccjit reproducer."
:type 'number :type 'number
:group 'comp) :group 'comp)
(defcustom comp-verbose 0 (defcustom comp-verbose 0
"Compiler verbosity. From 0 to 3. "Compiler verbosity. From 0 to 3.
- 0 no logging - 0 no logging.
- 1 final limple is logged - 1 final limple is logged.
- 2 LAP and final limple and some pass info are logged - 2 LAP and final limple and some pass info are logged.
- 3 max verbosity" - 3 max verbosity."
:type 'number :type 'number
:group 'comp) :group 'comp)
@ -1752,7 +1757,7 @@ Prepare every function for final compilation and drive the C back-end."
(defun native-compile (input) (defun native-compile (input)
"Compile INPUT into native code. "Compile INPUT into native code.
This is the entrypoint for the Emacs Lisp native compiler. This is the entrypoint for the Emacs Lisp native compiler.
If INPUT is a symbol, native-compile its function definition. If INPUT is a symbol, native compile its function definition.
If INPUT is a string, use it as the file path to be native compiled. If INPUT is a string, use it as the file path to be native compiled.
Return the compilation unit filename." Return the compilation unit filename."
(unless (or (symbolp input) (unless (or (symbolp input)