mu4e/mu4e.texi: fix external links in html

Fixes #2182.

Makefile

@@ -156,4 +156,4 @@ distclean: clean
 HTMLPATH=${BUILDDIR}/mu4e/mu4e
 mu4e-doc-html:
 	@mkdir -p ${HTMLPATH} && cp mu4e/texinfo-klare.css ${HTMLPATH}
-	@makeinfo -I ${BUILDDIR}/mu4e --html --css-ref=texinfo-klare.css -o ${HTMLPATH} mu4e/mu4e.texi
+	@cd mu4e; makeinfo -v -I ${BUILDDIR}/mu4e --html --css-ref=texinfo-klare.css -o ${HTMLPATH} mu4e.texi

mu4e/htmlxref.cnf

@@ -0,0 +1,788 @@
+# htmlxref.cnf - reference file for free Texinfo manuals on the web.
+
+htmlxrefversion=2023-04-02.12; # UTC
+
+# Copyright 2010-2023 Free Software Foundation, Inc.
+# 
+# Copying and distribution of this file, with or without modification,
+# are permitted in any medium without royalty provided the copyright
+# notice and this notice are preserved.
+#
+# The latest version of this file is available at
+# http://ftpmirror.gnu.org/texinfo/htmlxref.cnf.
+# Email corrections or additions to bug-texinfo@gnu.org.
+# The primary goal is to list all relevant GNU manuals;
+# other free manuals are also welcome.
+#
+# To be included in this list, a manual must:
+#
+# - have a generic url, e.g., no version numbers;
+# - have a unique file name (e.g., manual identifier), i.e., be related to the
+#   package name.  Things like "refman" or "tutorial" don't work.
+# - follow the naming convention for nodes described at
+# http://www.gnu.org/software/texinfo/manual/texinfo/html_node/HTML-Xref.html
+#   This is what makeinfo and texi2html implement.
+# 
+# Unless the above criteria are met, it's not possible to generate
+# reliable cross-manual references.
+# 
+# For information on automatically generating all the useful formats for
+# a manual to put on the web, see
+# http://www.gnu.org/prep/maintain/html_node/Manuals-on-Web-Pages.html.
+
+# For people editing this file: when a manual named foo is related to a
+# package named bar, the url should contain a variable reference ${BAR}.
+# Otherwise, the gnumaint scripts have no way of knowing they are
+# associated, and thus gnu.org/manual can't include them.
+
+# shorten references to manuals on www.gnu.org.
+G = https://www.gnu.org
+GS = ${G}/software
+
+3dldf		mono	${GS}/3dldf/manual/user_ref/3DLDF.html
+3dldf		node	${GS}/3dldf/manual/user_ref/
+
+alive		mono	${GS}/alive/manual/alive.html
+alive		node	${GS}/alive/manual/html_node/
+
+anubis		mono	${GS}/anubis/manual/anubis.html
+anubis		chapter	${GS}/anubis/manual/html_chapter/
+anubis		section	${GS}/anubis/manual/html_section/
+anubis		node	${GS}/anubis/manual/html_node/
+
+artanis		mono	${GS}/artanis/manual/artanis.html
+artanis		node	${GS}/artanis/manual/html_node/
+
+aspell		section	http://aspell.net/man-html/index.html
+
+auctex		mono	${GS}/auctex/manual/auctex.html
+auctex		node	${GS}/auctex/manual/auctex/
+
+autoconf	mono	${GS}/autoconf/manual/autoconf.html
+autoconf	node	${GS}/autoconf/manual/html_node/
+
+autogen		mono	${GS}/autogen/manual/autogen.html
+autogen		chapter	${GS}/autogen/manual/html_chapter/
+autogen		node	${GS}/autoconf/manual/html_node/
+
+automake	mono	${GS}/automake/manual/automake.html
+automake	node	${GS}/automake/manual/html_node/
+
+avl		node	http://adtinfo.org/libavl.html/
+
+bash		mono	${GS}/bash/manual/bash.html
+bash		node	${GS}/bash/manual/html_node/
+
+BINUTILS = https://sourceware.org/binutils/docs
+binutils	mono	${BINUTILS}/binutils.html
+binutils	node	${BINUTILS}/binutils/
+ #
+ as		mono	${BINUTILS}/as.html
+ as		node	${BINUTILS}/as/
+ #
+ bfd		mono	${BINUTILS}/bfd.html
+ bfd		node	${BINUTILS}/bfd/
+ #
+ gprof		mono	${BINUTILS}/gprof.html
+ gprof		node	${BINUTILS}/gprof/
+ #
+ ld		mono	${BINUTILS}/ld.html
+ ld		node	${BINUTILS}/ld/
+
+bison		mono	${GS}/bison/manual/bison.html
+bison		node	${GS}/bison/manual/html_node/
+
+bpel2owfn	mono	${GS}/bpel2owfn/manual/2.0.x/bpel2owfn.html
+
+ccd2cue		mono	${GS}/ccd2cue/manual/ccd2cue.html
+ccd2cue		node	${GS}/ccd2cue/manual/html_node/
+
+cflow		mono	${GS}/cflow/manual/cflow.html
+cflow		node	${GS}/cflow/manual/html_node/
+
+chess		mono	${GS}/chess/manual/gnuchess.html
+chess		node	${GS}/chess/manual/html_node/
+
+combine		mono	${GS}/combine/manual/combine.html
+combine		chapter	${GS}/combine/manual/html_chapter/
+combine		section	${GS}/combine/manual/html_section/
+combine		node	${GS}/combine/manual/html_node/
+
+complexity	mono	${GS}/complexity/manual/complexity.html
+complexity	node	${GS}/complexity/manual/html_node/
+
+coreutils	mono	${GS}/coreutils/manual/coreutils.html
+coreutils	node	${GS}/coreutils/manual/html_node/
+
+cpio		mono	${GS}/cpio/manual/cpio.html
+cpio		node	${GS}/cpio/manual/html_node/
+
+cssc		node	${GS}/cssc/manual/
+
+CVS = ${GS}/trans-coord/manual
+cvs		mono	${CVS}/cvs/cvs.html
+cvs		node	${CVS}/cvs/html_node/
+
+ddd		mono	${GS}/ddd/manual/html_mono/ddd.html
+
+ddrescue	mono	${GS}/ddrescue/manual/ddrescue_manual.html
+
+dejagnu         node    ${GS}/dejagnu/manual/
+
+DICO = https://www.gnu.org.ua/software/dico/manual
+dico		mono	${DICO}/dico.html
+dico		chapter	${DICO}/html_chapter/
+dico		section	${DICO}/html_section/
+dico		node	${DICO}/html_node/
+
+diffutils	mono	${GS}/diffutils/manual/diffutils.html
+diffutils	node	${GS}/diffutils/manual/html_node/
+
+ed		mono	${GS}/ed/manual/ed_manual.html
+
+EMACS = ${GS}/emacs/manual
+emacs		mono	${EMACS}/html_mono/emacs.html
+emacs		node	${EMACS}/html_node/emacs/
+ #
+ auth		mono	${EMACS}/html_mono/auth.html
+ auth		node	${EMACS}/html_node/auth/
+ #
+ autotype	mono	${EMACS}/html_mono/autotype.html
+ autotype	node	${EMACS}/html_node/autotype/
+ #
+ calc		mono	${EMACS}/html_mono/calc.html
+ calc		node	${EMACS}/html_node/calc/
+ #
+ ccmode		mono	${EMACS}/html_mono/ccmode.html
+ ccmode		node	${EMACS}/html_node/ccmode/
+ #
+ cl		mono	${EMACS}/html_mono/cl.html
+ cl		node	${EMACS}/html_node/cl/
+ #
+ dbus		mono	${EMACS}/html_mono/dbus.html
+ dbus		node	${EMACS}/html_node/dbus/
+ #
+ ebrowse	mono	${EMACS}/html_mono/ebrowse.html
+ ebrowse	node	${EMACS}/html_node/ebrowse/
+ #
+ ede		mono	${EMACS}/html_mono/ede.html
+ ede		node	${EMACS}/html_node/ede/
+ #
+ edt		mono	${EMACS}/html_mono/edt.html
+ edt		node	${EMACS}/html_node/edt/
+ #
+ ediff		mono	${EMACS}/html_mono/ediff.html
+ ediff		node	${EMACS}/html_node/ediff/
+ #
+ eieio		mono	${EMACS}/html_mono/eieio.html
+ eieio		node	${EMACS}/html_node/eieio/
+ #
+ elisp		mono	${EMACS}/html_mono/elisp.html
+ elisp		node	${EMACS}/html_node/elisp/
+ #
+ emacs-gnutls	mono	${EMACS}/html_mono/emacs-gnutls.html
+ emacs-gnutls	node	${EMACS}/html_node/emacs-gnutls/
+ #
+ emacs-mime	mono	${EMACS}/html_mono/emacs-mime.html
+ emacs-mime	node	${EMACS}/html_node/emacs-mime/
+ #
+ epa		mono	${EMACS}/html_mono/epa.html
+ epa		node	${EMACS}/html_node/epa/
+ #
+ erc		mono	${EMACS}/html_mono/erc.html
+ erc		node	${EMACS}/html_node/erc/
+ #
+ dired-x	mono	${EMACS}/html_mono/dired-x.html
+ dired-x	node	${EMACS}/html_node/dired-x/
+ #
+ ert		mono	${EMACS}/html_mono/ert.html
+ ert		node	${EMACS}/html_node/ert/
+ #
+ eshell		mono	${EMACS}/html_mono/eshell.html
+ eshell		node	${EMACS}/html_node/eshell/
+ #
+ eudc		mono	${EMACS}/html_mono/eudc.html
+ eudc		node	${EMACS}/html_node/eudc/
+ #
+ eww		mono	${EMACS}/html_mono/eww.html
+ eww		node	${EMACS}/html_node/eww/
+ #
+ forms		mono	${EMACS}/html_mono/forms.html
+ forms		node	${EMACS}/html_node/forms/
+ #
+ flymake	mono	${EMACS}/html_mono/flymake.html
+ flymake	node	${EMACS}/html_node/flymake/
+ #
+ gnus		mono	${EMACS}/html_mono/gnus.html
+ gnus		node	${EMACS}/html_node/gnus/
+ #
+ htmlfontify	mono	${EMACS}/html_mono/htmlfontify.html
+ htmlfontify	node	${EMACS}/html_node/htmlfontify/
+ #
+ idlwave	mono	${EMACS}/html_mono/idlwave.html
+ idlwave	node	${EMACS}/html_node/idlwave/
+ #
+ ido		mono	${EMACS}/html_mono/ido.html
+ ido		node	${EMACS}/html_node/ido/
+ #
+ info   	mono	${EMACS}/html_mono/info.html
+ info   	node	${EMACS}/html_node/info/
+ #
+ mairix-el	mono	${EMACS}/html_mono/mairix-el.html
+ mairix-el	node	${EMACS}/html_node/mairix-el/
+ #
+ message	mono	${EMACS}/html_mono/message.html
+ message	node	${EMACS}/html_node/message/
+ #
+ mh-e		mono	${EMACS}/html_mono/mh-e.html
+ mh-e		node	${EMACS}/html_node/mh-e/
+ #
+ newsticker	mono	${EMACS}/html_mono/newsticker.html
+ newsticker	node	${EMACS}/html_node/newsticker/
+ #
+ nxml-mode	mono	${EMACS}/html_mono/nxml-mode.html
+ nxml-mode	node	${EMACS}/html_node/nxml-mode/
+ #
+ octave-mode	mono	${EMACS}/html_mono/octave-mode.html
+ octave-mode	node	${EMACS}/html_node/octave-mode/
+ #
+ org		mono	${EMACS}/html_mono/org.html
+ org		node	${EMACS}/html_node/org/
+ #
+ pcl-cvs	mono	${EMACS}/html_mono/pcl-cvs.html
+ pcl-cvs	node	${EMACS}/html_node/pcl-cvs/
+ #
+ pgg		mono	${EMACS}/html_mono/pgg.html
+ pgg		node	${EMACS}/html_node/pgg/
+ #
+ rcirc		mono	${EMACS}/html_mono/rcirc.html
+ rcirc		node	${EMACS}/html_node/rcirc/
+ #
+ reftex		mono	${EMACS}/html_mono/reftex.html
+ reftex		node	${EMACS}/html_node/reftex/
+ #
+ remember	mono	${EMACS}/html_mono/remember.html
+ remember	node	${EMACS}/html_node/remember/
+ #
+ sasl		mono	${EMACS}/html_mono/sasl.html
+ sasl		node	${EMACS}/html_node/sasl/
+ #
+ semantic	mono	${EMACS}/html_mono/semantic.html
+ semantic	node	${EMACS}/html_node/semantic/
+ #
+ bovine		mono	${EMACS}/html_mono/bovine.html
+ bovine		node	${EMACS}/html_node/bovine/
+ #
+ srecode	mono	${EMACS}/html_mono/srecode.html
+ srecode	node	${EMACS}/html_node/srecode/
+ #
+ ses		mono	${EMACS}/html_mono/ses.html
+ ses		node	${EMACS}/html_node/ses/
+ #
+ sieve		mono	${EMACS}/html_mono/sieve.html
+ sieve		node	${EMACS}/html_node/sieve/
+ #
+ smtp		mono	${EMACS}/html_mono/smtpmail.html
+ smtp		node	${EMACS}/html_node/smtpmail/
+ #
+ speedbar	mono	${EMACS}/html_mono/speedbar.html
+ speedbar	node	${EMACS}/html_node/speedbar/
+ #
+ sc		mono	${EMACS}/html_mono/sc.html
+ sc		node	${EMACS}/html_node/sc/
+ #
+ todo-mode	mono	${EMACS}/html_mono/todo-mode.html
+ todo-mode	node	${EMACS}/html_node/todo-mode/
+ #
+ tramp		mono	${EMACS}/html_mono/tramp.html
+ tramp		node	${EMACS}/html_node/tramp/
+ #
+ url		mono	${EMACS}/html_mono/url.html
+ url		node	${EMACS}/html_node/url/
+ #
+ vhdl-mode	mono	${EMACS}/html_mono/vhdl-mode.html
+ vhdl-mode	node	${EMACS}/html_node/vhdl-mode/
+ #
+ vip		mono	${EMACS}/html_mono/vip.html
+ vip		node	${EMACS}/html_node/vip/
+ #
+ viper		mono	${EMACS}/html_mono/viper.html
+ viper		node	${EMACS}/html_node/viper/
+ #
+ widget		mono	${EMACS}/html_mono/widget.html
+ widget		node	${EMACS}/html_node/widget/
+ #
+ wisent		mono	${EMACS}/html_mono/wisent.html
+ wisent		node	${EMACS}/html_node/wisent/
+ #
+ woman		mono	${EMACS}/html_mono/woman.html
+ woman		node	${EMACS}/html_node/woman/
+ # (end emacs manuals in EMACS)
+
+easejs		mono	${GS}/easejs/manual/easejs.html
+easejs		node	${GS}/easejs/manual/
+
+emacs-muse	mono	${GS}/emacs-muse/manual/muse.html
+emacs-muse	node	${GS}/emacs-muse/manual/html_node/
+
+emms		node	${GS}/emms/manual/
+
+ada-mode	mono	https://elpa.gnu.org/packages/ada-mode.html
+
+gpr-mode	mono	https://elpa.gnu.org/packages/doc/gpr-mode.html
+
+findutils	mono	${GS}/findutils/manual/html_mono/find.html
+findutils	node	${GS}/findutils/manual/html_node/find_html
+
+flex		node	https://westes.github.io/flex/manual/
+
+gama		mono	${GS}/gama/manual/gama.html
+gama		node	${GS}/gama/manual/html_node/
+
+GAWK = ${GS}/gawk/manual
+gawk		mono	${GAWK}/gawk.html
+gawk		node	${GAWK}/html_node/
+ gawkinet	mono	${GAWK}/gawkinet/gawkinet.html
+ gawkinet	node	${GAWK}/gawkinet/html_node/
+
+gcal		mono	${GS}/gcal/manual/gcal.html
+gcal		node	${GS}/gcal/manual/html_node/
+
+GCC = https://gcc.gnu.org/onlinedocs
+gcc		node	${GCC}/gcc/
+ cpp		node	${GCC}/cpp/
+ gfortran	node	${GCC}/gfortran/
+ gnat_rm	node	${GCC}/gnat_rm/
+ gnat_ugn	node	${GCC}/gnat_ugn/
+ libgomp	node	${GCC}/libgomp/
+ libstdc++	node	${GCC}/libstdc++/
+ #
+ gccint		node	${GCC}/gccint/
+ cppinternals	node	${GCC}/cppinternals/
+ gfc-internals	node	${GCC}/gfc-internals/
+ gnat-style	node	${GCC}/gnat-style/
+ libiberty	node	${GCC}/libiberty/
+
+GDB = https://sourceware.org/gdb/current/onlinedocs
+gdb		node	${GDB}/gdb.html/
+ stabs		node	${GDB}/stabs.html/
+
+GDBM = http://www.gnu.org.ua/software/gdbm/manual
+gdbm		node	${GDBM}/
+
+gettext		mono	${GS}/gettext/manual/gettext.html
+gettext		node	${GS}/gettext/manual/html_node/
+
+gforth		node	https://www.complang.tuwien.ac.at/forth/gforth/Docs-html/
+
+global		mono	${GS}/global/manual/global.html
+
+gmediaserver	node	${GS}/gmediaserver/manual/
+
+gmp		node	https://www.gmplib.org/manual/
+
+gnu-arch	node	${GS}/gnu-arch/tutorial/
+
+gnu-c-manual	mono	${GS}/gnu-c-manual/gnu-c-manual.html
+
+gnu-crypto	node	${GS}/gnu-crypto/manual/
+
+gnubg		mono	${GS}/gnubg/manual/gnubg.html
+gnubg		node	${GS}/gnubg/manual/html_node/
+
+GNUCOBOL = https://gnucobol.sourceforge.io/HTML
+gnucobpg	mono	${GNUCOBOL}/gnucobpg.html
+ gnucobqr	mono	${GNUCOBOL}/gnucobqr.html
+ gnucobsp	mono	${GNUCOBOL}/gnucobsp.html
+
+gnubik		mono	${GS}/gnubik/manual/gnubik.html
+gnubik		node	${GS}/gnubik/manual/html_node/
+
+gnulib		mono	${GS}/gnulib/manual/gnulib.html
+gnulib		node	${GS}/gnulib/manual/html_node/
+
+GNUN = ${GS}/trans-coord/manual
+gnun		mono	${GNUN}/gnun/gnun.html
+gnun		node	${GNUN}/gnun/html_node/
+ web-trans	mono	${GNUN}/web-trans/web-trans.html
+ web-trans	node	${GNUN}/web-trans/html_node/
+
+GNUPG = https://www.gnupg.org/documentation/manuals
+gnupg		node	${GNUPG}/gnupg/
+ dirmngr	node	${GNUPG}/dirmngr/
+ gcrypt		node	${GNUPG}/gcrypt/
+ libgcrypt	node	${GNUPG}/gcrypt/
+ ksba		node	${GNUPG}/ksba/
+ assuan		node	${GNUPG}/assuan/
+ gpgme		node	${GNUPG}/gpgme/
+
+gnuprologjava	node	${GS}/gnuprologjava/manual/
+
+gnuschool	mono	${GS}/gnuschool/gnuschool.html
+
+GNUSTANDARDS = ${G}/prep
+ maintain	mono	${GNUSTANDARDS}/maintain/maintain.html
+ maintain	node	${GNUSTANDARDS}/maintain/html_node/
+ #
+ standards	mono	${GNUSTANDARDS}/standards/standards.html
+ standards	node	${GNUSTANDARDS}/standards/html_node/
+
+# following url is a redirect, which cannot be used for links within the manual
+#gnutls		mono	${GS}/gnutls/manual/gnutls.html
+# empty directory
+#gnutls		node	${GS}/gnutls/manual/html_node/
+GNUTLS = http://www.gnutls.org/manual
+gnutls		mono	${GNUTLS}/gnutls.html
+gnutls		node	${GNUTLS}/html_node/
+
+gperf		mono	${GS}/gperf/manual/gperf.html
+gperf		node	${GS}/gperf/manual/html_node/
+
+grep		mono	${GS}/grep/manual/grep.html
+grep		node	${GS}/grep/manual/html_node/
+
+groff		node	${GS}/groff/manual/html_node/
+
+GRUB = ${GS}/grub/manual/
+  grub		mono	${GRUB}/grub/grub.html
+  grub		node	${GRUB}/grub/html_node/
+  #
+  multiboot	mono	${GRUB}/multiboot/multiboot.html
+  multiboot	node	${GRUB}/multiboot/html_node/
+  #
+  grub-dev	mono	${GRUB}/grub-dev/grub-dev.html
+  grub-dev	node	${GRUB}/grub-dev/html_node/
+
+gsasl		mono	${GS}/gsasl/manual/gsasl.html
+gsasl		node	${GS}/gsasl/manual/html_node/
+
+gsl		node	${GS}/gsl/manual/html_node/
+
+gsrc		mono	${GS}/gsrc/manual/gsrc.html
+gsrc		node	${GS}/gsrc/manual/html_node/
+
+gss		mono	${GS}/gss/manual/gss.html
+gss		node	${GS}/gss/manual/html_node/
+
+gtypist		mono	${GS}/gtypist/doc/gtypist.html
+
+guile		mono	${GS}/guile/manual/guile.html
+guile		node	${GS}/guile/manual/html_node/
+
+GUILE_GNOME = ${GS}/guile-gnome/docs
+ gobject 	node	${GUILE_GNOME}/gobject/html/
+ glib		node	${GUILE_GNOME}/glib/html/
+ atk		node	${GUILE_GNOME}/atk/html/
+ pango		node	${GUILE_GNOME}/pango/html/
+ pangocairo	node	${GUILE_GNOME}/pangocairo/html/
+ gdk		node	${GUILE_GNOME}/gdk/html/
+ gtk		node	${GUILE_GNOME}/gtk/html/
+ libglade	node	${GUILE_GNOME}/libglade/html/
+ gnome-vfs	node	${GUILE_GNOME}/gnome-vfs/html/
+ libgnomecanvas	node	${GUILE_GNOME}/libgnomecanvas/html/
+ gconf		node	${GUILE_GNOME}/gconf/html/
+ libgnome	node	${GUILE_GNOME}/libgnome/html/
+ libgnomeui	node	${GUILE_GNOME}/libgnomeui/html/
+ corba		node	${GUILE_GNOME}/corba/html/
+ clutter	node	${GUILE_GNOME}/clutter/html/
+ clutter-glx	node	${GUILE_GNOME}/clutter-glx/html/
+
+guile-gtk	node	${GS}/guile-gtk/docs/guile-gtk/
+
+guile-rpc	mono	${GS}/guile-rpc/manual/guile-rpc.html
+guile-rpc	node	${GS}/guile-rpc/manual/html_node/
+
+guix		mono	${GS}/guix/manual/guix.html
+guix		node	${GS}/guix/manual/html_node/
+
+gv		mono	${GS}/gv/manual/gv.html
+gv		node	${GS}/gv/manual/html_node/
+
+gzip		mono	${GS}/gzip/manual/gzip.html
+gzip		node	${GS}/gzip/manual/html_node/
+
+hello		mono	${GS}/hello/manual/hello.html
+hello		node	${GS}/hello/manual/html_node/
+
+help2man	mono	${GS}/help2man/help2man.html
+
+idutils		mono	${GS}/idutils/manual/idutils.html
+idutils		node	${GS}/idutils/manual/html_node/
+
+inetutils	mono	${GS}/inetutils/manual/inetutils.html
+inetutils	node	${GS}/inetutils/manual/html_node/
+
+# No manual, redirects to git sources
+#jwhois		mono	${GS}/jwhois/manual/jwhois.html
+# 404 Not Found
+#jwhois		node	${GS}/jwhois/manual/html_node/
+
+libc		mono	${GS}/libc/manual/html_mono/libc.html
+libc		node	${GS}/libc/manual/html_node/
+
+LIBCDIO = ${GS}/libcdio
+ libcdio	mono	${LIBCDIO}/libcdio.html
+ cd-text	mono	${LIBCDIO}/cd-text-format.html
+
+libextractor	mono	${GS}/libextractor/manual/libextractor.html
+libextractor	node	${GS}/libextractor/manual/html_node/
+
+libidn		mono	${GS}/libidn/manual/libidn.html
+libidn		node	${GS}/libidn/manual/html_node/
+
+libidn2		mono	${GS}/libidn/libidn2/manual/libidn2.html
+libidn2		node	${GS}/libidn/libidn2/manual/html_node/
+
+librejs		mono	${GS}/librejs/manual/librejs.html
+librejs		node	${GS}/librejs/manual/html_node/
+
+libmatheval	mono	${GS}/libmatheval/manual/libmatheval.html
+
+LIBMICROHTTPD = ${GS}/libmicrohttpd
+libmicrohttpd		mono	${LIBMICROHTTPD}/manual/libmicrohttpd.html
+libmicrohttpd		node	${LIBMICROHTTPD}/manual/html_node/
+ # The manual name is based on the Texinfo file name in the code,
+ # not on the file name for the tutorial which is too generic.
+ microhttpd-tutorial	mono	${LIBMICROHTTPD}/tutorial.html
+
+libtasn1	mono	${GS}/libtasn1/manual/libtasn1.html
+libtasn1	node	${GS}/libtasn1/manual/html_node/
+
+libtool		mono	${GS}/libtool/manual/libtool.html
+libtool		node	${GS}/libtool/manual/html_node/
+
+lightning	mono	${GS}/lightning/manual/lightning.html
+lightning	node	${GS}/lightning/manual/html_node/
+
+# The stable/ url redirects immediately, but that's ok.
+# The .html extension is omitted on their web site, but it works if given.
+LILYPOND = http://lilypond.org/doc/stable/Documentation
+ lilypond-internals	node ${LILYPOND}/internals/
+ lilypond-learning	node ${LILYPOND}/learning/
+ lilypond-notation 	node ${LILYPOND}/notation/
+ lilypond-snippets 	node ${LILYPOND}/snippets/
+ lilypond-usage		node ${LILYPOND}/usage/
+ lilypond-web		node ${LILYPOND}/web/
+ music-glossary		node ${LILYPOND}/music-glossary/
+
+liquidwar6	mono	${GS}/liquidwar6/manual/liquidwar6.html
+liquidwar6	node	${GS}/liquidwar6/manual/html_node/
+
+lispintro	mono	${GS}/emacs/emacs-lisp-intro/html_mono/emacs-lisp-intro.html
+lispintro	node	${GS}/emacs/emacs-lisp-intro/html_node/index.html
+
+LSH = http://www.lysator.liu.se/~nisse/lsh
+  lsh		mono	${LSH}/lsh.html
+
+m4		mono	${GS}/m4/manual/m4.html
+m4		node	${GS}/m4/manual/html_node/
+
+MITGNUSCHEME = ${GS}/mit-scheme/documentation/stable
+mit-scheme-user	mono	${MITGNUSCHEME}/mit-scheme-user.html
+mit-scheme-user	node	${MITGNUSCHEME}/mit-scheme-user/
+ #
+ mit-scheme-ref	mono	${MITGNUSCHEME}/mit-scheme-ref.html
+ mit-scheme-ref	node	${MITGNUSCHEME}/mit-scheme-ref/
+ #
+ mit-scheme-ffi	mono	${MITGNUSCHEME}/mit-scheme-ffi.html
+ mit-scheme-ffi	node	${MITGNUSCHEME}/mit-scheme-ffi/
+ #
+ mit-scheme-sos	mono	${MITGNUSCHEME}/mit-scheme-sos.html
+ mit-scheme-sos	node	${MITGNUSCHEME}/mit-scheme-sos/
+ #
+ mit-scheme-imail	mono	${MITGNUSCHEME}/mit-scheme-imail.html
+ #
+ mit-scheme-blowfish	mono	${MITGNUSCHEME}/mit-scheme-blowfish.html
+ #
+ mit-scheme-gdbm	mono	${MITGNUSCHEME}/mit-scheme-gdbm.html
+
+mailutils	mono	${GS}/mailutils/manual/mailutils.html
+mailutils	chapter	${GS}/mailutils/manual/html_chapter/
+mailutils	section	${GS}/mailutils/manual/html_section/
+mailutils	node	${GS}/mailutils/manual/html_node/
+
+make		mono	${GS}/make/manual/make.html
+make		node	${GS}/make/manual/html_node/
+
+mdk		mono	${GS}/mdk/manual/mdk.html
+mdk		node	${GS}/mdk/manual/html_node/
+
+METAEXCHANGE = https://ftp.gwdg.de/pub/gnu2/iwfmdh/doc/texinfo
+ iwf_mh		node	${METAEXCHANGE}/iwf_mh.html
+ scantest	node	${METAEXCHANGE}/scantest.html
+
+MIT_SCHEME = ${GS}/mit-scheme/documentation/stable
+ mit-scheme-ref	  node	${MIT_SCHEME}/mit-scheme-ref/
+ mit-scheme-user  node	${MIT_SCHEME}/mit-scheme-user/
+ sos		  node	${MIT_SCHEME}/mit-scheme-sos/
+ mit-scheme-imail mono	${MIT_SCHEME}/mit-scheme-imail.html
+
+moe		mono	${GS}/moe/manual/moe_manual.html
+
+motti		node	${GS}/motti/manual/
+
+# only PDF is available as documentation to download
+#mpc		node	http://www.multiprecision.org/index.php?prog=mpc&page=html
+
+mpfr		mono	https://www.mpfr.org/mpfr-current/mpfr.html
+
+mtools		mono	${GS}/mtools/manual/mtools.html
+
+nano		mono	https://www.nano-editor.org/dist/latest/nano.html
+
+nettle		mono	https://www.lysator.liu.se/~nisse/nettle/nettle.html
+
+ocrad		mono	${GS}/ocrad/manual/ocrad_manual.html
+
+parted		mono	${GS}/parted/manual/parted.html
+parted		node	${GS}/parted/manual/html_node/
+
+pascal		node	https://www.gnu-pascal.de/gpc/
+
+# can't use pcb since url's contain dates --30nov10
+
+PIES = http://www.gnu.org.ua/software/pies/manual
+pies		node	${PIES}/
+
+plotutils	mono	${GS}/plotutils/manual/en/plotutils.html
+plotutils	node	${GS}/plotutils/manual/en/html_node/
+
+proxyknife	mono	${GS}/proxyknife/manual/proxyknife.html
+proxyknife	node	${GS}/proxyknife/manual/html_node/
+
+pspp		mono	${GS}/pspp/manual/pspp.html
+pspp		node	${GS}/pspp/manual/html_node/
+
+pyconfigure	mono	${GS}/pyconfigure/manual/pyconfigure.html
+pyconfigure	node	${GS}/pyconfigure/manual/html_node/
+
+R = https://cran.r-project.org/doc/manuals
+ R-intro	mono	${R}/R-intro.html
+ R-lang		mono	${R}/R-lang.html
+ R-exts		mono	${R}/R-exts.html
+ R-data		mono	${R}/R-data.html
+ R-admin	mono	${R}/R-admin.html
+ R-ints		mono	${R}/R-ints.html
+
+rcs		mono	${GS}/rcs/manual/rcs.html
+rcs		node	${GS}/rcs/manual/html_node/
+
+READLINE = https://tiswww.cwru.edu/php/chet/readline
+readline	mono	${READLINE}/readline.html
+ rluserman	mono	${READLINE}/rluserman.html
+ history	mono	${READLINE}/history.html
+
+# no manual for Recode found.  Most recent fork seems to be at
+# https://github.com/rrthomas/recode/
+
+recutils	mono	${GS}/recutils/manual/recutils.html
+recutils	node	${GS}/recutils/manual/html_node/
+
+remotecontrol	mono	${GS}/remotecontrol/manual/remotecontrol.html
+remotecontrol	node	${GS}/remotecontrol/manual/html_node/
+
+rottlog		mono	${GS}/rottlog/manual/rottlog.html
+rottlog		node	${GS}/rottlog/manual/html_node/
+
+RUSH = http://www.gnu.org.ua/software/rush/manual
+rush		mono	${RUSH}/rush.html
+rush 		chapter	${RUSH}/html_chapter/
+rush 		section	${RUSH}/html_section/
+rush		node	${RUSH}/html_node/
+
+screen		mono	${GS}/screen/manual/screen.html
+screen		node	${GS}/screen/manual/html_node/
+
+sed		mono	${GS}/sed/manual/sed.html
+sed		node	${GS}/sed/manual/html_node/
+
+sharutils	mono	${GS}/sharutils/manual/sharutils.html
+sharutils	chapter	${GS}/sharutils/manual/html_chapter/
+sharutils	node	${GS}/sharutils/manual/html_node/
+
+# replaces dmd
+shepherd	mono	${GS}/shepherd/manual/shepherd.html
+shepherd	node	${GS}/shepherd/manual/html_node/
+
+SMALLTALK = ${GS}/smalltalk
+gst		mono	${SMALLTALK}/manual/gst.html
+gst		node	${SMALLTALK}/manual/html_node/
+ #
+ gst-base	mono	${SMALLTALK}/manual-base/gst-base.html
+ gst-base	node	${SMALLTALK}/manual-base/html_node/
+ #
+ gst-libs	mono	${SMALLTALK}/manual-libs/gst-libs.html
+ gst-libs	node	${SMALLTALK}/manual-libs/html_node/
+
+sourceinstall	mono	${GS}/sourceinstall/manual/sourceinstall.html
+sourceinstall	node	${GS}/sourceinstall/manual/html_node/
+
+sqltutor	mono	${GS}/sqltutor/manual/sqltutor.html
+sqltutor	node	${GS}/sqltutor/manual/html_node/
+
+src-highlite	mono	${GS}/src-highlite/source-highlight.html
+
+swbis		mono	${GS}/swbis/manual.html
+
+tar		mono	${GS}/tar/manual/tar.html
+tar		chapter	${GS}/tar/manual/html_chapter/
+tar		section	${GS}/tar/manual/html_section/
+tar		node	${GS}/tar/manual/html_node/
+
+teseq		mono	${GS}/teseq/manual/teseq.html
+teseq		node	${GS}/teseq/manual/html_node/
+
+TEXINFO = ${GS}/texinfo/manual
+texinfo		mono	${TEXINFO}/texinfo/texinfo.html
+texinfo		node	${TEXINFO}/texinfo/html_node/
+ #
+ info-stnd	mono	${TEXINFO}/info-stnd/info-stnd.html
+ info-stnd	node	${TEXINFO}/info-stnd/html_node/
+ #
+ texi2any_api	mono	${TEXINFO}/texi2any_api/texi2any_api.html
+ texi2any_api	node	${TEXINFO}/texi2any_api/html_node/
+ #
+ texi2any_internals	mono	${TEXINFO}/texi2any_internals/texi2any_internals.html
+ texi2any_internals	chapter	${TEXINFO}/texi2any_internals/html_chapter/
+
+thales		node	${GS}/thales/manual/
+
+units		mono	${GS}/units/manual/units.html
+units		node	${GS}/units/manual/html_node/
+
+vc-dwim		mono	${GS}/vc-dwim/manual/vc-dwim.html
+vc-dwim		node	${GS}/vc-dwim/manual/html_node/
+
+wdiff		mono	${GS}/wdiff/manual/wdiff.html
+wdiff		node	${GS}/wdiff/manual/html_node/
+
+websocket4j	mono	${GS}/websocket4j/manual/websocket4j.html
+websocket4j	node	${GS}/websocket4j/manual/html_node/
+
+wget		mono	${GS}/wget/manual/wget.html
+wget		node	${GS}/wget/manual/html_node/
+
+xboard		mono	${GS}/xboard/manual/xboard.html
+xboard		node	${GS}/xboard/manual/html_node/
+
+# emacs-page
+# Free TeX-related Texinfo manuals on tug.org.
+
+T = https://tug.org/texinfohtml
+
+dvipng		mono	${T}/dvipng.html
+dvips		mono	${T}/dvips.html
+eplain		mono	${T}/eplain.html
+kpathsea	mono	${T}/kpathsea.html
+latex2e		mono	${T}/latex2e.html
+tlbuild		mono	${T}/tlbuild.html
+web2c		mono	${T}/web2c.html
+
+
+# Local Variables:
+# eval: (add-hook 'write-file-hooks 'time-stamp)
+# time-stamp-start: "htmlxrefversion="
+# time-stamp-format: "%:y-%02m-%02d.%02H"
+# time-stamp-time-zone: "UTC"
+# time-stamp-end: "; # UTC"
+# End:

