summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* Fix process filter documentation (Bug#13400)Noam Postavsky2019-08-191-16/+13
| | | | | | | | | * doc/lispref/processes.texi (Asynchronous Processes): Note that input may read when sending data as well. (Output from Processes): Note that functions which send data may also trigger reading from processes. (Input to Processes, Filter Functions): Note that filter functions may be called recursively.
* Fix markup in dired-x.texiEli Zaretskii2019-08-161-182/+161
| | | | | | | * doc/misc/dired-x.texi (Omitting Variables) (Local Variables, Shell Command Guessing) (Advanced Cleaning Variables, Special Marking Function): Fix markup and indexing. (Bug#14212)
* Improve documentation of features that use the fringesEli Zaretskii2019-08-101-1/+3
| | | | | | | * doc/emacs/display.texi (Fringes): Add cross-reference to where indicate-empty-lines is described. (Useless Whitespace): Add an @anchor for a more accurate cross-reference in "Fringes".
* Fix nnmail-expiry-wait docs and custom :typesBasil L. Contovounesios2019-08-031-22/+28
| | | | | | | | | | * doc/misc/gnus.texi (Group Parameters, Expiring Mail): * lisp/gnus/gnus-cus.el (gnus-group-parameters): Clarify descriptions of nnmail-expiry, nnmail-expiry-wait, and nnmail-expiry-wait-function. * lisp/gnus/nnmail.el (nnmail-expiry-wait) (nnmail-expiry-wait-function): Clarify docstrings and fix custom :types (bug#36850).
* 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) (cherry picked from commit faafd467a374c9398ee4668cdc173611d35693ed)
* ; * 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-302-1/+6
| | | | | | | * 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.
* Clarify Gravatar docsBasil L. Contovounesios2019-07-231-11/+15
| | | | | | | | | | | | For discussion, see the following thread: https://lists.gnu.org/archive/html/emacs-devel/2019-07/msg00528.html * doc/misc/gnus.texi (X-Face): Fix cross-reference. (Gravatars): * lisp/gnus/gnus-gravatar.el (gnus-gravatar-too-ugly): * lisp/image/gravatar.el (gravatar-cache-ttl, gravatar-rating) (gravatar-size): Clarify user option descriptions. (gravatar-retrieve, gravatar-retrieve-synchronously): Document return value.
* * doc/lispref/display.texi (Defining Faces): Say a face can't be undefined.Alan Mackenzie2019-07-221-0/+5
|
* * doc/misc/forms.texi (Control File Format): Fix a doc error.N. Jackson2019-07-201-1/+1
| | | | | | (Bug#36693) Copyright-paperwork-exempt: yes
* * doc/lispref/text.texi (Mode-Specific Indent): Fix a typo (bug#36646).Markus Triska2019-07-141-1/+1
|
* ; * doc/emacs/killing.texi (Secondary Selection): Fix last change.Eli Zaretskii2019-07-061-4/+3
|
* Minor copyedit of "Font Lock" in user manualEli Zaretskii2019-07-061-4/+4
| | | | | * doc/emacs/display.texi (Font Lock): Make the wording about "enabling Font Lock" crystal clear. (Bug#36529)
* Improve description of image descriptorsEli Zaretskii2019-07-061-1/+4
| | | | | * doc/lispref/display.texi (Image Descriptors): More accurate description of where image files are looked up. (Bug#36523)
* Improve documentation of secondary selectionsEli Zaretskii2019-07-061-6/+10
| | | | | | * doc/emacs/killing.texi (Secondary Selection): Improve wording. Mention that 'M-mouse-1' can be used to cancel secondary selections. (Bug#36365)
* Fix typo in windows.texiStefan Kangas2019-06-281-1/+1
| | | | * doc/lispref/windows.texi (Window History): Fix typo. (Bug#36412)
* Clarify & update (elisp) Writing Emacs PrimitivesBasil L. Contovounesios2019-06-261-29/+31
| | | | | | | * doc/lispref/internals.texi (Writing Emacs Primitives): Update some of the sample code listings, fixing argument lists and parentheses. Replace ... with @dots{}. Describe UNEVALLED special forms as taking a single argument. (bug#36392)
* Clarify a subtle issue in the Internals chapter of lisprefEli Zaretskii2019-06-261-4/+8
| | | | | | * doc/lispref/internals.texi (Writing Emacs Primitives): Clarify the issue with relocation of buffer or string text as side effect of Lisp evaluation. (Bug#36392)
* Rename 'make-symbolic-link' argument NEWNAME to LINKNAMEJuanma Barranquero2019-06-211-4/+4
| | | | | * src/fileio.c (Fmake_symbolic_link): Fix docstring. * doc/lispref/files.texi (Changing Files): Doc fix.
* Improve wording of documentation of click eventsEli Zaretskii2019-06-161-33/+37
| | | | | * doc/lispref/commands.texi (Click Events, Accessing Mouse): Improve and clarify wording. (Bug#36232)
* Backport: Fix typo in regexp-opt example codeMattias Engdegård2019-06-161-2/+2
| | | | | * doc/lispref/searching.texi (Regexp Functions): Fix typo in example code (Bug#34596).
* Fix description of 'display-buffer-in-previous-window' again (Bug#36161)Martin Rudalics2019-06-121-13/+37
| | | | | | | | | | | * lisp/window.el (display-buffer-in-previous-window): Make doc-string more explicit (Bug#36161). * doc/lispref/windows.texi (Buffer Display Action Functions): Make description of 'display-buffer-in-previous-window' more explicit. (Buffer Display Action Alists): Mention 'display-buffer-in-previous-window' in description of 'reusable-frames' entry.
* Consistently use @minus{} for negative argumentsEli Zaretskii2019-06-117-13/+14
| | | | | | | | | | | * doc/emacs/mark.texi (Marking Objects): * doc/misc/gnus.texi (Selecting a Group): * doc/emacs/programs.texi (Comment Commands): * doc/emacs/killing.texi (Deletion): * doc/emacs/display.texi (Recentering): * doc/lispref/display.texi (Face Attributes): * doc/lispref/searching.texi (String Search, Regexp Search): Make the markup of "-N" use @minus{} uniformly. (Bug#35885)
* Fix doc of 'display-buffer-in-previous-window' (Bug#36161)Martin Rudalics2019-06-111-0/+3
| | | | | | | * doc/lispref/windows.texi (Buffer Display Action Functions): * lisp/window.el (display-buffer-in-previous-window): Tell that 'display-buffer-in-previous-window' prefers non-selected windows (Bug#36161).
* More quotation fixes (Bug#35885)Eli Zaretskii2019-06-092-2/+2
| | | | | | * doc/emacs/text.texi (Quotation Marks): Fix a typo. * doc/emacs/modes.texi (Minor Modes): Fix another case of showing quotations.
* Minor copyedits in efaq-w32Eli Zaretskii2019-06-081-2/+4
| | | | | | * doc/misc/efaq-w32.texi (Grep, Recursive grep): More accurate description of using 'findstr' as a poor-man's replacement for 'grep'. Reported by 范凯 <m_pupil@163.com>
* Tiny improvement of documentation of major mode conventionsEli Zaretskii2019-06-081-1/+3
| | | | | | * doc/lispref/modes.texi (Major Mode Conventions): More accurate advice regarding customization of 'C-M-a' by major modes.
* Fix styling of Unicode codepoints in manualsEli Zaretskii2019-06-055-27/+29
| | | | | | | | | | * doc/lispref/nonascii.texi (Character Properties): * doc/lispref/display.texi (Glyphless Chars) (Bidirectional Display): * doc/emacs/search.texi (Lax Search): * doc/emacs/text.texi (Quotation Marks): * doc/emacs/basic.texi (Inserting Text): Canonicalize the style of "U+NNNN CHARACTER NAME". (Bug#35885)
* Fix a few uses of quotes in user manualEli Zaretskii2019-06-043-8/+8
| | | | | | | * doc/emacs/text.texi (Quotation Marks): * doc/emacs/display.texi (Text Display): * doc/emacs/basic.texi (Inserting Text): Fix some more quotes. (Bug#35885)
* More minor copyedits in the Emacs manualEli Zaretskii2019-06-034-17/+18
| | | | | | | | * doc/emacs/basic.texi (Arguments): * doc/emacs/display.texi (Recentering, Text Display): * doc/emacs/regs.texi (Text Registers, Rectangle Registers): * doc/emacs/mark.texi (Disabled Transient Mark): Fix inaccuracies and typos. (Bug#35885)
* Fix minor issues in the Emacs manualEli Zaretskii2019-06-032-5/+4
| | | | | | | * doc/emacs/search.texi (Regexp Replace, Regexps): * doc/emacs/kmacro.texi (Keyboard Macro Query) (Save Keyboard Macro): Fix inaccuracies and typos. (Bug#35885)
* Try to improve text on atomic windows in Elisp manualMartin Rudalics2019-06-031-34/+49
| | | | | | | | | * doc/lispref/windows.texi (Deleting Windows): Mention how 'delete-window' and 'delete-other-windows' handle atomic windows. Minor rewrite. (Quitting Windows): Mention how 'quit-restore-window' handles atomic windows and that it tries to avoid raising an error. (Atomic Windows): Tell how to dissolve atomic windows.
* Don't recommend insert-before-markers in process filtersNoam Postavsky2019-06-011-2/+7
| | | | | | | | See <https://lists.gnu.org/r/emacs-devel/2019-05/msg00062.html> and Bug#35334. * doc/lispref/processes.texi (Filter Functions): Go back to using plain insert in the example filter. Add note about updating window point.
* Improve documentation of 'safe-local-variable' propertyEli Zaretskii2019-06-011-0/+5
| | | | | | * doc/lispref/variables.texi (File Local Variables): Document how to define 'safe-local-variable' properties for built-in variables.
* ; * doc/lispref/nonascii.texi (Explicit Encoding): Fix typo.Noam Postavsky2019-05-261-1/+1
|
* Improve documentation of decoding into a unibyte bufferEli Zaretskii2019-05-251-2/+7
| | | | | | | | | * doc/lispref/nonascii.texi (Explicit Encoding): Document what happens when DESTINATION of decoding is a unibyte buffer. * src/coding.c (Fdecode_coding_region) (Fdecode_coding_string): Document what happens if DESTINATION is a unibyte buffer.
* Remove redundants "See" before @xref or @pxref (Bug#35793)Mauro Aranda2019-05-2512-21/+21
| | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/control.texi (Control Structures): * doc/lispref/modes.texi (Search-based Fontification): * doc/misc/cc-mode.texi (Filling and Line Breaking Commands) (Auto-newline Insertion, Other Special Indentations): * doc/misc/dbus.texi (Errors and Events): * doc/misc/dired-x.texi (Find File At Point): * doc/misc/eudc.texi (Display of Query Results, Inline Query Expansion): * doc/misc/gnus-faq.texi (FAQ 3-11): * doc/misc/gnus.texi (Group Parameters, Posting Styles) (Spam Package Introduction): * doc/misc/org.texi (LaTeX fragments, Previewing LaTeX fragments): * doc/misc/reftex.texi (Commands): Remove redundant "See" before cross references. * doc/lispref/functions.texi (Function Safety): Redundant "see" is in ignored text, but remove it anyway. * doc/lispref/positions.texi (Skipping Characters): Remove redundant "See" before cross references. Change @xref to @pxref, which is more suitable when at the end of a sentence. Most of the redundants "See" found by Noam Postavsky.
* Fix a typo in ELisp manualTom Levy2019-05-221-1/+1
| | | | | | | * doc/lispref/sequences.texi (Sequence Functions): Fix a typo. (Bug#35817) Copyright-paperwork-exempt: yes
* Add option to disable help completion autoloading (Bug#28607)Noam Postavsky2019-05-212-1/+28
| | | | | | | | | * lisp/help-fns.el (help-enable-completion-auto-load): New option. (help--symbol-completion-table): Consult it. * doc/emacs/building.texi (Lisp Libraries): Document it. * etc/NEWS: Announce it. * doc/lispref/loading.texi (Autoload by Prefix): New section. (Autoload): Reference it.
* Fix typo in ELisp manualMauro Aranda2019-05-201-1/+1
| | | | | * doc/lispref/variables.texi (Directory Local Variables): Fix typo in dir-locals-set-class-variables description. (Bug#35799)
* Fix Hideshow key binding typo in Emacs manualBasil L. Contovounesios2019-05-191-1/+4
| | | | | * doc/emacs/programs.texi (Hideshow): Add missing function and key index entries. Fix hs-toggle-hiding binding typo. (bug#35798)
* Let dir locals for more specific modes override those from lessNeil Roberts2019-05-121-0/+22
| | | | | | | | | | | | | | | | | | | | | | | | The list of dir local variables to apply is now sorted by the number of parent modes of the mode used as the key in the association list. That way when the variables are applied in order the variables from more specific modes will override those from less specific modes. If there are directory entries in the list then they are sorted in order of name length. The list of modes for that dir is then recursively sorted with the same mechanism. That way variables tied to a particular subdirectory override those in in a parent directory. Previously the behaviour didn’t seem to be well defined anyway and was dependent on the order they appeared in the file. However this order was changed in version 26.1 and it probably also depended on the number of dir-local files that are merged. Bug#33400 * lisp/files.el (dir-locals-get-sort-score, dir-locals-sort-variables) (dir-locals-read-from-dir): Sort the dir locals so that more precise modes and directory-specific entries have override lesser ones. * doc/emacs/custom.texi (Directory Variables): Document the priority.
* Improve documentation of Hexl modeEli Zaretskii2019-05-111-3/+12
| | | | | | * doc/emacs/misc.texi (Editing Binary Files): Clarify "insertion". Improve wording. Add a few Hexl commands. (Bug#35580)
* Fix description of (move-to-column <n> t) when column <n> is inside a tabAlan Mackenzie2019-05-091-3/+5
| | | | | | | | This fixes bug #35647. State that when indent-tabs-mode is non-nil, spaces are inserted before the tab rather than the tab being replaced by spaces. * doc/lispref/text.texi (columns) * src/indent.c (move-to-column): Make the above documentation amendment.
* Clarify handling of long options (Bug#24949)Noam Postavsky2019-05-041-1/+1
| | | | | * doc/emacs/cmdargs.texi (Emacs Invocation): Note that space can be used instead of "=" only if an option requires an argument.
* Improve documentation of the daemon and emacsclientEli Zaretskii2019-05-042-7/+12
| | | | | | | * doc/emacs/misc.texi (emacsclient Options): * doc/emacs/cmdargs.texi (Initial Options): Document that using --daemon=NAME will need to specify the same NAME when invoking 'emacscilent'. (Bug#35547)
* Update process filter example (Bug#35044)Noam Postavsky2019-04-301-1/+1
| | | | | | * doc/lispref/processes.texi (Filter Functions): Use insert-before-markers in the "ordinary" filter example, like internal-default-process-filter does.
* Recommend using font-lock-face over face (Bug#35044)Noam Postavsky2019-04-281-1/+6
| | | | | * doc/lispref/modes.texi (Precalculated Fontification): Explain advantages of using font-lock-face over face.
* ; * doc/lispref/nonascii.texi (Coding System Basics): Fix grammar.Charles A. Roelli2019-04-261-1/+1
|