]> git.eshelyaron.com Git - emacs.git/commitdiff
Fix some Texinfo markup in manuals
authorBasil L. Contovounesios <contovob@tcd.ie>
Mon, 12 Jun 2023 13:42:31 +0000 (14:42 +0100)
committerBasil L. Contovounesios <contovob@tcd.ie>
Tue, 13 Jun 2023 14:29:06 +0000 (15:29 +0100)
* doc/emacs/macos.texi (Mac / GNUstep Customization):
* doc/lispintro/emacs-lisp-intro.texi (condition-case):
* doc/lispref/control.texi (pcase Macro):
* doc/lispref/debugging.texi (Internals of Debugger):
* doc/lispref/internals.texi (Building Emacs):
* doc/lispref/modes.texi (Imenu):
(Parser-based Font Lock, Parser-based Indentation):
* doc/lispref/parsing.texi (Retrieving Nodes, Tree-sitter C API):
* doc/lispref/processes.texi (Network, Bindat Types):
* doc/lispref/searching.texi (Rx Functions):
* doc/lispref/text.texi (Replacing):
* doc/lispref/windows.texi (Textual Scrolling):
* doc/misc/calc.texi (Killing From Stack, Customizing Calc):
* doc/misc/cc-mode.texi (Misc Font Locking, List Line-Up):
* doc/misc/ede.texi (ede-cpp-root-project)
(ede-proj-target-makefile, ede-sourcecode):
* doc/misc/ert.texi (Running Tests in Batch Mode):
* doc/misc/eudc.texi (Emacs-only Configuration, The Server Hotlist):
* doc/misc/eww.texi (Advanced):
* doc/misc/flymake.texi (Starting Flymake)
(Proc customization variables):
* doc/misc/tramp.texi (File name completion):
* doc/misc/gnus.texi (Summary Buffer Lines, Gnus Registry Setup)
(Fancy splitting to parent, Customizing the IMAP Connection)
(Mail Source Specifiers, Agent as Cache): Consistently mark up nil
and t as @code.  Also fix the markup and wording of some surrounding
text (bug#64016).

* doc/lispref/display.texi (SVG Images, Icons):
* doc/lispref/modes.texi (Customizing Keywords): Prefer ASCII
apostrophe over Unicode right single quotation mark.

21 files changed:
doc/emacs/macos.texi
doc/lispintro/emacs-lisp-intro.texi
doc/lispref/control.texi
doc/lispref/debugging.texi
doc/lispref/display.texi
doc/lispref/internals.texi
doc/lispref/modes.texi
doc/lispref/parsing.texi
doc/lispref/processes.texi
doc/lispref/searching.texi
doc/lispref/text.texi
doc/lispref/windows.texi
doc/misc/calc.texi
doc/misc/cc-mode.texi
doc/misc/ede.texi
doc/misc/ert.texi
doc/misc/eudc.texi
doc/misc/eww.texi
doc/misc/flymake.texi
doc/misc/gnus.texi
doc/misc/tramp.texi

index 9f2c4721cab3cff5f569ab97a87542fc175511d1..18811291a9ea7f4167364cb40592d8eb0b2cd7de 100644 (file)
@@ -177,10 +177,10 @@ These variables only apply to macOS 10.7 (Lion) and above.
 @vindex ns-use-mwheel-acceleration
 @item ns-use-mwheel-acceleration
 This variable controls whether Emacs ignores the system mousewheel
-acceleration.  When nil each `click' of the mousewheel will correspond
-exactly with one mousewheel event.  When non-@code{nil}, the default, each
-`click' may correspond with more than one mousewheel event, depending
-on the user's input.
+acceleration.  When @code{nil} each `click' of the mousewheel will
+correspond exactly with one mousewheel event.  When non-@code{nil},
+the default, each `click' may correspond with more than one mousewheel
+event, depending on the user's input.
 
 @vindex ns-use-mwheel-momentum
 @item ns-use-mwheel-momentum
@@ -194,8 +194,8 @@ while after the user has lifted their fingers off the trackpad.
 This variable controls the sensitivity of scrolling with the trackpad.
 Apple trackpads scroll by pixels, not lines, so Emacs converts the
 system's pixel values into lines.  When set to a number, this variable
-sets the number of pixels Emacs will consider as one line.  When nil
-or a non-number the default line height is used.
+sets the number of pixels Emacs will consider as one line.  When
+@code{nil} or a non-number the default line height is used.
 
 Setting a lower number makes the trackpad more sensitive, and a higher
 number makes the trackpad less sensitive.
index 6447ff74bc9011a8c05f8fd8b55fa3c336c31083..37ef6133fb4771648015ee9d86337f6806009123 100644 (file)
@@ -8115,10 +8115,9 @@ than one error handler.  When an error occurs, the first applicable
 handler is run.
 
 Lastly, the first argument to the @code{condition-case} expression,
-the @var{var} argument, is sometimes bound to a variable that
-contains information about the error.  However, if that argument is
-nil, as is the case in @code{kill-region}, that information is
-discarded.
+the @var{var} argument, is sometimes bound to a variable that contains
+information about the error.  However, if that argument is @code{nil},
+as is the case in @code{kill-region}, that information is discarded.
 
 @need 1200
 In brief, in the @code{kill-region} function, the code
index e621a28acdacf4f79b4745b0e0be14029452cb47..3aee9dd80e44849b224eb742c03cefc7049b2c7e 100644 (file)
@@ -694,7 +694,7 @@ contain the following constructs:
 @item (let @var{ref} @var{rx-expr}@dots{})
 Bind the symbol @var{ref} to a submatch that matches
 @var{rx-expr}@enddots{}.  @var{ref} is bound in @var{body-forms} to
-the string of the submatch or nil, but can also be used in
+the string of the submatch or @code{nil}, but can also be used in
 @code{backref}.
 
 @item (backref @var{ref})
index d2e4f687f64f49fe9b052de48ce9f451aa0cd812..ea11d2d8d9c92923e975fe1c5f464c2487fc5a3c 100644 (file)
@@ -740,7 +740,7 @@ of @code{debug} (@pxref{Invoking the Debugger}).
 @cindex call stack
 This function prints a trace of Lisp function calls currently active.
 The trace is identical to the one that @code{debug} would show in the
-@file{*Backtrace*} buffer.  The return value is always nil.
+@file{*Backtrace*} buffer.  The return value is always @code{nil}.
 
 In the following example, a Lisp expression calls @code{backtrace}
 explicitly.  This prints the backtrace to the stream
index f1b4b00188927d7d1feda700a31345df33b0dac6..7655ca8839d7f24d7637a42b43343ffe868855bc 100644 (file)
@@ -6530,7 +6530,7 @@ specified, draw a polyline.
 @deffn Command horizontal-lineto x-coordinates
 Draw a horizontal line from the current point to the first element in
 @var{x-coordinates}.  Specifying multiple coordinates is possible,
-although usually this doesn’t make sense.
+although this usually doesn't make sense.
 
 @lisp
 (svg-path svg '((moveto ((100 . 200)))
@@ -6554,7 +6554,7 @@ Using the first element in @var{coordinate-sets}, draw a cubic Bézier
 curve from the current point.  If there are multiple coordinate sets,
 draw a polybezier.  Each coordinate set is a list of the form
 @code{(@var{x1} @var{y1} @var{x2} @var{y2} @var{x} @var{y})}, where
-@w{(@var{x}, @var{y})} is the curves end point.  @w{(@var{x1},
+@w{(@var{x}, @var{y})} is the curve's end point.  @w{(@var{x1},
 @var{y1})} and @w{(@var{x2}, @var{y2})} are control points at the
 beginning and at the end, respectively.
 
@@ -6571,7 +6571,7 @@ Using the first element in @var{coordinate-sets}, draw a cubic Bézier
 curve from the current point.  If there are multiple coordinate sets,
 draw a polybezier.  Each coordinate set is a list of the form
 @code{(@var{x2} @var{y2} @var{x} @var{y})}, where @w{(@var{x},
-@var{y})} is the curves end point and @w{(@var{x2}, @var{y2})} is the
+@var{y})} is the curve's end point and @w{(@var{x2}, @var{y2})} is the
 corresponding control point.  The first control point is the
 reflection of the second control point of the previous command
 relative to the current point, if that command was @command{curveto}
