xemacs-beta: man/gnus.texi comparison

comparison man/gnus.texi @ 173:8eaf7971accc r20-3b13

Import from CVS: tag r20-3b13

author	cvs
date	Mon, 13 Aug 2007 09:49:09 +0200
parents	15872534500d
children

comparison

equal deleted inserted replaced

-:a38aed19690b
+:8eaf7971accc
 \input texinfo                  @c -*-texinfo-*-
 @setfilename gnus
-@settitle Gnus 5.4.62 Manual
+@settitle Gnus 5.4.63 Manual
 @synindex fn cp
 @synindex vr cp
 @synindex pg cp
 @iftex
 @finalout
 @end ifinfo
 @tex
 @titlepage
-@title Gnus 5.4.62 Manual
+@title Gnus 5.4.63 Manual
 @author by Lars Magne Ingebrigtsen
 @page
 @vskip 0pt plus 1filll
 You can read news (and mail) from within Emacs by using Gnus.  The news
 can be gotten by any nefarious means you can think of---@sc{nntp}, local
 spool or your mbox file.  All at the same time, if you want to push your
 luck.
-This manual corresponds to Gnus 5.4.62.
+This manual corresponds to Gnus 5.4.63.
 @end ifinfo
 @iftex
 If you are satisfied that you really never want to see any new groups,
 you can set @code{gnus-check-new-newsgroups} to @code{nil}.  This will
 also save you some time at startup.  Even if this variable is
 @code{nil}, you can always subscribe to the new groups just by pressing
 @kbd{U} in the group buffer (@pxref{Group Maintenance}).  This variable
-is @code{t} by default.  If you set this variable to @code{always}, then
+is @code{ask-server} by default.  If you set this variable to
-Gnus will query the backends for new groups even when you do the @kbd{g}
+@code{always}, then Gnus will query the backends for new groups even
-command (@pxref{Scanning New Messages}).
+when you do the @kbd{g} command (@pxref{Scanning New Messages}).
 @menu
 * Checking New Groups::      Determining what groups are new.
 * Subscription Methods::     What Gnus should do with new groups.
 * Filtering New Groups::     Making Gnus ignore certain new groups.
 @findex nntp-send-authinfo
 @findex nntp-send-mode-reader
 is run after a connection has been made.  It can be used to send
 commands to the @sc{nntp} server after it has been contacted.  By
 default it sends the command @code{MODE READER} to the server with the
-@code{nntp-send-mode-reader} function.
+@code{nntp-send-mode-reader} function.  This function should always be
+present in this hook.
 @item nntp-authinfo-function
 @vindex nntp-authinfo-function
 This function will be used to send @samp{AUTHINFO} to the @sc{nntp}
 server.  Available functions include:
 @kindex V C (Summary)
 @findex gnus-score-customize
 Customize a score file in a visually pleasing manner
 (@code{gnus-score-customize}).
-@item I C-i
-@kindex I C-i (Summary)
-@findex gnus-summary-raise-score
-Increase the score of the current article
-(@code{gnus-summary-raise-score}).
-@item L C-l
-@kindex L C-l (Summary)
-@findex gnus-summary-lower-score
-Lower the score of the current article
-(@code{gnus-summary-lower-score}).
 @end table
 The rest of these commands modify the local score file.
 @table @kbd
 * Mode Lines::                 Displaying information in the mode lines.
 * Highlighting and Menus::     Making buffers look all nice and cozy.
 * Buttons::                    Get tendonitis in ten easy steps!
 * Daemons::                    Gnus can do things behind your back.
 * NoCeM::                      How to avoid spam and other fatty foods.
-* Picons::                     How to display pictures of what your reading.
 * Undo::                       Some actions can be undone.
 * Moderation::                 What to do if you're a moderator.
 * XEmacs Enhancements::        There are more pictures and stuff under XEmacs.
 * Fuzzy Matching::             What's the big fuzz?
 * Thwarting Email Spam::       A how-to on avoiding unsolited commercial email.
 (i. e., subscribed or unsubscribed groups), your Emacs process will grow
 big.  If this is a problem, you should kill off all (or most) of your
 unsubscribed groups (@pxref{Subscription Commands}).
