1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-02-04 06:31:13 -08:00
Commit graph

6259 commits

Author SHA1 Message Date
Eli Zaretskii
5b38406491 Fix documentation of delsel and of killing text
* doc/emacs/killing.texi (Appending Kills): Make sure the text
with 2 spaces is not broken between 2 lines.
* doc/emacs/mark.texi (Using Region): Remove the sentence about
delsel mode that describes behavior which exists even without
delsel mode turned on.  Suggested by Petteri Hintsanen
<petterih@iki.fi> in emacs-manual-bugs@gnu.org.

* lisp/delsel.el (delete-selection-mode): Doc fix.
2017-12-27 20:23:10 +02:00
Glenn Morris
fd35804971 * doc/lispref/strings.texi (Case Conversion):
Use a TeX font that support ligatures.
2017-12-27 09:55:35 -08:00
Charles A. Roelli
89e257d71b * doc/misc/speedbar.texi (Top): Fix grammar. 2017-12-27 18:25:30 +01:00
Eli Zaretskii
2ebc8dc3b6 Fix curved quotes in printed manual
* doc/emacs/text.texi (Quotation Marks): Fix curved quote
characters in the printed version of the manual.
2017-12-26 22:43:32 +02:00
Paul Eggert
e4a881b5cf Say that "gnus-cloud" is a parody name 2017-12-25 14:20:36 -08:00
Eli Zaretskii
13c59d0a83 More improvements for text.texi
* doc/emacs/text.texi (Outline Motion): Avoid unneeded
repetition.  Suggested by Petteri Hintsanen <petterih@iki.fi> in
emacs-manual-bugs@gnu.org.
2017-12-25 21:49:37 +02:00
Eli Zaretskii
7850b7620e Adjudicate review comments for the "Text" chapter of user manual
* doc/emacs/text.texi (Text): Rearrange text for clarity.  Add
cross-reference to the Org manual.  Make the cross-reference to
Outline Mode appear in online manuals as well (the conditional was
a forgotten remnant from time immemoriam).
(Paragraphs): Add a note that 'paragraph-start' and
'paragraph-separate' should not be anchored.
(Auto Fill): Remove redundant text.  Suggested by Petteri
Hintsanen <petterih@iki.fi> in emacs-manual-bugs@gnu.org.
2017-12-24 20:47:06 +02:00
Eli Zaretskii
b882d4ef11 Fix problems with ligatures in PDF version of ELisp manual
* doc/lispref/strings.texi (Case Conversion): Avoid problems with
ligatures in printed versions of the manual.  (Bug#29818)
2017-12-23 10:34:42 +02:00
Glenn Morris
cf36c82127 Avoid some overfull lines in PDF lispref
* doc/lispref/commands.texi (Reading One Event):
* doc/lispref/display.texi (SVG Images):
* doc/lispref/frames.texi (Size Parameters):
* doc/lispref/syntax.texi (Categories):
* doc/lispref/windows.texi (Frame Layouts with Side Windows):
Avoid overfull lines.
2017-12-22 16:26:08 -05:00
Glenn Morris
b07b56a351 Avoid some overfull lines in PDF manual
* doc/emacs/display.texi (Display Custom):
* doc/emacs/search.texi (Other Repeating Search):
* doc/emacs/text.texi (Quotation Marks): Avoid overfull lines.
2017-12-22 16:24:24 -05:00
Glenn Morris
6b3118f025 * doc/emacs/arevert-xtra.texi (Auto Reverting the Buffer Menu):
Fix ref.
2017-12-22 16:22:13 -05:00
Glenn Morris
7ffb7b1e01 ; lispref nil/t markup fixes 2017-12-22 13:45:46 -05:00
Eli Zaretskii
c3b6742b3f Improve documentation of selecting windows
* doc/lispref/windows.texi (Basic Windows, Selecting Windows):
Clarify what selecting a window means for keyboard input, and that
input focus may need to be considered when selecting windows on
other frames.  See
http://lists.gnu.org/archive/html/emacs-devel/2017-12/msg00372.html
for more details.
2017-12-22 12:18:12 +02:00
Eli Zaretskii
861d110078 Improve documentation of records
* doc/lispref/Makefile.in (srcs): Add the forgotten records.texi.
* doc/lispref/records.texi (Records): Recommend that record type
names use package-naming conventions.

* etc/NEWS: Add the naming convention recommendation for record
types.
2017-12-22 12:04:23 +02:00
Eli Zaretskii
90ca37feed Fix documentation of 'mouse-drag-and-drop-region' and friends
* doc/emacs/frames.texi (Drag and Drop): Index
'mouse-drag-and-drop-region-cut-when-buffers-differ',
'mouse-drag-and-drop-region-show-tooltip', and
'mouse-drag-and-drop-region-show-cursor'.

* etc/NEWS: Fix the format of the related entries.
2017-12-22 11:19:56 +02:00
Tak Kunihiro
a0e3b06725 Document 'mouse-drag-and-drop-region' options and mention them in NEWS
* doc/emacs/frames.texi (Drag and Drop):
* etc/NEWS (times): Document options for
'mouse-drag-and-drop-region' and mention them in NEWS.
2017-12-22 09:39:07 +01:00
Martin Rudalics
164e84c977 Fix uses of 'nil' and 'non-nil' in manuals and a few more minor issues
* 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'.
2017-12-22 09:20:41 +01:00
Philipp Stephani
798f07f150 Document that mode commands should be idempotent.
* doc/lispref/modes.texi (Major Mode Conventions, Minor Mode
Conventions): Document that the mode commands should be idempotent.
2017-12-21 21:49:08 +01:00
Dmitry Gutov
aca827b0d0 Merge branch 'widen-less' into emacs-26 2017-12-21 00:34:07 +02:00
Dmitry Gutov
446faf3efa Replace the mention of c-indent-defun with js-indent-line
* doc/lispref/text.texi (Mode-Specific Indent):
Avoid mentioning c-indent-defun in the context of multi-mode
indentation.
2017-12-18 02:30:41 +02:00
Eli Zaretskii
ffd4771560 * doc/lispref/sequences.texi (Sequence Functions): Improve indexing. 2017-12-16 16:54:32 +02:00
Eli Zaretskii
7890864413 Improve documentation of 'invisible-p'
* doc/lispref/display.texi (Invisible Text): Document the return
value of 'invisible-p'.

* src/xdisp.c (Finvisible_p): Rename the argument POS.  Doc fix.
(Bug#29721)
2017-12-16 12:15:06 +02:00
Eli Zaretskii
12ad276d15 Improve documentation of TERM environment variable
* doc/emacs/trouble.texi (Checklist):
* doc/emacs/building.texi (Compilation Shell):
* doc/emacs/misc.texi (Shell Options): Improve indexing of TERM.
* doc/emacs/building.texi (Compilation Shell): Mention
'comint-terminfo-terminal' in conjunction with the TERM value.
2017-12-15 11:45:22 +02:00
Allen Li
8ed529f0f3 Add option to configure comint TERM
* lisp/comint.el (comint-terminfo-terminal): New defcustom.
(comint-term-environment): New function for setting terminal options
(comint-exec-1): Use comint-term-environment.  (Bug#29583)
* lisp/progmodes/compile.el (compilation-start): Use comint-term-environment.

* etc/NEWS:
* doc/emacs/misc.texi (Shell Options): Document the new option.
2017-12-15 11:30:25 +02:00
Ted Zlatanov
a21dac18bb
Add %DUMBFW to the default GnuTLS priority strings
* lisp/net/gnutls.el (gnutls-boot-parameters): Add %DUMBFW to
the default priority strings (Bug#25061).

* etc/NEWS: Mention it.

* doc/misc/emacs-gnutls.texi (Help For Users): Point to the
GnuTLS priority string documentation URL.
2017-12-14 23:16:38 -05:00
Dmitry Gutov
7e9eef0ffd Consolidate 'widen' calls
* lisp/progmodes/prog-mode.el (prog-indentation-context):
Un-document all elements but the first.
(prog-widen): Remove.
(http://lists.gnu.org/archive/html/emacs-devel/2017-12/msg00321.html)

* doc/lispref/text.texi (Mode-Specific Indent): Update.

* lisp/progmodes/ruby-mode.el (ruby-calculate-indent):
Don't call widen.

* lisp/progmodes/python.el
(python-indent-guess-indent-offset)
(python-info-current-defun): Replace prog-widen with widen;
these functions are not called during indentation.
(python-indent-context)
(python-indent--calculate-indentation)
(python-info-dedenter-opening-block-message)
(python-info-line-ends-backslash-p)
(python-info-beginning-of-backslash)
(python-info-continuation-line-p)
(python-info-current-defun): Remove 'widen' calls.

* lisp/indent.el (indent-according-to-mode)
(indent-for-tab-command, indent-region): Move them here.

* lisp/textmodes/mhtml-mode.el (mhtml-indent-line):
Bind prog-indentation-context to one-element list.
2017-12-14 11:18:51 +02:00
Eli Zaretskii
d23158777d Fix fontset documentation inconsistencies for bug#29630
* doc/lispref/display.texi (Face Attributes): Don't document
:family as accepting a fontset.  Document that :font accepts a
fontset.

* lisp/faces.el (set-face-attribute): Doc fix.
2017-12-10 19:19:40 +02:00
Martin Rudalics
a829cb8c8b Remove sentence from child frames section in Elisp manual
* doc/lispref/frames.texi (Child Frames): Remove one sentence.
Suggested by Bob Weiner <rsw@gnu.org>.
2017-12-10 10:38:08 +01:00
Eli Zaretskii
90e20804f5 Improve documentation of 'save-abbrevs'.
* doc/emacs/abbrevs.texi (Saving Abbrevs): Document the 'silently'
value of 'save-abbrevs'.  Suggested by Alex Branham
<alex.branham@gmail.com> in emacs-manual-bugs@gnu.org.
2017-12-09 13:43:29 +02:00
Eli Zaretskii
14f0230a48 Improve documentation of Dired
* doc/emacs/dired.texi (Dired): Mention that the Dired buffer can
be made modifiable in Wdired.  Suggested by Alex Branham
<alex.branham@gmail.com> in emacs-manual-bugs@gnu.org.
2017-12-09 13:29:11 +02:00
Rasmus
445eefd238 Backport: Update Org to v9.1.4
Please note this is a bugfix release. See etc/ORG-NEWS for details.

(cherry picked from commit 567b5efe1f)
2017-12-06 15:37:41 +01:00
Martin Rudalics
5381c70b7a In windows.texi mention special splitting behavior of side and atomic windows
* doc/lispref/windows.texi (Splitting Windows): Add note about
and links to side and atomic windows.
2017-12-06 09:53:30 +01:00
Eli Zaretskii
77cf972592 Improve documentation of buffer-list commands and features
* doc/emacs/buffers.texi (List Buffers): Add a cross-reference to
"Several Buffers", to establish a relation between the two
sections.
(Buffer Menus): Expand on customizability of alternative buffer
menu offered by bs.el.  Mention IBuffer.
Suggested by Alex Branham <alex.branham@gmail.com> in
emacs-manual-bugs@gnu.org.
2017-12-02 12:56:45 +02:00
Glenn Morris
7e61e74da7 * doc/emacs/mule.texi (Output Coding): Clarify sendmail coding. 2017-12-01 19:59:11 -05:00
Eli Zaretskii
f52d79500b Fix a typo in ELisp manual
* doc/lispref/sequences.texi (Sequence Functions): Fix the example
of using 'seq-uniq'.  (Bug#29524)
2017-12-01 21:56:31 +02:00
Eli Zaretskii
9292276a44 Fix a typo in the Emacs manual
* doc/emacs/abbrevs.texi (Abbrev Concepts): Fix a typo.  Reported
by clemens.radermacher@posteo.de in emacs-manual-bugs@gnu.org.
2017-12-01 10:26:58 +02:00
Eli Zaretskii
42509c0649 Improve the documentation of 'table-insert-sequence'
* doc/emacs/text.texi (Table Misc): Fix the description of
'table-insert-sequence'.  Reported by jack <jackh@gmx.co.uk> in
emacs-manual-bugs@gnu.org.
2017-12-01 10:20:47 +02:00
Tino Calancha
d670a15f25 * doc/misc/url.texi (http/https): Fix typo 2017-11-29 11:42:11 +09:00
Kaushal Modi
0540df10e6 Update documentation of '.dir-locals-2.el'
See https://lists.gnu.org/r/emacs-devel/2017-11/msg00649.html
for more details.
* lisp/files.el (dir-locals-file-2): Remove unused constant.
* lisp/files.el (dir-locals-file): Mention ".dir-locals-2.el" in
the doc string.
* doc/lispref/variables.texi (Directory Local Variables): Mention
".dir-locals-2.el".
* etc/NEWS: Replace `dir-locals-file-2' mention with
`dir-locals-file'.
2017-11-28 19:17:48 +02:00
Eli Zaretskii
0a85d12474 Fix ELisp "Warning Tips"
* doc/lispref/tips.texi (Warning Tips): Clarify when to use
'require' wrapped by 'eval-when-compile'.  (Bug#29462)
2017-11-27 18:24:29 +02:00
Eli Zaretskii
16358d4fcb Improve documentation of "constant" symbols
* src/font.c (syms_of_font) <font-weight-table, font-slant-table>
<font-width-table>:
* src/data.c (syms_of_data) <most-positive-fixnum>
<most-negative-fixnum>:
* src/buffer.c (syms_of_buffer) <enable-multibyte-characters>:
Mention in the doc strings that these variables are read-only.

* doc/lispref/variables.texi (Creating Buffer-Local): Document
that making a constant variable buffer-local signals an error.
* doc/lispref/variables.texi (Constant Variables):
* doc/lispref/errors.texi (Standard Errors): More accurate and
up-to-date documentation of which symbols cannot be assigned
values.
2017-11-26 20:23:15 +02:00
Paul Eggert
a89f0b6f33 maint: shorten https://lists.gnu.org/archive/html/... links 2017-11-25 22:48:12 -08:00
Paul Eggert
8be3aee281 Merge from Gnulib
This incorporates:
2017-11-23 stat: work around Solaris bug with tv_nsec < 0
2017-11-12 maint: shorten https://lists.gnu.org/archive/html/... links
* build-aux/config.sub, doc/misc/texinfo.tex, lib/allocator.h:
* lib/fstatat.c, lib/intprops.h, lib/lstat.c, lib/signal.in.h:
* lib/stat-time.h, lib/stdio-impl.h, lib/stdio.in.h:
* lib/timespec.h, m4/alloca.m4, m4/extern-inline.m4:
* m4/faccessat.m4, m4/fstatat.m4, m4/gnulib-common.m4:
* m4/lstat.m4, m4/std-gnu11.m4, m4/sys_types_h.m4:
* m4/vararrays.m4:
Copy from Gnulib.
2017-11-25 22:48:09 -08:00
Eli Zaretskii
b4f67ebb92 Improve discoverability of 'defvar' for suppressing warnings
* 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)
2017-11-24 16:36:33 +02:00
Eli Zaretskii
8a2b204e64 Improve discoverability of 'read-buffer-completion-ignore-case'
* lisp/window.el (switch-to-buffer)
(switch-to-buffer-other-window, switch-to-buffer-other-frame):
Mention 'read-buffer' in the doc string.  (Bug#29389)

* doc/emacs/buffers.texi (Select Buffer): Add a cross-reference to
where 'read-buffer-completion-ignore-case' is documented.
2017-11-24 15:58:00 +02:00
Eli Zaretskii
eea4e9194c Improve documentation of self-insert-uses-region-functions
* lisp/simple.el (self-insert-uses-region-functions): Clarify the
doc string.
* lisp/delsel.el (delete-selection-uses-region-p): Mention
'self-insert-command' in the doc string.  (Bug#29373)

* doc/lispref/text.texi (Commands for Insertion): Mention
'self-insert-uses-region-functions'.
* doc/lispref/modes.texi (Keymaps and Minor Modes): Add a
cross-reference to "Commands for Insertion".
2017-11-24 12:49:04 +02:00
Eli Zaretskii
1d0dbdff6c Reorder type predicates in ELisp manual
* doc/lispref/objects.texi (Type Predicates): Restore alphabetical
order of listed predicates.  (Bug#29411)
2017-11-24 10:07:40 +02:00
Glenn Morris
8e40429c96 ; Fix some doc typos 2017-11-22 17:52:11 -05:00
Gemini Lasswell
93304e3115 Improve documentation of Edebug and macros
* doc/lispref/edebug.texi (Instrumenting Macro Calls): Improve
discussion of when it might be necessary to find and evaluate macro
specifications before instrumenting.
(Specification List): Clarify what "defining form" means to Edebug
and when 'def-form' or 'def-body' should be used instead of 'form'
or 'body'.
2017-11-13 13:22:39 -08:00
Paul Eggert
5d68dc9a2f Change vectorlike from struct to union
* src/lisp.h (vectorlike_headed): Change from struct to union.
All uses changed.  Since it has only one member, this does not
change semantics.  This is designed to simplify future changes
needed to fix bugs like Bug#29040.  All uses changed.
2017-11-13 10:16:51 -08:00