@@ -6591,7 +6591,7 @@ Using the first element in @var{coordinate-sets}, draw a quadratic
 Bézier curve from the current point.  If there are multiple coordinate
 sets, draw a polybezier.  Each coordinate set is a list of the form
 @code{(@var{x1} @var{y1} @var{x} @var{y})}, where @w{(@var{x},
-@var{y})} is the curves end point and @w{(@var{x1}, @var{y1})} is the
+@var{y})} is the curve's end point and @w{(@var{x1}, @var{y1})} is the
 control point.
 
 @lisp
@@ -6608,7 +6608,7 @@ control point.
 Using the first element in @var{coordinate-sets}, draw a quadratic
 Bézier curve from the current point.  If there are multiple coordinate
 sets, draw a polybezier.  Each coordinate set is a list of the form
-@code{(@var{x} @var{y})}, where @w{(@var{x}, @var{y})} is the curves
+@code{(@var{x} @var{y})}, where @w{(@var{x}, @var{y})} is the curve's
 end point.  The control point is the reflection of the control point
 of the previous command relative to the current point, if that command
 was @command{quadratic-bezier-curveto} or
@@ -7269,7 +7269,7 @@ window.
 @item :width
 This is only valid for @code{image} icons, and can be either a number
 (which specifies the width in pixels), or the symbol @code{font},
