Synch to Gnus 200311092140.
[elisp/gnus.git-] / Mule23@1934.en
1 How to build T-gnus with Mule 2.3 based on Emacs 19.34.
2
3 FIXING loaddefs.el
4 ==================
5
6 Unfortunately, some variables for `message' are predefined in lisp/
7 loaddefs.el which is dumped in Mule executable file.  It is uninvited,
8 moreover, it has a bad influence.  So you should remove these
9 definitions from lisp/loaddefs.el and rebuild Mule.  However, if you
10 don't want to rebuild Mule, you may put the following lines in the
11 beginning of .emacs file instead of rebuilding Mule.
12
13 (let ((symbols '(citation-line-function
14                  cite-function courtesy-message default-headers
15                  default-mail-headers default-news-headers
16                  deletable-headers fcc-handler-function
17                  followup-to-function from-style
18                  generate-headers-first generate-new-buffers
19                  ignored-bounced-headers ignored-cited-headers
20                  ignored-mail-headers ignored-news-headers
21                  ignored-resent-headers ignored-supersedes-headers
22                  included-forward-headers indent-citation-function
23                  interactive kill-buffer-on-exit post-method
24                  reply-to-function required-mail-headers
25                  required-news-headers send-mail-function
26                  send-news-function signature
27                  signature-before-forwarded-message signature-file
28                  signature-separator syntax-checks use-followup-to
29                  user-organization-file wide-reply-to-function
30                  yank-prefix))
31       symbol)
32   (while symbols
33     (setq symbol (car symbols)
34           symbols (cdr symbol))
35     (makunbound (intern (format "message-%s" symbol)))))
36
37
38 INSTALL CUSTOM, APEL, CLIME, SEMI
39 =================================
40
41 T-gnus requires the latest version of CUSTOM, APEL, CLIME and SEMI;
42 CLIME 1.14 provides the same features as FLIM 1.14 for old Emacsen,
43 which is currently available from:
44
45 ftp://ftp.jpl.org/pub/m17n/clime-1_14-************.tar.gz
46
47 You should install these packages before installing T-gnus.  As for
48 CUSTOM, you should apply the following patch before building it.
49
50 ------ cut here ------ cut here ------ cut here ------ cut here ------
51 --- custom-1.9962/cus-face.el~  Wed Mar  4 19:52:39 1998
52 +++ custom-1.9962/cus-face.el   Mon Mar  9 08:05:33 1998
53 @@ -96,7 +96,7 @@
54        "Define a new FACE on all frames, ignoring X resources."
55        (interactive "SMake face: ")
56        (or (internal-find-face name)
57 -         (let ((face (make-vector 8 nil)))
58 +         (let ((face (make-vector face-vector-length nil)))
59             (aset face 0 'face)
60             (aset face 1 name)
61             (let* ((frames (frame-list))
62 ------ cut here ------ cut here ------ cut here ------ cut here ------
63
64 By the way, the latest CUSTOM package for Emacs v19 is available from:
65
66 ftp://ftp.dina.kvl.dk/pub/Staff/Per.Abrahamsen/custom/custom-1.9962.tar.gz
67
68
69 INSTALL regexp-opt.el
70 =====================
71
72 Some T-gnus modules use the functions `regexp-opt', etc.  That
73 functions are defined in regexp-opt.el(c) in the recent Emacsen,
74 however, Mule 2.3 does not contain it in the standard Lisp libraries.
75 Copy the file contrib/regexp-opt.el to site-lisp directory (or any
76 other directory), and byte-compile it as follows:
77
78    % cp -p contrib/regexp-opt.el /usr/local/share/mule/site-lisp
79    % cd /usr/local/share/mule/site-lisp/
80    % mule -batch -q -no-site-file -f batch-byte-compile regexp-opt.el
81
82
83 INSTALL passwd.el
84 =================
85
86 This module provide the `read-passwd' function.  You have to install
87 it if you don't have that function.  To do this:
88
89    % cp -p contrib/passwd.el /usr/local/share/mule/site-lisp
90    % cd /usr/local/share/mule/site-lisp/
91    % mule -batch -q -no-site-file -f batch-byte-compile passwd.el
92
93 And add the following line in your .emacs file:
94
95    (autoload 'read-passwd "passwd")
96
97
98 INSTALL T-gnus
99 ==============
100
101 There are three ways of making T-gnus with Mule 2.3 based on Emacs 19.34.
102
103 1. If you have installed EMU, APEL, CLIME and SEMI packages under the
104    standard load-path, for instance:
105
106    EMU:   /usr/local/share/mule/19.34/site-lisp/
107    APEL:  /usr/local/share/mule/site-lisp/apel/
108    CLIME: /usr/local/share/mule/site-lisp/flim/
109    SEMI:  /usr/local/share/mule/site-lisp/semi/
110
111    What is more, if you have been replaced old CUSTOM with new CUSTOM
112    or if you have installed new CUSTOM directly under the standard
113    load-path as such as /usr/local/share/mule/19.34/site-lisp/, you
114    may have nothing to be done; type the following commands right now.
115
116    % ./configure --with-emacs=mule
117    % make install
118
119    However, if you have installed new CUSTOM in the subdirectory under
120    the standard load-path, use the configure option `--with-addpath='
121    as follows:
122
123    % ./configure --with-emacs=mule\
124      --with-addpath=/usr/local/share/mule/site-lisp/custom/
125    % make install
126
127    or you can use the file subdirs.el under the parent directory of
128    the subdirectory of CUSTOM to add it into load-path which contain
129    the following contents:
130
131    (normal-top-level-add-to-load-path
132     '("custom/" "and the other subdirectories.../"))
133
134    and then just type:
135
136    % ./configure --with-emacs=mule
137    % make install
138
139 2. If you have installed EMU, APEL, CLIME and SEMI packages in the
140    non-standard load-path, use the configure option `--with-addpath='
141    with the colon separated directory names where EMU, APEL or CUSTOM
142    packages are installed.  For example:
143
144    % ./configure --with-emacs=mule\
145      --with-addpath=~/elisp/emu/:~/elisp/apel/:~/elisp/custom/
146    % make install
147
148    In this case, you have no need to add paths of CLIME, SEMI if they
149    are installed under the directory which is same as the parent
150    directory of APEL.
151
152 3. This is another way to install T-gnus when you have installed EMU,
153    APEL, CLIME and SEMI packages in the non-standard load-path.  Copy
154    the file `sample.lpath.el' which is included in the distribution to
155    `~/.lpath.el' and modify it suitably for your environment.  And
156    then type the following command.
157
158    % ./configure --with-emacs=mule
159    % make install
160
161
162 USING emacs-w3m (and Emacs/W3)
163 ==============================
164 The `nnshimbun' web based back end has been moved to the emacs-w3m
165 package at 18 June 2003.  You need to install the latest version of
166 emacs-w3m if you want to browse web newspapers using T-gnus as before.
167 In that case, you *must* delete nnshimbun.el and nnshimbun.elc files
168 originated by T-gnus.  Emacs-w3m is an Emacs interface to the external
169 command w3m, visit the following pages for more information:
170
171    http://emacs-w3m.namazu.org/
172    http://w3m.sourceforge.net/
173
174 Please give up the idea to use Emacs/W3 under Mule 2.3.  There is no
175 information, sorry.