diff options
| author | Glenn Morris | 2018-01-30 07:50:25 -0800 |
|---|---|---|
| committer | Glenn Morris | 2018-01-30 07:50:25 -0800 |
| commit | 084cfae0e624469ebca78b155ffe4e2c20f2b205 (patch) | |
| tree | 090f0efbf80386248f99a054e45be8206d174b15 | |
| parent | 84055bda91d48dd603110b0805560cf1df205a83 (diff) | |
| parent | bc8dc37f1cd6dcede1f5f409a3aeb8fb345d642e (diff) | |
| download | emacs-084cfae0e624469ebca78b155ffe4e2c20f2b205.tar.gz emacs-084cfae0e624469ebca78b155ffe4e2c20f2b205.zip | |
Merge from origin/emacs-26
bc8dc37 (origin/emacs-26) Minor copyedits in "Distribution" chapter o...
1c7a936 Minor copyedits in "Entering" chapter of Emacs manual.
1d4498b Minor wording change in the Emacs manual
2bf49e7 Fix a typo in the Emacs manual
f3546a2 Improve the "Basic" chapter of the Emacs manual
691431e Resurrect lost text in lispref
956807b * lisp/emacs-lisp/rx.el (rx): Fix the definition of 'blank'.
7d90d2e Proofread os.texi and files.texi
490c736 Minor improvements in the "International" chapter of Emacs ma...
79252d3 Minor improvement in "Text" chapter of Emacs manual
| -rw-r--r-- | doc/emacs/basic.texi | 16 | ||||
| -rw-r--r-- | doc/emacs/custom.texi | 2 | ||||
| -rw-r--r-- | doc/emacs/emacs.texi | 4 | ||||
| -rw-r--r-- | doc/emacs/entering.texi | 9 | ||||
| -rw-r--r-- | doc/emacs/msdos-xtra.texi | 4 | ||||
| -rw-r--r-- | doc/emacs/msdos.texi | 4 | ||||
| -rw-r--r-- | doc/emacs/mule.texi | 51 | ||||
| -rw-r--r-- | doc/emacs/screen.texi | 2 | ||||
| -rw-r--r-- | doc/emacs/text.texi | 2 | ||||
| -rw-r--r-- | doc/emacs/trouble.texi | 2 | ||||
| -rw-r--r-- | doc/lispref/files.texi | 11 | ||||
| -rw-r--r-- | doc/lispref/loading.texi | 2 | ||||
| -rw-r--r-- | doc/lispref/os.texi | 17 | ||||
| -rw-r--r-- | doc/lispref/streams.texi | 6 | ||||
| -rw-r--r-- | doc/misc/calc.texi | 2 | ||||
| -rw-r--r-- | doc/misc/org.texi | 2 | ||||
| -rw-r--r-- | lisp/emacs-lisp/rx.el | 11 |
17 files changed, 79 insertions, 68 deletions
diff --git a/doc/emacs/basic.texi b/doc/emacs/basic.texi index b59ccf6ccfa..edb3d08f68d 100644 --- a/doc/emacs/basic.texi +++ b/doc/emacs/basic.texi | |||
| @@ -131,12 +131,6 @@ Unicode), or a number with a specified radix, e.g., @code{#o23072} | |||
| 131 | Manual}. The command then inserts the corresponding character into | 131 | Manual}. The command then inserts the corresponding character into |
| 132 | the buffer. | 132 | the buffer. |
| 133 | 133 | ||
| 134 | In some contexts, if you type a quotation using grave accent and | ||
| 135 | apostrophe @t{`like this'}, it is converted to a form @t{‘like this’} | ||
| 136 | using single quotation marks. Similarly, typing a quotation @t{``like | ||
| 137 | this''} using double grave accent and apostrophe converts it to a form | ||
| 138 | @t{“like this”} using double quotation marks. @xref{Quotation Marks}. | ||
| 139 | |||
| 140 | For example, the following all insert the same character: | 134 | For example, the following all insert the same character: |
| 141 | 135 | ||
| 142 | @example | 136 | @example |
| @@ -151,6 +145,13 @@ this''} using double grave accent and apostrophe converts it to a form | |||
| 151 | A numeric argument to @kbd{C-q} or @kbd{C-x 8 ...} specifies | 145 | A numeric argument to @kbd{C-q} or @kbd{C-x 8 ...} specifies |
| 152 | how many copies of the character to insert (@pxref{Arguments}). | 146 | how many copies of the character to insert (@pxref{Arguments}). |
| 153 | 147 | ||
| 148 | In addition, in some contexts, if you type a quotation using grave | ||
| 149 | accent and apostrophe @t{`like this'}, it is converted to a form | ||
| 150 | @t{‘like this’} using single quotation marks, even without @kbd{C-x 8} | ||
| 151 | commands. Similarly, typing a quotation @t{``like this''} using | ||
| 152 | double grave accent and apostrophe converts it to a form @t{“like | ||
| 153 | this”} using double quotation marks. @xref{Quotation Marks}. | ||
| 154 | |||
| 154 | @node Moving Point | 155 | @node Moving Point |
| 155 | @section Changing the Location of Point | 156 | @section Changing the Location of Point |
| 156 | 157 | ||
| @@ -711,6 +712,9 @@ where the two extra numbers give the smallest and largest character | |||
| 711 | position that point is allowed to assume. The characters between | 712 | position that point is allowed to assume. The characters between |
| 712 | those two positions are the accessible ones. @xref{Narrowing}. | 713 | those two positions are the accessible ones. @xref{Narrowing}. |
| 713 | 714 | ||
| 715 | Related, but different feature is @code{display-line-numbers-mode} | ||
| 716 | (@pxref{Display Custom}). | ||
| 717 | |||
| 714 | @node Arguments | 718 | @node Arguments |
| 715 | @section Numeric Arguments | 719 | @section Numeric Arguments |
| 716 | @cindex numeric arguments | 720 | @cindex numeric arguments |
diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi index c58cc7ebd70..5b2ab8280d1 100644 --- a/doc/emacs/custom.texi +++ b/doc/emacs/custom.texi | |||
| @@ -127,7 +127,7 @@ brings up the customization buffer for that group. | |||
| 127 | @kindex S-TAB @r{(customization buffer)} | 127 | @kindex S-TAB @r{(customization buffer)} |
| 128 | @findex widget-forward | 128 | @findex widget-forward |
| 129 | @findex widget-backward | 129 | @findex widget-backward |
| 130 | In the customizable buffer, you can type @key{TAB} | 130 | In the customization buffer, you can type @key{TAB} |
| 131 | (@code{widget-forward}) to move forward to the next button or editable | 131 | (@code{widget-forward}) to move forward to the next button or editable |
| 132 | field. @kbd{S-@key{TAB}} (@code{widget-backward}) moves back to the | 132 | field. @kbd{S-@key{TAB}} (@code{widget-backward}) moves back to the |
| 133 | previous button or editable field. | 133 | previous button or editable field. |
diff --git a/doc/emacs/emacs.texi b/doc/emacs/emacs.texi index 09817080c58..5904740b1f6 100644 --- a/doc/emacs/emacs.texi +++ b/doc/emacs/emacs.texi | |||
| @@ -1345,7 +1345,7 @@ for documentation. @xref{GNU Free Documentation License}.}. | |||
| 1345 | @xref{Copying}. | 1345 | @xref{Copying}. |
| 1346 | 1346 | ||
| 1347 | One way to get a copy of GNU Emacs is from someone else who has it. | 1347 | One way to get a copy of GNU Emacs is from someone else who has it. |
| 1348 | You need not ask for our permission to do so, or tell any one else; | 1348 | You need not ask for our permission to do so, or tell anyone else; |
| 1349 | just copy it. If you have access to the Internet, you can get the | 1349 | just copy it. If you have access to the Internet, you can get the |
| 1350 | latest distribution version of GNU Emacs by anonymous FTP; see | 1350 | latest distribution version of GNU Emacs by anonymous FTP; see |
| 1351 | @url{https://www.gnu.org/software/emacs} on our website for more | 1351 | @url{https://www.gnu.org/software/emacs} on our website for more |
| @@ -1361,7 +1361,7 @@ when you get it, not just free for the manufacturer. | |||
| 1361 | 1361 | ||
| 1362 | If you find GNU Emacs useful, please @strong{send a donation} to the | 1362 | If you find GNU Emacs useful, please @strong{send a donation} to the |
| 1363 | Free Software Foundation to support our work. Donations to the Free | 1363 | Free Software Foundation to support our work. Donations to the Free |
| 1364 | Software Foundation are tax deductible in the US@. If you use GNU Emacs | 1364 | Software Foundation are tax-deductible in the US@. If you use GNU Emacs |
| 1365 | at your workplace, please suggest that the company make a donation. | 1365 | at your workplace, please suggest that the company make a donation. |
| 1366 | To donate, see @url{https://my.fsf.org/donate/}. | 1366 | To donate, see @url{https://my.fsf.org/donate/}. |
| 1367 | For other ways in which you can help, see | 1367 | For other ways in which you can help, see |
diff --git a/doc/emacs/entering.texi b/doc/emacs/entering.texi index de0d7818099..2ff258ffb0c 100644 --- a/doc/emacs/entering.texi +++ b/doc/emacs/entering.texi | |||
| @@ -18,10 +18,11 @@ | |||
| 18 | @cindex starting Emacs | 18 | @cindex starting Emacs |
| 19 | 19 | ||
| 20 | The usual way to invoke Emacs is with the shell command | 20 | The usual way to invoke Emacs is with the shell command |
| 21 | @command{emacs}. From a terminal window running in the X Window | 21 | @command{emacs}. From a terminal window running a Unix shell in the X |
| 22 | System, you can run Emacs in the background with @command{emacs &}; | 22 | Window System, you can run Emacs in the background with @command{emacs |
| 23 | this way, Emacs won't tie up the terminal window, so you can use it to | 23 | &}; this way, Emacs won't tie up the terminal window, so you can use |
| 24 | run other shell commands. | 24 | it to run other shell commands. (For comparable methods of starting |
| 25 | Emacs on MS-Windows, see @ref{Windows Startup}.) | ||
| 25 | 26 | ||
| 26 | @cindex startup screen | 27 | @cindex startup screen |
| 27 | When Emacs starts up, the initial frame displays a special buffer | 28 | When Emacs starts up, the initial frame displays a special buffer |
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. | |||
| 380 | (@pxref{Printing}) and @code{ps-print-buffer} (@pxref{PostScript}) | 380 | (@pxref{Printing}) and @code{ps-print-buffer} (@pxref{PostScript}) |
| 381 | @end ifnottex | 381 | @end ifnottex |
| 382 | can work on MS-DOS by sending the output to one of the printer ports, | 382 | can work on MS-DOS by sending the output to one of the printer ports, |
| 383 | if a Posix-style @code{lpr} program is unavailable. The same Emacs | 383 | if a POSIX-style @code{lpr} program is unavailable. The same Emacs |
| 384 | variables control printing on all systems, but in some cases they have | 384 | variables control printing on all systems, but in some cases they have |
| 385 | different default values on MS-DOS. | 385 | different default values on MS-DOS. |
| 386 | 386 | ||
| @@ -567,7 +567,7 @@ asynchronous invocation on other platforms | |||
| 567 | 567 | ||
| 568 | Instead of the Shell mode, which doesn't work on MS-DOS, you can use | 568 | Instead of the Shell mode, which doesn't work on MS-DOS, you can use |
| 569 | the @kbd{M-x eshell} command. This invokes the Eshell package that | 569 | the @kbd{M-x eshell} command. This invokes the Eshell package that |
| 570 | implements a Posix-like shell entirely in Emacs Lisp. | 570 | implements a POSIX-like shell entirely in Emacs Lisp. |
| 571 | 571 | ||
| 572 | By contrast, Emacs compiled as a native Windows application | 572 | By contrast, Emacs compiled as a native Windows application |
| 573 | @strong{does} support asynchronous subprocesses. | 573 | @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}. | |||
| 129 | @cindex text and binary files on MS-DOS/MS-Windows | 129 | @cindex text and binary files on MS-DOS/MS-Windows |
| 130 | 130 | ||
| 131 | GNU Emacs uses newline characters to separate text lines. This is the | 131 | GNU Emacs uses newline characters to separate text lines. This is the |
| 132 | convention used on GNU, Unix, and other Posix-compliant systems. | 132 | convention used on GNU, Unix, and other POSIX-compliant systems. |
| 133 | 133 | ||
| 134 | @cindex end-of-line conversion on MS-DOS/MS-Windows | 134 | @cindex end-of-line conversion on MS-DOS/MS-Windows |
| 135 | By contrast, MS-DOS and MS-Windows normally use carriage-return linefeed, | 135 | By contrast, MS-DOS and MS-Windows normally use carriage-return linefeed, |
| @@ -770,7 +770,7 @@ more details. | |||
| 770 | Printing commands, such as @code{lpr-buffer} (@pxref{Printing}) and | 770 | Printing commands, such as @code{lpr-buffer} (@pxref{Printing}) and |
| 771 | @code{ps-print-buffer} (@pxref{PostScript}) work in MS-DOS and | 771 | @code{ps-print-buffer} (@pxref{PostScript}) work in MS-DOS and |
| 772 | MS-Windows by sending the output to one of the printer ports, if a | 772 | MS-Windows by sending the output to one of the printer ports, if a |
| 773 | Posix-style @code{lpr} program is unavailable. The same Emacs | 773 | POSIX-style @code{lpr} program is unavailable. The same Emacs |
| 774 | variables control printing on all systems, but in some cases they have | 774 | variables control printing on all systems, but in some cases they have |
| 775 | different default values on MS-DOS and MS-Windows. | 775 | different default values on MS-DOS and MS-Windows. |
| 776 | 776 | ||
diff --git a/doc/emacs/mule.texi b/doc/emacs/mule.texi index fd25604c700..4989982eca0 100644 --- a/doc/emacs/mule.texi +++ b/doc/emacs/mule.texi | |||
| @@ -1207,13 +1207,13 @@ using the internal Emacs representation. | |||
| 1207 | @cindex file-name encoding, MS-Windows | 1207 | @cindex file-name encoding, MS-Windows |
| 1208 | @vindex w32-unicode-filenames | 1208 | @vindex w32-unicode-filenames |
| 1209 | When Emacs runs on MS-Windows versions that are descendants of the | 1209 | When Emacs runs on MS-Windows versions that are descendants of the |
| 1210 | NT family (Windows 2000, XP, Vista, Windows 7, and Windows 8), the | 1210 | NT family (Windows 2000, XP, Vista, Windows 7, and all the later |
| 1211 | value of @code{file-name-coding-system} is largely ignored, as Emacs | 1211 | versions), the value of @code{file-name-coding-system} is largely |
| 1212 | by default uses APIs that allow passing Unicode file names directly. | 1212 | ignored, as Emacs by default uses APIs that allow passing Unicode file |
| 1213 | By contrast, on Windows 9X, file names are encoded using | 1213 | names directly. By contrast, on Windows 9X, file names are encoded |
| 1214 | @code{file-name-coding-system}, which should be set to the codepage | 1214 | using @code{file-name-coding-system}, which should be set to the |
| 1215 | (@pxref{Coding Systems, codepage}) pertinent for the current system | 1215 | codepage (@pxref{Coding Systems, codepage}) pertinent for the current |
| 1216 | locale. The value of the variable @code{w32-unicode-filenames} | 1216 | system locale. The value of the variable @code{w32-unicode-filenames} |
| 1217 | controls whether Emacs uses the Unicode APIs when it calls OS | 1217 | controls whether Emacs uses the Unicode APIs when it calls OS |
| 1218 | functions that accept file names. This variable is set by the startup | 1218 | functions that accept file names. This variable is set by the startup |
| 1219 | code to @code{nil} on Windows 9X, and to @code{t} on newer versions of | 1219 | code to @code{nil} on Windows 9X, and to @code{t} on newer versions of |
| @@ -1570,9 +1570,9 @@ used. Some examples are: | |||
| 1570 | unpleasant results for characters for which they are used, and you may | 1570 | unpleasant results for characters for which they are used, and you may |
| 1571 | wish to instruct Emacs to completely ignore them while searching for a | 1571 | wish to instruct Emacs to completely ignore them while searching for a |
| 1572 | suitable font required to display a character. You can do that by | 1572 | suitable font required to display a character. You can do that by |
| 1573 | adding the offending fonts to the value of @code{face-ignored-fonts} | 1573 | adding the offending fonts to the value of the variable |
| 1574 | variable, which is a list. Here's an example to put in your | 1574 | @code{face-ignored-fonts}, which is a list. Here's an example to put |
| 1575 | @file{~/.emacs}: | 1575 | in your @file{~/.emacs}: |
| 1576 | 1576 | ||
| 1577 | @example | 1577 | @example |
| 1578 | (add-to-list 'face-ignored-fonts "Some Bad Font") | 1578 | (add-to-list 'face-ignored-fonts "Some Bad Font") |
| @@ -1673,10 +1673,10 @@ should use the command @kbd{M-x set-keyboard-coding-system} or | |||
| 1673 | customize the variable @code{keyboard-coding-system} to specify which | 1673 | customize the variable @code{keyboard-coding-system} to specify which |
| 1674 | coding system your keyboard uses (@pxref{Terminal Coding}). Enabling | 1674 | coding system your keyboard uses (@pxref{Terminal Coding}). Enabling |
| 1675 | this feature will probably require you to use @key{ESC} to type Meta | 1675 | this feature will probably require you to use @key{ESC} to type Meta |
| 1676 | characters; however, on a console terminal or in @code{xterm}, you can | 1676 | characters; however, on a console terminal or a terminal emulator such |
| 1677 | arrange for Meta to be converted to @key{ESC} and still be able to | 1677 | as @code{xterm}, you can arrange for Meta to be converted to @key{ESC} |
| 1678 | type 8-bit characters present directly on the keyboard or using | 1678 | and still be able to type 8-bit characters present directly on the |
| 1679 | @key{Compose} or @key{AltGr} keys. @xref{User Input}. | 1679 | keyboard or using @key{Compose} or @key{AltGr} keys. @xref{User Input}. |
| 1680 | 1680 | ||
| 1681 | @cindex @code{iso-transl} library | 1681 | @cindex @code{iso-transl} library |
| 1682 | @cindex compose character | 1682 | @cindex compose character |
| @@ -1777,13 +1777,13 @@ for editing bidirectional text. | |||
| 1777 | @dfn{logical} (or @dfn{reading}) order: the buffer or string position | 1777 | @dfn{logical} (or @dfn{reading}) order: the buffer or string position |
| 1778 | of the first character you read precedes that of the next character. | 1778 | of the first character you read precedes that of the next character. |
| 1779 | Reordering of bidirectional text into the @dfn{visual} order happens | 1779 | Reordering of bidirectional text into the @dfn{visual} order happens |
| 1780 | at display time. As result, character positions no longer increase | 1780 | at display time. As a result, character positions no longer increase |
| 1781 | monotonically with their positions on display. Emacs implements the | 1781 | monotonically with their positions on display. Emacs implements the |
| 1782 | Unicode Bidirectional Algorithm (UBA) described in the Unicode | 1782 | Unicode Bidirectional Algorithm (UBA) described in the Unicode |
| 1783 | Standard Annex #9, for reordering of bidirectional text for display. | 1783 | Standard Annex #9, for reordering of bidirectional text for display. |
| 1784 | It deviates from the UBA only in how continuation lines are displayed | 1784 | It deviates from the UBA only in how continuation lines are displayed |
| 1785 | when text direction is opposite to the base paragraph direction, | 1785 | when text direction is opposite to the base paragraph direction, |
| 1786 | e.g. when a long line of English text appears in a right-to-left | 1786 | e.g., when a long line of English text appears in a right-to-left |
| 1787 | paragraph. | 1787 | paragraph. |
| 1788 | 1788 | ||
| 1789 | @vindex bidi-display-reordering | 1789 | @vindex bidi-display-reordering |
| @@ -1835,12 +1835,13 @@ thin blank characters; on text terminals they display as blanks. | |||
| 1835 | 1835 | ||
| 1836 | Because characters are reordered for display, Emacs commands that | 1836 | Because characters are reordered for display, Emacs commands that |
| 1837 | operate in the logical order or on stretches of buffer positions may | 1837 | operate in the logical order or on stretches of buffer positions may |
| 1838 | produce unusual effects. For example, @kbd{C-f} and @kbd{C-b} | 1838 | produce unusual effects. For example, the commands @kbd{C-f} and |
| 1839 | commands move point in the logical order, so the cursor will sometimes | 1839 | @kbd{C-b} move point in the logical order, so the cursor will |
| 1840 | jump when point traverses reordered bidirectional text. Similarly, a | 1840 | sometimes jump when point traverses reordered bidirectional text. |
| 1841 | highlighted region covering a contiguous range of character positions | 1841 | Similarly, a highlighted region covering a contiguous range of |
| 1842 | may look discontinuous if the region spans reordered text. This is | 1842 | character positions may look discontinuous if the region spans |
| 1843 | normal and similar to the behavior of other programs that support | 1843 | reordered text. This is normal and similar to the behavior of other |
| 1844 | bidirectional text. If you set @code{visual-order-cursor-movement} to | 1844 | programs that support bidirectional text. If you set |
| 1845 | a non-@code{nil} value, cursor motion by the arrow keys follows the | 1845 | @code{visual-order-cursor-movement} to a non-@code{nil} value, cursor |
| 1846 | visual order on screen (@pxref{Moving Point, visual-order movement}). | 1846 | motion by the arrow keys follows the visual order on screen |
| 1847 | (@pxref{Moving Point, visual-order movement}). | ||
diff --git a/doc/emacs/screen.texi b/doc/emacs/screen.texi index d00b74fa656..fb4eff9711a 100644 --- a/doc/emacs/screen.texi +++ b/doc/emacs/screen.texi | |||
| @@ -18,7 +18,7 @@ frames if you wish (@pxref{Frames}). | |||
| 18 | Each frame consists of several distinct regions. At the top of the | 18 | Each frame consists of several distinct regions. At the top of the |
| 19 | frame is a @dfn{menu bar}, which allows you to access commands via a | 19 | frame is a @dfn{menu bar}, which allows you to access commands via a |
| 20 | series of menus. On a graphical display, directly below the menu bar | 20 | series of menus. On a graphical display, directly below the menu bar |
| 21 | is a @dfn{tool bar}, a row of icons that perform editing commands if | 21 | is a @dfn{tool bar}, a row of icons that perform editing commands when |
| 22 | you click on them. At the very bottom of the frame is an @dfn{echo | 22 | you click on them. At the very bottom of the frame is an @dfn{echo |
| 23 | area}, where informative messages are displayed and where you enter | 23 | area}, where informative messages are displayed and where you enter |
| 24 | information when Emacs asks for it. | 24 | information when Emacs asks for it. |
diff --git a/doc/emacs/text.texi b/doc/emacs/text.texi index 7e49a46b179..b9d3b7b94b4 100644 --- a/doc/emacs/text.texi +++ b/doc/emacs/text.texi | |||
| @@ -101,7 +101,7 @@ Kill up to the end of a word (@code{kill-word}). | |||
| 101 | @item M-@key{DEL} | 101 | @item M-@key{DEL} |
| 102 | Kill back to the beginning of a word (@code{backward-kill-word}). | 102 | Kill back to the beginning of a word (@code{backward-kill-word}). |
| 103 | @item M-@@ | 103 | @item M-@@ |
| 104 | Mark the end of the next word (@code{mark-word}). | 104 | Set mark at the end of the next word (@code{mark-word}). |
| 105 | @item M-t | 105 | @item M-t |
| 106 | Transpose two words or drag a word across others | 106 | Transpose two words or drag a word across others |
| 107 | (@code{transpose-words}). | 107 | (@code{transpose-words}). |
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. | |||
| 806 | @item | 806 | @item |
| 807 | If non-@acronym{ASCII} text or internationalization is relevant, the locale that | 807 | If non-@acronym{ASCII} text or internationalization is relevant, the locale that |
| 808 | was current when you started Emacs. On GNU/Linux and Unix systems, or | 808 | was current when you started Emacs. On GNU/Linux and Unix systems, or |
| 809 | if you use a Posix-style shell such as Bash, you can use this shell | 809 | if you use a POSIX-style shell such as Bash, you can use this shell |
| 810 | command to view the relevant values: | 810 | command to view the relevant values: |
| 811 | 811 | ||
| 812 | @smallexample | 812 | @smallexample |
diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi index 021a62a56ab..6a0312bd2f3 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 | |||
| 1170 | which case it's important to know whether the underlying filesystem is | 1170 | which case it's important to know whether the underlying filesystem is |
| 1171 | case-insensitive. This function returns @code{t} if file | 1171 | case-insensitive. This function returns @code{t} if file |
| 1172 | @var{filename} is on a case-insensitive filesystem. It always returns | 1172 | @var{filename} is on a case-insensitive filesystem. It always returns |
| 1173 | @code{t} on MS-DOS and MS-Windows. On Cygwin and Mac OS X, | 1173 | @code{t} on MS-DOS and MS-Windows. On Cygwin and macOS, |
| 1174 | filesystems may or may not be case-insensitive, and the function tries | 1174 | filesystems may or may not be case-insensitive, and the function tries |
| 1175 | to determine case-sensitivity by a runtime test. If the test is | 1175 | to determine case-sensitivity by a runtime test. If the test is |
| 1176 | inconclusive, the function returns @code{t} on Cygwin and @code{nil} | 1176 | inconclusive, the function returns @code{t} on Cygwin and @code{nil} |
| 1177 | on Mac OS X. | 1177 | on macOS. |
| 1178 | 1178 | ||
| 1179 | Currently this function always returns @code{nil} on platforms other | 1179 | Currently this function always returns @code{nil} on platforms other |
| 1180 | than MS-DOS, MS-Windows, Cygwin, and Mac OS X. It does not detect | 1180 | than MS-DOS, MS-Windows, Cygwin, and macOS. It does not detect |
| 1181 | case-insensitivity of mounted filesystems, such as Samba shares or | 1181 | case-insensitivity of mounted filesystems, such as Samba shares or |
| 1182 | NFS-mounted Windows volumes. On remote hosts, it assumes @code{t} for | 1182 | NFS-mounted Windows volumes. On remote hosts, it assumes @code{t} for |
| 1183 | the @samp{smb} method. For all other connection methods, runtime | 1183 | the @samp{smb} method. For all other connection methods, runtime |
| @@ -1297,9 +1297,10 @@ The file's @acronym{GID}, likewise (@code{file-attribute-group-id}). | |||
| 1297 | The time of last access, as a list of four integers | 1297 | The time of last access, as a list of four integers |
| 1298 | @code{(@var{sec-high} @var{sec-low} @var{microsec} @var{picosec})} | 1298 | @code{(@var{sec-high} @var{sec-low} @var{microsec} @var{picosec})} |
| 1299 | (@code{file-attribute-access-time}). (This is similar to the value of | 1299 | (@code{file-attribute-access-time}). (This is similar to the value of |
| 1300 | @code{current-time}; see @ref{Time of Day}.) Note that on some | 1300 | @code{current-time}; see @ref{Time of Day}.) The value is truncated |
| 1301 | to that of the filesystem's timestamp resolution; for example, on some | ||
| 1301 | FAT-based filesystems, only the date of last access is recorded, so | 1302 | FAT-based filesystems, only the date of last access is recorded, so |
| 1302 | this time will always hold the midnight of the day of last access. | 1303 | this time will always hold the midnight of the day of the last access. |
| 1303 | 1304 | ||
| 1304 | @cindex modification time of file | 1305 | @cindex modification time of file |
| 1305 | @item | 1306 | @item |
diff --git a/doc/lispref/loading.texi b/doc/lispref/loading.texi index 0165d114a75..82c133de753 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. | |||
| 1151 | 1151 | ||
| 1152 | @defvar module-file-suffix | 1152 | @defvar module-file-suffix |
| 1153 | This variable holds the system-dependent value of the file-name | 1153 | This variable holds the system-dependent value of the file-name |
| 1154 | extension of the module files. Its value is @file{.so} on Posix hosts | 1154 | extension of the module files. Its value is @file{.so} on POSIX hosts |
| 1155 | and @file{.dll} on MS-Windows. | 1155 | and @file{.dll} on MS-Windows. |
| 1156 | @end defvar | 1156 | @end defvar |
| 1157 | 1157 | ||
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. | |||
| 257 | 257 | ||
| 258 | @item | 258 | @item |
| 259 | If a daemon was requested, it calls @code{server-start}. | 259 | If a daemon was requested, it calls @code{server-start}. |
| 260 | (On Posix systems, if a background daemon was requested, it then | 260 | (On POSIX systems, if a background daemon was requested, it then |
| 261 | detaches from the controlling terminal.) @xref{Emacs | 261 | detaches from the controlling terminal.) @xref{Emacs |
| 262 | Server,,, emacs, The GNU Emacs Manual}. | 262 | Server,,, emacs, The GNU Emacs Manual}. |
| 263 | 263 | ||
| @@ -888,7 +888,7 @@ IBM's AIX. | |||
| 888 | Berkeley BSD and its variants. | 888 | Berkeley BSD and its variants. |
| 889 | 889 | ||
| 890 | @item cygwin | 890 | @item cygwin |
| 891 | Cygwin, a Posix layer on top of MS-Windows. | 891 | Cygwin, a POSIX layer on top of MS-Windows. |
| 892 | 892 | ||
| 893 | @item darwin | 893 | @item darwin |
| 894 | Darwin (macOS). | 894 | Darwin (macOS). |
| @@ -1325,13 +1325,13 @@ omitted or @code{nil}, the conversion uses Emacs's default time zone. | |||
| 1325 | If it is @code{t}, the conversion uses Universal Time. If it is | 1325 | If it is @code{t}, the conversion uses Universal Time. If it is |
| 1326 | @code{wall}, the conversion uses the system wall clock time. If it is | 1326 | @code{wall}, the conversion uses the system wall clock time. If it is |
| 1327 | a string, the conversion uses the time zone rule equivalent to setting | 1327 | a string, the conversion uses the time zone rule equivalent to setting |
| 1328 | @env{TZ} to that string. If it is an integer @var{offset}, the | 1328 | @env{TZ} to that string. If it is a list (@var{offset} @var{abbr}), where |
| 1329 | conversion uses a fixed time zone with the given offset and a numeric | ||
| 1330 | abbreviation on POSIX-compatible platforms and an unspecified abbreviation | ||
| 1331 | on MS-Windows. If it is a list (@var{offset} @var{abbr}), where | ||
| 1332 | @var{offset} is an integer number of seconds east of Universal Time | 1329 | @var{offset} is an integer number of seconds east of Universal Time |
| 1333 | and @var{abbr} is a string, the conversion uses a fixed time zone with | 1330 | and @var{abbr} is a string, the conversion uses a fixed time zone with |
| 1334 | the given offset and abbreviation. | 1331 | the given offset and abbreviation. An integer @var{offset} is treated |
| 1332 | as if it were (@var{offset} @var{abbr}), where @var{abbr} is a numeric | ||
| 1333 | abbreviation on POSIX-compatible platforms and is unspecified on | ||
| 1334 | MS-Windows. | ||
| 1335 | 1335 | ||
| 1336 | @defun current-time-zone &optional time zone | 1336 | @defun current-time-zone &optional time zone |
| 1337 | @cindex time zone, current | 1337 | @cindex time zone, current |
| @@ -1488,6 +1488,7 @@ This is a synonym for @samp{%x %X}. | |||
| 1488 | @item %C | 1488 | @item %C |
| 1489 | This stands for the century, that is, the year divided by 100, | 1489 | This stands for the century, that is, the year divided by 100, |
| 1490 | truncated toward zero. | 1490 | truncated toward zero. |
| 1491 | The default field width is 2. | ||
| 1491 | @item %d | 1492 | @item %d |
| 1492 | This stands for the day of month, zero-padded. | 1493 | This stands for the day of month, zero-padded. |
| 1493 | @item %D | 1494 | @item %D |
| @@ -2398,7 +2399,7 @@ Emacs is restarted by the session manager. | |||
| 2398 | 2399 | ||
| 2399 | Emacs is able to send @dfn{notifications} on systems that support the | 2400 | Emacs is able to send @dfn{notifications} on systems that support the |
| 2400 | freedesktop.org Desktop Notifications Specification and on MS-Windows. | 2401 | freedesktop.org Desktop Notifications Specification and on MS-Windows. |
| 2401 | In order to use this functionality on Posix hosts, Emacs must have | 2402 | In order to use this functionality on POSIX hosts, Emacs must have |
| 2402 | been compiled with D-Bus support, and the @code{notifications} library | 2403 | been compiled with D-Bus support, and the @code{notifications} library |
| 2403 | must be loaded. @xref{Top, , D-Bus,dbus,D-Bus integration in Emacs}. | 2404 | must be loaded. @xref{Top, , D-Bus,dbus,D-Bus integration in Emacs}. |
| 2404 | The following function is supported when D-Bus support is available: | 2405 | 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 | |||
| 344 | Emacs process in batch mode, it is sometimes required to make sure any | 344 | Emacs process in batch mode, it is sometimes required to make sure any |
| 345 | arbitrary binary data will be read/written verbatim, and/or that no | 345 | arbitrary binary data will be read/written verbatim, and/or that no |
| 346 | translation of newlines to or from CR-LF pairs is performed. This | 346 | translation of newlines to or from CR-LF pairs is performed. This |
| 347 | issue does not exist on Posix hosts, only on MS-Windows and MS-DOS@. | 347 | issue does not exist on POSIX hosts, only on MS-Windows and MS-DOS@. |
| 348 | The following function allows you to control the I/O mode of any | 348 | The following function allows you to control the I/O mode of any |
| 349 | standard stream of the Emacs process. | 349 | standard stream of the Emacs process. |
| 350 | 350 | ||
| @@ -354,7 +354,7 @@ non-@code{nil}, switch to binary mode, otherwise switch to text mode. | |||
| 354 | The value of @var{stream} can be one of @code{stdin}, @code{stdout}, | 354 | The value of @var{stream} can be one of @code{stdin}, @code{stdout}, |
| 355 | or @code{stderr}. This function flushes any pending output data of | 355 | or @code{stderr}. This function flushes any pending output data of |
| 356 | @var{stream} as a side effect, and returns the previous value of I/O | 356 | @var{stream} as a side effect, and returns the previous value of I/O |
| 357 | mode for @var{stream}. On Posix hosts, it always returns a | 357 | mode for @var{stream}. On POSIX hosts, it always returns a |
| 358 | non-@code{nil} value and does nothing except flushing pending output. | 358 | non-@code{nil} value and does nothing except flushing pending output. |
| 359 | @end defun | 359 | @end defun |
| 360 | 360 | ||
| @@ -707,7 +707,7 @@ indent and fill the object to make it more readable for humans. | |||
| 707 | 707 | ||
| 708 | If you need to use binary I/O in batch mode, e.g., use the functions | 708 | If you need to use binary I/O in batch mode, e.g., use the functions |
| 709 | described in this section to write out arbitrary binary data or avoid | 709 | described in this section to write out arbitrary binary data or avoid |
| 710 | conversion of newlines on non-Posix hosts, see @ref{Input Functions, | 710 | conversion of newlines on non-POSIX hosts, see @ref{Input Functions, |
| 711 | set-binary-mode}. | 711 | set-binary-mode}. |
| 712 | 712 | ||
| 713 | @node Output Variables | 713 | @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 | |||
| 29128 | automatically. If you have GNUPLOT 3.0 or later and you are using a | 29128 | automatically. If you have GNUPLOT 3.0 or later and you are using a |
| 29129 | Unix or GNU system without X, Calc will configure GNUPLOT to display | 29129 | Unix or GNU system without X, Calc will configure GNUPLOT to display |
| 29130 | graphs using simple character graphics that will work on any | 29130 | graphs using simple character graphics that will work on any |
| 29131 | Posix-compatible terminal. | 29131 | POSIX-compatible terminal. |
| 29132 | 29132 | ||
| 29133 | @menu | 29133 | @menu |
| 29134 | * Basic Graphics:: | 29134 | * Basic Graphics:: |
diff --git a/doc/misc/org.texi b/doc/misc/org.texi index 762dfafdda7..aa3b029ab7c 100644 --- a/doc/misc/org.texi +++ b/doc/misc/org.texi | |||
| @@ -6752,7 +6752,7 @@ applying it to another one. | |||
| 6752 | @vindex org-clock-idle-time | 6752 | @vindex org-clock-idle-time |
| 6753 | By customizing the variable @code{org-clock-idle-time} to some integer, such | 6753 | By customizing the variable @code{org-clock-idle-time} to some integer, such |
| 6754 | as 10 or 15, Emacs can alert you when you get back to your computer after | 6754 | as 10 or 15, Emacs can alert you when you get back to your computer after |
| 6755 | being idle for that many minutes@footnote{On computers using Mac OS X, | 6755 | being idle for that many minutes@footnote{On computers using macOS, |
| 6756 | idleness is based on actual user idleness, not just Emacs' idle time. For | 6756 | idleness is based on actual user idleness, not just Emacs' idle time. For |
| 6757 | X11, you can install a utility program @file{x11idle.c}, available in the | 6757 | X11, you can install a utility program @file{x11idle.c}, available in the |
| 6758 | @code{contrib/scripts} directory of the Org git distribution, or install the | 6758 | @code{contrib/scripts} directory of the Org git distribution, or install the |
diff --git a/lisp/emacs-lisp/rx.el b/lisp/emacs-lisp/rx.el index 37aa25b556d..c4f6d4f70ea 100644 --- a/lisp/emacs-lisp/rx.el +++ b/lisp/emacs-lisp/rx.el | |||
| @@ -57,7 +57,6 @@ | |||
| 57 | ;; (rx (and line-start (0+ (in "a-z")))) | 57 | ;; (rx (and line-start (0+ (in "a-z")))) |
| 58 | ;; | 58 | ;; |
| 59 | ;; "\n[^ \t]" | 59 | ;; "\n[^ \t]" |
| 60 | ;; (rx (and "\n" (not blank))), or | ||
| 61 | ;; (rx (and "\n" (not (any " \t")))) | 60 | ;; (rx (and "\n" (not (any " \t")))) |
| 62 | ;; | 61 | ;; |
| 63 | ;; "\\*\\*\\* EOOH \\*\\*\\*\n" | 62 | ;; "\\*\\*\\* EOOH \\*\\*\\*\n" |
| @@ -74,9 +73,9 @@ | |||
| 74 | ;; "^content-transfer-encoding:\\(\n?[\t ]\\)*quoted-printable\\(\n?[\t ]\\)*" | 73 | ;; "^content-transfer-encoding:\\(\n?[\t ]\\)*quoted-printable\\(\n?[\t ]\\)*" |
| 75 | ;; (rx (and line-start | 74 | ;; (rx (and line-start |
| 76 | ;; "content-transfer-encoding:" | 75 | ;; "content-transfer-encoding:" |
| 77 | ;; (+ (? ?\n)) blank | 76 | ;; (+ (? ?\n)) (any " \t") |
| 78 | ;; "quoted-printable" | 77 | ;; "quoted-printable" |
| 79 | ;; (+ (? ?\n)) blank)) | 78 | ;; (+ (? ?\n)) (any " \t")) |
| 80 | ;; | 79 | ;; |
| 81 | ;; (concat "^\\(?:" something-else "\\)") | 80 | ;; (concat "^\\(?:" something-else "\\)") |
| 82 | ;; (rx (and line-start (eval something-else))), statically or | 81 | ;; (rx (and line-start (eval something-else))), statically or |
| @@ -962,7 +961,11 @@ CHAR | |||
| 962 | matches 0 through 9, a through f and A through F. | 961 | matches 0 through 9, a through f and A through F. |
| 963 | 962 | ||
| 964 | `blank' | 963 | `blank' |
| 965 | matches space and tab only. | 964 | matches horizontal whitespace, as defined by Annex C of the |
| 965 | Unicode Technical Standard #18. In particular, it matches | ||
| 966 | spaces, tabs, and other characters whose Unicode | ||
| 967 | `general-category' property indicates they are spacing | ||
| 968 | separators. | ||
| 966 | 969 | ||
| 967 | `graphic', `graph' | 970 | `graphic', `graph' |
| 968 | matches graphic characters--everything except whitespace, ASCII | 971 | matches graphic characters--everything except whitespace, ASCII |