Commit c9f2d80c authored by Dave Love's avatar Dave Love
Browse files

(Changing an Option): Change load-path example.

parent bae2aa40
...@@ -281,6 +281,10 @@ set their values. You can also use the customization buffer to save ...@@ -281,6 +281,10 @@ set their values. You can also use the customization buffer to save
settings permanently. (Not all Emacs user options are included in this settings permanently. (Not all Emacs user options are included in this
structure as of yet, but we are adding the rest.) structure as of yet, but we are adding the rest.)
The appearance of the example buffers in the following is typically
different under a window system where faces can be used to indicate the
active fields and other features.
@menu @menu
* Groups: Customization Groups. * Groups: Customization Groups.
How options are classified in a structure. How options are classified in a structure.
...@@ -434,34 +438,42 @@ field says @samp{[Toggle]}, and it changes to the other value. ...@@ -434,34 +438,42 @@ field says @samp{[Toggle]}, and it changes to the other value.
take effect when you use the @samp{Set for Current Session} operation. take effect when you use the @samp{Set for Current Session} operation.
Some options have values with complex structure. For example, the Some options have values with complex structure. For example, the
value of @code{load-path} is a list of directories. Here is how it value of @code{file-coding-system-alist} is an association list. Here
appears in the customization buffer: is how it appears in the customization buffer:
@smallexample @smallexample
Load Path: File Coding System Alist: [Hide]
[INS] [DEL] [Current dir?]: /usr/local/share/emacs/20.3/site-lisp [INS] [DEL] File regexp: \.elc\'
[INS] [DEL] [Current dir?]: /usr/local/share/emacs/site-lisp Choice: [Value Menu] Encoding/decoding pair:
[INS] [DEL] [Current dir?]: /usr/local/share/emacs/20.3/leim Decoding: emacs-mule
[INS] [DEL] [Current dir?]: /usr/local/share/emacs/20.3/lisp Encoding: emacs-mule
[INS] [DEL] [Current dir?]: /build/emacs/e20/lisp [INS] [DEL] File regexp: \(\`\|/\)loaddefs.el\'
[INS] [DEL] [Current dir?]: /build/emacs/e20/lisp/gnus Choice: [Value Menu] Encoding/decoding pair:
[INS] Decoding: no-conversion
[State]: this item has been changed outside the customization buffer. Encoding: no-conversion
List of directories to search for files to load.... [INS] [DEL] File regexp: \.tar\'
Choice: [Value Menu] Encoding/decoding pair:
Decoding: no-conversion
Encoding: no-conversion
[INS] [DEL] File regexp:
Choice: [Value Menu] Encoding/decoding pair:
Decoding: undecided
Encoding: nil
[INS
[State]: this option is unchanged from its standard setting.
Alist to decide a coding system to use for a file I/O operation. [Hide]
@dots{}
@end smallexample @end smallexample
@noindent @noindent
Each directory in the list appears on a separate line, and each line has Each association in the list appears starting on a separate line with
several editable or active fields. several editable or active fields.
You can edit any of the directory names. To delete a directory from You can edit the regexps and coding systems or select @samp{[Value
the list, invoke @samp{[DEL]} on that line. To insert a new directory in Menu]} to change the choice for the second part of the pair, e.g.@: to a
the list, invoke @samp{[INS]} at the point where you want to insert it. function. To delete an item from the list or to add one after another
item, invoke @samp{[DEL]} or @samp{[INS]} respectively at that item. An inserted item appears with some default values.
You can also invoke @samp{[Current dir?]} to switch between including Invoke @samp{[+]} to append an extra item to the current list.
a specific named directory in the path, and including @code{nil} in the
path. (@code{nil} in a search path means ``try the current
directory.'')
@kindex TAB @r{(customization buffer)} @kindex TAB @r{(customization buffer)}
@kindex S-TAB @r{(customization buffer)} @kindex S-TAB @r{(customization buffer)}
...@@ -549,16 +561,22 @@ the faces in the group appear in the customization buffer. Here is an ...@@ -549,16 +561,22 @@ the faces in the group appear in the customization buffer. Here is an
example of how a face looks: example of how a face looks:
@smallexample @smallexample
Custom Changed Face: (sample) Custom Changed Face: (sample) [Hide]
[State]: this face is unchanged from its standard setting. [State]: this face is unchanged from its standard setting.
Face used when the customize item has been changed. Parent groups: [Custom Magic Faces]
Attributes: [ ] Bold: [toggle] off Attributes: [ ] Font family: [Value Menu] *
[X] Italic: [toggle] on [ ] Width: [Value Menu] *
[ ] Underline: [toggle] off [ ] Height: [Value Menu] *
[ ] Inverse-Video: [toggle] on [ ] Weight: [Value Menu] *
[ ] Foreground: black (sample) [ ] Slant: [Value Menu] *
[ ] Background: white (sample) [ ] Underline: [Value Menu] *
[ ] Stipple: [ ] Overline: [Value Menu] *
[ ] Strike-through: [Value Menu] *
[ ] Box around text: [Value Menu] Off
[ ] Inverse-video: [Value Menu] *
[X] Foreground: [Value Menu] Color: white (sample)
[X] Background: [Value Menu] Color: blue (sample)
[ ] Stipple: [Value Menu] *
@end smallexample @end smallexample
Each face attribute has its own line. The @samp{[@var{x}]} field Each face attribute has its own line. The @samp{[@var{x}]} field
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment