mu4e.texi: mention header-line-format misalignment & workaround

We can't fully fix this with the current headers-view, but this may help
some user. Based on code provided by @phil-s.

Fixes #2606.
This commit is contained in:
Dirk-Jan C. Binnema 2023-12-04 20:52:31 +02:00
parent 038d6ea6b6
commit 0ee0a26689
1 changed files with 25 additions and 16 deletions

View File

@ -4412,27 +4412,36 @@ as:
@node Known issues @node Known issues
@section Known issues @section Known issues
Although they are not really @emph{questions}, we end this chapter with Although they are not really @emph{questions}, we end this chapter with a list
a list of known issues and/or missing features in @t{mu4e}. Thus, users of known issues and/or missing features in @t{mu4e}. Thus, users won't have to
won't have to search in vain for things that are not there (yet), and search in vain for things that are not there (yet), and the author can use it as
the author can use it as a todo-list. a todo-list.
@subsection UTF-8 language environment is required @subsection UTF-8 language environment is required
@t{mu4e} does not work well if the Emacs language environment is not @t{mu4e} does not work well if the Emacs language environment is not UTF-8; so,
UTF-8; so, if you encounter problems with encodings, be sure to have if you encounter problems with encodings, be sure to have
@code{(set-language-environment "UTF-8")} in your @file{~/.emacs} (or @code{(set-language-environment "UTF-8")} in your @file{~/.emacs} (or its moral
its moral equivalents in other places). equivalents in other places).
@subsection Thread handling is incomplete @subsection Headers-buffer can get mis-aligned
While threads are calculated and are visible in the headers buffer, Due to the way the headers buffer works, it can get misaligned.
you cannot collapse/open them.
@subsection Key-bindings are @emph{somewhat} hard-coded. For the particular case where the header values are misaligned with the column
That is, the main menu assumes the default key-bindings, as do the headings, you can try something like the following:
clicks-on-bookmarks. @lisp
(add-hook 'mu4e-headers-mode-hook #'my-mu4e-headers-mode-hook)
(defun my-mu4e-headers-mode-hook ()
;; Account for the fringe and other spacing in the header line.
(header-line-indent-mode 1)
(push (propertize " " 'display '(space :align-to header-line-indent-width))
header-line-format)
;; Ensure `text-scale-adjust' scales the header line with the headers themselves
;; by ensuring the `default' face is in the inheritance hierarchy.
(face-remap-add-relative 'header-line '(:inherit (mu4e-header-face default)))
@end lisp
For a more complete list, please refer to the issues-list in the This does not solve all possible issues; that would require a thorough rework of
github-repository. the headers-view, which may happen at some time.
@node Tips and Tricks @node Tips and Tricks
@appendix Tips and Tricks @appendix Tips and Tricks