-which will use the width in pixels of the current buffers default
+which will use the width in pixels of the current buffer's default
 face font.
 @end table
 
index e896c69bc38d6334f2a0d77af028484093723632..2dc1f1c6116ef32e07d7bfd5776392241ddd6757 100644 (file)
@@ -248,7 +248,7 @@ time it took to restore the Emacs state.  The value is an alist
 where @var{file} is the name of the dump file, and @var{time} is the
 time in seconds it took to restore the state from the dump file.
 If the current session was not restored from a dump file, the
-value is nil.
+value is @code{nil}.
 @end defun
 
 @node Pure Storage
index cb491d52c5038373916929bb985bb3c6edb0b4ac..bd09386de2bb48d92f3ec44d003529cc38cce4ba 100644 (file)
@@ -2921,13 +2921,13 @@ nodes that belong to @var{category}.  @var{pred} should be either
 return non-@code{nil} if the node is a valid node for @var{category},
 or @code{nil} if not.
 
-@var{category} could also be @code{nil}.  In which case the entries
+@var{category} could also be @code{nil}, in which case the entries
 matched by @var{regexp} and @var{pred} are not grouped under
 @var{category}.
 
-@var{name-fn} should be either @var{nil} or a function that takes a
+@var{name-fn} should be either @code{nil} or a function that takes a
 defun node and returns the name of that defun, e.g., the function name
-for a function definition.  If @var{name-fn} is @var{nil},
+for a function definition.  If @var{name-fn} is @code{nil},
 @code{treesit-defun-name} (@pxref{Tree-sitter Major Modes}) is used
 instead.
 
@@ -3446,7 +3446,7 @@ This condition matches any element of Font Lock keywords for which
 non-@code{nil}.
 
 @item @code{(not @var{condition})}
-This matches if @var{condition} doesnt.
+This matches if @var{condition} doesn't.
 
 @item @code{(and @var{condition} @dots{})}
 This matches if each of the @var{condition}s matches.
@@ -4145,9 +4145,9 @@ Other keywords are optional:
 
 @multitable @columnfractions .15 .15 .6
 @headitem Keyword @tab Value @tab Description
-@item @code{:override} @tab nil
+@item @code{:override} @tab @code{nil}
 @tab If the region already has a face, discard the new face
-@item @tab t @tab Always apply the new face
+@item @tab @code{t} @tab Always apply the new face
 @item @tab @code{append} @tab Append the new face to existing ones
 @item @tab @code{prepend} @tab Prepend the new face to existing ones
 @item @tab @code{keep} @tab Fill-in regions without an existing face
@@ -5153,10 +5153,10 @@ This anchor is a function that is called with 3 arguments: @var{node},
 @var{parent}, and @var{bol}.  It tries to go to the beginning of the
 previous non-empty line, and matches @code{adaptive-fill-regexp}.  If
 there is a match, this function returns the end of the match,
-otherwise it returns nil.  However, if the current line begins with a
-prefix (e.g., ``-''), return the beginning of the prefix of the
-previous line instead, so that the two prefixes aligns.  This anchor
-is useful for a @code{indent-relative}-like indent behavior for block
+otherwise it returns @code{nil}.  However, if the current line begins
+with a prefix (e.g., ``-''), return the beginning of the prefix of the
+previous line instead, so that the two prefixes align.  This anchor is
+useful for an @code{indent-relative}-like indent behavior for block
 comments.
 
 @end ftable
index b70f953f8ed687636eb375803304206919d5fa77..7e77af0a5cf639998d07bc72e249e23eadedb97d 100644 (file)
@@ -656,7 +656,7 @@ it, or query for information about this node.
 This function returns the immediate parent of @var{node}.
 
 If @var{node} is more than 1000 levels deep in a parse tree, the
-return value is undefined.  Currently it returns @var{nil}, but that
+return value is undefined.  Currently it returns @code{nil}, but that
 could change in the future.
 @end defun
 
