Mercurial > hg > xemacs-beta

comparison man/custom.texi @ 26:441bb1e64a06 r19-15b96

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import from CVS: tag r19-15b96
author cvs
date Mon, 13 Aug 2007 08:51:32 +0200
parents 4103f0995bd7
children 1917ad0d78d7
comparison
equal deleted inserted replaced
25:383a494979f8 26:441bb1e64a06
11 11
12 @node Top, Introduction, (dir), (dir) 12 @node Top, Introduction, (dir), (dir)
13 @comment node-name, next, previous, up 13 @comment node-name, next, previous, up
14 @top The Customization Library 14 @top The Customization Library
15 15
16 Version: 1.44 16 Version: 1.46
17 17
18 @menu 18 @menu
19 * Introduction:: 19 * Introduction::
20 * User Commands:: 20 * User Commands::
21 * The Customization Buffer:: 21 * The Customization Buffer::
408 408
409 @menu 409 @menu
410 * Declaring Groups:: 410 * Declaring Groups::
411 * Declaring Variables:: 411 * Declaring Variables::
412 * Declaring Faces:: 412 * Declaring Faces::
413 * Usage for Package Authors::
413 @end menu 414 @end menu
414 415
415 All the customization declarations can be changes by keyword arguments. 416 All the customization declarations can be changes by keyword arguments.
416 Groups, variables, and faces all share these common keywords: 417 Groups, variables, and faces all share these common keywords:
417 418
508 509
509 If @var{symbol} is a hook variable, @var{option} should be a hook 510 If @var{symbol} is a hook variable, @var{option} should be a hook
510 member. For other types variables, the effect is undefined." 511 member. For other types variables, the effect is undefined."
511 @end defun 512 @end defun
512 513
513 @node Declaring Faces, , Declaring Variables, Declarations 514 @node Declaring Faces, Usage for Package Authors, Declaring Variables, Declarations
514 @comment node-name, next, previous, up 515 @comment node-name, next, previous, up
515 @subsection Declaring Faces 516 @subsection Declaring Faces
516 517
517 Faces are declared with @code{defface}. 518 Faces are declared with @code{defface}.
518 519
562 properties saved by the user, and @code{face-documentation} for the 563 properties saved by the user, and @code{face-documentation} for the
563 documentation string.@refill 564 documentation string.@refill
564 565
565 @end defun 566 @end defun
566 567
568 @node Usage for Package Authors, , Declaring Faces, Declarations
569 @comment node-name, next, previous, up
570 @subsection Usage for Package Authors
571
572 The recommended usage for the author of a typical emacs lisp package is
573 to create one group identifying the package, and make all user options
574 and faces members of that group. If the package has more than around 20
575 such options, they should be divided into a number of subgroups, with
576 each subgroup being member of the top level group.
577
578 The top level group for the package should itself be member of one or
579 more of the standard customization groups. There exists a group for
580 each @emph{finder} keyword. Press @kbd{C-c p} to see a list of finder
581 keywords, and add you group to each of them, using the @code{:group}
582 keyword.
583
567 @node Utilities, The Init File, Declarations, Top 584 @node Utilities, The Init File, Declarations, Top
568 @comment node-name, next, previous, up 585 @comment node-name, next, previous, up
569 @section Utilities 586 @section Utilities
570 587
571 These utilities can come in handy when adding customization support. 588 These utilities can come in handy when adding customization support.