[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs-24 r117699: doc/misc/{gnus.texi, gnus-faq.texi}: Upd
From: |
Katsumi Yamaoka |
Subject: |
[Emacs-diffs] emacs-24 r117699: doc/misc/{gnus.texi, gnus-faq.texi}: Update docs wrt shr/html mail |
Date: |
Mon, 10 Nov 2014 09:28:31 +0000 |
User-agent: |
Bazaar (2.6b2) |
------------------------------------------------------------
revno: 117699
revision-id: address@hidden
parent: address@hidden
author: Tassilo Horn <address@hidden>
committer: Katsumi Yamaoka <address@hidden>
branch nick: emacs-24
timestamp: Mon 2014-11-10 09:28:18 +0000
message:
doc/misc/{gnus.texi,gnus-faq.texi}: Update docs wrt shr/html mail
* 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.
modified:
doc/misc/ChangeLog changelog-20091113204419-o5vbwnq5f7feedwu-6331
doc/misc/gnus-faq.texi
gnusfaq.texi-20091113204419-o5vbwnq5f7feedwu-6304
doc/misc/gnus.texi gnus.texi-20091113204419-o5vbwnq5f7feedwu-6305
=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog 2014-11-09 02:02:51 +0000
+++ b/doc/misc/ChangeLog 2014-11-10 09:28:18 +0000
@@ -1,3 +1,11 @@
+2014-11-07 Tassilo Horn <address@hidden>
+
+ * 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.
+
2014-11-09 Glenn Morris <address@hidden>
* Makefile.in (version): Remove variable.
=== modified file 'doc/misc/gnus-faq.texi'
--- a/doc/misc/gnus-faq.texi 2014-06-08 23:39:23 +0000
+++ b/doc/misc/gnus-faq.texi 2014-11-10 09:28:18 +0000
@@ -742,6 +742,7 @@
* 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 @@
@end example
@noindent
address@hidden FAQ 4-16
address@hidden Question 4.16
+
+How can I ensure more contrast when viewing HTML mail?
+
address@hidden Answer
+
+Gnus' built-in simple HTML renderer (you use it if the value of
address@hidden 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
address@hidden
+
@node FAQ 5 - Composing messages
@subsection Composing messages
=== modified file 'doc/misc/gnus.texi'
--- a/doc/misc/gnus.texi 2014-06-08 23:39:23 +0000
+++ b/doc/misc/gnus.texi 2014-11-10 09:28:18 +0000
@@ -618,6 +618,7 @@
* Hiding Headers:: Deciding what headers should be displayed.
* Using MIME:: Pushing articles through @acronym{MIME} before
reading them.
+* HTML:: Reading @acronym{HTML} messages.
* Customizing Articles:: Tailoring the look of the articles.
* Article Keymap:: Keystrokes available in the article buffer.
* Misc Article:: Other stuff.
@@ -11747,20 +11748,30 @@
@section @acronym{HTML}
@cindex @acronym{HTML}
-If you have @code{w3m} installed on your system, Gnus can display
address@hidden 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}
address@hidden@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, @xref{FAQ 4-16}.} which is also used by Emacs'
+browser EWW (@pxref{EWW, ,EWW, emacs, The Emacs Manual}).
+
+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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] emacs-24 r117699: doc/misc/{gnus.texi, gnus-faq.texi}: Update docs wrt shr/html mail,
Katsumi Yamaoka <=