alx/mu4e
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

* mu4e: add FAQ about UTF-7-encoded dirs, lack of UTF-8-supported in texi2pdf

Browse Source
This commit is contained in:
djcb
2013-06-17 00:54:19 +03:00
parent 15936cfd9a
commit 6ac32efd6d
1 changed files with 14 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
mu4e/mu4e.texi
View File

@ -1,3 +1,4 @@
@documentencoding UTF-8
\input texinfo.tex @c -*-texinfo-*- \input texinfo.tex @c -*-texinfo-*-
@include texi.texi @include texi.texi
@c %**start of header @c %**start of header
@ -8,8 +9,6 @@
@c Cf. Texinfo manual 14.2 @c Cf. Texinfo manual 14.2
@set txicodequoteundirected @set txicodequoteundirected
@set txicodequotebacktick @set txicodequotebacktick
@documentencoding UTF-8
@c %**end of header @c %**end of header
@copying @copying
@ -68,7 +67,7 @@ folders, you can use queries that match all messages in a folder}, only
queries queries
@item Fully documented, with example configurations @item Fully documented, with example configurations
@item User-interface optimized for speed, with quick key strokes for common actions @item User-interface optimized for speed, with quick key strokes for common actions
@item Support for non-English languages (so ``angstrom'' will match ``Ångström'') @item Support for non-English languages (so ``angstrom'' will match ``Angström'')
@item Asynchronous; heavy actions don't block @command{emacs}@footnote{currently, @item Asynchronous; heavy actions don't block @command{emacs}@footnote{currently,
the only exception to this is @emph{sending mail}; there are solutions for the only exception to this is @emph{sending mail}; there are solutions for
that though - see the @ref{FAQ}} that though - see the @ref{FAQ}}
@ -1144,7 +1143,7 @@ convert the html into plain-text for display. The default way to do that is to
use the @command{emacs} built-in @code{html2text} function. However, you can use the @command{emacs} built-in @code{html2text} function. However, you can
set the variable @code{mu4e-html2text-command} to use some external program set the variable @code{mu4e-html2text-command} to use some external program
instead. This program is expected to take html from standard input and write instead. This program is expected to take html from standard input and write
plain text in @t{utf-8} encoding on standard output. plain text in @t{UTF-8} encoding on standard output.
An example of such a program is the program that is actually @emph{called} An example of such a program is the program that is actually @emph{called}
@t{html2text}@footnote{@url{http://www.mbayer.de/html2text/}}. After @t{html2text}@footnote{@url{http://www.mbayer.de/html2text/}}. After
@ -2967,6 +2966,13 @@ main-window.
when they are moved to different folders. Can @t{mu4e} somehow accomodate when they are moved to different folders. Can @t{mu4e} somehow accomodate
this?} Yes - you can set the variable @code{mu4e-change-filenames-when-moving} this?} Yes - you can set the variable @code{mu4e-change-filenames-when-moving}
to non-nil. to non-nil.
@item @emph{@command{offlineimap} uses IMAP's UTF-7 for encoding
non-ascii folder names, while @t{mu} expects UTF-8 (so, e.g. @t{/まりもえ
お}@footnote{some Japanese characters, invisible in the UTF-8 version of this
manual} becomes @t{/&MH4wijCCMEgwSg-}). How can display such folders
correctly?} This is best solved by telling @command{offlineimap} to use UTF-8
instead -- see
@url{https://github.com/djcb/mu/issues/68#issuecomment-8598652}.
@end enumerate @end enumerate
@node Reading messages @node Reading messages
@ -3067,7 +3073,7 @@ as a todo-list.
@itemize @itemize
@item @emph{mu4e does not work well if the @command{emacs} language environment is not @item @emph{mu4e does not work well if the @command{emacs} language environment is not
utf-8}; so, if you problems with encodings, be sure to have UTF-8}; so, if you problems with encodings, be sure to have
@code{(set-language-environment "UTF-8")} in your @file{~/.emacs}. @code{(set-language-environment "UTF-8")} in your @file{~/.emacs}.
@item @emph{Thread handling is incomplete.} While threads are calculated and are @item @emph{Thread handling is incomplete.} While threads are calculated and are
visible in the headers buffer, you cannot collapse/open them. visible in the headers buffer, you cannot collapse/open them.
@ -3083,6 +3089,9 @@ error in process filter: mu4e-error-handler: Error 70: cannot read
when sending a reply to a new e-mail. This seems to be caused by @t{notmuch} when sending a reply to a new e-mail. This seems to be caused by @t{notmuch}
changing the name of the original message file while @t{mu4e} is working in on changing the name of the original message file while @t{mu4e} is working in on
it. To prevent this, deactivate @t{notmuch} in your Emacs setup. it. To prevent this, deactivate @t{notmuch} in your Emacs setup.
@item @emph{The PDF-version of the manual does not show any of the non-ASCII
characters} - this is because, sadly, @t{texi2pdf} documentation system
does not support those. There is not much we can do about that.
@end itemize @end itemize
For a more complete list, please refer to the issues-list in the For a more complete list, please refer to the issues-list in the