summaryrefslogtreecommitdiff
path: root/doc/lispref
Commit message (Collapse)AuthorAgeFilesLines
* Capitalise a couple of node namesLars Ingebrigtsen2019-08-042-7/+7
| | | | | | * doc/lispref/functions.texi (Advising Functions): Capitalise node names (bug#17717). (Advice Combinators, Porting Old Advice): Capitalise.
* Core Advising Primitives `interactive' clarificationLars Ingebrigtsen2019-08-041-1/+2
| | | | | * doc/lispref/functions.texi (Core Advising Primitives): Clarify when the interactive spec is a function (bug#17871).
* * doc/lispref/display.texi (SVG Images): Remove menu.Glenn Morris2019-08-031-3/+0
| | | | Not needed since SVG Path Commands was changed to not be a node.
* Mention `themed-value' in Variable Definitions nodeLars Ingebrigtsen2019-08-031-2/+4
| | | | | * doc/lispref/customize.texi (Variable Definitions): Mention `themed-value' (bug#17996).
* Don't refer to non-existent functions in mode line examplesLars Ingebrigtsen2019-08-031-1/+1
| | | | | | | * doc/lispintro/emacs-lisp-intro.texi (Mode Line): Ditto. * doc/lispref/modes.texi (Mode Line Top): In the :eval example, use a function that exists to avoid confusion (bug#19224).
* Improve documentation of debugging Lisp syntax errorEli Zaretskii2019-08-031-19/+26
| | | | | | | * doc/lispref/debugging.texi (Syntax Errors, Excess Open) (Excess Close): Name the commands invoked by the key sequences. Add cross-references to appropriate sections of the Emacs manual. (Bug#21385)
* Fix some minor inconsistencies in the Package examplesLars Ingebrigtsen2019-08-022-2/+2
| | | | | | | | * doc/lispref/package.texi (Simple Packages): Use one of the approved keywords (bug#19490). * doc/lispref/tips.texi (Library Headers): Use URL instead of Homepage to make things consistent with "Simple Packages".
* * doc/lispref/display.texi (SVG Images): Add menu for subsection.Glenn Morris2019-08-011-0/+3
| | | | Again. This is needed for makeinfo-4.13.
* Fix the ELisp manual part of a recent commitEli Zaretskii2019-08-011-2/+7
| | | | | * doc/lispref/display.texi (SVG Images): Fix markup of "SVG Path Commands". It is no longer a @node, but a @subheading.
* Add example for removing scroll bars/fringes from mini windows (Bug#8868)Martin Rudalics2019-08-011-1/+20
| | | | | | | * doc/lispref/display.texi (Fringe Size/Pos): Mention example for how to permenantly remove fringes from minibuffer windows. (Scroll Bars): Add example for how to permanently remove scroll bars and fringes from minibuffer windows.
* Revert "Revert "Add support for paths to svg.el""Lars Ingebrigtsen2019-07-311-0/+237
| | | | | | | This reverts commit 0a2461be9edb218bf9ca56156d8966a2421f13a7. Copyright paperwork is now in place, so the patch mistakenly applied can now be re-applied.
* Clarify (lognot bignum)Paul Eggert2019-07-311-1/+2
| | | | | * doc/lispref/numbers.texi (Bitwise Operations): Say that (= (lognot n) (- -1 n)).
* Remove no-longer relevant xrefNoam Postavsky2019-07-311-2/+1
| | | | | | * doc/lispref/positions.texi (List Motion): Remove xref, the text it references was removed in 2018-02-15 "Document open-paren-in-column-0-is-defun-start being of less importance".
* Merge from origin/emacs-26Glenn Morris2019-07-303-36/+10
|\ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 8fbe462 (origin/emacs-26) ; * doc/lispref/positions.texi (List Motion... 1d9efc0 Add index for "\( in strings" (Bug#25195) 304e96f Fix doc-string of 'fit-window-to-buffer' (Bug#36848) d4c4987 Update view-mode docstring d6ca1fc ; * lisp/term.el: Add missing / to esc seq commentary. b3e2073 Fix subproc listening when setting filter to non-t (Bug#36591) f671950 * etc/NEWS.25: Belatedly announce rcirc-reconnect-delay. 7f42277 Mention term.el's \032 dir tracking in commentary (Bug#19524) 16a529e Remove upload functionality of package-x from the elisp manual 78e6c2a * etc/AUTHORS: Update. 086a56e Clarify Gravatar docs 0592467 * doc/lispref/display.texi (Defining Faces): Say a face can't... # Conflicts: # doc/emacs/programs.texi # etc/AUTHORS # lisp/term.el
| * ; * doc/lispref/positions.texi (List Motion): Fix last change.Eli Zaretskii2019-07-301-3/+3
| |
| * Add index for "\( in strings" (Bug#25195)Noam Postavsky2019-07-301-1/+5
| | | | | | | | | | | | | | * doc/emacs/programs.texi (Left Margin Paren): Add index for "\( in strings". * doc/lispref/positions.texi (List Motion): Add index, and cross reference.
| * Remove upload functionality of package-x from the elisp manualStefan Kangas2019-07-251-35/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | Suggested by Stefan Monnier. Ref: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=19537#8 * doc/lispref/package.texi (Package Archives): Don't document package-x upload functions in the elisp manual, since they are not very commonly used. (Bug#19537) * lisp/emacs-lisp/package-x.el (package-archive-upload-base) (package-upload-buffer, package-upload-file): Add to the doc strings any details removed from the elisp manual that would otherwise be missing.
| * * doc/lispref/display.texi (Defining Faces): Say a face can't be undefined.Alan Mackenzie2019-07-221-0/+5
| |
* | Extend button.el to take callback dataLars Ingebrigtsen2019-07-301-4/+10
| | | | | | | | | | | | | | | | | | * doc/lispref/display.texi (Button Buffer Commands) (Button Buffer Commands): Document this. * lisp/button.el (backward-button, forward-button): Accept a NO-ERROR parameter. (button-activate): Make it possible to have specific data in the callback action.
* | Add further documentation about semicolon useLars Ingebrigtsen2019-07-291-3/+6
| | | | | | | | | | * doc/lispref/tips.texi (Comment Tips): Document the sub-heading convention (bug#23060) as explained by Stefan on StackExchange.
* | Add an ISO 8601 parsing libraryLars Ingebrigtsen2019-07-291-0/+13
| | | | | | | | | | | | | | | | * doc/lispref/os.texi (Time Parsing): Document it. * lisp/calendar/iso8601.el: New file. * test/lisp/calendar/iso8601-tests.el: Test ISO8601 parsing functions.
* | Add support for dealing with decoded time structuresLars Ingebrigtsen2019-07-291-0/+64
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/os.texi (Time Conversion): Document the new functions that work on decoded time. (Time Calculations): Document new date/time functions. * lisp/simple.el (decoded-time-second, decoded-time-minute) (decoded-time-hour, decoded-time-day, decoded-time-month) (decoded-time-year, decoded-time-weekday, decoded-time-dst) (decoded-time-zone): New accessor functions for decoded time values. * lisp/calendar/time-date.el (date-days-in-month) (date-ordinal-to-time): New functions. (decoded-time--alter-month, decoded-time--alter-day) (decoded-time--alter-second, make-decoded-time): New functions added to manipulate decoded time structures. * src/timefns.c (Fdecode_time): Mention the new accessors. * test/lisp/calendar/time-date-tests.el: New file to test the decoded time functions and the other new functions.
* | Allow serial-term to take an optional argument for line-modeLars Ingebrigtsen2019-07-271-1/+3
| | | | | | | | | | | | | | * lisp/term.el (serial-term): Allow taking an optional argument to avoid term-raw-mode (bug#24922). * doc/lispref/processes.texi (Serial Ports): Document it.
* | Allow directory-files-recursively to follow symlinksLars Ingebrigtsen2019-07-271-1/+4
| | | | | | | | | | | | | | * doc/lispref/files.texi (Contents of Directories): Document it. * lisp/files.el (directory-files-recursively): Allow following symlinks.
* | Add new macro `ignore-error'Lars Ingebrigtsen2019-07-261-0/+12
| | | | | | | | | | | | | | | | | | * doc/lispref/control.texi (Handling Errors): Document `ignore-error'. * lisp/subr.el (ignore-error): New macro. * lisp/progmodes/elisp-mode.el (elisp-completion-at-point): Provide completion for `ignore-error'.
* | Clarify in the manual when to use function-key-mapLars Ingebrigtsen2019-07-251-2/+3
| | | | | | | | | | | | | | | | | | | | * doc/misc/efaq.texi (No Escape key): * doc/emacs/msdos-xtra.texi (MS-DOS Keyboard): Change back to function-key-map from local-function-key-map, because these bindings apply to all terminals. * doc/lispref/keymaps.texi (Translation Keymaps): Clarify in what circumstances you may still want to use function-key-map.
* | Do not treat ~nosuchuser as an absolute file namePaul Eggert2019-07-241-1/+9
| | | | | | | | | | | | | | | | | | | | Derived from Ken Brown’s patch (Bug#36502#97). * doc/lispref/files.texi (Relative File Names): * etc/NEWS: Document this. * src/fileio.c (user_homedir): New function. (Fexpand_file_name, file_name_absolute_p): Use it. (search_embedded_absfilename): Simplify via file_name_absolute_p. * test/src/fileio-tests.el (fileio-tests--no-such-user): New test.
* | Improve pdumper doc; say unexec is deprecatedPaul Eggert2019-07-231-14/+20
| | | | | | | | | | | | | | | | | | | | | | Say that pdumping cannot redump unless -batch is used. Say that the traditional unexec dumping method is by default not available, and is deprecated. Don't call dump files "portable", as dump files are not any more portable than the Emacs executables themselves. Just call them "dump files". Similar, prefer "portable dumper" (since the dumper code is portable) to "portable dumping" (since the dump file is not). Be more systematic about calling them "dump files" instead of "dumped images" or whatnot.
* | Support "%x" etc. formats on more floatsPaul Eggert2019-07-231-6/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/strings.texi (Formatting Strings): Document this. * src/editfns.c (styled_format): Support %o, %x, and %X on finite floats less than zero or greater than UINTMAX_MAX. * test/src/editfns-tests.el (format-%x-large-float) (read-large-integer, format-%o-negative-float): Adjust tests to match extended behavior. Rename the latter test from format-%o-invalid-float, since the float is no longer invalid. * test/src/editfns-tests.el (format-%x-large-float) (read-large-integer): Test this.
* | Avoid overexposing fixnums for hash codesPaul Eggert2019-07-221-8/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Following a suggestion by Stefan Monnier in: https://lists.gnu.org/r/emacs-devel/2019-07/msg00530.html * doc/lispref/hash.texi (Creating Hash, Defining Hash): * src/fns.c (Fsxhash_eq, Fsxhash_eql, Fsxhash_equal, Fmake_hash_table): Don’t insist that hash codes be fixnums, reverting the recent doc changes to the contrary. * src/bytecode.c (exec_byte_code): Special-case only the eq case, as the others aren’t worth tuning now that we treat bignum hashes like fixnums. * src/fns.c (hashfn_user_defined): If the hash code is a bignum, reduce its hash down to a fixnum.
* | Handle persistence of windows' scroll bar and fringes settings (Bug#36193)Martin Rudalics2019-07-221-12/+28
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/display.texi (Fringe Size/Pos): Document new argument PERSISTENT of 'set-window-fringes'. (Scroll Bars): Document new argument PERSISTENT of 'set-window-scroll-bars'. Mention that HORIZONTAL-TYPE must be 'bottom' to show a horizontal scroll bar on mini windows. * lisp/window.el (window-min-pixel-height): For mini windows the minimum height is one line. (window--min-size-1): Use value returned by 'window-min-pixel-height' when dealing with mini windows. (window--resize-mini-window): Try to handle horizontal scroll bars and size restrictions more accurately. (window--state-put-2): Handle persistence of scroll bar settings. * src/frame.c (make_frame): Allow horizontal scroll bars in mini windows. (adjust_frame_size): Drop PIXELWISE argument in 'resize_frame_windows' calls. * src/window.c (set_window_buffer): Don't override WINDOW's scroll bar and fringe settings when marked as persistent. (resize_frame_windows): Drop fourth argument PIXELWISE - SIZE is always specified in terms of pixels. Try to handle height of mini windows more accurately. (grow_mini_window, shrink_mini_window): Use body height of mini window when calculating expected height change. Take horizontal scroll bars into account. (struct saved_window): Two new members to handle persistence of window fringes and scroll bars. (Fset_window_configuration, save_window_save): Handle persistence of fringes and scroll bars. (set_window_fringes, set_window_scroll_bars): New arguments PERSISTENT. Make dimension checks more accurate. (Fset_window_fringes): New argument PERSISTENT. (Fwindow_fringes, Fwindow_scroll_bars): Add PERSISTENT to return values. (Fset_window_scroll_bars): New argument PERSISTENT. In doc-string mention that 'bottom' must be specified to get a horizontal scroll bar in mini windows. (compare_window_configurations): Add checks for persistence of fringes and scroll bars. * src/window.h (struct window): New boolean slots 'fringes_persistent' and 'scroll_bars_persistent'. (WINDOW_HAS_HORIZONTAL_SCROLL_BAR): Allow horizontal scroll bars for mini windows. (resize_frame_windows): Remove fourth argument of 'resize_frame_windows' in external declaration. * src/xdisp.c (resize_mini_window): Use box text height to tell whether mini window height changed. (set_horizontal_scroll_bar): Set mini window's horizontal scroll bar when its type is specified as 'bottom'. * etc/NEWS: Mention new options for 'set-window-fringes' and 'set-window-scroll-bars'.
* | Improve doc for hash tablesPaul Eggert2019-07-211-11/+16
| | | | | | | | | | | | | | | | | | | | | | * doc/lispref/hash.texi (Creating Hash, Defining Hash): * src/fns.c (Fsxhash_eq, Fsxhash_eql, Fsxhash_equal): Say that hashes are fixnums. (Fmake_hash_table): Say that that an integer rehash-size should be a fixnum. * doc/lispref/hash.texi (Defining Hash): Say that hash and comparison functions should be consistent and pure, and should return quickly.
* | Merge from emacs-26Noam Postavsky2019-07-201-1/+1
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | 150bdfe43a Handle completely undecoded input in term (Bug#29918) 021f32cca1 * doc/misc/forms.texi (Control File Format): Fix a doc error. 76538d09b7 Fix typo in package-alist docstring b2fde4b5e8 * doc/lispref/text.texi (Mode-Specific Indent): Fix a typo... 7e62778548 ; Another minor change in 'bidi-display-reordering's doc s... 4455ddbe56 Improve doc string of 'bidi-display-reordering' 34ee26dd93 Add warning to bidi-display-reordering doc string # Conflicts: # lisp/term.el # test/lisp/term-tests.el
| * * doc/lispref/text.texi (Mode-Specific Indent): Fix a typo (bug#36646).Markus Triska2019-07-141-1/+1
| |
* | Fix last change to format-specBasil L. Contovounesios2019-07-201-3/+3
| | | | | | | | | | | | | | * doc/lispref/text.texi (Interpolated Strings): Use @result and fix typos. * lisp/format-spec.el: Avoid loading subr-x at runtime. (format-spec--parse-modifiers): Optimize slightly.
* | Allow counter-clockwise rotations in image-rotateBasil L. Contovounesios2019-07-201-1/+2
| | | | | | | | | | | | | | | | * lisp/image.el (image-rotate): Extend with an optional argument specifying the rotation in degrees (bug#35421). * doc/lispref/display.texi (Showing Images): * etc/NEWS: Document the change. * test/lisp/image-tests.el (image-rotate): New test.
* | Have 'display-buffer-reuse-window' prefer window on selected frame (Bug#36680)Martin Rudalics2019-07-191-1/+2
| | | | | | | | | | | | | | | | * lisp/window.el (display-buffer-reuse-window): Preferably reuse window on selected frame (Bug#36680). * doc/lispref/windows.texi (Buffer Display Action Functions): Say that 'display-buffer-reuse-window' prefers window on the selected frame.
* | Revert "Add support for paths to svg.el"Lars Ingebrigtsen2019-07-161-237/+0
| | | | | | | | | | | | This reverts commit d6bc55ae2dc98c83e58a28e380ce4bcf2ed00bb3. Paperwork not ready for Felix Klee; will reapply once that's in place.
* | Revert "* doc/lispref/display.texi (SVG Images): Add menu for subsection."Lars Ingebrigtsen2019-07-161-3/+0
| | | | | | | | | | | | This reverts commit e5cd597c7736b587f80c16fde1c53f904d921310. Paperwork nod ready for the SVG Path patch.
* | * doc/lispref/display.texi (SVG Images): Add menu for subsection.Glenn Morris2019-07-151-0/+3
| |
* | Add support for paths to svg.elFelix E. Klee2019-07-151-0/+237
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/display.texi (SVG Images): Document svg-path, svg-clip-path and svg-node (bug#32359). * doc/lispref/display.texi (SVG Path Commands): New node. * lisp/svg.el (svg--plist-delete, svg--path-command-symbol) (svg--elliptical-arc-coordinates, svg--elliptical-arc-command) (svg--moveto-command, svg--closepath-command) (svg--lineto-command, svg--horizontal-lineto-command) (svg--vertical-lineto-command, svg--curveto-command) (svg--smooth-curveto-command) (svg--quadratic-bezier-curveto-command) (svg--smooth-quadratic-bezier-curveto-command) (svg--eval-path-command, svg-path, svg-clip-path, svg-node): New functions.
* | Make directory-files-recursively take a PREDICATE parameterLars Ingebrigtsen2019-07-151-1/+8
| | | | | | | | | | | | | | * lisp/files.el (directory-files-recursively): Take an optional PREDICATE parameter (bug#28567). * doc/lispref/files.texi (Contents of Directories): Document it.
* | Add some indices for regexp character classesLars Ingebrigtsen2019-07-131-0/+4
| | | | | | | | | | * doc/lispref/searching.texi (Char Classes): Add some concept index entries for a handful of character classes (bug#32430).
* | Document format-spec and expand the modifiers it supportsLars Ingebrigtsen2019-07-131-0/+67
| | | | | | | | | | | | | | * doc/lispref/text.texi (Interpolated Strings): New section. * lisp/format-spec.el (format-spec--parse-modifiers) (format-spec--pad): New functions. (format-spec): Support more format modifiers (bug#32931).
* | Add a really simple nadvice exampleLars Ingebrigtsen2019-07-091-2/+20
| | | | | | | | | | * doc/lispref/functions.texi (Advising Functions): Add a really trivial and simple example (bug#35250).
* | Make the manual say what undo-auto-amalgamate doesLars Ingebrigtsen2019-07-091-0/+4
| | | | | | | | | | * doc/lispref/text.texi (Undo): Say what undo-auto-amalgamate does in addition to describing what amalgamation is (bug#35344).
* | Remove mention of :group in define-minor-mode infoLars Ingebrigtsen2019-07-081-7/+4
| | | | | | | | | | | | | | * doc/lispref/modes.texi (Defining Minor Modes): The :group stuff in the example and documentation isn't correct since this is not a global mode and `hunger-mode' therefore isn't customizable (bug#36501).
* | Avoid makeinfo error "@code expected braces"Glenn Morris2019-07-071-1/+1
| | | | | | | | * doc/lispref/searching.texi (Rx Constructs): Fix for makeinfo 4.13.
* | Remove printmax_t etc.Paul Eggert2019-07-071-5/+2
| | | | | | | | | | | | | | | | | | | | | | | | printmax_t etc. were needed only for platforms that lacked support for printing intmax_t. These platforms are now so obsolete that they are no longer practical porting targets. * src/image.c (gs_load): Fix unlikely buffer overrun discovered while making these changes. It was introduced in 2011-07-17T00:34:43!eggert@cs.ucla.edu. * src/lisp.h (printmax_t, uprintmax_t, pMd, pMu, pMx): Remove. All uses replaced by their standard counterparts intmax_t, uintmax_t, PRIdMAX, PRIuMAX, PRIxMAX.
* | Describe the rx notation in the elisp manual (bug#36496)Mattias Engdegård2019-07-073-0/+601
| | | | | | | | | | | | | | | | | | | | | | The additions are excluded from the print version to avoid making it thicker. * doc/lispref/elisp.texi (Top): New menu entry. * doc/lispref/searching.texi (Regular Expressions): New menu entry. (Regexp Example): Add rx form of the example. (Rx Notation, Rx Constructs, Rx Functions): New nodes. * doc/lispref/control.texi (pcase Macro): Describe the rx pattern.
View Lorry Controller Status