@@ -842,7 +842,7 @@ the number of levels to go down from @var{root}.  If @var{depth} is
 
 Each node in the returned tree looks like
 @w{@code{(@var{tree-sitter-node} . (@var{child} @dots{}))}}.  The
-@var{tree-sitter-node} of the root of this tree will be nil if
+@var{tree-sitter-node} of the root of this tree will be @code{nil} if
 @var{root} doesn't match @var{predicate}.  If no node matches
 @var{predicate}, the function returns @code{nil}.
 @end defun
@@ -866,7 +866,7 @@ the argument and returns a boolean that indicates a match.  If no
 parent satisfies @var{pred}, this function returns @code{nil}.
 
 Normally this function only looks at the parents of @var{node} but not
-@var{node} itself. But if @var{include-node} is non-@var{nil}, this
+@var{node} itself.  But if @var{include-node} is non-@code{nil}, this
 function returns @var{node} if @var{node} satisfies @var{pred}.
 @end defun
 
@@ -1880,7 +1880,7 @@ convenient and idiomatic:
 Instead of using byte positions, the Emacs Lisp API uses character
 positions.
 @item
-Null nodes are converted to nil.
+Null nodes are converted to @code{nil}.
 @end itemize
 
 Below is the correspondence between all C API functions and their
index c901215d35d0fbe933b4b7c7c70e354829676e07..43c794104b884135a1f4fcc3c53f592dff13e350 100644 (file)
@@ -2662,7 +2662,7 @@ naming the certificate key file and certificate file itself, or
 Library}).  Only used for @acronym{TLS} or @acronym{STARTTLS}.  To
 enable automatic queries of @code{auth-source} when
 @code{:client-certificate} is not specified customize
-@code{network-stream-use-client-certificates} to t.
+@code{network-stream-use-client-certificates} to @code{t}.
 
 @item :return-list @var{cons-or-nil}
 The return value of this function.  If omitted or @code{nil}, return a
@@ -3575,7 +3575,7 @@ and @code{#x1c} @code{#x28} to @w{@code{(3 5 10 11 12)}}.
 @item fill @var{len}
 @var{len} bytes used as a mere filler.  In packing, these bytes are
 left unchanged, which normally means they remain zero.
-When unpacking, this just returns nil.
+When unpacking, this just returns @code{nil}.
 
 @item align @var{len}
 Same as @code{fill} except the number of bytes is that needed to skip
index 06b3556c8559c1b48ce4e19e3274e73e0eb5699a..b8d9094b28db4f1680fc97ec42b107c40db1a72b 100644 (file)
@@ -1568,7 +1568,7 @@ used, a Lisp expression that evaluates to a string.  Example:
 
 @defun rx-to-string rx-expr &optional no-group
 Translate @var{rx-expr} to a string regexp which is returned.
-If @var{no-group} is absent or nil, bracket the result in a
+If @var{no-group} is absent or @code{nil}, bracket the result in a
 non-capturing group, @samp{\(?:@dots{}\)}, if necessary to ensure that
 a postfix operator appended to it will apply to the whole expression.
 Example:
index f15b3c33e0c0f9c18d4d22ca88b2bb6f6982ecb8..0f43f3d464abf717836b00df200cbc5229ab2e17 100644 (file)
@@ -4764,9 +4764,9 @@ and exceeded, it will fall back to @code{delete-region} and
 the actual costs exceed this limit, heuristics are used to provide a
 faster but suboptimal solution.  The default value is 1000000.
 
-@code{replace-buffer-contents} returns t if a non-destructive
+@code{replace-buffer-contents} returns @code{t} if a non-destructive
 replacement could be performed.  Otherwise, i.e., if @var{max-secs}
-was exceeded, it returns nil.
+was exceeded, it returns @code{nil}.
 @end deffn
 
 @defun replace-region-contents beg end replace-fn &optional max-secs max-costs
index 0196ed0e813c033e927fa476ab369123fe9ac115..a49e63e49de7fcfce4464ca00c49e6fbaa566371 100644 (file)
@@ -5569,7 +5569,7 @@ non-@code{nil}, this function may redraw the frame, according to the
 value of @code{recenter-redisplay}.  Thus, omitting the second
 argument can be used to countermand the effect of
 @code{recenter-redisplay} being non-@code{nil}.  Interactive calls
-pass non-‘nil’ for @var{redisplay}.
+pass non-@code{nil} for @var{redisplay}.
 
 When @code{recenter} is called interactively, @var{count} is the raw
 prefix argument.  Thus, typing @kbd{C-u} as the prefix sets the
index 3b525996d6f7d3a90c6bf7f80b5a4345047bbd5f..3ba1a9d4d150cfa1438a45cd2a1bbc48ac340b32 100644 (file)
@@ -29875,10 +29875,10 @@ with no argument copies only the number itself into the kill ring, whereas
 @kbd{C-k} with a prefix argument of 1 copies the number with its trailing
 newline.
 
-You can customize @code{calc-kill-line-numbering} to nil to exclude
-line numbering from kills and copies made by @code{calc-kill} and
-@code{calc-copy-as-kill}.  This option does not affect calc kill and
-copy commands which operate on the region, as that would not make
+You can customize @code{calc-kill-line-numbering} to @code{nil} to
+exclude line numbering from kills and copies made by @code{calc-kill}
+and @code{calc-copy-as-kill}.  This option does not affect calc kill
+and copy commands which operate on the region, as that would not make
 sense.
 
 @node Yanking Into Stack
@@ -35590,11 +35590,11 @@ The default value of @code{calc-note-threshold} is 1.
 See @ref{Displaying Selections}.@*
 The variable @code{calc-highlight-selections-with-faces}
 determines how selected sub-formulas are distinguished.
-If @code{calc-highlight-selections-with-faces} is nil, then
+If @code{calc-highlight-selections-with-faces} is @code{nil}, then
 a selected sub-formula is distinguished either by changing every
 character not part of the sub-formula with a dot or by changing every
 character in the sub-formula with a @samp{#} sign.
-If @code{calc-highlight-selections-with-faces} is t,
+If @code{calc-highlight-selections-with-faces} is @code{t},
 then a selected sub-formula is distinguished either by displaying the
 non-selected portion of the formula with @code{calc-nonselected-face}
 or by displaying the selected sub-formula with
index 3a8086198680c6b7cf3f1e1eb40670229658eb2b..888a51e0e1587a664513f9d0b337643ded1594f0 100644 (file)
@@ -2191,10 +2191,10 @@ foo& bar
 
 @defvar c-asymmetry-fontification-flag
 @vindex asymmetry-fontification-flag @r{(c-)}
-When @code{c-asymmetry-fontification-flag} is non-@code{nil} (which it is by
-default), code like the above, with white space either before or after
-the operator, but not both, is fontified as a declaration.  When the
-variable is nil, such a construct gets the default face.
+When @code{c-asymmetry-fontification-flag} is non-@code{nil} (which it
+is by default), code like the above, with white space either before or
+after the operator, but not both, is fontified as a declaration.  When
+the variable is @code{nil}, such a construct gets the default face.
 @end defvar
 
 When the construct is an expression there will often be white space
@@ -5998,7 +5998,7 @@ three syntactic symbols, @code{arglist-cont-nonempty},
 List Symbols}).
 
 This function is intended for use in a list.  If the construct being
