emacs-elpa-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[elpa] externals/compat 97726c2cf7 4/5: compat.texi: Formatting


From: ELPA Syncer
Subject: [elpa] externals/compat 97726c2cf7 4/5: compat.texi: Formatting
Date: Wed, 24 May 2023 05:58:00 -0400 (EDT)

branch: externals/compat
commit 97726c2cf7ee05b88345831742560764dad8e9d0
Author: Daniel Mendler <mail@daniel-mendler.de>
Commit: Daniel Mendler <mail@daniel-mendler.de>

    compat.texi: Formatting
---
 compat.texi | 77 +++++++++++++++++++++++++++++++------------------------------
 1 file changed, 39 insertions(+), 38 deletions(-)

diff --git a/compat.texi b/compat.texi
index a4a7c0d7dc..6db8bc88b7 100644
--- a/compat.texi
+++ b/compat.texi
@@ -683,10 +683,10 @@ the results (which must be lists), by altering the 
results (using
 @c copied from lispref/symbols.texi
 @defun gensym &optional prefix
 This function returns a symbol using @code{make-symbol}, whose name is
-made by appending @code{gensym-counter} to @var{prefix} and incrementing
-that counter, guaranteeing that no two calls to this function will
-generate a symbol with the same name.  The prefix defaults to
-@code{"g"}.
+made by appending @code{gensym-counter} to @var{prefix} and
+incrementing that counter, guaranteeing that no two calls to this
+function will generate a symbol with the same name.  The prefix
+defaults to @code{"g"}.
 @end defun
 
 @defvar gensym-counter
@@ -771,8 +771,8 @@ file is created in the directory returned by the function
 
 @c based on lisp/files.el
 @defvar mounted-file-systems
-A regular expression matching files names that are probably on a mounted
-file system.
+A regular expression matching files names that are probably on a
+mounted file system.
 @end defvar
 
 @c copied from lispref/fiels.texi
@@ -815,11 +815,11 @@ does not include a bug that was observed with Emacs 26 
(see
 
 @c copied from lispref/files.texi
 @defun file-local-name filename
-This function returns the @emph{local part} of @var{filename}.  This is
-the part of the file's name that identifies it on the remote host, and
-is typically obtained by removing from the remote file name the parts
-that specify the remote host and the method of accessing it.  For
-example:
+This function returns the @emph{local part} of @var{filename}.  This
+is the part of the file's name that identifies it on the remote host,
+and is typically obtained by removing from the remote file name the
+parts that specify the remote host and the method of accessing it.
+For example:
 
 @smallexample
 (file-local-name "/ssh:@var{user}@@@var{host}:/foo/bar") @result{}
@@ -993,8 +993,8 @@ This function returns the first association for @var{key} in
 (@pxref{Equality Predicates,,,elisp}).  If @var{testfn} is a function,
 it is called with two arguments: the @sc{car} of an element from
 @var{alist} and @var{key}.  The function returns @code{nil} if no
-association in @var{alist} has a @sc{car} equal to @var{key}, as tested
-by @var{testfn}.
+association in @var{alist} has a @sc{car} equal to @var{key}, as
+tested by @var{testfn}.
 
 @xref{Association Lists,,,elisp}.
 
@@ -1020,11 +1020,11 @@ argument @var{absolute}.
 @defun compat-call@ alist-get key alist &optional default remove testfn
 @xref{Association Lists,,,elisp}.  This function is similar to
 @code{assq}.  It finds the first association @w{@code{(@var{key}
-. @var{value})}} by comparing @var{key} with @var{alist} elements, and,
-if found, returns the @var{value} of that association.  If no
-association is found, the function returns @var{default}.  Comparison of
-@var{key} against @var{alist} elements uses the function specified by
-@var{testfn}, defaulting to @code{eq}.
+. @var{value})}} by comparing @var{key} with @var{alist} elements,
+and, if found, returns the @var{value} of that association.  If no
+association is found, the function returns @var{default}.  Comparison
+of @var{key} against @var{alist} elements uses the function specified
+by @var{testfn}, defaulting to @code{eq}.
 
 @xref{Association Lists,,,elisp,}.
 
