Thien-Thi Nguyen
9d6a3ac73a
Mention pcase as a fifth conditional form
...
* doc/lispref/control.texi (Conditionals): ...here,
in first para, w/ xref to "Pattern-Matching Conditional".
2018-05-27 17:15:19 +02:00
Thien-Thi Nguyen
567cb9046d
Overhaul pcase documentation
...
Suggested by Drew Adams (Bug#31311).
* doc/lispref/control.texi (Control Structures):
Add "Pattern-Matching Conditional" to menu, before "Iteration".
(Conditionals): Delete menu.
(Pattern matching case statement): Delete node/subsection,
by actually moving, renaming, and overhauling it to...
(Pattern-Matching Conditional): ...new node/section.
(pcase Macro): New node/subsection.
(Extending pcase): Likewise.
(Backquote Patterns): Likewise.
* doc/lispref/elisp.texi (Top) In @detailmenu, add
"Pattern-Matching Conditional" under "Control Structures"
section and delete "Conditionals" section.
* lisp/emacs-lisp/pcase.el (pcase): Rewrite docstring.
(pcase-defmacro \` (qpat) ...): Likewise.
2018-05-27 17:14:27 +02:00
Noam Postavsky
2f44d2d5b1
Note caveat for backward regexp searching in docstring (Bug#31584)
...
* src/search.c (Fre_search_backward): Emphasize that backwards
searches may give shorter than expected matches.
* doc/lispref/searching.texi (Regexp Search): Add an anchor for
re-search-backward to reference.
2018-05-25 07:54:30 -04:00
Eli Zaretskii
3145d08cae
Update backtrace in Emacs Lisp Intro
...
* doc/lispintro/emacs-lisp-intro.texi (Making Errors): Update the
backtrace to match Emacs 26. (Bug#31589)
2018-05-25 11:35:42 +03:00
Eli Zaretskii
4bb2741b7e
More fixes of Intro to Emacs Lisp
...
* doc/lispintro/emacs-lisp-intro.texi (Finding More): Tell the
reader how to invoke 'M-.' without a tags table. Add a
cross-reference to the Emacs manual for when a tags table does
need to be created.
(append save-excursion): Rephrase a confusing sentence.
(Bug#31578)
2018-05-24 20:37:15 +03:00
Eli Zaretskii
c57c226839
; * doc/emacs/misc.texi (FFAP): Fix a typo. (Bug#31580)
2018-05-24 19:55:40 +03:00
Eli Zaretskii
0a51113397
Add a footnote to Emacs Lisp Intro
...
* doc/lispintro/emacs-lisp-intro.texi (Run a Program): Describe
the detailed output of integer value evaluation in a footnote, to
prevent confusion. (Bug#31579)
2018-05-24 19:49:34 +03:00
Eli Zaretskii
5eabe4a024
; * doc/emacs/msdos.texi (ls in Lisp): Fix a typo. (Bug#31575)
2018-05-24 19:32:40 +03:00
Eli Zaretskii
e7952bdfc8
Fix some cross-references in emacs-lisp-intro.texi
...
* doc/lispintro/emacs-lisp-intro.texi (List Processing)
(Determining the Element, graph-body-print): Fix cross-references
to subsections that don't exist in the printed version of the
manual. (Bug#31567)
2018-05-23 19:31:38 +03:00
Eli Zaretskii
a89795944b
Minor copyedits in Emacs manual in macos.texi
...
* doc/emacs/macos.texi (Mac / GNUstep Basics)
(Mac / GNUstep Events): Fix markup and capitalization.
(Bug#31568)
2018-05-23 19:02:00 +03:00
Eli Zaretskii
c0f3e6b56b
Minor formatting tweak in the Emacs manual
...
* doc/emacs/custom.texi (Directory Variables): Don't have 2
footnotes back to back, it looks bad in HTML. (Bug#31555)
2018-05-22 20:27:28 +03:00
Eli Zaretskii
fadf6535c0
Update comments in Intro to Emacs Lisp
...
* doc/lispintro/emacs-lisp-intro.texi: Explain in the comments
what are roman page numbers in Preface about. (Bug#31541)
2018-05-22 20:03:09 +03:00
Philipp Stephani
52ccb24aba
; * doc/os.texi (Batch Mode): use = after --eval
2018-05-22 15:33:22 +02:00
Eli Zaretskii
ef4aec14d1
; * doc/lispref/hash.texi (Defining Hash): Fix typos.
2018-05-21 21:08:39 +03:00
Eli Zaretskii
b1b96d7cd9
Update binding of 'M-.' in Intro to Emacs Lisp
...
* doc/lispintro/emacs-lisp-intro.texi (On Reading this Text)
(Finding More, Buffer Related Review, Buffer Exercises)
(Find a File, Conclusion): 'M-.' is now bound to
'xref-find-definitions'. (Bug#31542)
2018-05-21 18:01:57 +03:00
Eli Zaretskii
0d8bae5c55
Fix capitalization of mail headers
...
* doc/emacs/sending.texi (Mail Format, Mail Headers)
(Mail Aliases, Header Editing): Use consistent capitalization of
CC, BCC, and FCC. (Bug#31532)
2018-05-20 12:08:03 +03:00
Eli Zaretskii
a3885f5653
Minor fixes in the Emacs manual
...
* doc/emacs/misc.texi (Gnus Group Buffer): Fix a typo. (Bug#31534)
(Single Shell): Rephrase an unclear sentence. (Bug#31535)
(Remote Host): Use @command where appropriate. (Bug#31536)
2018-05-20 10:11:05 +03:00
Eli Zaretskii
542f830247
Fix a typo in rmail.texi
...
* doc/emacs/rmail.texi (Rmail Summary Edit): Add markup to 'nil'.
(Bug#31533)
2018-05-19 23:08:38 +03:00
Eli Zaretskii
6b4bafedbc
; Add a comment to emacs-lisp-intro.texi
...
* doc/lispintro/emacs-lisp-intro.texi: Add a comment with the
rationale for the manual's seemingly too large size.
2018-05-18 09:31:24 +03:00
Eli Zaretskii
c2ef847d3c
Clarify the mode-line indicators in CC Mode
...
* doc/emacs/programs.texi (Electric C): Explain '*' and '/' in the
CC Mode mode-line. (Bug31445)
2018-05-14 19:28:06 +03:00
Eli Zaretskii
b98cf9cdab
; Fix a typo in the Emacs manual
...
* doc/emacs/fixit.texi (Transpose): Fix a typo. Reported by
Takesi Ayanokoji <ayanokoji.takesi@gmail.com>.
2018-05-12 12:09:05 +03:00
Paul Eggert
700fcd77d7
* doc/emacs/help.texi: Fix paren typo.
2018-05-11 16:09:35 -07:00
Eli Zaretskii
c9c0e40d67
More minor changes in shell-related nodes of Emacs manual
...
* doc/emacs/misc.texi (Interactive Shell): Clarify how the window
that displays "*shell*" is selected.
(Shell Prompts): Fix a typo. Reported by Jorge
<jorge+list@disroot.org> in emacs-manual-bugs.
2018-05-11 12:39:52 +03:00
Eli Zaretskii
e6bf19cfff
Fix inaccuracies in "Shell Ring" node of Emacs manual
...
* doc/emacs/misc.texi (Shell Ring): Don't mention 'M-s' and don't
insist on Shell history commands being "jsut like" similar
commands that operate on minibuffer history. Reported by Jorge
<jorge+list@disroot.org> in emacs-manual-bugs.
2018-05-11 12:32:31 +03:00
Noam Postavsky
be2e8cb8be
* doc/man/emacs.1.in: Document --fg-daemon and --bg-daemon.
2018-05-10 22:47:04 -04:00
Eli Zaretskii
7ddcc9ab1a
Document 'custom-group'
...
* doc/lispref/customize.texi (Group Definitions): Document the
'custom-group' property.
2018-05-04 18:00:02 +03:00
Eli Zaretskii
4403f89056
Update the Emacs FAQ
...
* doc/misc/efaq.texi (Latest version of Emacs): Update versions.
(New in Emacs 26): New node.
* admin/release-process: Mention the FAQ update as part of the
release.
2018-04-28 15:03:17 +03:00
Alan Third
850ff18016
Clarify wording of NS drag n drop documentation
...
* doc/emacs/macos.texi (Mac / GNUstep Events): Clarify wording of
ns-drag-n-drop description.
2018-04-26 20:55:55 +01:00
Basil L. Contovounesios
343d70b10e
Improve kill-related documentation (bug#31209)
...
* doc/lispref/text.texi (Low-Level Kill Ring): Fix typo under
current-kill. Mention interprogram-paste-function under kill-new
and kill-append.
* lisp/simple.el (save-interprogram-paste-before-kill, kill-new)
(kill-append-merge-undo, kill-append): Touch-up docstrings.
2018-04-24 20:58:15 -04:00
Charles A. Roelli
6cf83131e2
* doc/lispref/display.texi (Glyphless Chars): Fix grammar.
2018-04-22 11:15:37 +02:00
Alan Third
88d178ce94
Fix macOS drag n drop event documentation
...
* doc/emacs/macos.texi (Mac / GNUstep Customization): Remove
references to color panel.
(Mac / GNUstep Events): Remove ns-drag-file, and add ns-drag-n-drop.
2018-04-21 14:35:02 +01:00
Eli Zaretskii
5de608f3ed
Update the documentation of 'perform-replace'
...
* doc/lispref/searching.texi (Search and Replace): Update the
documentation of 'perform-replace'.
2018-04-20 10:18:06 +03:00
Eli Zaretskii
8f6293ca78
Fix use of @key in Texinfo manuals
...
* doc/misc/efaq-w32.texi (Location of init file):
* doc/misc/org.texi (Editing source code, Export settings)
(Closing items, Drawers, Structure editing):
* doc/misc/gnus.texi (Spam and Ham Processors, Terminology):
* doc/misc/calc.texi (Keypad Functions Menu, Keypad Binary Menu)
(Keypad Vectors Menu, Keypad Main Menu, Basic Arithmetic)
(Symbolic Mode):
* doc/misc/sc.texi (Electric References):
* doc/misc/info.texi (Help-^L):
* doc/misc/reftex.texi (Reference Styles):
* doc/misc/idlwave.texi (Troubleshooting, Examining Variables)
(Lesson III---User Catalog, Using the Shell):
* doc/misc/eshell.texi (Bugs and ideas):
* doc/misc/ada-mode.texi (Automatic Casing):
* doc/misc/ediff.texi (Selective Browsing):
* doc/misc/vip.texi (Customizing Constants):
* doc/misc/pcl-cvs.texi (Selected files):
* doc/misc/efaq.texi (Replying to the sender of a message)
(Basic keys, No Meta key, Matching parentheses)
(Origin of the term Emacs, Installing Texinfo documentation)
(Learning how to do something, Emacs manual, Extended commands):
* doc/misc/viper.texi (Rudimentary Changes):
* doc/misc/tramp.texi (Frequently Asked Questions):
* doc/emacs/kmacro.texi (Basic Keyboard Macro):
* doc/emacs/frames.texi (Frame Commands):
* doc/emacs/msdos.texi (Windows Keyboard):
* doc/emacs/search.texi (Query Replace):
* doc/lispintro/emacs-lisp-intro.texi (Keybindings)
(Note for Novices):
* doc/lispref/tips.texi (Key Binding Conventions): Fix use of
@key. For the details, see
http://lists.gnu.org/archive/html/emacs-devel/2018-04/msg00390.html .
2018-04-19 12:21:06 +03:00
Eli Zaretskii
f4c989427b
Improve documentation of actual arglist
...
* doc/lispref/functions.texi (Function Documentation): Advise
against using '(fn ARGLIST)' method of advertising a calling
convention when the old calling convention is deprecated.
(Bug#31191)
2018-04-19 11:29:50 +03:00
Eli Zaretskii
4341aacd87
Minor wording improvement in "Bookmarks"
...
* doc/emacs/regs.texi (Bookmarks): Improve wording. Suggested by
"Siraphob (Ben) Phipathananunth" <siraben@disroot.org>.
2018-04-15 20:34:44 +03:00
Eli Zaretskii
ad731b0d8f
; * doc/lispref/display.texi (Temporary Displays): Fix typos.
2018-04-13 20:19:17 +03:00
Alan Mackenzie
f1450e9f34
Complete documentation of syntax flags by adding `c'
...
* doc/lispref/syntax.texi ("Syntax Table Internals"): Add entry for `c'
as `(1 lsh 23)'.
2018-04-13 14:35:13 +00:00
Eli Zaretskii
6bdcaec885
Fix typos and minor wording issues in ELisp manual
...
* doc/lispref/internals.texi (Writing Emacs Primitives):
* doc/lispref/display.texi (Temporary Displays): Fix typos.
* doc/lispref/text.texi (Filling, Changing Properties)
(Transposition): Clarify and fix typos.
* doc/lispref/positions.texi (Screen Lines): Improve wording.
* doc/lispref/modes.texi (Minor Mode Conventions)
(Font Lock Multiline): Fix typos.
* doc/lispref/variables.texi (Dynamic Binding Tips): Fix a
cross-reference. Fix a typo.
* doc/lispref/sequences.texi (Sequence Functions): Fix typos.
(Bug#31143)
2018-04-13 16:44:05 +03:00
Eli Zaretskii
3a798f696b
Fix a minor mistake in the ELisp manual
...
* doc/lispref/files.texi (Reading from Files): Fix copy/paste
mistake. (Bug#31107)
2018-04-09 17:53:37 +03:00
Eli Zaretskii
1527235baf
; * doc/lispref/compile.texi (Compilation Functions): Fix wording.
2018-04-02 20:25:52 +03:00
Tino Calancha
b07decdf02
; * doc/lispref/compile.texi (Compilation Functions): Fix typo
2018-04-03 00:43:25 +09:00
Eli Zaretskii
9fee1b8fb3
Minor copyedits of completion-at-point-functions documentation
...
* lisp/minibuffer.el (completion-at-point-functions):
* doc/lispref/minibuf.texi (Completion in Buffers): Fix wording
and filling.
(cherry picked from commit a8ddd05d7d
)
2018-04-01 12:22:39 +03:00
Stefan Monnier
748f0fdd5a
(completion-at-point-functions): Improve doc
...
(cherry picked from commit b56c56f203
)
2018-04-01 12:21:29 +03:00
Eli Zaretskii
3a451bd1e0
; * doc/emacs/msdos.texi: Fix wording of last change.
2018-03-31 11:16:05 +03:00
Noam Postavsky
e50196e8a9
Document return value of pcase (Bug#30425)
...
* doc/lispref/control.texi (Pattern matching case statement):
* lisp/emacs-lisp/pcase.el (pcase): State that pcase returns nil if no
patterns match.
(pcase-exhaustive): State that an error is signaled if no patterns
match.
2018-03-31 00:50:37 -04:00
Paul Eggert
8a2466ff72
* doc/emacs/macos.texi: Tweak grammar and capitalization.
2018-03-30 19:08:44 -07:00
Richard Stallman
9db62bf993
Distinguish free from non-free OSes
2018-03-30 19:08:44 -07:00
Glenn Morris
ff49d86b64
* doc/emacs/misc.texi (Amusements): Avoid non-printing character.
...
; Hey fellow kids, remember that gag from 2008? Emacs does.
2018-03-28 15:00:58 -04:00
Glenn Morris
5bab671521
Fix xrefs in pdf Emacs manual
...
* doc/emacs/fortran-xtra.texi (ForIndent Cont, ForIndent Num)
(Fortran Columns):
* doc/emacs/picture-xtra.texi (Rectangles in Picture):
Fix recent changes that neglected the splitting of the pdf manuals.
2018-03-28 14:20:57 -04:00
Michael Albinus
9bff405d09
* doc/misc/org.texi (Installation): Fix clone commands.
2018-03-28 10:38:26 +02:00