;; Sync up with Pterodactyl Gnus v0.72.

* gnus.texi (Customizing Articles): Rewrite.  Remove mention of
gnus-article-display-hook.
* gnus-ja.texi (Customizing Articles): Ditto.
* message.texi: Modified for T-gnus 6.10.055.
* message-ja.texi: Ditto.

diff --git a/texi/ChangeLog b/texi/ChangeLog
index 4c0adf9..4c43219 100644 (file)
--- a/texi/ChangeLog
+++ b/texi/ChangeLog
@@ -1,3 +1,8 @@
+1999-01-16 20:36:48  Lars Magne Ingebrigtsen  <larsi@gnus.org>
+
+       * gnus.texi (Customizing Articles): Rewrite.
+       Remove mention of gnus-article-display-hook.
+
 1999-01-12 07:14:12  Lars Magne Ingebrigtsen  <larsi@gnus.org>
 
        * gnus.texi (To From Newsgroups): Addition.

diff --git a/texi/gnus-ja.texi b/texi/gnus-ja.texi
index f1d3ac1..6c223b2 100644 (file)
--- a/texi/gnus-ja.texi
+++ b/texi/gnus-ja.texi
@@ -1,7 +1,7 @@
 \input texinfo                  @c -*-texinfo-*-
 
 @setfilename gnus-ja
-@settitle Semi-gnus 6.10.054 Manual
+@settitle Semi-gnus 6.10.055 Manual
 @synindex fn cp
 @synindex vr cp
 @synindex pg cp
@@ -345,7 +345,7 @@ into another language, under the above conditions for modified versions.
 @tex
 
 @titlepage
-@title Semi-gnus 6.10.054 Manual
+@title Semi-gnus 6.10.055 Manual
 
 @author by Lars Magne Ingebrigtsen
 @author by members of Semi-gnus mailing-list
@@ -399,7 +399,7 @@ Semi-gnus \e$B$O!"Bg$-$J3($,F~$C$F$$$?$j$5$^$6$^$J7A<0$rMQ$$$?$j$7$F$$$k$A$g$C\e(B
 \e$B$J8@8l7w$r:9JL$7$^$;$s!#$"$"!"%/%j%s%4%s$NJ}$O\e(B Unicode Next Generation\e$B$r\e(B
 \e$B$*BT$A$/$@$5$$!#\e(B
 
