From: Konrad Scorciapino <konrad@scorciapino.com>
Date: Wed, 23 Mar 2011 19:21:20 +0000 (-0300)
Subject: Merge branch 'master' of git://notmuchmail.org/git/notmuch-wiki
X-Git-Url: https://git.cworth.org/git?p=notmuch-wiki;a=commitdiff_plain;h=e37567f20588e4075b06efd8e29d29f70338ad8c;hp=e04e2b521cc8baeba3641d7ddee0c9cd51ddea1b

Merge branch 'master' of git://notmuchmail.org/git/notmuch-wiki
---

diff --git a/emacstips.mdwn b/emacstips.mdwn
index 2aed80a..c7e7be4 100644
--- a/emacstips.mdwn
+++ b/emacstips.mdwn
@@ -174,12 +174,24 @@ useful to you.
 
 ## Viewing HTML messages with an external viewer
 
-The emacs client can often display an HTML message inline, but it
-sometimes fails for one reason or another, (or is perhaps inadequate
-if you really need to see the graphical presentation of the HTML
-message).
-
-In this case, it can be useful to display the message in an external
+The emacs client can display an HTML message inline using either the
+`html2text` library or some text browser, like w3m or lynx. This is
+controlled by the `mm-text-html-renderer` variable.
+
+The first option is theorically better, because it can generate
+strings formatted for emacs and do whatever you want, e.g., substitute
+text inside <b> tags for bold text in the buffer. The library, however
+is still in a very early development phase and cannot yet process
+properly many elements, like tables and <style> directives, and even
+the generated text is often poorly formatted.
+
+Among the available browsers, w3m seems to do a better job converting
+the html, and if you have the w3m emacs package, you can use it,
+instead of the w3m-standalone, and thus preserve the text formatting.
+
+But if the rendering fails for one reason or another, (or is perhaps
+inadequate if you really need to see the graphical presentation of the
+HTML message), it can be useful to display the message in an external
 viewer, such as a web browser. Here's a little script that Keith
 Packard wrote, which he calls `view-html`: