From b370fef5223f9db60cfdf779d080aad2f5a49785 Mon Sep 17 00:00:00 2001 From: Romain Francoise Date: Thu, 29 Dec 2005 14:08:09 +0000 Subject: [PATCH] (Using Customize): New node. --- man/ChangeLog | 4 ++++ man/faq.texi | 34 +++++++++++++++++++++++++++------- 2 files changed, 31 insertions(+), 7 deletions(-) diff --git a/man/ChangeLog b/man/ChangeLog index 3c4b718c796..3e50995f76f 100644 --- a/man/ChangeLog +++ b/man/ChangeLog @@ -1,3 +1,7 @@ +2005-12-29 Romain Francoise + + * faq.texi (Using Customize): New node. + 2005-12-28 Luc Teirlinck * org.texi: Remove blank line in @direntry. It is non-standard diff --git a/man/faq.texi b/man/faq.texi index 36564482cc7..b34a4d4ae12 100644 --- a/man/faq.texi +++ b/man/faq.texi @@ -1161,6 +1161,7 @@ In addition, Emacs 22 now includes the Emacs Lisp Reference Manual @menu * Setting up a customization file:: +* Using Customize:: * Debugging a customization file:: * Colors on a TTY:: * Displaying the current line or column:: @@ -1211,7 +1212,7 @@ In addition, Emacs 22 now includes the Emacs Lisp Reference Manual * Escape sequences in shell output:: @end menu -@node Setting up a customization file, Colors on a TTY, Common requests, Common requests +@node Setting up a customization file, Using Customize, Common requests, Common requests @section How do I set up a @file{.emacs} file properly? @cindex @file{.emacs} file, setting up @cindex @file{.emacs} file, locating @@ -1225,11 +1226,11 @@ it causes confusing non-standard behavior. Then they send questions to @email{help-gnu-emacs@@gnu.org} asking why Emacs isn't behaving as documented. -Beginning with version 20.1, Emacs includes the new Customize facility, -which can be invoked using @kbd{M-x customize @key{RET}}. This allows -users who are unfamiliar with Emacs Lisp to modify their @file{.emacs} -files in a relatively straightforward way, using menus rather than Lisp -code. Most packages support Customize as of this writing. +Beginning with version 20.1, Emacs includes the new Customize facility +(@pxref{Using Customize}). This allows users who are unfamiliar with +Emacs Lisp to modify their @file{.emacs} files in a relatively +straightforward way, using menus rather than Lisp code. Most packages +support Customize as of this writing. While Customize might indeed make it easier to configure Emacs, consider taking a bit of time to learn Emacs Lisp and modifying your @@ -1241,7 +1242,26 @@ Sometimes users are unsure as to where their @file{.emacs} file should be found. Visiting the file as @file{~/.emacs} from Emacs will find the correct file. -@node Colors on a TTY, Debugging a customization file, Setting up a customization file, Common requests +@node Using Customize, Colors on a TTY, Setting up a customization file, Common requests +@section How do I start using Customize? +@cindex Customize groups +@cindex Customizing variables +@cindex Customizing faces + +The main Customize entry point is @kbd{M-x customize @key{RET}}. This +command takes you to a buffer listing all the available Customize +groups. From there, you can access all customizable options and faces, +change their values, and save your changes to your init file. +@inforef{Easy Customization, Easy Customization, emacs}. + +If you know the name of the group in advance (e.g. ``shell''), use +@kbd{M-x customize-group @key{RET}}. + +If you wish to customize a single option, use @kbd{M-x customize-option +@key{RET}}. This command prompts you for the name of the option to +customize, with completion. + +@node Colors on a TTY, Debugging a customization file, Using Customize, Common requests @section How do I get colors and syntax highlighting on a TTY? @cindex Colors on a TTY @cindex Syntax highlighting on a TTY -- 2.39.5