diff options
| author | Glenn Morris | 2018-02-13 14:22:16 -0800 |
|---|---|---|
| committer | Glenn Morris | 2018-02-13 14:22:16 -0800 |
| commit | 4bee1b8bacb9ce6107ea605da464d01f6bd3aa7d (patch) | |
| tree | dc5dc2098f8956b66620cc1003601f705c289cd2 /src/w32select.c | |
| parent | 6c7186de3bbb2b7652cdc01a68bee035761197e5 (diff) | |
| download | emacs-4bee1b8bacb9ce6107ea605da464d01f6bd3aa7d.tar.gz emacs-4bee1b8bacb9ce6107ea605da464d01f6bd3aa7d.zip | |
Stop keeping multiple doc copies for items defined multiple times
It was always a nuisance to keep all the copies in sync.
* src/doc.c (Fsnarf_documentation): Don't skip entire files.
Instead, skip individual doc strings starting with "SKIP".
* doc/lispref/internals.texi (Writing Emacs Primitives):
Mention this skipping.
* lisp/term/ns-win.el, lisp/term/pc-win.el, src/dosfns.c:
* src/frame.c, src/nsfns.m, src/nsmenu.m, src/nsterm.m:
* src/w16select.c, src/w32fns.c, src/w32menu.c, src/w32select.c:
* src/w32term.c, src/xmenu.c: Remove duplicated doc strings.
* src/xfns.c: Merge in information from doc string duplicates.
Diffstat (limited to 'src/w32select.c')
| -rw-r--r-- | src/w32select.c | 36 |
1 files changed, 2 insertions, 34 deletions
diff --git a/src/w32select.c b/src/w32select.c index c451b7ff933..ce062ccfe61 100644 --- a/src/w32select.c +++ b/src/w32select.c | |||
| @@ -1170,45 +1170,13 @@ syms_of_w32select (void) | |||
| 1170 | defsubr (&Sw32_selection_targets); | 1170 | defsubr (&Sw32_selection_targets); |
| 1171 | 1171 | ||
| 1172 | DEFVAR_LISP ("selection-coding-system", Vselection_coding_system, | 1172 | DEFVAR_LISP ("selection-coding-system", Vselection_coding_system, |
| 1173 | doc: /* Coding system for communicating with other programs. | 1173 | doc: /* SKIP: real doc in select.el. */); |
| 1174 | |||
| 1175 | For MS-Windows and MS-DOS: | ||
| 1176 | When sending or receiving text via selection and clipboard, the text | ||
| 1177 | is encoded or decoded by this coding system. The default value is | ||
| 1178 | the current system default encoding on 9x/Me, `utf-16le-dos' | ||
| 1179 | \(Unicode) on NT/W2K/XP, and `iso-latin-1-dos' on MS-DOS. | ||
| 1180 | |||
| 1181 | For X Windows: | ||
| 1182 | When sending text via selection and clipboard, if the target | ||
| 1183 | data-type matches with the type of this coding system, it is used | ||
| 1184 | for encoding the text. Otherwise (including the case that this | ||
| 1185 | variable is nil), a proper coding system is used as below: | ||
| 1186 | |||
| 1187 | data-type coding system | ||
| 1188 | --------- ------------- | ||
| 1189 | UTF8_STRING utf-8 | ||
| 1190 | COMPOUND_TEXT compound-text-with-extensions | ||
| 1191 | STRING iso-latin-1 | ||
| 1192 | C_STRING no-conversion | ||
| 1193 | |||
| 1194 | When receiving text, if this coding system is non-nil, it is used | ||
| 1195 | for decoding regardless of the data-type. If this is nil, a | ||
| 1196 | proper coding system is used according to the data-type as above. | ||
| 1197 | |||
| 1198 | See also the documentation of the variable `x-select-request-type' how | ||
| 1199 | to control which data-type to request for receiving text. | ||
| 1200 | |||
| 1201 | The default value is nil. */); | ||
| 1202 | /* The actual value is set dynamically in the dumped Emacs, see | 1174 | /* The actual value is set dynamically in the dumped Emacs, see |
| 1203 | below. */ | 1175 | below. */ |
| 1204 | Vselection_coding_system = Qnil; | 1176 | Vselection_coding_system = Qnil; |
| 1205 | 1177 | ||
| 1206 | DEFVAR_LISP ("next-selection-coding-system", Vnext_selection_coding_system, | 1178 | DEFVAR_LISP ("next-selection-coding-system", Vnext_selection_coding_system, |
| 1207 | doc: /* Coding system for the next communication with other programs. | 1179 | doc: /* SKIP: real doc in select.el. */); |
| 1208 | Usually, `selection-coding-system' is used for communicating with | ||
| 1209 | other programs (X Windows clients or MS Windows programs). But, if this | ||
| 1210 | variable is set, it is used for the next communication only. | ||
| 1211 | After the communication, this variable is set to nil. */); | ||
| 1212 | Vnext_selection_coding_system = Qnil; | 1180 | Vnext_selection_coding_system = Qnil; |
| 1213 | 1181 | ||
| 1214 | DEFSYM (QCLIPBOARD, "CLIPBOARD"); | 1182 | DEFSYM (QCLIPBOARD, "CLIPBOARD"); |