aboutsummaryrefslogtreecommitdiffstats
path: root/lisp/term
diff options
context:
space:
mode:
authorPaul Eggert2015-09-11 11:04:24 -0700
committerPaul Eggert2015-09-11 11:05:12 -0700
commit818f06eaa72d8e4f9ba314c1c2855613bf89f396 (patch)
tree225d09e54fc0dbc5f27232caebe5d3055194662d /lisp/term
parent279303adfc6d6ba91db788c2b85333e3fc46f39b (diff)
downloademacs-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/term')
-rw-r--r--lisp/term/README32
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
9to see what type of terminal the user is running on. (If there is an entry 9to see what type of terminal the user is running on. (If there is an entry
10for TERM in the `term-file-aliases' variable, Emacs uses the associated value 10for TERM in the 'term-file-aliases' variable, Emacs uses the associated value
11in place of TERM in the following.) Emacs searches for an elisp file named 11in 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
13suitable file, then it strips the last hyphen and what follows it from TERM, 13suitable file, then it strips the last hyphen and what follows it from TERM,
14and tries again. If that still doesn't yield a file, then the previous hyphen 14and tries again. If that still doesn't yield a file, then the previous hyphen
15is stripped, and so on until all hyphens are gone. For example, if the 15is stripped, and so on until all hyphens are gone. For example, if the
16terminal type is `aaa-48-foo', Emacs will try first `term/aaa-48-foo.el', then 16terminal 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
18first file found, and will not load more than one file for any terminal. Note 18first file found, and will not load more than one file for any terminal. Note
19that it is not an error if Emacs is unable to find a terminal initialization 19that it is not an error if Emacs is unable to find a terminal initialization
20file; in that case, it will simply proceed with the next step without loading 20file; in that case, it will simply proceed with the next step without loading
21any files. 21any 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
24function named `terminal-init-TERMINALNAME' (eg `terminal-init-aaa-48' for the 24function 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
26function is not found, Emacs strips the last component of the name and tries 26function is not found, Emacs strips the last component of the name and tries
27again using the shorter name. This search is independent of the previous file 27again using the shorter name. This search is independent of the previous file
28search, so that you can have terminal initialization functions for a family of 28search, 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.
40given terminal, when the first frame is created on it. The function is not 40given terminal, when the first frame is created on it. The function is not
41called for subsequent frames on the same terminal. Therefore, terminal-init-* 41called for subsequent frames on the same terminal. Therefore, terminal-init-*
42functions should only modify terminal-local variables (such as 42functions 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
44correct to modify frame parameters, since the modifications will only be 44correct to modify frame parameters, since the modifications will only be
45applied for the first frame opened on the terminal. 45applied 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
52cookies it likes, but there are good reasons to stick to the set recognized by 52cookies it likes, but there are good reasons to stick to the set recognized by
53the X-windows code whenever possible. The key symbols recognized by Emacs 53the X-windows code whenever possible. The key symbols recognized by Emacs
54are listed in src/term.c; look for the string `keys' in that file. 54are 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
57terminal mode as on an X console. If there are differences, you can bet 57terminal 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.
61about. It tries to bind many of them to useful things at startup, before your 61about. 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
63is a admittedly poor one; it's incomplete, and not well matched to the set of 63is 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
65were worse. 65were 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
70clarity; also, for a fighting chance that your binding may be useful to someone 70clarity; also, for a fighting chance that your binding may be useful to someone
71else someday. 71else 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
74supports a key_find capability and call your cookie [find]. 74supports a key_find capability and call your cookie [find].
75 75
76Here is a complete list, with corresponding X keysyms. 76Here is a complete list, with corresponding X keysyms.
@@ -184,14 +184,14 @@ key_f36 FQ function key 36
184key_f64 k1 function key 64 184key_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
244normal Emacs key bindings, the package should set up a function called 244normal 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
246it up to the user's .emacs file whether to call it. 246it 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