From: Paul Eggert Date: Mon, 29 Jan 2018 18:35:53 +0000 (-0800) Subject: Proofread os.texi and files.texi X-Git-Tag: emacs-26.1-rc1~297 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=7d90d2ece041630e0c440a2b0216e43f82729844;p=emacs.git Proofread os.texi and files.texi --- diff --git a/doc/emacs/msdos-xtra.texi b/doc/emacs/msdos-xtra.texi index 43dc2654a67..541e29aa25f 100644 --- a/doc/emacs/msdos-xtra.texi +++ b/doc/emacs/msdos-xtra.texi @@ -380,7 +380,7 @@ using an actual directory named @file{/dev} on any disk. (@pxref{Printing}) and @code{ps-print-buffer} (@pxref{PostScript}) @end ifnottex can work on MS-DOS by sending the output to one of the printer ports, -if a Posix-style @code{lpr} program is unavailable. The same Emacs +if a POSIX-style @code{lpr} program is unavailable. The same Emacs variables control printing on all systems, but in some cases they have different default values on MS-DOS. @@ -567,7 +567,7 @@ asynchronous invocation on other platforms Instead of the Shell mode, which doesn't work on MS-DOS, you can use the @kbd{M-x eshell} command. This invokes the Eshell package that -implements a Posix-like shell entirely in Emacs Lisp. +implements a POSIX-like shell entirely in Emacs Lisp. By contrast, Emacs compiled as a native Windows application @strong{does} support asynchronous subprocesses. diff --git a/doc/emacs/msdos.texi b/doc/emacs/msdos.texi index 25c3a567edd..9c47f47a736 100644 --- a/doc/emacs/msdos.texi +++ b/doc/emacs/msdos.texi @@ -129,7 +129,7 @@ window. @xref{emacsclient Options}. @cindex text and binary files on MS-DOS/MS-Windows GNU Emacs uses newline characters to separate text lines. This is the -convention used on GNU, Unix, and other Posix-compliant systems. +convention used on GNU, Unix, and other POSIX-compliant systems. @cindex end-of-line conversion on MS-DOS/MS-Windows By contrast, MS-DOS and MS-Windows normally use carriage-return linefeed, @@ -770,7 +770,7 @@ more details. Printing commands, such as @code{lpr-buffer} (@pxref{Printing}) and @code{ps-print-buffer} (@pxref{PostScript}) work in MS-DOS and MS-Windows by sending the output to one of the printer ports, if a -Posix-style @code{lpr} program is unavailable. The same Emacs +POSIX-style @code{lpr} program is unavailable. The same Emacs variables control printing on all systems, but in some cases they have different default values on MS-DOS and MS-Windows. diff --git a/doc/emacs/trouble.texi b/doc/emacs/trouble.texi index 05114c376c9..2edeb05f9e0 100644 --- a/doc/emacs/trouble.texi +++ b/doc/emacs/trouble.texi @@ -806,7 +806,7 @@ stimulates the bug. @item If non-@acronym{ASCII} text or internationalization is relevant, the locale that was current when you started Emacs. On GNU/Linux and Unix systems, or -if you use a Posix-style shell such as Bash, you can use this shell +if you use a POSIX-style shell such as Bash, you can use this shell command to view the relevant values: @smallexample diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi index 162fc1eb1ef..88c9d1f3187 100644 --- a/doc/lispref/files.texi +++ b/doc/lispref/files.texi @@ -1170,14 +1170,14 @@ Sometimes file names or their parts need to be compared as strings, in which case it's important to know whether the underlying filesystem is case-insensitive. This function returns @code{t} if file @var{filename} is on a case-insensitive filesystem. It always returns -@code{t} on MS-DOS and MS-Windows. On Cygwin and Mac OS X, +@code{t} on MS-DOS and MS-Windows. On Cygwin and macOS, filesystems may or may not be case-insensitive, and the function tries to determine case-sensitivity by a runtime test. If the test is inconclusive, the function returns @code{t} on Cygwin and @code{nil} -on Mac OS X. +on macOS. Currently this function always returns @code{nil} on platforms other -than MS-DOS, MS-Windows, Cygwin, and Mac OS X. It does not detect +than MS-DOS, MS-Windows, Cygwin, and macOS. It does not detect case-insensitivity of mounted filesystems, such as Samba shares or NFS-mounted Windows volumes. On remote hosts, it assumes @code{t} for the @samp{smb} method. For all other connection methods, runtime @@ -1297,9 +1297,9 @@ The file's @acronym{GID}, likewise (@code{file-attribute-group-id}). The time of last access, as a list of four integers @code{(@var{sec-high} @var{sec-low} @var{microsec} @var{picosec})} (@code{file-attribute-access-time}). (This is similar to the value of -@code{current-time}; see @ref{Time of Day}.) Note that on some -FAT-based filesystems, only the date of last access is recorded, so -this time will always hold the midnight of the day of last access. +@code{current-time}; see @ref{Time of Day}.) The value is truncated +to that of the filesystem's timestamp resolution; for example, on some +FAT-based filesystems, only the date of last access is recorded. @cindex modification time of file @item diff --git a/doc/lispref/loading.texi b/doc/lispref/loading.texi index 92b7e864ab5..80b75729c13 100644 --- a/doc/lispref/loading.texi +++ b/doc/lispref/loading.texi @@ -1151,7 +1151,7 @@ extension, a.k.a.@: ``suffix''. This suffix is platform-dependent. @defvar module-file-suffix This variable holds the system-dependent value of the file-name -extension of the module files. Its value is @file{.so} on Posix hosts +extension of the module files. Its value is @file{.so} on POSIX hosts and @file{.dll} on MS-Windows. @end defvar diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi index 1a4e2db44a6..9352a929a7a 100644 --- a/doc/lispref/os.texi +++ b/doc/lispref/os.texi @@ -257,7 +257,7 @@ options were specified. @item If a daemon was requested, it calls @code{server-start}. -(On Posix systems, if a background daemon was requested, it then +(On POSIX systems, if a background daemon was requested, it then detaches from the controlling terminal.) @xref{Emacs Server,,, emacs, The GNU Emacs Manual}. @@ -888,7 +888,7 @@ IBM's AIX. Berkeley BSD and its variants. @item cygwin -Cygwin, a Posix layer on top of MS-Windows. +Cygwin, a POSIX layer on top of MS-Windows. @item darwin Darwin (macOS). @@ -1325,13 +1325,13 @@ omitted or @code{nil}, the conversion uses Emacs's default time zone. If it is @code{t}, the conversion uses Universal Time. If it is @code{wall}, the conversion uses the system wall clock time. If it is a string, the conversion uses the time zone rule equivalent to setting -@env{TZ} to that string. If it is an integer @var{offset}, the -conversion uses a fixed time zone with the given offset and a numeric -abbreviation on POSIX-compatible platforms and an unspecified abbreviation -on MS-Windows. If it is a list (@var{offset} @var{abbr}), where +@env{TZ} to that string. If it is a list (@var{offset} @var{abbr}), where @var{offset} is an integer number of seconds east of Universal Time and @var{abbr} is a string, the conversion uses a fixed time zone with -the given offset and abbreviation. +the given offset and abbreviation. An integer @var{offset} is treated +as if it were (@var{offset} @var{abbr}), where @var{abbr} is a numeric +abbreviation on POSIX-compatible platforms and is unspecified on +MS-Windows. @defun current-time-zone &optional time zone @cindex time zone, current @@ -1488,6 +1488,7 @@ This is a synonym for @samp{%x %X}. @item %C This stands for the century, that is, the year divided by 100, truncated toward zero. +The default field width is 2. @item %d This stands for the day of month, zero-padded. @item %D @@ -2398,7 +2399,7 @@ Emacs is restarted by the session manager. Emacs is able to send @dfn{notifications} on systems that support the freedesktop.org Desktop Notifications Specification and on MS-Windows. -In order to use this functionality on Posix hosts, Emacs must have +In order to use this functionality on POSIX hosts, Emacs must have been compiled with D-Bus support, and the @code{notifications} library must be loaded. @xref{Top, , D-Bus,dbus,D-Bus integration in Emacs}. The following function is supported when D-Bus support is available: diff --git a/doc/lispref/streams.texi b/doc/lispref/streams.texi index a25a5bfe84a..bd7dc2d9af3 100644 --- a/doc/lispref/streams.texi +++ b/doc/lispref/streams.texi @@ -344,7 +344,7 @@ When reading or writing from the standard input/output streams of the Emacs process in batch mode, it is sometimes required to make sure any arbitrary binary data will be read/written verbatim, and/or that no translation of newlines to or from CR-LF pairs is performed. This -issue does not exist on Posix hosts, only on MS-Windows and MS-DOS@. +issue does not exist on POSIX hosts, only on MS-Windows and MS-DOS@. The following function allows you to control the I/O mode of any standard stream of the Emacs process. @@ -354,7 +354,7 @@ non-@code{nil}, switch to binary mode, otherwise switch to text mode. The value of @var{stream} can be one of @code{stdin}, @code{stdout}, or @code{stderr}. This function flushes any pending output data of @var{stream} as a side effect, and returns the previous value of I/O -mode for @var{stream}. On Posix hosts, it always returns a +mode for @var{stream}. On POSIX hosts, it always returns a non-@code{nil} value and does nothing except flushing pending output. @end defun @@ -707,7 +707,7 @@ indent and fill the object to make it more readable for humans. If you need to use binary I/O in batch mode, e.g., use the functions described in this section to write out arbitrary binary data or avoid -conversion of newlines on non-Posix hosts, see @ref{Input Functions, +conversion of newlines on non-POSIX hosts, see @ref{Input Functions, set-binary-mode}. @node Output Variables diff --git a/doc/misc/calc.texi b/doc/misc/calc.texi index 1144f2843cd..40b16b0f3c9 100644 --- a/doc/misc/calc.texi +++ b/doc/misc/calc.texi @@ -29128,7 +29128,7 @@ the X window system or MS-Windows, Calc will configure GNUPLOT for you automatically. If you have GNUPLOT 3.0 or later and you are using a Unix or GNU system without X, Calc will configure GNUPLOT to display graphs using simple character graphics that will work on any -Posix-compatible terminal. +POSIX-compatible terminal. @menu * Basic Graphics:: diff --git a/doc/misc/org.texi b/doc/misc/org.texi index 37a9648bfbb..6d152970fe2 100644 --- a/doc/misc/org.texi +++ b/doc/misc/org.texi @@ -6752,7 +6752,7 @@ applying it to another one. @vindex org-clock-idle-time By customizing the variable @code{org-clock-idle-time} to some integer, such as 10 or 15, Emacs can alert you when you get back to your computer after -being idle for that many minutes@footnote{On computers using Mac OS X, +being idle for that many minutes@footnote{On computers using macOS, idleness is based on actual user idleness, not just Emacs' idle time. For X11, you can install a utility program @file{x11idle.c}, available in the @code{contrib/scripts} directory of the Org git distribution, or install the