manual: Deal with annoying misfeature of texinfo

Texinfo is of the opinion that every hyperlink has to be prefixed
by either "see" or "in".  If neither of these words appears there,
then it inserts "see" and it cannot be told not to do that.

This turns a correct sentence like:
  > Mu4e lets you define custom actions for messages in the <Headers view>.
into:
  > Mu4e lets you define custom actions for messages in the see <Headers view>.
The best compromise is
  > Mu4e lets you define custom actions for messages in <Headers view>.
which isn't correct but at least less messed up.

Alternatively one could rephrase every sentence that contains a link
to circumvent Texinfo's speech impairment.  Or one could replace each
link with a footnote and place the actual link in the footnote.
This commit is contained in:
Jonas Bernoulli 2020-02-17 11:46:31 +01:00
parent 440ea3fe6f
commit 4ce296d6b2
1 changed files with 2 additions and 2 deletions

View File

@ -2864,8 +2864,8 @@ edited. When you compose a totally new message, the @var{msg} parameter is
@node Actions
@chapter Actions
@t{mu4e} lets you define custom actions for messages in the @ref{Headers view}
and for both messages and attachments in the @ref{Message view}. Custom
@t{mu4e} lets you define custom actions for messages in @ref{Headers view}
and for both messages and attachments in @ref{Message view}. Custom
actions allow you to easily extend @t{mu4e} for specific needs --- for example,
marking messages as spam in a spam filter or applying an attachment with a
source code patch.