T-gnus 6.16.6 revision 00.
[elisp/gnus.git-] / README.semi
index e1c4535..e1cb3af 100644 (file)
-This package contains Semi-gnus.
+This package contains T-gnus 6.16.
 
-What is Semi-gnus?
-==================
+What is T-gnus?
+===============
 
-  Semi-gnus is a replacement of Gnus with gnus-mime for SEMI.  It has
-all features of Gnus and gnus-mime, so there are no need to install
-Gnus to use it, and you must not use gnus-mime for SEMI.
+  T-gnus is an improvement of Gnus with SEMI's MIME feature. T-gnus
+6.16 is based on Gnus v5.10.  SEMI may stand for "SEMI is Emacs MIME
+Interface" and is developped to provide an easy interfaces for users
+to handle MIME message structures. For further information, refer to
+README.en of SEMI.
 
-  It requires SEMI package, so please get and install SEMI package
-before to install it.
+  It requires APEL, FLIM and SEMI packages, so please get and install
+them before to install it.  T-gnus 6.16 requires APEL 10.0 or later,
+FLIM 1.14 and SEMI 1.14.  You can get these packages from:
 
+ftp://ftp.m17n.org/pub/mule/apel/
+ftp://ftp.m17n.org/pub/mule/flim/flim-1.14/
+ftp://ftp.m17n.org/pub/mule/semi/semi-1.14-for-flim-1.14/
 
-How to get?
-===========
+Required environment for SEMI is written in README.en of SEMI package.
 
-(0) cvs login
+  In addition, if you wish to use the web based backend `nnshimbun',
+you have to install the package emacs-w3m and the external command w3m.
+Visit the following pages for more information.
 
-    % cvs -d :pserver:anonymous@chamonix.jaist.ac.jp:/hare/cvs/root \
-       login
+http://emacs-w3m.namazu.org/
+http://ei5nazha.yz.yamagata-u.ac.jp/~aito/w3m/
+
+
+How to get? (via CVS)
+=====================
+
+(0) cvs login (first time only)
+
+    % cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/root login
 
     CVS password: [CR] # NULL string
 
 (1) checkout
 
-    Please do following in a directory to extract (ex. site-lisp):
-
-    % cvs -d :pserver:anonymous@chamonix.jaist.ac.jp:/hare/cvs/root \
-       checkout -r semi-gnus gnus
+    % cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/root \
+       checkout -r t-gnus-6_16-quimby gnus
 
 (2) compile
 
-    ;; as same as Gnus
-
     % cd gnus
-
-    % make EMACS=<file name of your emacs>
+    % configure [options]
+    % make [options]
 
 (3) update
 
-    Please do following in your Open gnus directory:
+    % cvs update -r t-gnus-6_16-quimby gnus
+
+Major tags are following:
+
+    t-gnus-6_16-quimby Assigned to the latest version of T-gnus for
+                       developing and synchronizing with Gnus.
+
+    t-gnus-6_16                Assigned to the latest version of T-gnus for
+                       developing and synchronizing with the released
+                       version of Gnus.
+
+    pgnus-ichikawa     The main trunk of T-gnus.
 
-    % cvs update -r semi-gnus
+    semi-gnus          Assigned to the latest stable version.  It is
+                       very conservative. Currently it is not used.
 
+    for-semi-N1_N2     assigned to the latest stable version for SEMI
+                       API N1.N2 (N1 and N2 are natural number).
+                       (e.g. `for-semi-1_3' is for SEMI API 1.3)
 
-  (semi-)daily snapshot is also available from
+    gnus-N1_N2_N3      assigned to gnus(Gnus) N1.N2.N3
+                       (e.g. `gnus-6_2_1' means gnus 6.2.1).
 
-    ftp://ftp.jaist.ac.jp/pub/GNU/elisp/semi-gnus/
+    larsi              Original Gnus
 
-  Note that this snapshot is automatically created from our repository
-and will usually not be tested, and may not even work.
+    himi               himi branch
+
+    akr                        akr branch
+
+    shuhei-k           shuhei-k branch
+                       Mail-Followup-To/Mail-Reply-To, gnus-cache fix.
+
+    keiichi            keiichi branch
+    nana-gnus-N1_N2    Stable version of `keiichi branch'.
+
+For more detailed information, please read README.branch.
+
+
+How to get? (via ftp)
+=====================
+
+  T-gnus 6.16 is available from
+
+    ftp://ftp.jpl.org/pub/elisp/t-gnus-6.16/snapshots/
+
+  NOTE: These snapshots are manually created when the urge takes the
+  administrator of the a-ftp site, and will usually not be tested.
 
 
 How to join development
 =======================
 
-  If you write bug-reports and/or suggestions for improvement, please
-send them to the Semi-gnus mailing list:
+  If you have found a bug in Gnus proper, please do `M-x gnus-bug' and
+send a bug report to the Gnus maintainers.
+
+  If you have found a bug in T-gnus, or if you're not sure whether it
+is a Gnus proper, please send a bug report to the Semi-gnus mailing
+list:
+
+    semi-gnus-en@meadowy.org   (English)
+    semi-gnus-ja@meadowy.org   (Japanese)
 
-    semi-gnus-en@meadow.scphys.kyoto-u.ac.jp   (English)
-    semi-gnus-ja@meadow.scphys.kyoto-u.ac.jp   (Japanese)
+Suggestions for T-gnus improvements are also welcome.
 
-  Via the Semi-gnus ML, you can report Semi-gnus related bugs, obtain
-the latest release of Semi-gnus, and discuss future enhancements to
-Semi-gnus.  To join the Semi-gnus ML, send an empty e-mail to
+  Via the Semi-gnus ML, you can report T-gnus related bugs, obtain the
+latest release of T-gnus, and discuss future enhancements to T-gnus.
+To join the Semi-gnus ML, send an empty e-mail to
 
-    semi-gnus-en-help@meadow.scphys.kyoto-u.ac.jp      (English)
-    semi-gnus-ja-help@meadow.scphys.kyoto-u.ac.jp      (Japanese)
+    semi-gnus-en-help@meadowy.org      (English)
+    semi-gnus-ja-help@meadowy.org      (Japanese)
 
   In addition, we need developers.  If you would like to develop it,
-please send mail to cvs@chamonix.jaist.ac.jp.
+please send mail to cvs@cvs.m17n.org with your account name and your
+public key for ssh.  cvsroot is :ext:cvs@cvs.m17n.org:/cvs/root.
+If you cannot use ssh, please send UNIX /etc/passwd style crypted
+password instead.  cvsroot is
+:pserver:<accountname>@cvs.m17n.org:/cvs/root in this case.  You can
+get the notice of modifications in m17n open CVS server via the mail
+which also contains informations on the other modules.  To subscribe
+it, send an empty e-mail to
+
+    cvs-info-help@cvs.m17n.org