From a067ef9a5ddc9812e35734e8c027684e01d684ef Mon Sep 17 00:00:00 2001 From: Tassilo Horn Date: Fri, 7 Nov 2014 10:48:25 +0000 Subject: [PATCH] doc/misc/{gnus.texi,gnus-faq.texi}: Add link to EWW manual * gnus.texi (HTML): Update section so that it mentions shr and w3m. Also link the full EWW manual that explains more on shr, too. * gnus-faq.texi (FAQ 4 - Reading messages, FAQ 4-16): Add Q&A on how to increase contrast when displaying HTML mail with shr. --- doc/misc/ChangeLog | 6 ++++++ doc/misc/gnus-faq.texi | 16 ++++++++++++++++ doc/misc/gnus.texi | 31 +++++++++++++++++++++---------- 3 files changed, 43 insertions(+), 10 deletions(-) diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog index 441285647bd..20b124f89cb 100644 --- a/doc/misc/ChangeLog +++ b/doc/misc/ChangeLog @@ -1,5 +1,11 @@ 2014-11-07 Tassilo Horn + * gnus.texi (HTML): Update section so that it mentions shr and w3m. + Also link the full EWW manual that explains more on shr, too. + + * gnus-faq.texi (FAQ 4 - Reading messages, FAQ 4-16): Add Q&A on how to + increase contrast when displaying HTML mail with shr. + * eww.texi (Advanced): Document increasing contrast with shr-color-visible-distance-min and shr-color-visible-luminance-min. diff --git a/doc/misc/gnus-faq.texi b/doc/misc/gnus-faq.texi index fd4f427431d..83fff5e9497 100644 --- a/doc/misc/gnus-faq.texi +++ b/doc/misc/gnus-faq.texi @@ -742,6 +742,7 @@ POP3 mail source. See @pxref{Mail Source Specifiers} for VALUE. * FAQ 4-14:: I don't like the way the Summary buffer looks, how to tweak it? * FAQ 4-15:: How to split incoming mails in several groups? +* FAQ 4-16:: How can I ensure more contrast when viewing HTML mail? @end menu @node FAQ 4-1 @@ -1185,6 +1186,21 @@ from using them): @end example @noindent +@node FAQ 4-16 +@subsubheading Question 4.16 + +How can I ensure more contrast when viewing HTML mail? + +@subsubheading Answer + +Gnus' built-in simple HTML renderer (you use it if the value of +@code{mm-text-html-renderer} is @code{shr}) uses the colors which are +declared in the HTML mail. However, it adjusts them in order to +prevent situations like dark gray text on black background. In case +the results still have a too low contrast for you, increase the values +of the variables @code{shr-color-visible-distance-min} and +@code{shr-color-visible-luminance-min}. + @node FAQ 5 - Composing messages @subsection Composing messages diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index a25d7c540f3..67d4ed4e9ef 100644 --- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi @@ -11761,20 +11761,31 @@ Also @pxref{MIME Commands}. @section @acronym{HTML} @cindex @acronym{HTML} -If you have @code{w3m} installed on your system, Gnus can display -@acronym{HTML} articles in the article buffer. There are many Gnus -add-ons for doing this, using various approaches, but there's one -(sort of) built-in method that's used by default. - -For a complete overview, consult @xref{Display Customization, -,Display Customization, emacs-mime, The Emacs MIME Manual}. This -section only describes the default method. +Gnus can display @acronym{HTML} articles nicely formatted in the +article buffer. There are many methods for doing that, but two of +them are kind of default methods. + +If your Emacs copy has been built with libxml2 support, then Gnus uses +Emacs' built-in, plain elisp Simple HTML Renderer @code{shr} +@footnote{@code{shr} displays colors as declared in the @acronym{HTML} +article but tries to adjust them in order to be readable. If you +prefer more contrast, have a look at question 4.16 in the +@xref{Frequently Asked Questions}.} which is also used by Emacs' +browser EWW (@xref{Top,,,eww}). + +If your Emacs copy lacks libxml2 support but you have @code{w3m} +installed on your system, Gnus uses that to render @acronym{HTML} mail +and display the results in the article buffer (@code{gnus-w3m}). + +For a complete overview, consult @xref{Display Customization, ,Display +Customization, emacs-mime, The Emacs MIME Manual}. This section only +describes the default method. @table @code @item mm-text-html-renderer @vindex mm-text-html-renderer -If set to @code{gnus-article-html}, Gnus will use the built-in method, -that's based on @code{w3m}. +If set to @code{shr}, Gnus uses its own simple @acronym{HTML} +renderer. If set to @code{gnus-w3m}, it uses @code{w3m}. @item gnus-blocked-images @vindex gnus-blocked-images -- 2.39.5