-analyzed isn't like the preceding, the function returns nil.
+analyzed isn't like the preceding, the function returns @code{nil}.
 Otherwise it returns the function
 @code{c-lineup-arglist-intro-after-paren}, which the caller then uses
 to perform indentation.
@@ -6042,8 +6042,8 @@ also has a syntactic element with the symbol @code{brace-list-entry}
 (@pxref{Brace List Symbols}).
 
 This function is intended for use in a list.  If the above structure
-isn't present, the function returns nil, allowing a different offset
-specification to indent the line.
+isn't present, the function returns @code{nil}, allowing a different
+offset specification to indent the line.
 
 @workswith{} @code{brace-list-intro}.
 @end defun
@@ -6085,8 +6085,8 @@ returning the symbol @code{c-lineup-arglist-intro-after-paren}, which
 the caller then uses to perform the indentation.
 
 This function is intended for use in a list.  If the above structure
-isn't present, the function returns nil, allowing a different offset
-specification to indent the line.
+isn't present, the function returns @code{nil}, allowing a different
+offset specification to indent the line.
 
 @workswith{} @code{brace-list-intro}.
 @end defun
index e4ec72af5cdd4e51aef585a58f29816080fb4d76..d49d2296aa74bfcdfb3e740b59ee9634b0e9fcdc 100644 (file)
@@ -1896,19 +1896,19 @@ Make sure the @code{:file} is fully expanded.
 @end deffn
 
 @deffn Method ede-preprocessor-map :AFTER this
-Get the pre-processor map for project @var{THIS}.
+Get the pre-processor map for project @var{this}.
 @end deffn
 
 @deffn Method ede-cpp-root-header-file-p :AFTER proj name
-Non @code{nil} if in @var{PROJ} the filename @var{NAME} is a header.
+Non-@code{nil} if in @var{proj} the filename @var{name} is a header.
 @end deffn
 
 @deffn Method ede-system-include-path :AFTER this
