cgit.sxemacs.org Git - gnus/blob - etc/gnus-tut.txt

   1 From lars Thu Feb 23 23:20:38 1995
   2 From: larsi@gnus.org (ding)
   3 Date: Fri Feb 24 13:40:45 1995
   4 Subject: So you want to use the new Gnus
   5 Message-ID: <lars-doc1@eyesore.no>
   6
   7 Actually, since you are reading this, chances are you are already
   8 using the new Gnus.  Congratulations.
   9
  10 This entire newsgroup you are reading is, in fact, no real newsgroup
  11 at all, in the traditional sense.  It is an example of one of the
  12 "foreign" select methods that Gnus may use.
  13
  14 The text you are now reading is stored in the "etc" directory with the
  15 rest of the Emacs sources.  You are using the "nndoc" backend for
  16 accessing it.  Scary, isn't it?
  17
  18 This isn't the real documentation.  `M-x info', `m gnus <RET>' to read
  19 that.  This "newsgroup" is intended as a kinder, gentler way of getting
  20 people started.
  21
  22 Gnus is a rewrite of GNUS 4.1, written by Masanobu Umeda.  The rewrite
  23 was done by moi, yours truly, your humble servant, Lars Magne
  24 Ingebrigtsen.  If you have a WWW browser, you can investigate to your
  25 heart's delight at <URL:http://www.gnus.org/> and
  26 <URL:http://quimby.gnus.org/lmi/>.
  27
  28 ;; Copyright (C) 1995, 2001-2015 Free Software Foundation, Inc.
  29
  30 ;; Author: Lars Magne Ingebrigtsen <larsi@ifi.uio.no>
  31 ;; Keywords: news
  32
  33 ;; This file is part of GNU Emacs.
  34
  35 ;; GNU Emacs is free software: you can redistribute it and/or modify
  36 ;; it under the terms of the GNU General Public License as published by
  37 ;; the Free Software Foundation, either version 3 of the License, or
  38 ;; (at your option) any later version.
  39
  40 ;; GNU Emacs is distributed in the hope that it will be useful,
  41 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  42 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  43 ;; GNU General Public License for more details.
  44
  45 ;; You should have received a copy of the GNU General Public License
  46 ;; along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
  47
  48 From lars Thu Feb 23 23:20:38 1995
  49 From: larsi@gnus.org (ding)
  50 Date: Fri Feb 24 13:40:45 1995
  51 Subject: Starting up
  52 Message-ID: <lars-doc2@eyesore.no>
  53
  54 If you are having problems with Gnus not finding your server, you have
  55 to set `gnus-select-method'.  A "method" is a way of specifying *how*
  56 the news is to be found, and from *where*.
  57
  58 Say you want to read news from you local, friendly nntp server
  59 "news.my.local.server".
  60
  61 (setq gnus-select-method '(nntp "news.my.local.server"))
  62
  63 Quite easy, huh?
  64
  65 From the news spool:
  66
  67 (setq gnus-select-method '(nnspool ""))
  68
  69 From your mh-e spool:
  70
  71 (setq gnus-select-method '(nnmh ""))
  72
  73 There's a whole bunch of other methods for reading mail and news, see
  74 the "Foreign groups" article for that.
  75
  76
  77 From lars Thu Feb 23 23:20:38 1995
  78 From: larsi@gnus.org (ding)
  79 Date: Fri Feb 24 13:40:45 1995
  80 Subject: Where are all the groups, then?
  81 Message-ID: <lars-doc3@eyesore.no>
  82
  83 If this is the first time you have used a newsreader, you won't have a
  84 .newsrc file.  This means that Gnus will think that all the newsgroups
  85 on the server are "new", and kill them all.
  86
  87 If you have a .newsrc file, the new groups will be processed with the
  88 function in the `gnus-subscribe-newsgroup-method' variable, which is
  89 `gnus-subscribe-zombies' by default.
  90
  91 This means that all the groups have been made into "zombies" - not
  92 quite dead, but not exactly alive, either.
  93
  94 Jump back to the *Group* buffer, and type `A z' to list all the zombie
  95 groups.  Look though the list, and subscribe to the groups you want to
  96 read by pressing `u' on the one you think look interesting.
  97
  98 If all the groups have been killed, type `A k' to list all the killed
  99 groups.  Subscribe to them the same way.
 100
 101 When you are satisfied, press `S z' to kill all the zombie groups.
 102
 103 Now you should have a nice list of all groups you are interested in.
 104
 105 (If you later want to subscribe to more groups, press `A k' to
 106 list all the kill groups, and repeat.  You can also type `U' and be
 107 prompted for groups to subscribe to.)
 108
 109
 110 From lars Thu Feb 23 23:20:38 1995
 111 From: larsi@gnus.org (ding)
 112 Date: Fri Feb 24 13:40:45 1995
 113 Subject: I want to read my mail!
 114 Message-ID: <lars-doc4@eyesore.no>
 115
 116 Yes, Virginia, you can read mail with Gnus.
 117
 118 First you have to decide which mail backend you want to use.  You have
 119 nnml, which is a one-file-one-mail backend, which is quite nice, but
 120 apt to make your systems administrator go crazy and come after you
 121 with a shotgun.
 122
 123 nnmbox uses a Unix mail box to store mail.  Nice, but slow.
 124
 125 nnmh uses mh-e folders, which is also a one-file-one-mail thingie, but
 126 slower than nnml.  (It doesn't support NOV files.)
 127
 128 So if you want to go with nnmbox, you can simply say:
 129
 130 (setq gnus-secondary-select-methods '((nnmbox "")))
 131
 132 (The same for the other methods, kind of.)
 133
 134 You should also set `nnmail-split-methods' to something sensible:
 135
 136 (setq nnmail-split-methods
 137       '(("mail.junk" "From:.*Lars")
 138         ("mail.misc "")))
 139
 140 This will put all mail from me in you junk mail group, and the rest in
 141 "mail.misc".
 142
 143 These groups will be subscribe the same way as the normal groups, so
 144 you will probably find them among the zombie groups after you set
 145 these variables and re-start Gnus.
 146
 147
 148 From lars Thu Feb 23 23:20:38 1995
 149 From: larsi@gnus.org (ding)
 150 Date: Fri Feb 24 13:40:45 1995
 151 Subject: Foreign newsgroups
 152 Message-ID: <lars-doc5@eyesore.no>
 153
 154 These are groups that do not come from `gnus-select-method'.
 155