4 files changed, 46 insertions, 11 deletions

diff --git a/man/ChangeLog b/man/ChangeLog
index 3c4b718c796..168753ae7a7 100644
--- a/man/ChangeLog
+++ b/man/ChangeLog
@@ -1,3 +1,11 @@
+2005-12-30  Juri Linkov  <juri@jurta.org>
+
+        * basic.texi (Position Info): Update example.
+
+2005-12-29  Romain Francoise  <romain@orebokech.com>
+
+        * faq.texi (Using Customize): New node.
+
 2005-12-28  Luc Teirlinck  <teirllm@auburn.edu>
 
         * org.texi: Remove blank line in @direntry.  It is non-standard
diff --git a/man/basic.texi b/man/basic.texi
index e8c36d405c1..c2e48263c20 100644
--- a/man/basic.texi
+++ b/man/basic.texi
@@ -717,14 +717,14 @@ displays the character as @samp{@`A}), and which has font-lock-mode
 
 @smallexample
   character: @`A (2240, #o4300, #x8c0, U+00C0)
-    charset: [latin-iso8859-1]
+    charset: latin-iso8859-1
              (Right-Hand Part of Latin Alphabet 1@dots{}
- code point: [64]
+ code point: #x40
      syntax: w  which means: word
    category: l:Latin
-   to input: type "`A" with [latin-1-prefix]
+   to input: type "`A" with latin-1-prefix
 buffer code: #x81 #xC0
-  file code: ESC #x2C #x41 #x40 (encoded by coding system iso-2022-7bit)
+  file code: #xC0 (encoded by coding system iso-latin-1)
     display: terminal code #xC0
 
 There are text properties here:
diff --git a/man/display.texi b/man/display.texi
index 2f813c4b7c0..2a3fc30ad82 100644
--- a/man/display.texi
+++ b/man/display.texi
@@ -1014,6 +1014,13 @@ terminal itself blinks the cursor, and Emacs has no control over it.)
 You can control how the cursor appears when it blinks off by setting
 the variable @code{blink-cursor-alist}.
 
+@vindex visible-cursor
+  Some text terminals offer two different cursors: the normal cursor
+and the very visible cursor, where the latter may be e.g. bigger or
+blinking.  By default Emacs uses the very visible cursor.  Setting the
+variable @code{visible-cursor} to @code{nil} makes it use the
+normal cursor.
+
 @cindex cursor in non-selected windows
 @vindex cursor-in-non-selected-windows
   Normally, the cursor appears in non-selected windows in the ``off''
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