-Get the system include path used by project @var{THIS}.
+Get the system include path used by project @var{this}.
 @end deffn
 
 @deffn Method ede-expand-filename-impl :AFTER proj name
-Within this project @var{PROJ}, find the file @var{NAME}.
+Within this project @var{proj}, find the file @var{name}.
 This knows details about or source tree.
 @end deffn
 
@@ -2796,7 +2796,7 @@ File name of generated Makefile.
 Type: @code{boolean} @*
 Default Value: @code{t}
 
-Non @code{nil} means the rule created is part of the all target.
+Non-@code{nil} means the rule created is part of the all target.
 Setting this to @code{nil} creates the rule to build this item, but does not
 include it in the @code{all:} rule.
 
@@ -3888,10 +3888,10 @@ themselves.
 Type: @code{boolean} @*
 Default Value: @code{nil}
 
-Non @code{nil} if this sourcecode type uses subdirectores.
-If sourcecode always lives near the target creating it, this should be nil.
-If sourcecode can, or typically lives in a subdirectory of the owning
-target, set this to t.
+Non-@code{nil} if this sourcecode type uses subdirectores.  If
+sourcecode always lives near the target creating it, this should be
+@code{nil}.  If sourcecode can, or typically lives in a subdirectory
+of the owning target, set this to @code{t}.
 
 @item :garbagepattern
 Type: @code{list} @*
index fd96fcf8b8c90ee5ea645b6c3132dec6a794b97a..a6b62a058f2d4e6fa7c8b2444083ab12e502b57d 100644 (file)
@@ -409,13 +409,13 @@ emacs -batch -l ert -l my-tests.el \
 @end example
 
 @vindex ert-batch-backtrace-line-length
-Even modest settings for @code{print-level} and @code{print-length} can
-produce extremely long lines in backtraces, however, with attendant
-pauses in execution progress.  Set
-@code{ert-batch-backtrace-line-length} to t to use the value of
-@code{backtrace-line-length}, @code{nil} to stop any limitations on backtrace
-line lengths (that is, to get full backtraces), or a positive integer to
-limit backtrace line length to that number.
+Even modest settings for @code{print-level} and @code{print-length}
+can produce extremely long lines in backtraces, however, with
+attendant pauses in execution progress.  Set
+@code{ert-batch-backtrace-line-length} to @code{t} to use the value of
+@code{backtrace-line-length}, @code{nil} to stop any limitations on
+backtrace line lengths (that is, to get full backtraces), or a
+positive integer to limit backtrace line length to that number.
 
 @vindex ert-quiet
 By default, ERT in batch mode is quite verbose, printing a line with
index 743d7da946b8ccebd24026292c642a899547a4f8..d82dec971cdbf0969c76d58722ca2e31a6868c9a 100644 (file)
@@ -374,7 +374,7 @@ LDAP:
 Specifying the function @code{ldap-password-read} for @code{passwd}
 will cause Emacs to prompt interactively for the password.  The
 password will then be validated and cached, unless
-@code{password-cache} is nil.  You can customize
+@code{password-cache} is @code{nil}.  You can customize
 @code{password-cache-expiry} to control the duration for which the
 password is cached.  If you want to clear the cache, call
 @code{password-reset}.
@@ -1023,9 +1023,9 @@ current server to the list with the command @kbd{M-x
 eudc-bookmark-current-server}.  The list is contained in the variable
 @code{eudc-server-hotlist} which is stored in and retrieved from the
 file designated by @code{eudc-options-file}, or normal Emacs
-initialization if @code{eudc-ignore-options-file} is non-nil.  EUDC
-also provides a facility to edit the hotlist interactively (@pxref{The
-Hotlist Edit Buffer}).
+initialization if @code{eudc-ignore-options-file} is non-@code{nil}.
+EUDC also provides a facility to edit the hotlist interactively
+(@pxref{The Hotlist Edit Buffer}).
 
 The hotlist is also used to make queries on multiple servers
 successively (@pxref{Multi-server Queries}).  The order in which the
@@ -1041,18 +1041,18 @@ Add the current server to the hotlist of servers
 @end deffn
 
 @defvar eudc-ignore-options-file
-If non-nil, then EUDC ignores @code{eudc-options-file} and warns or
+If non-@code{nil}, EUDC ignores @code{eudc-options-file} and warns or
 issues an error when an attempt is made to use it.  Most users should
 set this, and keep their EUDC configuration in the main Emacs
