From aa13ee01a32df9d5e2db79d709e479448aee528b Mon Sep 17 00:00:00 2001 From: Reiner Steib Date: Wed, 5 Apr 2006 16:40:48 +0000 Subject: [PATCH] (X-Face): Clarify. (Face): Need Emacs with PNG support. --- texi/ChangeLog | 5 +++++ texi/gnus.texi | 45 +++++++++++++++++++++++---------------------- 2 files changed, 28 insertions(+), 22 deletions(-) diff --git a/texi/ChangeLog b/texi/ChangeLog index 4871d5f0d..dc5bcea83 100644 --- a/texi/ChangeLog +++ b/texi/ChangeLog @@ -1,3 +1,8 @@ +2006-04-05 Reiner Steib + + * gnus.texi (X-Face): Clarify. + (Face): Need Emacs with PNG support. + 2006-04-04 Reiner Steib * gnus.texi, message.texi: Bump version. diff --git a/texi/gnus.texi b/texi/gnus.texi index 5304240a7..4cbff4793 100644 --- a/texi/gnus.texi +++ b/texi/gnus.texi @@ -22576,10 +22576,20 @@ readers. @end iftex @c @anchor{X-Face} -Decoding an @code{X-Face} header either requires an Emacs that has +Viewing an @code{X-Face} header either requires an Emacs that has @samp{compface} support (which most XEmacs versions has), or that you -have @samp{compface} installed on your system. If either is true, -Gnus will default to displaying @code{X-Face} headers. +have suitable conversion or display programs installed. If your Emacs +has image support the default action is to display the face before the +@code{From} header. If there's no native @code{X-Face} support, Gnus +will try to convert the @code{X-Face} header using external programs +from the @code{pbmplus} package and friends. For XEmacs it's faster if +XEmacs has been compiled with @code{X-Face} support. The default action +under Emacs without image support is to fork off the @code{display} +program. + +On a GNU/Linux system, the @code{display} program is from the +ImageMagick package. For external conversion programs look for packages +with names like @code{netpbm}, @code{libgr-progs} and @code{compface}. The variable that controls this is the @code{gnus-article-x-face-command} variable. If this variable is a @@ -22588,21 +22598,6 @@ function, this function will be called with the face as the argument. If the @code{gnus-article-x-face-too-ugly} (which is a regexp) matches the @code{From} header, the face will not be shown. -The default action under Emacs without image support is to fork off the -@code{display} program@footnote{@code{display} is from the ImageMagick -package. For the @code{uncompface} and @code{icontopbm} programs look -for a package like @code{compface} or @code{faces-xface} on a GNU/Linux -system.} to view the face. - -Under XEmacs or Emacs 21+ with suitable image support, the default -action is to display the face before the @code{From} header. (It's -nicer if XEmacs has been compiled with @code{X-Face} support---that -will make display somewhat faster. If there's no native @code{X-Face} -support, Gnus will try to convert the @code{X-Face} header using -external programs from the @code{pbmplus} package and -friends.@footnote{On a GNU/Linux system look for packages with names -like @code{netpbm}, @code{libgr-progs} and @code{compface}.}) - (Note: @code{x-face} is used in the variable/function names, not @code{xface}). @@ -22646,7 +22641,9 @@ on the @code{xface} image type in XEmacs if it is built with the If you use posting styles, you can use an @code{x-face-file} entry in @code{gnus-posting-styles}, @xref{Posting Styles}. If you don't, Gnus provides a few convenience functions and variables to allow easier -insertion of X-Face headers in outgoing messages. +insertion of X-Face headers in outgoing messages. You also need the +above mentioned ImageMagick, netpbm or other image conversion packages +(depending the values of the variables below) for these functions. @findex gnus-random-x-face @vindex gnus-convert-pbm-to-x-face-command @@ -22693,7 +22690,7 @@ Using the last function would be something like this: @subsection Face @cindex face -@c #### FIXME: faces and x-faces'implementations should really be harmonized. +@c #### FIXME: faces and x-faces' implementations should really be harmonized. @code{Face} headers are essentially a funkier version of @code{X-Face} ones. They describe a 48x48 pixel colored image that's supposed to @@ -22705,8 +22702,12 @@ The contents of a @code{Face} header must be a base64 encoded PNG image. See @uref{http://quimby.gnus.org/circus/face/} for the precise specifications. -The @code{gnus-face-properties-alist} variable affects the appearance of -displayed Face images. @xref{X-Face}. +Viewing an @code{X-Face} header either an Emacs that is able to display +PNG images. +@c Maybe add this: +@c (if (featurep 'xemacs) +@c (featurep 'pgn) +@c (image-type-available-p 'png)) Gnus provides a few convenience functions and variables to allow easier insertion of Face headers in outgoing messages. -- 2.25.1