*** empty log message ***
[gnus] / readme
1 This package contains a pre-release of (ding) Gnus, version 0.x. The
2 lisp directory contains the source lisp files, and the texi directory
3 contains an early draft of the Gnus info pages.
4
5 Gnus is meant to be totally compatible with GNUS. But, alas, it
6 probably isn't, which is one of the reasons for this pre-release. 
7
8 To use (ding) Gnus you first have to unpack the files, which you've
9 obviously done, because you are reading this. 
10
11 You should definitely byte-compile the source files. To do that, you
12 can simply say "gmake" in this directory. (You have to use GNU's make.) 
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 "~/dgnus/lisp") load-path))
18
19 in your .emacs file, or wherever you keep such things.
20
21 Note that (ding) Gnus and GNUS can not coexist in a single Emacs. They
22 both use the same function and variable names. If you have been
23 running GNUS in your Emacs, you should probably exit that Emacs and
24 start a new one to fire up Gnus.
25
26 (ding) Gnus does absolutely not work with Emacs 18, and only shakily
27 with Emacs 19s before 19.26. So you definitely need a newish Emacs. 
28
29 Then you do a `M-x gnus', and everything should... uhm... it should
30 work, but it might not. Set `debug-on-error' to t, and mail me the
31 backtraces, or, better yet, find out why Gnus does something wrong,
32 fix it, and send me the diffs. :-)
33
34 There are three main things I want your help and input on:
35
36 1) Startup. Does eveything go smoothly, and why not?
37
38 2) Any errors while you read news normally?
39
40 3) Any errors if you do anything abnormal?
41
42 4) Features you do not like, or do like, but would like to tweak a
43    bit, and features you would like to see.
44
45 You do not have to send me typo corrections for the info pages. They
46 are a very rough first draft - I haven't even read through it,
47 although they should document all of Gnus, I think.
48
49 I think I have implemented most of the deep-going changes that I'm
50 going to. Things that will probably come in the future, but I haven't
51 gotten around to yet is asynchronous posting/pre-fetch of headers and
52 articles, better digest handling, a hierarchal Newsgroup buffer, and a
53 few other things that I can't think of at the moment.
54
55 Send any comments and all your bug fixes/complaints to
56 `larsi@ifi.uio.no'.