mu4e/mu4e.texi

@@ -55,9 +55,9 @@ Documentation License.''
 Welcome to @t{mu4e}!
 
 @t{mu4e} (@t{mu}-for-emacs) is an e-mail client for GNU Emacs version 26.3 or
-newer, built on top of the
+newer, built on top of the @uref{https://www.djcbsoftware.nl/code/mu,mu} e-mail
-@t{mu}@footnote{@url{https://www.djcbsoftware.nl/code/mu}} e-mail search engine.
+search engine. @t{mu4e} is optimized for quickly processing large amounts of
-@t{mu4e} is optimized for quickly processing large amounts of e-mail.
+e-mail.
 
 Some of its highlights:
 @itemize
@@ -141,16 +141,14 @@ basis.
 @node Other mail clients
 @section Other mail clients
 
-Under the hood, @t{mu4e} is fully search-based, similar to programs
+Under the hood, @t{mu4e} is fully search-based, similar to programs like
-like @t{notmuch}@footnote{@url{https://notmuchmail.org/}} and
+@uref{https://notmuchmail.org/,notmuch} and
-@t{sup}@footnote{@url{https://sup-heliotrope.github.io/}}.
+@uref{https://sup-heliotrope.github.io/,sup}.
 
-However, @t{mu4e}'s user-interface is quite different. @t{mu4e}'s mail
+However, @t{mu4e}'s user-interface is quite different. @t{mu4e}'s mail handling
-handling (deleting, moving, etc.)@: is inspired by
+(deleting, moving, etc.)@: is inspired by
-Wanderlust@footnote{@url{http://www.gohome.org/wl/}} (another
+@uref{http://www.gohome.org/wl/,Wanderlust} (another Emacs-based e-mail client),
-Emacs-based e-mail client),
+@uref{http://www.mutt.org/,mutt} and the @t{dired} file-manager for emacs.
-@t{mutt}@footnote{@url{http://www.mutt.org/}} and the @t{dired}
-file-manager for emacs.
 
 @t{mu4e} keeps all the `state' in your maildirs, so you can easily
 switch between clients, synchronize over @abbr{IMAP}, backup with
@@ -164,14 +162,14 @@ information.
 There are a number of things that @t{mu4e} does @b{not} do, by design:
 @itemize
 @item @t{mu}/@t{mu4e} do @emph{not} get your e-mail messages from
-a mail server. Nor does it sync-back any changes. Those tasks are
+a mail server. Nor does it sync-back any changes. Those tasks are delegated to
-delegated to other tools, such as
+other tools, such as @uref{https://www.offlineimap.org/,offlineimap},
-@t{offlineimap}@footnote{@url{https://www.offlineimap.org/}},
+@uref{http://isync.sourceforge.net/,mbsync} or
-@t{isync/mbsync}@footnote{@url{http://isync.sourceforge.net/}} or
+@uref{http://www.fetchmail.info/,fetchmail}; As long as the messages end up in a
-@t{fetchmail}@footnote{@url{http://www.fetchmail.info/}}; As long as
+maildir, @t{mu4e} and @t{mu} are happy to deal with them.
-the messages end up in a maildir, @t{mu4e} and @t{mu} are happy to
+@item @t{mu4e} also does @emph{not} implement sending of messages; instead, it depends on
-deal with them.
+@ref{(smtpmail) Top}, which is part of Emacs. In addition, @t{mu4e} piggybacks on
-@item @t{mu4e} also does @emph{not} implement sending of messages; instead, it depends on @t{smtpmail} (@ref{Top,,smtpmail}), which is part of Emacs. In addition, @t{mu4e} piggybacks on Gnus' message editor.
+Gnus' message editor.
 @end itemize
 
 Thus, many of the things an e-mail client traditionally needs to do, are
@@ -189,18 +187,15 @@ about programming or elisp shouldn't be required. The idea is to provide
 sensible defaults, and allow for customization.
 
 When you take @t{mu4e} into use, it's a good idea to subscribe to the
-@t{mu}/@t{mu4e}-mailing
+@uref{https://groups.google.com/group/mu-discuss,mu/mu4e mailing list}.
-list@footnote{@url{https://groups.google.com/group/mu-discuss}}.
 
-Sometimes, you might encounter some unexpected behavior while using
+Sometimes, you might encounter some unexpected behavior while using @t{mu4e}, or
-@t{mu4e}. It could be a bug in @t{mu4e}, it could be an issue in other
+have some idea on how it could work better. To report this, you can use the
-software. Or it could just be a misunderstanding. In any case, if you
+@uref{https://github.com/djcb/mu/issues,bug-tracker}. Please always include the
-want to report this (either to the mailing list or to
+following information:
-@url{https://github.com/djcb/mu/issues}, the latter is preferred),
-please always include the following information:
 
 @itemize
-@item what did you expect that should happen? what actually happened?
+@item what did you expect or wish to happen? what actually happened?
 @item can you provide some exact steps to reproduce?
 @item what version of @t{mu4e} and @t{emacs} were you using? What operating system?
 @item can you reproduce it with @command{emacs -q} and only loading @t{mu4e}?
@@ -210,10 +205,9 @@ please always include the following information:
 @node Getting started
 @chapter Getting started
 
-In this chapter, we go through the installation of @t{mu4e} and its
+In this chapter, we go through the installation of @t{mu4e} and its basic setup.
-basic setup. After we have succeeded in @ref{Getting mail}, and
+After we have succeeded in @ref{Getting mail}, and @pxref{Indexing your
-@pxref{Indexing your messages}, we discuss the @ref{Basic
+messages}, we discuss the @ref{Basic configuration}.
-configuration}.
 
 After these steps, @t{mu4e} should be ready to go!
 
@@ -237,8 +231,8 @@ After these steps, @t{mu4e} should be ready to go!
 
 @t{mu}/@t{mu4e} are known to work on a wide variety of Unix- and Unix-like
 systems, including many Linux distributions, OS X and FreeBSD. Emacs 26.3 or
-higher is required, as well as Xapian@footnote{@url{https://xapian.org/}} and
+higher is required, as well as @uref{https://xapian.org/,Xapian} and
-GMime@footnote{@url{http://spruce.sourceforge.net/gmime/}}.
+@uref{http://spruce.sourceforge.net/gmime/,GMime}.
 
 @t{mu} has optional support for the Guile (Scheme) programming language (version
 3.0 or higher). There are also some GUI-toys, which require GTK+ 3.x and Webkit.
@@ -342,12 +336,11 @@ go through things step-by-step.
 @node Getting mail
 @section Getting mail
 
-In order for @t{mu} (and, by extension, @t{mu4e}) to work, you need to
+In order for @t{mu} (and, by extension, @t{mu4e}) to work, you need to have your
-have your e-mail messages stored in a
+e-mail messages stored in a
-@emph{maildir}@footnote{@url{https://en.wikipedia.org/wiki/Maildir};
+@uref{https://en.wikipedia.org/wiki/Maildir, Maildir}; in this manual we use the
-in this manual we use the term `maildir' for both the standard and the
+term `maildir' for both the standard and the hierarchy of maildirs that store
-hierarchy of maildirs that store your messages} --- a specific
+your messages --- a specific directory structure with one-file-per-message.
-directory structure with one-file-per-message.
 
 If you are already using a maildir, you are lucky. If not, some setup
 is required:
@@ -595,15 +588,14 @@ updates --- for example when receiving new mail. See
 @node Sending mail
 @section Sending mail
 
-@t{mu4e} re-uses Gnus' @code{message-mode} (@ref{Top,,message}) for
+@t{mu4e} uses Emacs's @ref{(message) Top,,message-mode} for writing mail.
-writing mail and inherits the setup for sending mail as well.
 
-For sending mail using @abbr{SMTP}, @t{mu4e} uses @t{smtpmail}
+For sending mail using @abbr{SMTP}, @t{mu4e} uses @ref{(smtpmail)
-(@ref{Top,,smtpmail}). This package supports many different ways to
+Top,,smtpmail}. This package supports many different ways to send mail; please
-send mail; please refer to its documentation for the details.
+refer to its documentation for the details.
 
-Here, we only provide some simple examples --- for more, see
+Here, we only provide some simple examples --- for more, see @ref{Example
-@ref{Example configurations}.
+configurations}.
 
 A very minimal setup:
 
@@ -953,9 +945,9 @@ F=@emph{flagged} (i.e., `starred'), N=@emph{new}, P=@emph{passed} (i.e.,
 forwarded), R=@emph{replied}, S=@emph{seen}, T=@emph{trashed},
 a=@emph{has-attachment}, x=@emph{encrypted}, s=@emph{signed},
 u=@emph{unread}. The tooltip for this field also contains this information.
-@item The subject field also indicates the discussion threads @footnote{using
+@item The subject field also indicates the discussion threads, following
-Jamie Zawinski's mail threading algorithm,
+@uref{https://www.jwz.org/doc/threading.html,Jamie Zawinski's mail threading
-@url{https://www.jwz.org/doc/threading.html}}.
+algorithm}.
 @item The headers view is @emph{automatically updated} if any changes are
 found during the indexing process, and if there is no current
 user-interaction. If you do not want such automatic updates, set
@@ -1784,16 +1776,16 @@ mu4e}.
 @node Signing and encrypting
 @section Signing and encrypting
 
-Signing and encrypting of messages is possible using @t{emacs-mime},
+Signing and encrypting of messages is possible using @ref{(emacs-mime) Top,
-most easily accessed through the @t{Attachments}-menu while composing a
+emacs-mime}, most easily accessed through the @t{Attachments}-menu while
-message, or with @kbd{M-x mml-secure-message-encrypt-pgp}, @kbd{M-x
+composing a message, or with @kbd{M-x mml-secure-message-encrypt-pgp}, @kbd{M-x
 mml-secure-message-sign-pgp}.
 
-Important note: the messages are encrypted when they are @emph{sent}:
+Important note: the messages are encrypted when they are @emph{sent}: this means
-this means that draft messages are @emph{not} encrypted. So if you are
+that draft messages are @emph{not} encrypted. So if you are using e.g.
-using e.g. @t{offlineimap} or @t{mbsync} to synchronize with some
+@t{offlineimap} or @t{mbsync} to synchronize with some remote IMAP-service, make
-remote IMAP-service, make sure the drafts folder is @emph{not} in the
+sure the drafts folder is @emph{not} in the set of synchronized folders, for
-set of synchronized folders, for obvious reasons.
+obvious reasons.
 
 @node Queuing mail
 @section Queuing mail
@@ -3167,7 +3159,9 @@ ways. Here we focus on Emacs built-ins; for dealing with external tools,
 
 Emacs allows you to select an e-mail program as the default program it uses when
 you press @key{C-x m} (@code{compose-mail}), call @code{report-emacs-bug} and so
-on. If you want to use @t{mu4e} for this, you can do so by adding the following
+on; see @ref{(emacs) Mail Methods}.
+
+If you want to use @t{mu4e} for this, you can do so by adding the following
 to your configuration:
 
 @lisp
@@ -3181,8 +3175,6 @@ mail, customize the variable @code{read-mail-command}.
 (set-variable 'read-mail-command 'mu4e)
 @end lisp
 
-(@pxref{Top,,Emacs,Sending Mail, Mail Methods})
-
 @node Modeline
 @section Modeline
 @cindex modeline
@@ -3265,8 +3257,8 @@ used for the @xref{Bookmarks and Maildirs}, in the main view and the
 ``baseline'', as discussed earlier.
 
 For now, notifications are implemented for desktop environments that support
-DBus-based notifications, as per Emacs' notification sub-system
+DBus-based notifications, as per Emacs' notification sub-system @xref{(elisp)
-@xref{Desktop Notifications,,,elisp,GNU Emacs Lisp Reference Manual}.
+Desktop Notifications}.
 
 You can enable mu4e's desktop notifications (provided that you are on a
 supported system) by setting @code{mu4e-notification-support} to @t{t}. If you
@@ -3498,9 +3490,9 @@ with other tools.
 @section Org-contacts
 
 Note, @t{mu4e} supports built-in address autocompletion; @ref{Address
-autocompletion}, and that is the recommended way to do this. However, it
+autocompletion}, and that is the recommended way to do this. However, it is also
-is also possible to manage your addresses with @t{org-mode}, using
+possible to manage your addresses with @t{org-mode}, using
-@t{org-contacts}@footnote{@url{https://julien.danjou.info/projects/emacs-packages#org-contacts}}.
+@uref{https://julien.danjou.info/projects/emacs-packages#org-contacts,org-contacts}.
 
 @t{mu4e-actions} defines a useful action (@ref{Actions}) for adding a
 contact based on the @t{From:}-address in the message at point. To
@@ -3524,10 +3516,9 @@ Note, the shortcut character @key{o} is due to the first character of
 @section BBDB
 
 Note, @t{mu4e} supports built-in address autocompletion; @ref{Address
-autocompletion}, and that is the recommended way to do this. However, it
+autocompletion}, and that is the recommended way to do this. However, it is also
-is also possible to manage your addresses with the current (2015-06-23)
+possible to manage your addresses with
-development release of @t{BBDB}, or releases of @t{BBDB} after
+@uref{https://savannah.nongnu.org/projects/bbdb/,BBDB}.
-3.1.2.@footnote{@url{https://savannah.nongnu.org/projects/bbdb/}}.
 
 To enable BBDB, add to your @file{~/.emacs} (or its moral equivalent,
 such as @file{~/.emacs.d/init.el}) the following @emph{after} the
@@ -3562,12 +3553,9 @@ After this, you should be able to:
 @node Sauron
 @section Sauron
 
-The Emacs package @t{sauron}@footnote{Sauron can be found at
+The Emacs package @uref{https://github.com/djcb/sauron,sauron} (by the same
-@url{https://github.com/djcb/sauron}, or in the MELPA (Milkypostman’s
+author) can be used to get notifications about new mails. If you run something
-Emacs Lisp Package Archive) package repository at
+like the below script from your @t{crontab} (or have some other way of having it
-@url{https://melpa.org/}} (by the same author) can be used to
-get notifications about new mails. If you run something like the below
-script from your @t{crontab} (or have some other way of having it
 execute every @emph{n} minutes), you receive notifications in the
 @t{sauron}-buffer when new messages arrive.
 
@@ -3620,9 +3608,9 @@ running outside its session.
 @node Hydra
 @section Hydra
 
-People sometimes ask about having multi-character shortcuts for
+People sometimes ask about having multi-character shortcuts for bookmarks; an
-bookmarks; an easy way to achieve this, is by using an emacs package
+easy way to achieve this, is by using an emacs package
-called Hydra@footnote{@url{https://github.com/abo-abo/hydra}}.
+@uref{https://github.com/abo-abo/hydra,Hydra}.
 
 With Hydra installed, we can add multi-character shortcuts, for instance:
 @lisp
@@ -4120,9 +4108,9 @@ help with this - you can set the variable
 names, while @command{mu} expects UTF-8 (so, e.g. @t{/まりもえ
 お}@footnote{some Japanese characters} becomes @t{/&MH4wijCCMEgwSg-}).
 
-This is best solved by telling @command{offlineimap} to use UTF-8
+This is best solved by telling @command{offlineimap} to use UTF-8 instead ---
-instead --- see
+see @uref{https://github.com/djcb/mu/issues/68#issuecomment-8598652,this
-@url{https://github.com/djcb/mu/issues/68#issuecomment-8598652}.
+ticket}.
 
 @subsection @command{mbsync} or @command{offlineimap} do not sync properly
 Unfortunately, @command{mbsync} and/or @command{offlineimap} do not
@@ -4216,13 +4204,12 @@ your configuration (courtesy of user @t{kpachnis}):
       mml2015-sign-with-sender t)
 @end lisp
 @subsection Can I `bounce' or `resend' messages?
-Somewhat --- it is possible to edit a (copy of) an existing message and
+Somewhat --- it is possible to edit a (copy of) an existing message and then
-then send it, using @code{M-x mu4e-compose-resend}. This gives you a
+send it, using @code{M-x mu4e-compose-resend}. This gives you a raw copy of the
-raw copy of the message, including all headers, encoded parts and so
+message, including all headers, encoded parts and so on. Reason for this is that
-on. Reason for this is that for resending, it is important not to
+for resending, it is important not to change anything (except perhaps for the
-change anything (except perhaps for the @t{To:} address when
+@t{To:} address when bouncing); since we cannot losslessly decode an existing
-bouncing); since we cannot losslessly decode an existing message, you
+message, you get the raw version.
-get the raw version.
 
 @node Writing messages
 @section Writing messages
@@ -4246,22 +4233,22 @@ See @ref{(emacs) Mail Aliases}.
 See @ref{Compose hooks}.
 
 @subsection How can I influence the way the original message looks when replying/forwarding?
-Since @code{mu4e-compose-mode} derives from @code{message-mode}, you can
+Since @code{mu4e-compose-mode} derives from @xref{(message) Top}, you can re-use
-re-use many of its facilities.
+many of its facilities.
 
 @subsection How can I easily include attachments in the messages I write?
-You can drag-and-drop from your desktop; alternatively, you can use
+You can drag-and-drop from your desktop; alternatively, you can use @ref{(emacs)
-@t{dired} --- see @ref{Dired}.
+Dired}.
 
 @subsection @t{mu4e} seems to remove myself from the @t{Cc:}-list; how can I prevent that?
 Set @code{mu4e-compose-keep-self-cc} to @t{t} in your configuration.
 
-@subsection @t{mu4e} include myself from the @t{Cc:}-list; how can I prevent that?
+@subsection @t{mu4e} includes myself from the @t{Cc:}-list; how can I prevent that?
 You need list your personal addresses by passing one or more
 @t{--my-address=...} to @t{mu init}. Note that the
-@code{mu4e-user-mail-address-list} which was used in older @t{mu4e}
+@code{mu4e-user-mail-address-list} which was used in older @t{mu4e} versions is
-versions is no longer used. Also see the entries for version 1.4 in
+no longer used. Also see the entries for version 1.4 in @t{NEWS.org} (@kbd{N})
-@t{NEWS.org} (@kbd{N}) in the main-menu.
+in the main-menu.
 
 @subsection How can I start a new message-thread from a reply?
 Remove the @t{In-Reply-To} header, and @t{mu4e} automatically removes
@@ -4293,9 +4280,6 @@ values of @var{mu4e-compose-complete-only-personal},
 @var{mu4e-compose-complete-only-after} and
 @var{mu4e-compose-complete-max}.
 
-@subsection Can I use @t{BBDB} with @t{mu4e}?
-Yes, with releases of BBDB after 3.1.2. @ref{BBDB}.
-
 @subsection How can I get rid of the message buffer after sending?
 @lisp
 (setq message-kill-buffer-on-exit t)
@@ -4303,9 +4287,9 @@ Yes, with releases of BBDB after 3.1.2. @ref{BBDB}.
 
 @subsection Sending big messages is slow and blocks emacs --- what can I do about it?
 
-For this, there's @url{https://github.com/jwiegley/emacs-async} (also available
+For this, there's @uref{https://github.com/jwiegley/emacs-async,emacs-async}
-from the Emacs package repository); add the following snippet to your
+(also available from the Emacs package repository); add the following snippet to
-configuration:
+your configuration:
 @lisp
 (require 'smtpmail-async)
 (setq
@@ -4346,12 +4330,10 @@ refilled) by receiving clients that support this standard. Clients
 that don't support this, show them as is, which means this feature is
 truly non-invasive.
 
-Here's an explanatory blog post which also shows why this is a
+Here's an explanatory blog post which also shows why this is a desirable
-desirable feature:
+feature: @url{https://mathiasbynens.be/notes/gmail-plain-text} (if you don't
-@url{https://mathiasbynens.be/notes/gmail-plain-text} (if you don't
+have it, your mails mostly look quite bad especially on mobile devices) and
-have it, your mails mostly look quite bad especially on mobile
+here's the @uref{https://www.ietf.org/rfc/rfc2646.txt,RFC with all the details}.
-devices) and here's the RFC with all the details:
-@url{https://www.ietf.org/rfc/rfc2646.txt}.
 
 Since version 0.9.17, @t{mu4e} sends emails with @t{format=flowed} by setting
 @lisp
@@ -4777,9 +4759,8 @@ log using @kbd{M-x mu4e-show-log} (@key{$}).
 @node The message s-expression
 @section The message s-expression
 
-As a word of warning, the details of the s-expression are internal to
+As a word of warning, the details of the s-expression are internal to the mu4e -
-the mu4e - mu communications, and are subject to change between
+mu communications, and are subject to change between versions.
-versions.
 
 A typical message s-expression looks something like the following: