Mercurial > hg > xemacs-beta

comparison man/xemacs/custom.texi @ 207:e45d5e7c476e r20-4b2

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import from CVS: tag r20-4b2
author cvs
date Mon, 13 Aug 2007 10:03:52 +0200
parents a2f645c6b9f8
children 65c19d2020f7
comparison
equal deleted inserted replaced
206:d3e9274cbc4e 207:e45d5e7c476e
210 /- Emacs group: ---------------------------------------------------\ 210 /- Emacs group: ---------------------------------------------------\
211 [State]: visible group members are all at standard settings. 211 [State]: visible group members are all at standard settings.
212 Customization of the One True Editor. 212 Customization of the One True Editor.
213 See also [Manual]. 213 See also [Manual].
214 214
215 Editing group: [Go to Group] 215 [Open] Editing group
216 Basic text editing facilities. 216 Basic text editing facilities.
217 217
218 External group: [Go to Group] 218 [Open] External group
219 Interfacing to external utilities. 219 Interfacing to external utilities.
220 220
221 @var{more second-level groups} 221 @var{more second-level groups}
222 222
223 \- Emacs group end ------------------------------------------------/ 223 \- Emacs group end ------------------------------------------------/
238 typically includes some @dfn{editable fields} that you can edit. There 238 typically includes some @dfn{editable fields} that you can edit. There
239 are also @dfn{active fields}; this means a field that does something 239 are also @dfn{active fields}; this means a field that does something
240 when you @dfn{invoke} it. To invoke an active field, either click on it 240 when you @dfn{invoke} it. To invoke an active field, either click on it
241 with @kbd{Mouse-1}, or move point to it and type @key{RET}. 241 with @kbd{Mouse-1}, or move point to it and type @key{RET}.
242 242
243 For example, the phrase @samp{[Go to Group]} that appears in a 243 For example, the phrase @samp{[Open]} that appears in a second-level
244 second-level group is an active field. Invoking the @samp{[Go to 244 group is an active field. Invoking the @samp{[Open]} field for a group
245 Group]} field for a group creates a new customization buffer, which 245 opens up a new customization buffer, which shows that group and its
246 shows that group and its contents. This field is a kind of hypertext 246 contents. This field is a kind of hypertext link to another group.
247 link to another group.
248 247
249 The @code{Emacs} group does not include any user options itself, but 248 The @code{Emacs} group does not include any user options itself, but
250 other groups do. By examining various groups, you will eventually find 249 other groups do. By examining various groups, you will eventually find
251 the options and faces that belong to the feature you are interested in 250 the options and faces that belong to the feature you are interested in
252 customizing. Then you can use the customization buffer to set them. 251 customizing. Then you can use the customization buffer to set them.
390 option variable again each time you start Emacs. To save the option, 389 option variable again each time you start Emacs. To save the option,
391 invoke @samp{[State]} and select the @samp{Save for Future Sessions} 390 invoke @samp{[State]} and select the @samp{Save for Future Sessions}
392 operation. 391 operation.
393 392
394 You can also restore the option to its standard value by invoking 393 You can also restore the option to its standard value by invoking
395 @samp{[State]} and selecting the @samp{Reset to Standard Settings} 394 @samp{[State]} and selecting the @samp{Reset} operation. There are
396 operation. There are actually three reset operations: 395 actually three reset operations:
397 396
398 @table @samp 397 @table @samp
399 @item Reset 398 @item Reset to Current
400 If you have made some modifications and not yet set the option, 399 If you have made some modifications and not yet set the option,
401 this restores the text in the customization buffer to match 400 this restores the text in the customization buffer to match
402 the actual value. 401 the actual value.
403 402
404 @item Reset to Saved 403 @item Reset to Saved
419 418
420 Near the top of the customization buffer there are two lines 419 Near the top of the customization buffer there are two lines
421 containing several active fields: 420 containing several active fields:
422 421
423 @smallexample 422 @smallexample
424 [Set] [Save] [Reset] [Reset to Saved] [Reset to Standard] [Done] 423 [Set] [Save] [Reset] [Done]
425 @end smallexample 424 @end smallexample
426 425
427 @noindent 426 @noindent
428 Invoking @samp{[Done]} buries this customization buffer. Each of the 427 Invoking @samp{[Done]} buries this customization buffer. Each of the
429 other fields performs an operation---set, save or reset---on each of the 428 other fields performs an operation---set, save or reset---on each of the
443 442
444 @smallexample 443 @smallexample
445 Custom Changed Face: (sample) 444 Custom Changed Face: (sample)
446 [State]: this face is unchanged from its standard setting. 445 [State]: this face is unchanged from its standard setting.
447 Face used when the customize item has been changed. 446 Face used when the customize item has been changed.
448 Attributes: [ ] Bold: [toggle] off 447 Parent groups: [Custom Magic Faces]
449 [X] Italic: [toggle] on 448 Attributes: [ ] Bold: [Toggle] off (nil)
450 [ ] Underline: [toggle] off 449 [ ] Italic: [Toggle] off (nil)
451 [ ] Inverse-Video: [toggle] on 450 [ ] Underline: [Toggle] off (nil)
452 [ ] Foreground: black (sample) 451 [ ] Foreground: white (sample)
453 [ ] Background: white (sample) 452 [ ] Background: blue (sample)
454 [ ] Stipple: 453 [ ] Inverse: [Toggle] off (nil)
454 [ ] Stipple:
455 [ ] Font Family:
456 [ ] Size:
457 [ ] Strikethru: off
455 @end smallexample 458 @end smallexample
456 459
457 Each face attribute has its own line. The @samp{[@var{x}]} field 460 Each face attribute has its own line. The @samp{[@var{x}]} field
458 before the attribute name indicates whether the attribute is 461 before the attribute name indicates whether the attribute is
459 @dfn{enabled}; @samp{X} means that it is. You can enable or disable the 462 @dfn{enabled}; @samp{X} means that it is. You can enable or disable the
460 attribute by invoking that field. When the attribute is enabled, you 463 attribute by invoking that field. When the attribute is enabled, you
461 can change the attribute value in the usual ways. 464 can change the attribute value in the usual ways.
462 465
463 On a black-and-white display, the colors you can use for the 466 @c Is this true for XEmacs?
464 background are @samp{black}, @samp{white}, @samp{gray}, @samp{gray1}, 467 @c On a black-and-white display, the colors you can use for the
465 and @samp{gray3}. Emacs supports these shades of gray by using 468 @c background are @samp{black}, @samp{white}, @samp{gray}, @samp{gray1},
466 background stipple patterns instead of a color. 469 @c and @samp{gray3}. Emacs supports these shades of gray by using
467 470 @c background stipple patterns instead of a color.
471 @c
468 Setting, saving and resetting a face work like the same operations for 472 Setting, saving and resetting a face work like the same operations for
469 options (@pxref{Changing an Option}). 473 options (@pxref{Changing an Option}).
470 474
471 A face can specify different appearances for different types of 475 A face can specify different appearances for different types of
472 display. For example, a face can make text red on a color display, but 476 display. For example, a face can make text red on a color display, but
473 use a bold font on a monochrome display. To specify multiple 477 use a bold font on a monochrome display. To specify multiple
474 appearances for a face, select @samp{Show Display Types} in the menu you 478 appearances for a face, select @samp{Show Display Types} in the menu you
475 get from invoking @samp{[State]}. 479 get from invoking @samp{[State]}.
476 480
477 @findex modify-face 481 @c It would be cool to implement this
478 Another more basic way to set the attributes of a specific face is 482 @c @findex modify-face
479 with @kbd{M-x modify-face}. This command reads the name of a face, then 483 @c Another more basic way to set the attributes of a specific face is
480 reads the attributes one by one. For the color and stipple attributes, 484 @c with @kbd{M-x modify-face}. This command reads the name of a face, then
481 the attribute's current value is the default---type just @key{RET} if 485 @c reads the attributes one by one. For the color and stipple attributes,
482 you don't want to change that attribute. Type @samp{none} if you want 486 @c the attribute's current value is the default---type just @key{RET} if
483 to clear out the attribute. 487 @c you don't want to change that attribute. Type @samp{none} if you want
488 @c to clear out the attribute.
484 489
485 @node Specific Customization 490 @node Specific Customization
486 @subsubsection Customizing Specific Items 491 @subsubsection Customizing Specific Items
487 492
488 Instead of finding the options you want to change by moving down 493 Instead of finding the options you want to change by moving down