From: Bill W. <wo...@us...> - 2005-12-24 00:27:32
|
Update of /cvsroot/mh-e/doc In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv17215 Modified Files: mh-e.texi ChangeLog Log Message: (HTML): Add descriptions of the mm-text-html-renderer choices. Index: mh-e.texi =================================================================== RCS file: /cvsroot/mh-e/doc/mh-e.texi,v retrieving revision 1.92 retrieving revision 1.93 diff -u -d -r1.92 -r1.93 --- mh-e.texi 23 Dec 2005 05:48:27 -0000 1.92 +++ mh-e.texi 24 Dec 2005 00:27:23 -0000 1.93 @@ -2199,31 +2199,115 @@ @vindex mm-text-html-renderer MH-E can display messages that have been sent in HTML@footnote{This -feature depends on post-5.10 versions of Gnus.}. The browser used -depends on the setting of the option @code{mm-text-html-renderer}. -@xref{Display Customization, , , emacs-mime, Emacs MIME}, and the -documentation for @kbd{W h} (@pxref{Article Washing, , , gnus, The -Gnus Newsreader}), for additional information. The default setting is -set automatically based upon the presence of a known browser on your -system. If you wish to use a different browser, then set this option -accordingly. See the documentation for the browser you use for -additional information on how to use it. - -@cindex Emacs, packages, w3m -@cindex w3m package - -For example, if you're using the built-in browser @samp{w3m}, the -content of the message will appear in the MH-Show buffer if the entire -message is HTML, or there is an inline HTML body part. If there is an -HTML body part that is an attachment, then you'll see a button like -this: +feature depends on post-5.10 versions of Gnus.}. The content of the +message will appear in the MH-Show buffer as you would expect if the +entire message is HTML, or there is an inline HTML body part. However, +if there is an HTML body part that is an attachment, then you'll see a +button like this: @example [1. text/html; foo.html]... @end example -You can read the contents of this body part using the methods -described in @ref{Viewing Attachments}. +See @ref{Viewing Attachments} to see how to read the contents of this +body part. + +The browser that MH-E uses is determined by the option +@code{mm-text-html-renderer}. The default setting is set automatically +based upon the presence of a known browser on your system. If you wish +to use a different browser, then set this option accordingly. See the +documentation for the browser you use for additional information on +how to use it. In particular, find and disable the option to render +images as this can tip off spammers that the email address they have +used is valid. + +If you're confused about which @code{mm-text-html-renderer} to use, +here's a brief description of each, sorted by popularity, that +includes the results of a quick poll of MH-E users from 2005-12-23. + +@table @asis + +@item @samp{w3m} 7 + +The @samp{w3m} browser requires an external program. It's quick, +produces pretty nice output, and best of all, it's the only browser +that highlights links. These can be clicked with @kbd{Mouse-2} to view +the content of the link in @samp{w3m} or with @kbd{S-Mouse-2} to view +the content of the link in an external browser. The @samp{w3m} browser +handles tables well and actually respects the table's width parameter +(which can cause text to wrap if the author didn't anticipate that the +page would be viewed in Emacs). + +@item @samp{w3m-standalone} 2 + +This browser, along with @samp{nil} for the external browser, are the +only choices that work without having to download a separate lisp +package or external program. This browser is quick, but does not show +links. It handles simple tables but some tables get rendered much +wider than the Emacs frame. This browser was the only one not to +handle the escape @samp{–} (it printed a @samp{?}), but it did +render @samp{®}. + +@item @samp{links} 1 + +The @samp{links} browser requires an external program. It's quick, and +produces nicer output than @samp{lynx} on single column mails in +tables. However, it doesn't show links and it doesn't do as nice a job +on multi-column tables as some lines wrap. At least it fits in 80 +columns and thus seems better than @samp{w3} and +@samp{w3m-standalone}. Converts escapes such as @samp{®} to (R). + +@item @samp{lynx} 1 + +The @samp{lynx} browser requires an external program. It's quick and +produces pretty decent output but it doesn't show links. It doesn't +seem to do multi-column tables which makes output much cleaner. It +centers the output and wraps long lines more than most. Handles +@samp{®}. + +@item @samp{nil} 1 + +This choice obviously requires an external browser. Like +@samp{w3m-standalone}, it works out of the box. With this setting, +HTML messages have a button for the body part which you can view with +@kbd{K v} (@code{mh-toggle-mime-part}). + +@item @samp{w3} 0 + +This choice does not require an external program as all of the +rendering is done in lisp. You do need to get the package separately. +This browser is @strong{slow}, and doesn't appear to have been updated +since 2001 and the author hasn't responded to my emails. It displays +unknown tags instead of hiding them, so you get to see all the +Microsoft crap in certain messages. Tends to make multi-column tables +wider than even a full-screen Emacs can handle. Like @samp{w3m}, you +can follow links, but you have to find them first as they are not +highlighted. Performs well on single-column tables and handles escapes +such as @samp{®}. + +@item @samp{html2text} 0 + +The @samp{html2text} browser requires an external program. I noticed +that it can do some nasty things with simple HTML mails (like filling +the entire message as if it were one paragraph, including signature). +On another message, it displayed half of the HTML tags for some +reason. + +@end table + +For a couple more sources of information about +@code{mm-text-html-renderer}, +@ifinfo +@xref{Display Customization,,,emacs-mime}, and the documentation for +the Gnus command @kbd{W h} (@pxref{Article Washing,,,gnus},). +@end ifinfo +@ifnotinfo +see section @uref{http://www.gnus.org/manual/emacs-mime_6.html, +Display Customization} in the @cite{The Emacs MIME Manual} and the the +documentation for the Gnus command @kbd{W h} (see section +@uref{http://www.gnus.org/manual/gnus_99.html, Article Washing} in the +@cite{The Gnus Manual}). +@end ifnotinfo @node Digests, Reading PGP, HTML, Reading Mail @section Digests Index: ChangeLog =================================================================== RCS file: /cvsroot/mh-e/doc/ChangeLog,v retrieving revision 1.80 retrieving revision 1.81 diff -u -d -r1.80 -r1.81 --- ChangeLog 23 Dec 2005 05:51:43 -0000 1.80 +++ ChangeLog 24 Dec 2005 00:27:23 -0000 1.81 @@ -1,3 +1,8 @@ +2005-12-23 Bill Wohler <wo...@ne...> + + * mh-e.texi (HTML): Add descriptions of the + mm-text-html-renderer choices. + 2005-12-22 Bill Wohler <wo...@ne...> * TODO: May as well add it to the repository in case I get hit by |