Mercurial > emacs
comparison man/custom.texi @ 31075:9c560a17ef4a
(Changing an Option): Change load-path example.
author | Dave Love <fx@gnu.org> |
---|---|
date | Tue, 22 Aug 2000 18:23:04 +0000 |
parents | 203ba1f77b7b |
children | 1c497211a58d |
comparison
equal
deleted
inserted
replaced
31074:d6bc065a3df2 | 31075:9c560a17ef4a |
---|---|
279 the Emacs user options in a logically organized structure, then edit and | 279 the Emacs user options in a logically organized structure, then edit and |
280 set their values. You can also use the customization buffer to save | 280 set their values. You can also use the customization buffer to save |
281 settings permanently. (Not all Emacs user options are included in this | 281 settings permanently. (Not all Emacs user options are included in this |
282 structure as of yet, but we are adding the rest.) | 282 structure as of yet, but we are adding the rest.) |
283 | 283 |
284 The appearance of the example buffers in the following is typically | |
285 different under a window system where faces can be used to indicate the | |
286 active fields and other features. | |
287 | |
284 @menu | 288 @menu |
285 * Groups: Customization Groups. | 289 * Groups: Customization Groups. |
286 How options are classified in a structure. | 290 How options are classified in a structure. |
287 * Changing an Option:: How to edit a value and set an option. | 291 * Changing an Option:: How to edit a value and set an option. |
288 * Face Customization:: How to edit the attributes of a face. | 292 * Face Customization:: How to edit the attributes of a face. |
432 field says @samp{[Toggle]}, and it changes to the other value. | 436 field says @samp{[Toggle]}, and it changes to the other value. |
433 @samp{[Value Menu]} and @samp{[Toggle]} edit the buffer; the changes | 437 @samp{[Value Menu]} and @samp{[Toggle]} edit the buffer; the changes |
434 take effect when you use the @samp{Set for Current Session} operation. | 438 take effect when you use the @samp{Set for Current Session} operation. |
435 | 439 |
436 Some options have values with complex structure. For example, the | 440 Some options have values with complex structure. For example, the |
437 value of @code{load-path} is a list of directories. Here is how it | 441 value of @code{file-coding-system-alist} is an association list. Here |
438 appears in the customization buffer: | 442 is how it appears in the customization buffer: |
439 | 443 |
440 @smallexample | 444 @smallexample |
441 Load Path: | 445 File Coding System Alist: [Hide] |
442 [INS] [DEL] [Current dir?]: /usr/local/share/emacs/20.3/site-lisp | 446 [INS] [DEL] File regexp: \.elc\' |
443 [INS] [DEL] [Current dir?]: /usr/local/share/emacs/site-lisp | 447 Choice: [Value Menu] Encoding/decoding pair: |
444 [INS] [DEL] [Current dir?]: /usr/local/share/emacs/20.3/leim | 448 Decoding: emacs-mule |
445 [INS] [DEL] [Current dir?]: /usr/local/share/emacs/20.3/lisp | 449 Encoding: emacs-mule |
446 [INS] [DEL] [Current dir?]: /build/emacs/e20/lisp | 450 [INS] [DEL] File regexp: \(\`\|/\)loaddefs.el\' |
447 [INS] [DEL] [Current dir?]: /build/emacs/e20/lisp/gnus | 451 Choice: [Value Menu] Encoding/decoding pair: |
448 [INS] | 452 Decoding: no-conversion |
449 [State]: this item has been changed outside the customization buffer. | 453 Encoding: no-conversion |
450 List of directories to search for files to load.... | 454 [INS] [DEL] File regexp: \.tar\' |
455 Choice: [Value Menu] Encoding/decoding pair: | |
456 Decoding: no-conversion | |
457 Encoding: no-conversion | |
458 [INS] [DEL] File regexp: | |
459 Choice: [Value Menu] Encoding/decoding pair: | |
460 Decoding: undecided | |
461 Encoding: nil | |
462 [INS | |
463 [State]: this option is unchanged from its standard setting. | |
464 Alist to decide a coding system to use for a file I/O operation. [Hide] | |
465 @dots{} | |
451 @end smallexample | 466 @end smallexample |
452 | 467 |
453 @noindent | 468 @noindent |
454 Each directory in the list appears on a separate line, and each line has | 469 Each association in the list appears starting on a separate line with |
455 several editable or active fields. | 470 several editable or active fields. |
456 | 471 |
457 You can edit any of the directory names. To delete a directory from | 472 You can edit the regexps and coding systems or select @samp{[Value |
458 the list, invoke @samp{[DEL]} on that line. To insert a new directory in | 473 Menu]} to change the choice for the second part of the pair, e.g.@: to a |
459 the list, invoke @samp{[INS]} at the point where you want to insert it. | 474 function. To delete an item from the list or to add one after another |
460 | 475 item, invoke @samp{[DEL]} or @samp{[INS]} respectively at that item. An inserted item appears with some default values. |
461 You can also invoke @samp{[Current dir?]} to switch between including | 476 Invoke @samp{[+]} to append an extra item to the current list. |
462 a specific named directory in the path, and including @code{nil} in the | |
463 path. (@code{nil} in a search path means ``try the current | |
464 directory.'') | |
465 | 477 |
466 @kindex TAB @r{(customization buffer)} | 478 @kindex TAB @r{(customization buffer)} |
467 @kindex S-TAB @r{(customization buffer)} | 479 @kindex S-TAB @r{(customization buffer)} |
468 @findex widget-forward | 480 @findex widget-forward |
469 @findex widget-backward | 481 @findex widget-backward |
547 faces. When you show the contents of a group, both the user options and | 559 faces. When you show the contents of a group, both the user options and |
548 the faces in the group appear in the customization buffer. Here is an | 560 the faces in the group appear in the customization buffer. Here is an |
549 example of how a face looks: | 561 example of how a face looks: |
550 | 562 |
551 @smallexample | 563 @smallexample |
552 Custom Changed Face: (sample) | 564 Custom Changed Face: (sample) [Hide] |
553 [State]: this face is unchanged from its standard setting. | 565 [State]: this face is unchanged from its standard setting. |
554 Face used when the customize item has been changed. | 566 Parent groups: [Custom Magic Faces] |
555 Attributes: [ ] Bold: [toggle] off | 567 Attributes: [ ] Font family: [Value Menu] * |
556 [X] Italic: [toggle] on | 568 [ ] Width: [Value Menu] * |
557 [ ] Underline: [toggle] off | 569 [ ] Height: [Value Menu] * |
558 [ ] Inverse-Video: [toggle] on | 570 [ ] Weight: [Value Menu] * |
559 [ ] Foreground: black (sample) | 571 [ ] Slant: [Value Menu] * |
560 [ ] Background: white (sample) | 572 [ ] Underline: [Value Menu] * |
561 [ ] Stipple: | 573 [ ] Overline: [Value Menu] * |
574 [ ] Strike-through: [Value Menu] * | |
575 [ ] Box around text: [Value Menu] Off | |
576 [ ] Inverse-video: [Value Menu] * | |
577 [X] Foreground: [Value Menu] Color: white (sample) | |
578 [X] Background: [Value Menu] Color: blue (sample) | |
579 [ ] Stipple: [Value Menu] * | |
562 @end smallexample | 580 @end smallexample |
563 | 581 |
564 Each face attribute has its own line. The @samp{[@var{x}]} field | 582 Each face attribute has its own line. The @samp{[@var{x}]} field |
565 before the attribute name indicates whether the attribute is | 583 before the attribute name indicates whether the attribute is |
566 @dfn{enabled}; @samp{X} means that it is. You can enable or disable the | 584 @dfn{enabled}; @samp{X} means that it is. You can enable or disable the |