From 2f98dacadedda234c62c846c13bd22cd9d9cd206 Mon Sep 17 00:00:00 2001 From: "Dirk-Jan C. Binnema" Date: Wed, 2 Aug 2023 23:51:37 +0300 Subject: [PATCH] mu4e/mu4e.texi: fix external links in html Fixes #2182. --- Makefile | 2 +- mu4e/htmlxref.cnf | 788 ++++++++++++++++++++++++++++++++++++++++++++++ mu4e/mu4e.texi | 207 ++++++------ 3 files changed, 883 insertions(+), 114 deletions(-) create mode 100644 mu4e/htmlxref.cnf diff --git a/Makefile b/Makefile index fe4f03b2..d8279216 100644 --- a/Makefile +++ b/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 diff --git a/mu4e/htmlxref.cnf b/mu4e/htmlxref.cnf new file mode 100644 index 00000000..1af587bb --- /dev/null +++ b/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: diff --git a/mu4e/mu4e.texi b/mu4e/mu4e.texi index eaa5febe..23878c41 100644 --- a/mu4e/mu4e.texi +++ b/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 -@t{mu}@footnote{@url{https://www.djcbsoftware.nl/code/mu}} e-mail search engine. -@t{mu4e} is optimized for quickly processing large amounts of e-mail. +newer, built on top of the @uref{https://www.djcbsoftware.nl/code/mu,mu} e-mail +search engine. @t{mu4e} is optimized for quickly processing large amounts of +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 -like @t{notmuch}@footnote{@url{https://notmuchmail.org/}} and -@t{sup}@footnote{@url{https://sup-heliotrope.github.io/}}. +Under the hood, @t{mu4e} is fully search-based, similar to programs like +@uref{https://notmuchmail.org/,notmuch} and +@uref{https://sup-heliotrope.github.io/,sup}. -However, @t{mu4e}'s user-interface is quite different. @t{mu4e}'s mail -handling (deleting, moving, etc.)@: is inspired by -Wanderlust@footnote{@url{http://www.gohome.org/wl/}} (another -Emacs-based e-mail client), -@t{mutt}@footnote{@url{http://www.mutt.org/}} and the @t{dired} -file-manager for emacs. +However, @t{mu4e}'s user-interface is quite different. @t{mu4e}'s mail handling +(deleting, moving, etc.)@: is inspired by +@uref{http://www.gohome.org/wl/,Wanderlust} (another Emacs-based e-mail client), +@uref{http://www.mutt.org/,mutt} 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 -delegated to other tools, such as -@t{offlineimap}@footnote{@url{https://www.offlineimap.org/}}, -@t{isync/mbsync}@footnote{@url{http://isync.sourceforge.net/}} or -@t{fetchmail}@footnote{@url{http://www.fetchmail.info/}}; As long as -the messages end up in a maildir, @t{mu4e} and @t{mu} are happy to -deal with them. -@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. +a mail server. Nor does it sync-back any changes. Those tasks are delegated to +other tools, such as @uref{https://www.offlineimap.org/,offlineimap}, +@uref{http://isync.sourceforge.net/,mbsync} or +@uref{http://www.fetchmail.info/,fetchmail}; As long as the messages end up in a +maildir, @t{mu4e} and @t{mu} are happy to deal with them. +@item @t{mu4e} also does @emph{not} implement sending of messages; instead, it depends on +@ref{(smtpmail) Top}, which is part of Emacs. In addition, @t{mu4e} piggybacks on +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 -list@footnote{@url{https://groups.google.com/group/mu-discuss}}. +@uref{https://groups.google.com/group/mu-discuss,mu/mu4e mailing list}. -Sometimes, you might encounter some unexpected behavior while using -@t{mu4e}. It could be a bug in @t{mu4e}, it could be an issue in other -software. Or it could just be a misunderstanding. In any case, if you -want to report this (either to the mailing list or to -@url{https://github.com/djcb/mu/issues}, the latter is preferred), -please always include the following information: +Sometimes, you might encounter some unexpected behavior while using @t{mu4e}, or +have some idea on how it could work better. To report this, you can use the +@uref{https://github.com/djcb/mu/issues,bug-tracker}. 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 -basic setup. After we have succeeded in @ref{Getting mail}, and -@pxref{Indexing your messages}, we discuss the @ref{Basic -configuration}. +In this chapter, we go through the installation of @t{mu4e} and its basic setup. +After we have succeeded in @ref{Getting mail}, and @pxref{Indexing your +messages}, we discuss the @ref{Basic 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 -GMime@footnote{@url{http://spruce.sourceforge.net/gmime/}}. +higher is required, as well as @uref{https://xapian.org/,Xapian} and +@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 -have your e-mail messages stored in a -@emph{maildir}@footnote{@url{https://en.wikipedia.org/wiki/Maildir}; -in this manual we use the term `maildir' for both the standard and the -hierarchy of maildirs that store your messages} --- a specific -directory structure with one-file-per-message. +In order for @t{mu} (and, by extension, @t{mu4e}) to work, you need to have your +e-mail messages stored in a +@uref{https://en.wikipedia.org/wiki/Maildir, Maildir}; in this manual we use the +term `maildir' for both the standard and the hierarchy of maildirs that store +your messages --- a specific 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 -writing mail and inherits the setup for sending mail as well. +@t{mu4e} uses Emacs's @ref{(message) Top,,message-mode} for writing mail. -For sending mail using @abbr{SMTP}, @t{mu4e} uses @t{smtpmail} -(@ref{Top,,smtpmail}). This package supports many different ways to -send mail; please refer to its documentation for the details. +For sending mail using @abbr{SMTP}, @t{mu4e} uses @ref{(smtpmail) +Top,,smtpmail}. This package supports many different ways to send mail; please +refer to its documentation for the details. -Here, we only provide some simple examples --- for more, see -@ref{Example configurations}. +Here, we only provide some simple examples --- for more, see @ref{Example +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 -Jamie Zawinski's mail threading algorithm, -@url{https://www.jwz.org/doc/threading.html}}. +@item The subject field also indicates the discussion threads, following +@uref{https://www.jwz.org/doc/threading.html,Jamie Zawinski's mail threading +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}, -most easily accessed through the @t{Attachments}-menu while composing a -message, or with @kbd{M-x mml-secure-message-encrypt-pgp}, @kbd{M-x +Signing and encrypting of messages is possible using @ref{(emacs-mime) Top, +emacs-mime}, most easily accessed through the @t{Attachments}-menu while +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}: -this means that draft messages are @emph{not} encrypted. So if you are -using e.g. @t{offlineimap} or @t{mbsync} to synchronize with some -remote IMAP-service, make sure the drafts folder is @emph{not} in the -set of synchronized folders, for obvious reasons. +Important note: the messages are encrypted when they are @emph{sent}: this means +that draft messages are @emph{not} encrypted. So if you are using e.g. +@t{offlineimap} or @t{mbsync} to synchronize with some remote IMAP-service, make +sure the drafts folder is @emph{not} in the set of synchronized folders, for +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 -@xref{Desktop Notifications,,,elisp,GNU Emacs Lisp Reference Manual}. +DBus-based notifications, as per Emacs' notification sub-system @xref{(elisp) +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 -is also possible to manage your addresses with @t{org-mode}, using -@t{org-contacts}@footnote{@url{https://julien.danjou.info/projects/emacs-packages#org-contacts}}. +autocompletion}, and that is the recommended way to do this. However, it is also +possible to manage your addresses with @t{org-mode}, using +@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 -is also possible to manage your addresses with the current (2015-06-23) -development release of @t{BBDB}, or releases of @t{BBDB} after -3.1.2.@footnote{@url{https://savannah.nongnu.org/projects/bbdb/}}. +autocompletion}, and that is the recommended way to do this. However, it is also +possible to manage your addresses with +@uref{https://savannah.nongnu.org/projects/bbdb/,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 -@url{https://github.com/djcb/sauron}, or in the MELPA (Milkypostman’s -Emacs Lisp Package Archive) package repository at -@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 +The Emacs package @uref{https://github.com/djcb/sauron,sauron} (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 -bookmarks; an easy way to achieve this, is by using an emacs package -called Hydra@footnote{@url{https://github.com/abo-abo/hydra}}. +People sometimes ask about having multi-character shortcuts for bookmarks; an +easy way to achieve this, is by using an emacs package +@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 -instead --- see -@url{https://github.com/djcb/mu/issues/68#issuecomment-8598652}. +This is best solved by telling @command{offlineimap} to use UTF-8 instead --- +see @uref{https://github.com/djcb/mu/issues/68#issuecomment-8598652,this +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 -then send it, using @code{M-x mu4e-compose-resend}. This gives you a -raw copy of the message, including all headers, encoded parts and so -on. Reason for this is that for resending, it is important not to -change anything (except perhaps for the @t{To:} address when -bouncing); since we cannot losslessly decode an existing message, you -get the raw version. +Somewhat --- it is possible to edit a (copy of) an existing message and then +send it, using @code{M-x mu4e-compose-resend}. This gives you a raw copy of the +message, including all headers, encoded parts and so on. Reason for this is that +for resending, it is important not to change anything (except perhaps for the +@t{To:} address when bouncing); since we cannot losslessly decode an existing +message, you 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 -re-use many of its facilities. +Since @code{mu4e-compose-mode} derives from @xref{(message) Top}, you can re-use +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 -@t{dired} --- see @ref{Dired}. +You can drag-and-drop from your desktop; alternatively, you can use @ref{(emacs) +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} -versions is no longer used. Also see the entries for version 1.4 in -@t{NEWS.org} (@kbd{N}) in the main-menu. +@code{mu4e-user-mail-address-list} which was used in older @t{mu4e} versions is +no longer used. Also see the entries for version 1.4 in @t{NEWS.org} (@kbd{N}) +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 -from the Emacs package repository); add the following snippet to your -configuration: +For this, there's @uref{https://github.com/jwiegley/emacs-async,emacs-async} +(also available from the Emacs package repository); add the following snippet to +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 -desirable feature: -@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 here's the RFC with all the details: -@url{https://www.ietf.org/rfc/rfc2646.txt}. +Here's an explanatory blog post which also shows why this is a desirable +feature: @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 +here's the @uref{https://www.ietf.org/rfc/rfc2646.txt,RFC with all the details}. 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 -the mu4e - mu communications, and are subject to change between -versions. +As a word of warning, the details of the s-expression are internal to the mu4e - +mu communications, and are subject to change between versions. A typical message s-expression looks something like the following: