Minor doc fixes, mostly for timestamp issues

This commit is contained in:
Paul Eggert 2018-02-23 11:51:31 -08:00
parent 361a8b908b
commit 8a73b80aa4
7 changed files with 10 additions and 9 deletions

View file

@ -647,7 +647,7 @@ visiting a file or if the time has been explicitly cleared by
too. For instance, in a Dired buffer listing a directory, it returns too. For instance, in a Dired buffer listing a directory, it returns
the last modification time of that directory, as recorded by Dired. the last modification time of that directory, as recorded by Dired.
If the buffer is not visiting a file, this function returns -1. If the buffer is not visiting a file, this function returns @minus{}1.
@end defun @end defun
@defun set-visited-file-modtime &optional time @defun set-visited-file-modtime &optional time
@ -656,7 +656,8 @@ of the visited file, to the value specified by @var{time} if @var{time}
is not @code{nil}, and otherwise to the last modification time of the is not @code{nil}, and otherwise to the last modification time of the
visited file. visited file.
If @var{time} is neither @code{nil} nor zero, it should have the form If @var{time} is neither @code{nil} nor an integer flag returned
by @code{visited-file-modtime}, it should have the form
@code{(@var{high} @var{low} @var{microsec} @var{picosec})}, @code{(@var{high} @var{low} @var{microsec} @var{picosec})},
the format used by @code{current-time} (@pxref{Time of Day}). the format used by @code{current-time} (@pxref{Time of Day}).

View file

@ -1894,8 +1894,7 @@ all.
This function sets the access and modification times of @var{filename} This function sets the access and modification times of @var{filename}
to @var{time}. The return value is @code{t} if the times are successfully to @var{time}. The return value is @code{t} if the times are successfully
set, otherwise it is @code{nil}. @var{time} defaults to the current set, otherwise it is @code{nil}. @var{time} defaults to the current
time and must be in the format returned by @code{current-time} time and must be a time value (@pxref{Time of Day}).
(@pxref{Time of Day}).
@end defun @end defun
@defun set-file-extended-attributes filename attribute-alist @defun set-file-extended-attributes filename attribute-alist

View file

@ -2277,7 +2277,7 @@ specifies the color mode to use on a text terminal. The value can be
either a symbol or a number. A number specifies the number of colors either a symbol or a number. A number specifies the number of colors
to use (and, indirectly, what commands to issue to produce each to use (and, indirectly, what commands to issue to produce each
color). For example, @code{(tty-color-mode . 8)} specifies use of the color). For example, @code{(tty-color-mode . 8)} specifies use of the
ANSI escape sequences for 8 standard text colors. A value of -1 turns ANSI escape sequences for 8 standard text colors. A value of @minus{}1 turns
off color support. off color support.
If the parameter's value is a symbol, it specifies a number through If the parameter's value is a symbol, it specifies a number through

View file

@ -1629,7 +1629,7 @@ anonymous function.
This specifies how to order the advice, should several pieces of This specifies how to order the advice, should several pieces of
advice be present. By default, the depth is 0. A depth of 100 advice be present. By default, the depth is 0. A depth of 100
indicates that this piece of advice should be kept as deep as indicates that this piece of advice should be kept as deep as
possible, whereas a depth of -100 indicates that it should stay as the possible, whereas a depth of @minus{}100 indicates that it should stay as the
outermost piece. When two pieces of advice specify the same depth, outermost piece. When two pieces of advice specify the same depth,
the most recently added one will be outermost. the most recently added one will be outermost.

View file

@ -1457,7 +1457,8 @@ on others, years as early as 1901 do work.
@cindex formatting time values @cindex formatting time values
These functions convert time values to text in a string, and vice versa. These functions convert time values to text in a string, and vice versa.
Time values are lists of two to four integers (@pxref{Time of Day}). Time values include @code{nil}, numbers, and lists of two to four
integers (@pxref{Time of Day}).
@defun date-to-time string @defun date-to-time string
This function parses the time-string @var{string} and returns the This function parses the time-string @var{string} and returns the

View file

@ -602,7 +602,7 @@ line @var{count} screen lines from the top of the window; zero means
the topmost line. If @var{count} is negative, that specifies a the topmost line. If @var{count} is negative, that specifies a
position @w{@minus{}@var{count}} lines from the bottom (or the last position @w{@minus{}@var{count}} lines from the bottom (or the last
line of the buffer, if the buffer ends above the specified screen line of the buffer, if the buffer ends above the specified screen
position); thus, @var{count} of -1 specifies the last fully visible position); thus, @var{count} of @minus{}1 specifies the last fully visible
screen line of the window. screen line of the window.
If @var{count} is @code{nil}, then point moves to the beginning of the If @var{count} is @code{nil}, then point moves to the beginning of the

View file

@ -920,7 +920,7 @@ floating-point number.
@item %g @item %g
Replace the specification with notation for a floating-point number, Replace the specification with notation for a floating-point number,
using either exponential notation or decimal-point notation. The using either exponential notation or decimal-point notation. The
exponential notation is used if the exponent would be less than -4 or exponential notation is used if the exponent would be less than @minus{}4 or
greater than or equal to the precision (default: 6). By default, greater than or equal to the precision (default: 6). By default,
trailing zeros are removed from the fractional portion of the result trailing zeros are removed from the fractional portion of the result
and a decimal-point character appears only if it is followed by a and a decimal-point character appears only if it is followed by a