aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref/compile.texi (follow)
Commit message (Collapse)AuthorAgeFilesLines
* Document that 'byte-compile-dynamic' is obsoleteEli Zaretskii2020-03-071-1/+5
| | | | | | | * doc/lispref/compile.texi (Dynamic Loading): Document that this is deprecated. * etc/NEWS: mark the 'byte-compile-dynamic' entry as documented.
* Update copyright year to 2020Paul Eggert2020-01-011-1/+1
| | | | Run "TZ=UTC0 admin/update-copyright $(git ls-files)".
* Add the new macro with-suppressed-warningsLars Ingebrigtsen2019-06-121-4/+22
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | * lisp/emacs-lisp/byte-run.el (with-suppressed-warnings): New macro. * doc/lispref/compile.texi (Compiler Errors): Document with-suppressed-warnings and deemphasise with-no-warnings slightly. * lisp/emacs-lisp/bytecomp.el (byte-compile--suppressed-warnings): New internal variable. (byte-compile-warning-enabled-p): Heed byte-compile--suppressed-warnings, bound via with-suppressed-warnings. (byte-compile-initial-macro-environment): Provide a macro expansion of with-suppressed-warnings. (byte-compile-file-form-with-suppressed-warnings): New byte hunk handler for the suppressed symbol machinery. (byte-compile-suppressed-warnings): Ditto for the byteop. (byte-compile-file-form-defmumble): Ditto. (byte-compile-form, byte-compile-normal-call) (byte-compile-normal-call, byte-compile-variable-ref) (byte-compile-set-default, byte-compile-variable-set) (byte-compile-function-form, byte-compile-set-default) (byte-compile-warn-obsolete, byte-compile--declare-var): Pass the symbol being warned in to byte-compile-warning-enabled-p. * test/lisp/emacs-lisp/bytecomp-tests.el (test-suppression): New function. (bytecomp-test--with-suppressed-warnings): Tests.
* Update copyright year to 2019Paul Eggert2019-01-011-1/+1
| | | | Run 'TZ=UTC0 admin/update-copyright $(git ls-files)'.
* ; * doc/lispref/compile.texi (Compilation Functions): Fix wording.Eli Zaretskii2018-04-021-1/+1
|
* ; * doc/lispref/compile.texi (Compilation Functions): Fix typoTino Calancha2018-04-031-1/+1
|
* Explain more about (defvar foo) form (Bug#18059)Noam Postavsky2018-03-231-1/+2
| | | | | | | | | * doc/lispref/variables.texi (Defining Variables) (Using Lexical Binding): * doc/lispref/compile.texi (Compiler Errors): Emphasize that omitting VALUE for `defvar' marks the variable special only locally. * doc/lispref/variables.texi (Using Lexical Binding): Add example of using `defvar' without VALUE.
* Fix some issues in the emacs/lispref manualsMartin Rudalics2018-01-281-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/emacs/basic.texi (Continuation Lines): * doc/emacs/building.texi (GDB User Interface Layout): * doc/emacs/dired.texi (Misc Dired Features): * doc/emacs/maintaining.texi (Identifier Search): * doc/emacs/mark.texi (Using Region): * doc/emacs/misc.texi (Document View, DocView Conversion): * doc/emacs/modes.texi (Major Modes): * doc/emacs/mule.texi (Input Methods, Unibyte Mode): * doc/emacs/sending.texi (Mail Methods): Replace @code by @kbd. * doc/emacs/frames.texi (Text-Only Mouse): * doc/lispref/maps.texi (Standard Keymaps): Replace @kbd by @key. * doc/lispref/compile.texi (Compiler Errors): Write non-@code{nil} instead of non-nil. * doc/lispref/debugging.texi (Internals of Debugger): 'backtrace' is not a command. 'debugger-stack-frame-as-list' is an option. * doc/lispref/display.texi (Size of Displayed Text): 'window-lines-pixel-dimensions' has a last argument 'left'. * doc/lispref/display.texi (Attribute Functions): 'set-face-underline' and 'set-face-inverse-video' are commands. (Tooltips): 'tooltip-frame-parameters' is an option. (Bidirectional Display): 'bidi-paragraph-direction' is an option. * doc/lispref/frames.texi (Cursor Parameters): 'cursor-type' is an option. (Input Focus): Argument FRAME of 'x-focus-frame' is not optional. (Child Frames): Both arguments of 'frame-ancestor-p' are non-optional. 'iconify-child-frame' is an option. * doc/lispref/os.texi (Killing Emacs): 'kill-emacs-query-functions' is an option. * doc/lispref/windows.texi (Mouse Window Auto-selection): 'mouse-autoselect-window' is an option.
* Improve documentation of safe values of variablesEli Zaretskii2018-01-131-0/+5
| | | | | | | | | * doc/lispref/variables.texi (File Local Variables): Mention the autoload cookie as a means of defining safe values for variables. See http://lists.gnu.org/archive/html/emacs-devel/2018-01/msg00261.html for the details. * doc/lispref/compile.texi (Compiler Errors): Document 'byte-compile-error-on-warn'.
* Update copyright year to 2018Paul Eggert2018-01-011-1/+1
| | | | Run admin/update-copyright.
* Fix uses of 'nil' and 'non-nil' in manuals and a few more minor issuesMartin Rudalics2017-12-221-1/+1
| | | | | | | | | | | | | | | | * doc/emacs/building.texi (Grep Searching): Fix doc of 'grep-save-buffers'. (Drag and Drop): Reorder paragraphs. Fix doc of 'mouse-drag-and-drop-region'. * doc/emacs/frames.texi (Word and Line Mouse): * doc/emacs/search.texi (Other Repeating Search): * doc/lispref/compile.texi (Compilation Functions): * doc/lispref/files.texi (Directory Names): * doc/lispref/functions.texi (Advising Named Functions): * doc/lispref/keymaps.texi (Controlling Active Maps): * doc/lispref/lists.texi (Association Lists): * doc/lispref/windows.texi (Quitting Windows): Fix uses of 'non-nil' and 'nil'.
* Improve discoverability of 'defvar' for suppressing warningsEli Zaretskii2017-11-241-2/+8
| | | | | | | * doc/lispref/compile.texi (Compiler Errors): Add index entries. * doc/lispref/variables.texi (Defining Variables): Mention that defvar with no value is used for suppressing compiler warnings. (Bug#29400)
* Index byte-compile-debugEli Zaretskii2017-01-311-0/+1
| | | | | * doc/lispref/compile.texi (Compilation Functions): Index byte-compile-debug.
* Document `byte-compile-debug' in the ELisp manualPhilipp Stephani2017-01-311-3/+6
| | | | * doc/lispref/compile.texi: Document variable `byte-compile-debug'.
* Update copyright year to 2017Paul Eggert2016-12-311-1/+1
| | | | Run admin/update-copyright.
* Doc fixes for grammar and typos (bug#23746)Stephen Berman2016-06-131-1/+1
| | | | | | | | | | | | | | | * doc/emacs/files.texi (Customize Save): * doc/emacs/frames.texi (Window Dividers): * doc/emacs/misc.texi (Printing): * doc/lispref/compile.texi (Compiler Errors): * doc/lispref/keymaps.texi (Changing Key Bindings): * doc/lispref/loading.texi (Named Features): * doc/lispref/markers.texi (Marker Insertion Types): * doc/lispref/modes.texi (Mode Hooks): * doc/lispref/text.texi (Undo): * src/floatfns.c (Fldexp): * src/xfaces.c (syms_of_xfaces): Minor doc fixes for grammar and typos (bug#23746).
* Improve documentation of byte-code objectsEli Zaretskii2016-04-021-7/+18
| | | | | * doc/lispref/compile.texi (Byte-Code Objects): Document the integer format of the argument descriptor. (Bug#23061)
* Update copyright year to 2016Paul Eggert2016-01-011-1/+1
| | | | Run admin/update-copyright.
* Quote less in manualsPaul Eggert2015-09-151-3/+3
| | | | | | | | | | The manuals often used quotes ``...'' when it is better to use @dfn or @code or capitalized words or no quoting at all. For example, there is no need for the `` and '' in “if a variable has one effect for @code{nil} values and another effect for ``non-@code{nil}'' values”. Reword the Emacs, Lisp intro, and Lisp reference manuals to eliminate unnecessary quoting like this, and to use @dfn etc. instead when called for (Bug#21472).
* Update copyright year to 2015Paul Eggert2015-01-011-1/+1
| | | | Run admin/update-copyright.
* Improve indexing on the chapter/section/subsection levels.Eli Zaretskii2014-12-231-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | doc/lispref/windows.texi (Recombining Windows): Index subject of sections. doc/lispref/variables.texi (Variables with Restricted Values) (Generalized Variables): Index subject of sections. doc/lispref/text.texi (Buffer Contents, Examining Properties) (Changing Properties, Property Search, Substitution): Index subject of sections. doc/lispref/syntax.texi (Motion and Syntax, Parsing Expressions) (Motion via Parsing, Position Parse, Control Parsing): Index subject of sections. doc/lispref/strings.texi (Predicates for Strings, Creating Strings) (Modifying Strings, Text Comparison): Index subject of sections. doc/lispref/searching.texi (Syntax of Regexps, Regexp Special) (Regexp Functions, Regexp Functions): Index subject of sections. doc/lispref/processes.texi (Subprocess Creation, Process Information): Index subject of sections. doc/lispref/positions.texi (Screen Lines): Index subject of sections. doc/lispref/nonascii.texi (Scanning Charsets, Specifying Coding Systems): Index subject of sections. doc/lispref/minibuf.texi (Text from Minibuffer, Object from Minibuffer) (Multiple Queries, Minibuffer Contents): Index subject of sections. doc/lispref/markers.texi (Predicates on Markers, Creating Markers) (Information from Markers, Moving Markers): Index subject of sections. doc/lispref/macros.texi (Defining Macros, Problems with Macros): Index subject of sections. doc/lispref/loading.texi (Loading Non-ASCII, Where Defined): Index subject of sections. doc/lispref/lists.texi (List-related Predicates, List Variables, Setcar) (Setcdr, Plist Access): Index subject of sections. doc/lispref/keymaps.texi (Controlling Active Maps, Scanning Keymaps) (Modifying Menus): Index subject of sections. doc/lispref/help.texi (Accessing Documentation, Help Functions): Index subject of sections. doc/lispref/hash.texi (Hash Access): Index subject of sections. doc/lispref/functions.texi (Core Advising Primitives) (Advising Named Functions, Porting old advices): Index subject of sections. doc/lispref/frames.texi (Creating Frames, Initial Parameters) (Position Parameters, Buffer Parameters, Minibuffers and Frames) (Pop-Up Menus, Drag and Drop): Index subject of sections. doc/lispref/files.texi (Visiting Functions, Kinds of Files) (Unique File Names): Index subject of sections. doc/lispref/display.texi (Refresh Screen, Echo Area Customization) (Warning Variables, Warning Options, Delayed Warnings) (Temporary Displays, Managing Overlays, Overlay Properties) (Finding Overlays, Size of Displayed Text, Defining Faces) (Attribute Functions, Displaying Faces, Face Remapping) (Basic Faces, Font Lookup, Fontsets, Replacing Specs) (Defining Images, Showing Images): Index subject of sections. doc/lispref/debugging.texi (Debugging, Explicit Debug) (Invoking the Debugger, Excess Open, Excess Close): Index subject of sections. doc/lispref/customize.texi (Defining New Types, Applying Customizations) (Custom Themes): Index subject of sections. doc/lispref/control.texi (Sequencing, Combining Conditions) (Processing of Errors, Cleanups): Index subject of sections. doc/lispref/compile.texi (Eval During Compile): Index subject of sections. doc/lispref/commands.texi (Using Interactive, Distinguish Interactive) (Command Loop Info, Classifying Events, Event Mod) (Invoking the Input Method): Index subject of sections. doc/lispref/buffers.texi (Buffer List, Buffer Gap): Index subject of sections. doc/lispref/backups.texi (Making Backups, Numbered Backups, Backup Names) (Reverting): Index subject of sections. doc/lispref/abbrevs.texi (Abbrev Tables, Defining Abbrevs, Abbrev Files) (Abbrev Expansion, Standard Abbrev Tables, Abbrev Properties) (Abbrev Table Properties): Index subject of sections. doc/lispref/os.texi (Time of Day, Time Conversion, Time Parsing) (Time Calculations, Idle Timers): Index subject of sections.
* More doc updates.Chong Yidong2014-01-061-25/+38
| | | | | | | | | | | | | | | | | | | | | | | | | | | * backups.texi (Making Backups): Document backup-buffer change. * commands.texi (Defining Commands): Document the interactive-form property more carefully. Document interactive-only. * compile.texi (Compiler Errors): Copyedits. Note that the details for byte-compile-warnings are in its docstring. * customize.texi (Variable Definitions): Likewise. * files.texi (Visiting Files): Copyedits. (Testing Accessibility): Mention ACLs. Move file-modes here from File Attributes. (Truenames): Move file-equal-p here from Kinds of Files. (File Attributes): Move file-newer-than-file-p here from Testing Accessibility. (Extended Attributes): New node. Add file-extended-attributes. (Changing Files): Document set-file-extended-attributes. * minibuf.texi (Minibuffer Contents): Remove obsolete function minibuffer-completion-contents. * variables.texi (Defining Variables): Note that defvar acts always on the dynamic value.
* Lisp manaual improvements re docstringsChong Yidong2014-01-031-46/+36
| | | | | | | | | | | * doc/lispref/compile.texi (Docs and Compilation): Copyedits. * doc/lispref/help.texi (Documentation, Accessing Documentation): Copyedits. (Documentation Basics): Rewrite, avoiding a repeat discussion of docstring conventions. * doc/lispref/tips.texi (Documentation Tips): Move discussion of emacs-lisp-docstring-fill-column here from Documentation Basics.
* Update copyright year to 2014 by running admin/update-copyright.Paul Eggert2014-01-011-1/+1
|
* Documentation fix for 'ls' and hard links.Paul Eggert2013-06-101-6/+6
| | | | | | | | | * compile.texi (Compilation Functions): * files.texi (File Attributes, Changing Files): Use current format for GNU 'ls' output. (File Attributes): Fix problem introduced in previous change: the link count is the number of hard links, not the number of hard links + 1.
* Minor improvements in ELisp manual.Eli Zaretskii2013-03-241-2/+4
| | | | | doc/lispref/compile.texi (Byte-Code Objects): Add index entry. (Disassembly): Add cross-references.
* Update copyright notices for 2013.Paul Eggert2013-01-011-1/+1
|
* Fix minor whitespace issues after "." in manual.Paul Eggert2012-12-051-3/+2
| | | | | | | | | | | | Be more systematic about using "@." (not ".") at end of sentence that ends in a capital letter, and about appending "@:" after non-ends of sentences that end in a lower case letter followed by "." followed by whitespace. Omit unnecessary use of "@:" and "@.". Similarly for "?" and "!". Be more consistent about putting a comma after "i.e." and "e.g."; this is the typical American style and it's easier to code in Texinfo. Fixes: debbugs:12973
* Nuke hand-written node pointers in doc/lisprefGlenn Morris2012-05-261-2/+1
| | | | Let makeinfo figure them out, as is recommended.
* Merge from emacs-24; up to 2012-04-24T08:35:02Z!lekktu@gmail.comGlenn Morris2012-05-261-2/+2
|\
| * Some minor fixes of Elisp manual.Martin Rudalics2012-05-151-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * commands.texi (Recursive Editing): recursive-edit is a command. * compile.texi (Docs and Compilation): byte-compile-dynamic-docstrings is an option. * debugging.texi (Invoking the Debugger): debug is a command. * display.texi (Progress): progress-reporter-update and progress-reporter-force-update have VALUE argument optional. (Animated Images): Use non-@code{nil} instead of non-nil. * files.texi (Format Conversion Round-Trip): Use non-@code{nil} instead of non-nil. * frames.texi (Creating Frames): make-frame is a command. (Input Focus): select-frame is a command. (Pointer Shape): void-text-area-pointer is an option. * help.texi (Describing Characters): read-kbd-macro is a command. (Help Functions): describe-prefix-bindings is a command. * markers.texi (Creating Markers): Both arguments of copy-marker are optional. * minibuf.texi (Reading File Names): Use @kbd instead of @code. * modes.texi (Mode Line Variables): mode-line-remote and mode-line-client are not options. (Imenu): imenu-add-to-menubar is a command. (SMIE Indentation Helpers): Use non-@code{nil} instead of non-nil. * os.texi (Sound Output): play-sound-file is a command. * package.texi (Package Archives): Use @key{RET} instead of @kbd{RET}. * processes.texi (Signals to Processes): Use @key{RET} instead of @code{RET}. (Signals to Processes): signal-process is a command. * text.texi (Clickable Text): Use @key{RET} instead of @kbd{RET}. (Base 64): base64-encode-string is not a command while base64-decode-region is. * windows.texi (Switching Buffers): pop-to-buffer is a command.
* | Merge from emacs-24; up to 2012-04-21T14:12:27Z!sdl.web@gmail.comGlenn Morris2012-05-081-71/+50
|\ \ | |/
| * * doc/lispref/compile.texi (Disassembly): Condense the examples.Glenn Morris2012-05-041-72/+51
| |
* | Merge changes from emacs-24 branchChong Yidong2012-04-271-1/+1
|\ \ | |/
| * Use Texinfo recommended convention for quotes+punctuation.Glenn Morris2012-04-251-1/+1
| |
* | Remove unnecessary @setfilename commands from many doc/lispref/*.texiGlenn Morris2012-04-131-2/+1
|/
* In doc/lispref, use @file for buffers, per the Texinfo manual.Glenn Morris2012-04-101-4/+4
| | | | It renders the same as @samp, so there is no visible change in most cases.
* * lispref/compile.texi (Compiler Errors): Add missing space in buffer name.Glenn Morris2012-04-101-1/+1
|
* Update Debugging chapter of Lisp manual.Chong Yidong2012-02-111-7/+16
| | | | | | | | | | | | * doc/emacs/debugging.texi (Debugging): Copyedits. Describe testcover, ERT. (Error Debugging): Note that debug-ignored-errors overrides list values of debug-on-error too. Add xref to Signaling Errors. Note that debug-on-signal is not customizable. Mention condition-case-unless-debug. (Compilation Errors): Node deleted. * doc/emacs/compile.texi (Compiler Errors): Move a paragraph here from deleted node Compilation Errors.
* Update Compilation and Advice chapters in Lisp manual.Chong Yidong2012-02-101-109/+72
| | | | | | | | | | | | | | | | | | | | * doc/lispref/advice.texi (Defining Advice): Clarify ad-unadvise. (Activation of Advice): Specifying the ACTIVATE flag in defadvice is not abnormal. (Advising Primitives): Node deleted; ad-define-subr-args has been removed. * doc/lispref/compile.texi (Speed of Byte-Code): Use float-time in example. (Compilation Functions): Note that the log uses Compilation mode. Don't discuss the contents of byte-code function object here. (Compilation Functions): De-document internal function byte-code. (Docs and Compilation): Minor clarifications. * doc/lispref/objects.texi (Byte-Code Type): Add xref to Byte-Code Function Objects. * lisp/emacs-lisp/advice.el: Update commentary to reflect deletion of ad-define-subr-args
* Add 2012 to FSF copyright years for Emacs filesGlenn Morris2012-01-051-1/+1
|
* Fix typos.Juanma Barranquero2011-11-201-1/+1
|
* Merge from emacs-23; up to 2010-06-12T11:17:12Z!eliz@gnu.org.Glenn Morris2011-05-291-1/+1
|\
| * Tweaks to lisp manual to remove over/underflows in printed version.Chong Yidong2011-05-291-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * help.texi (Accessing Documentation): * display.texi (Pixel Specification): * processes.texi (Serial Ports, Serial Ports): * nonascii.texi (Character Properties, Default Coding Systems): * text.texi (Changing Properties, Special Properties): * windows.texi (Window Start and End): * modes.texi (SMIE Indentation Example, SMIE Tricks): * keymaps.texi (Searching Keymaps, Tool Bar): * minibuf.texi (Basic Completion): * compile.texi (Eval During Compile): * strings.texi (Formatting Strings): Tweaks to avoid overflowing 7x9 paper in printed manual. * lists.texi (Sets And Lists): Fix misplaced text.
* | Convert consecutive FSF copyright years to ranges.Glenn Morris2011-01-241-2/+1
| |
* | Nuke arch-tags.Glenn Morris2011-01-151-4/+0
| |
* | Merge from emacs-23Stefan Monnier2011-01-141-1/+1
|\ \ | |/
| * Add 2011 to FSF/AIST copyright years.Glenn Morris2011-01-021-1/+1
| |
* | Make obsolete --unibyte argument do nothing (Bug#6886).Chong Yidong2010-08-221-6/+0
|/ | | | | | | | | | | | * src/emacs.c (main): Remove --unibyte handling (Bug#6886). * lisp/startup.el (command-line-1): Issue warning for ignored arguments --unibyte, etc (Bug#6886). * doc/lispref/nonascii.texi (Text Representations): * doc/lispref/loading.texi (Loading Non-ASCII): * doc/lispref/compile.texi (Byte Compilation): Don't mention obsolete --unibyte command-line argument.
* Untabify doc/lispref/*.texi.Glenn Morris2010-06-221-2/+2
| | | | | | | | | | * abbrevs.texi, commands.texi, compile.texi, debugging.texi: * display.texi, edebug.texi, elisp.texi, eval.texi, files.texi: * frames.texi, functions.texi, internals.texi, keymaps.texi: * loading.texi, minibuf.texi, numbers.texi, os.texi, processes.texi: * searching.texi, sequences.texi, strings.texi, syntax.texi: * text.texi, tips.texi, vol1.texi, vol2.texi, windows.texi: Untabify Texinfo files.