*** empty log message ***
[gnus] / readme
1 This package contains an alpha version of Gnus.  The lisp directory
2 contains the source lisp files, and the texi directory contains a
3 draft of the Gnus info pages.
4
5 To use Gnus you first have to unpack the files, which you've obviously
6 done, because you are reading this.
7
8 You should definitely byte-compile the source files. To do that, you
9 can simply say "make" in this directory.  If you are using XEmacs, you
10 *must* say "make EMACS=xemacs".  If you use XEmacs 19.13 (or earlier)
11 you should rename "lisp/x-easymenu.el" to "lisp/easymenu.el".  Ignore
12 all error messages you get when byte-compiling under XEmacs.
13
14 Then you have to tell Emacs where Gnus is. You might put something
15 like
16
17    (setq load-path (cons (expand-file-name "~/gnus-5.0/lisp") load-path))
18
19 in your .emacs file, or wherever you keep such things.  (Note that
20 "~/gnus-5.0/lisp" won't be right if you have pulled down version 5.1)
21
22 Note that Gnus and GNUS can't coexist in a single Emacs. They both use
23 the same function and variable names. If you have been running GNUS in
24 your Emacs, you should probably exit that Emacs and start a new one to
25 fire up Gnus.
26
27 Gnus does absolutely not work with Emacs 18, and only shakily with
28 Emacs 19s before 19.26. So you definitely need a newish Emacs.
29
30 Then you do a `M-x gnus', and everything should... uhm... it should
31 work, but it might not. Set `debug-on-error' to t, and mail me the
32 backtraces, or, better yet, find out why Gnus does something wrong,
33 fix it, and send me the diffs. :-)
34
35 There are three main things I want your help and input on:
36
37 1) Startup. Does eveything go smoothly, and why not?
38
39 2) Any errors while you read news normally?
40
41 3) Any errors if you do anything abnormal?
42
43 4) Features you do not like, or do like, but would like to tweak a
44    bit, and features you would like to see.
45
46 Send any comments and all your bug fixes/complaints to
47 `gnus-bug@ifi.uio.no'.