819acea4d228a78a0568b7b9f3e8f9ee0eafa724
[elisp/gnus.git-] / README.semi
1 This package contains T-gnus 6.15.
2
3 What is T-gnus?
4 ===============
5
6   T-gnus is an improvement of Gnus with SEMI's MIME feature. T-gnus
7 6.15 is based on Oort Gnus v0.16. SEMI may stand for "SEMI is Emacs
8 MIME Interface" and is developped to provide an easy interfaces for
9 users to handle MIME message structures. For further information,
10 refer to REASME.en of SEMI.
11
12   It requires APEL, FLIM and SEMI packages, so please get and install
13 them before to install it.  T-gnus 6.15 requires APEL 10.0 or later,
14 FLIM 1.14 and SEMI 1.14.  You can get these packages from:
15
16 ftp://ftp.m17n.org/pub/mule/apel/
17 ftp://ftp.m17n.org/pub/mule/flim/flim-1.14/
18 ftp://ftp.m17n.org/pub/mule/semi/semi-1.14-for-flim-1.14/
19
20 Required environment for SEMI is written in README.en of SEMI package.
21
22   In addition, if you wish to use the web based backend `nnshimbun',
23 you have to install the package emacs-w3m and the external command w3m.
24 Visit the following pages for more information.
25
26 http://emacs-w3m.namazu.org/
27 http://ei5nazha.yz.yamagata-u.ac.jp/~aito/w3m/
28
29
30 How to get? (via CVS)
31 =====================
32
33 (0) cvs login (first time only)
34
35     % cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/root login
36
37     CVS password: [CR] # NULL string
38
39 (1) checkout
40
41     % cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/root \
42         checkout -r t-gnus-6_15-quimby gnus
43
44 (2) compile
45
46     % cd gnus
47     % configure [options]
48     % make [options]
49
50 (3) update
51
52     % cvs update -r t-gnus-6_15-quimby gnus
53
54 Major tags are following:
55
56     t-gnus-6_15-quimby  Assigned to the latest version of T-gnus for
57                         developing and synchronizing with Oort Gnus.
58
59     t-gnus-6_15         Assigned to the latest version of T-gnus for
60                         developing and synchronizing with the released
61                         version of Oort Gnus.
62
63     pgnus-ichikawa      The main trunk of T-gnus.
64
65     semi-gnus           Assigned to the latest stable version.  It is
66                         very conservative. Currently it is not used.
67
68     for-semi-N1_N2      assigned to the latest stable version for SEMI
69                         API N1.N2 (N1 and N2 are natural number).
70                         (e.g. `for-semi-1_3' is for SEMI API 1.3)
71
72     gnus-N1_N2_N3       assigned to gnus(Gnus) N1.N2.N3
73                         (e.g. `gnus-6_2_1' means gnus 6.2.1).
74
75     larsi               Original Gnus
76
77     himi                himi branch
78
79     akr                 akr branch
80
81     shuhei-k            shuhei-k branch
82                         Mail-Followup-To/Mail-Reply-To, gnus-cache fix.
83
84     keiichi             keiichi branch
85     nana-gnus-N1_N2     Stable version of `keiichi branch'.
86
87 For more detailed information, please read README.branch.
88
89
90 How to get? (via ftp)
91 =====================
92
93   T-gnus 6.15 is available from
94
95     ftp://ftp.jpl.org/pub/elisp/t-gnus-6.15/snapshots/
96
97   NOTE: These snapshots are manually created when the urge takes the
98   administrator of the a-ftp site, and will usually not be tested.
99
100
101 How to join development
102 =======================
103
104   If you have found a bug in Gnus proper, please do `M-x gnus-bug' and
105 send a bug report to the Gnus maintainers.
106
107   If you have found a bug in T-gnus, or if you're not sure whether it
108 is a Gnus proper, please send a bug report to the Semi-gnus mailing
109 list:
110
111     semi-gnus-en@meadowy.org    (English)
112     semi-gnus-ja@meadowy.org    (Japanese)
113
114 Suggestions for T-gnus improvements are also welcome.
115
116   Via the Semi-gnus ML, you can report T-gnus related bugs, obtain the
117 latest release of T-gnus, and discuss future enhancements to T-gnus.
118 To join the Semi-gnus ML, send an empty e-mail to
119
120     semi-gnus-en-help@meadowy.org       (English)
121     semi-gnus-ja-help@meadowy.org       (Japanese)
122
123   In addition, we need developers.  If you would like to develop it,
124 please send mail to cvs@cvs.m17n.org with your account name and your
125 public key for ssh.  cvsroot is :ext:cvs@cvs.m17n.org:/cvs/root.
126 If you cannot use ssh, please send UNIX /etc/passwd style crypted
127 password instead.  cvsroot is
128 :pserver:<accountname>@cvs.m17n.org:/cvs/root in this case.  You can
129 get the notice of modifications in m17n open CVS server via the mail
130 which also contains informations on the other modules.  To subscribe
131 it, send an empty e-mail to
132
133     cvs-info-help@cvs.m17n.org