Make the "built-in" HTML renderer into its own section.

diff --git a/texi/ChangeLog b/texi/ChangeLog
index 7956ef2..9e7384a 100644 (file)
--- a/texi/ChangeLog
+++ b/texi/ChangeLog
@@ -2,6 +2,7 @@
 
        * gnus.texi (Asynchronous Fetching): Document
        gnus-async-post-fetch-function. 
+       (HTML): Made into its own section.
 
 2010-06-24  Glenn Morris  <rgm@gnu.org>
 

diff --git a/texi/gnus.texi b/texi/gnus.texi
index dbe9152..1836a2a 100644 (file)
--- a/texi/gnus.texi
+++ b/texi/gnus.texi
@@ -12196,6 +12196,7 @@ tell Gnus otherwise.
 @menu
 * Hiding Headers::              Deciding what headers should be displayed.
 * Using MIME::                  Pushing articles through @acronym{MIME} before reading them.
+* HTML::                        Reading @acronym{HTML} messages.
 * Customizing Articles::        Tailoring the look of the articles.
 * Article Keymap::              Keystrokes available in the article buffer.
 * Misc Article::                Other stuff.
@@ -12473,12 +12474,44 @@ Interactively run an action on the @acronym{MIME} object
 
 @end table
 
-@cindex HTML
+Gnus will display some @acronym{MIME} objects automatically.  The way Gnus
+determines which parts to do this with is described in the Emacs
+@acronym{MIME} manual.
+
+It might be best to just use the toggling functions from the article
+buffer to avoid getting nasty surprises.  (For instance, you enter the
+group @samp{alt.sing-a-long} and, before you know it, @acronym{MIME} has
+decoded the sound file in the article and some horrible sing-a-long song
+comes screaming out your speakers, and you can't find the volume button,
+because there isn't one, and people are starting to look at you, and you
+try to stop the program, but you can't, and you can't find the program
+to control the volume, and everybody else in the room suddenly decides
+to look at you disdainfully, and you'll feel rather stupid.)
+
+Any similarity to real events and people is purely coincidental.  Ahem.
+
+Also @pxref{MIME Commands}.
+
+
+@node HTML
+@section @acronym{HTML}
+@cindex @acronym{HTML}
+
 If you have @code{w3m} installed on your system, Gnus can display
-@acronym{HTML} articles in the article buffer.  The following
-variables are relevant:
+@acronym{HTML} articles in the article buffer.  There are many Gnus
+add-ons for doing this, using various approaches, but there's one
+(sort of) built-in method that's used by default.
+
+For a complete overview, consult @xref{Display Customization,
+,Display Customization, emacs-mime, The Emacs MIME Manual}.  This
+section only describes the default method.
 
 @table @code
+@item mm-text-html-renderer
+@vindex mm-text-html-renderer
+If set to @code{gnus-article-html}, Gnus will use the built-in method,
+that's based on @code{curl} and @code{w3m}.
+
 @item gnus-html-cache-directory
 @vindex gnus-html-cache-directory
 Gnus will download and cache images according to how
@@ -12496,24 +12529,10 @@ The width to use when rendering HTML.  The default is 70.
 
 @end table
 
+To use this, make sure that you have @code{w3m} and @code{curl}
+installed.  If you have, then Gnus should display @acronym{HTML}
+automatically. 
 
-Gnus will display some @acronym{MIME} objects automatically.  The way Gnus
-determines which parts to do this with is described in the Emacs
-@acronym{MIME} manual.
-
-It might be best to just use the toggling functions from the article
-buffer to avoid getting nasty surprises.  (For instance, you enter the
-group @samp{alt.sing-a-long} and, before you know it, @acronym{MIME} has
-decoded the sound file in the article and some horrible sing-a-long song
-comes screaming out your speakers, and you can't find the volume button,
-because there isn't one, and people are starting to look at you, and you
-try to stop the program, but you can't, and you can't find the program
-to control the volume, and everybody else in the room suddenly decides
-to look at you disdainfully, and you'll feel rather stupid.)
-
-Any similarity to real events and people is purely coincidental.  Ahem.
-
-Also @pxref{MIME Commands}.
 
 
 @node Customizing Articles