+@node Undo
+@section Undo
+@cindex undo
+It is very useful to be able to undo actions one has done.  In normal
+Emacs buffers, it's easy enough---you just push the @code{undo} button.
+In Gnus buffers, however, it isn't that simple.
+The things Gnus displays in its buffer is of no value whatsoever to
+Gnus---it's all just data designed to look nice to the user.
+Killing a group in the group buffer with @kbd{C-k} makes the line
+disappear, but that's just a side-effect of the real action---the
+removal of the group in question from the internal Gnus structures.
+Undoing something like that can't be done by the normal Emacs
+@code{undo} function.
+Gnus tries to remedy this somewhat by keeping track of what the user
+does and coming up with actions that would reverse the actions the user
+takes.  When the user then presses the @code{undo} key, Gnus will run
+the code to reverse the previous action, or the previous actions.
+However, not all actions are easily reversible, so Gnus currently offers
+a few key functions to be undoable.  These include killing groups,
+yanking groups, and changing the list of read articles of groups.
+That's it, really.  More functions may be added in the future, but each
+added function means an increase in data to be stored, so Gnus will
+never be totally undoable.
+@findex gnus-undo-mode
+@vindex gnus-use-undo
+@findex gnus-undo
+The undoability is provided by the @code{gnus-undo-mode} minor mode.  It
+is used if @code{gnus-use-undo} is non-@code{nil}, which is the
+default.  The @kbd{M-C-_} key performs the @code{gnus-undo} command
+command, which should feel kinda like the normal Emacs @code{undo}
+command.
+@node Moderation
+@section Moderation
+@cindex moderation
+If you are a moderator, you can use the @file{gnus-mdrtn.el} package.
+It is not included in the standard Gnus package.  Write a mail to
+@samp{larsi@@gnus.org} and state what group you moderate, and you'll
+get a copy.
+The moderation package is implemented as a minor mode for summary
+buffers.  Put
+@lisp
+(add-hook 'gnus-summary-mode-hook 'gnus-moderate)
+@end lisp
+in your @file{.gnus.el} file.
+If you are the moderator of @samp{rec.zoofle}, this is how it's
+supposed to work:
+@enumerate
+@item
+You split your incoming mail by matching on
+@samp{Newsgroups:.*rec.zoofle}, which will put all the to-be-posted
+articles in some mail group---for instance, @samp{nnml:rec.zoofle}.
+@item
+You enter that group once in a while and post articles using the @kbd{e}
+(edit-and-post) or @kbd{s} (just send unedited) commands.
+@item
+If, while reading the @samp{rec.zoofle} newsgroup, you happen upon some
+articles that weren't approved by you, you can cancel them with the
+@kbd{c} command.
+@end enumerate
+To use moderation mode in these two groups, say:
+@lisp
+(setq gnus-moderated-list
+"^nnml:rec.zoofle$\\|^rec.zoofle$")
+@end lisp
+@node XEmacs Enhancements
+@section XEmacs Enhancements
+@cindex XEmacs
+XEmacs is able to display pictures and stuff, so Gnus has taken
+advantage of that.
+@menu
+* Picons::    How to display pictures of what your reading.
+* Smileys::   Show all those happy faces the way they were meant to be shown.
+* Toolbar::   Click'n'drool.
+* XVarious::  Other XEmacsy Gnusey variables.
+@end menu
 @node Picons
-@section Picons
+@subsection Picons
 @iftex
 @iflatex
 \gnuspicon{tmp/picons-att.ps}
 \gnuspicon{tmp/picons-berkeley.ps}
 * Picon Configuration::    Other variables you can trash/tweak/munge/play with.
 @end menu
 @node Picon Basics
-@subsection Picon Basics
+@subsubsection Picon Basics
 What are Picons?  To quote directly from the Picons Web site:
 @quotation
 @dfn{Picons} is short for ``personal icons''.  They're small,
 Gnus expects picons to be installed into a location pointed to by
 @code{gnus-picons-database}.
 @node Picon Requirements
-@subsection Picon Requirements
+@subsubsection Picon Requirements
 To have Gnus display Picons for you, you must be running XEmacs
 19.13 or greater since all other versions of Emacs aren't yet able to
 display images.
 the @code{netpbm} utilities installed, or munge the
 @code{gnus-picons-convert-x-face} variable to use something else.
 @node Easy Picons
-@subsection Easy Picons
+@subsubsection Easy Picons
 To enable displaying picons, simply put the following line in your
 @file{~/.gnus} file and start Gnus.
 @lisp
 (add-hook 'gnus-article-display-hook 'gnus-picons-article-display-x-face)
 @end lisp
 @node Hard Picons
-@subsection Hard Picons
+@subsubsection Hard Picons
 Gnus can display picons for you as you enter and leave groups and
 articles.  It knows how to interact with three sections of the picons
 database.  Namely, it can display the picons newsgroup pictures,
 author's face picture(s), and the authors domain.  To enable this
 (add-hook 'gnus-article-display-hook 'gnus-article-display-picons t)
 @end lisp
 @node Picon Configuration
-@subsection Picon Configuration
+@subsubsection Picon Configuration
 The following variables offer further control over how things are
 done, where things are located, and other useless stuff you really
 don't need to worry about.
 @samp{*Icon Buffer*}.
 @end table
