Mercurial > hg > xemacs-beta

comparison etc/BETA @ 134:34a5b81f86ba r20-2b1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import from CVS: tag r20-2b1
author cvs
date Mon, 13 Aug 2007 09:30:11 +0200
parents
children b980b6286996
comparison
equal deleted inserted replaced
133:b27e67717092 134:34a5b81f86ba
1 -*- mode:outline; minor-mode:outl-mouse -*-
2
3 * Introduction
4 ==============
5
6 You are running an experimental version of XEmacs. Please do not
7 report problems with Beta XEmacs to comp.emacs.xemacs. Report them to
8 xemacs-beta@xemacs.org.
9
10 ** XEmacs Beta Mailing List
11 ===========================
12
13 *** Subscribing
14 ---------------
15
16 If you are not subscribed to the XEmacs beta list you should be. Send
17 an email message with a subject of `subscribe' (without the quotes) to
18 xemacs-beta-request@xemacs.org and follow the directions. You do not
19 have to fill out the survey if you don't want to.
20
21 *** Unsubscribing
22 -----------------
23
24 To unsubscribe from the list send an email message with a subject of
25 `unsubscribe' (without the quotes) to xemacs-beta-request@xemacs.org.
26
27 *** Administrivia
28 -----------------
29
30 The XEmacs beta list is managed by the SmartList mailing list package,
31 and the usual SmartList commands work. Do not send mailing list
32 requests to the main address (xemacs-beta@xemacs.org), always send
33 them to xemacs-beta-request@xemacs.org. If you have problems with the
34 list itself, they should be brought to the attention of the Mailing
35 List manager Chuck Thompson <cthomp@xemacs.org>.
36
37
38 ** Beta Release Schedule
39 ========================
40
41 The URL ftp://ftp.xemacs.org/pub/beta/README always contains the best
42 estimate of when the next beta XEmacs will be released. For weekend
43 betas the release time is generally in the vicinity of 2PM to 5PM US
44 Pacific Time (Universal Time minus 8 hours). For weekday betas, the
45 release time is generally in the vicinity of 8PM to Midnight US
46 Pacific Time on the listed day.
47
48 While 19.15 and 20.x are in parallel development, a simultaneous
49 release day implies a release of 20.x first, followed a few hours
50 later by 19.15.
51
52 Betas are nominally a week apart, scheduled on every Saturday.
53 Midweek releases are made when a serious enough problem warrants it.
54
55
56 ** Reporting Problems
57 =====================
58
59 The best way to get problems fixed in XEmacs is to submit good problem
60 reports. Since this is beta software problems are certain to exist.
61 Please read through all of part II of the XEmacs FAQ for an overview
62 of problem reporting. Other items which are most important are:
63
64 1. Do not submit C stack backtraces without line numbers. Since it
65 is possible to compile optimized with debug information with GCC
66 it is never a good idea to compile XEmacs without the -g flag.
67 XEmacs runs on a variety of platforms, and often it is not
68 possible to recreate problems which afflict a specific platform.
69 The line numbers in the C stack backtrace help isolate where the
70 problem is actually occurring.
71
72 2. Attempt to recreate the problem starting with an invocation of
73 XEmacs with `xemacs -q -no-site-file'. Quite often problems are
74 due to package interdependencies, and the like. An actual bug in
75 XEmacs should be reproducible in a default configuration without
76 loading any special packages (or the one or two specific packages
77 that cause the bug to appear).
78
79 3. A picture can be worth a thousand words. When reporting an
80 unusual display, it is generally best to capture the problem in a
81 screen dump and include that with the problem report. The easiest
82 way to get a screen dump is to use the xv program and its grab
83 function. Save the image as a GIF to keep bandwidth requirements
84 down without loss of information. MIME is the preferred method
85 for making the image attachments.
86
87 * Compiling Beta XEmacs
88 =======================
89
90 ** Building an XEmacs from patches
91 ==================================
92
93 All beta releases of XEmacs are included with patches from the
94 previous version in an attempt to keep bandwidth requirements down.
95 Patches should be applied with the GNU patch program in something like
96 the following. Let's say you're upgrading XEmacs 20.4-beta10 to
97 XEmacs 20.4-beta11 and you have a full unmodified XEmacs 20.4-beta10
98 source tree to work with. Cd to the top level directory and issue the
99 shell command:
100
101 $ gunzip -c /tmp/xemacs-20.4-b10-20.4-b11.patch.gz | patch -p1
102
103 After patching check to see that no patches were missed by doing
104 $ find . -name \*.rej -print
105
106 Any rejections should be treated as serious problems to be resolved
107 before starting compilation.
108
109 After seeing that there were no rejections, issue the command
110
111 $ make all-elc
112
113 and go play minesweep for awhile on an older XEmacs while the binary
114 is rebuilt.
115
116 ** Building an XEmacs from a full distribution
117 ==============================================
118
119 Locate a convenient place where you have at least 100MB of free space
120 and issue the command
121
122 $ gunzip -c /tmp/xemacs-20.4-b11.tar.gz | tar xvf -
123
124 (or the simpler `tar zxvf /tmp/xemacs-20.4-b11.tar.gz' if you use GNU
125 tar).
126
127 cd to the top level directory and issue an appropriate configure
128 command. The maintainer uses the following at the time of this
129 writing:
130
131 ./configure --with-offix --with-mule=yes --with-dialogs=athena3d \
132 --cflags="-m486 -g -O4 -fno-strength-reduce -malign-loops=2 \
133 -malign-jumps=2 -malign-functions=2" --with-sound=no \
134 --with-xface=yes --error-checking=all --debug=yes \
135 --with-scrollbars=athena3d \
136 --with-canna=yes --with-wnn=yes --wnn-includes=/usr/X11R6/include/wnn
137
138 Save the output from configure that looks something like:
139 Configured for `i586-unknown-linux2.0.28'.
140
141 Where should the build process find the source code? /usr/src/xemacs-20.0
142 What installation prefix should install use? /usr/local
143 What operating system and machine description files should XEmacs use?
144 `s/linux.h' and `m/intel386.h'
145 What compiler should XEmacs be built with? gcc -m486 -g -O4 -fno-strength-reduce -malign-loops=2 -malign-jumps=2 -malign-functions=2
146 Should XEmacs use the GNU version of malloc? yes
147 Should XEmacs use the relocating allocator for buffers? yes
148 What window system should XEmacs use? x11
149 Where do we find X Windows header files? /usr/X11R6/include
150 Where do we find X Windows libraries? /usr/X11R6/lib
151 Compiling in support for XAUTH.
152 Compiling in support for XPM.
153 Compiling in support for X-Face headers.
154 Compiling in support for GIF image conversion.
155 Compiling in support for JPEG image conversion.
156 Compiling in support for PNG image conversion.
157 Compiling in support for Berkeley DB.
158 Compiling in support for GNU DBM.
159 Compiling in Mule (multi-lingual) support.
160 Compiling in support for OffiX.
161 Using the Lucid menubar.
162 Using the Athena-3d scrollbar.
163 Using the Athena-3d dialog boxes.
164
165 Then type make and you should have a working XEmacs.
166
167 After you have verified that you have a functional editor, fire up
168 your favorite mail program and send a build report to
169 xemacs-beta@xemacs.org. The build report should include
170
171 1. Your hardware configuration (OS version, etc.)
172
173 2. Version numbers of software in use (X11 version, system library
174 versions if appropriate, graphics library versions if appropriate).
175 If you're on a system like Linux, include all the version numbers
176 you can because chances are it makes a difference.
177
178 3. The options given to configure
179
180 4. The configuration report illustrated above
181
182 5. Any other unusual items you feel should be brought to the attention
183 of the developers.