Commit graph

9185 commits

Author SHA1 Message Date
YugaEgo
cd9dd26d24 Format and index concept 'predicate' in ELisp Intro
* doc/lispintro/emacs-lisp-intro.texi (Wrong Type of Argument):
Add index and format definition (bug#52197).

Copyright-paperwork-exempt: yes
2021-11-30 14:04:22 +01:00
Protesilaos Stavrou
ecf3bf66ba
Remove problematic characters from modus-themes.org (bug#52126)
* doc/misc/modus-themes.org
(Enable and load, Font configurations for Org and others)
(Note on highlight-parentheses.el, Note on god-mode.el): Update links to
headings so that they no longer include the removed portions of text.

(Option for color-coding success state, Option for line highlighting)
(Option for line numbers, Option for parenthesis matching)
(Advanced customization, Per-theme customization settings)
(Case-by-case face specs using the themes' palette)
(Face specs at scale using the themes' palette)
(Remap face with local value, Cycle through arbitrary colors)
(Override colors, Override color saturation)
(Font configurations for Org and others, Configure bold and italic faces)
(Custom Org user faces, Update Org block delimiter fontification)
(Measure color contrast, Load theme depending on time of day)
(Backdrop for pdf-tools)
(A theme-agnostic hook for theme loading, Note on EWW and Elfeed fonts)
(Frequently Asked Questions): Remove parentheses from headings as they
can cause problems in the .texi version of the file.
2021-11-29 21:13:55 +02:00
Kyle Meyer
b8b2dd17c5 Update to Org 9.5.1-11-g96d91b 2021-11-27 16:25:09 -05:00
Eli Zaretskii
a937f536b3 * doc/lispref/commands.texi (Click Events): Fix wording (bug#52142). 2021-11-27 15:01:46 +02:00
Robert Pluim
4d16a2f737 Fix pdf generation with Texinfo 6.7
* doc/lispref/display.texi (Size of Displayed Text): Put @group inside
@example (bug#52102).
2021-11-25 15:29:00 +01:00
Eli Zaretskii
0854453ec2 Revert "Use @pxref when necessary"
This reverts commit b4f47d2ee2.
Cleanups should not be done on the release branch: that's
unnecessary risk.
2021-11-24 21:27:15 +02:00
Robert Pluim
b4f47d2ee2 Use @pxref when necessary
* doc/lispref/customize.texi (Composite Types):
* doc/lispref/edebug.texi (Specification List):
* doc/lispref/variables.texi (Local Variables):
* doc/misc/efaq.texi (Basic keys):
(Informational files for Emacs):
* doc/misc/flymake.texi (Locating a master file):
* doc/misc/gnus.texi (Don't Panic):
(Oort Gnus):
* doc/misc/htmlfontify.texi (Non-interactive):
* doc/misc/mh-e.texi (More About MH-E):
* doc/misc/pcl-cvs.texi (Entering PCL-CVS):
* doc/misc/tramp.texi (Remote processes):
* doc/misc/vhdl-mode.texi (Indentation Calculation):
(Custom Indentation Functions): Use @pxref when inside parens.
2021-11-24 17:55:27 +01:00
Takesi Ayanokoji
756b8a5f1b Fix typos in documentation
* doc/lispref/anti.texi:
* doc/misc/efaq.texi: Fix typos.

Copyright-paperwork-exempt: yes
2021-11-23 16:37:04 +02:00
Eli Zaretskii
5eeaf85767 Improve documentation of window hooks
* doc/lispref/windows.texi (Window Hooks): Clarify "buffer-local
functions".  (Bug#51930)
2021-11-18 10:25:58 +02:00
Stefan Kangas
42d4e24ff3 ; Fix typos 2021-11-12 13:59:58 +01:00
Eli Zaretskii
0d0125daae Improve documentation of 'decode-coding-region'
* src/coding.c (Fdecode_coding_region): Doc fix.

* doc/lispref/nonascii.texi (Coding System Basics)
(Explicit Encoding): Explain the significance of using 'undecided'
in 'decode-coding-*' functions.
2021-11-12 10:53:52 +02:00
Lars Ingebrigtsen
144ad77fda Fix Lisp Intro markup error
* doc/lispintro/emacs-lisp-intro.texi (Insert let): Fix @code
markup error (bug#51777).
2021-11-12 04:39:07 +01:00
Tom Levy
beaa7e14f3 ; Fix typos in CONTRIBUTE, ELisp manual, ediff
* CONTRIBUTE: Remove stray '. after git command.
* doc/lispref/functions.texi (Function Cells): Fix typo.
* lisp/vc/ediff.el (ediff-regions-wordwise): Fix typo in prompts
("Region's A buffer" => "Region A's buffer") (bug#51718).

Copyright-paperwork-exempt: yes
2021-11-10 01:17:42 +01:00
Juri Linkov
747a1ae4ac * doc/misc/eww.texi (Advanced): Fix missed variable name eww-retrieve-command. 2021-11-09 22:45:17 +02:00
Juri Linkov
52fe2340b8 * doc/emacs/windows.texi (Window Convenience): Use @code for windmove.
This refers to both a command and a user option.

* etc/NEWS: Add some ---.
2021-11-09 22:43:54 +02:00
Juri Linkov
7d3a654e2a * doc/emacs/maintaining.texi (Basic VC Editing): Mention Dired buffer.
* doc/emacs/text.texi (Outline Mode): Replace S-TAB with with S-<TAB>.

* etc/NEWS: Add some missing +++/--- and move some related items closer.
2021-11-09 22:40:15 +02:00
Eli Zaretskii
aeb19af4b5 ; * doc/emacs/building.texi (Lisp Libraries): Fix a typo. (Bug#51717) 2021-11-09 15:51:24 +02:00
Juri Linkov
818211ed89 * doc/emacs/search.texi (Isearch Yank): Add isearch-forward-thing-at-point.
; * etc/NEWS: Add +++ for isearch-forward-thing-at-point, reorder (bug#51444).
2021-11-08 19:36:57 +02:00
Juri Linkov
8d9b55330d * doc/emacs/frames.texi (Tab Bars): Add text about mouse and tab-bar-format
Briefly describe mouse commands on the tab bar and tab-bar-format (bug#51444)
2021-11-07 20:00:56 +02:00
Juri Linkov
d9b0b730e8 * doc/emacs/frames.texi (Tab Bars): Describe tab-last.
'C-9' and 'M-9' already had kindex, so describe them in the text as well
(bug#51444).
2021-11-07 19:56:28 +02:00
Eli Zaretskii
c2e3cd6694 Clarify "text area of a window" in the documentation
* src/keyboard.c (Fposn_at_x_y): Clarify that the Y coordinate
includes the header-line and the tab-line.  (Bug#51590)

* doc/lispref/windows.texi (Window Sizes, Splitting Windows)
(Textual Scrolling, Coordinates and Windows): Fix/remove improper
or confusing uses of "text area" of a window.
2021-11-06 08:59:09 +02:00
Juri Linkov
19ede237f5 * doc/emacs/frames.texi (Tab Bars): Reorder toggle-frame-tab-bar. 2021-11-04 19:33:31 +02:00
Juri Linkov
b5ccad3f5a * doc/emacs/building.texi (Compilation Mode): Add next-error-message-highlight
The variable 'next-error-message-highlight' already has vindex,
so describe it in the text as well (bug#51444).
2021-11-03 20:34:04 +02:00
Mattias Engdegård
81915a95af Add manual section about how to avoid regexp problems
Help users affected by our NFA engine's stack overflows and occasional
poor performance, replacing old text that was more limited in scope.

* doc/lispref/elisp.texi (Top):
* doc/lispref/searching.texi (Regular Expressions): Add menu entries.
(Regexp Problems): New node.
(Regexp Special):
* etc/PROBLEMS: Remove superseded text.
2021-11-03 13:50:12 +01:00
Eli Zaretskii
7e15ee5bc9 ; * doc/emacs/help.texi (Help Mode): Improve indexing. 2021-10-31 21:23:34 +02:00
Hanno Perrey
f1c9286376 ; * doc/misc/org.org: fix capture context example
* doc/misc/org.org (Templates in contexts): Add missing parenthesis to
code example for org-capture template contexts as documented in
docstring.

Copyright-paperwork-exempt: yes (bug#51524).
2021-10-31 16:23:41 +01:00
Eli Zaretskii
20ebd91a73 Improve documentation of string truncation APIs
* doc/lispref/display.texi (Size of Displayed Text):
* lisp/international/mule-util.el (truncate-string-to-width):
Document caveats of using 'truncate-string-to-width' when
character composition is involved.

* lisp/emacs-lisp/subr-x.el (string-limit):
* doc/lispref/strings.texi (Creating Strings): Improve the
documentation of 'string-limit'.
2021-10-30 10:26:38 +03:00
Michael Albinus
00103154e0 Some Tramp changes, mainly in tramp-tests.el
* doc/misc/tramp.texi (External packages): Don't use Tramp internals.

* lisp/net/tramp-gvfs.el (tramp-gvfs-handler-mounted-unmounted):
Protect `tramp-make-tramp-file-name' call.

* lisp/net/tramp.el (tramp-make-tramp-file-name): Set advertised
calling conventions.

* test/lisp/net/tramp-tests.el (tramp-test18-file-attributes):
Adapt test.
(tramp--test-supports-processes-p): New defun.
(tramp-test28-process-file, tramp-test29-start-file-process)
(tramp-test30-make-process, tramp-test32-shell-command)
(tramp-test32-shell-command-dont-erase-buffer)
(tramp-test34-explicit-shell-file-name, tramp-test35-exec-path)
(tramp-test44-asynchronous-requests): Use it.
2021-10-29 14:06:47 +02:00
Michael Albinus
9436943fb1 ; * doc/emacs/custom.texi (Connection Variables): Fix typo. Don't merge 2021-10-29 14:05:36 +02:00
Eli Zaretskii
928e05f2d6 Clarify "default face attributes" in the ELisp manual
* doc/lispref/display.texi (Defining Faces): Add index entries for
face symbol properties.
(Attribute Functions): Clarify "default face attribute values" wrt
'face-all-attributes' and 'face-attribute'.  (Bug#51465)
2021-10-29 10:10:01 +03:00
Jan Synacek
d72fefdeab Fix typos in the manual and in a comment
* lisp/minibuffer.el (completion-pcm--hilit-commonality):
* doc/lispintro/emacs-lisp-intro.texi (Mode Line): Fix typos
(bug#51434).

Copyright-paperwork-exempt: yes
2021-10-28 23:33:12 +02:00
Eli Zaretskii
d353fc4a00 ; Explain why "kinds of atom" isn't a typo
* doc/lispintro/emacs-lisp-intro.texi (Lisp Atoms): Add a comment
explaining why "kinds of atom" isn't a typo.
2021-10-27 14:33:42 +03:00
Eli Zaretskii
a2c17e115e Merge branch 'emacs-28' of git.savannah.gnu.org:/srv/git/emacs into emacs-28 2021-10-25 19:19:55 +03:00
Eli Zaretskii
fde56eeb76 Revert "Fix a typo in emacs-lisp-intro.texi"
This reverts commit 98eb6d783a.
I've consulted with Richard Stallman about this, and he says
that the original wording, "kinds of atom", is both correct
and more elegant writing.  So I'm restoring the original text.
* doc/lispintro/emacs-lisp-intro.texi (Lisp Atoms): Undo the
fix of a "typo" that wasn't a typo.  (Bug#51271)
2021-10-25 19:11:06 +03:00
Robert Pluim
4779d3ba19 * doc/lispref/functions.texi (Mapping Functions): Use #' when mapping. 2021-10-25 15:46:49 +02:00
Stefan Kangas
50f9436146 image-dired: Doc fix to better explain thumbnail generation
* doc/emacs/dired.texi (Image-Dired): Improve description by
explaining that the generation of thumbnails is asynchronous.
2021-10-25 04:54:00 +02:00
Lars Ingebrigtsen
f5b4bb4a6f Fix flymake example backend conditions in the manual
* doc/misc/flymake.texi (An annotated example backend): Also react
to `signal' process statuses (bug#51380).
2021-10-25 01:25:20 +02:00
Eli Zaretskii
9a50f760e9 ; * doc/lispref/modes.texi (Hooks): Clarify wording. (Bug#34588) 2021-10-24 09:44:18 +03:00
Stefan Kangas
4fd5c8df67 Clarify abnormal hook documentation
* doc/lispref/hooks.texi (Standard Hooks):
* doc/lispref/modes.texi (Hooks): Clarify wording of "abnormal
hook" documentation.  (Bug#34588)
2021-10-23 20:03:34 +02:00
Kyle Meyer
6fa5206770 Update to Org 9.5-59-g52e6f1 2021-10-23 13:46:59 -04:00
Eli Zaretskii
39413a45bf ; * doc/lispref/functions.texi (Calling Functions): Fix last change. 2021-10-23 20:44:26 +03:00
Stefan Kangas
43914ab01f Improve documentation of cl-reduce
* doc/misc/cl.texi (Mapping over Sequences): Change the
explanation of 'cl-reduce' so you don't need to have a major in
mathematics to understand it.  (Bug#24014)
2021-10-23 19:20:56 +02:00
Stefan Kangas
ef37a86cac Improve documentation of apply-partially
* doc/lispref/functions.texi (Calling Functions): Improve
documentation of 'apply-partially' to be slightly more clear with
regards to function arity.  (Bug#17623)
2021-10-23 18:47:00 +02:00
Michael Albinus
1e8be48738 Fix typos
* doc/emacs/cmdargs.texi:
* etc/DEBUG:
* etc/NEWS: Fix typos.
2021-10-23 15:21:33 +02:00
Stefan Kangas
cdbd03345d Fix documentation of posn-at-x-y
* doc/lispref/commands.texi (Accessing Mouse): Fix documentation of
'posn-at-x-y' to match docstring.  (Bug#15783)
2021-10-23 09:45:23 +02:00
Robert Pluim
7fde84e881 Improve documentation of syntax-ppss-context slightly
* doc/lispref/syntax.texi (Parser State): Document all possible return
values from 'syntax-ppss-context'.
2021-10-22 17:54:55 +02:00
Stefan Kangas
2a0a368ddc Fix typo in doc/emacs/anti.texi
* doc/emacs/anti.texi (Antinews): Fix typo.  (Bug#51325)
Reported by Po Lu <luangruo@yahoo.com>.
2021-10-22 05:28:21 +02:00
Stephen Gildea
9529e1d2fb Update doc of Edebug specification for macros
doc/lispref/edebug.texi:  Update documentation of Edebug specification:
- Do not document "0" as a recommended shortcut for non-instrumented
arguments; nobody knows about nor uses this, so don't encourage it.
- Add an example equivalent to (declare (debug (&rest sexp))).
2021-10-21 20:12:49 -07:00
Pedro Mauro
c1cf95a0e1 ; * doc/emacs/windows.texi: Doc fix.
* doc/emacs/windows.texi (Window Choice): Make example a valid
alist (bug#51274).
2021-10-19 05:14:15 +02:00
Stefan Kangas
98eb6d783a Fix a typo in emacs-lisp-intro.texi
* doc/lispintro/emacs-lisp-intro.texi (Lisp Atoms): Fix typo.
Reported by Mor Zahavi <morzahavi@me.com>.  (Bug#51271)
2021-10-19 02:39:00 +02:00