@@ -1171,7 +1171,8 @@ causes it to evaluate @code{help-form} and display the 
result.
 @defun bignump object
 This predicate tests whether its argument is a large integer, and
 returns @code{t} if so, @code{nil} otherwise.  Unlike small integers,
-large integers can be @code{=} or @code{eql} even if they are not @code{eq}.
+large integers can be @code{=} or @code{eql} even if they are not
+@code{eq}.
 @end defun
 
 @c copied from lispref/numbers.texi
@@ -1606,10 +1607,11 @@ suffixes are @code{k}, @code{M}, @code{G}, @code{T}, 
etc.
 @end itemize
 
 The compatibility version handles the optional third (@var{space}) and
-forth (@var{unit}) arguments.  The argument @var{space} can be a string
-that is placed between the number and the unit.  The argument @var{unit}
-determines the unit to use.  By default it will be an empty string,
-unless @var{flavor} is @code{iec}, in which case it will be @code{B}.
+forth (@var{unit}) arguments.  The argument @var{space} can be a
+string that is placed between the number and the unit.  The argument
+@var{unit} determines the unit to use.  By default it will be an empty
+string, unless @var{flavor} is @code{iec}, in which case it will be
+@code{B}.
 @end defun
 
 @c copied from lispref/lists.texi
@@ -1724,8 +1726,8 @@ Return the position of the first instance of @var{needle} 
in
 @var{haystack}, both of which are strings.  If @var{start-pos} is
 non-@code{nil}, start searching from that position in @var{needle}.
 Return @code{nil} if no match was found.  This function only considers
-the characters in the strings when doing the comparison; text properties
-are ignored.  Matching is always case-sensitive.
+the characters in the strings when doing the comparison; text
+properties are ignored.  Matching is always case-sensitive.
 @end defun
 
 @c copied from lispref/sequences.texi
@@ -1758,13 +1760,13 @@ didn't end with a slash.
 @end group
 @end example
 
-A @var{directory} or components that are @code{nil} or the empty string
-are ignored---they are filtered out first and do not affect the results
-in any way.
+A @var{directory} or components that are @code{nil} or the empty
+string are ignored---they are filtered out first and do not affect the
+results in any way.
 
 This is almost the same as using @code{concat}, but @var{dirname} (and
-the non-final components) may or may not end with slash characters, and
-this function will not double those characters.
+the non-final components) may or may not end with slash characters,
+and this function will not double those characters.
 @end defun
 
 @c based on src/alloc.c
@@ -1943,15 +1945,14 @@ Remove the final newline, if any, from @var{string}.
 
 @c based on lispref/variables.texi
 @defmac named-let name bindings &rest body
-This special form is a looping construct inspired from the
-Scheme language.  It is similar to @code{let}: It binds the variables in
+This special form is a looping construct inspired from the Scheme
+language.  It is similar to @code{let}: It binds the variables in
 @var{bindings}, and then evaluates @var{body}.  However,
-@code{named-let} also binds @var{name} to a
-local function whose formal arguments are the variables in @var{bindings}
-and whose body is @var{body}.  This allows @var{body} to call itself
-recursively by calling
-@var{name}, where the arguments passed to @var{name} are used as the
-new values of the bound variables in the recursive invocation.
+@code{named-let} also binds @var{name} to a local function whose
+formal arguments are the variables in @var{bindings} and whose body is
+@var{body}.  This allows @var{body} to call itself recursively by
+calling @var{name}, where the arguments passed to @var{name} are used
+as the new values of the bound variables in the recursive invocation.
 
 Recursive calls to @var{name} that occur in @emph{tail positions} in
 @var{body} are guaranteed to be optimized as @emph{tail calls}, which



reply via email to

[Prev in Thread] Current Thread [Next in Thread]