-\e$B$3$N@bL@=q$O\e(B Semi-gnus 6.10.054 \e$B$KBP1~$7$^$9!#\e(B
+\e$B$3$N@bL@=q$O\e(B Semi-gnus 6.10.055 \e$B$KBP1~$7$^$9!#\e(B
 
 @end ifinfo
 
@@ -7726,16 +7726,14 @@ Gnus \e$B$O%X%C%@!<$NJB$YBX$(\e(B(sort)\e$B$b9T$$$^$9!J$3$l$O%G%#%U%)%k%H$G9T$o$l$^
 \e$B<($5$l$k$G$7$g$&!#\e(B
 
 @findex gnus-article-hide-boring-headers
-@vindex gnus-article-display-hook
 @vindex gnus-boring-article-headers
-@code{gnus-article-hide-boring-headers} \e$B$r\e(B
-@code{gnus-article-display-hook} \e$B$KF~$l$k$3$H$K$h$C$F!"$b$C$H$D\e(B
-\e$B$^$i$J$$%X%C%@!<$r1#$9$3$H$,$G$-$^$9!#$3$N4X?t$,2?$r$9$k$+$O\e(B
-@code{gnus-boring-article-headers} \e$BJQ?t$K0MB8$7$^$9!#$3$NJQ?t$O\e(B
-\e$B%j%9%H$G$9$,!"$3$N%j%9%H$K$O<B:]$N%X%C%@!<$NL>A0$,F~$k$N$G$O$"$j\e(B
-\e$B$^$;$s!#Be$o$j$K\e(B gnus \e$B$,%A%'%C%/$7$F;k3&$+$i>C$75n$k$?$a$N$5$^$6\e(B
-\e$B$^$J!V$D$^$i$J$$>r7o!W\e(B@dfn{boring conditions} \e$B$N%j%9%H$r;XDj$7$^\e(B
-\e$B$9!#\e(B
+@code{gnus-treat-hide-boring-headers} \e$B$r\e(B @code{head} \e$B$K%;%C%H$9\e(B
+\e$B$k$3$H$K$h$C$F!"$b$C$H$D$^$i$J$$%X%C%@!<$r1#$9$3$H$,$G$-$^$9!#$3\e(B
+\e$B$N4X?t$,2?$r$9$k$+$O\e(B@code{gnus-boring-article-headers} \e$BJQ?t$K0M\e(B
+\e$BB8$7$^$9!#$3$NJQ?t$O%j%9%H$G$9$,!"$3$N%j%9%H$K$O<B:]$N%X%C%@!<$N\e(B
+\e$BL>A0$,F~$k$N$G$O$"$j$^$;$s!#Be$o$j$K\e(B gnus \e$B$,%A%'%C%/$7$F;k3&$+$i\e(B
+\e$B>C$75n$k$?$a$N$5$^$6$^$J!V$D$^$i$J$$>r7o!W\e(B
+@dfn{boring conditions} \e$B$N%j%9%H$r;XDj$7$^$9!#\e(B
 
 \e$B$3$N>r7o$K$O0J2<$N$h$&$J$b$N$,$"$j$^$9!#\e(B
 @table @code

diff --git a/texi/gnus.texi b/texi/gnus.texi
index c5b6dc8..3b14079 100644 (file)
--- a/texi/gnus.texi
+++ b/texi/gnus.texi
@@ -1,7 +1,7 @@
 \input texinfo                  @c -*-texinfo-*-
 
 @setfilename gnus
-@settitle Semi-gnus 6.10.054 Manual
+@settitle Semi-gnus 6.10.055 Manual
 @synindex fn cp
 @synindex vr cp
 @synindex pg cp
@@ -318,7 +318,7 @@ into another language, under the above conditions for modified versions.
 @tex
 
 @titlepage
-@title Semi-gnus 6.10.054 Manual
+@title Semi-gnus 6.10.055 Manual
 
 @author by Lars Magne Ingebrigtsen
 @page
@@ -361,7 +361,7 @@ internationalization/localization and multiscript features based on MULE
 API.  So Semi-gnus does not discriminate various language communities.
 Oh, if you are a Klingon, please wait Unicode Next Generation.
 
-This manual corresponds to Semi-gnus 6.10.054.
+This manual corresponds to Semi-gnus 6.10.055.
 
 @end ifinfo
 
@@ -6268,11 +6268,6 @@ Do much highlighting of the current article
 (@code{gnus-article-highlight}).  This function highlights header, cited
 text, the signature, and adds buttons to the body and the head.
 
-Most users would prefer using @code{gnus-article-maybe-highlight} in
-@code{gnus-article-display-hook} (@pxref{Customizing Articles}) instead.
-This is a bit less agressive---it highlights only the headers, the
-signature and adds buttons.
-
 @item W H h
 @kindex W H h (Summary)
 @findex gnus-article-highlight-headers
@@ -6459,7 +6454,7 @@ articles that have signatures in them do:
 @lisp
 ;;; Hide pgp cruft if any.
 
-(add-hook 'gnus-article-display-hook 'gnus-article-hide-pgp)
+(setq gnus-treat-strip-pgp t)
 
 ;;; After hiding pgp, verify the message;
 ;;; only happens if pgp signature is found.
@@ -6536,7 +6531,7 @@ is hidden.
 Hide cited text in articles that aren't roots
 (@code{gnus-article-hide-citation-in-followups}).  This isn't very
 useful as an interactive command, but might be a handy function to stick
-in @code{gnus-article-display-hook} (@pxref{Customizing Articles}).
+have happen automatically (@pxref{Customizing Articles}).
 
 @end table
 
@@ -6625,9 +6620,7 @@ interactively.
 @item W w
 @kindex W w (Summary)
 @findex gnus-article-fill-cited-article
-Do word wrap (@code{gnus-article-fill-cited-article}).  If you use this
-function in @code{gnus-article-display-hook}, it should be run fairly
-late and certainly after any highlighting.
+Do word wrap (@code{gnus-article-fill-cited-article}).  
 
 You can give the command a numerical prefix to specify the width to use
 when filling.
@@ -8101,14 +8094,13 @@ Any headers that are to remain visible, but are not listed in this
 variable, will be displayed in random order after all the headers listed in this variable.
 
 @findex gnus-article-hide-boring-headers
-@vindex gnus-article-display-hook
 @vindex gnus-boring-article-headers
-You can hide further boring headers by entering
-@code{gnus-article-hide-boring-headers} into
-@code{gnus-article-display-hook}.  What this function does depends on
-the @code{gnus-boring-article-headers} variable.  It's a list, but this
-list doesn't actually contain header names.  Instead is lists various
-@dfn{boring conditions} that gnus can check and remove from sight.
+You can hide further boring headers by setting
+@code{gnus-treat-hide-boring-headers} to @code{head}.  What this function
+does depends on the @code{gnus-boring-article-headers} variable.  It's a
+list, but this list doesn't actually contain header names.  Instead is
+lists various @dfn{boring conditions} that Gnus can check and remove
+from sight.
 
 These conditions are:
 @table @code
@@ -8197,29 +8189,91 @@ buffer when there are nobody else.
 @section Customizing Articles
 @cindex article customization
 
-@vindex gnus-article-display-hook
-The @code{gnus-article-display-hook} is called after the article has
-been inserted into the article buffer.  It is meant to handle all
-treatment of the article before it is displayed.
+A slew of functions for customizing how the articles are to look like
+exist.  You can call these functions interactively, or you can have them 
+called automatically when you select the articles.
 
-@findex gnus-article-maybe-highlight
-@findex gnus-article-maybe-hide-headers
-By default this hook just contains
-@code{gnus-article-maybe-hide-headers},
-@code{gnus-hide-boring-headers}, @code{gnus-article-treat-overstrike},
-and @code{gnus-article-maybe-highlight} (and under XEmacs,
-@code{gnus-article-display-x-face}), but there are thousands, nay
-millions, of functions you can put in this hook.  For an overview of
-functions @pxref{Article Highlighting}, @pxref{Article Hiding},
-@pxref{Article Washing}, @pxref{Article Buttons} and @pxref{Article
-Date}.  Note that the order of functions in this hook might affect
-things, so you may have to fiddle a bit to get the desired results.
-
-You can, of course, write your own functions.  The functions are called
-from the article buffer, and you can do anything you like, pretty much.
-There is no information that you have to keep in the buffer---you can
-change everything.  However, you shouldn't delete any headers.  Instead
-make them invisible if you want to make them go away.
+To have them called automatically, you should set the corresponding
+``treatment'' variable.  For instance, to have headers hidden, you'd set 
+@code{gnus-treat-hide-headers}.  Below is a list of variables that can
+be set, but first we discuss the values these variables can have.
+
+@enumerate
+@item
+@code{nil}: Don't do this treatment.
+
+@item
+@code{t}: Do this treatment on all body parts.
+
+@item
+@code{head}: Do the treatment on the headers.
+
+@item
+@code{last}: Do this treatment on the last part.
+
+@item
+An integer: Do this treatment on all body parts that have a length less
+than this number.
+
+@item
+A sexp: Do this treatment on all body parts where the sexp evals to a
+non-@code{nil} value.
+
+@end enumerate
+
+You may have noticed that the word @dfn{part} is used here.  This refers
+to the fact that some messages are @sc{mime} multipart articles that may
+be divided into several parts.  Articles that are not multiparts are
+considered to contain just a single part.
+
+@vindex gnus-article-treat-types
+Are the treatments applied to all sorts of multipart parts?  Yes, if you 
+want to, but by default, only @samp{text/plain} parts are given the
+treatment.  This is controlled by the @code{gnus-article-treat-types}
+variable, which is a list of regular expressions that are matched to the 
+type of the part.
+
+The following treatment options are available.  The easiest way to
+customize this is to examine the @code{gnus-article-treat} customization 
+group.
+
+@table @code
+@item gnus-treat-highlight-signature
+@item gnus-treat-buttonize
+@item gnus-treat-buttonize-head
+@item gnus-treat-emphasize
+@item gnus-treat-fill-article
+@item gnus-treat-strip-cr
+@item gnus-treat-hide-headers
+@item gnus-treat-hide-boring-headers
+@item gnus-treat-hide-signature
+@item gnus-treat-hide-citation
+@item gnus-treat-strip-pgp
+@item gnus-treat-strip-pem
+@item gnus-treat-highlight-headers
+@item gnus-treat-highlight-citation
+@item gnus-treat-highlight-signature 
+@item gnus-treat-date-ut 
+@item gnus-treat-date-local 
+@item gnus-treat-date-lapsed 
+@item gnus-treat-date-original 
+@item gnus-treat-strip-trailing-blank-lines
+@item gnus-treat-strip-leading-blank-lines
+@item gnus-treat-strip-multiple-blank-lines
+@item gnus-treat-strip-blank-lines 
+@item gnus-treat-overstrike 
+@item gnus-treat-display-xface 
+@item gnus-treat-display-smileys 
+@item gnus-treat-display-picons
+@end table
+
+@vindex gnus-part-display-hook
+You can, of course, write your own functions to be called from
+@code{gnus-part-display-hook}.  The functions are called narrowed to the
+part, and you can do anything you like, pretty much.  There is no
+information that you have to keep in the buffer---you can change
+everything.  However, you shouldn't delete any headers.  Instead make
+them invisible if you want to make them go away.
 
 
 @node Article Keymap
@@ -8308,12 +8362,6 @@ article buffer.  It is mainly intended for functions that do something
 depending on the contents; it should probably not be used for changing
 the contents of the article buffer.
 
-@vindex gnus-article-display-hook
-@item gnus-article-display-hook
-This hook is called as the last thing when displaying an article, and is
-intended for modifying the contents of the buffer, doing highlights,
-hiding headers, and the like.
-
 @item gnus-article-mode-hook
 @vindex gnus-article-mode-hook
 Hook called in article mode buffers.
@@ -14899,8 +14947,7 @@ Do highlights in the group buffer.
 @item summary-highlight
 Do highlights in the summary buffer.
 @item article-highlight
-Do highlights according to @code{gnus-article-display-hook} in the
-article buffer.
+Do highlights in the article buffer.
 @item highlight
 Turn on highlighting in all buffers.
 @item group-menu
@@ -15438,10 +15485,7 @@ To enable displaying picons, simply put the following line in your
 
 @lisp
 (setq gnus-use-picons t)
-(add-hook 'gnus-article-display-hook
-          'gnus-article-display-picons t)
-(add-hook 'gnus-article-display-hook
-          'gnus-picons-article-display-x-face)
+(setq gnus-treat-display-picons t)
 @end lisp
 
 and make sure @code{gnus-picons-database} points to the directory
@@ -15512,28 +15556,19 @@ Now that you've made those decision, you need to add the following
 functions to the appropriate hooks so these pictures will get displayed
 at the right time.
 
-@vindex gnus-article-display-hook
 @vindex gnus-picons-display-where
 @table @code
 @item gnus-article-display-picons
 @findex gnus-article-display-picons
 Looks up and displays the picons for the author and the author's domain
-in the @code{gnus-picons-display-where} buffer.  Should be added to the
-@code{gnus-article-display-hook}.
+in the @code{gnus-picons-display-where} buffer.  
 
 @item gnus-picons-article-display-x-face
 @findex gnus-article-display-picons
-Decodes and displays the X-Face header if present.  This function
-should be added to @code{gnus-article-display-hook}.
+Decodes and displays the X-Face header if present.  
 
 @end table
 
-Note:  You must append them to the hook, so make sure to specify 't'
-for the append flag of @code{add-hook}:
-
-@lisp
-(add-hook 'gnus-article-display-hook 'gnus-article-display-picons t)
-@end lisp
 
 
 @node Picon Useless Configuration
@@ -15650,7 +15685,7 @@ In short---to use Smiley in Gnus, put the following in your
 @file{.gnus.el} file:
 
 @lisp
-(add-hook 'gnus-article-display-hook 'gnus-smiley-display t)
+(setq gnus-treat-display-smiley t)
 @end lisp
 
 Smiley maps text smiley faces---@samp{:-)}, @samp{:-=}, @samp{:-(} and
@@ -16818,11 +16853,6 @@ All functions for hiding article elements are now toggles.
 @item
 Article headers can be buttonized (@pxref{Article Washing}).
 
-@lisp
-(add-hook 'gnus-article-display-hook
-          'gnus-article-add-buttons-to-head)
-@end lisp
-
 @item
 All mail backends support fetching articles by @code{Message-ID}.
 
@@ -16920,11 +16950,6 @@ cited text to hide is now customizable (@pxref{Article Hiding}).
 @item
 Boring headers can be hidden (@pxref{Article Hiding}).
 
-@lisp
-(add-hook 'gnus-article-display-hook
-          'gnus-article-hide-boring-headers t)
-@end lisp
-
 @item
 Default scoring values can now be set from the menu bar.
 
@@ -17089,11 +17114,6 @@ mail before saving the mail (@pxref{Washing Mail}).
 @item
 Emphasized text can be properly fontisized:
 
-@lisp
-(add-hook 'gnus-article-display-hook
-          'gnus-article-emphasize)
-@end lisp
-
 @end itemize
 
 
@@ -18785,13 +18805,11 @@ minimum.  You can, in fact, make do without them altogether---most of the
 useful data is in the summary buffer, anyway.  Set this variable to
 @samp{^NEVVVVER} or @samp{From:}, or whatever you feel you need.
 
-@item gnus-article-display-hook
 Set this hook to all the available hiding commands:
 @lisp
-(setq gnus-article-display-hook
-      '(gnus-article-hide-headers
-        gnus-article-hide-signature
-        gnus-article-hide-citation))
+(setq gnus-treat-hide-headers 'head
+      gnus-treat-hide-signature t
+      gnus-treat-hide-citation t)
 @end lisp
 
 @item gnus-use-full-window
@@ -18848,9 +18866,6 @@ Set @code{gnus-show-threads}, @code{gnus-use-cross-reference} and
 @code{gnus-nov-is-evil} to @code{nil} to make entering and exiting the
 summary buffer faster.
 
-Set @code{gnus-article-display-hook} to @code{nil} to make article
-processing a bit faster.
-
 
 @page
 @node Troubleshooting

diff --git a/texi/message-ja.texi b/texi/message-ja.texi
index 587467f..1e88a54 100644 (file)
--- a/texi/message-ja.texi
+++ b/texi/message-ja.texi
@@ -1,7 +1,7 @@
 \input texinfo                  @c -*-texinfo-*-
 
 @setfilename message-ja
-@settitle Message 6.10.054 Manual
+@settitle Message 6.10.055 Manual
 @synindex fn cp
 @synindex vr cp
 @synindex pg cp
@@ -60,7 +60,7 @@ into another language, under the above conditions for modified versions.
 @tex
 
 @titlepage
-@title Message 6.10.054 Manual
+@title Message 6.10.055 Manual
 
 @author by Lars Magne Ingebrigtsen
 @translated by members of Semi-gnus mailing-list
@@ -112,7 +112,7 @@ Gnus \e$B$NA4$F$N%a%C%;!<%8$N:n@.\e(B (\e$B%a!<%k$H%K%e!<%9$NN>J}\e(B) \e$B$O%a%C%;!<
 * Key Index::         \e$B%a%C%;!<%8%b!<%I%-!<$N0lMw!#\e(B
 @end menu
 
-\e$B$3$N%^%K%e%"%k$O\e(B Message 6.10.054 \e$B$KBP1~$7$^$9!#\e(BMessage \e$B$O$3$N%^%K%e%"%k$H\e(B
+\e$B$3$N%^%K%e%"%k$O\e(B Message 6.10.055 \e$B$KBP1~$7$^$9!#\e(BMessage \e$B$O$3$N%^%K%e%"%k$H\e(B
 \e$BF1$8HGHV9f$N\e(B Gnus \e$B$NG[I[$H6&$KG[I[$5$l$^$9!#\e(B
 
 

diff --git a/texi/message.texi b/texi/message.texi
index 89d71f9..91384b3 100644 (file)
--- a/texi/message.texi
+++ b/texi/message.texi
@@ -1,7 +1,7 @@
 \input texinfo                  @c -*-texinfo-*-
 
 @setfilename message
-@settitle Message 6.10.054 Manual
+@settitle Message 6.10.055 Manual
 @synindex fn cp
 @synindex vr cp
 @synindex pg cp
@@ -42,7 +42,7 @@ into another language, under the above conditions for modified versions.
 @tex
 
 @titlepage
-@title Message 6.10.054 Manual
+@title Message 6.10.055 Manual
 
 @author by Lars Magne Ingebrigtsen
 @page
@@ -83,7 +83,7 @@ Message mode buffers.
 * Key Index::         List of Message mode keys.
 @end menu
 
-This manual corresponds to Message 6.10.054.  Message is
+This manual corresponds to Message 6.10.055.  Message is
 distributed with the Gnus distribution bearing the same version number
 as this manual.