-initialization file instead.  The separate eudc-options file has
-created confusion for users in the past.
+initialization file instead.  The separate @file{eudc-options} file
+has created confusion for users in the past.
 @end defvar
 
 @defvar eudc-options-file
 The name of a file where EUDC stores its internal variables (the
 hotlist and the current server).  EUDC will try to load that file upon
 initialization so, if you choose a file name different from the
-defaults @file{~/.emacs.d/eudc-options}, be sure to set this variable
+default @file{~/.emacs.d/eudc-options}, be sure to set this variable
 to the appropriate value @emph{before} EUDC is itself loaded.
 @end defvar
 
index bc556ed88e2779025fec3056bf8f14f1d2952b1c..1a5688b035891b60e525f6b0a1d7555572897379 100644 (file)
@@ -367,8 +367,8 @@ point positions or the actual Web page contents.
 The latter, however, tend to be overly large to preserve in the
 desktop file, so they get omitted, thus rendering the respective
 entries entirely equivalent.  By default, such duplicate entries are
-not saved.  Setting @code{eww-desktop-remove-duplicates} to nil will
-force EWW to save them anyway.
+not saved.  Setting @code{eww-desktop-remove-duplicates} to @code{nil}
+will force EWW to save them anyway.
 
 @vindex eww-restore-desktop
   Restoring EWW buffers' contents may prove to take too long to
index 03d296a1d428977f6a85347615429a47996cd1fb..c7c46896709296f18f7fbcc9b65a481c49af97bb 100644 (file)
@@ -115,11 +115,11 @@ Syntax checks happen ``on-the-fly''.  Each check is started whenever:
 @itemize @bullet
 @item
 @code{flymake-mode} is started, unless
-@code{flymake-start-on-flymake-mode} is nil;
+@code{flymake-start-on-flymake-mode} is @code{nil};
 
 @item
 the buffer is saved, unless @code{flymake-start-on-save-buffer} is
-nil;
+@code{nil};
 
 @item
 some changes were made to the buffer more than @code{0.5} seconds ago
@@ -876,13 +876,18 @@ Patterns for error/warning messages in the form @code{(regexp file-idx
 line-idx col-idx err-text-idx)}.  @xref{Parsing the output}.
 
 @item flymake-proc-diagnostic-type-pred
-A function to classify a diagnostic text as particular type of error.
-Should be a function taking an error text and returning a diagnostic
-symbol (@pxref{Flymake error types}).  If non-@code{nil} is returned but
-there is no such symbol in that table, a warning is assumed.  If nil
-is returned, an error is assumed.  Can also be a regular expression
-that should match only warnings.  This variable replaces the old
-@code{flymake-warning-re} and @code{flymake-warning-predicate}.
+A function to classify a diagnostic text as a particular type of
+error.  The value of this variable should be a function taking an
+error text and returning a diagnostic symbol (@pxref{Flymake error
+types}).  If it returns a non-@code{nil} value but there is no such
+symbol in that table, the text is interpreted as a warning.  If the
+function returns @code{nil}, the text is assumed to be an error.
+
+The value of this variable can alternatively be a regular expression
+that should match only warnings.
+
+This variable replaces the old @code{flymake-warning-re} and
+@code{flymake-warning-predicate}.
 
 @item flymake-proc-compilation-prevents-syntax-check
 A flag indicating whether compilation and syntax check of the same
index d77d4be1beeebb595a6b9c37b175c5f0ab1bc95c..e995469ee3de2d232f47c757a9333a51a1ed9c7a 100644 (file)
@@ -5014,14 +5014,14 @@ the @code{a} spec.
 @item L
 Number of lines in the article.
 @item Z
-Retrieval Score Value (RSV) of the article; nil if not in an nnselect
-group.
+Retrieval Score Value (RSV) of the article; @code{nil} if not in an
+nnselect group.
 @item G
-Originating group name of the article; nil if not in an nnselect
-group.
+Originating group name of the article; @code{nil} if not in an
+nnselect group.
 @item g
-Short form of the originating group name of the article; nil if not in
-an nnselect group.
+Short form of the originating group name of the article; @code{nil} if
+not in an nnselect group.
 @item c
 Number of characters in the article.  This specifier is not supported
 in some methods (like nnfolder).
@@ -14568,18 +14568,20 @@ requires using the @file{oauth2.el} library.)
 @vindex nnimap-expunge
 @item nnimap-expunge
 When to expunge deleted messages.  If @code{never}, deleted articles
