1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-26 15:21:51 -08:00
emacs/doc/misc
Alexander Adolf 8dc85d1db4 Enable Better Alignment of EUDC Inline Expansion With RFC5322
The format of EUDC inline expansion results is formatted according to
the variable eudc-inline-expansion-format, which previously defaulted
to '("%s %s <%s>" firstname name email).

Since email address specifications need to comply with RFC 5322 in
order to be useful in messages, there was little headroom for users to
change this format anyway. Plus, if an EUDC back-end returned an empty
first and last name, the result was the email address in angle
brackets. Whilst this was standard with RFC 822, it is marked as
obsolete syntax by its successor RFC 5322. Also, the first and last
name part was never enclosed in double quotes, potentially producing
invalid address specifications, which may be rejected by a receiving
MTA.

This commit updates the variable eudc-inline-expansion-format, so that
it can, in addition to the current ("format" attributes) list, now
alternatively be set to nil, or a formatting function. In both cases
the resulting email address is formatted using the new function
eudc-rfc5322-make-address, whose results fully comply with RFC 5322.

If the value is nil (the new default value), eudc-rfc5322-make-address
will be called to produce any of the default formats

                               ADDRESS
                           FIRST <ADDRESS>
                            LAST <ADDRESS>
                         FIRST LAST <ADDRESS>

depending on whether a first and/or last name are returned by the
query, or not.

If the value is a formatting function, that will be called to allow
the user to supply content for the phrase and comment parts of the
address (cf. RFC 5322). Thus one can produce any of the formats:

                               ADDRESS
                           PHRASE <ADDRESS>
                          ADDRESS (COMMENT)
                      PHRASE <ADDRESS> (COMMENT)

This can for example be used to get "last, first <address>" instead of
the default "first last <address>".

In any case when using nil, or the formatting function, the phrase
part of the result will be enclosed in double quotes if needed, and
the comment part will be omitted if it contains characters not allowed
by RFC 5322.

When eudc-inline-expansion-format remains set to a list as previously,
the old behaviour is fully retained.
2022-03-22 18:15:47 -04:00
..
auth.texi Update for the recent change 2022-01-10 20:52:20 -05:00
autotype.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
bovine.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
calc.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
cc-mode.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
ChangeLog.1 ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
cl.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
dbus.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
dired-x.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
doclicense.texi
ebrowse.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
ede.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
ediff.texi Improve the ediff-diff-options documentation 2022-02-07 04:58:49 +01:00
edt.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
efaq-w32.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
efaq.texi Avoid statting directories on startup for Info 2022-03-04 17:36:20 +01:00
eieio.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
emacs-gnutls.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
emacs-mime.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
epa.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
erc.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
ert.texi Interpret a "" value of EMACS_TEST_VERBOSE as "off" 2022-01-21 12:32:10 +01:00
eshell.texi Improve wording of Eshell variable interpolation code/documentation 2022-03-08 15:54:16 +02:00
eudc.texi Enable Better Alignment of EUDC Inline Expansion With RFC5322 2022-03-22 18:15:47 -04:00
eww.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
flymake.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
forms.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
gnus-coding.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
gnus-faq.texi Remove tarball instructions from gnus-faq.texi 2022-02-03 20:54:17 +01:00
gnus.texi Fix wording and punctuation in recent Gnus documentation changes 2022-03-04 13:52:09 +02:00
gpl.texi
htmlfontify.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
idlwave.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
ido.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
info.texi Avoid statting directories on startup for Info 2022-03-04 17:36:20 +01:00
mairix-el.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
Makefile.in Improve vtable documentation 2022-02-19 15:34:01 +02:00
message.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
mh-e.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
modus-themes.org Update modus-themes to version 2.2.0 2022-02-23 15:00:09 +02:00
newsticker.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
nxml-mode.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
octave-mode.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
org-setup.org ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
org.org ; Copyright year fixes 2022-01-01 10:02:17 -08:00
pcl-cvs.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
pgg.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
rcirc.texi ; Fix recent changes in rcirc documentation 2022-01-06 18:53:45 +02:00
reftex.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
remember.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
sasl.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
sc.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
sem-user.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
semantic.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
ses.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
sieve.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
smtpmail.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
speedbar.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
srecode.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
texinfo.tex Update from gnulib 2022-01-04 13:17:25 -08:00
todo-mode.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
tramp.texi Support remote home directories via connection property 2022-03-10 12:31:22 +01:00
trampver.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
transient.texi * doc/misc/transient.texi: Fix @dircategory to "Emacs misc features" for dir. 2022-03-15 19:28:50 +02:00
url.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
vhdl-mode.texi Merge from origin/emacs-28 2022-01-01 07:03:03 -05:00
vip.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
viper.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
vtable.texi Some vtable.texi copy edits 2022-02-19 16:58:52 +01:00
widget.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
wisent.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00
woman.texi ; Add 2022 to copyright years. 2022-01-01 02:45:51 -05:00