diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/misc/ChangeLog | 49 | ||||
| -rw-r--r-- | doc/misc/gnus.texi | 289 | ||||
| -rw-r--r-- | doc/misc/message.texi | 34 |
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 @@ | |||
| 1 | 2012-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 | |||
| 6 | 2012-06-26 Wolfgang Jenkner <wjenkner@inode.at> | ||
| 7 | |||
| 8 | * gnus.texi (Picons): Document gnus-picon-properties. | ||
| 9 | |||
| 10 | 2012-06-26 Lars Magne Ingebrigtsen <larsi@gnus.org> | ||
| 11 | |||
| 12 | * gnus.texi: Remove mention of compilation, as that's no longer | ||
| 13 | supported. | ||
| 14 | |||
| 15 | 2012-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 | |||
| 20 | 2012-06-26 Lars Ingebrigtsen <larsi@gnus.org> | ||
| 21 | |||
| 22 | * gnus.texi (Various Summary Stuff): | ||
| 23 | Remove mention of `gnus-propagate-marks'. | ||
| 24 | |||
| 25 | 2012-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 | |||
| 30 | 2012-06-26 Katsumi Yamaoka <yamaoka@jpl.org> | ||
| 31 | |||
| 32 | * gnus.texi (Archived Messages): | ||
| 33 | Document gnus-gcc-self-resent-messages. | ||
| 34 | |||
| 35 | 2012-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 | |||
| 40 | 2012-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 | |||
| 46 | 2012-06-26 Lars Ingebrigtsen <larsi@gnus.org> | ||
| 47 | |||
| 48 | * gnus.texi (Key Index): Change encoding to utf-8. | ||
| 49 | |||
| 1 | 2012-06-21 Glenn Morris <rgm@gnu.org> | 50 | 2012-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 |
| 14 | Copyright @copyright{} 1995-2012 Free Software Foundation, Inc. | 14 | Copyright @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 | ||
| 668 | Getting Mail | 667 | Getting 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 | ||
| 912 | Customization | 911 | Customization |
| 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 | ||
| 1069 | Note: the @acronym{NNTP} back end stores marks in marks files | ||
| 1070 | (@pxref{NNTP marks}). This feature makes it easy to share marks between | ||
| 1071 | several Gnus installations, but may slow down things a bit when fetching | ||
| 1072 | new 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 | |||
| 2884 | generated, if @code{(gcc-self . "string")} is present, this string will | 2879 | generated, if @code{(gcc-self . "string")} is present, this string will |
| 2885 | be inserted literally as a @code{gcc} header. This parameter takes | 2880 | be inserted literally as a @code{gcc} header. This parameter takes |
| 2886 | precedence over any default @code{Gcc} rules as described later | 2881 | precedence 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 | |||
| 4293 | named @code{file-name} (a certain coding system of which an alias is | 4289 | named @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 | ||
| 4296 | The @code{nnml} back end, the @code{nnrss} back end, the @acronym{NNTP} | 4292 | The @code{nnml} back end, the @code{nnrss} back end, the agent, and |
| 4297 | marks feature (@pxref{NNTP marks}), the agent, and the cache use | 4293 | the cache use non-@acronym{ASCII} group names in those files and |
| 4298 | non-@acronym{ASCII} group names in those files and directories. This | 4294 | directories. This variable overrides the value of |
| 4299 | variable overrides the value of @code{file-name-coding-system} which | 4295 | @code{file-name-coding-system} which specifies the coding system used |
| 4300 | specifies the coding system used when encoding and decoding those file | 4296 | when encoding and decoding those file names and directory names. |
| 4301 | names and directory names. | ||
| 4302 | 4297 | ||
| 4303 | In XEmacs (with the @code{mule} feature), @code{file-name-coding-system} | 4298 | In XEmacs (with the @code{mule} feature), @code{file-name-coding-system} |
| 4304 | is the only means to specify the coding system used to encode and decode | 4299 | is 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}). |
| 8987 | This is mostly useful if you're on a terminal that has a limited font | 8982 | This is mostly useful if you're on a terminal that has a limited font |
| 8988 | and doesn't show accented characters, ``advanced'' punctuation, and the | 8983 | and doesn't show accented characters, ``advanced'' punctuation, and the |
| 8989 | like. For instance, @samp{»} is translated into @samp{>>}, and so on. | 8984 | like. 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 | ||
| 10820 | Also @pxref{Group Parameters}. | 10815 | Also @pxref{Group Parameters}. |
| 10821 | 10816 | ||
| 10822 | @vindex gnus-propagate-marks | ||
| 10823 | @item gnus-propagate-marks | ||
| 10824 | If non-@code{nil}, propagate marks to the backends for possible | ||
| 10825 | storing. @xref{NNTP marks}, and friends, for a more fine-grained | ||
| 10826 | sieve. | ||
| 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 |
| 12405 | information. | 12394 | information. |
| 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 | ||
| 12413 | Does your @acronym{ISP} require the @acronym{POP}-before-@acronym{SMTP} | 12402 | Does your @acronym{ISP} use @acronym{POP}-before-@acronym{SMTP} |
| 12414 | authentication? It is whether you need to connect to the @acronym{POP} | 12403 | authentication? This authentication method simply requires you to |
| 12415 | mail server within a certain time before sending mails. If so, there is | 12404 | contact the @acronym{POP} server before sending email. To do that, |
| 12416 | a convenient way. To do that, put the following lines in your | 12405 | put 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 |
| 12425 | It means to let Gnus connect to the @acronym{POP} mail server in advance | 12412 | The @code{mail-source-touch-pop} function does @acronym{POP} |
| 12426 | whenever you send a mail. The @code{mail-source-touch-pop} function | 12413 | authentication according to the value of @code{mail-sources} without |
| 12427 | does only a @acronym{POP} authentication according to the value of | 12414 | fetching mails, just before sending a mail. @xref{Mail Sources}. |
| 12428 | @code{mail-sources} without fetching mails, just before sending a mail. | ||
| 12429 | Note 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 | ||
| 12431 | set the value of @code{mail-sources} for a @acronym{POP} connection | ||
| 12432 | correctly. @xref{Mail Sources}. | ||
| 12433 | 12415 | ||
| 12434 | If you have two or more @acronym{POP} mail servers set in | 12416 | If 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 | |||
| 12674 | non-@code{nil}, the behavior is the same as @code{all}, but it may be | 12657 | non-@code{nil}, the behavior is the same as @code{all}, but it may be |
| 12675 | changed in the future. | 12658 | changed in the future. |
| 12676 | 12659 | ||
| 12660 | @item gnus-gcc-self-resent-messages | ||
| 12661 | @vindex gnus-gcc-self-resent-messages | ||
| 12662 | Like the @code{gcc-self} group parameter, applied only for unmodified | ||
| 12663 | messages that @code{gnus-summary-resend-message} (@pxref{Summary Mail | ||
| 12664 | Commands}) resends. Non-@code{nil} value of this variable takes | ||
| 12665 | precedence over any existing @code{Gcc} header. | ||
| 12666 | |||
| 12667 | If 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 | ||
| 12669 | group. If this is a string, it specifies a group to which resent | ||
| 12670 | messages will be @code{Gcc} copied. If this is @code{nil}, @code{Gcc} | ||
| 12671 | will be done according to existing @code{Gcc} header(s), if any. If | ||
| 12672 | this 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, | ||
| 12674 | except 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 | |||
| 12681 | These hooks are run before/after encoding the message body of the Gcc | ||
| 12682 | copy of a sent message. The current buffer (when the hook is run) | ||
| 12683 | contains the message including the message header. Changes made to | ||
| 12684 | the message will only affect the Gcc copy, but not the original | ||
| 12685 | message. You can use these hooks to edit the copy (and influence | ||
| 12686 | subsequent 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. | |||
| 12819 | You may also use @code{message-alternative-emails} instead. | 12832 | You 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 | ||
| 12835 | Of particular interest in the ``work-mail'' style is the | ||
| 12836 | @samp{X-Message-SMTP-Method} header. It specifies how to send the | ||
| 12837 | outgoing 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 | |||
| 14022 | Gnus stores marks (@pxref{Marking Articles}) for @acronym{NNTP} | ||
| 14023 | servers in marks files. A marks file records what marks you have set | ||
| 14024 | in a group and each file is specific to the corresponding server. | ||
| 14025 | Marks files are stored in @file{~/News/marks} | ||
| 14026 | (@code{nntp-marks-directory}) under a classic hierarchy resembling | ||
| 14027 | that of a news server, for example marks for the group | ||
| 14028 | @samp{gmane.discuss} on the news.gmane.org server will be stored in | ||
| 14029 | the file @file{~/News/marks/news.gmane.org/gmane/discuss/.marks}. | ||
| 14030 | |||
| 14031 | Marks files are useful because you can copy the @file{~/News/marks} | ||
| 14032 | directory (using rsync, scp or whatever) to another Gnus installation, | ||
| 14033 | and it will realize what articles you have read and marked. The data | ||
| 14034 | in @file{~/News/marks} has priority over the same data in | ||
| 14035 | @file{~/.newsrc.eld}. | ||
| 14036 | |||
| 14037 | Note that marks files are very much server-specific: Gnus remembers | ||
| 14038 | the article numbers so if you don't use the same servers on both | ||
| 14039 | installations things are most likely to break (most @acronym{NNTP} | ||
| 14040 | servers do not use the same article numbers as any other server). | ||
| 14041 | However, if you use servers A, B, C on one installation and servers A, | ||
| 14042 | D, E on the other, you can sync the marks files for A and then you'll | ||
| 14043 | get synchronization for that server between the two installations. | ||
| 14044 | |||
| 14045 | Using @acronym{NNTP} marks can possibly incur a performance penalty so | ||
| 14046 | if Gnus feels sluggish, try setting the @code{nntp-marks-is-evil} | ||
| 14047 | variable to @code{t}. Marks will then be stored in @file{~/.newsrc.eld}. | ||
| 14048 | |||
| 14049 | Related variables: | ||
| 14050 | |||
| 14051 | @table @code | ||
| 14052 | |||
| 14053 | @item nntp-marks-is-evil | ||
| 14054 | @vindex nntp-marks-is-evil | ||
| 14055 | If non-@code{nil}, this back end will ignore any marks files. The | ||
| 14056 | default is @code{nil}. | ||
| 14057 | |||
| 14058 | @item nntp-marks-directory | ||
| 14059 | @vindex nntp-marks-directory | ||
| 14060 | The 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 |
| 16153 | fastest back end when it comes to reading mail. | 16125 | fastest back end when it comes to reading mail. |
| 16154 | 16126 | ||
| 16155 | @cindex self contained nnml servers | ||
| 16156 | @cindex marks | ||
| 16157 | When the marks file is used (which it is by default), @code{nnml} | ||
| 16158 | servers have the property that you may backup them using @code{tar} or | ||
| 16159 | similar, and later be able to restore them into Gnus (by adding the | ||
| 16160 | proper @code{nnml} server) and have all your marks be preserved. Marks | ||
| 16161 | for 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. | ||
| 16163 | Individual @code{nnml} groups are also possible to backup, use @kbd{G m} | ||
| 16164 | to restore the group (after restoring the backup into the nnml | ||
| 16165 | directory). | ||
| 16166 | |||
| 16167 | If for some reason you believe your @file{.marks} files are screwed | ||
| 16168 | up, you can just delete them all. Gnus will then correctly regenerate | ||
| 16169 | them next time it starts. | ||
| 16170 | |||
| 16171 | Virtual server settings: | 16127 | Virtual 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 |
| 16206 | Hook run narrowed to an article before saving. | 16162 | Hook run narrowed to an article before saving. |
| 16207 | 16163 | ||
| 16208 | @item nnml-marks-is-evil | ||
| 16209 | @vindex nnml-marks-is-evil | ||
| 16210 | If non-@code{nil}, this back end will ignore any @sc{marks} files. The | ||
| 16211 | default is @code{nil}. | ||
| 16212 | |||
| 16213 | @item nnml-marks-file-name | ||
| 16214 | @vindex nnml-marks-file-name | ||
| 16215 | The 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 |
| 16219 | If non-@code{nil}, @code{nnml} will allow using compressed message | 16166 | If 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 |
| 16555 | numbers and arrival dates. | 16502 | numbers and arrival dates. |
| 16556 | 16503 | ||
| 16557 | @cindex self contained nnfolder servers | ||
| 16558 | @cindex marks | ||
| 16559 | When the marks file is used (which it is by default), @code{nnfolder} | ||
| 16560 | servers have the property that you may backup them using @code{tar} or | ||
| 16561 | similar, and later be able to restore them into Gnus (by adding the | ||
| 16562 | proper @code{nnfolder} server) and have all your marks be preserved. | ||
| 16563 | Marks for a group are usually stored in a file named as the mbox file | ||
| 16564 | with @code{.mrk} concatenated to it (but see | ||
| 16565 | @code{nnfolder-marks-file-suffix}) within the @code{nnfolder} | ||
| 16566 | directory. Individual @code{nnfolder} groups are also possible to | ||
| 16567 | backup, use @kbd{G m} to restore the group (after restoring the backup | ||
| 16568 | into the @code{nnfolder} directory). | ||
| 16569 | |||
| 16570 | Virtual server settings: | 16504 | Virtual 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}. | |||
| 16625 | The directory where the @acronym{NOV} files should be stored. If | 16559 | The 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 | ||
| 16630 | If non-@code{nil}, this back end will ignore any @sc{marks} files. The | ||
| 16631 | default is @code{nil}. | ||
| 16632 | |||
| 16633 | @item nnfolder-marks-file-suffix | ||
| 16634 | @vindex nnfolder-marks-file-suffix | ||
| 16635 | The extension for @sc{marks} files. The default is @file{.mrk}. | ||
| 16636 | |||
| 16637 | @item nnfolder-marks-directory | ||
| 16638 | @vindex nnfolder-marks-directory | ||
| 16639 | The 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 |
| 16800 | corresponding maildir, in a way designed so that it's easy to manipulate | 16720 | corresponding maildir, in a way designed so that it's easy to manipulate |
| 16801 | them from outside Gnus. You can tar up a maildir, unpack it somewhere | 16721 | them from outside Gnus. You can tar up a maildir, unpack it somewhere |
| 16802 | else, and still have your marks. @code{nnml} also stores marks, but | 16722 | else, and still have your marks. |
| 16803 | it'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 | |||
| 16893 | might interfere with overwriting data, so you may want to shut down Gnus | 16811 | might interfere with overwriting data, so you may want to shut down Gnus |
| 16894 | before you restore the data. | 16812 | before you restore the data. |
| 16895 | 16813 | ||
| 16896 | It is also possible to archive individual @code{nnml}, | ||
| 16897 | @code{nnfolder}, or @code{nnmaildir} groups, while preserving marks. | ||
| 16898 | For @code{nnml} or @code{nnmaildir}, you copy all files in the group's | ||
| 16899 | directory. For @code{nnfolder} you need to copy both the base folder | ||
| 16900 | file itself (@file{FOO}, say), and the marks file (@file{FOO.mrk} in | ||
| 16901 | this example). Restoring the group is done with @kbd{G m} from the Group | ||
| 16902 | buffer. The last step makes Gnus notice the new directory. | ||
| 16903 | @code{nnmaildir} notices the new directory automatically, so @kbd{G m} | ||
| 16904 | is 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 ¬ |
| 20879 | This logical operator only takes a single argument. It returns the | 20787 | This logical operator only takes a single argument. It returns the |
| 20880 | logical negation of the value of its argument. | 20788 | logical 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.) | |||
| 22465 | Ignoring is done first; then cutting; then maxing; and then as the very | 22372 | Ignoring is done first; then cutting; then maxing; and then as the very |
| 22466 | last operation, padding. | 22373 | last operation, padding. |
| 22467 | 22374 | ||
| 22468 | If you use lots of these advanced thingies, you'll find that Gnus gets | ||
| 22469 | quite slow. This can be helped enormously by running @kbd{M-x | ||
| 22470 | gnus-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 |
| 22520 | Text inside the @samp{%<<} and @samp{%>>} specifiers will get the | 22422 | Text inside the @samp{%<<} and @samp{%>>} specifiers will get the |
| 22521 | special @code{balloon-help} property set to | 22423 | special @code{balloon-help} property set to |
| @@ -22978,30 +22880,6 @@ the face you want to alter, and alter it via the standard Customize | |||
| 22978 | interface. | 22880 | interface. |
| 22979 | 22881 | ||
| 22980 | 22882 | ||
| 22981 | @node Compilation | ||
| 22982 | @section Compilation | ||
| 22983 | @cindex compilation | ||
| 22984 | @cindex byte-compilation | ||
| 22985 | |||
| 22986 | @findex gnus-compile | ||
| 22987 | |||
| 22988 | Remember all those line format specification variables? | ||
| 22989 | @code{gnus-summary-line-format}, @code{gnus-group-line-format}, and so | ||
| 22990 | on. Now, Gnus will of course heed whatever these variables are, but, | ||
| 22991 | unfortunately, changing them will mean a quite significant slow-down. | ||
| 22992 | (The default values of these variables have byte-compiled functions | ||
| 22993 | associated with them, while the user-generated versions do not, of | ||
| 22994 | course.) | ||
| 22995 | |||
| 22996 | To help with this, you can run @kbd{M-x gnus-compile} after you've | ||
| 22997 | fiddled around with the variables and feel that you're (kind of) | ||
| 22998 | satisfied. This will result in the new specs being byte-compiled, and | ||
| 22999 | you'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 | ||
| 23001 | this function, though---you should compile them yourself by sticking | ||
| 23002 | them 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. | |||
| 23656 | If @code{inline}, the textual representation is replaced. If | 23534 | If @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 | ||
| 23538 | The value of the variable @code{gnus-picon-properties} is a list of | ||
| 23539 | properties applied to picons. | ||
| 23540 | |||
| 23659 | The following variables offer control over where things are located. | 23541 | The 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 | ||
| 26414 | The first ``proper'' release of Gnus 5 was done in November 1995 when it | 26297 | The 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 | |||
| 26437 | http://git.gnus.org for details (http://www.gnus.org will be updated | 26320 | http://git.gnus.org for details (http://www.gnus.org will be updated |
| 26438 | with the information when possible). | 26321 | with the information when possible). |
| 26439 | 26322 | ||
| 26323 | On the January 31th 2012, Ma Gnus was begun. | ||
| 26324 | |||
| 26440 | If you happen upon a version of Gnus that has a prefixed name -- | 26325 | If 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 |
| 26443 | Don't let it know that you're frightened. Back away. Slowly. Whatever | 26328 | panic. Don't let it know that you're frightened. Back away. Slowly. |
| 26444 | you do, don't run. Walk away, calmly, until you're out of its reach. | 26329 | Whatever you do, don't run. Walk away, calmly, until you're out of |
| 26445 | Find a proper released version of Gnus and snuggle up to that instead. | 26330 | its reach. Find a proper released version of Gnus and snuggle up to |
| 26331 | that 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 | ||
| 27051 | These lists are, of course, just @emph{short} overviews of the | 26938 | These 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 | |||
| 28314 | I'm sure there will be lots of text here. It's really spelled 真 | ||
| 28315 | Gnus. | ||
| 28316 | |||
| 28317 | New 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 | ||
| 28327 | The new hooks @code{gnus-gcc-pre-body-encode-hook} and | ||
| 28328 | @code{gnus-gcc-post-body-encode-hook} are run before/after encoding | ||
| 28329 | the 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 | |||
| 1637 | requires the @acronym{POP}-before-@acronym{SMTP} authentication. | 1637 | requires 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 | ||
| 1641 | If you have a complex @acronym{SMTP} setup, and want some messages to | ||
| 1642 | go via one mail server, and other messages to go through another, you | ||
| 1643 | can use the @samp{X-Message-SMTP-Method} header. These are the | ||
| 1644 | supported values: | ||
| 1645 | |||
| 1646 | @table @samp | ||
| 1647 | @item smtpmail | ||
| 1648 | |||
| 1649 | @example | ||
| 1650 | X-Message-SMTP-Method: smtp smtp.fsf.org 587 | ||
| 1651 | @end example | ||
| 1652 | |||
| 1653 | This will send the message via @samp{smtp.fsf.org}, using port 587. | ||
| 1654 | |||
| 1655 | @example | ||
| 1656 | X-Message-SMTP-Method: smtp smtp.fsf.org 587 other-user | ||
| 1657 | @end example | ||
| 1658 | |||
| 1659 | This is the same as the above, but uses @samp{other-user} as the user | ||
| 1660 | name when authenticating. This is handy if you have several | ||
| 1661 | @acronym{SMTP} accounts on the same server. | ||
| 1662 | |||
| 1663 | @item sendmail | ||
| 1664 | |||
| 1665 | @example | ||
| 1666 | X-Message-SMTP-Method: sendmail | ||
| 1667 | @end example | ||
| 1668 | |||
| 1669 | This will send the message via the locally installed sendmail/exim/etc | ||
| 1670 | installation. | ||
| 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 |
| 1642 | Most versions of MH doesn't like being fed messages that contain the | 1676 | Most versions of MH doesn't like being fed messages that contain the |