Mercurial > emacs
comparison man/custom.texi @ 75012:b1c1e60969db
(Specific Customization): Document customize-option
instead of customize-variable.
author | Richard M. Stallman <rms@gnu.org> |
---|---|
date | Mon, 01 Jan 2007 01:57:16 +0000 |
parents | e81b342a6e8a |
children | 28b09f927c55 e4e4a56ef723 |
comparison
equal
deleted
inserted
replaced
75011:c918cd93c615 | 75012:b1c1e60969db |
---|---|
623 Instead of finding the setting you want to change by navigating the | 623 Instead of finding the setting you want to change by navigating the |
624 structure of groups, here are other ways to specify the settings that | 624 structure of groups, here are other ways to specify the settings that |
625 you want to customize. | 625 you want to customize. |
626 | 626 |
627 @table @kbd | 627 @table @kbd |
628 @item M-x customize-variable @key{RET} @var{variable} @key{RET} | 628 @item M-x customize-option @key{RET} @var{option} @key{RET} |
629 Set up a customization buffer with just one variable, @var{variable}. | 629 Set up a customization buffer with just one user option variable, |
630 @var{option}. | |
630 @item M-x customize-face @key{RET} @var{face} @key{RET} | 631 @item M-x customize-face @key{RET} @var{face} @key{RET} |
631 Set up a customization buffer with just one face, @var{face}. | 632 Set up a customization buffer with just one face, @var{face}. |
632 @item M-x customize-group @key{RET} @var{group} @key{RET} | 633 @item M-x customize-group @key{RET} @var{group} @key{RET} |
633 Set up a customization buffer with just one group, @var{group}. | 634 Set up a customization buffer with just one group, @var{group}. |
634 @item M-x customize-apropos @key{RET} @var{regexp} @key{RET} | 635 @item M-x customize-apropos @key{RET} @var{regexp} @key{RET} |
635 Set up a customization buffer with all the settings and groups that | 636 Set up a customization buffer with all the settings and groups that |
636 match @var{regexp}. | 637 match @var{regexp}. |
637 @item M-x customize-changed-options @key{RET} @var{version} @key{RET} | 638 @item M-x customize-changed @key{RET} @var{version} @key{RET} |
638 Set up a customization buffer with all the settings and groups | 639 Set up a customization buffer with all the settings and groups |
639 whose meaning has changed since Emacs version @var{version}. | 640 whose meaning has changed since Emacs version @var{version}. |
640 @item M-x customize-saved | 641 @item M-x customize-saved |
641 Set up a customization buffer containing all settings that you | 642 Set up a customization buffer containing all settings that you |
642 have saved with customization buffers. | 643 have saved with customization buffers. |
643 @item M-x customize-customized | 644 @item M-x customize-customized |
644 Set up a customization buffer containing all settings that you have | 645 Set up a customization buffer containing all settings that you have |
645 customized but not saved. | 646 customized but not saved. |
646 @end table | 647 @end table |
647 | 648 |
648 @findex customize-variable | 649 @findex customize-option |
649 If you want to alter a particular variable with the customization | 650 If you want to alter a particular user option with the customization |
650 buffer, and you know its name, you can use the command @kbd{M-x | 651 buffer, and you know its name, you can use the command @kbd{M-x |
651 customize-variable} and specify the variable name. This sets up the | 652 customize-option} and specify the user option (variable) name. This |
652 customization buffer with just one variable---the one that you asked | 653 sets up the customization buffer with just one user option---the one |
653 for. Editing, setting and saving the value work as described above, | 654 that you asked for. Editing, setting and saving the value work as |
654 but only for the specified variable. Minibuffer completion is handy | 655 described above, but only for the specified user option. Minibuffer |
655 if you only know part of the name. However, this command can only see | 656 completion is handy if you only know part of the name. However, this |
656 options that have been loaded in the current Emacs session. | 657 command can only see options that have been loaded in the current |
658 Emacs session. | |
657 | 659 |
658 @findex customize-face | 660 @findex customize-face |
659 Likewise, you can modify a specific face, chosen by name, using | 661 Likewise, you can modify a specific face, chosen by name, using |
660 @kbd{M-x customize-face}. By default it operates on the face used | 662 @kbd{M-x customize-face}. By default it operates on the face used |
661 on the character after point. | 663 on the character after point. |
662 | 664 |
663 @findex customize-group | 665 @findex customize-group |
664 You can also set up the customization buffer with a specific group, | 666 You can also set up the customization buffer with a specific group, |
665 using @kbd{M-x customize-group}. The immediate contents of the chosen | 667 using @kbd{M-x customize-group}. The immediate contents of the chosen |
666 group, including settings (variables and faces), and other groups, all | 668 group, including settings (user options and faces), and other groups, |
667 appear as well (even if not already loaded). However, the subgroups' | 669 all appear as well (even if not already loaded). However, the |
668 own contents are not included. | 670 subgroups' own contents are not included. |
669 | 671 |
670 @findex customize-apropos | 672 @findex customize-apropos |
671 For a more general way of controlling what to customize, you can use | 673 For a more general way of controlling what to customize, you can use |
672 @kbd{M-x customize-apropos}. You specify a regular expression as | 674 @kbd{M-x customize-apropos}. You specify a regular expression as |
673 argument; then all @emph{loaded} settings and groups whose names match | 675 argument; then all @emph{loaded} settings and groups whose names match |