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 Emacs 21.
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).

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-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 Emacs 21.
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').

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"))