From: yamaoka Date: Wed, 20 Jan 1999 02:00:15 +0000 (+0000) Subject: ;; Sync up with Pterodactyl Gnus v0.72. X-Git-Tag: pgnus-ichikawa-199901201900~5 X-Git-Url: http://git.chise.org/gitweb/?a=commitdiff_plain;h=2faa0e44df7151887f6a1d4711e4d7dd757e2dac;p=elisp%2Fgnus.git- ;; 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 --- a/texi/ChangeLog +++ b/texi/ChangeLog @@ -1,3 +1,8 @@ +1999-01-16 20:36:48 Lars Magne Ingebrigtsen + + * gnus.texi (Customizing Articles): Rewrite. + Remove mention of gnus-article-display-hook. + 1999-01-12 07:14:12 Lars Magne Ingebrigtsen * gnus.texi (To From Newsgroups): Addition. diff --git a/texi/gnus-ja.texi b/texi/gnus-ja.texi index f1d3ac1..6c223b2 100644 --- 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 $B$O!"Bg$-$J3($,F~$C$F$$$?$j$5$^$6$^$J7A<0$rMQ$$$?$j$7$F$$$k$A$g$C(B $B$J8@8l7w$r:9JL$7$^$;$s!#$"$"!"%/%j%s%4%s$NJ}$O(B Unicode Next Generation$B$r(B $B$*BT$A$/$@$5$$!#(B -$B$3$N@bL@=q$O(B Semi-gnus 6.10.054 $B$KBP1~$7$^$9!#(B +$B$3$N@bL@=q$O(B Semi-gnus 6.10.055 $B$KBP1~$7$^$9!#(B @end ifinfo @@ -7726,16 +7726,14 @@ Gnus $B$O%X%C%@!<$NJB$YBX$((B(sort)$B$b9T$$$^$9!J$3$l$O%G%#%U%)%k%H$G9T$o$l$^ $B<($5$l$k$G$7$g$&!#(B @findex gnus-article-hide-boring-headers -@vindex gnus-article-display-hook @vindex gnus-boring-article-headers -@code{gnus-article-hide-boring-headers} $B$r(B -@code{gnus-article-display-hook} $B$KF~$l$k$3$H$K$h$C$F!"$b$C$H$D(B -$B$^$i$J$$%X%C%@!<$r1#$9$3$H$,$G$-$^$9!#$3$N4X?t$,2?$r$9$k$+$O(B -@code{gnus-boring-article-headers} $BJQ?t$K0MB8$7$^$9!#$3$NJQ?t$O(B -$B%j%9%H$G$9$,!"$3$N%j%9%H$K$OA0$,F~$k$N$G$O$"$j(B -$B$^$;$s!#Be$o$j$K(B gnus $B$,%A%'%C%/$7$F;k3&$+$i>C$75n$k$?$a$N$5$^$6(B -$B$^$J!V$D$^$i$J$$>r7o!W(B@dfn{boring conditions} $B$N%j%9%H$r;XDj$7$^(B -$B$9!#(B +@code{gnus-treat-hide-boring-headers} $B$r(B @code{head} $B$K%;%C%H$9(B +$B$k$3$H$K$h$C$F!"$b$C$H$D$^$i$J$$%X%C%@!<$r1#$9$3$H$,$G$-$^$9!#$3(B +$B$N4X?t$,2?$r$9$k$+$O(B@code{gnus-boring-article-headers} $BJQ?t$K0M(B +$BB8$7$^$9!#$3$NJQ?t$O%j%9%H$G$9$,!"$3$N%j%9%H$K$OA0$,F~$k$N$G$O$"$j$^$;$s!#Be$o$j$K(B gnus $B$,%A%'%C%/$7$F;k3&$+$i(B +$B>C$75n$k$?$a$N$5$^$6$^$J!V$D$^$i$J$$>r7o!W(B +@dfn{boring conditions} $B$N%j%9%H$r;XDj$7$^$9!#(B $B$3$N>r7o$K$O0J2<$N$h$&$J$b$N$,$"$j$^$9!#(B @table @code diff --git a/texi/gnus.texi b/texi/gnus.texi index c5b6dc8..3b14079 100644 --- 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 --- 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 $B$NA4$F$N%a%C%;!<%8$N:n@.(B ($B%a!<%k$H%K%e!<%9$NN>J}(B) $B$O%a%C%;!< * Key Index:: $B%a%C%;!<%8%b!<%I%-!<$N0lMw!#(B @end menu -$B$3$N%^%K%e%"%k$O(B Message 6.10.054 $B$KBP1~$7$^$9!#(BMessage $B$O$3$N%^%K%e%"%k$H(B +$B$3$N%^%K%e%"%k$O(B Message 6.10.055 $B$KBP1~$7$^$9!#(BMessage $B$O$3$N%^%K%e%"%k$H(B $BF1$8HGHV9f$N(B Gnus $B$NG[I[$H6&$KG[I[$5$l$^$9!#(B diff --git a/texi/message.texi b/texi/message.texi index 89d71f9..91384b3 100644 --- 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.