-@node Undo
+@node Smileys
-@section Undo
+@subsection Smileys
-@cindex undo
+@cindex smileys
-It is very useful to be able to undo actions one has done.  In normal
+@dfn{Smiley} is a package separate from Gnus, but since Gnus is
-Emacs buffers, it's easy enough---you just push the @code{undo} button.
+currently the only package that uses Smiley, it is documented here.
-In Gnus buffers, however, it isn't that simple.
+In short---to use Smiley in Gnus, put the following in your
-The things Gnus displays in its buffer is of no value whatsoever to
+@file{.gnus.el} file:
-Gnus---it's all just data designed to look nice to the user.
-Killing a group in the group buffer with @kbd{C-k} makes the line
-disappear, but that's just a side-effect of the real action---the
-removal of the group in question from the internal Gnus structures.
-Undoing something like that can't be done by the normal Emacs
-@code{undo} function.
-Gnus tries to remedy this somewhat by keeping track of what the user
-does and coming up with actions that would reverse the actions the user
-takes.  When the user then presses the @code{undo} key, Gnus will run
-the code to reverse the previous action, or the previous actions.
-However, not all actions are easily reversible, so Gnus currently offers
-a few key functions to be undoable.  These include killing groups,
-yanking groups, and changing the list of read articles of groups.
-That's it, really.  More functions may be added in the future, but each
-added function means an increase in data to be stored, so Gnus will
-never be totally undoable.
-@findex gnus-undo-mode
-@vindex gnus-use-undo
-@findex gnus-undo
-The undoability is provided by the @code{gnus-undo-mode} minor mode.  It
-is used if @code{gnus-use-undo} is non-@code{nil}, which is the
-default.  The @kbd{M-C-_} key performs the @code{gnus-undo} command
-command, which should feel kinda like the normal Emacs @code{undo}
-command.
-@node Moderation
-@section Moderation
-@cindex moderation
-If you are a moderator, you can use the @file{gnus-mdrtn.el} package.
-It is not included in the standard Gnus package.  Write a mail to
-@samp{larsi@@gnus.org} and state what group you moderate, and you'll
-get a copy.
-The moderation package is implemented as a minor mode for summary
-buffers.  Put
 @lisp
-(add-hook 'gnus-summary-mode-hook 'gnus-moderate)
+(add-hook 'gnus-article-display-hook 'gnus-smiley-display t)
 @end lisp
-in your @file{.gnus.el} file.
+Smiley maps text smiley faces---@samp{:-)}, @samp{:-=}, @samp{:-(} and
+the like---to pictures and displays those instead of the text smiley
-If you are the moderator of @samp{rec.zoofle}, this is how it's
+faces.  The conversion is controlled by a list of regexps that matches
-supposed to work:
+text and maps that to file names.
-@enumerate
+@vindex smiley-nosey-regexp-alist
-@item
+@vindex smiley-deformed-regexp-alist
-You split your incoming mail by matching on
+Smiley supplies two example conversion alists by default:
-@samp{Newsgroups:.*rec.zoofle}, which will put all the to-be-posted
+@code{smiley-deformed-regexp-alist} (which matches @samp{:)}, @samp{:(}
-articles in some mail group---for instance, @samp{nnml:rec.zoofle}.
+and so on), and @code{smiley-nosey-regexp-alist} (which matches
+@samp{:-)}, @samp{:-(} and so on).
-@item
-You enter that group once in a while and post articles using the @kbd{e}
+The alist used is specified by the @code{smiley-regexp-alist} variable,
-(edit-and-post) or @kbd{s} (just send unedited) commands.
+which defaults to the value of @code{smiley-deformed-regexp-alist}.
-@item
+Here's the default value of @code{smiley-smiley-regexp-alist}:
-If, while reading the @samp{rec.zoofle} newsgroup, you happen upon some
-articles that weren't approved by you, you can cancel them with the
-@kbd{c} command.
-@end enumerate
-To use moderation mode in these two groups, say:
 @lisp
-(setq gnus-moderated-list
+(setq smiley-nosey-regexp-alist
-"^nnml:rec.zoofle$\\|^rec.zoofle$")
+'(("\\(:-+[<�]+\\)\\W" 1 "FaceAngry.xpm")
+("\\(:-+\\]+\\)\\W" 1 "FaceGoofy.xpm")
+("\\(:-+D\\)\\W" 1 "FaceGrinning.xpm")
+("\\(:-+[@}�]+\\)\\W" 1 "FaceHappy.xpm")
+("\\(:-*)+\\)\\W" 1 "FaceHappy.xpm")
+("\\(:-+[/\\\"]+\\)\\W" 1 "FaceIronic.xpm")
+("\\([8|]-+[|Oo%]\\)\\W" 1 "FaceKOed.xpm")
+("\\([:|]-+#+\\)\\W" 1 "FaceNyah.xpm")
+("\\(:-+[(@{]+\\)\\W" 1 "FaceSad.xpm")
+("\\(:-+[Oo\*]\\)\\W" 1 "FaceStartled.xpm")
+("\\(:-+|\\)\\W" 1 "FaceStraight.xpm")
+("\\(:-+p\\)\\W" 1 "FaceTalking.xpm")
+("\\(:-+d\\)\\W" 1 "FaceTasty.xpm")
+("\\(;-+[>)@}�]+\\)\\W" 1 "FaceWinking.xpm")
+("\\(:-+[Vv�]\\)\\W" 1 "FaceWry.xpm")
+("\\(][:8B]-[)>]\\)\\W" 1 "FaceDevilish.xpm")
+("\\([:|]-+P\\)\\W" 1 "FaceYukky.xpm")))
 @end lisp
