Variable: mh-show-use-xface-flag

mh-show-use-xface-flag is a customizable variable defined in mh-e.el.gz.

Value

t

Documentation

Non-nil means display face images in MH-show buffers.

MH-E can display the content of "Face:", "X-Face:", and
"X-Image-URL:" header fields. If any of these fields occur in the
header of your message, the sender's face will appear in the "From:" header field. If more than one of these fields appear, then the first field found in the order "Face:", "X-Face:", and "X-Image-URL:" will be used.

The option mh-show-use-xface-flag is used to turn this feature on and off. This feature will be turned on by default if your system supports it.

The first header field used, if present, is the Gnus-specific
"Face:" field. The "Face:" field appeared in GNU Emacs 21 and
XEmacs. For more information, see URL https://quimby.gnus.org/circus/face/. Next is the traditional
"X-Face:" header field. The display of this field requires the
"uncompface" program (see URL
ftp://ftp.cs.indiana.edu/pub/faces/compface/compface.tar.z). Recent versions of XEmacs have internal support for "X-Face:" images. If your version of XEmacs does not, then you'll need both "uncompface" and the x-face package (see URL https://www.jpl.org/ftp/pub/elisp/).

Finally, MH-E will display images referenced by the "X-Image-URL:" header field if neither the "Face:" nor the "X-Face:" fields are present. The display of the images requires "wget" (see URL https://www.gnu.org/software/wget/wget.html), "fetch", or "curl" to fetch the image and the "convert" program from the ImageMagick suite (see URL https://www.imagemagick.org/). Of the three header fields this is the most efficient in terms of network usage since the image doesn't need to be transmitted with every single mail.

The option mh-fetch-x-image-url controls the fetching of the
"X-Image-URL:" header field image.

This variable was added, or its default value changed, in MH-E version
7.0.

Source Code

;; Defined in /usr/src/emacs/lisp/mh-e/mh-e.el.gz
(defcustom-mh mh-show-use-xface-flag (>= emacs-major-version 21)
  "Non-nil means display face images in MH-show buffers.

MH-E can display the content of \"Face:\", \"X-Face:\", and
\"X-Image-URL:\" header fields. If any of these fields occur in the
header of your message, the sender's face will appear in the \"From:\"
header field. If more than one of these fields appear, then the first
field found in the order \"Face:\", \"X-Face:\", and \"X-Image-URL:\"
will be used.

The option `mh-show-use-xface-flag' is used to turn this feature on
and off. This feature will be turned on by default if your system
supports it.

The first header field used, if present, is the Gnus-specific
\"Face:\" field. The \"Face:\" field appeared in GNU Emacs 21 and
XEmacs. For more information, see URL
`https://quimby.gnus.org/circus/face/'. Next is the traditional
\"X-Face:\" header field. The display of this field requires the
\"uncompface\" program (see URL
`ftp://ftp.cs.indiana.edu/pub/faces/compface/compface.tar.z'). Recent
versions of XEmacs have internal support for \"X-Face:\" images. If
your version of XEmacs does not, then you'll need both \"uncompface\"
and the x-face package (see URL `https://www.jpl.org/ftp/pub/elisp/').

Finally, MH-E will display images referenced by the \"X-Image-URL:\"
header field if neither the \"Face:\" nor the \"X-Face:\" fields are
present. The display of the images requires \"wget\" (see URL
`https://www.gnu.org/software/wget/wget.html'), \"fetch\", or \"curl\"
to fetch the image and the \"convert\" program from the ImageMagick
suite (see URL `https://www.imagemagick.org/'). Of the three header
fields this is the most efficient in terms of network usage since the
image doesn't need to be transmitted with every single mail.

The option `mh-fetch-x-image-url' controls the fetching of the
\"X-Image-URL:\" header field image."
  :type 'boolean
  :group 'mh-show
  :package-version '(MH-E . "7.0"))