aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/misc/ChangeLog49
-rw-r--r--doc/misc/gnus.texi289
-rw-r--r--doc/misc/message.texi34
3 files changed, 184 insertions, 188 deletions
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index 212343f4c67..42320b227f8 100644
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,3 +1,52 @@
12012-06-26 Lars Magne Ingebrigtsen <larsi@gnus.org>
2
3 * gnus.texi (POP before SMTP): POP-before-SMTP works with all sending
4 methods, so don't mention smtpmail here.
5
62012-06-26 Wolfgang Jenkner <wjenkner@inode.at>
7
8 * gnus.texi (Picons): Document gnus-picon-properties.
9
102012-06-26 Lars Magne Ingebrigtsen <larsi@gnus.org>
11
12 * gnus.texi: Remove mention of compilation, as that's no longer
13 supported.
14
152012-06-26 Christopher Schmidt <christopher@ch.ristopher.com>
16
17 * gnus.texi (Archived Messages): Mention
18 gnus-gcc-pre-body-encode-hook and gnus-gcc-post-body-encode-hook.
19
202012-06-26 Lars Ingebrigtsen <larsi@gnus.org>
21
22 * gnus.texi (Various Summary Stuff):
23 Remove mention of `gnus-propagate-marks'.
24
252012-06-26 Lars Ingebrigtsen <larsi@gnus.org>
26
27 * gnus.texi: Remove mentions of nnml/nnfolder/nntp backend marks,
28 which no longer exist.
29
302012-06-26 Katsumi Yamaoka <yamaoka@jpl.org>
31
32 * gnus.texi (Archived Messages):
33 Document gnus-gcc-self-resent-messages.
34
352012-06-26 Lars Ingebrigtsen <larsi@gnus.org>
36
37 * message.texi (Mail Variables):
38 Mention the optional user parameter for X-Message-SMTP-Method.
39
402012-06-26 Lars Ingebrigtsen <larsi@gnus.org>
41
42 * gnus.texi (Posting Styles): Mention X-Message-SMTP-Method.
43
44 * message.texi (Mail Variables): Document X-Message-SMTP-Method.
45
462012-06-26 Lars Ingebrigtsen <larsi@gnus.org>
47
48 * gnus.texi (Key Index): Change encoding to utf-8.
49
12012-06-21 Glenn Morris <rgm@gnu.org> 502012-06-21 Glenn Morris <rgm@gnu.org>
2 51
3 * Makefile.in: Rename infodir to buildinfodir throughout. (Bug#11737) 52 * Makefile.in: Rename infodir to buildinfodir throughout. (Bug#11737)
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi
index 71a06d4461a..df4493789b6 100644
--- a/doc/misc/gnus.texi
+++ b/doc/misc/gnus.texi
@@ -8,7 +8,7 @@
8@syncodeindex vr cp 8@syncodeindex vr cp
9@syncodeindex pg cp 9@syncodeindex pg cp
10 10
11@documentencoding ISO-8859-1 11@documentencoding UTF-8
12 12
13@copying 13@copying
14Copyright @copyright{} 1995-2012 Free Software Foundation, Inc. 14Copyright @copyright{} 1995-2012 Free Software Foundation, Inc.
@@ -663,7 +663,6 @@ Getting News
663* Direct Functions:: Connecting directly to the server. 663* Direct Functions:: Connecting directly to the server.
664* Indirect Functions:: Connecting indirectly to the server. 664* Indirect Functions:: Connecting indirectly to the server.
665* Common Variables:: Understood by several connection functions. 665* Common Variables:: Understood by several connection functions.
666* NNTP marks:: Storing marks for @acronym{NNTP} servers.
667 666
668Getting Mail 667Getting Mail
669 668
@@ -816,7 +815,6 @@ Various
816* Formatting Variables:: You can specify what buffers should look like. 815* Formatting Variables:: You can specify what buffers should look like.
817* Window Layout:: Configuring the Gnus buffer windows. 816* Window Layout:: Configuring the Gnus buffer windows.
818* Faces and Fonts:: How to change how faces look. 817* Faces and Fonts:: How to change how faces look.
819* Compilation:: How to speed Gnus up.
820* Mode Lines:: Displaying information in the mode lines. 818* Mode Lines:: Displaying information in the mode lines.
821* Highlighting and Menus:: Making buffers look all nice and cozy. 819* Highlighting and Menus:: Making buffers look all nice and cozy.
822* Daemons:: Gnus can do things behind your back. 820* Daemons:: Gnus can do things behind your back.
@@ -907,7 +905,8 @@ New Features
907* Quassia Gnus:: Two times two is four, or Gnus 5.6/5.7. 905* Quassia Gnus:: Two times two is four, or Gnus 5.6/5.7.
908* Pterodactyl Gnus:: Pentad also starts with P, AKA Gnus 5.8/5.9. 906* Pterodactyl Gnus:: Pentad also starts with P, AKA Gnus 5.8/5.9.
909* Oort Gnus:: It's big. It's far out. Gnus 5.10/5.11. 907* Oort Gnus:: It's big. It's far out. Gnus 5.10/5.11.
910* No Gnus:: Very punny. 908* No Gnus:: Very punny. Gnus 5.12/5.13
909* Ma Gnus:: Celebrating 25 years of Gnus.
911 910
912Customization 911Customization
913 912
@@ -1066,10 +1065,6 @@ you would typically set this variable to
1066(setq gnus-secondary-select-methods '((nnmbox ""))) 1065(setq gnus-secondary-select-methods '((nnmbox "")))
1067@end lisp 1066@end lisp
1068 1067
1069Note: the @acronym{NNTP} back end stores marks in marks files
1070(@pxref{NNTP marks}). This feature makes it easy to share marks between
1071several Gnus installations, but may slow down things a bit when fetching
1072new articles. @xref{NNTP marks}, for more information.
1073 1068
1074 1069
1075@node The Server is Down 1070@node The Server is Down
@@ -2884,7 +2879,7 @@ composed messages will be @code{Gcc}'d to the current group. If
2884generated, if @code{(gcc-self . "string")} is present, this string will 2879generated, if @code{(gcc-self . "string")} is present, this string will
2885be inserted literally as a @code{gcc} header. This parameter takes 2880be inserted literally as a @code{gcc} header. This parameter takes
2886precedence over any default @code{Gcc} rules as described later 2881precedence over any default @code{Gcc} rules as described later
2887(@pxref{Archived Messages}). 2882(@pxref{Archived Messages}), with the exception for messages to resend.
2888 2883
2889@strong{Caveat}: Adding @code{(gcc-self . t)} to the parameter list of 2884@strong{Caveat}: Adding @code{(gcc-self . t)} to the parameter list of
2890@code{nntp} groups (or the like) isn't valid. An @code{nntp} server 2885@code{nntp} groups (or the like) isn't valid. An @code{nntp} server
@@ -3027,6 +3022,7 @@ like this in the group parameters:
3027@example 3022@example
3028(posting-style 3023(posting-style
3029 (name "Funky Name") 3024 (name "Funky Name")
3025 ("X-Message-SMTP-Method" "smtp smtp.example.org 587")
3030 ("X-My-Header" "Funky Value") 3026 ("X-My-Header" "Funky Value")
3031 (signature "Funky Signature")) 3027 (signature "Funky Signature"))
3032@end example 3028@end example
@@ -4293,12 +4289,11 @@ default is @code{nil} in Emacs, or is the aliasee of the coding system
4293named @code{file-name} (a certain coding system of which an alias is 4289named @code{file-name} (a certain coding system of which an alias is
4294@code{file-name}) in XEmacs. 4290@code{file-name}) in XEmacs.
4295 4291
4296The @code{nnml} back end, the @code{nnrss} back end, the @acronym{NNTP} 4292The @code{nnml} back end, the @code{nnrss} back end, the agent, and
4297marks feature (@pxref{NNTP marks}), the agent, and the cache use 4293the cache use non-@acronym{ASCII} group names in those files and
4298non-@acronym{ASCII} group names in those files and directories. This 4294directories. This variable overrides the value of
4299variable overrides the value of @code{file-name-coding-system} which 4295@code{file-name-coding-system} which specifies the coding system used
4300specifies the coding system used when encoding and decoding those file 4296when encoding and decoding those file names and directory names.
4301names and directory names.
4302 4297
4303In XEmacs (with the @code{mule} feature), @code{file-name-coding-system} 4298In XEmacs (with the @code{mule} feature), @code{file-name-coding-system}
4304is the only means to specify the coding system used to encode and decode 4299is the only means to specify the coding system used to encode and decode
@@ -8986,7 +8981,7 @@ Translate many non-@acronym{ASCII} characters into their
8986@acronym{ASCII} equivalents (@code{gnus-article-treat-non-ascii}). 8981@acronym{ASCII} equivalents (@code{gnus-article-treat-non-ascii}).
8987This is mostly useful if you're on a terminal that has a limited font 8982This is mostly useful if you're on a terminal that has a limited font
8988and doesn't show accented characters, ``advanced'' punctuation, and the 8983and doesn't show accented characters, ``advanced'' punctuation, and the
8989like. For instance, @samp{»} is translated into @samp{>>}, and so on. 8984like. For instance, @samp{»} is translated into @samp{>>}, and so on.
8990 8985
8991@item W Y f 8986@item W Y f
8992@kindex W Y f (Summary) 8987@kindex W Y f (Summary)
@@ -10819,12 +10814,6 @@ buffers. For example:
10819 10814
10820Also @pxref{Group Parameters}. 10815Also @pxref{Group Parameters}.
10821 10816
10822@vindex gnus-propagate-marks
10823@item gnus-propagate-marks
10824If non-@code{nil}, propagate marks to the backends for possible
10825storing. @xref{NNTP marks}, and friends, for a more fine-grained
10826sieve.
10827
10828@end table 10817@end table
10829 10818
10830 10819
@@ -12404,32 +12393,25 @@ value suitable for your system.
12404@xref{Mail Variables, ,Mail Variables,message,Message manual}, for more 12393@xref{Mail Variables, ,Mail Variables,message,Message manual}, for more
12405information. 12394information.
12406 12395
12396
12407@node POP before SMTP 12397@node POP before SMTP
12408@section POP before SMTP 12398@section POP before SMTP
12409@cindex pop before smtp 12399@cindex pop before smtp
12410@findex message-smtpmail-send-it
12411@findex mail-source-touch-pop 12400@findex mail-source-touch-pop
12412 12401
12413Does your @acronym{ISP} require the @acronym{POP}-before-@acronym{SMTP} 12402Does your @acronym{ISP} use @acronym{POP}-before-@acronym{SMTP}
12414authentication? It is whether you need to connect to the @acronym{POP} 12403authentication? This authentication method simply requires you to
12415mail server within a certain time before sending mails. If so, there is 12404contact the @acronym{POP} server before sending email. To do that,
12416a convenient way. To do that, put the following lines in your 12405put the following lines in your @file{~/.gnus.el} file:
12417@file{~/.gnus.el} file:
12418 12406
12419@lisp 12407@lisp
12420(setq message-send-mail-function 'message-smtpmail-send-it)
12421(add-hook 'message-send-mail-hook 'mail-source-touch-pop) 12408(add-hook 'message-send-mail-hook 'mail-source-touch-pop)
12422@end lisp 12409@end lisp
12423 12410
12424@noindent 12411@noindent
12425It means to let Gnus connect to the @acronym{POP} mail server in advance 12412The @code{mail-source-touch-pop} function does @acronym{POP}
12426whenever you send a mail. The @code{mail-source-touch-pop} function 12413authentication according to the value of @code{mail-sources} without
12427does only a @acronym{POP} authentication according to the value of 12414fetching mails, just before sending a mail. @xref{Mail Sources}.
12428@code{mail-sources} without fetching mails, just before sending a mail.
12429Note that you have to use @code{message-smtpmail-send-it} which runs
12430@code{message-send-mail-hook} rather than @code{smtpmail-send-it} and
12431set the value of @code{mail-sources} for a @acronym{POP} connection
12432correctly. @xref{Mail Sources}.
12433 12415
12434If you have two or more @acronym{POP} mail servers set in 12416If you have two or more @acronym{POP} mail servers set in
12435@code{mail-sources}, you may want to specify one of them to 12417@code{mail-sources}, you may want to specify one of them to
@@ -12457,6 +12439,7 @@ Otherwise, bind it dynamically only when performing the
12457 (mail-source-touch-pop)))) 12439 (mail-source-touch-pop))))
12458@end lisp 12440@end lisp
12459 12441
12442
12460@node Mail and Post 12443@node Mail and Post
12461@section Mail and Post 12444@section Mail and Post
12462 12445
@@ -12674,6 +12657,35 @@ and matches the Gcc group name, attach files as external parts; if it is
12674non-@code{nil}, the behavior is the same as @code{all}, but it may be 12657non-@code{nil}, the behavior is the same as @code{all}, but it may be
12675changed in the future. 12658changed in the future.
12676 12659
12660@item gnus-gcc-self-resent-messages
12661@vindex gnus-gcc-self-resent-messages
12662Like the @code{gcc-self} group parameter, applied only for unmodified
12663messages that @code{gnus-summary-resend-message} (@pxref{Summary Mail
12664Commands}) resends. Non-@code{nil} value of this variable takes
12665precedence over any existing @code{Gcc} header.
12666
12667If this is @code{none}, no @code{Gcc} copy will be made. If this is
12668@code{t}, messages resent will be @code{Gcc} copied to the current
12669group. If this is a string, it specifies a group to which resent
12670messages will be @code{Gcc} copied. If this is @code{nil}, @code{Gcc}
12671will be done according to existing @code{Gcc} header(s), if any. If
12672this is @code{no-gcc-self}, that is the default, resent messages will be
12673@code{Gcc} copied to groups that existing @code{Gcc} header specifies,
12674except for the current group.
12675
12676@item gnus-gcc-pre-body-encode-hook
12677@vindex gnus-gcc-pre-body-encode-hook
12678@itemx gnus-gcc-post-body-encode-hook
12679@vindex gnus-gcc-post-body-encode-hook
12680
12681These hooks are run before/after encoding the message body of the Gcc
12682copy of a sent message. The current buffer (when the hook is run)
12683contains the message including the message header. Changes made to
12684the message will only affect the Gcc copy, but not the original
12685message. You can use these hooks to edit the copy (and influence
12686subsequent transformations), e.g. remove MML secure tags
12687(@pxref{Signing and encrypting}).
12688
12677@end table 12689@end table
12678 12690
12679 12691
@@ -12805,6 +12817,7 @@ So here's a new example:
12805 (signature-file "~/.work-signature") 12817 (signature-file "~/.work-signature")
12806 (address "user@@bar.foo") 12818 (address "user@@bar.foo")
12807 (body "You are fired.\n\nSincerely, your boss.") 12819 (body "You are fired.\n\nSincerely, your boss.")
12820 ("X-Message-SMTP-Method" "smtp smtp.example.org 587")
12808 (organization "Important Work, Inc")) 12821 (organization "Important Work, Inc"))
12809 ("nnml:.*" 12822 ("nnml:.*"
12810 (From (with-current-buffer gnus-article-buffer 12823 (From (with-current-buffer gnus-article-buffer
@@ -12819,6 +12832,13 @@ if you fill many roles.
12819You may also use @code{message-alternative-emails} instead. 12832You may also use @code{message-alternative-emails} instead.
12820@xref{Message Headers, ,Message Headers, message, Message Manual}. 12833@xref{Message Headers, ,Message Headers, message, Message Manual}.
12821 12834
12835Of particular interest in the ``work-mail'' style is the
12836@samp{X-Message-SMTP-Method} header. It specifies how to send the
12837outgoing email. You may want to sent certain emails through certain
12838@acronym{SMTP} servers due to company policies, for instance.
12839@xref{Mail Variables, ,Message Variables, message, Message Manual}.
12840
12841
12822@node Drafts 12842@node Drafts
12823@section Drafts 12843@section Drafts
12824@cindex drafts 12844@cindex drafts
@@ -13744,7 +13764,6 @@ don't update their active files often, this can help.
13744* Direct Functions:: Connecting directly to the server. 13764* Direct Functions:: Connecting directly to the server.
13745* Indirect Functions:: Connecting indirectly to the server. 13765* Indirect Functions:: Connecting indirectly to the server.
13746* Common Variables:: Understood by several connection functions. 13766* Common Variables:: Understood by several connection functions.
13747* NNTP marks:: Storing marks for @acronym{NNTP} servers.
13748@end menu 13767@end menu
13749 13768
13750 13769
@@ -14015,53 +14034,6 @@ is @samp{()}.
14015 14034
14016@end table 14035@end table
14017 14036
14018@node NNTP marks
14019@subsubsection NNTP marks
14020@cindex storing NNTP marks
14021
14022Gnus stores marks (@pxref{Marking Articles}) for @acronym{NNTP}
14023servers in marks files. A marks file records what marks you have set
14024in a group and each file is specific to the corresponding server.
14025Marks files are stored in @file{~/News/marks}
14026(@code{nntp-marks-directory}) under a classic hierarchy resembling
14027that of a news server, for example marks for the group
14028@samp{gmane.discuss} on the news.gmane.org server will be stored in
14029the file @file{~/News/marks/news.gmane.org/gmane/discuss/.marks}.
14030
14031Marks files are useful because you can copy the @file{~/News/marks}
14032directory (using rsync, scp or whatever) to another Gnus installation,
14033and it will realize what articles you have read and marked. The data
14034in @file{~/News/marks} has priority over the same data in
14035@file{~/.newsrc.eld}.
14036
14037Note that marks files are very much server-specific: Gnus remembers
14038the article numbers so if you don't use the same servers on both
14039installations things are most likely to break (most @acronym{NNTP}
14040servers do not use the same article numbers as any other server).
14041However, if you use servers A, B, C on one installation and servers A,
14042D, E on the other, you can sync the marks files for A and then you'll
14043get synchronization for that server between the two installations.
14044
14045Using @acronym{NNTP} marks can possibly incur a performance penalty so
14046if Gnus feels sluggish, try setting the @code{nntp-marks-is-evil}
14047variable to @code{t}. Marks will then be stored in @file{~/.newsrc.eld}.
14048
14049Related variables:
14050
14051@table @code
14052
14053@item nntp-marks-is-evil
14054@vindex nntp-marks-is-evil
14055If non-@code{nil}, this back end will ignore any marks files. The
14056default is @code{nil}.
14057
14058@item nntp-marks-directory
14059@vindex nntp-marks-directory
14060The directory where marks for nntp groups will be stored.
14061
14062@end table
14063
14064
14065@node News Spool 14037@node News Spool
14066@subsection News Spool 14038@subsection News Spool
14067@cindex nnspool 14039@cindex nnspool
@@ -16152,22 +16124,6 @@ splitting. It has to create lots of files, and it also generates
16152@acronym{NOV} databases for the incoming mails. This makes it possibly the 16124@acronym{NOV} databases for the incoming mails. This makes it possibly the
16153fastest back end when it comes to reading mail. 16125fastest back end when it comes to reading mail.
16154 16126
16155@cindex self contained nnml servers
16156@cindex marks
16157When the marks file is used (which it is by default), @code{nnml}
16158servers have the property that you may backup them using @code{tar} or
16159similar, and later be able to restore them into Gnus (by adding the
16160proper @code{nnml} server) and have all your marks be preserved. Marks
16161for a group are usually stored in the @code{.marks} file (but see
16162@code{nnml-marks-file-name}) within each @code{nnml} group's directory.
16163Individual @code{nnml} groups are also possible to backup, use @kbd{G m}
16164to restore the group (after restoring the backup into the nnml
16165directory).
16166
16167If for some reason you believe your @file{.marks} files are screwed
16168up, you can just delete them all. Gnus will then correctly regenerate
16169them next time it starts.
16170
16171Virtual server settings: 16127Virtual server settings:
16172 16128
16173@table @code 16129@table @code
@@ -16205,15 +16161,6 @@ The name of the @acronym{NOV} files. The default is @file{.overview}.
16205@vindex nnml-prepare-save-mail-hook 16161@vindex nnml-prepare-save-mail-hook
16206Hook run narrowed to an article before saving. 16162Hook run narrowed to an article before saving.
16207 16163
16208@item nnml-marks-is-evil
16209@vindex nnml-marks-is-evil
16210If non-@code{nil}, this back end will ignore any @sc{marks} files. The
16211default is @code{nil}.
16212
16213@item nnml-marks-file-name
16214@vindex nnml-marks-file-name
16215The name of the @dfn{marks} files. The default is @file{.marks}.
16216
16217@item nnml-use-compressed-files 16164@item nnml-use-compressed-files
16218@vindex nnml-use-compressed-files 16165@vindex nnml-use-compressed-files
16219If non-@code{nil}, @code{nnml} will allow using compressed message 16166If non-@code{nil}, @code{nnml} will allow using compressed message
@@ -16554,19 +16501,6 @@ separate file. Each file is in the standard Un*x mbox format.
16554@code{nnfolder} will add extra headers to keep track of article 16501@code{nnfolder} will add extra headers to keep track of article
16555numbers and arrival dates. 16502numbers and arrival dates.
16556 16503
16557@cindex self contained nnfolder servers
16558@cindex marks
16559When the marks file is used (which it is by default), @code{nnfolder}
16560servers have the property that you may backup them using @code{tar} or
16561similar, and later be able to restore them into Gnus (by adding the
16562proper @code{nnfolder} server) and have all your marks be preserved.
16563Marks for a group are usually stored in a file named as the mbox file
16564with @code{.mrk} concatenated to it (but see
16565@code{nnfolder-marks-file-suffix}) within the @code{nnfolder}
16566directory. Individual @code{nnfolder} groups are also possible to
16567backup, use @kbd{G m} to restore the group (after restoring the backup
16568into the @code{nnfolder} directory).
16569
16570Virtual server settings: 16504Virtual server settings:
16571 16505
16572@table @code 16506@table @code
@@ -16625,20 +16559,6 @@ The extension for @acronym{NOV} files. The default is @file{.nov}.
16625The directory where the @acronym{NOV} files should be stored. If 16559The directory where the @acronym{NOV} files should be stored. If
16626@code{nil}, @code{nnfolder-directory} is used. 16560@code{nil}, @code{nnfolder-directory} is used.
16627 16561
16628@item nnfolder-marks-is-evil
16629@vindex nnfolder-marks-is-evil
16630If non-@code{nil}, this back end will ignore any @sc{marks} files. The
16631default is @code{nil}.
16632
16633@item nnfolder-marks-file-suffix
16634@vindex nnfolder-marks-file-suffix
16635The extension for @sc{marks} files. The default is @file{.mrk}.
16636
16637@item nnfolder-marks-directory
16638@vindex nnfolder-marks-directory
16639The directory where the @sc{marks} files should be stored. If
16640@code{nil}, @code{nnfolder-directory} is used.
16641
16642@end table 16562@end table
16643 16563
16644 16564
@@ -16799,9 +16719,7 @@ undergo treatment such as duplicate checking.
16799@code{nnmaildir} stores article marks for a given group in the 16719@code{nnmaildir} stores article marks for a given group in the
16800corresponding maildir, in a way designed so that it's easy to manipulate 16720corresponding maildir, in a way designed so that it's easy to manipulate
16801them from outside Gnus. You can tar up a maildir, unpack it somewhere 16721them from outside Gnus. You can tar up a maildir, unpack it somewhere
16802else, and still have your marks. @code{nnml} also stores marks, but 16722else, and still have your marks.
16803it's not as easy to work with them from outside Gnus as with
16804@code{nnmaildir}.
16805 16723
16806@code{nnmaildir} uses a significant amount of memory to speed things up. 16724@code{nnmaildir} uses a significant amount of memory to speed things up.
16807(It keeps in memory some of the things that @code{nnml} stores in files 16725(It keeps in memory some of the things that @code{nnml} stores in files
@@ -16893,16 +16811,6 @@ adding a server definition pointing to that directory in Gnus. The
16893might interfere with overwriting data, so you may want to shut down Gnus 16811might interfere with overwriting data, so you may want to shut down Gnus
16894before you restore the data. 16812before you restore the data.
16895 16813
16896It is also possible to archive individual @code{nnml},
16897@code{nnfolder}, or @code{nnmaildir} groups, while preserving marks.
16898For @code{nnml} or @code{nnmaildir}, you copy all files in the group's
16899directory. For @code{nnfolder} you need to copy both the base folder
16900file itself (@file{FOO}, say), and the marks file (@file{FOO.mrk} in
16901this example). Restoring the group is done with @kbd{G m} from the Group
16902buffer. The last step makes Gnus notice the new directory.
16903@code{nnmaildir} notices the new directory automatically, so @kbd{G m}
16904is unnecessary in that case.
16905
16906@node Web Searches 16814@node Web Searches
16907@subsection Web Searches 16815@subsection Web Searches
16908@cindex nnweb 16816@cindex nnweb
@@ -20875,7 +20783,7 @@ then this operator will return @code{false}.
20875 20783
20876@item ! 20784@item !
20877@itemx not 20785@itemx not
20878@itemx ¬ 20786@itemx ¬
20879This logical operator only takes a single argument. It returns the 20787This logical operator only takes a single argument. It returns the
20880logical negation of the value of its argument. 20788logical negation of the value of its argument.
20881 20789
@@ -22168,7 +22076,6 @@ to you, using @kbd{G b u} and updating the group will usually fix this.
22168* Formatting Variables:: You can specify what buffers should look like. 22076* Formatting Variables:: You can specify what buffers should look like.
22169* Window Layout:: Configuring the Gnus buffer windows. 22077* Window Layout:: Configuring the Gnus buffer windows.
22170* Faces and Fonts:: How to change how faces look. 22078* Faces and Fonts:: How to change how faces look.
22171* Compilation:: How to speed Gnus up.
22172* Mode Lines:: Displaying information in the mode lines. 22079* Mode Lines:: Displaying information in the mode lines.
22173* Highlighting and Menus:: Making buffers look all nice and cozy. 22080* Highlighting and Menus:: Making buffers look all nice and cozy.
22174* Daemons:: Gnus can do things behind your back. 22081* Daemons:: Gnus can do things behind your back.
@@ -22465,11 +22372,6 @@ than 6 characters to make it look nice in columns.)
22465Ignoring is done first; then cutting; then maxing; and then as the very 22372Ignoring is done first; then cutting; then maxing; and then as the very
22466last operation, padding. 22373last operation, padding.
22467 22374
22468If you use lots of these advanced thingies, you'll find that Gnus gets
22469quite slow. This can be helped enormously by running @kbd{M-x
22470gnus-compile} when you are satisfied with the look of your lines.
22471@xref{Compilation}.
22472
22473 22375
22474@node User-Defined Specs 22376@node User-Defined Specs
22475@subsection User-Defined Specs 22377@subsection User-Defined Specs
@@ -22515,7 +22417,7 @@ and so on. Create as many faces as you wish. The same goes for the
22515@samp{hello} mouse-highlighted with @code{gnus-mouse-face-3}. 22417@samp{hello} mouse-highlighted with @code{gnus-mouse-face-3}.
22516 22418
22517@cindex %<<, %>>, guillemets 22419@cindex %<<, %>>, guillemets
22518@c @cindex %<<, %>>, %«, %», guillemets 22420@c @cindex %<<, %>>, %«, %», guillemets
22519@vindex gnus-balloon-face-0 22421@vindex gnus-balloon-face-0
22520Text inside the @samp{%<<} and @samp{%>>} specifiers will get the 22422Text inside the @samp{%<<} and @samp{%>>} specifiers will get the
22521special @code{balloon-help} property set to 22423special @code{balloon-help} property set to
@@ -22978,30 +22880,6 @@ the face you want to alter, and alter it via the standard Customize
22978interface. 22880interface.
22979 22881
22980 22882
22981@node Compilation
22982@section Compilation
22983@cindex compilation
22984@cindex byte-compilation
22985
22986@findex gnus-compile
22987
22988Remember all those line format specification variables?
22989@code{gnus-summary-line-format}, @code{gnus-group-line-format}, and so
22990on. Now, Gnus will of course heed whatever these variables are, but,
22991unfortunately, changing them will mean a quite significant slow-down.
22992(The default values of these variables have byte-compiled functions
22993associated with them, while the user-generated versions do not, of
22994course.)
22995
22996To help with this, you can run @kbd{M-x gnus-compile} after you've
22997fiddled around with the variables and feel that you're (kind of)
22998satisfied. This will result in the new specs being byte-compiled, and
22999you'll get top speed again. Gnus will save these compiled specs in the
23000@file{.newsrc.eld} file. (User-defined functions aren't compiled by
23001this function, though---you should compile them yourself by sticking
23002them into the @file{~/.gnus.el} file and byte-compiling that file.)
23003
23004
23005@node Mode Lines 22883@node Mode Lines
23006@section Mode Lines 22884@section Mode Lines
23007@cindex mode lines 22885@cindex mode lines
@@ -23656,6 +23534,10 @@ The variable @code{gnus-picon-style} controls how picons are displayed.
23656If @code{inline}, the textual representation is replaced. If 23534If @code{inline}, the textual representation is replaced. If
23657@code{right}, picons are added right to the textual representation. 23535@code{right}, picons are added right to the textual representation.
23658 23536
23537@vindex gnus-picon-properties
23538The value of the variable @code{gnus-picon-properties} is a list of
23539properties applied to picons.
23540
23659The following variables offer control over where things are located. 23541The following variables offer control over where things are located.
23660 23542
23661@table @code 23543@table @code
@@ -26409,6 +26291,7 @@ renamed it back again to ``Gnus''. But in mixed case. ``Gnus'' vs.
26409@cindex Pterodactyl Gnus 26291@cindex Pterodactyl Gnus
26410@cindex Oort Gnus 26292@cindex Oort Gnus
26411@cindex No Gnus 26293@cindex No Gnus
26294@cindex Ma Gnus
26412@cindex Gnus versions 26295@cindex Gnus versions
26413 26296
26414The first ``proper'' release of Gnus 5 was done in November 1995 when it 26297The first ``proper'' release of Gnus 5 was done in November 1995 when it
@@ -26437,12 +26320,15 @@ On April 19, 2010 Gnus development was moved to Git. See
26437http://git.gnus.org for details (http://www.gnus.org will be updated 26320http://git.gnus.org for details (http://www.gnus.org will be updated
26438with the information when possible). 26321with the information when possible).
26439 26322
26323On the January 31th 2012, Ma Gnus was begun.
26324
26440If you happen upon a version of Gnus that has a prefixed name -- 26325If you happen upon a version of Gnus that has a prefixed name --
26441``(ding) Gnus'', ``September Gnus'', ``Red Gnus'', ``Quassia Gnus'', 26326``(ding) Gnus'', ``September Gnus'', ``Red Gnus'', ``Quassia Gnus'',
26442``Pterodactyl Gnus'', ``Oort Gnus'', ``No Gnus'' -- don't panic. 26327``Pterodactyl Gnus'', ``Oort Gnus'', ``No Gnus'', ``Ma Gnus'' -- don't
26443Don't let it know that you're frightened. Back away. Slowly. Whatever 26328panic. Don't let it know that you're frightened. Back away. Slowly.
26444you do, don't run. Walk away, calmly, until you're out of its reach. 26329Whatever you do, don't run. Walk away, calmly, until you're out of
26445Find a proper released version of Gnus and snuggle up to that instead. 26330its reach. Find a proper released version of Gnus and snuggle up to
26331that instead.
26446 26332
26447 26333
26448@node Why? 26334@node Why?
@@ -27045,7 +26931,8 @@ actually are people who are using Gnus. Who'd'a thunk it!
27045* Quassia Gnus:: Two times two is four, or Gnus 5.6/5.7. 26931* Quassia Gnus:: Two times two is four, or Gnus 5.6/5.7.
27046* Pterodactyl Gnus:: Pentad also starts with P, AKA Gnus 5.8/5.9. 26932* Pterodactyl Gnus:: Pentad also starts with P, AKA Gnus 5.8/5.9.
27047* Oort Gnus:: It's big. It's far out. Gnus 5.10/5.11. 26933* Oort Gnus:: It's big. It's far out. Gnus 5.10/5.11.
27048* No Gnus:: Very punny. 26934* No Gnus:: Very punny. Gnus 5.12/5.13.
26935* Ma Gnus:: Celebrating 25 years of Gnus.
27049@end menu 26936@end menu
27050 26937
27051These lists are, of course, just @emph{short} overviews of the 26938These lists are, of course, just @emph{short} overviews of the
@@ -28420,6 +28307,32 @@ New features in No Gnus:
28420 28307
28421@include gnus-news.texi 28308@include gnus-news.texi
28422 28309
28310@node Ma Gnus
28311@subsubsection Ma Gnus
28312@cindex Ma Gnus
28313
28314I'm sure there will be lots of text here. It's really spelled 真
28315Gnus.
28316
28317New features in Ma Gnus:
28318
28319@itemize @bullet
28320
28321@item Changes in Message mode and related Gnus features
28322@c ****************************************************
28323
28324@itemize @bullet
28325
28326@item
28327The new hooks @code{gnus-gcc-pre-body-encode-hook} and
28328@code{gnus-gcc-post-body-encode-hook} are run before/after encoding
28329the message body of the Gcc copy of a sent message. See
28330@xref{Archived Messages}.
28331
28332@end itemize
28333
28334@end itemize
28335
28423@iftex 28336@iftex
28424 28337
28425@page 28338@page
@@ -30642,5 +30555,5 @@ former). The manual is unambiguous, but it can be confusing.
30642 30555
30643@c Local Variables: 30556@c Local Variables:
30644@c mode: texinfo 30557@c mode: texinfo
30645@c coding: iso-8859-1 30558@c coding: utf-8
30646@c End: 30559@c End:
diff --git a/doc/misc/message.texi b/doc/misc/message.texi
index ac5811a0ce8..ef752a96fdc 100644
--- a/doc/misc/message.texi
+++ b/doc/misc/message.texi
@@ -1637,6 +1637,40 @@ To the thing similar to this, there is
1637requires the @acronym{POP}-before-@acronym{SMTP} authentication. 1637requires the @acronym{POP}-before-@acronym{SMTP} authentication.
1638@xref{POP before SMTP, , POP before SMTP, gnus, The Gnus Manual}. 1638@xref{POP before SMTP, , POP before SMTP, gnus, The Gnus Manual}.
1639 1639
1640@cindex X-Message-SMTP-Method
1641If you have a complex @acronym{SMTP} setup, and want some messages to
1642go via one mail server, and other messages to go through another, you
1643can use the @samp{X-Message-SMTP-Method} header. These are the
1644supported values:
1645
1646@table @samp
1647@item smtpmail
1648
1649@example
1650X-Message-SMTP-Method: smtp smtp.fsf.org 587
1651@end example
1652
1653This will send the message via @samp{smtp.fsf.org}, using port 587.
1654
1655@example
1656X-Message-SMTP-Method: smtp smtp.fsf.org 587 other-user
1657@end example
1658
1659This is the same as the above, but uses @samp{other-user} as the user
1660name when authenticating. This is handy if you have several
1661@acronym{SMTP} accounts on the same server.
1662
1663@item sendmail
1664
1665@example
1666X-Message-SMTP-Method: sendmail
1667@end example
1668
1669This will send the message via the locally installed sendmail/exim/etc
1670installation.
1671
1672@end table
1673
1640@item message-mh-deletable-headers 1674@item message-mh-deletable-headers
1641@vindex message-mh-deletable-headers 1675@vindex message-mh-deletable-headers
1642Most versions of MH doesn't like being fed messages that contain the 1676Most versions of MH doesn't like being fed messages that contain the