-are marked with the IMAP @code{\\Delete} flag but not automatically
-expunged. If @code{immediately}, deleted articles are immediately expunged
-(this requires the server to support the UID EXPUNGE command). If
-@code{on-exit}, deleted articles are flagged, and all flagged articles are
-expunged when the group is closed.
-
-For backwards compatibility, this variable may also be set to t
-or nil. If the server supports UID EXPUNGE, both t and nil are
-equivalent to @code{immediately}. If the server does not support UID
-EXPUNGE nil is equivalent to @code{never}, while t will immediately
-expunge ALL articles that are currently flagged as deleted
-(i.e., potentially not only the article that was just deleted).
+are marked with the @acronym{IMAP} @code{\\Delete} flag but not
+automatically expunged.  If @code{immediately}, deleted articles are
+immediately expunged (this requires the server to support the
+@code{UID EXPUNGE} command).  If @code{on-exit}, deleted articles are
+flagged, and all flagged articles are expunged when the group is
+closed.
+
+For backwards compatibility, this variable may also be set to @code{t}
+or @code{nil}.  If the server supports @code{UID EXPUNGE}, both
+@code{t} and @code{nil} are equivalent to @code{immediately}.  If the
+server does not support @code{UID EXPUNGE}, @code{nil} is equivalent
+to @code{never}, while @code{t} will immediately expunge @emph{all}
+articles that are currently flagged as deleted (i.e., potentially not
+only the article that was just deleted).
 
 @vindex nnimap-streaming
 @item nnimap-streaming
@@ -15296,9 +15298,9 @@ Two example maildir mail sources:
 @end lisp
 
 @item imap
-Get mail from a @acronym{IMAP} server.  If you don't want to use
+Get mail from an @acronym{IMAP} server.  If you don't want to use
 @acronym{IMAP} as intended, as a network mail reading protocol (i.e.,
-with nnimap), for some reason or other, Gnus let you treat it similar
+with nnimap), for some reason or other, Gnus lets you treat it similar
 to a @acronym{POP} server and fetches articles from a given
 @acronym{IMAP} mailbox.  @xref{Using IMAP}, for more information.
 
@@ -19404,7 +19406,7 @@ If you so desire, you can configure the agent (see @code{gnus-agent-cache}
 @pxref{Agent Variables}) to always download headers and articles while
 plugged.  Gnus will almost certainly be slower, but it will be kept
 synchronized with the server.  That last point probably won't make any
-sense if you are using a nntp or nnimap back end.
+sense if you are using an nntp or nnimap back end.
 
 @node Agent Expiry
 @subsection Agent Expiry
@@ -26369,7 +26371,7 @@ If this option is non-@code{nil}, the registry will register all messages, as
 you see them.  This is important to making split-to-parent and
 Message-ID references work correctly, as the registry needs to know
 where all messages are, but it can slow down group opening and the
-saving of Gnus.  If this option is nil, entries must be created
+saving of Gnus.  If this option is @code{nil}, entries must be created
 manually, for instance by storing a custom flag or keyword for the
 message.
 @end defvar
@@ -26391,8 +26393,8 @@ This option specifies how registry entries are sorted during pruning.
 If a function is given, it should sort least valuable entries first,
 as pruning starts from the beginning of the list.  The default value
 is @code{gnus-registry-sort-by-creation-time}, which proposes the
-oldest entries for pruning.  Set to nil to perform no sorting, which
-will speed up the pruning process.
+oldest entries for pruning.  Set to @code{nil} to perform no sorting,
+which will speed up the pruning process.
 @end defvar
 
 @defvar gnus-registry-cache-file
@@ -26465,10 +26467,10 @@ have to put a rule like this:
 
 in your fancy split setup.
 
-If @code{gnus-registry-register-all} is non-@code{nil} (the default), the
-registry will perform splitting for all messages.  If it is nil,
-splitting will only happen for children of messages you've explicitly
-registered.
+If @code{gnus-registry-register-all} is non-@code{nil} (the default),
+the registry will perform splitting for all messages.  If it is
+@code{nil}, splitting will only happen for children of messages you've
+explicitly registered.
 
 In addition, you may want to customize the following variables.
 
index f9617f7a5cdb5bbd521ac544c8baaf69aa051112..6ed7e0ac032dce0e2cbcc36dc2716b97857f2dce 100644 (file)
@@ -3553,7 +3553,7 @@ completion lists.  If you want to suppress this completion because
 there are invalid entries in the persistency file, for example if the
 host configuration changes often, or if you plug your laptop to
 different networks frequently, you can set the user option
-@code{tramp-completion-use-cache} to nil.
+@code{tramp-completion-use-cache} to @code{nil}.
 
 After remote host name completion comes completion of file names on
 the remote host.  It works the same as with local host file completion