[Emacs-diffs] /srv/bzr/emacs/trunk r101217: gnus.texi (Asynchronous Fetching): Document gnus-async-post-fetch-function; gnus.texi (HTML): Made into its own section by Lars Magne Ingebrigtsen <address@hidden>.

[Katsumi Yamaoka]

------------------------------------------------------------
revno: 101217
committer: Katsumi Yamaoka <address@hidden>
branch nick: trunk
timestamp: Mon 2010-08-30 06:36:12 +0000
message:
  gnus.texi (Asynchronous Fetching): Document gnus-async-post-fetch-function; 
gnus.texi (HTML): Made into its own section by Lars Magne Ingebrigtsen 
<address@hidden>.
  
  2010-08-29  Lars Magne Ingebrigtsen  <address@hidden>
   * gnus.texi (Asynchronous Fetching): Document
   gnus-async-post-fetch-function.
   (HTML): Made into its own section.
modified:
  doc/misc/ChangeLog
  doc/misc/emacs-mime.texi
  doc/misc/gnus.texi
  doc/misc/message.texi

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2010-08-26 07:39:39 +0000
+++ b/doc/misc/ChangeLog        2010-08-30 06:36:12 +0000
@@ -1,3 +1,9 @@
+2010-08-29  Lars Magne Ingebrigtsen  <address@hidden>
+
+       * gnus.texi (Asynchronous Fetching): Document
+       gnus-async-post-fetch-function.
+       (HTML): Made into its own section.
+
 2010-08-26  Michael Albinus  <address@hidden>
 
        Sync with Tramp 2.1.19.

=== modified file 'doc/misc/emacs-mime.texi'
--- a/doc/misc/emacs-mime.texi  2010-06-24 07:10:51 +0000
+++ b/doc/misc/emacs-mime.texi  2010-08-30 06:36:12 +0000
@@ -394,7 +394,7 @@
 @item mm-text-html-renderer
 @vindex mm-text-html-renderer
 This selects the function used to render @acronym{HTML}.  The predefined
-renderers are selected by the symbols @code{w3},
+renderers are selected by the symbols @code{gnus-article-html}, @code{w3},
 @address@hidden @uref{http://emacs-w3m.namazu.org/} for more
 information about emacs-w3m}, @code{links}, @code{lynx},
 @code{w3m-standalone} or @code{html2text}.  If @code{nil} use an

=== modified file 'doc/misc/gnus.texi'
--- a/doc/misc/gnus.texi        2010-07-10 18:52:53 +0000
+++ b/doc/misc/gnus.texi        2010-08-30 06:36:12 +0000
@@ -6043,6 +6043,11 @@
 This variable can also be a number.  In that case, center the window at
 the given number of lines from the top.
 
address@hidden gnus-summary-stop-at-end-of-message
address@hidden gnus-summary-stop-at-end-of-message
+If address@hidden, don't go to the next article when hitting
address@hidden, and you're at the end of the article.
+
 @end table
 
 
@@ -8271,6 +8276,16 @@
 preferably be short and sweet to avoid slowing down Gnus too much.
 It's probably a good idea to byte-compile things like this.
 
address@hidden gnus-async-post-fetch-function
address@hidden gnus-html-prefetch-images
+After an article has been prefetched, this
address@hidden will be called.  The buffer will
+be narrowed to the region of the article that was fetched.  A useful
+value would be @code{gnus-html-prefetch-images}, which will prefetch
+and store images referenced in the article, so that you don't have to
+wait for them to be fetched when you read the article.  This is useful
+for @acronym{HTML} messages that have external images.
+
 @vindex gnus-prefetched-article-deletion-strategy
 Articles have to be removed from the asynch buffer sooner or later.  The
 @code{gnus-prefetched-article-deletion-strategy} says when to remove
@@ -12186,6 +12201,7 @@
 @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.
@@ -12482,6 +12498,48 @@
 Also @pxref{MIME Commands}.
 
 
address@hidden HTML
address@hidden @acronym{HTML}
address@hidden @acronym{HTML}
+
+If you have @code{w3m} installed on your system, Gnus can display
address@hidden 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.
+
address@hidden @code
address@hidden mm-text-html-renderer
address@hidden 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}.
+
address@hidden gnus-html-cache-directory
address@hidden gnus-html-cache-directory
+Gnus will download and cache images according to how
address@hidden is set.  These images will be stored in
+this directory.
+
address@hidden gnus-html-cache-size
address@hidden gnus-html-cache-size
+When @code{gnus-html-cache-size} bytes have been used in that
+directory, the oldest files will be deleted.  The default is 500MB.
+
address@hidden gnus-html-frame-width
address@hidden gnus-html-frame-width
+The width to use when rendering HTML.  The default is 70.
+
address@hidden 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. 
+
+
+
 @node Customizing Articles
 @section Customizing Articles
 @cindex article customization

=== modified file 'doc/misc/message.texi'
--- a/doc/misc/message.texi     2010-06-24 07:10:51 +0000
+++ b/doc/misc/message.texi     2010-08-30 06:36:12 +0000
@@ -1645,7 +1645,8 @@
 @cindex split large message
 The limitation of messages sent as message/partial.  The lower bound
 of message size in characters, beyond which the message should be sent
-in several parts.  If it is @code{nil}, the size is unlimited.
+in several parts.  If it is @code{nil} (which is the default), the
+size is unlimited.
 
 @end table