Synch with 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, FLIM, SEMI/WEMI
39 =====================================
40
41 T-gnus requires the latest version of CUSTOM, APEL, FLIM and SEMI or
42 WEMI; you should install these packages before installing T-gnus.
43
44 As for CUSTOM, you should apply the following patch before building it.
45
46 ------ cut here ------ cut here ------ cut here ------ cut here ------
47 --- custom-1.9962/cus-face.el~  Wed Mar  4 19:52:39 1998
48 +++ custom-1.9962/cus-face.el   Mon Mar  9 08:05:33 1998
49 @@ -96,7 +96,7 @@
50        "Define a new FACE on all frames, ignoring X resources."
51        (interactive "SMake face: ")
52        (or (internal-find-face name)
53 -         (let ((face (make-vector 8 nil)))
54 +         (let ((face (make-vector face-vector-length nil)))
55             (aset face 0 'face)
56             (aset face 1 name)
57             (let* ((frames (frame-list))
58 ------ cut here ------ cut here ------ cut here ------ cut here ------
59
60 By the way, the latest CUSTOM package for Emacs v19 is available from:
61
62 ftp://ftp.dina.kvl.dk/pub/Staff/Per.Abrahamsen/custom/custom-1.9962.tar.gz
63
64
65 INSTALL regexp-opt.el
66 =====================
67
68 Some T-gnus modules use the functions `regexp-opt', etc.  That
69 functions are defined in regexp-opt.el(c) in the recent Emacsen,
70 however, Mule 2.3 does not contain it in the standard Lisp libraries.
71 Copy the file contrib/regexp-opt.el to site-lisp directory (or any
72 other directory), and byte-compile it as follows:
73
74    % cp -p contrib/regexp-opt.el /usr/local/share/mule/site-lisp
75    % cd /usr/local/share/mule/site-lisp/
76    % mule -batch -q -no-site-file -f batch-byte-compile regexp-opt.el
77
78
79 INSTALL T-gnus
80 ==============
81
82 There are three ways of making T-gnus with Mule 2.3 based on Emacs 19.34.
83
84 1. If you have installed EMU, APEL, FLIM and SEMI or WEMI packages
85    under the standard load-path, for instance:
86
87    EMU:  /usr/local/share/mule/19.34/site-lisp/
88    APEL: /usr/local/share/mule/site-lisp/apel/
89    FLIM: /usr/local/share/mule/site-lisp/flim/
90    SEMI: /usr/local/share/mule/site-lisp/semi/
91
92    What is more, if you have been replaced old CUSTOM with new CUSTOM
93    or if you have installed new CUSTOM directly under the standard
94    load-path as such as /usr/local/share/mule/19.34/site-lisp/, you
95    may have nothing to be done; type the following commands right now.
96
97    % ./configure --with-emacs=mule
98    % make install
99
100    However, if you have installed new CUSTOM in the subdirectory under
101    the standard load-path, use the configure option `--with-addpath='
102    as follows:
103
104    % ./configure --with-emacs=mule\
105      --with-addpath=/usr/local/share/mule/site-lisp/custom/
106    % make install
107
108    or you can use the file subdirs.el under the parent directory of
109    the subdirectory of CUSTOM to add it into load-path which contain
110    the following contents:
111
112    (normal-top-level-add-to-load-path
113     '("custom/" "and the other subdirectories.../"))
114
115    and then just type:
116
117    % ./configure --with-emacs=mule
118    % make install
119
120 2. If you have installed EMU, APEL, FLIM and SEMI or WEMI packages in
121    the non-standard load-path, use the configure option
122    `--with-addpath=' with the colon separated directory names where
123    EMU, APEL or CUSTOM packages are installed.  For example:
124
125    % ./configure --with-emacs=mule\
126      --with-addpath=~/elisp/emu/:~/elisp/apel/:~/elisp/custom/
127    % make install
128
129    In this case, you have no need to add paths of FLIM, SEMI or WEMI
130    if they are installed under the directory which is same as the
131    parent directory of APEL.
132
133 3. This is another way to install T-gnus when you have installed EMU,
134    APEL, FLIM and SEMI or WEMI packages in the non-standard load-path.
135    Copy the file `sample.lpath.el' which is included in the
136    distribution to `~/.lpath.el' and modify it suitably for your
137    environment.  And then type the following command.
138
139    % ./configure --with-emacs=mule
140    % make install
141
142
143 USING emacs-w3m (and Emacs/W3)
144 ==============================
145 The web based backend `nnshimbun' uses the shimbun modules which are
146 included in emacs-w3m package (and the other web based backends of T-
147 gnus requires Emacs/W3).  emacs-w3m is an interface program to the
148 external command w3m, visit the following pages for more information.
149
150    http://emacs-w3m.namazu.org/
151    http://ei5nazha.yz.yamagata-u.ac.jp/~aito/w3m/
152
153 If you wish to build T-gnus to be able to use emacs-w3m and nnshimbun,
154 you have to specify the path where emacs-w3m is installed using the
155 configure option `--with-addpath=' (for Emacs/W3, use the configure
156 option `--with-w3=' or editing the file `~/.lpath.el').  Here is an
157 example for that:
158
159    % ./configure --with-emacs=mule\
160      --with-addpath=~/elisp/emu/:~/elisp/apel/: ... :~/elisp/w3m/\
161      --with-w3=/usr/local/share/mule/site-lisp/w3/
162    % make install
163
164 ;; Don't mind if configure says "W3... not found".  It is currently
165 ;; malfunction when the configure option `--with-w3=' is not used even
166 ;; if the path of Emacs/W3 is specified in the file `~/.lpath.el'.
167
168 ;; By the way, does anyone know where do we find Emacs/W3 package
169 ;; which is suitable to Mule 2.3 based on Emacs 19.34?