+The first item in each element is the regexp to be matched; the second
-@node XEmacs Enhancements
+element is the regexp match group that is to be replaced by the picture;
-@section XEmacs Enhancements
+and the third element is the name of the file to be displayed.
-@cindex XEmacs
+The following variables customize where Smiley will look for these
-XEmacs is able to display pictures and stuff, so Gnus has taken
+files, as well as the color to be used and stuff:
-advantage of that.  Relevant variables include:
+@table @code
+@item smiley-data-directory
+@vindex smiley-data-directory
+Where Smiley will look for smiley faces files.
+@item smiley-flesh-color
+@vindex smiley-flesh-color
+Skin color.  The default is @samp{yellow}, which is really racist.
+@item smiley-features-color
+@vindex smiley-features-color
+Color of the features of the face.  The default is @samp{black}.
+@item smiley-tongue-color
+@vindex smiley-tongue-color
+Color of the tongue.  The default is @samp{red}.
+@item smiley-circle-color
+@vindex smiley-circle-color
+Color of the circle around the face.  The default is @samp{black}.
+@item smiley-mouse-face
+@vindex smiley-mouse-face
+Face used for mouse highlighting over the smiley face.
+@end table
+@node Toolbar
+@subsection Toolbar
+@table @code
+@item gnus-use-toolbar
+@vindex gnus-use-toolbar
+If @code{nil}, don't display toolbars.  If non-@code{nil}, it should be
+one of @code{default-toolbar}, @code{top-toolbar}, @code{bottom-toolbar},
+@code{right-toolbar}, or @code{left-toolbar}.
+@item gnus-group-toolbar
+@vindex gnus-group-toolbar
+The toolbar in the group buffer.
+@item gnus-summary-toolbar
+@vindex gnus-summary-toolbar
+The toolbar in the summary buffer.
+@item gnus-summary-mail-toolbar
+@vindex gnus-summary-mail-toolbar
+The toolbar in the summary buffer of mail groups.
+@end table
+@node XVarious
+@subsection Various XEmacs Variables
 @table @code
 @item gnus-xmas-glyph-directory
 @vindex gnus-xmas-glyph-directory
 This is where Gnus will look for pictures.  Gnus will normally
 @vindex gnus-xmas-logo-color-style
 This is the key used to look up the color in the alist described above.
 Legal values include @code{flame}, @code{pine}, @code{moss},
 @code{irish}, @code{sky}, @code{tin}, @code{velvet}, @code{grape},
 @code{labia}, @code{berry}, @code{neutral}, and @code{september}.
-@item gnus-use-toolbar
-@vindex gnus-use-toolbar
-If @code{nil}, don't display toolbars.  If non-@code{nil}, it should be
-one of @code{default-toolbar}, @code{top-toolbar}, @code{bottom-toolbar},
-@code{right-toolbar}, or @code{left-toolbar}.
-@item gnus-group-toolbar
-@vindex gnus-group-toolbar
-The toolbar in the group buffer.
-@item gnus-summary-toolbar
-@vindex gnus-summary-toolbar
-The toolbar in the summary buffer.
-@item gnus-summary-mail-toolbar
-@vindex gnus-summary-mail-toolbar
-The toolbar in the summary buffer of mail groups.
 @item gnus-xmas-modeline-glyph
 @vindex gnus-xmas-modeline-glyph
 A glyph displayed in all Gnus mode lines.  It is a tiny gnu head by
 default.
 Here the virtual server name is @samp{odd-one} while the name of
 the physical server is @samp{ifi.uio.no}.
 The backends should be able to switch between several virtual servers.
 The standard backends implement this by keeping an alist of virtual
-server environments that they pull down/pushe up when needed.
+server environments that they pull down/push up when needed.
 There are two groups of interface functions: @dfn{required functions},
 which must be present, and @dfn{optional functions}, which Gnus will
 always check for presence before attempting to call 'em.

Mercurial > hg > xemacs-beta

comparison man/gnus.texi @ 173:8eaf7971accc r20-3b13