diff options
| author | Paul Eggert | 2015-09-11 11:04:24 -0700 |
|---|---|---|
| committer | Paul Eggert | 2015-09-11 11:05:12 -0700 |
| commit | 818f06eaa72d8e4f9ba314c1c2855613bf89f396 (patch) | |
| tree | 225d09e54fc0dbc5f27232caebe5d3055194662d /lisp | |
| parent | 279303adfc6d6ba91db788c2b85333e3fc46f39b (diff) | |
| download | emacs-818f06eaa72d8e4f9ba314c1c2855613bf89f396.tar.gz emacs-818f06eaa72d8e4f9ba314c1c2855613bf89f396.zip | |
Prefer straight quoting in some text files
Mostly this just changes ` to ' in static text. Some exceptions:
* INSTALL.REPO: Use curved quotes, as the diagnostic in question
typically does that now.
* admin/quick-install-emacs (TRY, top level):
Use straight quoting in diagnostics.
* src/README: Fix working-directory confusion.
Diffstat (limited to 'lisp')
| -rw-r--r-- | lisp/term/README | 32 |
1 files changed, 16 insertions, 16 deletions
diff --git a/lisp/term/README b/lisp/term/README index 35715d97bb4..d01f133e5fb 100644 --- a/lisp/term/README +++ b/lisp/term/README | |||
| @@ -7,22 +7,22 @@ terminal types. | |||
| 7 | 7 | ||
| 8 | When Emacs opens a new terminal, it checks the TERM environment variable | 8 | When Emacs opens a new terminal, it checks the TERM environment variable |
| 9 | to see what type of terminal the user is running on. (If there is an entry | 9 | to see what type of terminal the user is running on. (If there is an entry |
| 10 | for TERM in the `term-file-aliases' variable, Emacs uses the associated value | 10 | for TERM in the 'term-file-aliases' variable, Emacs uses the associated value |
| 11 | in place of TERM in the following.) Emacs searches for an elisp file named | 11 | in place of TERM in the following.) Emacs searches for an elisp file named |
| 12 | "term/${TERM}.el", and if one exists, loads it. If Emacs finds no | 12 | "term/${TERM}.el", and if one exists, loads it. If Emacs finds no |
| 13 | suitable file, then it strips the last hyphen and what follows it from TERM, | 13 | suitable file, then it strips the last hyphen and what follows it from TERM, |
| 14 | and tries again. If that still doesn't yield a file, then the previous hyphen | 14 | and tries again. If that still doesn't yield a file, then the previous hyphen |
| 15 | is stripped, and so on until all hyphens are gone. For example, if the | 15 | is stripped, and so on until all hyphens are gone. For example, if the |
| 16 | terminal type is `aaa-48-foo', Emacs will try first `term/aaa-48-foo.el', then | 16 | terminal type is 'aaa-48-foo', Emacs will try first 'term/aaa-48-foo.el', then |
| 17 | `term/aaa-48.el' and finally `term/aaa.el'. Emacs stops searching at the | 17 | 'term/aaa-48.el' and finally 'term/aaa.el'. Emacs stops searching at the |
| 18 | first file found, and will not load more than one file for any terminal. Note | 18 | first file found, and will not load more than one file for any terminal. Note |
| 19 | that it is not an error if Emacs is unable to find a terminal initialization | 19 | that it is not an error if Emacs is unable to find a terminal initialization |
| 20 | file; in that case, it will simply proceed with the next step without loading | 20 | file; in that case, it will simply proceed with the next step without loading |
| 21 | any files. | 21 | any files. |
| 22 | 22 | ||
| 23 | Once the file has been loaded (or the search failed), Emacs tries to call a | 23 | Once the file has been loaded (or the search failed), Emacs tries to call a |
| 24 | function named `terminal-init-TERMINALNAME' (eg `terminal-init-aaa-48' for the | 24 | function named 'terminal-init-TERMINALNAME' (eg 'terminal-init-aaa-48' for the |
| 25 | `aaa-48' terminal) in order to initialize the terminal. Once again, if the | 25 | 'aaa-48' terminal) in order to initialize the terminal. Once again, if the |
| 26 | function is not found, Emacs strips the last component of the name and tries | 26 | function is not found, Emacs strips the last component of the name and tries |
| 27 | again using the shorter name. This search is independent of the previous file | 27 | again using the shorter name. This search is independent of the previous file |
| 28 | search, so that you can have terminal initialization functions for a family of | 28 | search, so that you can have terminal initialization functions for a family of |
| @@ -40,7 +40,7 @@ declaration. Simply loading the file should not have any side effect. | |||
| 40 | given terminal, when the first frame is created on it. The function is not | 40 | given terminal, when the first frame is created on it. The function is not |
| 41 | called for subsequent frames on the same terminal. Therefore, terminal-init-* | 41 | called for subsequent frames on the same terminal. Therefore, terminal-init-* |
| 42 | functions should only modify terminal-local variables (such as | 42 | functions should only modify terminal-local variables (such as |
| 43 | `local-function-key-map') and terminal parameters. For example, it is not | 43 | 'local-function-key-map') and terminal parameters. For example, it is not |
| 44 | correct to modify frame parameters, since the modifications will only be | 44 | correct to modify frame parameters, since the modifications will only be |
| 45 | applied for the first frame opened on the terminal. | 45 | applied for the first frame opened on the terminal. |
| 46 | 46 | ||
| @@ -51,7 +51,7 @@ mind. | |||
| 51 | First, about keycap names. Your terminal package can create any keycap | 51 | First, about keycap names. Your terminal package can create any keycap |
| 52 | cookies it likes, but there are good reasons to stick to the set recognized by | 52 | cookies it likes, but there are good reasons to stick to the set recognized by |
| 53 | the X-windows code whenever possible. The key symbols recognized by Emacs | 53 | the X-windows code whenever possible. The key symbols recognized by Emacs |
| 54 | are listed in src/term.c; look for the string `keys' in that file. | 54 | are listed in src/term.c; look for the string 'keys' in that file. |
| 55 | 55 | ||
| 56 | For one thing, it means that you'll have the same Emacs key bindings on in | 56 | For one thing, it means that you'll have the same Emacs key bindings on in |
| 57 | terminal mode as on an X console. If there are differences, you can bet | 57 | terminal mode as on an X console. If there are differences, you can bet |
| @@ -61,7 +61,7 @@ they'll frustrate you after you've forgotten about them. | |||
| 61 | about. It tries to bind many of them to useful things at startup, before your | 61 | about. It tries to bind many of them to useful things at startup, before your |
| 62 | .emacs is read (so you can override them). In some ways, the X keysym standard | 62 | .emacs is read (so you can override them). In some ways, the X keysym standard |
| 63 | is a admittedly poor one; it's incomplete, and not well matched to the set of | 63 | is a admittedly poor one; it's incomplete, and not well matched to the set of |
| 64 | `virtual keys' that UNIX terminfo(3) provides. But, trust us, the alternatives | 64 | 'virtual keys' that UNIX terminfo(3) provides. But, trust us, the alternatives |
| 65 | were worse. | 65 | were worse. |
| 66 | 66 | ||
| 67 | This doesn't mean that if your terminal has a "Cokebottle" key you shouldn't | 67 | This doesn't mean that if your terminal has a "Cokebottle" key you shouldn't |
| @@ -70,7 +70,7 @@ that set, try to pattern them on the standard terminfo variable names for | |||
| 70 | clarity; also, for a fighting chance that your binding may be useful to someone | 70 | clarity; also, for a fighting chance that your binding may be useful to someone |
| 71 | else someday. | 71 | else someday. |
| 72 | 72 | ||
| 73 | For example, if your terminal has a `find' key, observe that terminfo | 73 | For example, if your terminal has a 'find' key, observe that terminfo |
| 74 | supports a key_find capability and call your cookie [find]. | 74 | supports a key_find capability and call your cookie [find]. |
| 75 | 75 | ||
| 76 | Here is a complete list, with corresponding X keysyms. | 76 | Here is a complete list, with corresponding X keysyms. |
| @@ -184,14 +184,14 @@ key_f36 FQ function key 36 | |||
| 184 | key_f64 k1 function key 64 | 184 | key_f64 k1 function key 64 |
| 185 | 185 | ||
| 186 | (1) The terminfo documentation says this may be the 'insert character' or | 186 | (1) The terminfo documentation says this may be the 'insert character' or |
| 187 | `enter insert mode' key. Accordingly, key_ic is mapped to the `insertchar' | 187 | 'enter insert mode' key. Accordingly, key_ic is mapped to the 'insertchar' |
| 188 | keysym if there is also a key_dc key; otherwise it's mapped to `insert'. | 188 | keysym if there is also a key_dc key; otherwise it's mapped to 'insert'. |
| 189 | The presumption is that keyboards with `insert character' keys usually | 189 | The presumption is that keyboards with 'insert character' keys usually |
| 190 | have `delete character' keys paired with them. | 190 | have 'delete character' keys paired with them. |
| 191 | 191 | ||
| 192 | (2) If there is no key_next key but there is a key_npage key, key_npage | 192 | (2) If there is no key_next key but there is a key_npage key, key_npage |
| 193 | will be bound to the `next' keysym. If there is no key_previous key but | 193 | will be bound to the 'next' keysym. If there is no key_previous key but |
| 194 | there is a key_ppage key, key_ppage will be bound to the `previous' keysym. | 194 | there is a key_ppage key, key_ppage will be bound to the 'previous' keysym. |
| 195 | 195 | ||
| 196 | (3) Sorry, these are not exact but they're the best we can do. | 196 | (3) Sorry, these are not exact but they're the best we can do. |
| 197 | 197 | ||
| @@ -242,7 +242,7 @@ the setup code to bind anything else. | |||
| 242 | 242 | ||
| 243 | If your terminal's arrow key sequences are so funky that they conflict with | 243 | If your terminal's arrow key sequences are so funky that they conflict with |
| 244 | normal Emacs key bindings, the package should set up a function called | 244 | normal Emacs key bindings, the package should set up a function called |
| 245 | (enable-foo-arrow-keys), where `foo' becomes the terminal name, and leave | 245 | (enable-foo-arrow-keys), where 'foo' becomes the terminal name, and leave |
| 246 | it up to the user's .emacs file whether to call it. | 246 | it up to the user's .emacs file whether to call it. |
| 247 | 247 | ||
| 248 | Before writing a terminal-support package, it's a good idea to read the | 248 | Before writing a terminal-support package, it's a good idea to read the |