aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJuanma Barranquero2014-03-21 02:12:57 +0100
committerJuanma Barranquero2014-03-21 02:12:57 +0100
commitdada060d9f65ce57fca99bef6e5a69ee88e126cf (patch)
treedc7777479a3e08d9cf4c2de5941c8882aa2b9e4e
parent1271626ab5d345cdfcd9aca1c528f6ed6152ef96 (diff)
downloademacs-dada060d9f65ce57fca99bef6e5a69ee88e126cf.tar.gz
emacs-dada060d9f65ce57fca99bef6e5a69ee88e126cf.zip
lisp/*.el: Fix typos.
* lisp/align.el (align-regexp): Remove superfluous backslash. * lisp/ffap.el (ffap-ftp-default-user, ffap-url-regexp) (ffap-pass-wildcards-to-dired, dired-at-point-require-prefix) (ffap-rfc-path, ffap-ftp-sans-slash-regexp, ffap-menu-regexp): Fix docstring typos. (ffap-next): Use C-u in docstring. (ffap-machine-p, ffap-list-env, ffap-alist, ffap-alist) (ffap-string-at-point-mode-alist, ffap-menu, ffap-menu-ask): Remove superfluous backslashes. (ffap-string-at-point): Reflow docstring. * lisp/server.el (server-host): Reflow docstring. (server-unload-function): Fix docstring typo. (server-eval-at): Remove superfluous backslash. * lisp/skeleton.el (skeleton-insert): Remove superfluous backslash. (skeleton-insert): Doc fix. (skeleton-insert): Reflow docstring. * lisp/term/tty-colors.el (tty-color-alist, tty-modify-color-alist) (tty-color-approximate, tty-color-by-index, tty-color-values) (tty-color-desc): Remove superfluous backslashes.
-rw-r--r--lisp/ChangeLog26
-rw-r--r--lisp/align.el2
-rw-r--r--lisp/ffap.el40
-rw-r--r--lisp/server.el12
-rw-r--r--lisp/skeleton.el20
-rw-r--r--lisp/term/tty-colors.el14
6 files changed, 70 insertions, 44 deletions
diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 857c086790e..8a9acd99423 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,29 @@
12014-03-21 Juanma Barranquero <lekktu@gmail.com>
2
3 * align.el (align-regexp): Remove superfluous backslash.
4
5 * ffap.el (ffap-ftp-default-user, ffap-url-regexp)
6 (ffap-pass-wildcards-to-dired, dired-at-point-require-prefix)
7 (ffap-rfc-path, ffap-ftp-sans-slash-regexp, ffap-menu-regexp):
8 Fix docstring typos.
9 (ffap-next): Use C-u in docstring.
10 (ffap-machine-p, ffap-list-env, ffap-alist, ffap-alist)
11 (ffap-string-at-point-mode-alist, ffap-menu, ffap-menu-ask):
12 Remove superfluous backslashes.
13 (ffap-string-at-point): Reflow docstring.
14
15 * server.el (server-host): Reflow docstring.
16 (server-unload-function): Fix docstring typo.
17 (server-eval-at): Remove superfluous backslash.
18
19 * skeleton.el (skeleton-insert): Remove superfluous backslash.
20 (skeleton-insert): Doc fix.
21 (skeleton-insert): Reflow docstring.
22
23 * term/tty-colors.el (tty-color-alist, tty-modify-color-alist)
24 (tty-color-approximate, tty-color-by-index, tty-color-values)
25 (tty-color-desc): Remove superfluous backslashes.
26
12014-03-20 Stefan Monnier <monnier@iro.umontreal.ca> 272014-03-20 Stefan Monnier <monnier@iro.umontreal.ca>
2 28
3 * electric.el (electric-newline-and-maybe-indent): New command. 29 * electric.el (electric-newline-and-maybe-indent): New command.
diff --git a/lisp/align.el b/lisp/align.el
index 1efc6e6505b..9038adf624c 100644
--- a/lisp/align.el
+++ b/lisp/align.el
@@ -937,7 +937,7 @@ throughout the line.
937See `align-rules-list' for more information about these options. 937See `align-rules-list' for more information about these options.
938 938
939The non-interactive form of the previous example would look something like: 939The non-interactive form of the previous example would look something like:
940 \(align-regexp (point-min) (point-max) \"\\\\(\\\\s-*\\\\)(\") 940 (align-regexp (point-min) (point-max) \"\\\\(\\\\s-*\\\\)(\")
941 941
942This function is a nothing more than a small wrapper that helps you 942This function is a nothing more than a small wrapper that helps you
943construct a rule to pass to `align-region', which does the real work." 943construct a rule to pass to `align-region', which does the real work."
diff --git a/lisp/ffap.el b/lisp/ffap.el
index 7051273a681..119e0ad3078 100644
--- a/lisp/ffap.el
+++ b/lisp/ffap.el
@@ -164,9 +164,9 @@ schemes (e.g. \"ftp\"); in that case, only convert those URLs."
164 :version "24.3") 164 :version "24.3")
165 165
166(defcustom ffap-ftp-default-user "anonymous" 166(defcustom ffap-ftp-default-user "anonymous"
167 "User name in ftp file names generated by `ffap-host-to-path'. 167 "User name in FTP file names generated by `ffap-host-to-path'.
168Note this name may be omitted if it equals the default 168Note this name may be omitted if it equals the default
169\(either `efs-default-user' or `ange-ftp-default-user'\)." 169\(either `efs-default-user' or `ange-ftp-default-user')."
170 :type 'string 170 :type 'string
171 :group 'ffap) 171 :group 'ffap)
172 172
@@ -185,7 +185,7 @@ Note this name may be omitted if it equals the default
185 "\\|" 185 "\\|"
186 "\\(ftp\\|https?\\|telnet\\|gopher\\|www\\|wais\\)://" ; needs host 186 "\\(ftp\\|https?\\|telnet\\|gopher\\|www\\|wais\\)://" ; needs host
187 "\\)") 187 "\\)")
188 "Regexp matching the beginning of a URI, for FFAP. 188 "Regexp matching the beginning of a URI, for ffap.
189If the value is nil, disable URL-matching features in ffap.") 189If the value is nil, disable URL-matching features in ffap.")
190 190
191(defcustom ffap-foo-at-bar-prefix "mailto" 191(defcustom ffap-foo-at-bar-prefix "mailto"
@@ -228,7 +228,7 @@ it passes it on to `dired'."
228 :group 'ffap) 228 :group 'ffap)
229 229
230(defcustom ffap-pass-wildcards-to-dired nil 230(defcustom ffap-pass-wildcards-to-dired nil
231 "If non-nil, pass filenames matching `ffap-dired-wildcards' to dired." 231 "If non-nil, pass filenames matching `ffap-dired-wildcards' to Dired."
232 :type 'boolean 232 :type 'boolean
233 :group 'ffap) 233 :group 'ffap)
234 234
@@ -291,8 +291,8 @@ For a fancy alternative, get `ffap-url.el'."
291 291
292(defcustom dired-at-point-require-prefix nil 292(defcustom dired-at-point-require-prefix nil
293 "If non-nil, reverse the prefix argument to `dired-at-point'. 293 "If non-nil, reverse the prefix argument to `dired-at-point'.
294This is nil so neophytes notice FFAP. Experts may prefer to 294This is nil so neophytes notice ffap. Experts may prefer to
295disable FFAP most of the time." 295disable ffap most of the time."
296 :type 'boolean 296 :type 'boolean
297 :group 'ffap 297 :group 'ffap
298 :version "20.3") 298 :version "20.3")
@@ -343,7 +343,7 @@ Only considers strings that match `ffap-next-regexp'."
343 "Search buffer for next file or URL, and run ffap. 343 "Search buffer for next file or URL, and run ffap.
344Optional argument BACK says to search backwards. 344Optional argument BACK says to search backwards.
345Optional argument WRAP says to try wrapping around if necessary. 345Optional argument WRAP says to try wrapping around if necessary.
346Interactively: use a single prefix to search backwards, 346Interactively: use a single prefix \\[universal-argument] to search backwards,
347double prefix to wrap forward, triple to wrap backwards. 347double prefix to wrap forward, triple to wrap backwards.
348Actual search is done by the function `ffap-next-guess'." 348Actual search is done by the function `ffap-next-guess'."
349 (interactive 349 (interactive
@@ -413,7 +413,7 @@ See `mail-extr.el' for the known domains."
413Depending on the domain (none, known, or unknown), follow the strategy 413Depending on the domain (none, known, or unknown), follow the strategy
414named by the variable `ffap-machine-p-local', `ffap-machine-p-known', 414named by the variable `ffap-machine-p-local', `ffap-machine-p-known',
415or `ffap-machine-p-unknown'. Pinging uses `open-network-stream'. 415or `ffap-machine-p-unknown'. Pinging uses `open-network-stream'.
416Optional SERVICE specifies the port used \(default \"discard\"\). 416Optional SERVICE specifies the port used (default \"discard\").
417Optional QUIET flag suppresses the \"Pinging...\" message. 417Optional QUIET flag suppresses the \"Pinging...\" message.
418Optional STRATEGY overrides the three variables above. 418Optional STRATEGY overrides the three variables above.
419Returned values: 419Returned values:
@@ -642,7 +642,7 @@ Looks at `ffap-ftp-default-user', returns \"\" for \"localhost\"."
642 642
643(defun ffap-list-env (env &optional empty) 643(defun ffap-list-env (env &optional empty)
644 "Return a list of strings parsed from environment variable ENV. 644 "Return a list of strings parsed from environment variable ENV.
645Optional EMPTY is the default list if \(getenv ENV\) is undefined, and 645Optional EMPTY is the default list if (getenv ENV) is undefined, and
646also is substituted for the first empty-string component, if there is one. 646also is substituted for the first empty-string component, if there is one.
647Uses `path-separator' to separate the path into substrings." 647Uses `path-separator' to separate the path into substrings."
648 ;; We cannot use parse-colon-path (files.el), since it kills 648 ;; We cannot use parse-colon-path (files.el), since it kills
@@ -787,12 +787,12 @@ This uses `ffap-file-exists-string', which may try adding suffixes from
787 . ffap-rfc) ; "100% RFC2100 compliant" 787 . ffap-rfc) ; "100% RFC2100 compliant"
788 (dired-mode . ffap-dired) ; maybe in a subdirectory 788 (dired-mode . ffap-dired) ; maybe in a subdirectory
789 ) 789 )
790 "Alist of \(KEY . FUNCTION\) pairs parsed by `ffap-file-at-point'. 790 "Alist of (KEY . FUNCTION) pairs parsed by `ffap-file-at-point'.
791If string NAME at point (maybe \"\") is not a file or URL, these pairs 791If string NAME at point (maybe \"\") is not a file or URL, these pairs
792specify actions to try creating such a string. A pair matches if either 792specify actions to try creating such a string. A pair matches if either
793 KEY is a symbol, and it equals `major-mode', or 793 KEY is a symbol, and it equals `major-mode', or
794 KEY is a string, it should match NAME as a regexp. 794 KEY is a string, it should match NAME as a regexp.
795On a match, \(FUNCTION NAME\) is called and should return a file, an 795On a match, (FUNCTION NAME) is called and should return a file, an
796URL, or nil. If nil, search the alist for further matches.") 796URL, or nil. If nil, search the alist for further matches.")
797 797
798(put 'ffap-alist 'risky-local-variable t) 798(put 'ffap-alist 'risky-local-variable t)
@@ -980,7 +980,7 @@ If t, `ffap-tex-init' will initialize this when needed.")
980(defcustom ffap-rfc-path 980(defcustom ffap-rfc-path
981 (concat (ffap-host-to-filename "ftp.rfc-editor.org") "/in-notes/rfc%s.txt") 981 (concat (ffap-host-to-filename "ftp.rfc-editor.org") "/in-notes/rfc%s.txt")
982 "A `format' string making a filename for RFC documents. 982 "A `format' string making a filename for RFC documents.
983This can be an ange-ftp or tramp remote filename to download, or 983This can be an ange-ftp or Tramp remote filename to download, or
984a local filename if you have full set of RFCs locally. See also 984a local filename if you have full set of RFCs locally. See also
985`ffap-rfc-directories'." 985`ffap-rfc-directories'."
986 :type 'string 986 :type 'string
@@ -1018,8 +1018,8 @@ If a given RFC isn't in these then `ffap-rfc-path' is offered."
1018 ;; Mathematica paths: allow backquotes 1018 ;; Mathematica paths: allow backquotes
1019 (math-mode ",-:$+<>@-Z_[:lower:]~`" "<" "@>;.,!?`:") 1019 (math-mode ",-:$+<>@-Z_[:lower:]~`" "<" "@>;.,!?`:")
1020 ) 1020 )
1021 "Alist of \(MODE CHARS BEG END\), where MODE is a symbol, 1021 "Alist of (MODE CHARS BEG END), where MODE is a symbol,
1022possibly a major-mode name, or one of the symbol 1022possibly a major-mode name, or one of the symbols
1023`file', `url', `machine', and `nocolon'. 1023`file', `url', `machine', and `nocolon'.
1024Function `ffap-string-at-point' uses the data fields as follows: 1024Function `ffap-string-at-point' uses the data fields as follows:
10251. find a maximal string of CHARS around point, 10251. find a maximal string of CHARS around point,
@@ -1032,8 +1032,8 @@ Function `ffap-string-at-point' uses the data fields as follows:
1032 1032
1033(defun ffap-string-at-point (&optional mode) 1033(defun ffap-string-at-point (&optional mode)
1034 "Return a string of characters from around point. 1034 "Return a string of characters from around point.
1035MODE (defaults to value of `major-mode') is a symbol used to look up string 1035MODE (defaults to value of `major-mode') is a symbol used to look up
1036syntax parameters in `ffap-string-at-point-mode-alist'. 1036string syntax parameters in `ffap-string-at-point-mode-alist'.
1037If MODE is not found, we use `file' instead of MODE. 1037If MODE is not found, we use `file' instead of MODE.
1038If the region is active, return a string from the region. 1038If the region is active, return a string from the region.
1039Sets the variable `ffap-string-at-point' and the variable 1039Sets the variable `ffap-string-at-point' and the variable
@@ -1143,7 +1143,7 @@ The two subexpressions are the KEY and VALUE.")
1143 ;; Icky regexp avoids: default: 123: foo::bar cs:pub 1143 ;; Icky regexp avoids: default: 123: foo::bar cs:pub
1144 ;; It does match on: mic@cs: cs:/pub mathcs.emory.edu: (point at end) 1144 ;; It does match on: mic@cs: cs:/pub mathcs.emory.edu: (point at end)
1145 "\\`\\([^:@]+@[^:@]+:\\|[^@.:]+\\.[^@:]+:\\|[^:]+:[~/]\\)\\([^:]\\|\\'\\)") 1145 "\\`\\([^:@]+@[^:@]+:\\|[^@.:]+\\.[^@:]+:\\|[^:]+:[~/]\\)\\([^:]\\|\\'\\)")
1146 "Strings matching this are coerced to ftp file names by ffap. 1146 "Strings matching this are coerced to FTP file names by ffap.
1147That is, ffap just prepends \"/\". Set to nil to disable.") 1147That is, ffap just prepends \"/\". Set to nil to disable.")
1148 1148
1149(defun ffap-file-at-point () 1149(defun ffap-file-at-point ()
@@ -1445,7 +1445,7 @@ and the functions `ffap-file-at-point' and `ffap-url-at-point'."
1445(defcustom ffap-menu-regexp nil 1445(defcustom ffap-menu-regexp nil
1446 "If non-nil, regexp overriding `ffap-next-regexp' in `ffap-menu'. 1446 "If non-nil, regexp overriding `ffap-next-regexp' in `ffap-menu'.
1447Make this more restrictive for faster menu building. 1447Make this more restrictive for faster menu building.
1448For example, try \":/\" for URL (and some ftp) references." 1448For example, try \":/\" for URL (and some FTP) references."
1449 :type '(choice (const nil) regexp) 1449 :type '(choice (const nil) regexp)
1450 :group 'ffap) 1450 :group 'ffap)
1451 1451
@@ -1465,7 +1465,7 @@ These properties may be used to fontify the menu references.")
1465 "Put up a menu of files and URLs mentioned in this buffer. 1465 "Put up a menu of files and URLs mentioned in this buffer.
1466Then set mark, jump to choice, and try to fetch it. The menu is 1466Then set mark, jump to choice, and try to fetch it. The menu is
1467cached in `ffap-menu-alist', and rebuilt by `ffap-menu-rescan'. 1467cached in `ffap-menu-alist', and rebuilt by `ffap-menu-rescan'.
1468The optional RESCAN argument \(a prefix, interactively\) forces 1468The optional RESCAN argument (a prefix, interactively) forces
1469a rebuild. Searches with `ffap-menu-regexp'." 1469a rebuild. Searches with `ffap-menu-regexp'."
1470 (interactive "P") 1470 (interactive "P")
1471 ;; (require 'imenu) -- no longer used, but roughly emulated 1471 ;; (require 'imenu) -- no longer used, but roughly emulated
@@ -1498,7 +1498,7 @@ a rebuild. Searches with `ffap-menu-regexp'."
1498 1498
1499(defun ffap-menu-ask (title alist cont) 1499(defun ffap-menu-ask (title alist cont)
1500 "Prompt from a menu of choices, and then apply some action. 1500 "Prompt from a menu of choices, and then apply some action.
1501Arguments are TITLE, ALIST, and CONT \(a continuation function\). 1501Arguments are TITLE, ALIST, and CONT (a continuation function).
1502This uses either a menu or the minibuffer depending on invocation. 1502This uses either a menu or the minibuffer depending on invocation.
1503The TITLE string is used as either the prompt or menu title. 1503The TITLE string is used as either the prompt or menu title.
1504Each ALIST entry looks like (STRING . DATA) and defines one choice. 1504Each ALIST entry looks like (STRING . DATA) and defines one choice.
diff --git a/lisp/server.el b/lisp/server.el
index a8e4444b999..0c645889d75 100644
--- a/lisp/server.el
+++ b/lisp/server.el
@@ -104,10 +104,10 @@
104 "The name or IP address to use as host address of the server process. 104 "The name or IP address to use as host address of the server process.
105If set, the server accepts remote connections; otherwise it is local. 105If set, the server accepts remote connections; otherwise it is local.
106 106
107DO NOT give this a non-nil value unless you know what you are 107DO NOT give this a non-nil value unless you know what you are doing!
108doing! On unsecured networks, accepting remote connections is 108On unsecured networks, accepting remote connections is very dangerous,
109very dangerous, because server-client communication (including 109because server-client communication (including session authentication)
110session authentication) is not encrypted." 110is not encrypted."
111 :group 'server 111 :group 'server
112 :type '(choice 112 :type '(choice
113 (string :tag "Name or IP address") 113 (string :tag "Name or IP address")
@@ -1634,7 +1634,7 @@ only these files will be asked to be saved."
1634(define-key ctl-x-map "#" 'server-edit) 1634(define-key ctl-x-map "#" 'server-edit)
1635 1635
1636(defun server-unload-function () 1636(defun server-unload-function ()
1637 "Unload the server library." 1637 "Unload the Server library."
1638 (server-mode -1) 1638 (server-mode -1)
1639 (substitute-key-definition 'server-edit nil ctl-x-map) 1639 (substitute-key-definition 'server-edit nil ctl-x-map)
1640 (save-current-buffer 1640 (save-current-buffer
@@ -1648,7 +1648,7 @@ only these files will be asked to be saved."
1648 "Contact the Emacs server named SERVER and evaluate FORM there. 1648 "Contact the Emacs server named SERVER and evaluate FORM there.
1649Returns the result of the evaluation, or signals an error if it 1649Returns the result of the evaluation, or signals an error if it
1650cannot contact the specified server. For example: 1650cannot contact the specified server. For example:
1651 \(server-eval-at \"server\" '(emacs-pid)) 1651 (server-eval-at \"server\" '(emacs-pid))
1652returns the process ID of the Emacs instance running \"server\"." 1652returns the process ID of the Emacs instance running \"server\"."
1653 (let* ((server-dir (if server-use-tcp server-auth-dir server-socket-dir)) 1653 (let* ((server-dir (if server-use-tcp server-auth-dir server-socket-dir))
1654 (server-file (expand-file-name server server-dir)) 1654 (server-file (expand-file-name server server-dir))
diff --git a/lisp/skeleton.el b/lisp/skeleton.el
index 767f0b3490b..21f00d16c82 100644
--- a/lisp/skeleton.el
+++ b/lisp/skeleton.el
@@ -183,7 +183,7 @@ of `str' whereas the skeleton's interactor is then ignored."
183With optional second argument REGIONS, wrap first interesting point 183With optional second argument REGIONS, wrap first interesting point
184\(`_') in skeleton around next REGIONS words, if REGIONS is positive. 184\(`_') in skeleton around next REGIONS words, if REGIONS is positive.
185If REGIONS is negative, wrap REGIONS preceding interregions into first 185If REGIONS is negative, wrap REGIONS preceding interregions into first
186REGIONS interesting positions \(successive `_'s) in skeleton. 186REGIONS interesting positions (successive `_'s) in skeleton.
187 187
188An interregion is the stretch of text between two contiguous marked 188An interregion is the stretch of text between two contiguous marked
189points. If you marked A B C [] (where [] is the cursor) in 189points. If you marked A B C [] (where [] is the cursor) in
@@ -208,21 +208,21 @@ If ELEMENT is a string or a character it gets inserted (see also
208 @ add position to `skeleton-positions' 208 @ add position to `skeleton-positions'
209 & do next ELEMENT if previous moved point 209 & do next ELEMENT if previous moved point
210 | do next ELEMENT if previous didn't move point 210 | do next ELEMENT if previous didn't move point
211 -num delete num preceding characters (see `skeleton-untabify') 211 -NUM delete NUM preceding characters (see `skeleton-untabify')
212 resume: skipped, continue here if quit is signaled 212 resume: skipped, continue here if quit is signaled
213 nil skipped 213 nil skipped
214 214
215After termination, point will be positioned at the last occurrence of - 215After termination, point will be positioned at the last occurrence of -
216or at the first occurrence of _ or at the end of the inserted text. 216or at the first occurrence of _ or at the end of the inserted text.
217 217
218Further elements can be defined via `skeleton-further-elements'. ELEMENT may 218Further elements can be defined via `skeleton-further-elements'.
219itself be a SKELETON with an INTERACTOR. The user is prompted repeatedly for 219ELEMENT may itself be a SKELETON with an INTERACTOR. The user is prompted
220different inputs. The SKELETON is processed as often as the user enters a 220repeatedly for different inputs. The SKELETON is processed as often as
221non-empty string. \\[keyboard-quit] terminates skeleton insertion, but 221the user enters a non-empty string. \\[keyboard-quit] terminates skeleton insertion, but
222continues after `resume:' and positions at `_' if any. If INTERACTOR in such 222continues after `resume:' and positions at `_' if any. If INTERACTOR in
223a subskeleton is a prompt-string which contains a \".. %s ..\" it is 223such a subskeleton is a prompt-string which contains a \".. %s ..\" it is
224formatted with `skeleton-subprompt'. Such an INTERACTOR may also be a list of 224formatted with `skeleton-subprompt'. Such an INTERACTOR may also be a list
225strings with the subskeleton being repeated once for each string. 225of strings with the subskeleton being repeated once for each string.
226 226
227Quoted Lisp expressions are evaluated for their side-effects. 227Quoted Lisp expressions are evaluated for their side-effects.
228Other Lisp expressions are evaluated and the value treated as above. 228Other Lisp expressions are evaluated and the value treated as above.
diff --git a/lisp/term/tty-colors.el b/lisp/term/tty-colors.el
index 60be0a40f58..7e53a98d02a 100644
--- a/lisp/term/tty-colors.el
+++ b/lisp/term/tty-colors.el
@@ -771,7 +771,7 @@
771 "Return an alist of colors supported by FRAME's terminal. 771 "Return an alist of colors supported by FRAME's terminal.
772FRAME defaults to the selected frame. 772FRAME defaults to the selected frame.
773Each element of the returned alist is of the form: 773Each element of the returned alist is of the form:
774 \(NAME INDEX R G B\) 774 (NAME INDEX R G B)
775where NAME is the name of the color, a string; 775where NAME is the name of the color, a string;
776INDEX is the index of this color to be sent to the terminal driver 776INDEX is the index of this color to be sent to the terminal driver
777when the color should be displayed; it is typically a small integer; 777when the color should be displayed; it is typically a small integer;
@@ -785,10 +785,10 @@ color."
785 785
786(defun tty-modify-color-alist (elt &optional frame) 786(defun tty-modify-color-alist (elt &optional frame)
787 "Put the association ELT into the alist of terminal colors for FRAME. 787 "Put the association ELT into the alist of terminal colors for FRAME.
788ELT should be of the form \(NAME INDEX R G B\) (see `tty-color-alist' 788ELT should be of the form (NAME INDEX R G B) (see `tty-color-alist'
789for details). 789for details).
790If the association for NAME already exists in the color alist, it is 790If the association for NAME already exists in the color alist, it is
791modified to specify \(INDEX R G B\) as its cdr. Otherwise, ELT is 791modified to specify (INDEX R G B) as its cdr. Otherwise, ELT is
792appended to the end of the color alist. 792appended to the end of the color alist.
793If FRAME is unspecified or nil, it defaults to the selected frame. 793If FRAME is unspecified or nil, it defaults to the selected frame.
794Value is the modified color alist for FRAME." 794Value is the modified color alist for FRAME."
@@ -856,7 +856,7 @@ of gray, thus the name."
856 856
857(defun tty-color-approximate (rgb &optional frame) 857(defun tty-color-approximate (rgb &optional frame)
858 "Find the color in `tty-color-alist' that best approximates RGB. 858 "Find the color in `tty-color-alist' that best approximates RGB.
859Value is a list of the form \(NAME INDEX R G B\). 859Value is a list of the form (NAME INDEX R G B).
860The argument RGB should be an rgb value, that is, a list of three 860The argument RGB should be an rgb value, that is, a list of three
861integers in the 0..65535 range. 861integers in the 0..65535 range.
862FRAME defaults to the selected frame." 862FRAME defaults to the selected frame."
@@ -981,7 +981,7 @@ If FRAME is unspecified or nil, it defaults to the selected frame."
981 "Given a numeric index of a tty color, return its description. 981 "Given a numeric index of a tty color, return its description.
982 982
983FRAME, if unspecified or nil, defaults to the selected frame. 983FRAME, if unspecified or nil, defaults to the selected frame.
984Value is a list of the form \(NAME INDEX R G B\)." 984Value is a list of the form (NAME INDEX R G B)."
985 (and idx 985 (and idx
986 (let ((colors (tty-color-alist frame)) 986 (let ((colors (tty-color-alist frame))
987 desc found) 987 desc found)
@@ -997,14 +997,14 @@ Value is a list of the form \(NAME INDEX R G B\)."
997 997
998If COLOR is not directly supported by the display, return the RGB 998If COLOR is not directly supported by the display, return the RGB
999values for a supported color that is its best approximation. 999values for a supported color that is its best approximation.
1000The value is a list of integer RGB values--\(RED GREEN BLUE\). 1000The value is a list of integer RGB values--(RED GREEN BLUE).
1001These values range from 0 to 65535; white is (65535 65535 65535). 1001These values range from 0 to 65535; white is (65535 65535 65535).
1002If FRAME is omitted or nil, use the selected frame." 1002If FRAME is omitted or nil, use the selected frame."
1003 (cddr (tty-color-desc color frame))) 1003 (cddr (tty-color-desc color frame)))
1004 1004
1005(defun tty-color-desc (color &optional frame) 1005(defun tty-color-desc (color &optional frame)
1006 "Return the description of the color COLOR for a character terminal. 1006 "Return the description of the color COLOR for a character terminal.
1007Value is a list of the form \(NAME INDEX R G B\). The returned NAME or 1007Value is a list of the form (NAME INDEX R G B). The returned NAME or
1008RGB value may not be the same as the argument COLOR, because the latter 1008RGB value may not be the same as the argument COLOR, because the latter
1009might need to be approximated if it is not supported directly." 1009might need to be approximated if it is not supported directly."
1010 (and (stringp color) 1010 (and (stringp color)