1
0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-12-19 10:22:27 +00:00

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)
This commit is contained in:
Eli Zaretskii 2018-04-13 16:44:05 +03:00
parent febac2796b
commit 6bdcaec885
7 changed files with 27 additions and 25 deletions

View File

@ -739,7 +739,7 @@ DEFUN ("foo", Ffoo, Sfoo, 0, UNEVALLED, 0
"(list (read-char-by-name \"Insert character: \")\
(prefix-numeric-value current-prefix-arg)\
t))",
doc: /* @dots{} /*)
doc: /* @dots{} */)
@end group
@end example
@ -769,7 +769,7 @@ this:
@example
@group
DEFUN ("bar", Fbar, Sbar, 0, UNEVALLED, 0
doc: /* @dots{} /*
doc: /* @dots{} */
attributes: @var{attr1} @var{attr2} @dots{})
@end group
@end example

View File

@ -1388,9 +1388,10 @@ similar to the code generated by the @code{define-minor-mode} macro):
@example
(interactive (list (or current-prefix-arg 'toggle)))
(let ((enable (if (eq arg 'toggle)
(not foo-mode) ; @r{this mode's mode variable}
(> (prefix-numeric-value arg) 0))))
(let ((enable
(if (eq arg 'toggle)
(not foo-mode) ; @r{this is the mode's mode variable}
(> (prefix-numeric-value arg) 0))))
(if enable
@var{do-enable}
@var{do-disable}))
@ -3375,7 +3376,7 @@ easy to add the @code{font-lock-multiline} property by hand.
The @code{font-lock-multiline} property is meant to ensure proper
refontification; it does not automatically identify new multiline
constructs. Identifying the requires that Font Lock mode operate on
constructs. Identifying them requires that Font Lock mode operate on
large enough chunks at a time. This will happen by accident on many
cases, which may give the impression that multiline constructs magically
work. If you set the @code{font-lock-multiline} variable

View File

@ -569,9 +569,9 @@ The optional argument @var{cur-col} specifies the current column when
the function is called. This is the window-relative horizontal
coordinate of point, measured in units of font width of the frame's
default face. Providing it speeds up the function, especially in very
long lines, because it doesn't have to go back in the buffer in order
to determine the current column. Note that @var{cur-col} is also
counted from the visual start of the line.
long lines, because the function doesn't have to go back in the buffer
in order to determine the current column. Note that @var{cur-col} is
also counted from the visual start of the line.
@end defun
@defun count-screen-lines &optional beg end count-final-newline window

View File

@ -728,7 +728,7 @@ to every element of @var{sequence} returns non-@code{nil}.
@result{} t
@end group
@group
(seq-some #'numberp [2 4 "6"])
(seq-every-p #'numberp [2 4 "6"])
@result{} nil
@end group
@end example
@ -854,7 +854,7 @@ it is a function of two arguments to use instead of the default @code{equal}.
@end group
@group
(seq-uniq '(1 2 2.0 1.0) #'=)
@result{} [1 2]
@result{} (1 2)
@end group
@end example
@end defun

View File

@ -1612,7 +1612,7 @@ that the line ends exactly at @code{fill-column}. It returns
The argument @var{how}, if non-@code{nil} specifies explicitly the style
of justification. It can be @code{left}, @code{right}, @code{full},
@code{center}, or @code{none}. If it is @code{t}, that means to do
@code{center}, or @code{none}. If it is @code{t}, that means to
follow specified justification style (see @code{current-justification},
below). @code{nil} means to do full justification.
@ -2976,7 +2976,7 @@ If any text in the region already has a non-@code{nil} @code{face} property,
those face(s) are retained. This function sets the @code{face}
property to a list of faces, with @var{face} as the first element (by
default) and the pre-existing faces as the remaining elements. If the
optional argument @var{append} is non-@code{nil}, @var{face} is
optional argument @var{appendp} is non-@code{nil}, @var{face} is
appended to the end of the list instead. Note that in a face list,
the first occurring value for each attribute takes precedence.
@ -4297,10 +4297,10 @@ read register names use this function.
This function can be used to transpose stretches of text:
@defun transpose-regions start1 end1 start2 end2 &optional leave-markers
This function exchanges two nonoverlapping portions of the buffer.
Arguments @var{start1} and @var{end1} specify the bounds of one portion
and arguments @var{start2} and @var{end2} specify the bounds of the
other portion.
This function exchanges two nonoverlapping portions of the buffer (if
they overlap, the function signals an error). Arguments @var{start1}
and @var{end1} specify the bounds of one portion and arguments
@var{start2} and @var{end2} specify the bounds of the other portion.
Normally, @code{transpose-regions} relocates markers with the transposed
text; a marker previously positioned within one of the two transposed

View File

@ -1004,12 +1004,13 @@ affect, nor be affected by, any uses of the same variable symbol
elsewhere in the program.
@item
Otherwise, define the variable with @code{defvar}, @code{defconst}, or
@code{defcustom}. @xref{Defining Variables}. Usually, the definition
should be at top-level in an Emacs Lisp file. As far as possible, it
should include a documentation string which explains the meaning and
purpose of the variable. You should also choose the variable's name
to avoid name conflicts (@pxref{Coding Conventions}).
Otherwise, define the variable with @code{defvar}, @code{defconst}
(@pxref{Defining Variables}), or @code{defcustom} (@pxref{Variable
Definitions}). Usually, the definition should be at top-level in an
Emacs Lisp file. As far as possible, it should include a
documentation string which explains the meaning and purpose of the
variable. You should also choose the variable's name to avoid name
conflicts (@pxref{Coding Conventions}).
Then you can bind the variable anywhere in a program, knowing reliably
what the effect will be. Wherever you encounter the variable, it will
@ -1024,7 +1025,7 @@ variables like @code{case-fold-search}:
@group
(defun search-for-abc ()
"Search for the string \"abc\", ignoring case differences."
(let ((case-fold-search nil))
(let ((case-fold-search t))
(re-search-forward "abc")))
@end group
@end example

View File

@ -904,7 +904,7 @@ include mode and header line and a bottom divider, if any.
If @var{window} is part of a horizontal combination and the value of the
option @code{fit-window-to-buffer-horizontally} (see below) is
non-@code{nil}, this function adjusts @var{window}'s height. The new
non-@code{nil}, this function adjusts @var{window}'s width. The new
width of @var{window} is calculated from the maximum length of its
buffer's lines that follow the current start position of @var{window}.
The optional argument @var{max-width} specifies a maximum width and