home *** CD-ROM | disk | FTP | other *** search
/ Dream 49 / Amiga_Dream_49.iso / beos / emacs / emacs-19.34-bin / emacs-19 / info / gnus-2 (.txt) < prev    next >
GNU Info File  |  1997-09-17  |  47KB  |  967 lines
  1. This is Info file ../info/gnus, produced by Makeinfo-1.63 from the
  2. input file gnus.texi.
  3.    This file documents Gnus, the GNU Emacs newsreader.
  4.    Copyright (C) 1995,96 Free Software Foundation, Inc.
  5.    Permission is granted to make and distribute verbatim copies of this
  6. manual provided the copyright notice and this permission notice are
  7. preserved on all copies.
  8.    Permission is granted to copy and distribute modified versions of
  9. this manual under the conditions for verbatim copying, provided also
  10. that the entire resulting derived work is distributed under the terms
  11. of a permission notice identical to this one.
  12.    Permission is granted to copy and distribute translations of this
  13. manual into another language, under the above conditions for modified
  14. versions.
  15. File: gnus,  Node: Sorting Groups,  Next: Group Maintenance,  Prev: Listing Groups,  Up: The Group Buffer
  16. Sorting Groups
  17. ==============
  18.    The `C-c C-s' (`gnus-group-sort-groups') command sorts the group
  19. buffer according to the function(s) given by the
  20. `gnus-group-sort-function' variable.  Available sorting functions
  21. include:
  22. `gnus-group-sort-by-alphabet'
  23.      Sort the group names alphabetically.  This is the default.
  24. `gnus-group-sort-by-level'
  25.      Sort by group level.
  26. `gnus-group-sort-by-score'
  27.      Sort by group score.
  28. `gnus-group-sort-by-rank'
  29.      Sort by group score and then the group level.  The level and the
  30.      score are, when taken together, the group's "rank".
  31. `gnus-group-sort-by-unread'
  32.      Sort by number of unread articles.
  33. `gnus-group-sort-by-method'
  34.      Sort by alphabetically on the select method.
  35.    `gnus-group-sort-function' can also be a list of sorting functions.
  36. In that case, the most significant sort key function must be the last
  37.    There are also a number of commands for sorting directly according to
  38. some sorting criteria:
  39. `G S a'
  40.      Sort the group buffer alphabetically by group name
  41.      (`gnus-group-sort-groups-by-alphabet').
  42. `G S u'
  43.      Sort the group buffer by the number of unread articles
  44.      (`gnus-group-sort-groups-by-unread').
  45. `G S l'
  46.      Sort the group buffer by group level
  47.      (`gnus-group-sort-groups-by-level').
  48. `G S v'
  49.      Sort the group buffer by group score
  50.      (`gnus-group-sort-groups-by-score').
  51. `G S r'
  52.      Sort the group buffer by group level
  53.      (`gnus-group-sort-groups-by-rank').
  54. `G S m'
  55.      Sort the group buffer alphabetically by backend name
  56.      (`gnus-group-sort-groups-by-method').
  57.    When given a prefix, all these commands will sort in reverse order.
  58. File: gnus,  Node: Group Maintenance,  Next: Browse Foreign Server,  Prev: Sorting Groups,  Up: The Group Buffer
  59. Group Maintenance
  60. =================
  61.      Find bogus groups and delete them
  62.      (`gnus-group-check-bogus-groups').
  63.      Find new groups and process them (`gnus-find-new-newsgroups').  If
  64.      given a prefix, use the `ask-server' method to query the server for
  65.      new groups.
  66. `C-c C-x'
  67.      Run all expirable articles in the current group through the expiry
  68.      process (if any) (`gnus-group-expire-articles').
  69. `C-c M-C-x'
  70.      Run all articles in all groups through the expiry process
  71.      (`gnus-group-expire-all-groups').
  72. File: gnus,  Node: Browse Foreign Server,  Next: Exiting Gnus,  Prev: Group Maintenance,  Up: The Group Buffer
  73. Browse Foreign Server
  74. =====================
  75.      You will be queried for a select method and a server name.  Gnus
  76.      will then attempt to contact this server and let you browse the
  77.      groups there (`gnus-group-browse-foreign-server').
  78.    A new buffer with a list of available groups will appear.  This
  79. buffer will be use the `gnus-browse-mode'.  This buffer looks a bit
  80. (well, a lot) like a normal group buffer, but with one major difference
  81. - you can't enter any of the groups.  If you want to read any of the
  82. news available on that server, you have to subscribe to the groups you
  83. think may be interesting, and then you have to exit this buffer.  The
  84. new groups will be added to the group buffer, and then you can read them
  85. as you would any other group.
  86.    Future versions of Gnus may possibly permit reading groups straight
  87. from the browse buffer.
  88.    Here's a list of keystrokes available in the browse mode:
  89.      Go to the next group (`gnus-group-next-group').
  90.      Go to the previous group (`gnus-group-prev-group').
  91. `SPACE'
  92.      Enter the current group and display the first article
  93.      (`gnus-browse-read-group').
  94. `RET'
  95.      Enter the current group (`gnus-browse-select-group').
  96.      Unsubscribe to the current group, or, as will be the case here,
  97.      subscribe to it (`gnus-browse-unsubscribe-current-group').
  98.      Exit browse mode (`gnus-browse-exit').
  99.      Describe browse mode briefly (well, there's not much to describe,
  100.      is there) (`gnus-browse-describe-briefly').
  101. File: gnus,  Node: Exiting Gnus,  Next: Group Topics,  Prev: Browse Foreign Server,  Up: The Group Buffer
  102. Exiting Gnus
  103. ============
  104.    Yes, Gnus is ex(c)iting.
  105.      Suspend Gnus (`gnus-group-suspend').  This doesn't really exit
  106.      Gnus, but it kills all buffers except the Group buffer.  I'm not
  107.      sure why this is a gain, but then who am I to judge?
  108.      Quit Gnus (`gnus-group-exit').
  109.      Quit Gnus without saving any startup files (`gnus-group-quit').
  110.    `gnus-suspend-gnus-hook' is called when you suspend Gnus and
  111. `gnus-exit-gnus-hook' is called when you quit Gnus, while
  112. `gnus-after-exiting-gnus-hook' is called as the final item when exiting
  113. Gnus.
  114.    If you wish to completely unload Gnus and all its adherents, you can
  115. use the `gnus-unload' command.  This command is also very handy when
  116. trying to customize meta-variables.
  117.    Note:
  118.      Miss Lisa Cannifax, while sitting in English class, feels her feet
  119.      go numbly heavy and herself fall into a hazy trance as the boy
  120.      sitting behind her drew repeated lines with his pencil across the
  121.      back of her plastic chair.
  122. File: gnus,  Node: Group Topics,  Next: Misc Group Stuff,  Prev: Exiting Gnus,  Up: The Group Buffer
  123. Group Topics
  124. ============
  125.    If you read lots and lots of groups, it might be convenient to group
  126. them hierarchically according to topics.  You put your Emacs groups over
  127. here, your sex groups over there, and the rest (what, two groups or so?)
  128. you put in some misc section that you never bother with anyway.  You can
  129. even group the Emacs sex groups as a sub-topic to either the Emacs
  130. groups or the sex groups--or both!  Go wild!
  131.    To get this *fab* functionality you simply turn on (ooh!) the
  132. `gnus-topic' minor mode--type `t' in the group buffer.  (This is a
  133. toggling command.)
  134.    Go ahead, just try it.  I'll still be here when you get back.  La de
  135. dum...  Nice tune, that...  la la la...  What, you're back? Yes, and now
  136. press `l'.  There.  All your groups are now listed under `misc'.
  137. Doesn't that make you feel all warm and fuzzy?  Hot and bothered?
  138.    If you want this permanently enabled, you should add that minor mode
  139. to the hook for the group mode:
  140.      (add-hook 'gnus-group-mode-hook 'gnus-topic-mode)
  141. * Menu:
  142. * Topic Variables::    How to customize the topics the Lisp Way.
  143. * Topic Commands::     Interactive E-Z commands.
  144. * Topic Topology::     A map of the world.
  145. File: gnus,  Node: Topic Variables,  Next: Topic Commands,  Up: Group Topics
  146. Topic Variables
  147. ---------------
  148.    Now, if you select a topic, if will fold/unfold that topic, which is
  149. really neat, I think.
  150.    The topic lines themselves are created according to the
  151. `gnus-topic-line-format' variable.  *Note Formatting Variables::.
  152. Elements allowed are:
  153.      Indentation.
  154.      Topic name.
  155.      Visibility.
  156.      Level.
  157.      Number of groups in the topic.
  158.      Number of unread articles in the topic.
  159.      Number of unread articles in the topic and all its subtopics.
  160.    Each sub-topic (and the groups in the sub-topics) will be indented
  161. with `gnus-topic-indent-level' times the topic level number of spaces.
  162. The default is `2'.
  163.    `gnus-topic-mode-hook' is called in topic minor mode buffers.
  164. File: gnus,  Node: Topic Commands,  Next: Topic Topology,  Prev: Topic Variables,  Up: Group Topics
  165. Topic Commands
  166. --------------
  167.    When the topic minor mode is turned on, a new `T' submap will be
  168. available.  In addition, a few of the standard keys change their
  169. definitions slightly.
  170. `T n'
  171.      Prompt for a new topic name and create it
  172.      (`gnus-topic-create-topic').
  173. `T m'
  174.      Move the current group to some other topic
  175.      (`gnus-topic-move-group').  This command understands the
  176.      process/prefix convention (*note Process/Prefix::.).
  177. `T c'
  178.      Copy the current group to some other topic
  179.      (`gnus-topic-copy-group').  This command understands the
  180.      process/prefix convention (*note Process/Prefix::.).
  181. `T D'
  182.      Remove a group from the current topic (`gnus-topic-remove-group').
  183.      This command understands the process/prefix convention (*note
  184.      Process/Prefix::.).
  185. `T M'
  186.      Move all groups that match some regular expression to a topic
  187.      (`gnus-topic-move-matching').
  188. `T C'
  189.      Copy all groups that match some regular expression to a topic
  190.      (`gnus-topic-copy-matching').
  191. `T #'
  192.      Mark all groups in the current topic with the process mark
  193.      (`gnus-topic-mark-topic').
  194. `T M-#'
  195.      Remove the process mark from all groups in the current topic
  196.      (`gnus-topic-unmark-topic').
  197. `RET'
  198. `SPACE'
  199.      Either select a group or fold a topic (`gnus-topic-select-group').
  200.      When you perform this command on a group, you'll enter the group,
  201.      as usual.  When done on a topic line, the topic will be folded (if
  202.      it was visible) or unfolded (if it was folded already).  So it's
  203.      basically a toggling command on topics.  In addition, if you give
  204.      a numerical prefix, group on that level (and lower) will be
  205.      displayed.
  206. `T TAB'
  207.      "Indent" the current topic so that it becomes a sub-topic of the
  208.      previous topic (`gnus-topic-indent').  If given a prefix,
  209.      "un-indent" the topic instead.
  210. `C-k'
  211.      Kill a group or topic (`gnus-topic-kill-group').
  212. `C-y'
  213.      Yank the previously killed group or topic
  214.      (`gnus-topic-yank-group').  Note that all topics will be yanked
  215.      before all groups.
  216. `T r'
  217.      Rename a topic (`gnus-topic-rename').
  218. `T DEL'
  219.      Delete an empty topic (`gnus-topic-delete').
  220. `A T'
  221.      List all groups that Gnus knows about in a topics-ified way
  222.      (`gnus-topic-list-active').
  223. File: gnus,  Node: Topic Topology,  Prev: Topic Commands,  Up: Group Topics
  224. Topic Topology
  225. --------------
  226.    So, let's have a look at an example group buffer:
  227.      Gnus
  228.        Emacs -- I wuw it!
  229.             3: comp.emacs
  230.             2: alt.religion.emacs
  231.          Naughty Emacs
  232.           452: alt.sex.emacs
  233.             0: comp.talk.emacs.recovery
  234.        Misc
  235.             8: comp.binaries.fractals
  236.            13: comp.sources.unix
  237.    So, here we have one top-level topic, two topics under that, and one
  238. sub-topic under one of the sub-topics.  (There is always just one (1)
  239. top-level topic).  This topology can be expressed as follows:
  240.      (("Gnus" visible)
  241.       (("Emacs -- I wuw it!" visible)
  242.        (("Naughty Emacs" visible)))
  243.       (("Misc" visible)))
  244.    This is in fact how the variable `gnus-topic-topology' would look
  245. for the display above.  That variable is saved in the `.newsrc.eld'
  246. file, and shouldn't be messed with manually--unless you really want to.
  247. Since this variable is read from the `.newsrc.eld' file, setting it in
  248. any other startup files will have no effect.
  249.    This topology shows what topics are sub-topics of what topics
  250. (right), and which topics are visible.  Two settings are currently
  251. allowed--`visible' and `invisible'.
  252. File: gnus,  Node: Misc Group Stuff,  Prev: Group Topics,  Up: The Group Buffer
  253. Misc Group Stuff
  254. ================
  255. * Menu:
  256. * Scanning New Messages:: Asking Gnus to see whether new messages have arrived.
  257. * Group Information::     Information and help on groups and Gnus.
  258. * File Commands::         Reading and writing the Gnus files.
  259.      Enter the server buffer (`gnus-group-enter-server-mode'). *Note
  260.      The Server Buffer::.
  261.      Post an article to a group (`gnus-group-post-news').  The current
  262.      group name will be used as the default.
  263.      Mail a message somewhere (`gnus-group-mail').
  264.    Variables for the group buffer:
  265. `gnus-group-mode-hook'
  266.      `gnus-group-mode-hook' is called after the group buffer has been
  267.      created.
  268. `gnus-group-prepare-hook'
  269.      `gnus-group-prepare-hook' is called after the group buffer is
  270.      generated.  It may be used to modify the buffer in some strange,
  271.      unnatural way.
  272. `gnus-permanently-visible-groups'
  273.      Groups matching this regexp will always be listed in the group
  274.      buffer, whether they are empty or not.
  275. File: gnus,  Node: Scanning New Messages,  Next: Group Information,  Up: Misc Group Stuff
  276. Scanning New Messages
  277. ---------------------
  278.      Check the server(s) for new articles.  If the numerical prefix is
  279.      used, this command will check only groups of level ARG and lower
  280.      (`gnus-group-get-new-news').  If given a non-numerical prefix, this
  281.      command will force a total rereading of the active file(s) from the
  282.      backend(s).
  283. `M-g'
  284.      Check whether new articles have arrived in the current group
  285.      (`gnus-group-get-new-news-this-group').  The
  286.      `gnus-goto-next-group-when-activating' variable controls whether
  287.      this command is to move point to the next group or not.  It is `t'
  288.      by default.
  289. `C-c M-g'
  290.      Activate absolutely all groups (`gnus-activate-all-groups').
  291.      Restart Gnus (`gnus-group-restart').
  292.    `gnus-get-new-news-hook' is run just before checking for new news.
  293.    `gnus-after-getting-new-news-hook' is run after checking for new
  294. news.
  295. File: gnus,  Node: Group Information,  Next: File Commands,  Prev: Scanning New Messages,  Up: Misc Group Stuff
  296. Group Information
  297. -----------------
  298. `M-f'
  299.      Try to fetch the FAQ for the current group
  300.      (`gnus-group-fetch-faq').  Gnus will try to get the FAQ from
  301.      `gnus-group-faq-directory', which is usually a directory on a
  302.      remote machine.  `ange-ftp' will be used for fetching the file.
  303.      Describe the current group (`gnus-group-describe-group').  If given
  304.      a prefix, force Gnus to re-read the description from the server.
  305. `M-d'
  306.      Describe all groups (`gnus-group-describe-all-groups').  If given a
  307.      prefix, force Gnus to re-read the description file from the server.
  308.      Display current Gnus version numbers (`gnus-version').
  309.      Give a very short help message (`gnus-group-describe-briefly').
  310. `C-c C-i'
  311.      Go to the Gnus info node (`gnus-info-find-node').
  312. File: gnus,  Node: File Commands,  Prev: Group Information,  Up: Misc Group Stuff
  313. File Commands
  314. -------------
  315.      Read the init file (`gnus-init-file', which defaults to `~/.gnus')
  316.      (`gnus-group-read-init-file').
  317.      Save the `.newsrc.eld' file (and `.newsrc' if wanted)
  318.      (`gnus-group-save-newsrc').  If given a prefix, force saving the
  319.      file(s) whether Gnus thinks it is necessary or not.
  320. File: gnus,  Node: The Summary Buffer,  Next: The Article Buffer,  Prev: The Group Buffer,  Up: Top
  321. The Summary Buffer
  322. ******************
  323.    A line for each article is displayed in the summary buffer.  You can
  324. move around, read articles, post articles and reply to articles.
  325. * Menu:
  326. * Summary Buffer Format::       Deciding how the summary buffer is to look.
  327. * Summary Maneuvering::         Moving around the summary buffer.
  328. * Choosing Articles::           Reading articles.
  329. * Paging the Article::          Scrolling the current article.
  330. * Reply Followup and Post::     Posting articles.
  331. * Canceling and Superseding::   "Whoops, I shouldn't have called him that."
  332. * Marking Articles::            Marking articles as read, expirable, etc.
  333. * Limiting::                    You can limit the summary buffer.
  334. * Threading::                   How threads are made.
  335. * Sorting::                     How articles and threads are sorted.
  336. * Asynchronous Fetching::       Gnus might be able to pre-fetch articles.
  337. * Article Caching::             You may store articles in a cache.
  338. * Persistent Articles::         Making articles expiry-resistant.
  339. * Article Backlog::             Having already read articles hang around.
  340. * Saving Articles::             Ways of customizing article saving.
  341. * Decoding Articles::           Gnus can treat series of (uu)encoded articles.
  342. * Article Treatment::           The article buffer can be mangled at will.
  343. * Summary Sorting::             Sorting the summary buffer in various ways.
  344. * Finding the Parent::          No child support? Get the parent.
  345. * Alternative Approaches::      Reading using non-default summaries.
  346. * Tree Display::                A more visual display of threads.
  347. * Mail Group Commands::         Some commands can only be used in mail groups.
  348. * Various Summary Stuff::       What didn't fit anywhere else.
  349. * Exiting the Summary Buffer::  Returning to the Group buffer.
  350. File: gnus,  Node: Summary Buffer Format,  Next: Summary Maneuvering,  Up: The Summary Buffer
  351. Summary Buffer Format
  352. =====================
  353. * Menu:
  354. * Summary Buffer Lines::     You can specify how summary lines should look.
  355. * Summary Buffer Mode Line:: You can say how the mode line should look.
  356. * Summary Highlighting::     Making the summary buffer all pretty and nice.
  357.    Gnus will use the value of the `gnus-extract-address-components'
  358. variable as a function for getting the name and address parts of a
  359. `From' header.  Two pre-defined function exist:
  360. `gnus-extract-address-components', which is the default, quite fast,
  361. and too simplistic solution; and `mail-extract-address-components',
  362. which works very nicely, but is slower.  The default function will
  363. return the wrong answer in 5% of the cases.  If this is unacceptable to
  364. you, use the other function instead.
  365.    `gnus-summary-same-subject' is a string indicating that the current
  366. article has the same subject as the previous.  This string will be used
  367. with those specs that require it.  The default is `'.
  368. File: gnus,  Node: Summary Buffer Lines,  Next: Summary Buffer Mode Line,  Up: Summary Buffer Format
  369. Summary Buffer Lines
  370. --------------------
  371.    You can change the format of the lines in the summary buffer by
  372. changing the `gnus-summary-line-format' variable.  It works along the
  373. same lines a a normal `format' string, with some extensions.
  374.    The default string is `%U%R%z%I%(%[%4L: %-20,20n%]%) %s\n'.
  375.    The following format specification characters are understood:
  376.      Article number.
  377.      Subject string.
  378.      Subject if the article is the root, `gnus-summary-same-subject'
  379.      otherwise.
  380.      Full `From' line.
  381.      The name (from the `From' header).
  382.      The name (from the `From' header).  This differs from the `n' spec
  383.      in that it uses `gnus-extract-address-components', which is
  384.      slower, but may be more thorough.
  385.      The address (from the `From' header).  This works the same way as
  386.      the `a' spec.
  387.      Number of lines in the article.
  388.      Number of characters in the article.
  389.      Indentation based on thread level (*note Customizing Threading::.).
  390.      Nothing if the article is a root and lots of spaces if it isn't (it
  391.      pushes everything after it off the screen).
  392.      Opening bracket, which is normally `\[', but can also be `<' for
  393.      adopted articles.
  394.      Closing bracket, which is normally `\]', but can also be `>' for
  395.      adopted articles.
  396.      One space for each thread level.
  397.      Twenty minus thread level spaces.
  398.      Unread.
  399.      Replied.
  400.      Score as a number.
  401.      Zcore, `+' if above the default level and `-' if below the default
  402.      level.  If the difference between `gnus-summary-default-level' and
  403.      the score is less than `gnus-summary-zcore-fuzz', this spec will
  404.      not be used.
  405.      Total thread score.
  406.      `Xref'.
  407.      `Date'.
  408.      `Message-ID'.
  409.      `References'.
  410.      Number of articles in the current sub-thread.  Using this spec
  411.      will slow down summary buffer generation somewhat.
  412.      A single character will be displayed if the article has any
  413.      children.
  414.      User defined specifier.  The next character in the format string
  415.      should be a letter.  GNUS will call the function
  416.      `gnus-user-format-function-'`X', where `X' is the letter following
  417.      `%u'.  The function will be passed the current header as argument.
  418.      The function should return a string, which will be inserted into
  419.      the summary just like information from any other summary specifier.
  420.    The `%U' (status), `%R' (replied) and `%z' (zcore) specs have to be
  421. handled with care.  For reasons of efficiency, Gnus will compute what
  422. column these characters will end up in, and "hard-code" that.  This
  423. means that it is illegal to have these specs after a variable-length
  424. spec.  Well, you might not be arrested, but your summary buffer will
  425. look strange, which is bad enough.
  426.    The smart choice is to have these specs as far to the left as
  427. possible.  (Isn't that the case with everything, though?  But I
  428. digress.)
  429.    This restriction may disappear in later versions of Gnus.
  430. File: gnus,  Node: Summary Buffer Mode Line,  Next: Summary Highlighting,  Prev: Summary Buffer Lines,  Up: Summary Buffer Format
  431. Summary Buffer Mode Line
  432. ------------------------
  433.    You can also change the format of the summary mode bar.  Set
  434. `gnus-summary-mode-line-format' to whatever you like.  Here are the
  435. elements you can play with:
  436.      Group name.
  437.      Unprefixed group name.
  438.      Current article number.
  439.      Gnus version.
  440.      Number of unread articles in this group.
  441.      Number of unselected articles in this group.
  442.      A string with the number of unread and unselected articles
  443.      represented either as `<%U(+%u) more>' if there are both unread
  444.      and unselected articles, and just as `<%U more>' if there are just
  445.      unread articles and no unselected ones.
  446.      Shortish group name.  For instance, `rec.arts.anime' will be
  447.      shortened to `r.a.anime'.
  448.      Subject of the current article.
  449.      Used-defined spec.
  450.      Name of the current score file.
  451.      Number of dormant articles.
  452.      Number of ticked articles.
  453.      Number of articles that have been marked as read in this session.
  454.      Number of articles expunged by the score files.
  455. File: gnus,  Node: Summary Highlighting,  Prev: Summary Buffer Mode Line,  Up: Summary Buffer Format
  456. Summary Highlighting
  457. --------------------
  458. `gnus-visual-mark-article-hook'
  459.      This hook is run after selecting an article.  It is meant to be
  460.      used for highlighting the article in some way.  It is not run if
  461.      `gnus-visual' is `nil'.
  462. `gnus-summary-update-hook'
  463.      This hook is called when a summary line is changed.  It is not run
  464.      if `gnus-visual' is `nil'.
  465. `gnus-summary-selected-face'
  466.      This is the face (or "font" as some people call it) that is used to
  467.      highlight the current article in the summary buffer.
  468. `gnus-summary-highlight'
  469.      Summary lines are highlighted according to this variable, which is
  470.      a list where the elements are on the format `(FORM . FACE)'.  If
  471.      you would, for instance, like ticked articles to be italic and
  472.      high-scored articles to be bold, you could set this variable to
  473.      something like
  474.           (((eq mark gnus-ticked-mark) . italic)
  475.            ((> score default) . bold))
  476.      As you may have guessed, if FORM returns a non-`nil' value, FACE
  477.      will be applied to the line.
  478. File: gnus,  Node: Summary Maneuvering,  Next: Choosing Articles,  Prev: Summary Buffer Format,  Up: The Summary Buffer
  479. Summary Maneuvering
  480. ===================
  481.    All the straight movement commands understand the numeric prefix and
  482. behave pretty much as you'd expect.
  483.    None of these commands select articles.
  484. `G M-n'
  485. `M-n'
  486.      Go to the next summary line of an unread article
  487.      (`gnus-summary-next-unread-subject').
  488. `G M-p'
  489. `M-p'
  490.      Go to the previous summary line of an unread article
  491.      (`gnus-summary-prev-unread-subject').
  492. `G j'
  493.      Ask for an article number and then go that article
  494.      (`gnus-summary-goto-article').
  495. `G g'
  496.      Ask for an article number and then go the summary line of that
  497.      article (`gnus-summary-goto-subject').
  498.    If Gnus asks you to press a key to confirm going to the next group,
  499. you can use the `C-n' and `C-p' keys to move around the group buffer,
  500. searching for the next group to read without actually returning to the
  501. group buffer.
  502.    Variables related to summary movement:
  503. `gnus-auto-select-next'
  504.      If you are at the end of the group and issue one of the movement
  505.      commands, Gnus will offer to go to the next group.  If this
  506.      variable is `t' and the next group is empty, Gnus will exit
  507.      summary mode and return to the group buffer.  If this variable is
  508.      neither `t' nor `nil', Gnus will select the next group, no matter
  509.      whether it has any unread articles or not.  As a special case, if
  510.      this variable is `quietly', Gnus will select the next group
  511.      without asking for confirmation.  If this variable is
  512.      `almost-quietly', the same will happen only if you are located on
  513.      the last article in the group.  Finally, if this variable is
  514.      `slightly-quietly', the `Z n' command will go to the next group
  515.      without confirmation.  Also *note Group Levels::..
  516. `gnus-auto-select-same'
  517.      If non-`nil', all the movement commands will try to go to the next
  518.      article with the same subject as the current.  This variable is not
  519.      particularly useful if you use a threaded display.
  520. `gnus-summary-check-current'
  521.      If non-`nil', all the "unread" movement commands will not proceed
  522.      to the next (or previous) article if the current article is unread.
  523.      Instead, they will choose the current article.
  524. `gnus-auto-center-summary'
  525.      If non-`nil', Gnus will keep the point in the summary buffer
  526.      centered at all times.  This makes things quite tidy, but if you
  527.      have a slow network connection, or simply do not like this
  528.      un-Emacsism, you can set this variable to `nil' to get the normal
  529.      Emacs scrolling action.  This will also inhibit horizontal
  530.      re-centering of the summary buffer, which might make it more
  531.      inconvenient to read extremely long threads.
  532. File: gnus,  Node: Choosing Articles,  Next: Paging the Article,  Prev: Summary Maneuvering,  Up: The Summary Buffer
  533. Choosing Articles
  534. =================
  535.    None of the following movement commands understand the numeric
  536. prefix, and they all select and display an article.
  537. `SPACE'
  538.      Select the current article, or, if that one's read already, the
  539.      next unread article (`gnus-summary-next-page').
  540. `G n'
  541.      Go to next unread article (`gnus-summary-next-unread-article').
  542. `G p'
  543.      Go to previous unread article (`gnus-summary-prev-unread-article').
  544. `G N'
  545.      Go to the next article (`gnus-summary-next-article').
  546. `G P'
  547.      Go to the previous article (`gnus-summary-prev-article').
  548. `G C-n'
  549.      Go to the next article with the same subject
  550.      (`gnus-summary-next-same-subject').
  551. `G C-p'
  552.      Go to the previous article with the same subject
  553.      (`gnus-summary-prev-same-subject').
  554. `G f'
  555.      Go to the first unread article
  556.      (`gnus-summary-first-unread-article').
  557. `G b'
  558.      Go to the article with the highest score
  559.      (`gnus-summary-best-unread-article').
  560. `G l'
  561.      Go to the previous article read (`gnus-summary-goto-last-article').
  562. `G p'
  563.      Pop an article off the summary history and go to this article
  564.      (`gnus-summary-pop-article').  This command differs from the
  565.      command above in that you can pop as many previous articles off the
  566.      history as you like.
  567.    Some variables that are relevant for moving and selecting articles:
  568. `gnus-auto-extend-newsgroup'
  569.      All the movement commands will try to go to the previous (or next)
  570.      article, even if that article isn't displayed in the Summary
  571.      buffer if this variable is non-`nil'.  Gnus will then fetch the
  572.      article from the server and display it in the article buffer.
  573. `gnus-select-article-hook'
  574.      This hook is called whenever an article is selected.  By default it
  575.      exposes any threads hidden under the selected article.
  576. `gnus-mark-article-hook'
  577.      This hook is called whenever an article is selected.  It is
  578.      intended to be used for marking articles as read.  The default
  579.      value is `gnus-summary-mark-read-and-unread-as-read', and will
  580.      change the mark of almost any article you read to
  581.      `gnus-unread-mark'.  The only articles not affected by this
  582.      function are ticked, dormant, and expirable articles.  If you'd
  583.      instead like to just have unread articles marked as read, you can
  584.      use `gnus-summary-mark-unread-as-read' instead.  It will leave
  585.      marks like `gnus-low-score-mark', `gnus-del-mark' (and so on)
  586.      alone.
  587. File: gnus,  Node: Paging the Article,  Next: Reply Followup and Post,  Prev: Choosing Articles,  Up: The Summary Buffer
  588. Scrolling the Article
  589. =====================
  590. `SPACE'
  591.      Pressing `SPACE' will scroll the current article forward one page,
  592.      or, if you have come to the end of the current article, will
  593.      choose the next article (`gnus-summary-next-page').
  594. `DEL'
  595.      Scroll the current article back one page
  596.      (`gnus-summary-prev-page').
  597. `RET'
  598.      Scroll the current article one line forward
  599.      (`gnus-summary-scroll-up').
  600. `A g'
  601.      (Re)fetch the current article (`gnus-summary-show-article').  If
  602.      given a prefix, fetch the current article, but don't run any of the
  603.      article treatment functions.  This will give you a "raw" article,
  604.      just the way it came from the server.
  605. `A <'
  606.      Scroll to the beginning of the article
  607.      (`gnus-summary-beginning-of-article').
  608. `A >'
  609.      Scroll to the end of the article (`gnus-summary-end-of-article').
  610. `A s'
  611.      Perform an isearch in the article buffer
  612.      (`gnus-summary-isearch-article').
  613. File: gnus,  Node: Reply Followup and Post,  Next: Canceling and Superseding,  Prev: Paging the Article,  Up: The Summary Buffer
  614. Reply, Followup and Post
  615. ========================
  616. * Menu:
  617. * Summary Mail Commands::            Sending mail.
  618. * Summary Post Commands::            Sending news.
  619. File: gnus,  Node: Summary Mail Commands,  Next: Summary Post Commands,  Up: Reply Followup and Post
  620. Summary Mail Commands
  621. ---------------------
  622.    Commands for composing a mail message:
  623. `S r'
  624.      Mail a reply to the author of the current article
  625.      (`gnus-summary-reply').
  626. `S R'
  627.      Mail a reply to the author of the current article and include the
  628.      original message (`gnus-summary-reply-with-original').  This
  629.      command uses the process/prefix convention.
  630. `S o m'
  631.      Forward the current article to some other person
  632.      (`gnus-summary-mail-forward').
  633. `S o p'
  634.      Forward the current article to a newsgroup
  635.      (`gnus-summary-post-forward').
  636. `S m'
  637.      Send a mail to some other person
  638.      (`gnus-summary-mail-other-window').
  639. `S D b'
  640.      If you have sent a mail, but the mail was bounced back to you for
  641.      some reason (wrong address, transient failure), you can use this
  642.      command to resend that bounced mail
  643.      (`gnus-summary-resend-bounced-mail').  You will be popped into a
  644.      mail buffer where you can edit the headers before sending the mail
  645.      off again.  If you give a prefix to this command, and the bounced
  646.      mail is a reply to some other mail, Gnus will try to fetch that
  647.      mail and display it for easy perusal of its headers.  This might
  648.      very well fail, though.
  649. `S D r'
  650.      Not to be confused with the previous command,
  651.      `gnus-summary-resend-message' will prompt you for an address to
  652.      send the current message off to, and then send it to that place.
  653.      The headers of the message won't be altered--but lots of headers
  654.      that say `Resent-To', `Resent-From' and so on will be added.  This
  655.      means that you actually send a mail to someone that has a `To'
  656.      header that (probably) points to yourself.  This will confuse
  657.      people.  So, natcherly you'll only do that if you're really eVIl.
  658.      This command is mainly used if you have several accounts and want
  659.      to ship a mail to a different account of yours.  (If you're both
  660.      `root' and `postmaster' and get a mail for `postmaster' to the
  661.      `root' account, you may want to resend it to `postmaster'.
  662.      Ordnung muss sein!
  663. `S O m'
  664.      Digest the current series and forward the result using mail
  665.      (`gnus-uu-digest-mail-forward').  This command uses the
  666.      process/prefix convention (*note Process/Prefix::.).
  667. `S O p'
  668.      Digest the current series and forward the result to a newsgroup
  669.      (`gnus-uu-digest-mail-forward').
  670. File: gnus,  Node: Summary Post Commands,  Prev: Summary Mail Commands,  Up: Reply Followup and Post
  671. Summary Post Commands
  672. ---------------------
  673.    Commands for posting an article:
  674. `S p'
  675.      Post an article to the current group (`gnus-summary-post-news').
  676. `S f'
  677.      Post a followup to the current article (`gnus-summary-followup').
  678. `S F'
  679.      Post a followup to the current article and include the original
  680.      message (`gnus-summary-followup-with-original').   This command
  681.      uses the process/prefix convention.
  682. `S u'
  683.      Uuencode a file, split it into parts, and post it as a series
  684.      (`gnus-uu-post-news'). (*note Uuencoding and Posting::.).
  685. File: gnus,  Node: Canceling and Superseding,  Next: Marking Articles,  Prev: Reply Followup and Post,  Up: The Summary Buffer
  686. Canceling Articles
  687. ==================
  688.    Have you ever written something, and then decided that you really,
  689. really, really wish you hadn't posted that?
  690.    Well, you can't cancel mail, but you can cancel posts.
  691.    Find the article you wish to cancel (you can only cancel your own
  692. articles, so don't try any funny stuff).  Then press `C' or `S c'
  693. (`gnus-summary-cancel-article').  Your article will be
  694. canceled--machines all over the world will be deleting your article.
  695.    Be aware, however, that not all sites honor cancels, so your article
  696. may live on here and there, while most sites will delete the article in
  697. question.
  698.    If you discover that you have made some mistakes and want to do some
  699. corrections, you can post a "superseding" article that will replace
  700. your original article.
  701.    Go to the original article and press `S s'
  702. (`gnus-summary-supersede-article').  You will be put in a buffer where
  703. you can edit the article all you want before sending it off the usual
  704.    The same goes for superseding as for canceling, only more so: Some
  705. sites do not honor superseding.  On those sites, it will appear that you
  706. have posted almost the same article twice.
  707.    If you have just posted the article, and change your mind right away,
  708. there is a trick you can use to cancel/supersede the article without
  709. waiting for the article to appear on your site first.  You simply return
  710. to the post buffer (which is called `*post-buf*').  There you will find
  711. the article you just posted, with all the headers intact.  Change the
  712. `Message-ID' header to a `Cancel' or `Supersedes' header by
  713. substituting one of those words for `Message-ID'.  Then just press `C-c
  714. C-c' to send the article as you would do normally.  The previous
  715. article will be canceled/superseded.
  716.    Just remember, kids: There is no 'c' in 'supersede'.
  717. File: gnus,  Node: Marking Articles,  Next: Limiting,  Prev: Canceling and Superseding,  Up: The Summary Buffer
  718. Marking Articles
  719. ================
  720.    There are several marks you can set on an article.
  721.    You have marks that decide the "readedness" (whoo, neato-keano
  722. neologism ohoy!) of the article.  Alphabetic marks generally mean
  723. "read", while non-alphabetic characters generally mean "unread".
  724.    In addition, you also have marks that do not affect readedness.
  725. * Menu:
  726. * Unread Articles::      Marks for unread articles.
  727. * Read Articles::        Marks for read articles.
  728. * Other Marks::          Marks that do not affect readedness.
  729.    There's a plethora of commands for manipulating these marks:
  730. * Menu:
  731. * Setting Marks::           How to set and remove marks.
  732. * Setting Process Marks::   How to mark articles for later processing.
  733. File: gnus,  Node: Unread Articles,  Next: Read Articles,  Up: Marking Articles
  734. Unread Articles
  735. ---------------
  736.    The following marks mark articles as unread, in one form or other.
  737.      "Ticked articles" are articles that will remain visible always.  If
  738.      you see an article that you find interesting, or you want to put
  739.      off reading it, or replying to it, until sometime later, you'd
  740.      typically tick it.  However, articles can be expired, so if you
  741.      want to keep an article forever, you'll have to save it.  Ticked
  742.      articles have a `!' (`gnus-ticked-mark') in the first column.
  743.      A "dormant" article is marked with a `?' (`gnus-dormant-mark'),
  744.      and will only appear in the summary buffer if there are followups
  745.      to it.
  746. `SPACE'
  747.      An "unread" article is marked with a `SPACE' (`gnus-unread-mark').
  748.      These are articles that haven't been read at all yet.
  749. File: gnus,  Node: Read Articles,  Next: Other Marks,  Prev: Unread Articles,  Up: Marking Articles
  750. Read Articles
  751. -------------
  752.    All the following marks mark articles as read.
  753.      Articles that are marked as read.  They have a `r'
  754.      (`gnus-del-mark') in the first column.  These are articles that the
  755.      user has marked as read more or less manually.
  756.      Articles that are actually read are marked with `R'
  757.      (`gnus-read-mark').
  758.      Articles that were marked as read in previous sessions are now
  759.      "old" and marked with `O' (`gnus-ancient-mark').
  760.      Marked as killed (`gnus-killed-mark').
  761.      Marked as killed by kill files (`gnus-kill-file-mark').
  762.      Marked as read by having a too low score (`gnus-low-score-mark').
  763.      Marked as read by a catchup (`gnus-catchup-mark').
  764.      Canceled article (`gnus-canceled-mark')
  765.      SOUPed article (`gnus-souped-mark').
  766.      Sparsely reffed article (`gnus-sparse-mark').
  767.    All these marks just mean that the article is marked as read, really.
  768. They are interpreted differently by the adaptive scoring scheme,
  769. however.
  770.    One more special mark, though:
  771.      You can also mark articles as "expirable" (or have them marked as
  772.      such automatically).  That doesn't make much sense in normal
  773.      groups, because a user does not control the expiring of news
  774.      articles, but in mail groups, for instance, articles that are
  775.      marked as "expirable" can be deleted by Gnus at any time.
  776.      Expirable articles are marked with `E' (`gnus-expirable-mark').
  777. File: gnus,  Node: Other Marks,  Next: Setting Marks,  Prev: Read Articles,  Up: Marking Articles
  778. Other Marks
  779. -----------
  780.    There are some marks that have nothing to do with whether the
  781. article is read or not.
  782.    * You can set a bookmark in the current article.  Say you are
  783.      reading a long thesis on cats' urinary tracts, and have to go home
  784.      for dinner before you've finished reading the thesis.  You can
  785.      then set a bookmark in the article, and Gnus will jump to this
  786.      bookmark the next time it encounters the article.
  787.    * All articles that you have replied to or made a followup to (i.e.,
  788.      have answered) will be marked with an `A' in the second column
  789.      (`gnus-replied-mark').
  790.    * Articles that are stored in the article cache will be marked with
  791.      an `*' in the second column (`gnus-cached-mark').
  792.    * Articles that are "saved" (in some manner or other; not necessarily
  793.      religiously) are marked with an `S' in the second column
  794.      (`gnus-saved-mark'.
  795.    * It the `%e' spec is used, the presence of threads or not will be
  796.      marked with `gnus-not-empty-thread-mark' and
  797.      `gnus-empty-thread-mark' in the third column, respectively.
  798.    * Finally we have the "process mark" (`gnus-process-mark'.  A
  799.      variety of commands react to the presence of the process mark.  For
  800.      instance, `X u' (`gnus-uu-decode-uu') will uudecode and view all
  801.      articles that have been marked with the process mark.  Articles
  802.      marked with the process mark have a `#' in the second column.
  803.    You might have noticed that most of these "non-readedness" marks
  804. appear in the second column by default.  So if you have a cached, saved,
  805. replied article that you have process-marked, what will that look like?
  806.    Nothing much.  The precedence rules go as follows: process -> cache
  807. -> replied -> saved.  So if the article is in the cache and is replied,
  808. you'll only see the cache mark and not the replied mark.
  809. File: gnus,  Node: Setting Marks,  Next: Setting Process Marks,  Prev: Other Marks,  Up: Marking Articles
  810. Setting Marks
  811. -------------
  812.    All the marking commands understand the numeric prefix.
  813. `M t'
  814.      Tick the current article (`gnus-summary-tick-article-forward').
  815. `M ?'
  816.      Mark the current article as dormant
  817.      (`gnus-summary-mark-as-dormant').
  818. `M d'
  819.      Mark the current article as read
  820.      (`gnus-summary-mark-as-read-forward').
  821. `M k'
  822.      Mark all articles that have the same subject as the current one as
  823.      read, and then select the next unread article
  824.      (`gnus-summary-kill-same-subject-and-select').
  825. `M K'
  826. `C-k'
  827.      Mark all articles that have the same subject as the current one as
  828.      read (`gnus-summary-kill-same-subject').
  829. `M C'
  830.      Mark all unread articles in the group as read
  831.      (`gnus-summary-catchup').
  832. `M C-c'
  833.      Mark all articles in the group as read--even the ticked and dormant
  834.      articles (`gnus-summary-catchup-all').
  835. `M H'
  836.      Catchup the current group to point
  837.      (`gnus-summary-catchup-to-here').
  838. `C-w'
  839.      Mark all articles between point and mark as read
  840.      (`gnus-summary-mark-region-as-read').
  841. `M V k'
  842.      Kill all articles with scores below the default score (or below the
  843.      numeric prefix) (`gnus-summary-kill-below').
  844. `M c'
  845. `M-u'
  846.      Clear all readedness-marks from the current article
  847.      (`gnus-summary-clear-mark-forward').
  848. `M e'
  849.      Mark the current article as expirable
  850.      (`gnus-summary-mark-as-expirable').
  851. `M b'
  852.      Set a bookmark in the current article
  853.      (`gnus-summary-set-bookmark').
  854. `M B'
  855.      Remove the bookmark from the current article
  856.      (`gnus-summary-remove-bookmark').
  857. `M V c'
  858.      Clear all marks from articles with scores over the default score
  859.      (or over the numeric prefix) (`gnus-summary-clear-above').
  860. `M V u'
  861.      Tick all articles with scores over the default score (or over the
  862.      numeric prefix) (`gnus-summary-tick-above').
  863. `M V m'
  864.      Prompt for a mark, and mark all articles with scores over the
  865.      default score (or over the numeric prefix) with this mark
  866.      (`gnus-summary-clear-above').
  867.    The `gnus-summary-goto-unread' variable controls what action should
  868. be taken after setting a mark.  If non-`nil', point will move to the
  869. next/previous unread article.  If `nil', point will just move one line
  870. up or down.  As a special case, if this variable is `never', all the
  871. marking commands as well as other commands (like `SPACE') will move to
  872. the next article, whether it is unread or not.  The default is `t'.
  873. File: gnus,  Node: Setting Process Marks,  Prev: Setting Marks,  Up: Marking Articles
  874. Setting Process Marks
  875. ---------------------
  876. `M P p'
  877.      Mark the current article with the process mark
  878.      (`gnus-summary-mark-as-processable').
  879. `M P u'
  880. `M-#'
  881.      Remove the process mark, if any, from the current article
  882.      (`gnus-summary-unmark-as-processable').
  883. `M P U'
  884.      Remove the process mark from all articles
  885.      (`gnus-summary-unmark-all-processable').
  886. `M P R'
  887.      Mark articles by a regular expression (`gnus-uu-mark-by-regexp').
  888. `M P r'
  889.      Mark articles in region (`gnus-uu-mark-region').
  890. `M P t'
  891.      Mark all articles in the current (sub)thread
  892.      (`gnus-uu-mark-thread').
  893. `M P T'
  894.      Unmark all articles in the current (sub)thread
  895.      (`gnus-uu-unmark-thread').
  896. `M P v'
  897.      Mark all articles that have a score above the prefix argument
  898.      (`gnus-uu-mark-over').
  899. `M P s'
  900.      Mark all articles in the current series (`gnus-uu-mark-series').
  901. `M P S'
  902.      Mark all series that have already had some articles marked
  903.      (`gnus-uu-mark-sparse').
  904. `M P a'
  905.      Mark all articles in series order (`gnus-uu-mark-series').
  906. `M P b'
  907.      Mark all articles in the buffer in the order they appear
  908.      (`gnus-uu-mark-buffer').
  909. File: gnus,  Node: Limiting,  Next: Threading,  Prev: Marking Articles,  Up: The Summary Buffer
  910. Limiting
  911. ========
  912.    It can be convenient to limit the summary buffer to just show some
  913. subset of the articles currently in the group.  The effect most limit
  914. commands have is to remove a few (or many) articles from the summary
  915. buffer.
  916. `/ /'
  917. `/ s'
  918.      Limit the summary buffer to articles that match some subject
  919.      (`gnus-summary-limit-to-subject').
  920. `/ a'
  921.      Limit the summary buffer to articles that match some author
  922.      (`gnus-summary-limit-to-author').
  923. `/ u'
  924.      Limit the summary buffer to articles that are not marked as read
  925.      (`gnus-summary-limit-to-unread').  If given a prefix, limit the
  926.      buffer to articles that are strictly unread.  This means that
  927.      ticked and dormant articles will also be excluded.
  928. `/ m'
  929.      Ask for a mark and then limit to all articles that have not been
  930.      marked with that mark (`gnus-summary-limit-to-marks').
  931. `/ n'
  932.      Limit the summary buffer to the current article
  933.      (`gnus-summary-limit-to-articles').  Uses the process/prefix
  934.      convention (*note Process/Prefix::.).
  935. `/ w'
  936.      Pop the previous limit off the stack and restore it
  937.      (`gnus-summary-pop-limit').  If given a prefix, pop all limits off
  938.      the stack.
  939. `/ v'
  940.      Limit the summary buffer to articles that have a score at or above
  941.      some score (`gnus-summary-limit-to-score').
  942. `/ E'
  943. `M S'
  944.      Display all expunged articles
  945.      (`gnus-summary-limit-include-expunged').
  946. `/ D'
  947.      Display all dormant articles
  948.      (`gnus-summary-limit-include-dormant').
  949. `/ d'
  950.      Hide all dormant articles (`gnus-summary-limit-exclude-dormant').
  951. `/ c'
  952.      Hide all dormant articles that have no children
  953.      (`gnus-summary-limit-exclude-childless-dormant').
  954. `/ C'
  955.      Mark all excluded unread articles as read
  956.      (`gnus-summary-limit-mark-excluded-as-read').   If given a prefix,
  957.      also mark excluded ticked and dormant articles as read.
  958. File: gnus,  Node: Threading,  Next: Sorting,  Prev: Limiting,  Up: The Summary Buffer
  959. Threading
  960. =========
  961.    Gnus threads articles by default.  "To thread" is to put replies to
  962. articles directly after the articles they reply to--in a hierarchical
  963. fashion.
  964. * Menu:
  965. * Customizing Threading::     Variables you can change to affect the threading.
  966. * Thread Commands::           Thread based commands in the summary buffer.
  967.