+2004-03-04 Katsumi Yamaoka <yamaoka@jpl.org>
+
+ * gnus.texi (X-Face, Face): Add gnus-x-face and
+ gnus-face-properties-alist.
+
2004-03-04 Jesper Harder <harder@ifa.au.dk>
* texi2latex.el (latexi-translate-file): Support accents.
@vindex uncompface-use-external-threshold
\e$B%[%9%H%^%7%s$,CY$$$+$I$&$+$r8!::$9$k$?$a$NIC?t$G$9!#\e(BELisp \e$B$G=q$+$l$?Fb\e(B
\e$BIt\e(B @code{uncompface} \e$B%W%m%0%i%`$r;H$C$F\e(B @code{X-Face} \e$B$r%G%3!<%I$9$k$N$K\e(B
-\e$B$+$+$k;~4V$,$3$NCM$h$jBg$-$$>l9g$O!"30It%G%3!<%@$N;HMQ$KJQ99$5$l$^$9!#\e(B
+\e$B$+$+$k;~4V$,$3$NCM$h$jBg$-$$>l9g$O!"30It%G%3!<%@$N;HMQ$KJQ99$5$l$^$9!#%G%#\e(B
+\e$B%U%)%k%H$O\e(B 0.1 \e$BIC$G$9!#\e(B
@end table
\e$BFbIt%G%3!<%@$,L58z$K$5$l$k>l9g!"$"$k$$$O\e(B XEmacs \e$B$r;H$C$F$$$k>l9g$O!"\e(B
(\e$BCm\e(B: \e$BJQ?t\e(B/\e$B4X?tL>$K$O\e(B @code{xface} \e$B$G$O$J$/\e(B @code{x-face} \e$B$,;H$o$l$^$9!#\e(B)
+\e$B%U%'!<%9$HJQ?t\e(B:
+
+@table @code
+@item gnus-x-face
+@vindex gnus-x-face
+X-Face \e$B$rI=<($9$k$?$a$N%U%'!<%9!#$3$N%U%'!<%9$N?'$,I=<($5$l$k\e(B X-Face \e$B$N\e(B
+\e$BA07J?'$HGX7J?'$H$7$F;H$o$l$^$9!#%G%#%U%)%k%H$N?'$OGr$H9u$G$9!#\e(B
+
+@item gnus-face-properties-alist
+@vindex gnus-face-properties-alist
+Face (@pxref{Face}) \e$B$H\e(B X-Face \e$B2hA|$KE,MQ$5$l$k!"2hA|$N7A<0$H%W%m%Q%F%#$N\e(B
+\e$BO"A[%j%9%H$G$9!#%G%#%U%)%k%HCM$O\e(B Emacs \e$BMQ$N\e(B @code{((pbm . (:face
+gnus-x-face)) (png . nil))} \e$B$^$?$O\e(B XEmacs \e$BMQ$N\e(B @code{((xface . (:face
+gnus-x-face)))} \e$B$G$9!#Nc$r5s$2$^$7$g$&\e(B:
+
+@lisp
+;; From \e$B%X%C%@!<$K$*$1$k\e(B Face \e$B$H\e(B X-Face \e$B$N9b$5$r;XDj$7$^$9!#\e(B
+(setq gnus-face-properties-alist
+ '((pbm . (:face gnus-x-face :ascent 80))
+ (png . (:ascent 80))))
+
+;; Face \e$B$H\e(B X-Face \e$B$r1z$s$@%\%?%s$N$h$&$KI=<($7$^$9!#\e(B
+(setq gnus-face-properties-alist
+ '((pbm . (:face gnus-x-face :relief -2))
+ (png . (:relief -2))))
+@end lisp
+
+\e$B$$$m$$$m$J2hA|$N7A<0$GMxMQ2DG=$J%W%m%Q%F%#$K$D$$$F$O\e(B @pxref{Image
+Descriptors, ,Image Descriptors, elisp, The Emacs Lisp Reference
+Manual} \e$B$r;2>H$7$F2<$5$$!#:#$N$H$3$m\e(B Emacs \e$B$G$O\e(B @code{pbm} \e$B$,\e(B X-Face \e$B2h\e(B
+\e$BA|$K;H$o$l!"\e(B @code{png} \e$B$,\e(B Face \e$B2hA|$K;H$o$l$^$9!#\e(BXEmacs \e$B$G$O!"$=$l\e(B
+\e$B$,\e(B @samp{libcompface} \e$B%i%$%V%i%j$H$H$b$K9=C[$5$l$F$$$l$P!"\e(B
+@code{xface} \e$B2hA|7A<0$K\e(B @code{:face} \e$B%W%m%Q%F%#$@$1$,8z2L$r5Z$\$7$^$9!#\e(B
+@end table
+
gnus \e$B$O!"30$K=P$9%a%C%;!<%8$K\e(B X-Face \e$B%X%C%@!<$r4JC1$KA^F~$9$k$?$a$N!"JX\e(B
\e$BMx$J4X?t$HJQ?t$r>/$7$P$+$jDs6!$7$^$9!#\e(B
\e$B$l$P$J$j$^$;$s!#@53N$J;EMM$K$D$$$F!"\e(B
@uref{http://quimby.gnus.org/circus/face/} \e$B$r;2>H$7$F2<$5$$!#\e(B
+\e$BJQ?t\e(B @code{gnus-face-properties-alist} \e$B$OI=<($5$l$k\e(B Face \e$B2hA|$N304Q$K1F\e(B
+\e$B6A$7$^$9!#\e(B@xref{X-Face}.
+
\e$BAw?.$9$k%a%C%;!<%8$K4JC1$K\e(B Face \e$B%X%C%@!<$rA^F~$G$-$k$h$&$K$9$k$?$a$K!"\e(B
Gnus \e$B$O\e(B 2\e$B!A\e(B3 \e$B$N4X?t$HJQ?t$rDs6!$7$^$9!#\e(B
@item uncompface-use-external-threshold
@vindex uncompface-use-external-threshold
-@vindex uncompface-use-external-threshold
A number of seconds to check whether the host machine is slow. If the
host takes time larger than this value for decoding an @code{X-Face}
using the internal ELisp-based @code{uncompface} program, it will be
-changed to using the external decoder.
+changed to using the external decoder. The default is 0.1 seconds.
@end table
If the internal decoder is invalidated or if you are using XEmacs,
(Note: @code{x-face} is used in the variable/function names, not
@code{xface}).
+@noindent
+Face and variable:
+
+@table @code
+@item gnus-x-face
+@vindex gnus-x-face
+Face to show X-Face. The colors from this face are used as the
+foreground and background colors of the displayed X-Faces. The
+default colors are black and white.
+
+@item gnus-face-properties-alist
+@vindex gnus-face-properties-alist
+Alist of image types and properties applied to Face (@pxref{Face}) and
+X-Face images. The default value is @code{((pbm . (:face gnus-x-face))
+(png . nil))} for Emacs or @code{((xface . (:face gnus-x-face)))} for
+XEmacs. Here are examples:
+
+@lisp
+;; Specify the altitude of Face and X-Face images in the From header.
+(setq gnus-face-properties-alist
+ '((pbm . (:face gnus-x-face :ascent 80))
+ (png . (:ascent 80))))
+
+;; Show Face and X-Face images as pressed buttons.
+(setq gnus-face-properties-alist
+ '((pbm . (:face gnus-x-face :relief -2))
+ (png . (:relief -2))))
+@end lisp
+
+@pxref{Image Descriptors, ,Image Descriptors, elisp, The Emacs Lisp
+Reference Manual} for the valid properties for various image types.
+Currently, @code{pbm} is used for X-Face images and @code{png} is used
+for Face images in Emacs. Only the @code{:face} property is effective
+on the @code{xface} image type in XEmacs if it is built with the
+@samp{libcompface} library.
+@end table
+
Gnus provides a few convenience functions and variables to allow
easier insertion of X-Face headers in outgoing messages.
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}.
+
Gnus provides a few convenience functions and variables to allow
easier insertion of Face headers in outgoing messages.
projects / elisp / gnus.git- / commitdiff