xemacs-beta: man/gnus.texi comparison

comparison man/gnus.texi @ 100:4be1180a9e89 r20-1b2

Import from CVS: tag r20-1b2

author	cvs
date	Mon, 13 Aug 2007 09:15:11 +0200
parents	0d2f883870bc
children	cf808b4c4290

comparison

equal deleted inserted replaced

-:2d83cbd90d8d
+:4be1180a9e89
 @cindex nndoc
 Make a group based on some file or other
 (@code{gnus-group-make-doc-group}).  If you give a prefix to this
 command, you will be prompted for a file name and a file type.
 Currently supported types are @code{babyl}, @code{mbox}, @code{digest},
-@code{mmdf}, @code{news}, @code{rnews}, @code{clari-briefs}, and
+@code{mmdf}, @code{news}, @code{rnews}, @code{clari-briefs},
-@code{forward}.  If you run this command without a prefix, Gnus will
+@code{rfc934} and @code{forward}.  If you run this command without a
-guess at the file type.  @xref{Document Groups}.
+prefix, Gnus will guess at the file type.  @xref{Document Groups}.
 @item G w
 @kindex G w (Group)
 @findex gnus-group-make-web-group
 @cindex DejaNews
 @node Threading
 @section Threading
 @cindex threading
 @cindex article threading
-Gnus threads articles by default.  @dfn{To thread} is to put replies to
+Gnus threads articles by default.  @dfn{To thread} is to put responses
-articles directly after the articles they reply to---in a hierarchical
+to articles directly after the articles they respond to---in a
-fashion.
+hierarchical fashion.
 @menu
 * Customizing Threading::     Variables you can change to affect the threading.
 * Thread Commands::           Thread based commands in the summary buffer.
 @end menu
 @menu
 * Server Buffer Format::      You can customize the look of this buffer.
 * Server Commands::           Commands to manipulate servers.
 * Example Methods::           Examples server specifications.
 * Creating a Virtual Server:: An example session.
+* Server Variables::          Which variables to set.
 * Servers and Methods::       You can use server names as select methods.
 * Unavailable Servers::       Some servers you try to contact may be down.
 @end menu
 @vindex gnus-server-mode-hook
 @end lisp
 Type @kbd{C-c C-c} to return to the server buffer.  If you now press
 @kbd{RET} over this virtual server, you should be entered into a browse
 buffer, and you should be able to enter any of the groups displayed.
+@node Server Variables
+@subsection Server Variables
+One sticky point when defining variables (both on backends and in Emacs
+in general) is that some variables are typically initialized from other
+variables when the definition of the variables is being loaded.  If you
+change the "base" variable after the variables have been loaded, you
+won't change the "derived" variables.
+This typically affects directory and file variables.  For instance,
+@code{nnml-directory} is @file{~/Mail/} by default, and all @code{nnml}
+directory variables are initialized from that variable, so
+@code{nnml-active-file} will be @file{~/Mail/active}.  If you define a
+new virtual @code{nnml} server, it will @emph{not} suffice to set just
+@code{nnml-directory}---you have to explicitly set all the file
+variables to be what you want them to be.  For a complete list of
+variables for each backend, see each backend's section later in this
+manual, but here's an example @code{nnml} definition:
+@lisp
+(nnml "public"
+(nnml-directory "~/my-mail/")
+(nnml-active-file "~/my-mail/active")
+(nnml-newsgroups-file "~/my-mail/newsgroups"))
+@end lisp
 @node Servers and Methods
 @subsection Servers and Methods
 @item nnmail-delete-incoming
 @vindex nnmail-delete-incoming
 @cindex incoming mail files
 @cindex deleting incoming files
 If non-@code{nil}, the mail backends will delete the temporary incoming
-file after splitting mail into the proper groups.  This is @code{nil} by
+file after splitting mail into the proper groups.  This is @code{t} by
-default for reasons of security.
+default.
+@c This is @code{nil} by
+@c default for reasons of security.
 @c Since Red Gnus is an alpha release, it is to be expected to lose mail.
 (No Gnus release since (ding) Gnus 0.10 (or something like that) have
 lost mail, I think, but that's not the point.  (Except certain versions
 of Red Gnus.))  By not deleting the Incoming* files, one can be sure to
 @table @code
 @item nndoc-article-type
 @vindex nndoc-article-type
 This should be one of @code{mbox}, @code{babyl}, @code{digest},
-@code{mmdf}, @code{forward}, @code{news}, @code{rnews},
+@code{mmdf}, @code{forward}, @code{rfc934}, @code{news}, @code{rnews},
 @code{mime-digest}, @code{clari-briefs}, or @code{guess}.
 @item nndoc-post-type
 @vindex nndoc-post-type
 This variable says whether Gnus is to consider the group a news group or
 @code{group}, @code{summary}, @code{article}, @code{server},
 @code{browse}, @code{message}, @code{pick}, @code{info},
 @code{summary-faq}, @code{edit-group}, @code{edit-server},
 @code{edit-score}, @code{post}, @code{reply}, @code{forward},
-@code{reply-yank}, @code{mail-bounce}, @code{draft},
+@code{reply-yank}, @code{mail-bounce}, @code{draft}, @code{pipe},
-@code{pipe}, @code{bug}, @code{compose-bounce}.
+@code{bug}, @code{compose-bounce}.
 Note that the @code{message} key is used for both
 @code{gnus-group-mail} and @code{gnus-summary-mail-other-window}.  If
 it is desirable to distinguish between the two, something like this
 might be used:

Mercurial > hg > xemacs-beta

comparison man/gnus.texi @ 100:4be1180a9e89 r20-1b2