Synch to Oort Gnus.
[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 T-gnus
84 ==============
85
86 There are three ways of making T-gnus with Mule 2.3 based on Emacs 19.34.
87
88 1. If you have installed EMU, APEL, CLIME and SEMI packages under the
89    standard load-path, for instance:
90
91    EMU:   /usr/local/share/mule/19.34/site-lisp/
92    APEL:  /usr/local/share/mule/site-lisp/apel/
93    CLIME: /usr/local/share/mule/site-lisp/flim/
94    SEMI:  /usr/local/share/mule/site-lisp/semi/
95
96    What is more, if you have been replaced old CUSTOM with new CUSTOM
97    or if you have installed new CUSTOM directly under the standard
98    load-path as such as /usr/local/share/mule/19.34/site-lisp/, you
99    may have nothing to be done; type the following commands right now.
100
101    % ./configure --with-emacs=mule
102    % make install
103
104    However, if you have installed new CUSTOM in the subdirectory under
105    the standard load-path, use the configure option `--with-addpath='
106    as follows:
107
108    % ./configure --with-emacs=mule\
109      --with-addpath=/usr/local/share/mule/site-lisp/custom/
110    % make install
111
112    or you can use the file subdirs.el under the parent directory of
113    the subdirectory of CUSTOM to add it into load-path which contain
114    the following contents:
115
116    (normal-top-level-add-to-load-path
117     '("custom/" "and the other subdirectories.../"))
118
119    and then just type:
120
121    % ./configure --with-emacs=mule
122    % make install
123
124 2. If you have installed EMU, APEL, CLIME and SEMI packages in the
125    non-standard load-path, use the configure option `--with-addpath='
126    with the colon separated directory names where EMU, APEL or CUSTOM
127    packages are installed.  For example:
128
129    % ./configure --with-emacs=mule\
130      --with-addpath=~/elisp/emu/:~/elisp/apel/:~/elisp/custom/
131    % make install
132
133    In this case, you have no need to add paths of CLIME, SEMI if they
134    are installed under the directory which is same as the parent
135    directory of APEL.
136
137 3. This is another way to install T-gnus when you have installed EMU,
138    APEL, CLIME and SEMI packages in the non-standard load-path.  Copy
139    the file `sample.lpath.el' which is included in the distribution to
140    `~/.lpath.el' and modify it suitably for your environment.  And
141    then type the following command.
142
143    % ./configure --with-emacs=mule
144    % make install
145
146
147 USING emacs-w3m (and Emacs/W3)
148 ==============================
149 The web based backend `nnshimbun' uses the shimbun modules which are
150 included in emacs-w3m package (and the other web based backends of T-
151 gnus requires Emacs/W3).  emacs-w3m is an interface program to the
152 external command w3m, visit the following pages for more information.
153
154    http://emacs-w3m.namazu.org/
155    http://ei5nazha.yz.yamagata-u.ac.jp/~aito/w3m/
156
157 If you wish to build T-gnus to be able to use emacs-w3m and nnshimbun,
158 you have to specify the path where emacs-w3m is installed using the
159 configure option `--with-addpath=' (for Emacs/W3, use the configure
160 option `--with-w3=' or editing the file `~/.lpath.el').  Here is an
161 example for that:
162
163    % ./configure --with-emacs=mule\
164      --with-addpath=~/elisp/emu/:~/elisp/apel/: ... :~/elisp/w3m/\
165      --with-w3=/usr/local/share/mule/site-lisp/w3/
166    % make install
167
168 ;; Don't mind if configure says "W3... not found".  It is currently
169 ;; malfunction when the configure option `--with-w3=' is not used even
170 ;; if the path of Emacs/W3 is specified in the file `~/.lpath.el'.
171
172 ;; By the way, does anyone know where do we find Emacs/W3 package
173 ;; which is suitable to Mule 2.3 based on Emacs 19.34?