CVS update: REMOVED: xemacs/etc BETA
20 years, 1 month
CVS Monitor
CVS Monitor
User: ben
Date: 05/01/31 21:15:38
Removed: xemacs/etc BETA
Log:
Remove BETA; moved to man/beta.texi
- 1 participants
- 0 comments
CVS update: MODIFIED: os-utils ...
20 years, 1 month
CVS Monitor
CVS Monitor
User: viteno
Date: 05/01/31 21:11:54
Modified: packages/xemacs-packages/os-utils ChangeLog Makefile
Log:
Increment VERSION in Makefile
Revision Changes Path
1.52 +4 -0 XEmacs/packages/xemacs-packages/os-utils/ChangeLog
(In the diff below, changes in quantity of whitespace are not shown.)
Index: ChangeLog
===================================================================
RCS file: /pack/xemacscvs/XEmacs/packages/xemacs-packages/os-utils/ChangeLog,v
retrieving revision 1.51
retrieving revision 1.52
diff -u -b -r1.51 -r1.52
--- ChangeLog 2005/01/30 14:40:06 1.51
+++ ChangeLog 2005/01/31 20:11:52 1.52
＠＠ -1,3 +1,7 ＠＠
+2005-01-31 Norbert Koch <viteno(a)xemacs.org>
+
+ * Makefile (VERSION): XEmacs package 1.36 released.
+
2005-01-29 Ville Skyttä <scop(a)xemacs.org>
* os-utils.texi: Spelling fixes, add document title.
1.41 +1 -1 XEmacs/packages/xemacs-packages/os-utils/Makefile
(In the diff below, changes in quantity of whitespace are not shown.)
Index: Makefile
===================================================================
RCS file: /pack/xemacscvs/XEmacs/packages/xemacs-packages/os-utils/Makefile,v
retrieving revision 1.40
retrieving revision 1.41
diff -u -b -r1.40 -r1.41
--- Makefile 2004/01/13 06:16:21 1.40
+++ Makefile 2005/01/31 20:11:52 1.41
＠＠ -19,7 +19,7 ＠＠
# This XEmacs package contains independent single file lisp packages
-VERSION = 1.35
+VERSION = 1.36
AUTHOR_VERSION =
MAINTAINER = XEmacs Development Team <xemacs-beta(a)xemacs.org>
PACKAGE = os-utils
- 1 participants
- 0 comments
CVS update: MODIFIED: mule-ucs ...
20 years, 1 month
CVS Monitor
CVS Monitor
User: viteno
Date: 05/01/31 21:11:07
Modified: packages/mule-packages/mule-ucs ChangeLog Makefile
Log:
Increment VERSION in Makefile
Revision Changes Path
1.21 +4 -0 XEmacs/packages/mule-packages/mule-ucs/ChangeLog
(In the diff below, changes in quantity of whitespace are not shown.)
Index: ChangeLog
===================================================================
RCS file: /pack/xemacscvs/XEmacs/packages/mule-packages/mule-ucs/ChangeLog,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -b -r1.20 -r1.21
--- ChangeLog 2005/01/30 18:43:07 1.20
+++ ChangeLog 2005/01/31 20:11:07 1.21
＠＠ -1,3 +1,7 ＠＠
+2005-01-31 Norbert Koch <viteno(a)xemacs.org>
+
+ * Makefile (VERSION): XEmacs package 1.07 released.
+
2005-01-30 Adrian Aichner <adrian(a)xemacs.org>
* doc/mule-ucs.texi (Configuration): Quote utf-8 in code sample.
1.20 +1 -1 XEmacs/packages/mule-packages/mule-ucs/Makefile
(In the diff below, changes in quantity of whitespace are not shown.)
Index: Makefile
===================================================================
RCS file: /pack/xemacscvs/XEmacs/packages/mule-packages/mule-ucs/Makefile,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -b -r1.19 -r1.20
--- Makefile 2004/06/21 18:22:00 1.19
+++ Makefile 2005/01/31 20:11:07 1.20
＠＠ -17,7 +17,7 ＠＠
# the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
# Boston, MA 02111-1307, USA.
-VERSION = 1.06
+VERSION = 1.07
AUTHOR_VERSION = 0.84
MAINTAINER = Stephen J. Turnbull <stephen(a)xemacs.org>
PACKAGE = mule-ucs
- 1 participants
- 0 comments
CVS update: MODIFIED: packages ...
20 years, 1 month
CVS Monitor
CVS Monitor
User: viteno
Date: 05/01/31 21:09:29
Modified: packages ChangeLog
Log:
Package release
Revision Changes Path
1.488 +4 -0 XEmacs/packages/ChangeLog
(In the diff below, changes in quantity of whitespace are not shown.)
Index: ChangeLog
===================================================================
RCS file: /pack/xemacscvs/XEmacs/packages/ChangeLog,v
retrieving revision 1.487
retrieving revision 1.488
diff -u -b -r1.487 -r1.488
--- ChangeLog 2005/01/23 14:03:54 1.487
+++ ChangeLog 2005/01/31 20:09:29 1.488
＠＠ -1,3 +1,7 ＠＠
+2005-01-31 Norbert Koch <viteno(a)xemacs.org>
+
+ * Packages released: mule-ucs os-utils.
+
2005-01-23 Norbert Koch <viteno(a)xemacs.org>
* Packages released: ispell pcomplete.
- 1 participants
- 0 comments
CVS update: MODIFIED: nt ...
20 years, 1 month
CVS Monitor
CVS Monitor
User: ben
Date: 05/01/31 21:08:52
Modified: xemacs/nt ChangeLog xemacs.mak
Added: xemacs/man beta.texi
Removed: xemacs/etc CHARSETS CODINGS COPYING.LIB DEBUG DISTRIB FTP
GNU LPF MACHINES MAILINGLISTS MORE.STUFF MOTIVATION
ORDERS ORDERS.EUROPE ORDERS.JAPAN PACKAGES
README.HYPERBOLE README.OO-BROWSER SERVICE TERMS
aliases.ksh check_cygwin_setup.sh chr.png chrm.png
gnu.xbm gnu.xpm ms-kermit ms-kermit-7bit sink.xbm
Log:
Documentation updates
GETTING.GNU.SOFTWARE, Makefile.in.in: Delete GETTING.GNU.SOFTWARE from SOURCES.
PROBLEMS: Delete reference to check_cygwin_setup.sh.
Delete stuff that is irrelevant, mislocated or woefully out-of-date.
GNU, SERVICE: Delete.
* ORDERS, ORDERS.EUROPE, ORDERS.JAPAN: Delete.
* CHARSETS, CODINGS: Delete.
* DEBUG, LPF, MORE.STUFF, MOTIVATION: Delete.
aliases.ksh: Delete. (moved to xemacs-builds/steve)
* README.HYPERBOLE, README.OO-BROWSER: Delete.
* chr.png, chrm.png: Move to photos/.
check_cygwin_setup.sh: Delete.
* gnu.xpm, gnu.xbm, sink.xbm: Delete.
* ms-kermit, ms-kermit-7bit: Delete.
TERMS: Delete.
* DISTRIB, FTP, MACHINES, MAILINGLISTS, PACKAGES:
Delete and move to FAQ.
BETA: Delete and move to man/beta.texi.
README: Update.
help.el: Removed.
xemacs/help.texi: Delete references to DISTRIB. Point to FAQ.
xemacs/new.texi: Update sample code for version checking.
xemacs/xemacs.texi: Delete references to DISTRIB. Point directly to web site.
Update stuff referring to GNU Emacs. Delete references to Win-Emacs.
Makefile: Add beta.texi and built files.
xemacs-faq.texi: Major overhaul of section 1. Add mailing list info, update
downloading info, add info on CVS, etc.
xemacs.mak: Also copy BUGS, README, COPYING and Installation.
Revision Changes Path
1.51 +25 -0 XEmacs/xemacs/etc/ChangeLog
(In the diff below, changes in quantity of whitespace are not shown.)
Index: ChangeLog
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/etc/ChangeLog,v
retrieving revision 1.50
retrieving revision 1.51
diff -u -b -r1.50 -r1.51
--- ChangeLog 2005/01/26 10:05:03 1.50
+++ ChangeLog 2005/01/31 20:08:32 1.51
＠＠ -1,3 +1,28 ＠＠
+2005-01-31 Ben Wing <ben(a)xemacs.org>
+
+ Delete stuff that is irrelevant, mislocated or woefully out-of-date.
+
+ * GNU: Delete.
+ * SERVICE: Delete.
+ * ORDERS, ORDERS.EUROPE, ORDERS.JAPAN: Delete.
+ * CHARSETS, CODINGS: Delete.
+ * DEBUG, LPF, MORE.STUFF, MOTIVATION: Delete.
+ * aliases.ksh: Delete. (moved to xemacs-builds/steve)
+ * README.HYPERBOLE, README.OO-BROWSER: Delete.
+ * chr.png, chrm.png: Move to photos/.
+ * check_cygwin_setup.sh: Delete.
+ * gnu.xpm, gnu.xbm, sink.xbm: Delete.
+ * ms-kermit, ms-kermit-7bit: Delete.
+ * TERMS: Delete.
+
+ * DISTRIB, FTP, MACHINES, MAILINGLISTS, PACKAGES:
+ Delete and move to FAQ.
+
+ * BETA:
+ Delete and move to man/beta.texi.
+
+ * README: Update.
+
2004-11-13 Ben Wing <ben(a)xemacs.org>
* CODING-STANDARDS: Delete and incorporate into Internals manual.
1.10 +12 -35 XEmacs/xemacs/etc/README
(In the diff below, changes in quantity of whitespace are not shown.)
Index: README
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/etc/README,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -b -r1.9 -r1.10
--- README 2003/03/27 12:57:44 1.9
+++ README 2005/01/31 20:08:37 1.10
＠＠ -3,40 +3,21 ＠＠
of interest to XEmacs users, some programs used by or with XEmacs, and
the file of on-line documentation for XEmacs.
-BETA Information about Beta versions
-CHARSETS Character set descriptions
-CODING-STANDARDS XEmacs C & Lisp coding standards
-CODINGS Character set codings
-COOKIES Urban Legend, or True Story? :-)
COPYING GNU Public License
-COPYING.LIB Library GNU Public License
-DEBUG Hints on how to debug XEmacs
-DISTRIB How to obtain copies of XEmacs and Emacs
+ChangeLog ChangeLog for etc/
+ETAGS.EBNF Description of TAGS file format
Emacs.ad Sample Resource file
-FTP XEmacs FTP Mirrors
-GNU GNU Manifesto
-GOATS Complete XEmacs internals documentation
+HELLO Hello in many languages (Mule test file)
InstallGuide Fast track to installation
-LPF Information about the League for Programming Freedom
-MACHINES List of known machines configurations (OLD)
-MAILINGLISTS List of available Mailing lists
-MORE.STUFF List of useful unbundled packages
-NEWS XEmacs 21.4 release information
-ORDERS
-ORDERS.EUROPE
-ORDERS.JAPAN Order forms for GNU software
-PACKAGES List of packages available for 21.4 release
+NEWS XEmacs 21.5 release information
+ONEWS Older release information
+OONEWS Even older release information
README This file
-README.HYPERBOLE
-README.OO-BROWSER How to obtain Hyperbole and the OO-Browser
-SERVICE How to obtain paid support for free software
-TERMS Information about termcap entries
TUTORIAL Tutorial for first time users (English version)
TUTORIAL.* Tutorials in non-English languages
+VEGETABLES XEmacs 21.5 code names
XKeysymDB X Keysym Database with Motif bindings
-aliases.sh Useful shell aliases
cbx.png "Created by XEmacs" logo
-check_cygwin_setup.sh Script to check for presence of Cygwin
ctags.1 Ctags man page
custom/ Images used in Custom mode
editclient.sh Either start up XEmacs or connect to a running one
＠＠ -44,18 +25,15 ＠＠
emacsstrs.sco Special files for running on an SCO console
eos/ Images for EOS support (GUD)
etags.1 Etags man page
-gnu.xbm
-gnu.xpm Image of a Gnu.
gnuattach.1 Gnuattach man page
gnuclient.1 Gnuclient man page
gnudoit.1 Gnudoit man page
gnuserv.1 Gnuserv man page
gnuserv.README Original README file from gnuserv
-gnusref.tex Gnus reference card
gray1.xbm Gray bitmap
-ms-kermit
-ms-kermit-7bit Files for running XEmacs through kermit
-photos/*.Z Various pictures of XEmacs developers
+idd/ ?
+package-index.LATEST.gpg ?
+photos/* Various pictures of XEmacs developers
recycle.xpm
recycle2.xpm Two versions of oversized Recycle cursor
refcard.ps.gz Postscript version of XEmacs reference card
＠＠ -63,19 +41,18 ＠＠
sample.Xdefaults (legacy -- to be removed)
sample.Xresources Example ~/.Xresources file
sample.init.el Example ~/.xemacs/init.el file
-sink.xbm A Gnu icon
sparcworks/ Support files for Sparcworks
tests/ Testcases for external widget
-time/ Image files for display-time
toolbar/ Image files for the toolbar
trash.xpm Garbage can icon
+unicode/ Unicode conversion tables
xemacs-beta.xpm XEmacs Beta logo
+xemacs-enhanced.png "XEmacs-enhanced" logo
xemacs-fe.sh XEmacs frontend driver
xemacs-icon.xpm
xemacs-icon2.xbm
xemacs-icon2.xpm
xemacs-icon3.xpm Various versions of an XEmacs WM icon
-xemacs-ja.1 Japanese XEmacs man page
xemacs.1 XEmacs man page
xemacs.xbm
xemacs.xpm XEmacs logo used on the splash screen
1.620 +7 -0 XEmacs/xemacs/lisp/ChangeLog
(In the diff below, changes in quantity of whitespace are not shown.)
Index: ChangeLog
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/lisp/ChangeLog,v
retrieving revision 1.619
retrieving revision 1.620
diff -u -b -r1.619 -r1.620
--- ChangeLog 2005/01/28 02:58:38 1.619
+++ ChangeLog 2005/01/31 20:08:44 1.620
＠＠ -1,3 +1,10 ＠＠
+2005-01-31 Ben Wing <ben(a)xemacs.org>
+
+ * help.el:
+ * help.el (describe-distribution): Go to appropriate FAQ entry.
+ * help.el (describe-beta): Go to info file.
+ * help.el (describe-project): Removed.
+
2005-01-27 Ben Wing <ben(a)xemacs.org>
* font-menu.el:
1.44 +8 -8 XEmacs/xemacs/lisp/help.el
(In the diff below, changes in quantity of whitespace are not shown.)
Index: help.el
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/lisp/help.el,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -b -r1.43 -r1.44
--- help.el 2004/09/15 08:30:26 1.43
+++ help.el 2005/01/31 20:08:45 1.44
＠＠ -1,7 +1,7 ＠＠
;;; help.el --- help commands for XEmacs.
;; Copyright (C) 1985, 1986, 1992-4, 1997 Free Software Foundation, Inc.
-;; Copyright (C) 2001, 2002 Ben Wing.
+;; Copyright (C) 2001, 2002, 2003 Ben Wing.
;; Maintainer: FSF
;; Keywords: help, internal, dumped
＠＠ -696,12 +696,17 ＠＠
(defun describe-distribution ()
"Display info on how to obtain the latest version of XEmacs."
(interactive)
- (Help-find-file (locate-data-file "DISTRIB")))
+ (save-window-excursion
+ (info)
+ (Info-find-node "xemacs-faq" "Q1.1.1"))
+ (switch-to-buffer "*info*"))
(defun describe-beta ()
"Display info on how to deal with Beta versions of XEmacs."
(interactive)
- (Help-find-file (locate-data-file "BETA")))
+ (save-window-excursion
+ (info "(beta)Top"))
+ (switch-to-buffer "*info*"))
(defun describe-copying ()
"Display info on how you may redistribute copies of XEmacs."
＠＠ -712,11 +717,6 ＠＠
"Show a list of all defined mouse buttons, and their definitions."
(interactive)
(describe-bindings nil t))
-
-(defun describe-project ()
- "Display info on the GNU project."
- (interactive)
- (Help-find-file (locate-data-file "GNU")))
(defun describe-no-warranty ()
"Display info on all the kinds of warranty XEmacs does NOT have."
1.284 +109 -0 XEmacs/xemacs/man/ChangeLog
(In the diff below, changes in quantity of whitespace are not shown.)
Index: ChangeLog
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/man/ChangeLog,v
retrieving revision 1.283
retrieving revision 1.284
diff -u -b -r1.283 -r1.284
--- ChangeLog 2005/01/28 00:12:32 1.283
+++ ChangeLog 2005/01/31 20:08:47 1.284
＠＠ -1,3 +1,112 ＠＠
+2005-01-31 Ben Wing <ben(a)xemacs.org>
+
+ * xemacs/help.texi (Misc Help):
+ Delete references to DISTRIB. Point to FAQ.
+
+ * xemacs/new.texi:
+ Update sample code for version checking.
+
+ * xemacs/xemacs.texi (Distrib):
+ * xemacs/xemacs.texi (Intro):
+ Delete references to DISTRIB. Point directly to web site.
+ Update stuff referring to GNU Emacs. Delete references to Win-Emacs.
+
+2005-01-31 Ben Wing <ben(a)xemacs.org>
+
+ * Makefile:
+ * Makefile (info_files):
+ * Makefile (html_files):
+ * Makefile (dvi_files):
+ * Makefile (pdf_files):
+ * Makefile ($(INFODIR)/beta.info):
+ Add beta.texi and built files.
+
+ * xemacs-faq.texi (Top):
+ * xemacs-faq.texi (Introduction):
+ * xemacs-faq.texi (Q1.0.3):
+ * xemacs-faq.texi (Q1.0.4):
+ * xemacs-faq.texi (Q1.0.5):
+ * xemacs-faq.texi (Q1.0.6):
+ * xemacs-faq.texi (Q1.1.1):
+ * xemacs-faq.texi (Q1.1.2):
+ * xemacs-faq.texi (Q1.1.3):
+ * xemacs-faq.texi (Q1.1.4):
+ * xemacs-faq.texi (Q1.2.1):
+ * xemacs-faq.texi (Q1.2.2):
+ * xemacs-faq.texi (Q1.2.3):
+ * xemacs-faq.texi (Q1.2.4):
+ * xemacs-faq.texi (Q1.2.5):
+ * xemacs-faq.texi (Q1.2.6):
+ * xemacs-faq.texi (Q1.2.7):
+ * xemacs-faq.texi (Q1.2.8):
+ * xemacs-faq.texi (Q1.2.9):
+ * xemacs-faq.texi (Q1.2.10):
+ * xemacs-faq.texi (Q1.2.11):
+ * xemacs-faq.texi (Q1.2.12):
+ * xemacs-faq.texi (Q1.2.13):
+ * xemacs-faq.texi (Q1.3.1):
+ * xemacs-faq.texi (Q1.3.2):
+ * xemacs-faq.texi (Q1.3.3):
+ * xemacs-faq.texi (Q1.3.4):
+ * xemacs-faq.texi (Q1.3.5):
+ * xemacs-faq.texi (Q1.3.6):
+ * xemacs-faq.texi (Q1.3.7):
+ * xemacs-faq.texi (Q1.3.8):
+ * xemacs-faq.texi (Q1.4.1):
+ * xemacs-faq.texi (Q1.4.2):
+ * xemacs-faq.texi (double-word): New.
+ * xemacs-faq.texi (Q1.4.3):
+ * xemacs-faq.texi (Q1.4.4):
+ * xemacs-faq.texi (Q1.4.5):
+ * xemacs-faq.texi (Q1.5.1):
+ * xemacs-faq.texi (Q1.5.2):
+ * xemacs-faq.texi (Q1.5.3):
+ * xemacs-faq.texi (Q1.6.1):
+ * xemacs-faq.texi (Q1.6.2):
+ * xemacs-faq.texi (Q1.6.3):
+ * xemacs-faq.texi (Q1.6.4):
+ * xemacs-faq.texi (Q1.6.5):
+ * xemacs-faq.texi (Q1.6.6):
+ * xemacs-faq.texi (Q1.7.1):
+ * xemacs-faq.texi (Q1.8.1):
+ * xemacs-faq.texi (Q1.8.2):
+ * xemacs-faq.texi (Q1.8.3):
+ * xemacs-faq.texi (Q1.8.4):
+ * xemacs-faq.texi (Q1.8.5):
+ * xemacs-faq.texi (Q1.8.6):
+ * xemacs-faq.texi (Q1.8.7):
+ * xemacs-faq.texi (Q1.8.8):
+ * xemacs-faq.texi (Q1.8.9):
+ * xemacs-faq.texi (Q2.2.1):
+ * xemacs-faq.texi (Q2.2.2):
+ * xemacs-faq.texi (Q2.4.2):
+ * xemacs-faq.texi (Advanced):
+ * xemacs-faq.texi (Q7.0.1):
+ * xemacs-faq.texi (Q7.0.2):
+ * xemacs-faq.texi (Q7.0.3):
+ * xemacs-faq.texi (Q7.0.4):
+ * xemacs-faq.texi (Q7.0.5):
+ * xemacs-faq.texi (Q7.0.6):
+ * xemacs-faq.texi (Q7.1.1):
+ * xemacs-faq.texi (Q7.1.2):
+ * xemacs-faq.texi (Q7.1.3):
+ * xemacs-faq.texi (Q7.1.4):
+ * xemacs-faq.texi (Q7.1.5):
+ * xemacs-faq.texi (Q7.1.6):
+ * xemacs-faq.texi (Q7.1.7):
+ * xemacs-faq.texi (Q7.1.8):
+ * xemacs-faq.texi (Q7.1.9):
+ * xemacs-faq.texi (Q7.1.10):
+ * xemacs-faq.texi (Q7.1.11):
+ * xemacs-faq.texi (Q7.2.1):
+ * xemacs-faq.texi (Q7.2.2):
+ * xemacs-faq.texi (Q7.2.3):
+ * xemacs-faq.texi (Other Packages):
+ * xemacs-faq.texi (Current Events):
+ * xemacs-faq.texi (Legacy Versions):
+ Major overhaul of section 1. Add mailing list info, update
+ downloading info, add info on CVS, etc.
+
2004-10-17 Shyamal Prasad <shyamal(a)member.fsf.org>
* xemacs/programs.texi (Program Modes): Updated it to reflect
1.34 +10 -0 XEmacs/xemacs/man/Makefile
(In the diff below, changes in quantity of whitespace are not shown.)
Index: Makefile
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/man/Makefile,v
retrieving revision 1.33
retrieving revision 1.34
diff -u -b -r1.33 -r1.34
--- Makefile 2004/12/07 12:52:45 1.33
+++ Makefile 2005/01/31 20:08:47 1.34
＠＠ -42,6 +42,7 ＠＠
PHOTODIR = ../etc/photos
info_files = \
+ $(INFODIR)/beta.info \
$(INFODIR)/cl.info \
$(INFODIR)/custom.info \
$(INFODIR)/emodules.info \
＠＠ -59,6 +60,7 ＠＠
$(INFODIR)/xemacs-faq.info
html_files = \
+ $(HTMLDIR)/beta.html \
$(HTMLDIR)/cl.html \
$(HTMLDIR)/custom.html \
$(HTMLDIR)/emodules.html \
＠＠ -76,6 +78,7 ＠＠
$(HTMLDIR)/xemacs-faq.html
dvi_files = \
+ beta.dvi \
cl.dvi \
custom.dvi \
emodules.dvi \
＠＠ -93,6 +96,7 ＠＠
xemacs-faq.dvi
pdf_files = \
+ beta.pdf \
cl.pdf \
custom.pdf \
emodules.pdf \
＠＠ -237,6 +241,9 ＠＠
new-users-guide/search.texi \
new-users-guide/xmenu.texi
+$(INFODIR)/beta.info : beta.texi
+ $(MAKEINFO) -o $(INFODIR)/beta.info beta.texi
+
$(INFODIR)/cl.info : cl.texi
$(MAKEINFO) -o $(INFODIR)/cl.info cl.texi
＠＠ -339,6 +346,9 ＠＠
$(RM) *~ \#* */*~ */\#*
############################################################################
+
+$(HTMLDIR)/beta.html : beta.texi
+ $(TEXI2HTML) beta.texi
$(HTMLDIR)/cl.html : cl.texi
$(TEXI2HTML_SPLIT) cl.texi
1.83 +1731 -1068XEmacs/xemacs/man/xemacs-faq.texi
(In the diff below, changes in quantity of whitespace are not shown.)
Index: xemacs-faq.texi
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/man/xemacs-faq.texi,v
retrieving revision 1.82
retrieving revision 1.83
diff -u -b -r1.82 -r1.83
--- xemacs-faq.texi 2004/12/29 05:08:26 1.82
+++ xemacs-faq.texi 2005/01/31 20:08:48 1.83
＠＠ -7,7 +7,7 ＠＠
＠finalout
＠titlepage
＠title XEmacs FAQ
-＠subtitle Frequently asked questions about XEmacs ＠* Last Modified: $Date: 2004/12/29 05:08:26 $
+＠subtitle Frequently asked questions about XEmacs ＠* Last Modified: $Date: 2005/01/31 20:08:48 $
＠sp 1
＠author Ben Wing <ben＠(a)xemacs.org>
＠author Tony Rossini <rossini＠(a)u.washington.edu>
＠＠ -194,63 +194,77 ＠＠
1 Introduction, Policy, Credits
-1.0: Introduction
+1.0: What is XEmacs?
* Q1.0.1:: What is XEmacs?
* Q1.0.2:: What is the current version of XEmacs?
-* Q1.0.3:: Where can I find it?
-* Q1.0.4:: Are binaries available?
-* Q1.0.5:: How does XEmacs differ from GNU Emacs?
-* Q1.0.6:: How much does XEmacs differ?
-* Q1.0.7:: Is XEmacs "GNU"?
-* Q1.0.8:: What is the correct way to refer to XEmacs and GNU Emacs?
-* Q1.0.9:: Why haven't XEmacs and GNU Emacs merged?
-* Q1.0.10:: Where can I get help?
-* Q1.0.11:: Where are the mailing lists archived?
-* Q1.0.12:: How do you pronounce XEmacs?
-* Q1.0.13:: What does XEmacs look like?
-* Q1.0.14:: Where can I obtain a printed copy of the XEmacs User's Manual?
-
-1.1: Versions for Different Operating Systems
-* Q1.1.1:: Do I need X11 to run XEmacs?
-* Q1.1.2:: Is there a port of XEmacs to Microsoft Windows?
-* Q1.1.3:: Can I build XEmacs on MS Windows with X support? Do I need to?
-* Q1.1.4:: What are Cygwin and MinGW, and do I need them to run XEmacs?
-* Q1.1.5:: What are the differences between the various MS Windows emacsen?
-* Q1.1.6:: Is there a port of XEmacs to the Macintosh?
-* Q1.1.7:: Is there a port of XEmacs to NextStep?
-* Q1.1.8:: Is there a port of XEmacs to OS/2?
-* Q1.1.9:: How does the port cope with differences in the Windows user interface?
-
-1.2: Policies
-* Q1.2.1:: What is the FAQ editorial policy?
-* Q1.2.2:: How do I become a beta tester?
-* Q1.2.3:: How do I contribute to XEmacs itself?
-
-1.3: Credits
-* Q1.3.1:: Who wrote XEmacs?
-* Q1.3.2:: Who contributed to this version of the FAQ?
-* Q1.3.3:: Who contributed to the FAQ in the past?
-
-1.4: Internationalization
-* Q1.4.1:: What is the status of internationalization support aka MULE (including Asian language support)?
-* Q1.4.2:: How can I help with internationalization?
-* Q1.4.3:: How do I type non-ASCII characters?
-* Q1.4.4:: Can XEmacs messages come out in a different language?
-* Q1.4.5:: Please explain the various input methods in MULE/XEmacs
-* Q1.4.6:: How do I portably code for MULE/XEmacs?
-* Q1.4.7:: How about Cyrillic modes?
-* Q1.4.8:: Does XEmacs support Unicode?
-* Q1.4.9:: How does XEmacs display Unicode?
-
-1.5: Getting Started
-* Q1.5.1:: What is an ＠file{init.el} or ＠file{.emacs} and is there a sample one?
-* Q1.5.2:: Where do I put my ＠file{init.el} file?
-* Q1.5.3:: Can I use the same ＠file{init.el} with the other Emacs?
-* Q1.5.4:: Any good XEmacs tutorials around?
-* Q1.5.5:: May I see an example of a useful XEmacs Lisp function?
-* Q1.5.6:: And how do I bind it to a key?
-* Q1.5.7:: What's the difference between a macro and a function?
-* Q1.5.8:: What is ＠code{Custom}?
+* Q1.0.3:: How do you pronounce XEmacs?
+* Q1.0.4:: What does XEmacs look like?
+* Q1.0.5:: Who wrote XEmacs?
+* Q1.0.6:: Who wrote the FAQ?
+
+1.1: Getting XEmacs
+* Q1.1.1:: Where can I find XEmacs?
+* Q1.1.2:: Are binaries available?
+* Q1.1.3:: How do I get the bleeding-edge sources?
+* Q1.1.4:: Where can I obtain a printed copy of the XEmacs User's Manual?
+
+1.2: Versions for Different Operating Systems
+* Q1.2.1:: Do I need X11 to run XEmacs?
+* Q1.2.2:: What versions of Unix does XEmacs run on?
+* Q1.2.3:: Is there a port of XEmacs to Microsoft Windows?
+* Q1.2.4:: Can I build XEmacs on MS Windows with X support? Do I need to?
+* Q1.2.5:: What are Cygwin and MinGW, and do I need them to run XEmacs?
+* Q1.2.6:: What are the differences between the various MS Windows emacsen?
+* Q1.2.7:: How does the port cope with differences in the Windows user interface?
+* Q1.2.8:: Is there a port of XEmacs to the Macintosh?
+* Q1.2.9:: Is there a port of XEmacs to MS-DOS?
+* Q1.2.10:: Is there a port of XEmacs to OS/2?
+* Q1.2.11:: Is there a port of XEmacs to NextStep?
+* Q1.2.12:: Is there a port of XEmacs to VMS?
+
+1.3: Getting Started
+* Q1.3.1:: What is an ＠file{init.el} or ＠file{.emacs} and is there a sample one?
+* Q1.3.2:: Where do I put my ＠file{init.el} file?
+* Q1.3.3:: Can I use the same ＠file{init.el} with the other Emacs?
+* Q1.3.4:: Any good XEmacs tutorials around?
+* Q1.3.5:: May I see an example of a useful XEmacs Lisp function?
+* Q1.3.6:: And how do I bind it to a key?
+* Q1.3.7:: What's the difference between a macro and a function?
+* Q1.3.8:: What is ＠code{Custom}?
+
+1.4: Getting Help
+* Q1.4.1:: Where can I get help?
+* Q1.4.2:: Which mailing lists are there?
+* Q1.4.2:: Where are the mailing lists archived?
+* Q1.4.3:: How can I get two instances of info?
+* Q1.4.4:: How do I add new Info directories?
+
+1.5: Contributing to XEmacs
+* Q1.5.1:: How do I submit changes to the FAQ?
+* Q1.5.2:: How do I become a beta tester?
+* Q1.5.3:: How do I contribute to XEmacs itself?
+
+1.6: Politics (XEmacs vs. GNU Emacs)
+* Q1.6.1:: What is GNU Emacs?
+* Q1.6.2:: How does XEmacs differ from GNU Emacs?
+* Q1.6.3:: How much does XEmacs differ?
+* Q1.6.4:: Is XEmacs "GNU"?
+* Q1.6.5:: What is the correct way to refer to XEmacs and GNU Emacs?
+* Q1.6.6:: Why haven't XEmacs and GNU Emacs merged?
+
+1.7: External Packages
+* Q1.7.1:: Which external packages are there?
+
+1.8: Internationalization
+* Q1.8.1:: What is the status of internationalization support aka MULE (including Asian language support)?
+* Q1.8.2:: How can I help with internationalization?
+* Q1.8.3:: How do I type non-ASCII characters?
+* Q1.8.4:: Can XEmacs messages come out in a different language?
+* Q1.8.5:: Please explain the various input methods in MULE/XEmacs
+* Q1.8.6:: How do I portably code for MULE/XEmacs?
+* Q1.8.7:: How about Cyrillic modes?
+* Q1.8.8:: Does XEmacs support Unicode?
+* Q1.8.9:: How does XEmacs display Unicode?
2 Installation and Troubleshooting
＠＠ -473,36 +487,32 ＠＠
7 Advanced Customization Using XEmacs Lisp
-7.0: Online Help
-* Q7.0.1:: How can I get two instances of info?
-* Q7.0.2:: How do I add new Info directories?
-
-7.1: Emacs Lisp and ＠file{init.el}
-* Q7.1.1:: What version of Emacs am I running?
-* Q7.1.2:: How can I evaluate Emacs-Lisp expressions?
-* Q7.1.3:: ＠code{(setq tab-width 6)} behaves oddly.
-* Q7.1.4:: How can I add directories to the ＠code{load-path}?
-* Q7.1.5:: How to check if a lisp function is defined?
-* Q7.1.6:: Can I force the output of ＠code{(face-list)} to a buffer?
-
-7.2: Emacs Lisp Programming Techniques
-* Q7.2.1:: What is the difference in key sequences between XEmacs and GNU Emacs?
-* Q7.2.2:: Can I generate "fake" keyboard events?
-* Q7.2.3:: Could you explain ＠code{read-kbd-macro} in more detail?
-* Q7.2.4:: What is the performance hit of ＠code{let}?
-* Q7.2.5:: What is the recommended use of ＠code{setq}?
-* Q7.2.6:: What is the typical misuse of ＠code{setq}?
-* Q7.2.7:: I like the ＠code{do} form of cl, does it slow things down?
-* Q7.2.8:: I like recursion, does it slow things down?
-* Q7.2.9:: How do I put a glyph as annotation in a buffer?
-* Q7.2.10:: ＠code{map-extents} won't traverse all of my extents!
-* Q7.2.11:: My elisp program is horribly slow. Is there an easy way to find out where it spends time?
-
-7.3: Mathematics
-* Q7.3.1:: What are bignums, ratios, and bigfloats in Lisp?
-* Q7.3.2:: XEmacs segfaults when I use very big numbers!
-* Q7.3.3:: Bignums are really slow!
-* Q7.3.4:: Equal bignums don't compare as equal! What gives?
+7.0: Emacs Lisp and ＠file{init.el}
+* Q7.0.1:: What version of Emacs am I running?
+* Q7.0.2:: How can I evaluate Emacs-Lisp expressions?
+* Q7.0.3:: ＠code{(setq tab-width 6)} behaves oddly.
+* Q7.0.4:: How can I add directories to the ＠code{load-path}?
+* Q7.0.5:: How to check if a lisp function is defined?
+* Q7.0.6:: Can I force the output of ＠code{(face-list)} to a buffer?
+
+7.1: Emacs Lisp Programming Techniques
+* Q7.1.1:: What is the difference in key sequences between XEmacs and GNU Emacs?
+* Q7.1.2:: Can I generate "fake" keyboard events?
+* Q7.1.3:: Could you explain ＠code{read-kbd-macro} in more detail?
+* Q7.1.4:: What is the performance hit of ＠code{let}?
+* Q7.1.5:: What is the recommended use of ＠code{setq}?
+* Q7.1.6:: What is the typical misuse of ＠code{setq}?
+* Q7.1.7:: I like the ＠code{do} form of cl, does it slow things down?
+* Q7.1.8:: I like recursion, does it slow things down?
+* Q7.1.9:: How do I put a glyph as annotation in a buffer?
+* Q7.1.10:: ＠code{map-extents} won't traverse all of my extents!
+* Q7.1.11:: My elisp program is horribly slow. Is there an easy way to find out where it spends time?
+
+7.2: Mathematics
+* Q7.1.1:: What are bignums, ratios, and bigfloats in Lisp?
+* Q7.1.2:: XEmacs segfaults when I use very big numbers!
+* Q7.1.3:: Bignums are really slow!
+* Q7.1.4:: Equal bignums don't compare as equal! What gives?
8 Other External Packages
＠＠ -537,7 +547,6 ＠＠
10.0: XEmacs 21.1
* Q10.0.1:: Gnus 5.10 won't display smileys in XEmacs 21.1.
-
＠end detailmenu
＠end menu
＠＠ -574,66 +583,81 ＠＠
Include ＠samp{XEmacs FAQ} on the Subject: line.
＠menu
-1.0: Introduction
+1.0: What is XEmacs?
* Q1.0.1:: What is XEmacs?
* Q1.0.2:: What is the current version of XEmacs?
-* Q1.0.3:: Where can I find it?
-* Q1.0.4:: Are binaries available?
-* Q1.0.5:: How does XEmacs differ from GNU Emacs?
-* Q1.0.6:: How much does XEmacs differ?
-* Q1.0.7:: Is XEmacs "GNU"?
-* Q1.0.8:: What is the correct way to refer to XEmacs and GNU Emacs?
-* Q1.0.9:: Why haven't XEmacs and GNU Emacs merged?
-* Q1.0.10:: Where can I get help?
-* Q1.0.11:: Where are the mailing lists archived?
-* Q1.0.12:: How do you pronounce XEmacs?
-* Q1.0.13:: What does XEmacs look like?
-* Q1.0.14:: Where can I obtain a printed copy of the XEmacs User's Manual?
-
-1.1: Versions for Different Operating Systems
-* Q1.1.1:: Do I need X11 to run XEmacs?
-* Q1.1.2:: Is there a port of XEmacs to Microsoft Windows?
-* Q1.1.3:: Can I build XEmacs on MS Windows with X support? Do I need to?
-* Q1.1.4:: What are Cygwin and MinGW, and do I need them to run XEmacs?
-* Q1.1.5:: What are the differences between the various MS Windows emacsen?
-* Q1.1.6:: Is there a port of XEmacs to the Macintosh?
-* Q1.1.7:: Is there a port of XEmacs to NextStep?
-* Q1.1.8:: Is there a port of XEmacs to OS/2?
-* Q1.1.9:: How does the port cope with differences in the Windows user interface?
-
-1.2: Policies
-* Q1.2.1:: What is the FAQ editorial policy?
-* Q1.2.2:: How do I become a beta tester?
-* Q1.2.3:: How do I contribute to XEmacs itself?
-
-1.3: Credits
-* Q1.3.1:: Who wrote XEmacs?
-* Q1.3.2:: Who contributed to this version of the FAQ?
-* Q1.3.3:: Who contributed to the FAQ in the past?
-
-1.4: Internationalization
-* Q1.4.1:: What is the status of internationalization support aka MULE (including Asian language support)?
-* Q1.4.2:: How can I help with internationalization?
-* Q1.4.3:: How do I type non-ASCII characters?
-* Q1.4.4:: Can XEmacs messages come out in a different language?
-* Q1.4.5:: Please explain the various input methods in MULE/XEmacs
-* Q1.4.6:: How do I portably code for MULE/XEmacs?
-* Q1.4.7:: How about Cyrillic modes?
-* Q1.4.8:: Does XEmacs support Unicode?
-* Q1.4.9:: How does XEmacs display Unicode?
-
-1.5: Getting Started
-* Q1.5.1:: What is an ＠file{init.el} or ＠file{.emacs} and is there a sample one?
-* Q1.5.2:: Where do I put my ＠file{init.el} file?
-* Q1.5.3:: Can I use the same ＠file{init.el} with the other Emacs?
-* Q1.5.4:: Any good XEmacs tutorials around?
-* Q1.5.5:: May I see an example of a useful XEmacs Lisp function?
-* Q1.5.6:: And how do I bind it to a key?
-* Q1.5.7:: What's the difference between a macro and a function?
-* Q1.5.8:: What is ＠code{Custom}?
+* Q1.0.3:: How do you pronounce XEmacs?
+* Q1.0.4:: What does XEmacs look like?
+* Q1.0.5:: Who wrote XEmacs?
+* Q1.0.6:: Who wrote the FAQ?
+
+1.1: Getting XEmacs
+* Q1.1.1:: Where can I find XEmacs?
+* Q1.1.2:: Are binaries available?
+* Q1.1.3:: How do I get the bleeding-edge sources?
+* Q1.1.4:: Where can I obtain a printed copy of the XEmacs User's Manual?
+
+1.2: Versions for Different Operating Systems
+* Q1.2.1:: Do I need X11 to run XEmacs?
+* Q1.2.2:: What versions of Unix does XEmacs run on?
+* Q1.2.3:: Is there a port of XEmacs to Microsoft Windows?
+* Q1.2.4:: Can I build XEmacs on MS Windows with X support? Do I need to?
+* Q1.2.5:: What are Cygwin and MinGW, and do I need them to run XEmacs?
+* Q1.2.6:: What are the differences between the various MS Windows emacsen?
+* Q1.2.7:: How does the port cope with differences in the Windows user interface?
+* Q1.2.8:: Is there a port of XEmacs to the Macintosh?
+* Q1.2.9:: Is there a port of XEmacs to MS-DOS?
+* Q1.2.10:: Is there a port of XEmacs to OS/2?
+* Q1.2.11:: Is there a port of XEmacs to NextStep?
+* Q1.2.12:: Is there a port of XEmacs to VMS?
+
+1.3: Getting Started
+* Q1.2.13::
+* Q1.3.1:: What is an ＠file{init.el} or ＠file{.emacs} and is there a sample one?
+* Q1.3.2:: Where do I put my ＠file{init.el} file?
+* Q1.3.3:: Can I use the same ＠file{init.el} with the other Emacs?
+* Q1.3.4:: Any good XEmacs tutorials around?
+* Q1.3.5:: May I see an example of a useful XEmacs Lisp function?
+* Q1.3.6:: And how do I bind it to a key?
+* Q1.3.7:: What's the difference between a macro and a function?
+* Q1.3.8:: What is ＠code{Custom}?
+
+1.4: Getting Help
+* Q1.4.1:: Where can I get help?
+* Q1.4.2:: Which mailing lists are there?
+* Q1.4.3:: How can I get two instances of info?
+* Q1.4.4:: How do I add new Info directories?
+
+1.5: Contributing to XEmacs
+* Q1.4.5::
+* Q1.5.1:: How do I submit changes to the FAQ?
+* Q1.5.2:: How do I become a beta tester?
+* Q1.5.3:: How do I contribute to XEmacs itself?
+
+1.6: Politics (XEmacs vs. GNU Emacs)
+* Q1.6.1:: What is GNU Emacs?
+* Q1.6.2:: How does XEmacs differ from GNU Emacs?
+* Q1.6.3:: How much does XEmacs differ?
+* Q1.6.4:: Is XEmacs "GNU"?
+* Q1.6.5:: What is the correct way to refer to XEmacs and GNU Emacs?
+* Q1.6.6:: Why haven't XEmacs and GNU Emacs merged?
+
+1.7: External Packages
+* Q1.7.1:: Which external packages are there?
+
+1.8: Internationalization
+* Q1.8.1:: What is the status of internationalization support aka MULE (including Asian language support)?
+* Q1.8.2:: How can I help with internationalization?
+* Q1.8.3:: How do I type non-ASCII characters?
+* Q1.8.4:: Can XEmacs messages come out in a different language?
+* Q1.8.5:: Please explain the various input methods in MULE/XEmacs
+* Q1.8.6:: How do I portably code for MULE/XEmacs?
+* Q1.8.7:: How about Cyrillic modes?
+* Q1.8.8:: Does XEmacs support Unicode?
+* Q1.8.9:: How does XEmacs display Unicode?
＠end menu
-＠unnumberedsec 1.0: Introduction
+＠unnumberedsec 1.0: What is XEmacs?
＠node Q1.0.1, Q1.0.2, Introduction, Introduction
＠unnumberedsubsec Q1.0.1: What is XEmacs?
＠＠ -667,134 +691,1208 ＠＠
and was also the last version without international language support.
＠node Q1.0.3, Q1.0.4, Q1.0.2, Introduction
-＠unnumberedsubsec Q1.0.3: Where can I find it?
-
-The canonical source and binaries can be found at:
+＠unnumberedsubsec Q1.0.3: How do you pronounce XEmacs?
-＠example
-＠uref{http://ftp.xemacs.org/pub/xemacs/}
-＠end example
+The most common pronounciation is ＠samp{Eks eemax}.
＠node Q1.0.4, Q1.0.5, Q1.0.3, Introduction
-＠unnumberedsubsec Q1.0.4: Are binaries available?
-
-MS Windows binaries are available at
-＠uref{http://www.xemacs.org/Download/win32/} for the native versions
-of 21.4 and 21.1. Cygwin binaries are now available as part of the
-standard Cygwin installation process. XEmacs also comes pre-built as
-part of many Linux distributions, such as Red Hat and SuSE.
+＠unnumberedsubsec Q1.0.4: What does XEmacs look like?
-Otherwise, you will need to build XEmacs yourself or get your system
-administrator to do it. Generally, this is not a difficult process
-under Unix and Mac OS X, as XEmacs has been tested under all of the
-common Unix versions and under Mac OS X and comes with an extensive
-configure script that is able to automatically detect most aspects of
-the configuration of your particular system.
+Screen snapshots are available at
+＠uref{http://www.xemacs.org/About/Screenshots/index.html}
+as part of the XEmacs website.
＠node Q1.0.5, Q1.0.6, Q1.0.4, Introduction
-＠unnumberedsubsec Q1.0.5: How does XEmacs differ from GNU Emacs?
-
-For a detailed description of the differences between GNU Emacs and
-XEmacs and a detailed history of XEmacs, check out the
-＠example
-＠uref{http://www.xemacs.org/About/XEmacsVsGNUemacs.html, NEWS file}
-＠end example
+＠unnumberedsubsec Q1.0.5: Who wrote XEmacs?
-＠table ＠strong
-＠item User-Visible Editing Features
-XEmacs in general tries hard to conform to exist user-interface
-standards, and to work "out-of-the-box" without the need for obscure
-customization changes. GNU Emacs, particularly version 21, has gotten
-better about this (in many cases by copying the XEmacs behavior!), but
-still has some weirdnesses. For example, the standard method of
-selecting text using the Shift key works out-of-the-box in XEmacs.
+XEmacs is the result of the time and effort of many people, and the
+active developers have changed over time. There are two major
+components of the XEmacs effort -- writing the code itself and providing
+all the support work (testing the code, releasing beta and final
+versions, handling patches, reading bug reports, maintaining the web
+site, managing the mailing lists, etc. etc.). Neither component would
+work without the other.
-XEmacs has a built-in toolbar. Four toolbars can actually be configured
-simultaneously: top, bottom, left, and right toolbars.
+＠subheading CODING
-XEmacs has vertical and horizontal scrollbars. Unlike in GNU Emacs 19
-(which provides a primitive form of vertical scrollbar), these are true
-toolkit scrollbars. A look-alike Motif scrollbar is provided for those
-who don't have Motif. (Even for those who do, the look-alike may be
-preferable as it is faster.)
+The primary code contributor over the years has been Ben Wing (active
+since late 1992). Between 1991 and 1995, large amounts of coding was
+contributed by Jamie Zawinski and Chuck Thompson. Many other people
+have authored major subsystems or otherwise contributed large amounts of
+code, including Andy Piper, Hrvoje Niksic, Jerry James, Jonathan Harris,
+Kyle Jones, Martin Buchholz, Michael Sperber, Olivier Galibert, Richard
+Mlynarik, Stig, William Perry and plenty of others.
-XEmacs has buffer tabs along the top of the frame (although the
-position can be changed) that make it very easy to switch buffers.
+Primary XEmacs-specific subsystems and their authors:
-The menubar under XEmacs is better-designed, with more thought put into
-it.
+＠table ＠asis
+＠item Objects
+＠itemize ＠minus
+＠item
+Conversion from 26-bit to 28-bit pointers and integers, lrecords, lcrecords: Richard Mlynarik, 1994
+＠item
+Conversion to 32-bit pointers and 31-bit integers: Kyle Jones, Martin Buchholz
+＠item
+Portable dumper, object descriptions: Olivier Galibert
+＠item
+KKCC (new garbage collector), ephemerons, weak boxes: Michael Sperber and students
+＠item
+Random object work (object equal and hash methods, weak lists, lcrecord lists, bit vectors, dynarr, blocktype, opaque, string resizing): Ben Wing
+＠item
+Profiling: Ben Wing
+＠item
+Some byte-compilation and hash-table improvements: Martin Buchholz
+＠item
+Bignum: Jerry James
+＠end itemize
-XEmacs can ask questions using popup dialog boxes. Any command executed
-from a menu will ask yes/no questions with dialog boxes, while commands
-executed via the keyboard will use the minibuffer.
+＠item Internationalization/Mule
+＠itemize ＠minus
+＠item
+mostly Ben Wing; many ideas for future work, Stephen Turnbull
+＠end itemize
-XEmacs under MS Windows provides uses the standard file-dialog box for
-opening and saving files. Standard menu-accelerator behavior can easily
-be enabled using the Options menu, and integrates well into the existing
-keymap.
+＠item I/O
+＠itemize ＠minus
+＠item
+Basic event/event-stream implementation: Jamie Zawinski
+＠item
+Most event work since 1994: Ben Wing
+＠item
+Asynchronous stuff (async timeouts, signals, quit-checking): Ben Wing
+＠item
+Process method abstraction, Windows process work: Kirill Katsnelson
+＠item
+Misc-user events, async timeouts, most quit-checking and signal code, most other work since 1994: Ben Wing
+＠item
+Lstreams: Ben Wing
+＠end itemize
-XEmacs has (still experimental) support for widgets of various sorts --
-buttons, text boxes, sliders, progress bars, etc. A progress bar is
-used in font lock to show the progress.
+＠item Display
+＠itemize ＠minus
+＠item
+Redisplay mechanism: implementation, Chuck Thompson; additional work, lots of people
+＠item
+Glyphs: mostly Ben Wing
+＠item
+Specifiers: Ben Wing
+＠item
+Extents: initial implementation, someone at Lucid; rewrite, 1994, Ben Wing
+＠item
+Widgets: Andy Piper
+＠item
+JPEG/PNG/TIFF image converters: Ben Wing, William Perry, Jareth Hein, others (see comment in ＠file{glyphs-eimage.c})
+＠item
+Menus: Jamie Zawinski, someone at Lucid (Lucid menus)
+＠item
+Scrollbars: Chuck Thompson, ??? (Lucid scrollbar)
+＠item
+Multi-device/device-independence work (console/device/etc methods): Ben Wing, prototype by chuck thompson
+＠item
+Faces: first implementation, Jamie Zawinski; second, chuck; third, Ben Wing
+＠item
+Fonts/colors: first implementation, Jamie Zawinski; further work, Ben Wing
+＠item
+Toolbars: implementation, chuck, much interface work, Ben Wing
+＠item
+Gutters, tabs: andy piper
+＠end itemize
-Experimental support for drag-and-drop protocols is provided from
-XEmacs 21.
+＠item Device subsystems
+＠itemize ＠minus
+＠item
+X Windows: Jamie Zawinksi, Ben Wing, others
+＠item
+GTK: William Perry, Malcolm Purvis
+＠item
+MS Windows: initial implementation, Jonathan Harris; some more work, Andy Piper, Ben Wing
+＠item
+TTY: Chuck Thompson, Ben Wing
+＠item
+Cygwin: Andy Piper
+＠end itemize
-＠item General Platform Support
-If you're running on a machine with audio hardware, you can specify
-sound files for XEmacs to play instead of the default X beep. See the
-documentation of the function load-sound-file and the variable
-sound-alist. XEmacs also supports the network sound protocols NAS and
-EsounD.
+＠item Misc
+＠itemize ＠minus
+＠item
+Configure: initial porting from fsf, Chuck Thompson; conversion to autoconf 2, much rewriting, Martin Buchholz
+＠item
+Most initialization-related code: Ben Wing
+＠item
+Internals manual, much of Lisp manual: Ben Wing
+＠item
+FSF synching: initial sync with FSF 19, Richard Mlynarik, further work, Ben Wing
+＠end itemize
+＠end table
-XEmacs 21 supports database protocols with LISP bindings, currently
-including Berkeley DB, LDAP, and PostgreSQL (21.2 only).
+＠subheading SUPPORT
-XEmacs 20 and 21 support the Canna, Wnn, and SJ3 Japanese input method
-servers directly, as well as through the X Input Method (XIM)
-protocol. GNU Emacs 20 supports only the XIM protocol. Both Emacsen
-support the Quail family of input methods (implemented in LISP) for many
-languages.
+Currently, support duties are handled by many different people.
-XEmacs provides support for ToolTalk on systems that have
-it.
+Release managers have been
-＠item Packaged LISP Libraries
-Many more packages are provided standard with XEmacs than with GNU Emacs
-19 or 20.
+＠itemize ＠minus
+＠item
+Stephen Turnbull (April 2001 - January 2003, March 2004 - present, 21.2.47 - 21.4.12, 21.5.2 - 21.5.7, 21.5.17 - present)
+＠item
+Vin Shelton (May 2003 - present, 21.4.13 - present)
+＠item
+Steve Youngs (July 2002 - September 2003, 21.5.8 - 21.5.16)
+＠item
+Martin Buchholz (December 1998, November 1999 - May 2001, 21.2.7 - 21.2.8, 21.2.21 - 21.2.46, 21.5.0 - 21.5.1)
+＠item
+Steve Baur (early 1997 - December 1998, February 1999 - November 1999, 19.15 - 21.2.5, 21.2.9 - 21.2.20)
+＠item
+Andy Piper (December 1998, 21.2.6)
+＠item
+Chuck Thompson (June 1994 - September 1996, 19.11 - 19.14)
+＠item
+Jamie Zawinski (April 1991 - June 1994, 19.0 - 19.10)
+＠end itemize
-XEmacs 21 supports an integrated package management system which uses
-EFS to download, then automatically install prebuilt LISP
-libraries. This allows XEmacs users much more straightforward access to
-the "latest and greatest" version of any given library.
+The recent overlapping dates are intentional, since two or three trees
+are maintained simultaneously at any point.
-We are working on a standard method for enabling, disabling and
-otherwise controlling packages, which should make them very easy to use.
+Other major support work:
-＠item LISP Programming
-From XEmacs 20 on, characters are a separate type. Characters can be
-converted to integers (and many integers can be converted to
-characters), but characters are not integers. GNU Emacs 19, XEmacs 19,
-Mule 2.3 (an extensive patch to GNU Emacs 18.55 and 19.x), and GNU Emacs
-20 (incorporating Mule 3 and later Mule 4) represent them as integers.
+＠itemize ＠minus
+＠item
+Adrian Aichner wrote and maintains the web site.
+＠item
+Stephen Turnbull has produced many of the beta and semi-stable releases
+and has attempted to be the "face" of XEmacs on the newsgroups and
+mailing lists.
+＠item
+Steve Youngs currently produces the beta releases (???).
+＠item
+Steve Youngs, Ville Skytta, and now Norbert Koch have taken turns
+maintaining the packages.
+＠item
+Vin Shelton maintains the stable releases.
+＠item
+Testing - #### Norbert, Adrian, ???
+＠end itemize
-From XEmacs 20 on, the buffer is treated as an array of characters, and
-the representation of buffer text is not exposed to LISP. The GNU Emacs
-20 functions like buffer-as-multibyte are not supported.
+Portraits and email of some of the major developers:
-In XEmacs, events are first-class objects. GNU Emacs 19 represents them
-as integers, which obscures the differences between a key gesture and
-the ancient ASCII code used to represent a particular overlapping subset
-of them.
+＠itemize ＠bullet
+＠item ＠email{andy＠(a)xemacs.org, Andy Piper}
+＠html
+<br><img src="piper.png" alt="Portrait of Andy Piper"><br>
+＠end html
-In XEmacs, keymaps are first-class opaque objects. GNU Emacs 19
-represents them as complicated combinations of association lists and
-vectors. If you use the advertised functional interface to manipulation
-of keymaps, the same code will work in XEmacs, GNU Emacs 18, and GNU
-Emacs 19; if your code depends on the underlying implementation of
-keymaps, it will not.
+＠item ＠email{ben＠(a)xemacs.org, Ben Wing}
+＠html
+<br><img src="ben.png" alt="Portrait of Ben Wing"><br>
+＠end html
-XEmacs uses "extents" to represent all non-textual aspects of buffers;
+＠item ＠email{cthomp＠(a)xemacs.org, Chuck Thompson}
+＠html
+<br><img src="cthomp.png" alt="Portrait of Chuck Thompson"><br>
+＠end html
+
+＠item ＠email{hniksic＠(a)xemacs.org, Hrvoje Niksic}
+
+＠html
+<br><img src="hniksic.png" alt="Portrait of Hrvoje Niksic"><br>
+＠end html
+
+＠item ＠email{jwz＠(a)jwz.org, Jamie Zawinski}
+＠html
+<br><img src="jwz.png" alt="Portrait of Jamie Zawinski"><br>
+＠end html
+
+＠item ＠email{martin＠(a)xemacs.org, Martin Buchholz}
+＠html
+<br><img src="martin.png" alt="Portrait of Martin Buchholz"><br>
+＠end html
+
+＠item ＠email{mly＠(a)adoc.xerox.com, Richard Mlynarik}
+＠html
+<br><img src="mly.png" alt="Portrait of Richard Mlynarik"><br>
+＠end html
+
+＠item ＠email{stephen＠(a)xemacs.org, Stephen Turnbull}
+
+＠item ＠email{steve＠(a)xemacs.org, Steve Baur}
+＠html
+<br><img src="slb.png" alt="Portrait of Steve Baur"><br>
+＠end html
+＠end itemize
+
+Many other people have contributed to XEmacs; this is partially
+enumerated in the ＠samp{About XEmacs} option in the Help menu.
+
+＠node Q1.0.6, Q1.1.1, Q1.0.5, Introduction
+＠unnumberedsubsec Q1.0.6: Who wrote the FAQ?
+
+The current version of this FAQ was created by ＠email{ben＠(a)xemacs.org,
+Ben Wing}.
+
+Previous contributors to the FAQ include
+
+＠itemize ＠bullet
+＠item ＠email{steve＠(a)xemacs.org, SL Baur}
+
+＠item ＠email{hniksic＠(a)xemacs.org, Hrvoje Niksic}
+
+＠item ＠email{binge＠(a)aloft.att.com, Curtis.N.Bingham}
+
+＠item ＠email{bruncott＠(a)dormeur.inria.fr, Georges Brun-Cottan}
+
+＠item ＠email{rjc＠(a)cogsci.ed.ac.uk, Richard Caley}
+
+＠item ＠email{cognot＠(a)ensg.u-nancy.fr, Richard Cognot}
+
+＠item ＠email{daku＠(a)nortel.ca, Mark Daku}
+
+＠item ＠email{wgd＠(a)martigny.ai.mit.edu, William G. Dubuque}
+
+＠item ＠email{eeide＠(a)cs.utah.edu, Eric Eide}
+
+＠item ＠email{af＠(a)biomath.jussieu.fr, Alain Fauconnet}
+
+＠item ＠email{cflatter＠(a)nrao.edu, Chris Flatters}
+
+＠item ＠email{ginsparg＠(a)adra.com, Evelyn Ginsparg}
+
+＠item ＠email{hall＠(a)aplcenmp.apl.jhu.edu, Marty Hall}
+
+＠item ＠email{dkindred＠(a)cmu.edu, Darrell Kindred}
+
+＠item ＠email{dmoore＠(a)ucsd.edu, David Moore}
+
+＠item ＠email{arup+＠(a)cmu.edu, Arup Mukherjee}
+
+＠item ＠email{nickel＠(a)prz.tu-berlin.de, Juergen Nickelsen}
+
+＠item ＠email{powell＠(a)csl.ncsa.uiuc.edu, Kevin R. Powell}
+
+＠item ＠email{dworkin＠(a)ccs.neu.edu, Justin Sheehy}
+
+＠item ＠email{stig＠(a)hackvan.com, Stig}
+
+＠item ＠email{Aki.Vehtari＠(a)hut.fi, Aki Vehtari}
+＠end itemize
+
+＠unnumberedsec 1.1: Getting XEmacs
+
+＠node Q1.1.1, Q1.1.2, Q1.0.6, Introduction
+＠unnumberedsubsec Q1.1.1: Where can I find XEmacs?
+
+To download XEmacs, visit the XEmacs WWW page at
+＠uref{http://www.xemacs.org/Download/}. The most up-to-date list of
+distribution sites can always be found there. Try to pick a site that
+is networkologically close to you. If you know of other mirrors of
+the XEmacs archives, please send e-mail to
+＠uref{mailto:webmaster＠＠xemacs.org} and we will list them here as well.
+
+The canonical distribution point is ftp.xemacs.org, available either
+through HTTP (＠uref{http://ftp.xemacs.org/}) or anonymous FTP
+(＠uref{ftp://ftp.xemacs.org/pub/xemacs/}).
+
+＠node Q1.1.2, Q1.1.3, Q1.1.1, Introduction
+＠unnumberedsubsec Q1.1.2: Are binaries available?
+
+MS Windows binaries are available at
+＠uref{http://www.xemacs.org/Download/win32/} for the native versions
+of 21.4 and 21.1. Cygwin binaries are now available as part of the
+standard Cygwin installation process. XEmacs also comes pre-built as
+part of many Linux distributions, such as Red Hat and SuSE.
+
+Otherwise, you will need to build XEmacs yourself or get your system
+administrator to do it. Generally, this is not a difficult process
+under Unix and Mac OS X, as XEmacs has been tested under all of the
+common Unix versions and under Mac OS X and comes with an extensive
+configure script that is able to automatically detect most aspects of
+the configuration of your particular system.
+
+＠node Q1.1.3, Q1.1.4, Q1.1.2, Introduction
+＠unnumberedsubsec Q1.1.3: How do I get the bleeding-edge sources?
+
+If you are interested in developing XEmacs, or getting the absolutely most
+recent, up-to-the-moment, bleeding-edge source code, you can directly
+access the master CVS source tree (read-only, of course, until you ask for
+and are granted permission to directly modify portions of the source tree)
+at cvs.xemacs.org. Directions on how to access the source tree are located
+at ＠uref{http://www.xemacs.org/Develop/cvsaccess.html}.
+
+Nightly CVS snapshots are available at
+＠uref{http://www.dk.xemacs.org/Download/CVS-snapshots/}.
+
+＠node Q1.1.4, Q1.2.1, Q1.1.3, Introduction
+＠unnumberedsubsec Q1.1.4: Where can I obtain a printed copy of the XEmacs User's Manual?
+
+Pre-printed manuals are not available. If you are familiar with
+TeX, you can generate your own manual from the XEmacs sources.
+
+HTML and Postscript versions of XEmacs manuals are available from the
+XEmacs web site at
+＠uref{http://www.xemacs.org/Documentation/index.html}.
+
+＠unnumberedsec 1.2: Versions for Different Operating Systems
+
+＠node Q1.2.1, Q1.2.2, Q1.1.4, Introduction
+＠unnumberedsubsec Q1.2.1: Do I need X11 to run XEmacs?
+
+No. The name ＠dfn{XEmacs} is unfortunate in the sense that it is
+＠strong{not} an X Window System-only version of Emacs. XEmacs has
+full color support on a color-capable character terminal.
+
+＠node Q1.2.2, Q1.2.3, Q1.2.1, Introduction
+＠unnumberedsubsec Q1.2.2: What versions of Unix does XEmacs run on?
+
+For problems with particular machines and versions of Unix, see the
+＠file{PROBLEMS} file.
+
+Much effort has gone into making XEmacs work on as many different
+machines, configurations, and compilers as possible.
+
+Much effort has gone into making XEmacs 64-bit clean.
+
+Much effort has gone into removing system-specific code, and replacing
+such code with autodetection at configure time.
+
+The XEmacs core should build "out of the box" on most Unix-like systems.
+
+XEmacs 21.2 was tested and ＠samp{make check} succeeded on these Unix
+configurations as of 2001-02-10:
+
+＠example
+alphaev56-dec-osf4.0e (both Compaq C and gcc)
+i386-unknown-freebsd4.2
+i386-unknown-netbsdelf1.5
+i586-sco-sysv5uw7.0.1 (both SCO's cc and gcc)
+i686-pc-linux-gnu
+hppa2.0-hp-hpux10.20 (both HP's ANSI cc and gcc)
+mips-sgi-irix6.5 (both MIPSpro cc and gcc)
+rs6000-ibm-aix4.3.0.0 (both IBM's xlc and gcc)
+sparc-sun-solaris2.6 (both Sun's Forte C and gcc)
+sparc-sun-solaris2.7 (both Sun's Forte C and gcc)
+sparc-sun-sunos4.1.4 (gcc)
+＠end example
+
+Some systems have a dual mode 32-bit/64-bit compiler. On most of
+these, XEmacs requires the ＠samp{--pdump} configure option to build
+correctly with the 64-bit version of the compiler.
+
+＠example
+mips-sgi-irix6.5, CC="gcc -mabi=64"
+mips-sgi-irix6.5, CC="cc -64"
+rs6000-ibm-aix4.3.0.0, CC="cc -q64"
+＠end example
+
+On most of these systems, XEmacs also builds with a C++ compiler,
+but not "out of the box". This feature is only for use by the
+maintainers.
+
+XEmacs 21.2 is known ＠emph{not} to work on any machines with m680x0
+processors. Sorry, all you sun3 and Unix PC nostalgia buffs out there.
+
+VMS has never been supported by XEmacs. In fact, all the old VMS code
+inherited from Emacs has been removed. Sorry, all you VMS fans out there.
+
+＠node Q1.2.3, Q1.2.4, Q1.2.2, Introduction
+＠unnumberedsubsec Q1.2.3: Is there a port of XEmacs to Microsoft Windows?
+
+Yes. Beginning with release 21.0, XEmacs has worked under MS Windows
+and is fully-featured and actively developed. A group of dedicated
+developers actively maintains and improves the Windows-specific
+portions of the code. Some of the core developers, in fact, use
+Windows as their only development environment, and some features, such
+as printing, actually work better on Windows than native Unix and Mac
+OS X. The mailing list at ＠email{xemacs-winnt＠(a)xemacs.org} is dedicated
+to that effort (please use the -request address to
+subscribe). (Despite its name, XEmacs actually works on all versions
+of Windows.)
+
+The list name is misleading, as XEmacs supports and has been compiled on
+Windows 95, Windows 98, Windows NT, Windows 2000, Windows ME, Windows
+XP, and all newer versions of Windows. The MS Windows-specific code is
+based on Microsoft Win32 API, and will not work on MS Windows 3.x or on
+MS-DOS.
+
+XEmacs also supports the Cygwin and MinGW development and runtime
+environments, where it also uses native Windows code for graphical
+features. In addition, under Cygwin it is possible to compile XEmacs
+to use an X server (and XFree86 is available as part of the standard
+Cygwin installation).
+
+＠node Q1.2.4, Q1.2.5, Q1.2.3, Introduction
+＠unnumberedsubsec Q1.2.4: Can I build XEmacs on MS Windows with X support? Do I need to?
+
+Yes, you can, but no you do not need to. In fact, we recommend that you
+use a native-GUI version unless you have a specific need for an X
+version.
+
+＠node Q1.2.5, Q1.2.6, Q1.2.4, Introduction
+＠unnumberedsubsec Q1.2.5: What are Cygwin and MinGW, and do I need them to run XEmacs?
+
+To answer the second part of the question: No, you, you don't need
+Cygwin or MinGW to build or to run XEmacs. But if you have them and
+want to use them, XEmacs supports these environments.
+
+(One important reason to support Cygwin is that it lets the MS Windows
+developers test out their code in a Unix environment without actually
+having to have a Unix machine around. For this reason alone, Cygwin
+support is likely to remain supported for a long time in XEmacs. Same
+goes for the X support under Cygwin, for the same reasons. MinGW
+support, on the other hand, depends on volunteers to keep it up to date;
+but this is generally not hard.)
+
+Cygwin is a set of tools providing Unix-like API on top of Win32.
+It makes it easy to port large Unix programs without significant
+changes to their source code. It is a development environment as well
+as a runtime environment.
+
+When built with Cygwin, XEmacs supports all display types -- TTY, X &
+Win32 GUI, and can be built with support for all three simultaneously.
+If you build with Win32 GUI support then the Cygwin version uses the
+majority of the Windows-specific code, which is mostly related to
+display. If you want to build with X support you need X libraries (and
+an X server to display XEmacs on); see ＠ref{Q2.2.7}. TTY and Win32 GUI
+require no additional libraries beyond what comes standard with Cygwin.
+
+The advantages of the Cygwin version are that it integrates well with
+the Cygwin environment for existing Cygwin users; uses configure so
+building with different features is very easy; and actively supports X &
+TTY. Furthermore, the entire Cygwin environment and compiler are free,
+whereas Visual C++ costs money.
+
+The disadvantage is that it requires the whole Cygwin environment,
+whereas the native port requires only a suitable MS Windows compiler.
+Also, it follows the Unix filesystem and process model very closely
+(some will undoubtedly view this as an advantage).
+
+See ＠uref{http://www.cygwin.com/} for more information on
+Cygwin.
+
+MinGW is a collection of header files and import libraries that allow
+one to use GCC under the Cygwin environment to compile and produce
+exactly the same native Win32 programs that you can using Visual C++.
+Programs compiled with MinGW make use of the standard Microsoft runtime
+library ＠file{MSVCRT.DLL}, present on all Windows systems, and look,
+feel, and act like a standard Visual-C-produced application. (The only
+difference is the compiler.) This means that, unlike a
+standardly-compiled Cygwin application, no extra runtime support
+(e.g. Cygwin's ＠file{cygwin1.dll}) is required. This, along with the
+fact that GCC is free (and works in a nice Unix-y way in a nice Unix-y
+environment, for those die-hard Unix hackers out there), is the main
+advantage of MinGW. It is also potentially faster than Cygwin because
+it has less overhead when calling Windows, but you lose the POSIX
+emulation layer, which makes Unix programs harder to port. (But this is
+irrelevant for XEmacs since it's already ported to Win32.)
+
+See ＠uref{http://www.mingw.org/} for more information on MinGW.
+
+＠node Q1.2.6, Q1.2.7, Q1.2.5, Introduction
+＠unnumberedsubsec Q1.2.6: What are the differences between the various MS Windows emacsen?
+
+XEmacs, Win-Emacs, DOS Emacs, NT Emacs, this is all very confusing.
+Could you briefly explain the differences between them?
+
+Here is a recount of various Emacs versions running on MS Windows:
+
+＠itemize ＠bullet
+
+＠item
+XEmacs
+
+＠itemize ＠minus
+
+＠item
+Beginning with XEmacs 19.12, XEmacs' architecture was redesigned
+in such a way to allow clean support of multiple window systems. At
+this time the TTY support was added, making X and TTY the first two
+"window systems" supported by XEmacs. The 19.12 design is the basis for
+the current native MS Windows code.
+
+＠item
+Some time during 1997, David Hobley (soon joined by Marc Paquette)
+imported some of the NT-specific portions of GNU Emacs, making XEmacs
+with X support compile under Windows NT, and creating the "X" port.
+
+＠item
+Several months later, Jonathan Harris sent out initial patches to use
+the Win32 API, thus creating the native port. Since then, various
+people have contributed, including Kirill M. Katsnelson (contributed
+support for menubars, subprocesses and network, as well as loads of
+other code), Andy Piper (ported XEmacs to Cygwin environment,
+contributed Windows unexec, Windows-specific glyphs and toolbars code,
+and more), Ben Wing (loads of improvements; primary MS Windows developer
+since 2000), Jeff Sparkes (contributed scrollbars support) and many
+others.
+＠end itemize
+
+＠item
+NT Emacs
+
+＠itemize ＠minus
+
+＠item
+NT Emacs was an early version of GNU Emacs 19 modified to compile and
+run under MS Windows 95 and NT using the native Win32 API. It was
+written by Geoff Voelker, and has long since been incorporated into
+the mainline GNU Emacs distribution.
+＠end itemize
+
+＠item
+Win-Emacs
+
+＠itemize ＠minus
+
+＠item
+Win-Emacs was a port of Lucid Emacs 19.6 to MS Windows using X
+compatibility libraries. Win-Emacs was written by Ben Wing. The MS
+Windows code never made it back to Lucid Emacs, and its creator (Pearl
+Software) has long since gone out of business.
+＠end itemize
+
+＠item
+GNU Emacs for DOS
+
+＠itemize ＠minus
+
+＠item
+GNU Emacs features support for MS-DOS and DJGPP (D.J. Delorie's DOS
+port of GCC). Such an Emacs is heavily underfeatured, because it does
+not support long file names, lacks proper subprocesses support, and
+is far too big compared with typical DOS editors.
+＠end itemize
+
+＠item
+GNU Emacs compiled with Win32
+
+＠itemize ＠minus
+
+＠item
+Starting with GNU Emacs 19.30, it has been possible to compile GNU Emacs
+under MS Windows using the DJGPP compiler and X libraries. The result
+is very similar to GNU Emacs compiled under MS DOS, only it works
+somewhat better because it runs in 32-bit mode, makes use of all the
+system memory, supports long file names, etc.
+＠end itemize
+
+＠end itemize
+
+＠node Q1.2.7, Q1.2.8, Q1.2.6, Introduction
+＠unnumberedsubsec Q1.2.7: How does the port cope with differences in the Windows user interface?
+
+The XEmacs (and Emacs in general) user interface is pretty different
+from what is expected of a typical MS Windows program. How does the MS
+Windows port cope with it?
+
+As a general rule, we follow native MS Windows conventions as much as
+possible. 21.4 is a fairly complete Windows application, supporting
+native printing, system file dialog boxes, tool tips, etc. In cases
+where there's a clear UI conflict, we currently use normal Unix XEmacs
+behavior by default, but make sure the MS Windows "look and feel" (mark
+via shift-arrow, self-inserting deletes region, Alt selects menu items,
+etc.) is easily configurable (respectively: using the variable
+＠code{shifted-motion-keys-select-region} in 21.4 and above [it's in fact
+the default in these versions], or the ＠file{pc-select} package; using
+the ＠file{pending-del} package; and setting the variable
+＠code{menu-accelerator-enabled} to ＠code{menu-force} in 21.4 and above).
+In fact, if you use the sample ＠file{init.el} file as your init file,
+you will get all these behaviors automatically turned on.
+
+In future versions, some of these features might be turned on by
+default in the MS Windows environment.
+
+＠node Q1.2.8, Q1.2.9, Q1.2.7, Introduction
+＠unnumberedsubsec Q1.2.8: Is there a port of XEmacs to the Macintosh?
+
+Yes.
+
+XEmacs 21.5 (perhaps 21.4 also?) works on MacOS X, although it certainly
+will not feel very much like a Mac application as it has no Mac-specific
+code in it.
+
+There is also a port of XEmacs 19.14 that works on all recent versions
+of MacOS, from 8.1 through MacOS X, by ＠email{pjarvis＠(a)ispchannel.com,
+Pitts Jarvis} (recently deceased). It runs in an equivalent of TTY
+mode only (one single Macintosh window, 25 colors), but has a large
+number of Mac-specific additions. It's available at
+＠uref{http://homepage.mac.com/pjarvis/xemacs.html}.
+
+＠node Q1.2.9, Q1.2.10, Q1.2.8, Introduction
+＠unnumberedsubsec Q1.2.9: Is there a port of XEmacs to the Macintosh?
+
+Yes.
+
+XEmacs 21.5 (perhaps 21.4 also?) works on MacOS X, although it certainly
+will not feel very much like a Mac application as it has no Mac-specific
+code in it.
+
+There is also a port of XEmacs 19.14 that works on all recent versions
+of MacOS, from 8.1 through MacOS X, by ＠email{pjarvis＠(a)ispchannel.com,
+Pitts Jarvis} (recently deceased). It runs in an equivalent of TTY
+mode only (one single Macintosh window, 25 colors), but has a large
+number of Mac-specific additions. It's available at
+＠uref{http://homepage.mac.com/pjarvis/xemacs.html}.
+
+＠node Q1.2.10, Q1.2.11, Q1.2.9, Introduction
+＠unnumberedsubsec Q1.2.10: Is there a port of XEmacs to MS-DOS?
+
+No. We have never supported running on MS-DOS or Windows 3.1, and in
+fact have long since deleted all MS-DOS-related code.
+
+＠node Q1.2.11, Q1.2.12, Q1.2.10, Introduction
+＠unnumberedsubsec Q1.2.11: Is there a port of XEmacs to OS/2?
+
+No, but Alexander Nikolaev <avn_1251＠(a)mail.ru> was at one point
+working on it.
+
+＠node Q1.2.12, Q1.2.13, Q1.2.11, Introduction
+＠unnumberedsubsec Q1.2.12: Is there a port of XEmacs to NextStep?
+
+Carl Edman, apparently no longer at ＠email{cedman＠(a)princeton.edu}, did
+the port of GNU Emacs to NeXTstep and expressed interest in doing the
+XEmacs port, but never went any farther.
+
+＠node Q1.2.13, Q1.3.1, Q1.2.12, Introduction
+＠unnumberedsubsec Q1.2.13: Is there a port of XEmacs to VMS?
+
+VMS has never been supported by XEmacs. In fact, all the old VMS code
+inherited from GNU Emacs has been removed. Sorry, all you VMS fans
+out there.
+
+＠unnumberedsec 1.3: Getting Started
+
+＠node Q1.3.1, Q1.3.2, Q1.2.13, Introduction
+＠unnumberedsubsec Q1.3.1: What is an ＠file{init.el} or ＠file{.emacs} and is there a sample one?
+
+The ＠file{init.el} or ＠file{.emacs} file is used to customize XEmacs to
+your tastes. Starting in 21.4, the preferred location for the init file
+is ＠file{~/.xemacs/init.el}; in previous versions, it was
+(a)file{~/.emacs}. 21.4 still accepts the old location, but the first
+time you run it, it will ask to migrate your file to the new location.
+If you answer yes, the file will be moved, and a "compatibility"
+(a)file{.emacs} file will be placed in the old location so that you can
+still run older versions of XEmacs, and versions of GNU Emacs, which
+expect the old location. The ＠file{.emacs} file present is just a stub
+that loads the real file in ＠file{~/.xemacs/init.el}.
+
+No two init files are alike, nor are they expected to be alike, but
+that's the point. The XEmacs distribution contains an excellent starter
+example in the ＠file{etc/} directory called ＠file{sample.init.el}
+(starting in 21.4) or ＠file{sample.emacs} in older versions. Copy this
+file from there to ＠file{~/.xemacs/init.el} (starting in 21.4) or
+(a)file{~/.emacs} in older versions, where ＠samp{~} means your home
+directory, of course. Then edit it to suit.
+
+You may bring the ＠file{sample.init.el} or ＠file{sample.emacs} file into
+an XEmacs buffer from the menubar. (The menu entry for it is always
+under the ＠samp{Help} menu, but its location under that has changed in
+various versions. Recently, look under the ＠samp{Samples} submenu.) To
+determine the location of the ＠file{etc/} directory type the command
+＠kbd{C-h v data-directory ＠key{RET}}.
+
+＠node Q1.3.2, Q1.3.3, Q1.3.1, Introduction
+＠unnumberedsubsec Q1.3.2: Where do I put my ＠file{init.el} file?
+
+(a)file{init.el} is the name of the init file starting with 21.4, and is
+located in the subdirectory ＠file{.xemacs/} of your home directory. In
+prior versions, the init file is called ＠file{.emacs} and is located in
+your home directory.
+
+Your home directory under Windows is determined by the ＠samp{HOME}
+environment variable. If this is not set, it defaults to ＠samp{C:\}.
+To set this variable, modify ＠file{AUTOEXEC.BAT} under Windows 95/98, or
+select ＠samp{Control Panel->System->Advanced->Environment Variables...}
+under Windows NT/2000.
+
+＠node Q1.3.3, Q1.3.4, Q1.3.2, Introduction
+＠unnumberedsubsec Q1.3.3: Can I use the same ＠file{init.el} with the other Emacs?
+
+Yes. The sample ＠file{init.el} included in the XEmacs
+distribution will show you how to handle different versions and flavors
+of Emacs.
+
+＠node Q1.3.4, Q1.3.5, Q1.3.3, Introduction
+＠unnumberedsubsec Q1.3.4: Any good XEmacs tutorials around?
+
+There's the XEmacs tutorial available from the Help Menu under
+＠samp{Help->Tutorials}, or by typing ＠kbd{C-h t}. To check whether
+it's available in a non-english language, type ＠kbd{C-u C-h t TAB}, type
+the first letters of your preferred language, then type ＠key{RET}.
+
+＠comment There's an Emacs Lisp tutorial at
+＠comment
+＠comment ＠example
+＠comment ＠uref{ftp://prep.ai.mit.edu/pub/gnu/emacs-lisp-intro-1.04.tar.gz}.
+＠comment ＠end example
+＠comment
+＠comment ＠email{erik＠(a)petaxp.rug.ac.be, Erik Sundermann} has made a tutorial web
+＠comment page at
+＠comment ＠iftex
+＠comment ＠*
+＠comment ＠end iftex
+＠comment ＠uref{http://petaxp.rug.ac.be/~erik/xemacs/}.
+
+＠node Q1.3.5, Q1.3.6, Q1.3.4, Introduction
+＠unnumberedsubsec Q1.3.5: May I see an example of a useful XEmacs Lisp function?
+
+The following function does a little bit of everything useful. It does
+something with the prefix argument, it examines the text around the
+cursor, and it's interactive so it may be bound to a key. It inserts
+copies of the current word the cursor is sitting on at the cursor. If
+you give it a prefix argument: ＠kbd{C-u 3 M-x double-word} then it will
+insert 3 copies.
+
+＠lisp
+(defun double-word (count)
+ "Insert a copy of the current word underneath the cursor"
+ (interactive "*p")
+ (let (here there string)
+ (save-excursion
+ (forward-word -1)
+ (setq here (point))
+ (forward-word 1)
+ (setq there (point))
+ (setq string (buffer-substring here there)))
+ (while (>= count 1)
+ (insert string)
+ (decf count))))
+＠end lisp
+
+The best way to see what is going on here is to let XEmacs tell you.
+Put the code into an XEmacs buffer, and do a ＠kbd{C-h f} with the cursor
+sitting just to the right of the function you want explained. Eg. move
+the cursor to the SPACE between ＠code{interactive} and ＠samp{"*p"} and
+hit ＠kbd{C-h f} to see what the function ＠code{interactive} does. Doing
+this will tell you that the ＠code{*} requires a writable buffer, and
+＠code{p} converts the prefix argument to a number, and
+＠code{interactive} allows you to execute the command with ＠kbd{M-x}.
+
+＠node Q1.3.6, Q1.3.7, Q1.3.5, Introduction
+＠unnumberedsubsec Q1.3.6: And how do I bind it to a key?
+
+To bind to a key do:
+
+＠lisp
+(global-set-key "\C-cd" 'double-word)
+＠end lisp
+
+Or interactively, ＠kbd{M-x global-set-key} and follow the prompts.
+
+＠node Q1.3.7, Q1.3.8, Q1.3.6, Introduction
+＠unnumberedsubsec Q1.3.7: What's the difference between a macro and a function?
+
+Quoting from the Lisp Reference (a.k.a ＠dfn{Lispref}) Manual:
+
+＠dfn{Macros} enable you to define new control constructs and other
+language features. A macro is defined much like a function, but instead
+of telling how to compute a value, it tells how to compute another Lisp
+expression which will in turn compute the value. We call this
+expression the ＠dfn{expansion} of the macro.
+
+Macros can do this because they operate on the unevaluated expressions
+for the arguments, not on the argument values as functions do. They can
+therefore construct an expansion containing these argument expressions
+or parts of them.
+
+Do not confuse the two terms with ＠dfn{keyboard macros}, which are
+another matter, entirely. A keyboard macro is a key bound to several
+other keys. Refer to manual for details.
+
+＠node Q1.3.8, Q1.4.1, Q1.3.7, Introduction
+＠unnumberedsubsec Q1.3.8: What is ＠code{Custom}?
+
+＠code{Custom} is a system for customizing XEmacs options.
+
+You can access ＠code{Advanced (Customize)} from the ＠code{Options} menu
+or invoking one of customize commands by typing eg.
+＠kbd{M-x customize}, ＠kbd{M-x customize-face},
+＠kbd{M-x customize-variable} or ＠kbd{M-x customize-apropos}.
+
+There is also new ＠samp{browser} mode for Customize.
+Try it out with ＠kbd{M-x customize-browse}
+
+＠unnumberedsec 1.4: Getting Help
+
+＠node Q1.4.1, Q1.4.2, Q1.3.8, Introduction
+＠unnumberedsubsec Q1.4.1: Where can I get help?
+
+Probably the easiest way, if everything is installed, is to use Info, by
+pressing ＠kbd{C-h i}, or looking for an Info item on the
+Help Menu. ＠kbd{M-x apropos} can be used to look for particular commands.
+
+For items not found in the manual, try reading this FAQ
+and reading the Usenet group comp.emacs.xemacs.
+
+If you choose to post to a newsgroup, ＠strong{please use
+comp.emacs.xemacs}. Please do not post XEmacs related questions to
+gnu.emacs.help.
+
+If you cannot post or read Usenet news, there is a corresponding mailing
+list ＠email{xemacs-news＠(a)xemacs.org} which is available. It can be
+subscribed to via the Mailman Web interface or by sending mail to to
+＠email{xemacs-news-request＠(a)xemacs.org} with ＠samp{subscribe} in the
+body of the message. See also
+＠uref{http://www.xemacs.org/Lists/#xemacs-news}. To cancel a
+subscription, you may use the ＠email{xemacs-news-request＠(a)xemacs.org}
+address or the Web interface. Send a message with a subject of
+＠samp{unsubscribe} to be removed.
+
+＠node Q1.4.2, Q1.4.3, Q1.4.1, Introduction
+＠unnumberedsubsec Q1.4.2: Which mailing lists are there?
+
+For complete, up-to-date info on the lists and how to subscribe, see
+＠uref{http://www.xemacs.org/Lists/}.
+
+＠table ＠samp
+
+＠item comp.emacs.xemacs
+is a Usenet newsgroup
+for XEmacs users to discuss problems and issues that arise
+for them. It's not generally an appropriate place to ask
+about apparent bugs (use ＠samp{xemacs-beta}), or future plans
+(use ＠samp{xemacs-design}).
+
+＠item xemacs-announce
+is a read-only, low
+volume list for announcements concerning the XEmacs project
+and new releases of the XEmacs software.
+
+＠item xemacs-beta
+is an open list for bug
+reports about beta versions of XEmacs. This includes the bug
+reports themselves, by both users and developers, as well as
+queries, follow-ups, and discussions further determining their
+nature and status. This is the primary channel for this kind
+of discussion; related code changes will usually not be
+applied until they have been discussed here. When such
+discussions touch on significant changes to the code (in
+particular, structural changes), or on changes to API's or
+external functionality, they should be moved to
+＠samp{xemacs-design}. Requests and proposals for
+non-bug-related changes do not belong on ＠samp{xemacs-beta},
+and should be sent to ＠samp{xemacs-design} instead.
+
+＠item xemacs-beta-ja
+is an open list for bug
+reports and design discussion related to Mule features,
+including Japanese handling, in beta versions of XEmacs.
+Japanese is the preferred language of discussion. For most
+timely presentation to reviewers, please consider sending
+appropriate discussion to ＠samp{xemacs-mule} or
+＠samp{xemacs-design} in English when convenient for
+the participants in discussion. When possible, bug reports
+not related to Mule (including Japanese) should be reported on
+＠samp{xemacs-beta} in English.
+
+＠item xemacs-buildreports
+is an open list for
+submission of build-reports on beta versions of XEmacs. For
+information on what the build-reports should contain, please
+see the `etc/BETA' file which is included in each beta
+distribution.
+
+＠item xemacs-cvs
+is a read-only list for notices
+and information on what has been committed to the XEmacs CVS
+trees, by whom, and for what.
+
+＠item xemacs-design
+is an open list for
+discussing the design of XEmacs. This includes discussion
+about planned and ongoing changes to functionality and API
+changes and additions as well as requests for them. This is
+the primary channel for this kind of discussion; related code
+changes will usually not be applied until they have been
+discussed here. This does not include bug reports, which go
+to ＠samp{xemacs-beta}.
+
+＠item xemacs-mule
+is an open mailing list for
+discussion of International extensions to XEmacs including
+Mule, XIM, I18n issues, etc, and is not confined to
+developmental issues. This list is not restricted to
+English, postings in all languages are welcome.
+
+＠item xemacs-news
+is an open list for discussion
+and bug reporting for XEmacs. This mailing list is
+bi-directionally gatewayed with the USENET newsgroup
+comp.emacs.xemacs.
+
+＠item xemacs-nt
+is a developers-only mailing
+list and is intended for people who wish to work actively on
+the porting of XEmacs to Microsoft Windows NT and Microsoft
+Windows '95.
+
+＠item xemacs-patches
+is an open, moderated
+list for submission of patches to the XEmacs distribution
+and its packages. Anyone may subscribe or submit to
+xemacs-patches, but all submissions are reviewed by the list
+moderator before they are distributed to the
+list. Discussion is not appropriate on xemacs-patches.
+
+＠item xemacs-users-ja
+is an open list for
+discussion and bug reporting for XEmacs. Japanese is the
+preferred language of discussion. It is not gated to
+comp.emacs.xemacs or the ＠samp{xemacs} list. For
+fastest response, bugs not specifically related to Japanese
+or Mule features should be reported on
+＠samp{xemacs-beta} (in English).
+
+＠item xemacs-users-ru
+is an open list for
+discussion and bug reporting for XEmacs. Russian is the
+preferred language of discussion. It is not gated to
+comp.emacs.xemacs or the ＠samp{xemacs} list. For
+fastest response, bugs not specifically related to Russian
+or Mule features should be reported on
+＠samp{xemacs-beta} (in English).
+＠end table
+
+＠node Q1.4.3, Q1.4.4, Q1.4.2, Introduction
+＠unnumberedsubsec Q1.4.3: Where are the mailing lists archived?
+
+The archives can be found at ＠uref{http://list-archive.xemacs.org}
+
+＠node Q1.4.4, Q1.4.5, Q1.4.3, Introduction
+＠unnumberedsubsec Q1.4.4: How can I get two instances of info?
+
+Before 21.4, you can't. The ＠code{info} package does not provide for
+multiple info buffers. In 21.4, this should be fixed. #### how?
+
+＠node Q1.4.5, Q1.5.1, Q1.4.4, Introduction
+＠unnumberedsubsec Q1.4.5: How do I add new Info directories?
+
+You use something like:
+
+＠lisp
+(setq Info-directory-list (cons
+ (expand-file-name "~/info")
+ Info-default-directory-list))
+＠end lisp
+
+＠email{davidm＠(a)prism.kla.com, David Masterson} writes:
+
+＠quotation
+Emacs Info and XEmacs Info do many things differently. If you're trying to
+support a number of versions of Emacs, here are some notes to remember:
+
+＠enumerate
+＠item
+Emacs Info scans ＠code{Info-directory-list} from right-to-left while
+XEmacs Info reads it from left-to-right, so append to the ＠emph{correct}
+end of the list.
+
+＠item
+Use ＠code{Info-default-directory-list} to initialize
+＠code{Info-directory-list} ＠emph{if} it is available at startup, but not
+all Emacsen define it.
+
+＠item
+Emacs Info looks for a standard ＠file{dir} file in each of the
+directories scanned from #1 and magically concatenates them together.
+
+＠item
+XEmacs Info looks for a ＠file{localdir} file (which consists of just the
+menu entries from a ＠file{dir} file) in each of the directories scanned
+from #1 (except the first), does a simple concatenation of them, and
+magically attaches the resulting list to the end of the menu in the
+＠file{dir} file in the first directory.
+＠end enumerate
+
+Another alternative is to convert the documentation to HTML with
+texi2html and read it from a web browser like Lynx or W3.
+＠end quotation
+
+＠unnumberedsec 1.5: Contributing to XEmacs
+
+＠node Q1.5.1, Q1.5.2, Q1.4.5, Introduction
+＠unnumberedsubsec Q1.5.1: How do I submit changes to the FAQ?
+
+The FAQ is actively maintained and modified regularly. All links should
+be up to date. Unfortunately, some of the information is out of date --
+a situation which the FAQ maintainer is working on. All submissions are
+welcome, please e-mail submissions to ＠email{faq＠(a)xemacs.org, XEmacs FAQ
+maintainers}.
+
+Please make sure that ＠samp{XEmacs FAQ} appears on the Subject: line.
+If you think you have a better way of answering a question, or think a
+question should be included, we'd like to hear about it. Questions and
+answers included into the FAQ will be edited for spelling and grammar
+and will be attributed. Answers appearing without attribution are
+either from versions of the FAQ dated before May 1996 or are from
+previous FAQ maintainers. Answers quoted from Usenet news articles will
+always be attributed, regardless of the author.
+
+＠node Q1.5.2, Q1.5.3, Q1.5.1, Introduction
+＠unnumberedsubsec Q1.5.2: How do I become a beta tester?
+
+Send an email message to ＠email{xemacs-beta-request＠(a)xemacs.org} with
+the line ＠samp{subscribe} in the body of the message.
+
+Be prepared to get your hands dirty, as beta testers are expected to
+identify problems as best they can.
+
+＠node Q1.5.3, Q1.6.1, Q1.5.2, Introduction
+＠unnumberedsubsec Q1.5.3: How do I contribute to XEmacs itself?
+
+It depends on the knowledge and time you possess. If you are able, by
+all means become a beta tester (＠pxref{Q1.5.2}). If you are a
+programmer, try to build XEmacs and see if you can improve it.
+
+Otherwise, you can still help by using XEmacs as your everyday editor
+(for pre-built binary versions, ＠pxref{Q1.1.2}) and reporting bugs you
+find to the mailing list.
+
+Another area where we need help is the documentation: We need good
+documentation for building XEmacs and for using it. This FAQ is a
+small step in that direction.
+
+Ben Wing ＠email{ben＠(a)xemacs.org} writes:
+
+＠quotation
+BTW if you have a wish list of things that you want added, you have to
+speak up about it! More specifically, you can do the following if you
+want a feature added (in increasing order of usefulness):
+
+＠itemize ＠bullet
+＠item
+Make a posting about a feature you want added.
+
+＠item
+Become a beta tester and make more postings about those same features.
+
+＠item
+Convince us that you're going to use the features in some cool and
+useful way.
+
+＠item
+Come up with a clear and well-thought-out API concerning the features.
+
+＠item
+Write the code to implement a feature and send us a patch.
+＠end itemize
+
+(not that we're necessarily requiring you to write the code, but we can
+always hope :)
+＠end quotation
+
+＠unnumberedsec 1.6: Politics (XEmacs vs. GNU Emacs)
+
+＠node Q1.6.1, Q1.6.2, Q1.5.3, Introduction
+＠unnumberedsubsec Q1.6.1: What is GNU Emacs?
+
+GNU Emacs and XEmacs are related open-source text editors. Both
+derive from GNU Emacs version 18; the split between the two happened
+in 1991 (for comparison, the oldest versions of GNU Emacs date from
+1984). For information on GNU Emacs, see
+＠uref{http://www.gnu.org/software/emacs/emacs.html}.
+
+＠node Q1.6.2, Q1.6.3, Q1.6.1, Introduction
+＠unnumberedsubsec Q1.6.2: How does XEmacs differ from GNU Emacs?
+
+For a detailed description of the differences between GNU Emacs and
+XEmacs and a detailed history of XEmacs, check out the
+＠example
+＠uref{http://www.xemacs.org/About/XEmacsVsGNUemacs.html, NEWS file}
+＠end example
+
+＠table ＠strong
+＠item User-Visible Editing Features
+XEmacs in general tries hard to conform to exist user-interface
+standards, and to work "out-of-the-box" without the need for obscure
+customization changes. GNU Emacs, particularly version 21, has gotten
+better about this (in many cases by copying the XEmacs behavior!), but
+still has some weirdnesses. For example, the standard method of
+selecting text using the Shift key works out-of-the-box in XEmacs.
+
+XEmacs has a built-in toolbar. Four toolbars can actually be configured
+simultaneously: top, bottom, left, and right toolbars.
+
+XEmacs has vertical and horizontal scrollbars. Unlike in GNU Emacs 19
+(which provides a primitive form of vertical scrollbar), these are true
+toolkit scrollbars. A look-alike Motif scrollbar is provided for those
+who don't have Motif. (Even for those who do, the look-alike may be
+preferable as it is faster.)
+
+XEmacs has buffer tabs along the top of the frame (although the
+position can be changed) that make it very easy to switch buffers.
+
+The menubar under XEmacs is better-designed, with more thought put into
+it.
+
+XEmacs can ask questions using popup dialog boxes. Any command executed
+from a menu will ask yes/no questions with dialog boxes, while commands
+executed via the keyboard will use the minibuffer.
+
+XEmacs under MS Windows provides uses the standard file-dialog box for
+opening and saving files. Standard menu-accelerator behavior can easily
+be enabled using the Options menu, and integrates well into the existing
+keymap.
+
+XEmacs has (still experimental) support for widgets of various sorts --
+buttons, text boxes, sliders, progress bars, etc. A progress bar is
+used in font lock to show the progress.
+
+Experimental support for drag-and-drop protocols is provided from
+XEmacs 21.
+
+＠item General Platform Support
+If you're running on a machine with audio hardware, you can specify
+sound files for XEmacs to play instead of the default X beep. See the
+documentation of the function load-sound-file and the variable
+sound-alist. XEmacs also supports the network sound protocols NAS and
+EsounD.
+
+XEmacs 21 supports database protocols with LISP bindings, currently
+including Berkeley DB, LDAP, and PostgreSQL (21.2 only).
+
+XEmacs 20 and 21 support the Canna, Wnn, and SJ3 Japanese input method
+servers directly, as well as through the X Input Method (XIM)
+protocol. GNU Emacs 20 supports only the XIM protocol. Both Emacsen
+support the Quail family of input methods (implemented in LISP) for many
+languages.
+
+XEmacs provides support for ToolTalk on systems that have
+it.
+
+＠item Packaged LISP Libraries
+Many more packages are provided standard with XEmacs than with GNU Emacs
+19 or 20.
+
+XEmacs 21 supports an integrated package management system which uses
+EFS to download, then automatically install prebuilt LISP
+libraries. This allows XEmacs users much more straightforward access to
+the "latest and greatest" version of any given library.
+
+We are working on a standard method for enabling, disabling and
+otherwise controlling packages, which should make them very easy to use.
+
+＠item LISP Programming
+From XEmacs 20 on, characters are a separate type. Characters can be
+converted to integers (and many integers can be converted to
+characters), but characters are not integers. GNU Emacs 19, XEmacs 19,
+Mule 2.3 (an extensive patch to GNU Emacs 18.55 and 19.x), and GNU Emacs
+20 (incorporating Mule 3 and later Mule 4) represent them as integers.
+
+From XEmacs 20 on, the buffer is treated as an array of characters, and
+the representation of buffer text is not exposed to LISP. The GNU Emacs
+20 functions like buffer-as-multibyte are not supported.
+
+In XEmacs, events are first-class objects. GNU Emacs 19 represents them
+as integers, which obscures the differences between a key gesture and
+the ancient ASCII code used to represent a particular overlapping subset
+of them.
+
+In XEmacs, keymaps are first-class opaque objects. GNU Emacs 19
+represents them as complicated combinations of association lists and
+vectors. If you use the advertised functional interface to manipulation
+of keymaps, the same code will work in XEmacs, GNU Emacs 18, and GNU
+Emacs 19; if your code depends on the underlying implementation of
+keymaps, it will not.
+
+XEmacs uses "extents" to represent all non-textual aspects of buffers;
GNU Emacs 19 uses two distinct objects, "text properties" and
"overlays", which divide up the functionality between them. Extents are
a superset of the union of the functionality of the two GNU Emacs data
＠＠ -850,11 +1948,11 ＠＠
automatically qualify for CVS accounts for their packages.
＠end table
-＠node Q1.0.6, Q1.0.7, Q1.0.5, Introduction
-＠unnumberedsubsec Q1.0.6: How much does XEmacs differ?
+＠node Q1.6.3, Q1.6.4, Q1.6.2, Introduction
+＠unnumberedsubsec Q1.6.3: How much does XEmacs differ?
RMS has asserted at times that XEmacs is merely a "patch" on top of
-GNU Emacs (＠pxref{Q1.0.7}). In fact, probably not more than 5% of the
+GNU Emacs (＠pxref{Q1.6.4}). In fact, probably not more than 5% of the
code, if that, remains unchanged, and nearly 14 years of work has gone
into XEmacs at this point. (GNU Emacs itself is only than 20 years
old, and thus XEmacs has existed as a separate product for over 2/3 of
＠＠ -870,8 +1968,8 ＠＠
This stems from self-imposed licensing restrictions on the part of GNU
Emacs -- and almost certainly out of hostility, as well.)
-＠node Q1.0.7, Q1.0.8, Q1.0.6, Introduction
-＠unnumberedsubsec Q1.0.7: Is XEmacs "GNU"?
+＠node Q1.6.4, Q1.6.5, Q1.6.3, Introduction
+＠unnumberedsubsec Q1.6.4: Is XEmacs "GNU"?
RMS insists on the term "GNU XEmacs" and maintains that
＠＠ -884,7 +1982,7 ＠＠
＠end quotation
In fact, FSF is ＠emph{not} the copyright holder for most of the code,
-as very little unmodified FSF code remains (＠pxref{Q1.0.6}).
+as very little unmodified FSF code remains (＠pxref{Q1.6.3}).
Furthermore, RMS's assertion that XEmacs is "GNU" seems rather bizarre
to the XEmacs developers given RMS's hostility and general lack of
＠＠ -897,8 +1995,8 ＠＠
non-GNU software projects on the FSF web site, but again XEmacs is not
one of them.
-＠node Q1.0.8, Q1.0.9, Q1.0.7, Introduction
-＠unnumberedsubsec Q1.0.8: What is the correct way to refer to XEmacs and GNU Emacs?
+＠node Q1.6.5, Q1.6.6, Q1.6.4, Introduction
+＠unnumberedsubsec Q1.6.5: What is the correct way to refer to XEmacs and GNU Emacs?
Unfortunately even the naming of these two applications has become
politicized. Much of this stems from RMS, who has a history of
＠＠ -907,12 +2005,12 ＠＠
Emacs" be used, which are neutral and acceptable to most people. RMS,
however, is not willing to accept these terms. He insists that, if
his product is called "GNU Emacs", then ours must be called "GNU
-XEmacs". (For our opinion of this term, ＠xref{Q1.0.7}.) On the other
+XEmacs". (For our opinion of this term, ＠xref{Q1.6.4}.) On the other
hand, if our product is to be called "XEmacs", as we prefer, then his
product must simply be called "Emacs". The intent of this seems
clear: RMS wants to make sure the names reflect his view that his
version is the "real" Emacs and ours is merely a derivative,
-second-class product (＠pxref{Q1.0.6}).
+second-class product (＠pxref{Q1.6.3}).
The XEmacs developers hope that you will use the neutral terms
"XEmacs" and "GNU Emacs" for these two specific products. "Emacs", on
＠＠ -933,8 +2031,8 ＠＠
to be insulting, so we refrain from using them as much as possible in
preference to GNU Emacs.)
-＠node Q1.0.9, Q1.0.10, Q1.0.8, Introduction
-＠unnumberedsubsec Q1.0.9: Why haven't XEmacs and GNU Emacs merged?
+＠node Q1.6.6, Q1.7.1, Q1.6.5, Introduction
+＠unnumberedsubsec Q1.6.6: Why haven't XEmacs and GNU Emacs merged?
There are currently irreconcilable differences in the views about
technical, programming, design, organizational and legal matters
＠＠ -1013,656 +2111,426 ＠＠
avoid posting to the newsgroups, because of the very heated flamewars
that often result. Mail your questions to
＠email{xemacs-beta＠(a)xemacs.org} and ＠email{emacs-devel＠(a)gnu.org}.
-
-＠node Q1.0.10, Q1.0.11, Q1.0.9, Introduction
-＠unnumberedsubsec Q1.0.10: Where can I get help?
-
-Probably the easiest way, if everything is installed, is to use Info, by
-pressing ＠kbd{C-h i}, or looking for an Info item on the
-Help Menu. ＠kbd{M-x apropos} can be used to look for particular commands.
-
-For items not found in the manual, try reading this FAQ
-and reading the Usenet group comp.emacs.xemacs.
-
-If you choose to post to a newsgroup, ＠strong{please use
-comp.emacs.xemacs}. Please do not post XEmacs related questions to
-gnu.emacs.help.
-
-If you cannot post or read Usenet news, there is a corresponding mailing
-list ＠email{xemacs-news＠(a)xemacs.org} which is available. It can be
-subscribed to via the Mailman Web interface or by sending mail to to
-＠email{xemacs-news-request＠(a)xemacs.org} with ＠samp{subscribe} in the
-body of the message. See also
-＠uref{http://www.xemacs.org/Lists/#xemacs-news}. To cancel a
-subscription, you may use the ＠email{xemacs-news-request＠(a)xemacs.org}
-address or the Web interface. Send a message with a subject of
-＠samp{unsubscribe} to be removed.
-
-＠node Q1.0.11, Q1.0.12, Q1.0.10, Introduction
-＠unnumberedsubsec Q1.0.11: Where are the mailing lists archived?
-
-The archives can be found at ＠uref{http://list-archive.xemacs.org}
-
-＠node Q1.0.12, Q1.0.13, Q1.0.11, Introduction
-＠unnumberedsubsec Q1.0.12: How do you pronounce XEmacs?
-
-The most common pronounciation is ＠samp{Eks eemax}.
-
-＠node Q1.0.13, Q1.0.14, Q1.0.12, Introduction
-＠unnumberedsubsec Q1.0.13: What does XEmacs look like?
-
-Screen snapshots are available at
-＠uref{http://www.xemacs.org/About/Screenshots/index.html}
-as part of the XEmacs website.
-＠node Q1.0.14, Q1.1.1, Q1.0.13, Introduction
-＠unnumberedsubsec Q1.0.14: Where can I obtain a printed copy of the XEmacs User's Manual?
+＠unnumberedsec 1.7: External Packages
-Pre-printed manuals are not available. If you are familiar with
-TeX, you can generate your own manual from the XEmacs sources.
+＠node Q1.7.1, Q1.8.1, Q1.6.6, Introduction
+＠unnumberedsubsec Q1.7.1: Which external packages are there?
-HTML and Postscript versions of XEmacs manuals are available from the
-XEmacs web site at
-＠uref{http://www.xemacs.org/Documentation/index.html}.
+＠subheading Normal Packages
-＠unnumberedsec 1.1: Versions for Different Operating Systems
+A very broad collection of elisp packages.
-＠node Q1.1.1, Q1.1.2, Q1.0.14, Introduction
-＠unnumberedsubsec Q1.1.1: Do I need X11 to run XEmacs?
+＠table ＠asis
+＠item Sun
+Support for Sparcworks.
-No. The name ＠dfn{XEmacs} is unfortunate in the sense that it is
-＠strong{not} an X Window System-only version of Emacs. XEmacs has
-full color support on a color-capable character terminal.
+＠item ada
+Ada language support.
-＠node Q1.1.2, Q1.1.3, Q1.1.1, Introduction
-＠unnumberedsubsec Q1.1.2: Is there a port of XEmacs to Microsoft Windows?
+＠item apel
+A Portable Emacs Library. Used by XEmacs MIME support.
-Yes. Beginning with release 21.0, XEmacs has worked under MS Windows
-and is fully-featured and actively developed. A group of dedicated
-developers actively maintains and improves the Windows-specific
-portions of the code. Some of the core developers, in fact, use
-Windows as their only development environment, and some features, such
-as printing, actually work better on Windows than native Unix and Mac
-OS X. The mailing list at ＠email{xemacs-winnt＠(a)xemacs.org} is dedicated
-to that effort (please use the -request address to
-subscribe). (Despite its name, XEmacs actually works on all versions
-of Windows.)
+＠item auctex
+Basic TeX/LaTeX support.
-The list name is misleading, as XEmacs supports and has been compiled on
-Windows 95, Windows 98, Windows NT, Windows 2000, Windows ME, Windows
-XP, and all newer versions of Windows. The MS Windows-specific code is
-based on Microsoft Win32 API, and will not work on MS Windows 3.x or on
-MS-DOS.
+＠item bbdb
+The Big Brother Data Base: a rolodex-like database program.
-XEmacs also supports the Cygwin and MinGW development and runtime
-environments, where it also uses native Windows code for graphical
-features. In addition, under Cygwin it is possible to compile XEmacs
-to use an X server (and XFree86 is available as part of the standard
-Cygwin installation).
+＠item build
+Build XEmacs from within (UNIX, Windows).
-＠node Q1.1.3, Q1.1.4, Q1.1.2, Introduction
-＠unnumberedsubsec Q1.1.3: Can I build XEmacs on MS Windows with X support? Do I need to?
+＠item c-support
+Basic single-file add-ons for editing C code.
-Yes, you can, but no you do not need to. In fact, we recommend that you
-use a native-GUI version unless you have a specific need for an X
-version.
+＠item calc
+Emacs calculator.
-＠node Q1.1.4, Q1.1.5, Q1.1.3, Introduction
-＠unnumberedsubsec Q1.1.4: What are Cygwin and MinGW, and do I need them to run XEmacs?
+＠item calendar
+Calendar and diary support.
-To answer the second part of the question: No, you, you don't need
-Cygwin or MinGW to build or to run XEmacs. But if you have them and
-want to use them, XEmacs supports these environments.
+＠item cc-mode
+C, C++, Objective-C, Java, CORBA IDL, Pike and AWK language support.
-(One important reason to support Cygwin is that it lets the MS Windows
-developers test out their code in a Unix environment without actually
-having to have a Unix machine around. For this reason alone, Cygwin
-support is likely to remain supported for a long time in XEmacs. Same
-goes for the X support under Cygwin, for the same reasons. MinGW
-support, on the other hand, depends on volunteers to keep it up to date;
-but this is generally not hard.)
+＠item clearcase
+New Clearcase Version Control for XEmacs (UNIX, Windows).
-Cygwin is a set of tools providing Unix-like API on top of Win32.
-It makes it easy to port large Unix programs without significant
-changes to their source code. It is a development environment as well
-as a runtime environment.
+＠item clearcase
+Support for the Clearcase version control system.
-When built with Cygwin, XEmacs supports all display types -- TTY, X &
-Win32 GUI, and can be built with support for all three simultaneously.
-If you build with Win32 GUI support then the Cygwin version uses the
-majority of the Windows-specific code, which is mostly related to
-display. If you want to build with X support you need X libraries (and
-an X server to display XEmacs on); see ＠ref{Q2.2.7}. TTY and Win32 GUI
-require no additional libraries beyond what comes standard with Cygwin.
+＠item cookie
+"Fortune cookie"-style messages. Includes Spook (suspicious phrases)
+and Yow (Zippy quotes).
-The advantages of the Cygwin version are that it integrates well with
-the Cygwin environment for existing Cygwin users; uses configure so
-building with different features is very easy; and actively supports X &
-TTY. Furthermore, the entire Cygwin environment and compiler are free,
-whereas Visual C++ costs money.
+＠item crisp
+Crisp/Brief emulation.
-The disadvantage is that it requires the whole Cygwin environment,
-whereas the native port requires only a suitable MS Windows compiler.
-Also, it follows the Unix filesystem and process model very closely
-(some will undoubtedly view this as an advantage).
+＠item debug
+GUD, gdb, dbx debugging support.
-See ＠uref{http://www.cygwin.com/} for more information on
-Cygwin.
+＠item dictionary
+Interface to RFC2229 dictionary servers.
-MinGW is a collection of header files and import libraries that allow
-one to use GCC under the Cygwin environment to compile and produce
-exactly the same native Win32 programs that you can using Visual C++.
-Programs compiled with MinGW make use of the standard Microsoft runtime
-library ＠file{MSVCRT.DLL}, present on all Windows systems, and look,
-feel, and act like a standard Visual-C-produced application. (The only
-difference is the compiler.) This means that, unlike a
-standardly-compiled Cygwin application, no extra runtime support
-(e.g. Cygwin's ＠file{cygwin1.dll}) is required. This, along with the
-fact that GCC is free (and works in a nice Unix-y way in a nice Unix-y
-environment, for those die-hard Unix hackers out there), is the main
-advantage of MinGW. It is also potentially faster than Cygwin because
-it has less overhead when calling Windows, but you lose the POSIX
-emulation layer, which makes Unix programs harder to port. (But this is
-irrelevant for XEmacs since it's already ported to Win32.)
+＠item dired
+The DIRectory EDitor is for manipulating, and running commands on
+files in a directory.
-See ＠uref{http://www.mingw.org/} for more information on MinGW.
+＠item docbookide
+DocBook editing support.
-＠node Q1.1.5, Q1.1.6, Q1.1.4, Introduction
-＠unnumberedsubsec Q1.1.5: What are the differences between the various MS Windows emacsen?
+＠item ecb
+Emacs source code browser.
-XEmacs, Win-Emacs, DOS Emacs, NT Emacs, this is all very confusing.
-Could you briefly explain the differences between them?
+＠item ecrypto
+Crypto functionality in Emacs Lisp.
-Here is a recount of various Emacs versions running on MS Windows:
+＠item edebug
+An Emacs Lisp debugger.
-＠itemize ＠bullet
+＠item ediff
+Interface over GNU patch.
-＠item
-XEmacs
+＠item edit-utils
+Miscellaneous editor extensions, you probably need this.
-＠itemize ＠minus
+＠item edt
+DEC EDIT/EDT emulation.
-＠item
-Beginning with XEmacs 19.12, XEmacs' architecture was redesigned
-in such a way to allow clean support of multiple window systems. At
-this time the TTY support was added, making X and TTY the first two
-"window systems" supported by XEmacs. The 19.12 design is the basis for
-the current native MS Windows code.
+＠item efs
+Treat files on remote systems the same as local files.
-＠item
-Some time during 1997, David Hobley (soon joined by Marc Paquette)
-imported some of the NT-specific portions of GNU Emacs, making XEmacs
-with X support compile under Windows NT, and creating the "X" port.
+＠item eieio
+Enhanced Implementation of Emacs Interpreted Objects.
-＠item
-Several months later, Jonathan Harris sent out initial patches to use
-the Win32 API, thus creating the native port. Since then, various
-people have contributed, including Kirill M. Katsnelson (contributed
-support for menubars, subprocesses and network, as well as loads of
-other code), Andy Piper (ported XEmacs to Cygwin environment,
-contributed Windows unexec, Windows-specific glyphs and toolbars code,
-and more), Ben Wing (loads of improvements; primary MS Windows developer
-since 2000), Jeff Sparkes (contributed scrollbars support) and many
-others.
-＠end itemize
+＠item elib
+Portable Emacs Lisp utilities library.
-＠item
-NT Emacs
+＠item emerge
+Another interface over GNU patch.
-＠itemize ＠minus
+＠item erc
+ERC is an Emacs InternetRelayChat client.
-＠item
-NT Emacs was an early version of GNU Emacs 19 modified to compile and
-run under MS Windows 95 and NT using the native Win32 API. It was
-written by Geoff Voelker, and has long since been incorporated into
-the mainline GNU Emacs distribution.
-＠end itemize
+＠item escreen
+Multiple editing sessions withing a single frame (like screen).
-＠item
-Win-Emacs
+＠item eshell
+Command shell implemented entirely in Emacs Lisp.
-＠itemize ＠minus
+＠item ess
+ESS: Emacs Speaks Statistics.
-＠item
-Win-Emacs was a port of Lucid Emacs 19.6 to MS Windows using X
-compatibility libraries. Win-Emacs was written by Ben Wing. The MS
-Windows code never made it back to Lucid Emacs, and its creator (Pearl
-Software) has long since gone out of business.
-＠end itemize
+＠item eterm
+Terminal emulation.
-＠item
-GNU Emacs for DOS
+＠item eudc
+Emacs Unified Directory Client (LDAP, PH).
-＠itemize ＠minus
+＠item footnote
+Footnoting in mail message editing modes.
-＠item
-GNU Emacs features support for MS-DOS and DJGPP (D.J. Delorie's DOS
-port of GCC). Such an Emacs is heavily underfeatured, because it does
-not support long file names, lacks proper subprocesses support, and
-is far too big compared with typical DOS editors.
-＠end itemize
+＠item forms
+Forms editing support (obsolete, use Widget instead).
-＠item
-GNU Emacs compiled with Win32
+＠item fortran-modes
+Fortran support.
-＠itemize ＠minus
+＠item fortran-modes
+Fortran language support.
-＠item
-Starting with GNU Emacs 19.30, it has been possible to compile GNU Emacs
-under MS Windows using the DJGPP compiler and X libraries. The result
-is very similar to GNU Emacs compiled under MS DOS, only it works
-somewhat better because it runs in 32-bit mode, makes use of all the
-system memory, supports long file names, etc.
-＠end itemize
+＠item frame-icon
+Set up mode-specific icons for each frame under XEmacs.
-＠end itemize
+＠item fsf-compat
+GNU Emacs compatibility files.
-＠node Q1.1.6, Q1.1.7, Q1.1.5, Introduction
-＠unnumberedsubsec Q1.1.6: Is there a port of XEmacs to the Macintosh?
+＠item games
+Tetris, Sokoban, and Snake.
-Yes.
+＠item general-docs
+General documentation. Presently, empty.
-XEmacs 21.5 (perhaps 21.4 also?) works on MacOS X, although it certainly
-will not feel very much like a Mac application as it has no Mac-specific
-code in it.
+＠item gnats
+XEmacs bug reports.
-There is also a port of XEmacs 19.14 that works on all recent versions
-of MacOS, from 8.1 through MacOS X, by ＠email{pjarvis＠(a)ispchannel.com,
-Pitts Jarvis} (recently deceased). It runs in an equivalent of TTY
-mode only (one single Macintosh window, 25 colors), but has a large
-number of Mac-specific additions. It's available at
-＠uref{http://homepage.mac.com/pjarvis/xemacs.html}.
+＠item gnus
+The Gnus Newsreader and Mailreader.
-＠node Q1.1.7, Q1.1.8, Q1.1.6, Introduction
-＠unnumberedsubsec Q1.1.7: Is there a port of XEmacs to NextStep?
+＠item haskell-mode
+Haskell editing support.
-Carl Edman, apparently no longer at ＠email{cedman＠(a)princeton.edu}, did
-the port of GNU Emacs to NeXTstep and expressed interest in doing the
-XEmacs port, but never went any farther.
+＠item hm--html-menus
+HTML editing.
-＠node Q1.1.8, Q1.1.9, Q1.1.7, Introduction
-＠unnumberedsubsec Q1.1.8: Is there a port of XEmacs to OS/2?
+＠item hyperbole
+Hyperbole: The Everyday Info Manager.
-No, but Alexander Nikolaev <avn_1251＠(a)mail.ru> is working on it.
+＠item ibuffer
+Advanced replacement for buffer-menu.
-＠node Q1.1.9, Q1.2.1, Q1.1.8, Introduction
-＠unnumberedsubsec Q1.1.9: How does the port cope with differences in the Windows user interface?
+＠item idlwave
+Editing and Shell mode for the Interactive Data Language.
-The XEmacs (and Emacs in general) user interface is pretty different
-from what is expected of a typical MS Windows program. How does the MS
-Windows port cope with it?
+＠item igrep
+Enhanced front-end for Grep.
-As a general rule, we follow native MS Windows conventions as much as
-possible. 21.4 is a fairly complete Windows application, supporting
-native printing, system file dialog boxes, tool tips, etc. In cases
-where there's a clear UI conflict, we currently use normal Unix XEmacs
-behavior by default, but make sure the MS Windows "look and feel" (mark
-via shift-arrow, self-inserting deletes region, Alt selects menu items,
-etc.) is easily configurable (respectively: using the variable
-＠code{shifted-motion-keys-select-region} in 21.4 and above [it's in fact
-the default in these versions], or the ＠file{pc-select} package; using
-the ＠file{pending-del} package; and setting the variable
-＠code{menu-accelerator-enabled} to ＠code{menu-force} in 21.4 and above).
-In fact, if you use the sample ＠file{init.el} file as your init file,
-you will get all these behaviors automatically turned on.
+＠item ilisp
+Front-end for interacting with Inferior Lisp (external lisps).
-In future versions, some of these features might be turned on by
-default in the MS Windows environment.
+＠item ispell
+Spell-checking with GNU ispell.
-＠unnumberedsec 1.2: Policies
+＠item jde
+Integrated Development Environment for Java.
-＠node Q1.2.1, Q1.2.2, Q1.1.9, Introduction
-＠unnumberedsubsec Q1.2.1: What is the FAQ editorial policy?
+＠item liece
+IRC (Internet Relay Chat) client for Emacs. Note, this package is
+deprecated and will be removed, use riece instead.
-The FAQ is actively maintained and modified regularly. All links should
-be up to date. Unfortunately, some of the information is out of date --
-a situation which the FAQ maintainer is working on. All submissions are
-welcome, please e-mail submissions to ＠email{faq＠(a)xemacs.org, XEmacs FAQ
-maintainers}.
+＠item mail-lib
+Fundamental lisp files for providing email support.
-Please make sure that ＠samp{XEmacs FAQ} appears on the Subject: line.
-If you think you have a better way of answering a question, or think a
-question should be included, we'd like to hear about it. Questions and
-answers included into the FAQ will be edited for spelling and grammar
-and will be attributed. Answers appearing without attribution are
-either from versions of the FAQ dated before May 1996 or are from
-previous FAQ maintainers. Answers quoted from Usenet news articles will
-always be attributed, regardless of the author.
+＠item mailcrypt
+Support for messaging encryption with PGP.
-＠node Q1.2.2, Q1.2.3, Q1.2.1, Introduction
-＠unnumberedsubsec Q1.2.2: How do I become a beta tester?
+＠item mew
+Messaging in an Emacs World; a MIME-based email program.
-Send an email message to ＠email{xemacs-beta-request＠(a)xemacs.org} with
-the line ＠samp{subscribe} in the body of the message.
+＠item mh-e
+The XEmacs Interface to the MH Mail System.
-Be prepared to get your hands dirty, as beta testers are expected to
-identify problems as best they can.
+＠item mine
+Elisp implementation of the game 'Minehunt'.
-＠node Q1.2.3, Q1.3.1, Q1.2.2, Introduction
-＠unnumberedsubsec Q1.2.3: How do I contribute to XEmacs itself?
+＠item misc-games
+Other amusements and diversions.
-It depends on the knowledge and time you possess. If you are able, by
-all means become a beta tester (＠pxref{Q1.2.2}). If you are a
-programmer, try to build XEmacs and see if you can improve it.
+＠item mmm-mode
+Support for Multiple Major Modes within a single buffer.
-Otherwise, you can still help by using XEmacs as your everyday editor
-(for pre-built binary versions, ＠pxref{Q1.0.4}) and reporting bugs you
-find to the mailing list.
+＠item net-utils
+Miscellaneous Networking Utilities.
-Another area where we need help is the documentation: We need good
-documentation for building XEmacs and for using it. This FAQ is a
-small step in that direction.
+＠item ocaml
+Objective Caml editing support.
-Ben Wing ＠email{ben＠(a)xemacs.org} writes:
+＠item oo-browser
+OO-Browser: The Multi-Language Object-Oriented Code Browser.
-＠quotation
-BTW if you have a wish list of things that you want added, you have to
-speak up about it! More specifically, you can do the following if you
-want a feature added (in increasing order of usefulness):
+＠item ocaml
+Objective Caml editing support.
-＠itemize ＠bullet
-＠item
-Make a posting about a feature you want added.
+＠item os-utils
+Miscellaneous single-file O/S utilities, for printing, archiving,
+compression, remote shells, etc.
-＠item
-Become a beta tester and make more postings about those same features.
+＠item pc
+PC style interface emulation.
-＠item
-Convince us that you're going to use the features in some cool and
-useful way.
+＠item pcl-cvs
+CVS frontend.
-＠item
-Come up with a clear and well-thought-out API concerning the features.
+＠item pcomplete
+Provides programmatic completion.
-＠item
-Write the code to implement a feature and send us a patch.
-＠end itemize
+＠item perl-modes
+Perl support.
-(not that we're necessarily requiring you to write the code, but we can
-always hope :)
-＠end quotation
+＠item pgg
+Emacs interface to various PGP implementations.
-＠unnumberedsec 1.3: Credits
+＠item prog-modes
+Support for various programming languages.
-＠node Q1.3.1, Q1.3.2, Q1.2.3, Introduction
-＠unnumberedsubsec Q1.3.1: Who wrote XEmacs?
+＠item ps-print
+Printing functions and utilities.
-XEmacs is the result of the time and effort of many people, and the
-active developers have changed over time. There are two major
-components of the XEmacs effort -- writing the code itself and providing
-all the support work (testing the code, releasing beta and final
-versions, handling patches, reading bug reports, maintaining the web
-site, managing the mailing lists, etc. etc.). Neither component would
-work without the other.
+＠item psgml
+Validated HTML/SGML editing.
-＠subheading CODING
+＠item psgml-dtds
+A collection of DTDs for psgml. Note that this package is deprecated
+and will be removed in the future, most likely Q2/2003. Instead of using
+this, you should install needed DTDs yourself.
-The primary code contributor over the years has been Ben Wing (active
-since late 1992). Between 1991 and 1995, large amounts of coding was
-contributed by Jamie Zawinski and Chuck Thompson. Many other people
-have authored major subsystems or otherwise contributed large amounts of
-code, including Andy Piper, Hrvoje Niksic, Jerry James, Jonathan Harris,
-Kyle Jones, Martin Buchholz, Michael Sperber, Olivier Galibert, Richard
-Mlynarik, Stig, William Perry and plenty of others.
+＠item python-modes
+Python language support.
-Primary XEmacs-specific subsystems and their authors:
+＠item reftex
+Emacs support for LaTeX cross-references, citations.
-＠table ＠asis
-＠item Objects
-＠itemize ＠minus
-＠item
-Conversion from 26-bit to 28-bit pointers and integers, lrecords, lcrecords: Richard Mlynarik, 1994
-＠item
-Conversion to 32-bit pointers and 31-bit integers: Kyle Jones, Martin Buchholz
-＠item
-Portable dumper, object descriptions: Olivier Galibert
-＠item
-KKCC (new garbage collector), ephemerons, weak boxes: Michael Sperber and students
-＠item
-Random object work (object equal and hash methods, weak lists, lcrecord lists, bit vectors, dynarr, blocktype, opaque, string resizing): Ben Wing
-＠item
-Profiling: Ben Wing
-＠item
-Some byte-compilation and hash-table improvements: Martin Buchholz
-＠item
-Bignum: Jerry James
-＠end itemize
+＠item riece
+IRC (Internet Relay Chat) client for Emacs.
-＠item Internationalization/Mule
-＠itemize ＠minus
-＠item
-mostly Ben Wing; many ideas for future work, Stephen Turnbull
-＠end itemize
+＠item rmail
+An obsolete Emacs mailer. If you do not already use it don't start.
-＠item I/O
-＠itemize ＠minus
-＠item
-Basic event/event-stream implementation: Jamie Zawinski
-＠item
-Most event work since 1994: Ben Wing
-＠item
-Asynchronous stuff (async timeouts, signals, quit-checking): Ben Wing
-＠item
-Process method abstraction, Windows process work: Kirill Katsnelson
-＠item
-Misc-user events, async timeouts, most quit-checking and signal code, most other work since 1994: Ben Wing
-＠item
-Lstreams: Ben Wing
-＠end itemize
+＠item ruby-modes
+Ruby support.
-＠item Display
-＠itemize ＠minus
-＠item
-Redisplay mechanism: implementation, Chuck Thompson; additional work, lots of people
-＠item
-Glyphs: mostly Ben Wing
-＠item
-Specifiers: Ben Wing
-＠item
-Extents: initial implementation, someone at Lucid; rewrite, 1994, Ben Wing
-＠item
-Widgets: Andy Piper
-＠item
-JPEG/PNG/TIFF image converters: Ben Wing, William Perry, Jareth Hein, others (see comment in ＠file{glyphs-eimage.c})
-＠item
-Menus: Jamie Zawinski, someone at Lucid (Lucid menus)
-＠item
-Scrollbars: Chuck Thompson, ??? (Lucid scrollbar)
-＠item
-Multi-device/device-independence work (console/device/etc methods): Ben Wing, prototype by chuck thompson
-＠item
-Faces: first implementation, Jamie Zawinski; second, chuck; third, Ben Wing
-＠item
-Fonts/colors: first implementation, Jamie Zawinski; further work, Ben Wing
-＠item
-Toolbars: implementation, chuck, much interface work, Ben Wing
-＠item
-Gutters, tabs: andy piper
-＠end itemize
+＠item sasl
+Simple Authentication and Security Layer (SASL) library.
-＠item Device subsystems
-＠itemize ＠minus
-＠item
-X Windows: Jamie Zawinksi, Ben Wing, others
-＠item
-GTK: William Perry, Malcolm Purvis
-＠item
-MS Windows: initial implementation, Jonathan Harris; some more work, Andy Piper, Ben Wing
-＠item
-TTY: Chuck Thompson, Ben Wing
-＠item
-Cygwin: Andy Piper
-＠end itemize
+＠item scheme
+Front-end support for Inferior Scheme.
-＠item Misc
-＠itemize ＠minus
-＠item
-Configure: initial porting from fsf, Chuck Thompson; conversion to autoconf 2, much rewriting, Martin Buchholz
-＠item
-Most initialization-related code: Ben Wing
-＠item
-Internals manual, much of Lisp manual: Ben Wing
-＠item
-FSF synching: initial sync with FSF 19, Richard Mlynarik, further work, Ben Wing
-＠end itemize
-＠end table
+＠item semantic
+Semantic bovinator (Yacc/Lex for XEmacs). Includes Senator.
-＠subheading SUPPORT
+＠item sgml
+SGML/Linuxdoc-SGML editing.
-Currently, support duties are handled by many different people.
+＠item sh-script
+Support for editing shell scripts.
-Release managers have been
+＠item sieve
+Manage Sieve email filtering scripts.
-＠itemize ＠minus
-＠item
-Stephen Turnbull (April 2001 - present, 21.x - 21.x?)
-＠item
-Vin Shelton?
-＠item
-Steve Youngs (July 2002 - present??, 21.x - 21.x?)
-＠item
-Martin Buchholz (December 1998 - May 2001, 21.x - 21.x?)
-＠item
-Steve Baur (early 1997 - November 1998, 19.15 - 21.0)
-＠item
-Chuck Thompson (June 1994 - September 1996, 19.11 - 19.14)
-＠item
-Jamie Zawinski (April 1991 - June 1994, 19.0 - 19.10)
-＠end itemize
+＠item slider
+User interface tool.
-The recent overlapping dates are intentional, since two or three trees
-are maintained simultaneously at any point.
+＠item sml-mode
+SML editing support.
-Other major support work:
+＠item sounds-au
+XEmacs Sun sound files.
-＠itemize ＠minus
-＠item
-Adrian Aichner wrote and maintains the web site.
-＠item
-Stephen Turnbull has produced many of the beta and semi-stable releases
-and has attempted to be the "face" of XEmacs on the newsgroups and
-mailing lists.
-＠item
-Steve Youngs currently produces the beta releases (???).
-＠item
-Steve Youngs, Ville Skytta, and now Norbert Koch have taken turns
-maintaining the packages.
-＠item
-Vin Shelton maintains the stable releases.
-＠item
-Testing - #### Norbert, Adrian, ???
-＠end itemize
+＠item sounds-wav
+XEmacs Microsoft sound files.
-Portraits and email of some of the major developers:
+＠item speedbar
+Provides a separate frame with convenient references.
-＠itemize ＠bullet
-＠item ＠email{andy＠(a)xemacs.org, Andy Piper}
-＠html
-<br><img src="piper.png" alt="Portrait of Andy Piper"><br>
-＠end html
+＠item strokes
+Mouse enhancement utility.
-＠item ＠email{ben＠(a)xemacs.org, Ben Wing}
-＠html
-<br><img src="ben.png" alt="Portrait of Ben Wing"><br>
-＠end html
+＠item supercite
+An Emacs citation tool for News & Mail messages.
-＠item ＠email{cthomp＠(a)xemacs.org, Chuck Thompson}
-＠html
-<br><img src="cthomp.png" alt="Portrait of Chuck Thompson"><br>
-＠end html
+＠item texinfo
+XEmacs TeXinfo support.
+
+＠item text-modes
+Miscellaneous support for editing text files.
-＠item ＠email{hniksic＠(a)xemacs.org, Hrvoje Niksic}
+＠item textools
+Miscellaneous TeX support.
-＠html
-<br><img src="hniksic.png" alt="Portrait of Hrvoje Niksic"><br>
-＠end html
+＠item time
+Display time & date on the modeline.
-＠item ＠email{jwz＠(a)jwz.org, Jamie Zawinski}
-＠html
-<br><img src="jwz.png" alt="Portrait of Jamie Zawinski"><br>
-＠end html
+＠item tm
+Emacs MIME support. Not needed for gnus >= 5.8.0.
-＠item ＠email{martin＠(a)xemacs.org, Martin Buchholz}
-＠html
-<br><img src="martin.png" alt="Portrait of Martin Buchholz"><br>
-＠end html
+＠item tooltalk
+Support for building with Tooltalk.
-＠item ＠email{mly＠(a)adoc.xerox.com, Richard Mlynarik}
-＠html
-<br><img src="mly.png" alt="Portrait of Richard Mlynarik"><br>
-＠end html
+＠item tpu
+DEC EDIT/TPU support.
-＠item ＠email{stephen＠(a)xemacs.org, Stephen Turnbull}
+＠item tramp
+Remote shell-based file editing. This is similar to EFS or Ange-FTP,
+but works with rsh/ssh and rcp/scp.
-＠item ＠email{steve＠(a)xemacs.org, Steve Baur}
-＠html
-<br><img src="slb.png" alt="Portrait of Steve Baur"><br>
-＠end html
-＠end itemize
+＠item vc
+Version Control for Free systems.
-Many other people have contributed to XEmacs; this is partially
-enumerated in the ＠samp{About XEmacs} option in the Help menu.
+＠item vc-cc
+Version Control for ClearCase (UnFree) systems.
-＠node Q1.3.2, Q1.3.3, Q1.3.1, Introduction
-＠unnumberedsubsec Q1.3.2: Who contributed to this version of the FAQ?
+＠item vhdl
+Support for VHDL.
-The current version of this FAQ was created by ＠email{ben＠(a)xemacs.org,
-Ben Wing}.
+＠item view-process
+A Unix process browsing tool.
-＠node Q1.3.3, Q1.4.1, Q1.3.2, Introduction
-＠unnumberedsubsec Q1.3.3: Who contributed to the FAQ in the past?
+＠item viper
+VI emulation support.
-This is only a partial list, as many names were lost in a hard disk
-crash some time ago.
+＠item vm
+An Emacs mailer.
-＠itemize ＠bullet
-＠item ＠email{steve＠(a)xemacs.org, SL Baur}
+＠item w3
+A Web browser.
-＠item ＠email{hniksic＠(a)xemacs.org, Hrvoje Niksic}
+＠item x-symbol
+Semi WYSIWYG for LaTeX, HTML, etc, using additional fonts.
-＠item ＠email{binge＠(a)aloft.att.com, Curtis.N.Bingham}
+＠item xemacs-base
+Fundamental XEmacs support, you almost certainly need this.
-＠item ＠email{bruncott＠(a)dormeur.inria.fr, Georges Brun-Cottan}
+＠item xemacs-devel
+XEmacs Lisp developer support. This package contains utilities for
+supporting Lisp development. It is a single-file package so it may be
+tailored.
-＠item ＠email{rjc＠(a)cogsci.ed.ac.uk, Richard Caley}
+＠item xlib
+Emacs interface to X server.
-＠item ＠email{cognot＠(a)ensg.u-nancy.fr, Richard Cognot}
+＠item xslide
+XSL editing support.
-＠item ＠email{daku＠(a)nortel.ca, Mark Daku}
+＠item xslt-process
+A minor mode for (X)Emacs which allows running an XSLT processor on a
+buffer.
-＠item ＠email{wgd＠(a)martigny.ai.mit.edu, William G. Dubuque}
+＠item xwem
+X Emacs Window Manager.
-＠item ＠email{eeide＠(a)cs.utah.edu, Eric Eide}
+＠item zenirc
+ZENIRC IRC Client.
+＠end table
-＠item ＠email{af＠(a)biomath.jussieu.fr, Alain Fauconnet}
+＠subheading Mule Support (mule)
-＠item ＠email{cflatter＠(a)nrao.edu, Chris Flatters}
+MULti-lingual Enhancement. Support for world scripts such as
+Latin, Arabic, Cyrillic, Chinese, Japanese, Greek, Hebrew etc.
+To use these packages your XEmacs must be compiled with Mule
+support.
-＠item ＠email{ginsparg＠(a)adra.com, Evelyn Ginsparg}
+＠table ＠asis
+＠item edict
+MULE: Lisp Interface to EDICT, Kanji Dictionary.
-＠item ＠email{hall＠(a)aplcenmp.apl.jhu.edu, Marty Hall}
+＠item egg-its
+MULE: Wnn (4.2 and 6) support. SJ3 support.
-＠item ＠email{dkindred＠(a)cmu.edu, Darrell Kindred}
+＠item latin-unity
+MULE: find single ISO 8859 character set to encode a buffer.
-＠item ＠email{dmoore＠(a)ucsd.edu, David Moore}
+＠item latin-unity
+Unify character sets in a buffer. When characters belong to disjoint
+character sets, this attempts to translate the characters so
+that they belong to one character set. If the buffer coding system is
+not sufficient, this suggests different coding systems.
-＠item ＠email{arup+＠(a)cmu.edu, Arup Mukherjee}
+＠item leim
+MULE: Quail. All non-English and non-Japanese language support.
-＠item ＠email{nickel＠(a)prz.tu-berlin.de, Juergen Nickelsen}
+＠item locale
+MULE: Localized menubars and localized splash screens.
-＠item ＠email{powell＠(a)csl.ncsa.uiuc.edu, Kevin R. Powell}
+＠item lookup
+Dictionary support. (This isn't an English dictionary program)
-＠item ＠email{dworkin＠(a)ccs.neu.edu, Justin Sheehy}
+＠item mule-base
+MULE: Basic Mule support, required for building with Mule.
-＠item ＠email{stig＠(a)hackvan.com, Stig}
+＠item mule-ucs
+MULE: Extended coding systems (including Unicode) for XEmacs.
-＠item ＠email{Aki.Vehtari＠(a)hut.fi, Aki Vehtari}
-＠end itemize
+＠item mule-ucs
+Extended coding systems (including Unicode) for XEmacs.
+
+＠item skk
+Another Japanese Language Input Method. Can be used without a
+separate process running as a dictionary server.
+＠end table
-＠unnumberedsec 1.4: Internationalization
+＠unnumberedsec 1.8: Internationalization
-＠node Q1.4.1, Q1.4.2, Q1.3.3, Introduction
-＠unnumberedsubsec Q1.4.1: What is the status of internationalization support aka MULE (including Asian language support)?
+＠node Q1.8.1, Q1.8.2, Q1.7.1, Introduction
+＠unnumberedsubsec Q1.8.1: What is the status of internationalization support aka MULE (including Asian language support)?
Both the stable and development versions of XEmacs include
internationalization support (aka MULE). MULE currently (21.4) works on
＠＠ -1672,8 +2540,8 ＠＠
instability of the development tree. Binaries compiled without MULE
support run faster than MULE capable XEmacsen.
-＠node Q1.4.2, Q1.4.3, Q1.4.1, Introduction
-＠unnumberedsubsec Q1.4.2: How can I help with internationalization?
+＠node Q1.8.2, Q1.8.3, Q1.8.1, Introduction
+＠unnumberedsubsec Q1.8.2: How can I help with internationalization?
If you would like to help, you may want to join the
＠email{xemacs-mule＠(a)xemacs.org} mailing list. Especially needed are
＠＠ -1683,24 +2551,24 ＠＠
Translations of the TUTORIAL and man page are welcome, and XEmacs does
support multilingual menus, but we have few current translations.
-(a)xref{Q1.2.2, How do I become a Beta Tester?}.
+(a)xref{Q1.5.2, How do I become a Beta Tester?}.
-＠node Q1.4.3, Q1.4.4, Q1.4.2, Introduction
-＠unnumberedsubsec Q1.4.3: How do I type non-ASCII characters?
+＠node Q1.8.3, Q1.8.4, Q1.8.2, Introduction
+＠unnumberedsubsec Q1.8.3: How do I type non-ASCII characters?
＠xref{Q3.0.6, How can you type in special characters in XEmacs?}, in
part 3 of this FAQ, for some simple methods that also work in non-MULE
builds of XEmacs (but only for one-octet coded character sets, and
mostly for ISO 8859/1). Many of the methods available for Cyrillic
-((a)pxref{Q1.4.7, How about Cyrillic modes?}) work without MULE. MULE
-has more general capabilities. ＠xref{Q1.4.5, Please explain the
+((a)pxref{Q1.8.7, How about Cyrillic modes?}) work without MULE. MULE
+has more general capabilities. ＠xref{Q1.8.5, Please explain the
various input methods in MULE/XEmacs}.
＠xref{Q4.0.8, How do I display non-ASCII characters?}, which covers
display of non-ASCII characters.
-＠node Q1.4.4, Q1.4.5, Q1.4.3, Introduction
-＠unnumberedsubsec Q1.4.4: Can XEmacs messages come out in a different language?
+＠node Q1.8.4, Q1.8.5, Q1.8.3, Introduction
+＠unnumberedsubsec Q1.8.4: Can XEmacs messages come out in a different language?
The message-catalog support was written but is badly bit-rotted. XEmacs
20 and 21 did ＠emph{not} support it, and early releases of XEmacs 22
＠＠ -1718,8 +2586,8 ＠＠
The name of the resource is derived from the non-localized entry by
removing punctuation and capitalizing as above.
-＠node Q1.4.5, Q1.4.6, Q1.4.4, Introduction
-＠unnumberedsubsec Q1.4.5: Please explain the various input methods in MULE/XEmacs
+＠node Q1.8.5, Q1.8.6, Q1.8.4, Introduction
+＠unnumberedsubsec Q1.8.5: Please explain the various input methods in MULE/XEmacs
Mule supports a wide variety of input methods. There are three basic
classes: Lisp implementations, generic platform support, and library
＠＠ -1811,8 +2679,8 ＠＠
Much of this information was provided by ＠email{morioka＠(a)jaist.ac.jp,
MORIOKA Tomohiko}.
-＠node Q1.4.6, Q1.4.7, Q1.4.5, Introduction
-＠unnumberedsubsec Q1.4.6: How do I portably code for MULE/XEmacs?
+＠node Q1.8.6, Q1.8.7, Q1.8.5, Introduction
+＠unnumberedsubsec Q1.8.6: How do I portably code for MULE/XEmacs?
MULE has evolved rapidly over the last few years, and the original third
party patch (for GNU Emacs 19), GNU Emacs 20+, and XEmacs 20+ have quite
＠＠ -1876,8 +2744,8 ＠＠
＠end lisp
＠end quotation
-＠node Q1.4.7, Q1.4.8, Q1.4.6, Introduction
-＠unnumberedsubsec Q1.4.7: How about Cyrillic modes?
+＠node Q1.8.7, Q1.8.8, Q1.8.6, Introduction
+＠unnumberedsubsec Q1.8.7: How about Cyrillic modes?
＠email{ilya＠(a)math.ohio-state.edu, Ilya Zakharevich} writes:
＠＠ -1914,8 +2782,8 ＠＠
XEmacs) is ＠uref{http://www.ibiblio.org/sergei/Software/Software.html}
＠end quotation
-＠node Q1.4.8, Q1.4.9, Q1.4.7, Introduction
-＠unnumberedsubsec Q1.4.8: Does XEmacs support Unicode?
+＠node Q1.8.8, Q1.8.9, Q1.8.7, Introduction
+＠unnumberedsubsec Q1.8.8: Does XEmacs support Unicode?
To get Unicode support, you need a Mule-enabled XEmacs.
＠＠ -1923,7 +2791,7 ＠＠
don't yet use it as the internal encoding.
21.4 supports Unicode partially -- as an external encoding for files,
-processes, and terminals, but without font support. ＠xref{Q1.4.9, How
+processes, and terminals, but without font support. ＠xref{Q1.8.9, How
does XEmacs display Unicode?}. To get Unicode support in 21.4,
install Mule-UCS from packages in the usual way, and put
＠＠ -1938,13 +2806,13 ＠＠
that files that are not UTF-8 are being mis-recognized as UTF-8.
Install standard national fonts (not Unicode fonts) for all character
-sets you use. ＠xref{Q1.4.9, How does XEmacs display Unicode??}.
+sets you use. ＠xref{Q1.8.9, How does XEmacs display Unicode??}.
Mule-UCS also supports 16-bit forms of Unicode (UTF-16). It does not
support 31-bit forms of Unicode (UTF-32 or UCS-4).
-＠node Q1.4.9, Q1.5.1, Q1.4.8, Introduction
-＠unnumberedsubsec Q1.4.9: How does XEmacs display Unicode?
+＠node Q1.8.9, , Q1.8.8, Introduction
+＠unnumberedsubsec Q1.8.9: How does XEmacs display Unicode?
Mule doesn't have a Unicode charset internally, so there's nothing to
bind a Unicode registry to. It would not be straightforward to create,
＠＠ -1965,158 +2833,6 ＠＠
Real Unicode support will be introduced in XEmacs 22.0.
-＠unnumberedsec 1.5: Getting Started
-
-＠node Q1.5.1, Q1.5.2, Q1.4.9, Introduction
-＠unnumberedsubsec Q1.5.1: What is an ＠file{init.el} or ＠file{.emacs} and is there a sample one?
-
-The ＠file{init.el} or ＠file{.emacs} file is used to customize XEmacs to
-your tastes. Starting in 21.4, the preferred location for the init file
-is ＠file{~/.xemacs/init.el}; in previous versions, it was
-(a)file{~/.emacs}. 21.4 still accepts the old location, but the first
-time you run it, it will ask to migrate your file to the new location.
-If you answer yes, the file will be moved, and a "compatibility"
-(a)file{.emacs} file will be placed in the old location so that you can
-still run older versions of XEmacs, and versions of GNU Emacs, which
-expect the old location. The ＠file{.emacs} file present is just a stub
-that loads the real file in ＠file{~/.xemacs/init.el}.
-
-No two init files are alike, nor are they expected to be alike, but
-that's the point. The XEmacs distribution contains an excellent starter
-example in the ＠file{etc/} directory called ＠file{sample.init.el}
-(starting in 21.4) or ＠file{sample.emacs} in older versions. Copy this
-file from there to ＠file{~/.xemacs/init.el} (starting in 21.4) or
-(a)file{~/.emacs} in older versions, where ＠samp{~} means your home
-directory, of course. Then edit it to suit.
-
-You may bring the ＠file{sample.init.el} or ＠file{sample.emacs} file into
-an XEmacs buffer from the menubar. (The menu entry for it is always
-under the ＠samp{Help} menu, but its location under that has changed in
-various versions. Recently, look under the ＠samp{Samples} submenu.) To
-determine the location of the ＠file{etc/} directory type the command
-＠kbd{C-h v data-directory ＠key{RET}}.
-
-＠node Q1.5.2, Q1.5.3, Q1.5.1, Introduction
-＠unnumberedsubsec Q1.5.2: Where do I put my ＠file{init.el} file?
-
-(a)file{init.el} is the name of the init file starting with 21.4, and is
-located in the subdirectory ＠file{.xemacs/} of your home directory. In
-prior versions, the init file is called ＠file{.emacs} and is located in
-your home directory.
-
-Your home directory under Windows is determined by the ＠samp{HOME}
-environment variable. If this is not set, it defaults to ＠samp{C:\}.
-To set this variable, modify ＠file{AUTOEXEC.BAT} under Windows 95/98, or
-select ＠samp{Control Panel->System->Advanced->Environment Variables...}
-under Windows NT/2000.
-
-＠node Q1.5.3, Q1.5.4, Q1.5.2, Introduction
-＠unnumberedsubsec Q1.5.3: Can I use the same ＠file{init.el} with the other Emacs?
-
-Yes. The sample ＠file{init.el} included in the XEmacs
-distribution will show you how to handle different versions and flavors
-of Emacs.
-
-＠node Q1.5.4, Q1.5.5, Q1.5.3, Introduction
-＠unnumberedsubsec Q1.5.4: Any good XEmacs tutorials around?
-
-There's the XEmacs tutorial available from the Help Menu under
-＠samp{Help->Tutorials}, or by typing ＠kbd{C-h t}. To check whether
-it's available in a non-english language, type ＠kbd{C-u C-h t TAB}, type
-the first letters of your preferred language, then type ＠key{RET}.
-
-＠comment There's an Emacs Lisp tutorial at
-＠comment
-＠comment ＠example
-＠comment ＠uref{ftp://prep.ai.mit.edu/pub/gnu/emacs-lisp-intro-1.04.tar.gz}.
-＠comment ＠end example
-＠comment
-＠comment ＠email{erik＠(a)petaxp.rug.ac.be, Erik Sundermann} has made a tutorial web
-＠comment page at
-＠comment ＠iftex
-＠comment ＠*
-＠comment ＠end iftex
-＠comment ＠uref{http://petaxp.rug.ac.be/~erik/xemacs/}.
-
-＠node Q1.5.5, Q1.5.6, Q1.5.4, Introduction
-＠unnumberedsubsec Q1.5.5: May I see an example of a useful XEmacs Lisp function?
-
-The following function does a little bit of everything useful. It does
-something with the prefix argument, it examines the text around the
-cursor, and it's interactive so it may be bound to a key. It inserts
-copies of the current word the cursor is sitting on at the cursor. If
-you give it a prefix argument: ＠kbd{C-u 3 M-x double-word} then it will
-insert 3 copies.
-
-＠lisp
-(defun double-word (count)
- "Insert a copy of the current word underneath the cursor"
- (interactive "*p")
- (let (here there string)
- (save-excursion
- (forward-word -1)
- (setq here (point))
- (forward-word 1)
- (setq there (point))
- (setq string (buffer-substring here there)))
- (while (>= count 1)
- (insert string)
- (decf count))))
-＠end lisp
-
-The best way to see what is going on here is to let XEmacs tell you.
-Put the code into an XEmacs buffer, and do a ＠kbd{C-h f} with the cursor
-sitting just to the right of the function you want explained. Eg. move
-the cursor to the SPACE between ＠code{interactive} and ＠samp{"*p"} and
-hit ＠kbd{C-h f} to see what the function ＠code{interactive} does. Doing
-this will tell you that the ＠code{*} requires a writable buffer, and
-＠code{p} converts the prefix argument to a number, and
-＠code{interactive} allows you to execute the command with ＠kbd{M-x}.
-
-＠node Q1.5.6, Q1.5.7, Q1.5.5, Introduction
-＠unnumberedsubsec Q1.5.6: And how do I bind it to a key?
-
-To bind to a key do:
-
-＠lisp
-(global-set-key "\C-cd" 'double-word)
-＠end lisp
-
-Or interactively, ＠kbd{M-x global-set-key} and follow the prompts.
-
-＠node Q1.5.7, Q1.5.8, Q1.5.6, Introduction
-＠unnumberedsubsec Q1.5.7: What's the difference between a macro and a function?
-
-Quoting from the Lisp Reference (a.k.a ＠dfn{Lispref}) Manual:
-
-＠dfn{Macros} enable you to define new control constructs and other
-language features. A macro is defined much like a function, but instead
-of telling how to compute a value, it tells how to compute another Lisp
-expression which will in turn compute the value. We call this
-expression the ＠dfn{expansion} of the macro.
-
-Macros can do this because they operate on the unevaluated expressions
-for the arguments, not on the argument values as functions do. They can
-therefore construct an expansion containing these argument expressions
-or parts of them.
-
-Do not confuse the two terms with ＠dfn{keyboard macros}, which are
-another matter, entirely. A keyboard macro is a key bound to several
-other keys. Refer to manual for details.
-
-＠node Q1.5.8, , Q1.5.7, Introduction
-＠unnumberedsubsec Q1.5.8: What is ＠code{Custom}?
-
-＠code{Custom} is a system for customizing XEmacs options.
-
-You can access ＠code{Advanced (Customize)} from the ＠code{Options} menu
-or invoking one of customize commands by typing eg.
-＠kbd{M-x customize}, ＠kbd{M-x customize-face},
-＠kbd{M-x customize-variable} or ＠kbd{M-x customize-apropos}.
-
-There is also new ＠samp{browser} mode for Customize.
-Try it out with ＠kbd{M-x customize-browse}
-
＠node Installation, Editing, Introduction, Top
＠unnumbered 2 Installation and Troubleshooting
＠＠ -2442,11 +3158,11 ＠＠
there is little reason not to use it.
The second way to build is the Cygwin port. It takes advantage of
-Cygnus emulation library under Win32. ＠xref{Q1.1.4, What are Cygwin
+Cygnus emulation library under Win32. ＠xref{Q1.2.5, What are Cygwin
and MinGW, and do I need them to run XEmacs?}, for more information.
A third way is the MinGW port. It uses the Cygwin environment to
-build but does not require it at runtime. ＠xref{Q1.1.4, What are
+build but does not require it at runtime. ＠xref{Q1.2.5, What are
Cygwin and MinGW, and do I need them to run XEmacs?}, for more
information.
＠＠ -2465,7 +3181,7 ＠＠
some beta testers currently trying to compile with VC.NET, aka version
7.0, but we can't yet report complete success.) For the Cygwin and
MinGW versions, you need the Cygwin environment, which comes with GCC,
-the compiler used for those versions. ＠xref{Q1.1.4, What are Cygwin
+the compiler used for those versions. ＠xref{Q1.2.5, What are Cygwin
and MinGW, and do I need them to run XEmacs?}, for more information on
Cygwin and MinGW.
＠＠ -3195,7 +3911,7 ＠＠
problem for most people. 21.4 implements "portable dumping", which
eliminates the problem altogether. We recommend you use the 21.4
binaries, but you can use the 21.1 binaries if you are very paranoid
-about stability. ＠xref{Q1.0.4, Are binaries available?}.
+about stability. ＠xref{Q1.1.2, Are binaries available?}.
＠node Q2.4.3, Q2.4.4, Q2.4.2, Installation
＠unnumberedsubsec Q2.4.3: XEmacs won't start without network.
＠＠ -5957,95 +6673,39 ＠＠
section is devoted to advanced customization using XEmacs Lisp.
＠menu
-7.0: Online Help
-* Q7.0.1:: How can I get two instances of info?
-* Q7.0.2:: How do I add new Info directories?
-
-7.1: Emacs Lisp and ＠file{init.el}
-* Q7.1.1:: What version of Emacs am I running?
-* Q7.1.2:: How can I evaluate Emacs-Lisp expressions?
-* Q7.1.3:: ＠code{(setq tab-width 6)} behaves oddly.
-* Q7.1.4:: How can I add directories to the ＠code{load-path}?
-* Q7.1.5:: How to check if a lisp function is defined?
-* Q7.1.6:: Can I force the output of ＠code{(face-list)} to a buffer?
-
-7.2: Emacs Lisp Programming Techniques
-* Q7.2.1:: What is the difference in key sequences between XEmacs and GNU Emacs?
-* Q7.2.2:: Can I generate "fake" keyboard events?
-* Q7.2.3:: Could you explain ＠code{read-kbd-macro} in more detail?
-* Q7.2.4:: What is the performance hit of ＠code{let}?
-* Q7.2.5:: What is the recommended use of ＠code{setq}?
-* Q7.2.6:: What is the typical misuse of ＠code{setq}?
-* Q7.2.7:: I like the ＠code{do} form of cl, does it slow things down?
-* Q7.2.8:: I like recursion, does it slow things down?
-* Q7.2.9:: How do I put a glyph as annotation in a buffer?
-* Q7.2.10:: ＠code{map-extents} won't traverse all of my extents!
-* Q7.2.11:: My elisp program is horribly slow. Is there an easy way to find out where it spends time?
-
-7.3: Mathematics
-* Q7.3.1:: What are bignums, ratios, and bigfloats in Lisp?
-* Q7.3.2:: XEmacs segfaults when I use very big numbers!
-* Q7.3.3:: Bignums are really slow!
-* Q7.3.4:: Equal bignums don't compare as equal! What gives?
+7.0: Emacs Lisp and ＠file{init.el}
+* Q7.0.1:: What version of Emacs am I running?
+* Q7.0.2:: How can I evaluate Emacs-Lisp expressions?
+* Q7.0.3:: ＠code{(setq tab-width 6)} behaves oddly.
+* Q7.0.4:: How can I add directories to the ＠code{load-path}?
+* Q7.0.5:: How to check if a lisp function is defined?
+* Q7.0.6:: Can I force the output of ＠code{(face-list)} to a buffer?
+
+7.1: Emacs Lisp Programming Techniques
+* Q7.1.1:: What is the difference in key sequences between XEmacs and GNU Emacs?
+* Q7.1.2:: Can I generate "fake" keyboard events?
+* Q7.1.3:: Could you explain ＠code{read-kbd-macro} in more detail?
+* Q7.1.4:: What is the performance hit of ＠code{let}?
+* Q7.1.5:: What is the recommended use of ＠code{setq}?
+* Q7.1.6:: What is the typical misuse of ＠code{setq}?
+* Q7.1.7:: I like the ＠code{do} form of cl, does it slow things down?
+* Q7.1.8:: I like recursion, does it slow things down?
+* Q7.1.9:: How do I put a glyph as annotation in a buffer?
+* Q7.1.10:: ＠code{map-extents} won't traverse all of my extents!
+* Q7.1.11:: My elisp program is horribly slow. Is there an easy way to find out where it spends time?
+
+7.2: Mathematics
+* Q7.2.1:: What are bignums, ratios, and bigfloats in Lisp?
+* Q7.2.2:: XEmacs segfaults when I use very big numbers!
+* Q7.2.3:: Bignums are really slow!
+* Q7.2.4:: Equal bignums don't compare as equal! What gives?
＠end menu
-＠unnumberedsec 7.0: Online Help
+＠unnumberedsec 7.0: Emacs Lisp and ＠file{init.el}
＠node Q7.0.1, Q7.0.2, Advanced, Advanced
-＠unnumberedsubsec Q7.0.1: How can I get two instances of info?
-
-Before 21.4, you can't. The ＠code{info} package does not provide for
-multiple info buffers. In 21.4, this should be fixed. #### how?
-
-＠node Q7.0.2, Q7.1.1, Q7.0.1, Advanced
-＠unnumberedsubsec Q7.0.2: How do I add new Info directories?
-
-You use something like:
-
-＠lisp
-(setq Info-directory-list (cons
- (expand-file-name "~/info")
- Info-default-directory-list))
-＠end lisp
-
-＠email{davidm＠(a)prism.kla.com, David Masterson} writes:
-
-＠quotation
-Emacs Info and XEmacs Info do many things differently. If you're trying to
-support a number of versions of Emacs, here are some notes to remember:
-
-＠enumerate
-＠item
-Emacs Info scans ＠code{Info-directory-list} from right-to-left while
-XEmacs Info reads it from left-to-right, so append to the ＠emph{correct}
-end of the list.
-
-＠item
-Use ＠code{Info-default-directory-list} to initialize
-＠code{Info-directory-list} ＠emph{if} it is available at startup, but not
-all Emacsen define it.
-
-＠item
-Emacs Info looks for a standard ＠file{dir} file in each of the
-directories scanned from #1 and magically concatenates them together.
-
-＠item
-XEmacs Info looks for a ＠file{localdir} file (which consists of just the
-menu entries from a ＠file{dir} file) in each of the directories scanned
-from #1 (except the first), does a simple concatenation of them, and
-magically attaches the resulting list to the end of the menu in the
-＠file{dir} file in the first directory.
-＠end enumerate
-
-Another alternative is to convert the documentation to HTML with
-texi2html and read it from a web browser like Lynx or W3.
-＠end quotation
-
-＠unnumberedsec 7.1: Emacs Lisp and ＠file{init.el}
+＠unnumberedsubsec Q7.0.1: What version of Emacs am I running?
-＠node Q7.1.1, Q7.1.2, Q7.0.2, Advanced
-＠unnumberedsubsec Q7.1.1: What version of Emacs am I running?
-
How can ＠file{init.el} determine which of the family of
Emacsen I am using?
＠＠ -6061,8 +6721,8 ＠＠
(defvar running-xemacs (string-match "XEmacs\\|Lucid" emacs-version))
＠end lisp
-＠node Q7.1.2, Q7.1.3, Q7.1.1, Advanced
-＠unnumberedsubsec Q7.1.2: How can I evaluate Emacs-Lisp expressions?
+＠node Q7.0.2, Q7.0.3, Q7.0.1, Advanced
+＠unnumberedsubsec Q7.0.2: How can I evaluate Emacs-Lisp expressions?
I know I can evaluate Elisp expressions from ＠code{*scratch*} buffer
with ＠kbd{C-j} after the expression. How do I do it from another
＠＠ -6071,8 +6731,8 ＠＠
Press ＠kbd{M-:} (the default binding of ＠code{eval-expression}), and
enter the expression to the minibuffer.
-＠node Q7.1.3, Q7.1.4, Q7.1.2, Advanced
-＠unnumberedsubsec Q7.1.3: ＠code{(setq tab-width 6)} behaves oddly.
+＠node Q7.0.3, Q7.0.4, Q7.0.2, Advanced
+＠unnumberedsubsec Q7.0.3: ＠code{(setq tab-width 6)} behaves oddly.
If you put ＠code{(setq tab-width 6)} in your
＠file{init.el} file it does not work! Is there a reason
＠＠ -6081,8 +6741,8 ＠＠
Use ＠code{setq-default} instead, since ＠code{tab-width} is
all-buffer-local.
-＠node Q7.1.4, Q7.1.5, Q7.1.3, Advanced
-＠unnumberedsubsec Q7.1.4: How can I add directories to the ＠code{load-path}?
+＠node Q7.0.4, Q7.0.5, Q7.0.3, Advanced
+＠unnumberedsubsec Q7.0.4: How can I add directories to the ＠code{load-path}?
Here are two ways to do that, one that puts your directories at the
front of the load-path, the other at the end:
＠＠ -6109,8 +6769,8 ＠＠
＠end lisp
＠end quotation
-＠node Q7.1.5, Q7.1.6, Q7.1.4, Advanced
-＠unnumberedsubsec Q7.1.5: How to check if a lisp function is defined?
+＠node Q7.0.5, Q7.0.6, Q7.0.4, Advanced
+＠unnumberedsubsec Q7.0.5: How to check if a lisp function is defined?
Use the following elisp:
＠＠ -6134,8 +6794,8 ＠＠
much better more often in more places if it did the above instead of
trying to divine its environment from the value of one variable.
-＠node Q7.1.6, Q7.2.1, Q7.1.5, Advanced
-＠unnumberedsubsec Q7.1.6: Can I force the output of ＠code{(face-list)} to a buffer?
+＠node Q7.0.6, Q7.1.1, Q7.0.5, Advanced
+＠unnumberedsubsec Q7.0.6: Can I force the output of ＠code{(face-list)} to a buffer?
It would be good having it in a buffer, as the output of
＠code{(face-list)} is too wide to fit to a minibuffer.
＠＠ -6147,10 +6807,10 ＠＠
simply press ＠kbd{C-h l} to get the former minibuffer contents in a
buffer.
-＠unnumberedsec 7.2: Emacs Lisp Programming Techniques
+＠unnumberedsec 7.1: Emacs Lisp Programming Techniques
-＠node Q7.2.1, Q7.2.2, Q7.1.6, Advanced
-＠unnumberedsubsec Q7.2.1: What is the difference in key sequences between XEmacs and GNU Emacs?
+＠node Q7.1.1, Q7.1.2, Q7.0.6, Advanced
+＠unnumberedsubsec Q7.1.1: What is the difference in key sequences between XEmacs and GNU Emacs?
＠email{clerik＠(a)naggum.no, Erik Naggum} writes;
＠＠ -6182,8 +6842,8 ＠＠
<up>}, and converts it to the internal key representation of the Emacs
you use. The function is available both on XEmacs and GNU Emacs.
-＠node Q7.2.2, Q7.2.3, Q7.2.1, Advanced
-＠unnumberedsubsec Q7.2.2: Can I generate "fake" keyboard events?
+＠node Q7.1.2, Q7.1.3, Q7.1.1, Advanced
+＠unnumberedsubsec Q7.1.2: Can I generate "fake" keyboard events?
I wonder if there is an interactive function that can generate
＠dfn{fake} keyboard events. This way, I could simply map them inside
＠＠ -6203,8 +6863,8 ＠＠
(lambda () (interactive) (cg--generate-char-event 4)))
＠end lisp
-＠node Q7.2.3, Q7.2.4, Q7.2.2, Advanced
-＠unnumberedsubsec Q7.2.3: Could you explain ＠code{read-kbd-macro} in more detail?
+＠node Q7.1.3, Q7.1.4, Q7.1.2, Advanced
+＠unnumberedsubsec Q7.1.3: Could you explain ＠code{read-kbd-macro} in more detail?
The ＠code{read-kbd-macro} function returns the internal Emacs
representation of a human-readable string (which is its argument).
＠＠ -6294,8 +6954,8 ＠＠
use whitespace.
＠end quotation
-＠node Q7.2.4, Q7.2.5, Q7.2.3, Advanced
-＠unnumberedsubsec Q7.2.4: What is the performance hit of ＠code{let}?
+＠node Q7.1.4, Q7.1.5, Q7.1.3, Advanced
+＠unnumberedsubsec Q7.1.4: What is the performance hit of ＠code{let}?
In most cases, not noticeable. Besides, there's no avoiding
＠code{let}---you have to bind your local variables, after all. Some
＠＠ -6304,8 +6964,8 ＠＠
future implementation), ＠code{let}-s should be used (nested) in a way to
provide the clearest code.
-＠node Q7.2.5, Q7.2.6, Q7.2.4, Advanced
-＠unnumberedsubsec Q7.2.5: What is the recommended use of ＠code{setq}?
+＠node Q7.1.5, Q7.1.6, Q7.1.4, Advanced
+＠unnumberedsubsec Q7.1.5: What is the recommended use of ＠code{setq}?
＠itemize ＠bullet
＠item Global variables
＠＠ -6367,8 +7027,8 ＠＠
＠end lisp
＠end itemize
-＠node Q7.2.6, Q7.2.7, Q7.2.5, Advanced
-＠unnumberedsubsec Q7.2.6: What is the typical misuse of ＠code{setq}?
+＠node Q7.1.6, Q7.1.7, Q7.1.5, Advanced
+＠unnumberedsubsec Q7.1.6: What is the typical misuse of ＠code{setq}?
A typical misuse is probably ＠code{setq}ing a variable that was meant to
be local. Such a variable will remain bound forever, never to be
＠＠ -6409,8 +7069,8 ＠＠
** assignment to free variable flurghoze
＠end lisp
-＠node Q7.2.7, Q7.2.8, Q7.2.6, Advanced
-＠unnumberedsubsec Q7.2.7: I like the ＠code{do} form of cl, does it slow things down?
+＠node Q7.1.7, Q7.1.8, Q7.1.6, Advanced
+＠unnumberedsubsec Q7.1.7: I like the ＠code{do} form of cl, does it slow things down?
It shouldn't. Here is what Dave Gillespie has to say about cl.el
performance:
＠＠ -6451,8 +7111,8 ＠＠
function.
＠end quotation
-＠node Q7.2.8, Q7.2.9, Q7.2.7, Advanced
-＠unnumberedsubsec Q7.2.8: I like recursion, does it slow things down?
+＠node Q7.1.8, Q7.1.9, Q7.1.7, Advanced
+＠unnumberedsubsec Q7.1.8: I like recursion, does it slow things down?
Yes. The Emacs byte-compiler cannot do much to optimize recursion. But
think well whether this is a real concern in Emacs. Much of the Emacs
＠＠ -6462,8 +7122,8 ＠＠
Please try not to make your code much uglier to gain a very small speed
gain. It's not usually worth it.
-＠node Q7.2.9, Q7.2.10, Q7.2.8, Advanced
-＠unnumberedsubsec Q7.2.9: How do I put a glyph as annotation in a buffer?
+＠node Q7.1.9, Q7.1.10, Q7.1.8, Advanced
+＠unnumberedsubsec Q7.1.9: How do I put a glyph as annotation in a buffer?
Here is a solution that will insert the glyph annotation at the
beginning of buffer:
＠＠ -6489,8 +7149,8 ＠＠
name), and inserts the glyph at ＠code{(point)} instead of
＠code{(point-min)}.
-＠node Q7.2.10, Q7.2.11, Q7.2.9, Advanced
-＠unnumberedsubsec Q7.2.10: ＠code{map-extents} won't traverse all of my extents!
+＠node Q7.1.10, Q7.1.11, Q7.1.9, Advanced
+＠unnumberedsubsec Q7.1.10: ＠code{map-extents} won't traverse all of my extents!
I tried to use ＠code{map-extents} to do an operation on all the extents
in a region. However, it seems to quit after processing a random number
＠＠ -6520,8 +7180,8 ＠＠
nil))
＠end lisp
-＠node Q7.2.11, Q7.3.1, Q7.2.10, Advanced
-＠unnumberedsubsec Q7.2.11: My elisp program is horribly slow. Is there an easy way to find out where it spends time?
+＠node Q7.1.11, Q7.2.1, Q7.1.10, Advanced
+＠unnumberedsubsec Q7.1.11: My elisp program is horribly slow. Is there an easy way to find out where it spends time?
＠c New
＠email{hniksic＠(a)xemacs.org, Hrvoje Niksic} writes:
＠＠ -6532,10 +7192,10 ＠＠
where the time is being spent.
＠end quotation
-＠unnumberedsec 7.3: Mathematics
+＠unnumberedsec 7.2: Mathematics
-＠node Q7.3.1, Q7.3.2, Q7.2.11, Advanced
-＠unnumberedsubsec Q7.3.1: What are bignums, ratios, and bigfloats in Lisp?
+＠node Q7.2.1, Q7.2.2, Q7.1.11, Advanced
+＠unnumberedsubsec Q7.2.1: What are bignums, ratios, and bigfloats in Lisp?
Thanks to ＠email{james＠(a)xemacs.org, Jerry James}, XEmacs 21.5.18 and
later can use the capabilities of multiple-precision libraries that may
＠＠ -6563,7 +7223,7 ＠＠
＠itemize
＠item
Arithmetic can cause a segfault, depending on your MP library
-(a)ref{Q7.3.2, XEmacs segfaults when I use very big numbers!}.
+(a)ref{Q7.2.2, XEmacs segfaults when I use very big numbers!}.
＠item
Terminology is not Common-Lisp-conforming. For example, ``integer'' for
＠＠ -6589,7 +7249,7 ＠＠
can't be ruled out. ``Arbitrary'' precision means precisely what it
says. If you work with extremely large numbers, your machine may
arbitrarily decide to hand you an unpleasant surprise rather than a
-bignum ＠ref{Q7.3.2, XEmacs segfaults when I use very big numbers!}.
+bignum ＠ref{Q7.2.2, XEmacs segfaults when I use very big numbers!}.
To configure with GNU MP, add
＠samp{--use-number-lib=gmp}
＠＠ -6604,8 +7264,8 ＠＠
than to writing new code, feel free to fill in the gap!
-＠node Q7.3.2, Q7.3.3, Q7.3.1, Advanced
-＠unnumberedsubsec Q7.3.2: XEmacs segfaults when I use very big numbers!
+＠node Q7.2.2, Q7.2.3, Q7.2.1, Advanced
+＠unnumberedsubsec Q7.2.2: XEmacs segfaults when I use very big numbers!
GMP by default allocates temporaries on the stack. If you run out of
stack space, you're dead; there is no way that we know of to reliably
＠＠ -6622,8 +7282,8 ＠＠
yet.)
-＠node Q7.3.3, Q7.3.4, Q7.3.2, Advanced
-＠unnumberedsubsec Q7.3.3: Bignums are really slow!
+＠node Q7.2.3, Q7.2.4, Q7.2.2, Advanced
+＠unnumberedsubsec Q7.2.3: Bignums are really slow!
Many Linux distributions compile all their packages for the i386, and
this is costly. An optimized version can give you two or three orders
＠＠ -6631,8 +7291,8 ＠＠
See ＠uref{http://www.swox.com/gmp/gmp-speed.html}.)
-＠node Q7.3.4, , Q7.3.3, Advanced
-＠unnumberedsubsec Q7.3.4: Equal bignums don't compare as equal! What gives?
+＠node Q7.2.4, , Q7.2.3, Advanced
+＠unnumberedsubsec Q7.2.4: Equal bignums don't compare as equal! What gives?
Ah, Grasshopper, I see you are using ＠code{(eq x y)}. The Bodhisattva
CLTL2 warned of the illusion that equal numbers would be ＠samp{eq}!
＠＠ -6654,6 +7314,7 ＠＠
elsewhere in XEmacs.
＠menu
+8.0: TeX
* Q8.0.1:: Is there something better than LaTeX mode?
* Q8.0.2:: What is AUCTeX? Where do you get it?
* Q8.0.3:: Problems installing AUCTeX.
＠＠ -7010,6 +7671,7 ＠＠
the same directory, or ＠file{OONEWS} for really old versions.
＠menu
+9.0: Changes
* Q9.0.1:: What new features will be in XEmacs soon?
* Q9.0.2:: What's new in XEmacs 21.4?
* Q9.0.3:: What's new in XEmacs 21.1?
＠＠ -7339,6 +8001,7 ＠＠
to released XEmacsen, but users can apply themselves) are also accepted.
＠menu
+10.0: XEmacs 21.1
* Q10.0.1:: Gnus 5.10 won't display smileys in XEmacs 21.1.
＠end menu
1.1 XEmacs/xemacs/man/beta.texi
Index: beta.texi
===================================================================
\input texinfo ＠c -*-texinfo-*-
＠c %**start of header
＠setfilename ../info/beta.info
＠settitle Info on beta versions of XEmacs
＠direntry
* Beta: (beta). Info on beta versions of XEmacs.
＠end direntry
＠c footnotestyle separate
＠c paragraphindent 2
＠c %**end of header
＠ifinfo
This file describes info relevant to beta versions of XEmacs.
Copyright ＠copyright{} 2005 Ben Wing.
This file is part of XEmacs.
XEmacs is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2, or (at your option) any
later version.
XEmacs is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.
You should have received a copy of the GNU General Public License
along with XEmacs; see the file COPYING. If not, write to
the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.
＠end ifinfo
＠c Combine indices.
＠syncodeindex fn cp
＠syncodeindex vr cp
＠syncodeindex ky cp
＠syncodeindex pg cp
＠syncodeindex tp cp
＠setchapternewpage odd
＠finalout
＠titlepage
＠title Info on beta versions of XEmacs
＠author XEmacs Development Team
＠page
＠vskip 0pt plus 1fill
＠noindent
Copyright ＠copyright{} 2005 Ben Wing. ＠*
This file is part of XEmacs.
XEmacs is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2, or (at your option) any
later version.
XEmacs is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.
You should have received a copy of the GNU General Public License
along with XEmacs; see the file COPYING. If not, write to
the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.
＠end titlepage
＠page
＠ifinfo
＠node Top, Introduction, (dir), (dir)
This Info file describes info relevant to beta versions of XEmacs.
＠menu
* Introduction::
* Compiling Beta XEmacs::
* Packages::
* Improving XEmacs::
＠detailmenu
--- The Detailed Node Listing ---
Introduction
* Mailing Lists::
* Beta Release Schedule::
* Reporting Problems::
* Getting the Source::
Mailing Lists
* XEmacs Beta Mailing List::
* XEmacs Patches Mailing List::
* XEmacs Design Mailing List::
* List Administrivia::
* Managing your subscription via the Web::
* Subscribing by e-mail::
* Unsubscribing by e-mail::
Compiling Beta XEmacs
* Building an XEmacs from patches::
* Building XEmacs from a full distribution::
Packages
* Binary package installation::
* Manual procedures for package management::
* Building XEmacs and XEmacs packages from scratch::
Improving XEmacs
* Creating patches for submission::
* Large contributions::
Creating patches for submission
* Patch discussion etiquette::
Large contributions
* Updates to existing packages::
* New packages::
* Syncing with GNU Emacs::
＠end detailmenu
＠end menu
＠end ifinfo
＠node Introduction, Compiling Beta XEmacs, Top, Top
＠chapter Introduction
You are running a potentially unstable version of XEmacs. Please do
not report problems with Beta XEmacs to comp.emacs.xemacs. Report
them to ＠uref{mailto:xemacs-beta＠＠xemacs.org}, preferably with
＠kbd{M-x report-xemacs-bug RET}.
＠menu
* Mailing Lists::
* Beta Release Schedule::
* Reporting Problems::
* Getting the Source::
＠end menu
＠node Mailing Lists, Beta Release Schedule, Introduction, Introduction
＠section Mailing Lists
＠menu
* XEmacs Beta Mailing List::
* XEmacs Patches Mailing List::
* XEmacs Design Mailing List::
* List Administrivia::
* Managing your subscription via the Web::
* Subscribing by e-mail::
* Unsubscribing by e-mail::
＠end menu
＠node XEmacs Beta Mailing List, XEmacs Patches Mailing List, Mailing Lists, Mailing Lists
＠subsection XEmacs Beta Mailing List
If you are not subscribed to the XEmacs beta list you should be.
Currently all discussion of development issues, including bug reports
and coding discussion, takes place on the XEmacs Beta mailing list.
Only patches and administrative actions regarding patches are sent
elsewhere (to the XEmacs Patches list).
＠node XEmacs Patches Mailing List, XEmacs Design Mailing List, XEmacs Beta Mailing List, Mailing Lists
＠subsection XEmacs Patches Mailing List
XEmacs Patches records proposed changes to XEmacs, and their
disposition. It is open subscription, and all patches that are
seriously proposed for inclusion in XEmacs should be posted here. You
can follow progress of your patch by subscribing to the mailing list
or in the archives.
Besides patches, only actions by members of the XEmacs Review Board
should be posted to this list. All discussion should be redirected to
XEmacs Beta or XEmacs Design.
＠node XEmacs Design Mailing List, List Administrivia, XEmacs Patches Mailing List, Mailing Lists
＠subsection XEmacs Design Mailing List
XEmacs Design is for design discussions such as adding major features
or whole modules, or reimplementation of existing functions, to XEmacs.
＠node List Administrivia, Managing your subscription via the Web, XEmacs Design Mailing List, Mailing Lists
＠subsection List Administrivia
In the descriptions below, the word LIST (all uppercase) is a
variable. Substitute "beta", "design", or "patches" as appropriate
(to get "xemacs-beta" as the mailbox for the XEmacs Beta mailing list,
or ＠uref{http://www.xemacs.org/Lists/#xemacs-beta} for its URL).
The XEmacs mailing lists are managed by the Mailman mailing list package,
and the usual Mailman commands work. Do not send mailing list requests to
the main address (＠uref{mailto:xemacs-LIST＠＠xemacs.org}), always send them
to ＠uref{mailto:xemacs-LIST-request＠＠xemacs.org}. If you have problems with
the list itself, they should be brought to the attention of the XEmacs
Mailing List manager ＠uref{mailto:list-manager＠＠xemacs.org} (the same
mailbox, "list-manager", for all lists). All public mailing lists have
searchable archives. The URL is
＠uref{http://list-archive.xemacs.org/xemacs-LIST}
Note that the xemacs-LIST-admin address is used internally by the
Mailman software; it is NOT a synonym for xemacs-LIST-request.
＠node Managing your subscription via the Web, Subscribing by e-mail, List Administrivia, Mailing Lists
＠subsection Managing your subscription via the Web
Subscription, unsubscription, and options (such as digests and
temporarily suspending delivery) can be accomplished via the web
interface at ＠uref{http://www.xemacs.org/Lists/#xemacs-LIST}.
＠node Subscribing by e-mail, Unsubscribing by e-mail, Managing your subscription via the Web, Mailing Lists
＠subsection Subscribing by e-mail
Send an email message to ＠uref{mailto:xemacs-LIST-request＠＠xemacs.org} with
＠samp{subscribe} (without the quotes) as the BODY of the message.
＠node Unsubscribing by e-mail, , Subscribing by e-mail, Mailing Lists
＠subsection Unsubscribing by e-mail
Send an email message to ＠uref{mailto:xemacs-LIST-request＠＠xemacs.org} with
＠samp{unsubscribe} (without the quotes) as the BODY of the message.
＠node Beta Release Schedule, Reporting Problems, Mailing Lists, Introduction
＠section Beta Release Schedule
We would like to achieve a weekly or fortnightly release cycle (you
know the Open Source model: release early, release often), and in a
perfect world that would indeed be the case. There are at least three
things that often get in the way of that goal: 1) The Release Manager
has a life outside of XEmacs (hard to believe, I know, but true),
2) we like to make releases that will build (at least on the Release
Manager's box), and 3) Murphy likes to throw a spanner in the works
right when you least expect it (Murphy's Law: Whatever can go wrong,
will go wrong).
If you'd like to keep right up to date and ride the bleeding edge, use
CVS (see ＠uref{http://www.xemacs.org/Develop/cvsaccess.html}). If you
can't use CVS for some reason and must use FTP, please let us know.
it will make it more likely that we release betas more often.
＠node Reporting Problems, Getting the Source, Beta Release Schedule, Introduction
＠section Reporting Problems
The best way to get problems fixed in XEmacs is to submit good problem
reports, ＠kbd{M-x report-xemacs-bug RET} will help you do this (assuming
you have a usable XEmacs). Since this is beta software, problems are
certain to exist. Please read through all of part II of the XEmacs
FAQ for an overview of problem reporting. Other items which are most
important are:
＠enumerate
＠item
Do not submit C stack backtraces without line numbers. Since it
is possible to compile optimized with debug information with GCC
it is never a good idea to compile XEmacs without the -g flag.
XEmacs runs on a variety of platforms, and often it is not
possible to recreate problems which afflict a specific platform.
The line numbers in the C stack backtrace help isolate where the
problem is actually occurring.
＠item
Attempt to recreate the problem starting with an invocation of
XEmacs with ＠code{xemacs -no-autoloads}. Quite often, problems are
due to package interdependencies, and the like. An actual bug
in XEmacs should be reproducible in a default configuration
without loading any special packages (or the one or two specific
packages that cause the bug to appear). If you have trouble
getting anything to work at all with the above invocation, use
＠code{xemacs -vanilla} instead. If you need to load your user init
file or the site file to get the problem to occur, then it has
something to do with them, and you should try to isolate the
issue in those files.
＠item
A picture can be worth a thousand words. When reporting an
unusual display, it is generally best to capture the problem in a
screen dump and include that with the problem report. The easiest
way to get a screen dump is to use the xv program and its grab
function. Save the image as a GIF to keep bandwidth requirements
down without loss of information. MIME is the preferred method
for making the image attachments.
＠end enumerate
＠node Getting the Source, , Reporting Problems, Introduction
＠section Getting the Source
In addition to the normal tar distribution, XEmacs source is now
available via CVS. Please see
＠uref{http://www.xemacs.org/Develop/cvsaccess.html}
＠node Compiling Beta XEmacs, Packages, Introduction, Top
＠chapter Compiling Beta XEmacs
＠menu
* Building an XEmacs from patches::
* Building XEmacs from a full distribution::
＠end menu
＠node Building an XEmacs from patches, Building XEmacs from a full distribution, Compiling Beta XEmacs, Compiling Beta XEmacs
＠section Building an XEmacs from patches
All beta releases of XEmacs are included with patches from the previous
version in an attempt to keep bandwidth requirements down. Patches
should be applied with the GNU patch program in something like the
following. Let's say you're upgrading XEmacs 21.5-beta9 to XEmacs
21.5-beta10 and you have a full unmodified XEmacs 21.5-beta9 source
tree to work with. Change to the top level directory and issue the
shell command:
＠example
$ gunzip -c /tmp/xemacs-21.5.9-21.5.10.patch.gz | patch -p1
＠end example
After patching, check to see that no patches were missed by doing
＠example
$ find . -name \*.rej -print
＠end example
Any rejections should be treated as serious problems to be resolved
before building XEmacs.
After seeing that there were no rejections, issue the commands
＠example
$ ./config.status --recheck
$ make beta > ./beta.err 2>&1
$ make check > ./xemacs-make-check.err 2>&1
＠end example
Redirect the output from make to those files because you'll use them
later when you send off a build report with ＠kbd{M-x build-report RET}
＠node Building XEmacs from a full distribution, , Building an XEmacs from patches, Compiling Beta XEmacs
＠section Building XEmacs from a full distribution
＠enumerate
＠item
Locate a convenient place where you have at least 100MB of free space
and issue the command
＠example
$ gunzip -c /tmp/xemacs-21.5.10.tar.gz | tar xvf -
＠end example
(or simply ＠code{tar zxvf /tmp/xemacs-21.5.10.tar.gz} if you use GNU tar).
＠item
cd to the top level directory and issue an appropriate configure
command.
＠item
Run ＠code{configure}. If you are new, just consider running it with no
options, to see if you can get a succesful build. When you are more
experienced, you should put various flags in. Here is what we suggest:
＠enumerate
＠item
It's a good idea to use
＠example
--extra-verbose
--debug
--memory-usage-stats
--error-checking=all
＠end example
These turn on extra debugging info and checks. The last one in particular
will add a great deal of extra error-checking -- which will slow your XEmacs
down somewhat but is likely to catch bugs much sooner and make your bug
reports much more useful.
＠item
You should also strongly consider
＠example
--with-mule
--use-pkcc
--pdump
--with-clash-detection
--with-wmcommand
--with-xfs
＠end example
These turn on optional features, which can always use testing.
＠item
If you have gcc, consider using
＠example
--compiler=gcc
--xemacs-compiler=g++
＠end example
This will compile XEmacs using g++, which will turn on a lot of additional
error-checking.
＠item
If your packages are not installed under /usr/local, you should add a
line like
＠example
--package-path=~/.xemacs::/xemacs/site-packages:/xemacs/xemacs-packages:/xemacs/mule-packages
＠end example
＠item
If you want to build multiple configurations from the same source
tree, make separate build directories for each configuration, run
＠code{configure} from the top level of these (currently empty)
directories and use an option like
＠example
--srcdir=/xemacs/source-tree
＠end example
(or wherever your source tree is). This will magically create symlinks and
populate your build directory.
＠item
Use --site-prefixes (or --site-includes and --site-libraries) if you have
some packages that XEmacs can compile with that are located in an unusual
place. For example:
＠example
--site-prefixes=/usr/local/pgsql:/usr/local/BerkeleyDB.4.1
＠end example
＠item
Depending on your build environment, consuder setting or not setting
options for menubars, scrollbars, window systems, native sound, etc. If
you're not sure, leave them out and let configure do the auto-detection.
(If you get bugs compiling GTK, use ＠code{--with-gtk=no --with-gnome=no}.)
Part of the configure output is a summary that looks something
like the following. (this summary is also available as the file
'Installation' in the top directory of your build tree, and via
the command ＠kbd{M-x describe-installation RET}).
＠example
uname -a: Linux eicq 2.4.20 #1 Wed Dec 18 02:14:29 EST 2002 i586 unknown
./configure '--extra-verbose' '--site-prefixes=/usr/local/pgsql:/usr/local/BerkeleyDB.4.1' '--dynamic=yes' '--with-gtk=no' '--with-gnome=no' '--with-toolbars' '--with-wmcommand' '--with-athena=next' '--with-menubars=lucid' '--with-scrollbars=athena' '--with-dialogs=athena' '--with-widgets=athena' '--with-gif' '--with-sound=native,noesd' '--with-site-lisp=no' '--with-site-modules' '--pdump' '--with-mule' '--with-xfs' '--debug' '--error-checking=all' '--memory-usage-stats' '--use-kkcc' '--with-clash-detection'
XEmacs 21.5-b10 "burdock" (+CVS-20030131) configured for `i586-pc-linux'.
Compilation / Installation:
Source code location: /usr/local/src/xemacs
Installation prefix: /usr/local
Additional prefixes: /usr/local/pgsql /usr/local/BerkeleyDB.4.1
Operating system description file: `s/linux.h'
Machine description file: `m/intel386.h'
Compiler: gcc -Wall -Wno-switch -Winline -Wmissing-prototypes -Wsign-compare -Wundef -Wstrict-prototypes -Wshadow -Wmissing-declarations -O1 -ggdb3 -Wall -Wchar-subscripts -Wunused -Wundef -Wshadow -Wsign-compare -Wmissing-declarations -march=k6
Relocating allocator for buffers: no
GNU version of malloc: yes
- Using Doug Lea's new malloc from the GNU C Library.
Window System:
Compiling in support for the X window system:
- X Windows headers location: /usr/X11/include
- X Windows libraries location: /usr/X11/lib
- Handling WM_COMMAND properly.
Compiling in support for the Athena widget set:
- Athena headers location: X11/neXtaw
- Athena library to link: neXtaw
Using Lucid menubars.
Using Athena scrollbars.
Using Athena dialog boxes.
Using Athena native widgets.
TTY:
Compiling in support for ncurses.
Compiling in support for GPM (General Purpose Mouse).
Images:
Compiling in support for GIF images (builtin).
Compiling in support for XPM images.
Compiling in support for PNG images.
Compiling in support for JPEG images.
Compiling in support for TIFF images.
Compiling in support for X-Face message headers.
Sound:
Compiling in support for sound (native).
Databases:
Compiling in support for Berkeley database.
Compiling in support for PostgreSQL.
- Using PostgreSQL header file: libpq-fe.h
- Using PostgreSQL V7 bindings.
Internationalization:
Compiling in support for Mule (multi-lingual Emacs).
Compiling in support for XIM (X11R5+ I18N input method).
- Using raw Xlib to provide XIM support.
- Using XFontSet to provide bilingual menubar.
Mail:
Compiling in support for "dot-locking" mail spool file locking method.
Other Features:
Inhibiting IPv6 canonicalization at startup.
Compiling in support for dynamic shared object modules.
Using the new GC algorithms.
Using the new portable dumper.
Compiling in support for extra debugging code.
WARNING: WARNING: Compiling in support for runtime error checking.
WARNING: XEmacs will run noticeably more slowly as a result.
WARNING: Error checking is on by default for XEmacs beta releases.
WARNING:
＠end example
＠end enumerate
＠item
Then...
＠example
$ make > ./beta.err 2>&1
$ make check > ./xemacs-make-check.err 2>&1
＠end example
...and you should have a working XEmacs.
＠item
After you have verified that you have a functional editor, fire up
your favorite mail program and send a build report to
＠uref{mailto:xemacs-buildreports＠＠xemacs.org}.
Preferably this is best done from XEmacs, following these simple steps:
＠enumerate
＠kbd{M-x customize-group RET build-report RET}
＠kbd{M-x build-report RET}
＠end enumerate
See also
＠uref{http://www.xemacs.org/Releases/Public-21.2/tester.html#reporting}
If you create the report manually by other means, here is what the
build report should include:
＠enumerate
＠item
Your hardware configuration (OS version, etc.)
＠item
Version numbers of software in use (X11 version, system library
versions if appropriate, graphics library versions if appropriate).
If you're on a system like Linux, include all the version numbers
you can because chances are it makes a difference.
＠item
The options given to configure
＠item
The configuration report illustrated above
For convenience all of the above items are placed in a file called
`Installation' in the top level build directory. They are also
available by performing ＠kbd{M-x describe-installation} inside XEmacs.
＠item
Any other unusual items you feel should be brought to the attention
of the developers.
＠end enumerate
＠end enumerate
＠node Packages, Improving XEmacs, Compiling Beta XEmacs, Top
＠chapter Packages
[Note: these instructions have been partly updated, but not carefully
reviewed in some time. Caveat tester.]
Starting with XEmacs 21.1, much of the functionality of XEmacs has
been unbundled into "the packages." For more information about the
package system, see the Info nodes on Packages (in the XEmacs User
Manual) and on Packaging (in the Lisp Reference).
When bootstrapping XEmacs, you may need to manually install some
packages (at least xemacs-base and efs). These packages are available
by FTP at ＠uref{ftp://ftp.xemacs.org/pub/xemacs/packages/}.
＠menu
* Binary package installation::
* Manual procedures for package management::
* Building XEmacs and XEmacs packages from scratch::
＠end menu
＠node Binary package installation, Manual procedures for package management, Packages, Packages
＠section Binary package installation
Prerequisite: XEmacs 21.0-b1.
Binary packages are complete entities that can be untarred at the top
level of an XEmacs package hierarchy and work at runtime. To install files
in this directory, run the command ＠kbd{M-x package-admin-add-binary-package}
and fill in appropriate values to the prompts.
＠node Manual procedures for package management, Building XEmacs and XEmacs packages from scratch, Binary package installation, Packages
＠section Manual procedures for package management
Prerequisite: XEmacs 21.0
When adding and deleting files from a lisp directory the
auto-autoloads.el (global symbols) and custom-load.el (Customization
groups) must be kept in synch. Assuming one is manipulating a
directory called `lisp-utils', the command to rebuild the
auto-autoloads.el file is:
＠example
xemacs -vanilla -batch \
-eval \("setq autoload-package-name \"lisp-utils\""\) \
-f batch-update-directory lisp-utils
＠end example
The command to rebuild the custom-load.el file is:
＠example
xemacs -vanilla -batch -f Custom-make-dependencies lisp-utils
＠end example
To byte-compile both of these files the command is:
＠example
xemacs -vanilla -batch -f batch-byte-compile \
lisp-utils/auto-autoloads.el lisp-utils/custom-load.el
＠end example
Of course, being a beta tester, you'd be aware that it is much easier
to manage your XEmacs packages with PUI.
＠node Building XEmacs and XEmacs packages from scratch, , Manual procedures for package management, Packages
＠section Building XEmacs and XEmacs packages from scratch
To build everything completely from scratch isn't hard, just time
consuming.
＠subheading Step 1 - grab the sources (core and packages)
＠example
$ cvs -d :pserver:cvs＠＠cvs.xemacs.org:/pack/xemacscvs login
[password: "cvs" (sans quotes)]
$ cvs -d :pserver:cvs＠＠cvs.xemacs.org:/pack/xemacscvs co -d xemacs-21.5 xemacs
$ cvs -d :pserver:cvs＠＠cvs.xemacs.org:/pack/xemacscvs co packages
＠end example
＠subheading Step 2 - build XEmacs
＠example
$ cd xemacs-21.5
$ ./configure [options...]
$ make > ./beta.err 2>&1
$ make check > ./xemacs-make-check.err 2>&1
＠end example
And optionally:
＠example
$ make install > ./xemacs-make-install.err 2>&1
＠end example
＠subheading Step 3 - build and install the packages
＠example
$ cd packages
$ cp Local.rules.template Local.rules
＠end example
Then edit Local.rules to suit your needs/environment
(＠pxref{Local.rules file,,, xemacs, XEmacs User's Manual}) for details
about this file.
And then:
＠example
$ make install
＠end example
＠node Improving XEmacs, , Packages, Top
＠chapter Improving XEmacs
＠menu
* Creating patches for submission::
* Large contributions::
＠end menu
＠node Creating patches for submission, Large contributions, Improving XEmacs, Improving XEmacs
＠section Creating patches for submission
All patches to XEmacs that are seriously proposed for inclusion (eg,
bug fixes) should be mailed to ＠uref{mailto:xemacs-patches＠＠xemacs.org}. Each
patch will be reviewed by the patches review board, and will be
acknowledged and added to the distribution, or rejected with an
explanation. Progress of the patch is tracked on the XEmacs Patches
mailing list, which is open subscription. (If a patch is simply
intended to facilitate discussion, "I mean something that works like
this but this is really rough", a Cc to XEmacs Patches is optional,
but doesn't hurt.)
Patches to XEmacs Lisp packages should be sent to the maintainer of
the package. If the maintainer is listed as `XEmacs Development Team'
patches should be sent to ＠uref{mailto:xemacs-patches＠＠xemacs.org}.
Emailed patches should preferably be sent in MIME format and quoted
printable encoding (if necessary).
The simplest way to create well-formed patches is to use CVS and
Didier Verna's Patcher library (available as patcher.el in the
xemacs-devel package). Patcher is new and requires some setup, but
most of the core developers are now using it for their own patches.
Patcher also can be configured to create patches for several projects,
and recognize the project from the directory it is invoked in. This
makes it a useful general tool (as long as XEmacs-style patches are
accepted at your other projects, which is likely since they conform to
the GNU standards).
When making patches by hand, please use the `-u' option, or if your
diff doesn't support it, `-c'. Using ordinary (context-free) diffs
are notoriously prone to error, since line numbers tend to change when
others make changes to the same source file.
An example of the `diff' usage:
＠example
$ diff -u OLDFILE NEWFILE
＠end example
-or-
＠example
$ diff -c OLDFILE NEWFILE
＠end example
Also, it is helpful if you create the patch in the top level of the
XEmacs source directory:
＠example
$ cp -p lwlib/xlwmenu.c lwlib/xlwmenu.c.orig
hack, hack, hack....
$ diff -u lwlib/xlwmenu.c.orig lwlib/xlwmenu.c
＠end example
Also note that if you cut & paste from an xterm to an XEmacs mail
buffer you will probably lose due to tab expansion. The best thing to
do is to use an XEmacs shell buffer to run the diff commands, or ...
＠kbd{M-x cd} to the appropriate directory, and issue the command
＠kbd{C-u M-!} from within XEmacs.
Patches should be as single-minded as possible. Mammoth patches can
be very difficult to place into the right slot. They are much easier
to deal with when broken down into functional or conceptual chunks.
The patches submitted by Kyle Jones and Hrvoje Niksic are stellar
examples of how to "Do The Right Thing".
Each patch should be accompanied by an update to the appropriate
ChangeLog file. Guidelines for writing ChangeLog entries is governed
by the GNU coding standards. Please see
＠uref{http://www.gnu.org/prep/standards_toc.html} [Change Logs section]
for details.
Do not submit context diffs (either -c or -u) of ChangeLogs. Because
of the "stack" nature of ChangeLogs (new entries are always pushed on
the top), context diffs will fail to apply more often than they
succeed. Simply cutting and pasting the entry from an Emacs buffer to
the mail buffer (beware of tab expansion!) is probably easiest. The
Patcher library also will set up your ChangeLogs for you, and copy
them to the mail. Context-less unified diffs (-U 0) are also
acceptable.
＠menu
* Patch discussion etiquette::
＠end menu
＠node Patch discussion etiquette, , Creating patches for submission, Creating patches for submission
＠subsection Patch discussion etiquette
If you intend a patch for _application_ to the sources as is, _always_
post it to xemacs-patches, even if there are minor points you would
like to have discussed by others. Not doing so will resulting in
patches getting "lost". If you expect that the patch will not be
acceptable, but are using it to stimulate discussion, then don't post
to xemacs-patches. Intermediate cases are up to your judgment;
unless you're sure you'll follow up with a "real" patch, better to err
on the side of posting to xemacs-patches.
Discussion of the _content_ of the patch (ie responses to reviewer
comments beyond "that's right, ok, I'll do it your way") should _always_
be posted to xemacs-beta or to xemacs-design. If you're not sure
which is more appropriate, send it to xemacs-beta. That is the most
widely read channel.
If discussion results in a bright idea and you come up with a new
patch, normally you should post it to both mailing lists. The people
discussing on XEmacs Beta will want to know the outcome of the thread,
and you need to submit to XEmacs Patches as the "list of record."
If the old patch has been applied to CVS, then just submit the new one
as usual. If it has not been applied, then it is best to submit a new
patch against CVS. If possible do this as a reply to the original
patch post, or something following it in the thread. (The point is to
get the original patch post's Message-ID in your References header.)
In this case, also use the keyword SUPERSEDES in the Subject header to
indicate that the old patch is no longer valid, and that this one
replaces it.
These rules will result in a fair number of cross posts, but we don't
yet have a better way to handle that.
Note: Developers should never post to xemacs-patches unless there is a
patch in the post. We plan to enforce this with an automatic filter.
The exceptions are administrative. If you have commit authorization,
then post a short COMMIT notice to xemacs-patches when you commit to
CVS. Members of the Review Board will also post short notices of
administrative action (APPROVE, VETO, QUERY, etc) to xemacs-patches.
＠node Large contributions, , Creating patches for submission, Improving XEmacs
＠section Large contributions
Perhaps you have a whole new mode, or a major synchronization with
upstream for a neglected package, or a synchronization with GNU Emacs
you would like to contribute. We welcome such contributions, but they
are likely to be relatively controversial, generate more comments and
requests for revision, and take longer to integrate. Please be
patient with the process.
＠menu
* Updates to existing packages::
* New packages::
* Syncing with GNU Emacs::
＠end menu
＠node Updates to existing packages, New packages, Large contributions, Large contributions
＠subsection Updates to existing packages
If a package has gotten a bit out of date, or even started to bitrot,
we welcome patches to synchronize it with upstream/GNU Emacs versions.
Most packages end up varying somewhat from their GNU origins. See
"Syncing with GNU Emacs" for hints. Note that if you do a reasonably
large amount of syncing with GNU Emacs, you should log this in the
file itself as well as in the ChangeLog.
If the package is important to you, please consider becoming the
maintainer. (See "New packages", below.)
＠node New packages, Syncing with GNU Emacs, Updates to existing packages, Large contributions
＠subsection New packages
If you have a new mode or other large addition that does not require
changes to the core, please consider submitting it as a package, and
becoming the maintainer. You get direct commit privileges to the
repository for your package, "approval" privileges for your own
patches as well as third party patches to your package, and some
degree of veto power over patches you don't like. In return, you are
expected to maintain friendly liaison with the upstream developer (if
you aren't the upstream developer), keep watch on the XEmacs Patches
list for relevant patches, and be available by email to other
developers for discussion of changes that impact your package. It's
also a pretty standard route to the "core" development group, where we
have plenty of extra work waiting for volunteers.
You don't have to become the maintainer, but it virtually ensures
rapid acceptance of the package.
For help in creating new packages, see the (rather sparse) discussions
in the XEmacs User's Guide and the Lisp Reference Manual. The XEmacs
Package Release Engineer (Ville Skyttä ＠uref{mailto:scop＠＠xemacs.org}
is currently serving with Norbert Koch ＠uref{mailto:viteno＠＠xemacs.org}
assisting; Steve Youngs ＠uref{mailto:youngs＠＠xemacs.org} and Stephen
Turnbull ＠uref{mailto:stephen＠＠xemacs.org} also can help) are the most
likely sources of advice.
＠node Syncing with GNU Emacs, , New packages, Large contributions
＠subsection Syncing with GNU Emacs
Syncing with GNU Emacs is an important activity. Although each
version has its advantages and areas of concentration, it is very
desirable that common functionality share specifications and APIs.
When porting GNU code to XEmacs, the following points should be given
special attention:
＠itemize ＠bullet
＠item
Recent GNU Emacsen cannot be built without Mule, but XEmacs can.
Make sure your changes do not assume the presence of Mule.
＠item
GNU Emacs nomenclature often differs from that of XEmacs.
Sometimes syncing the names is desirable, other times not.
＠item
GNU Emacs functionality often differs from that of XEmacs.
Syncing functionality is often controversial.
＠end itemize
It is important that you let other developers know that
synchronization has taken place, to what degree, and when. For this
purpose, we use comments of the form
＠example
/* Synched up with: FSF 21.3 by Stephen Turnbull */
＠end example
in the source file itself, as the last element of the prefatory
material (copyright notice and commentary). Obviously the comment
marker needs to be changed to leading semicolons for Lisp, but
otherwise the format is the same.
Of course you should note syncing as the purpose in the ChangeLog,
too. But entries get buried deep in the ChangeLog file, and may even
get moved to a separate ChangeLog.OLD file for rarely synched files.
Rather than dates we use the version of GNU Emacs to sync to. If the
synchronization is partial, add a new comment describing what has
actually been synched, leaving the description of the last full sync
in place. At each full sync, remove all previous synchronization
comments.
This applies to Lisp that we have broken out into packages, but
remains in the GNU Emacs core, as well to core Lisp in XEmacs.
＠c Print the tables of contents
＠contents
＠c That's all
＠node Index, , Defining Variables, Top
＠unnumbered Index
＠printindex cp
＠bye
1.5 +9 -10 XEmacs/xemacs/man/xemacs/help.texi
(In the diff below, changes in quantity of whitespace are not shown.)
Index: help.texi
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/man/xemacs/help.texi,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -b -r1.4 -r1.5
--- help.texi 2004/08/13 09:47:57 1.4
+++ help.texi 2005/01/31 20:08:50 1.5
＠＠ -442,13 +442,12 ＠＠
information. ＠kbd{C-h C-w} (＠code{describe-no-warranty}) displays the
full details on the complete absence of warranty for XEmacs. ＠kbd{C-h
n} (＠code{view-emacs-news}) displays the file ＠file{xemacs/etc/NEWS},
-which contains documentation on XEmacs changes arranged chronologically.
-＠kbd{C-h F} (＠code{xemacs-local-faq}) displays local version of the
-XEmacs frequently-answered-questions-list. ＠kbd{C-h t}
-(＠code{help-with-tutorial}) displays the learn-by-doing XEmacs
-tutorial. ＠kbd{C-h C-c} (＠code{describe-copying}) displays the file
-＠file{xemacs/etc/COPYING}, which tells you the conditions you must obey
-in distributing copies of XEmacs. ＠kbd{C-h C-d}
-(＠code{describe-distribution}) displays another file named
-＠file{xemacs/etc/DISTRIB}, which tells you how you can order a copy of
-the latest version of XEmacs.
+which contains documentation on XEmacs changes arranged
+chronologically. ＠kbd{C-h F} (＠code{xemacs-local-faq}) displays the
+local version of the XEmacs FAQ (Frequently Answered Questions list).
+＠kbd{C-h t} (＠code{help-with-tutorial}) displays the learn-by-doing
+XEmacs tutorial. ＠kbd{C-h C-c} (＠code{describe-copying}) displays the
+file ＠file{xemacs/etc/COPYING}, which tells you the conditions you
+must obey in distributing copies of XEmacs. ＠kbd{C-h C-d}
+(＠code{describe-distribution} displays the section of the FAQ that
+tells you how you can get the latest version of XEmacs.
1.3 +48 -13 XEmacs/xemacs/man/xemacs/new.texi
(In the diff below, changes in quantity of whitespace are not shown.)
Index: new.texi
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/man/xemacs/new.texi,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -b -r1.2 -r1.3
--- new.texi 2001/04/12 18:22:29 1.2
+++ new.texi 2005/01/31 20:08:50 1.3
＠＠ -235,39 +235,74 ＠＠
＠cindex version number
＠example
-(cond ((string-match "Lucid" emacs-version)
+(cond ((string-match "XEmacs" emacs-version)
;;
- ;; Code for any version of Lucid Emacs or XEmacs goes here
+ ;; Code for any version of XEmacs goes here.
;;
))
-(cond ((and (string-match "XEmacs" emacs-version)
- (or (> emacs-major-version 19)
- (>= emacs-minor-version 12)))
+(cond ((not (string-match "XEmacs" emacs-version)))
;;
- ;; Code which requires XEmacs version 19.12 or newer goes here
+ ;; Code for any version of GNU Emacs goes here.
;;
))
-(cond ((>= emacs-major-version 19)
+(cond ((and (string-match "XEmacs" emacs-version)
+ (emacs-version>= 21 4))
;;
- ;; Code for any vintage-19 emacs goes here
+ ;; Code which requires XEmacs version 21.4 or newer goes here
;;
))
-(cond ((and (not (string-match "Lucid" emacs-version))
- (= emacs-major-version 19))
+(cond ((and (string-match "XEmacs" emacs-version)
+ (emacs-version>= 21 4 12)
+ (not (emacs-version>= 21 4 15)))
;;
- ;; Code specific to FSF Emacs 19 (not XEmacs) goes here
+ ;; Code which requires exactly XEmacs version 21.4.12 through
+ ;; 21.4.14, inclusive, goes here. (e.g. A bug was introduced in
+ ;; 21.4.12 and fixed in 21.4.15 but many of the versions of
+ ;; XEmacs around in the computer laboratory run those versions,
+ ;; so I need to introduce a workaround. In such a case, you
+ ;; should ideally try to conditionalize on something else,
+ ;; e.g. a feature symbol or a simple test that can be run to
+ ;; smoke out the bug.)
;;
))
-(cond ((< emacs-major-version 19)
+(cond ((and (not (string-match "XEmacs" emacs-version)
+ (emacs-version>= 20 2))
;;
- ;; Code specific to emacs 18 goes here
+ ;; Code which requires GNU Emacs version 20.2 or newer, but not XEmacs,
+ ;; goes here
;;
))
+
+＠end example
+
+＠emph{NOTE}: ＠strong{DO} use ＠code{(emacs-version>= ...)}. ＠strong{DO NOT}
+try to do this yourself using ＠code{emacs-major-version} and
+＠code{emacs-minor-version}. You will, with high probability, get it
+wrong. Typical attempts to replace ＠code{(emacs-version>= 21 4)} use
+
+＠example
+(and (>= emacs-major-version 21)
+ (>= emacs-minor-version 4))
+＠end example
+
+which correctly excludes 21.3 and all previous versions,
+but also excludes 22.0 through 22.3, 23.0 through 23.3, etc.
+
+A "more clever" version, as advocated in earlier versions
+of this very manual, was like this:
+
+＠example
+(or (> emacs-major-version 21)
+ (>= emacs-minor-version 4))
＠end example
+
+which correctly includes 21.4 and all following versions,
+but also includes 20.4 through 20.99999, 19.4 through
+19.99999, etc.
Alternatively, use ＠file{.xemacs/init.el} for an init file. ＠xref{Init File}.
1.18 +5 -21 XEmacs/xemacs/man/xemacs/xemacs.texi
(In the diff below, changes in quantity of whitespace are not shown.)
Index: xemacs.texi
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/man/xemacs/xemacs.texi,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -b -r1.17 -r1.18
--- xemacs.texi 2005/01/28 00:12:39 1.17
+++ xemacs.texi 2005/01/31 20:08:50 1.18
＠＠ -996,27 +996,12 ＠＠
the GNU General Public License that comes with XEmacs and also appears
following this section.
-The easiest way to get a copy of XEmacs is from someone else who has it.
-You need not ask for permission to do so, or tell any one else; just copy
-it.
+To get XEmacs, go to ＠uref{http://www.xemacs.org/Download/}.
-If you have access to the Internet, you can get the latest version of
-XEmacs from the anonymous FTP server ＠file{ftp.xemacs.org} in the directory
-＠file{/pub/xemacs}. It can also be found at numerous other archive
-sites around the world; check the file ＠file{etc/DISTRIB} in an XEmacs
-distribution for the latest known list.
-
-
＠unnumberedsec Getting Other Versions of Emacs
-
-The Free Software Foundation's version of Emacs (called ＠dfn{FSF Emacs}
-in this manual and often referred to as ＠dfn{GNU Emacs}) is available
-by anonymous FTP from ＠file{prep.ai.mit.edu}.
-Win-Emacs, an older version of XEmacs that runs on Microsoft Windows
-and Windows NT, is available by anonymous FTP from ＠file{ftp.netcom.com}
-in the directory ＠file{/pub/pe/pearl}, or from ＠file{ftp.cica.indiana.edu}
-as the files ＠file{wemdemo*.zip} in the directory ＠file{/pub/pc/win3/demo}.
+The Free Software Foundation's version of Emacs (＠dfn{GNU Emacs}) is
+available at ＠uref{http://www.gnu.org/software/emacs/emacs.html}.
＠node Intro, Glossary, Distrib, Top
＠unnumbered Introduction
＠＠ -1025,9 +1010,8 ＠＠
self-documenting, customizable, extensible real-time display editor
Emacs. XEmacs provides many powerful display and user-interface
capabilities not found in other Emacsen and is mostly upwardly
-compatible with GNU Emacs from the Free Software Foundation
-(referred to as ＠dfn{FSF Emacs} in this manual). XEmacs also
-comes standard with a great number of useful packages.
+compatible with GNU Emacs from the Free Software Foundation. XEmacs
+also comes standard with a great number of useful packages.
We say that XEmacs is a ＠dfn{display} editor because normally the text
being edited is visible on the screen and is updated automatically as you
1.180 +5 -0 XEmacs/xemacs/nt/ChangeLog
(In the diff below, changes in quantity of whitespace are not shown.)
Index: ChangeLog
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/nt/ChangeLog,v
retrieving revision 1.179
retrieving revision 1.180
diff -u -b -r1.179 -r1.180
--- ChangeLog 2005/01/29 00:32:38 1.179
+++ ChangeLog 2005/01/31 20:08:52 1.180
＠＠ -1,3 +1,8 ＠＠
+2005-01-31 Ben Wing <ben(a)xemacs.org>
+
+ * xemacs.mak (install):
+ Also copy BUGS, README, COPYING and Installation.
+
2005-01-28 Ben Wing <ben(a)xemacs.org>
* config.inc.samp (COMPFACE_DIR):
1.112 +8 -0 XEmacs/xemacs/nt/xemacs.mak
(In the diff below, changes in quantity of whitespace are not shown.)
Index: xemacs.mak
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/nt/xemacs.mak,v
retrieving revision 1.111
retrieving revision 1.112
diff -u -b -r1.111 -r1.112
--- xemacs.mak 2005/01/28 01:54:47 1.111
+++ xemacs.mak 2005/01/31 20:08:52 1.112
＠＠ -1457,8 +1457,16 ＠＠
＠echo Installing in $(INSTALL_DIR) ...
＠echo PlaceHolder > PlaceHolder
＠$(COPY) $(SRCROOT)\PROBLEMS "$(INSTALL_DIR)\"
+ ＠$(COPY) $(SRCROOT)\BUGS "$(INSTALL_DIR)\"
+ ＠$(COPY) $(SRCROOT)\README "$(INSTALL_DIR)\"
+ ＠$(COPY) $(SRCROOT)\COPYING "$(INSTALL_DIR)\"
+ ＠$(COPY) $(SRCROOT)\Installation "$(INSTALL_DIR)\"
＠$(COPY) PlaceHolder "$(INSTALL_DIR)\lock\"
-$(DEL) "$(INSTALL_DIR)\lock\PlaceHolder"
+# ＠$(COPY) $(BLDLIB_SRC)\*.exe "$(INSTALL_DIR)\lib-src\"
+# ＠$(COPY) $(BLDLIB_SRC)\DOC "$(INSTALL_DIR)\lib-src\"
+# ＠$(COPY) $(CONFIG_VALUES) "$(INSTALL_DIR)\lib-src\"
+# ＠$(COPY) $(BLDSRC)\xemacs.exe "$(INSTALL_DIR)\bin\"
＠$(COPY) $(BLDLIB_SRC)\*.exe "$(INSTALL_DIR)\$(EMACS_CONFIGURATION)\"
＠$(COPY) $(BLDLIB_SRC)\DOC "$(INSTALL_DIR)\$(EMACS_CONFIGURATION)"
＠$(COPY) $(CONFIG_VALUES) "$(INSTALL_DIR)\$(EMACS_CONFIGURATION)"
- 1 participants
- 0 comments
CVS update: MODIFIED: xemacs ...
20 years, 1 month
CVS Monitor
CVS Monitor
User: ben
Date: 05/01/31 21:01:51
Modified: xemacs PROBLEMS ChangeLog Makefile.in.in
Removed: xemacs GETTING.GNU.SOFTWARE
Log:
Documentation updates
GETTING.GNU.SOFTWARE, Makefile.in.in: Delete GETTING.GNU.SOFTWARE from SOURCES.
PROBLEMS: Delete reference to check_cygwin_setup.sh.
Delete stuff that is irrelevant, mislocated or woefully out-of-date.
GNU, SERVICE: Delete.
* ORDERS, ORDERS.EUROPE, ORDERS.JAPAN: Delete.
* CHARSETS, CODINGS: Delete.
* DEBUG, LPF, MORE.STUFF, MOTIVATION: Delete.
aliases.ksh: Delete. (moved to xemacs-builds/steve)
* README.HYPERBOLE, README.OO-BROWSER: Delete.
* chr.png, chrm.png: Move to photos/.
check_cygwin_setup.sh: Delete.
* gnu.xpm, gnu.xbm, sink.xbm: Delete.
* ms-kermit, ms-kermit-7bit: Delete.
TERMS: Delete.
* DISTRIB, FTP, MACHINES, MAILINGLISTS, PACKAGES:
Delete and move to FAQ.
BETA: Delete and move to man/beta.texi.
README: Update.
help.el: Removed.
xemacs/help.texi: Delete references to DISTRIB. Point to FAQ.
xemacs/new.texi: Update sample code for version checking.
xemacs/xemacs.texi: Delete references to DISTRIB. Point directly to web site.
Update stuff referring to GNU Emacs. Delete references to Win-Emacs.
Makefile: Add beta.texi and built files.
xemacs-faq.texi: Major overhaul of section 1. Add mailing list info, update
downloading info, add info on CVS, etc.
xemacs.mak: Also copy BUGS, README, COPYING and Installation.
Revision Changes Path
1.69 +1 -7 XEmacs/xemacs/PROBLEMS
(In the diff below, changes in quantity of whitespace are not shown.)
Index: PROBLEMS
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/PROBLEMS,v
retrieving revision 1.68
retrieving revision 1.69
diff -u -b -r1.68 -r1.69
--- PROBLEMS 2003/09/19 16:24:33 1.68
+++ PROBLEMS 2005/01/31 20:01:49 1.69
＠＠ -783,12 +783,6 ＠＠
Try configuring with pdump or without system malloc.
-*** In general use etc/check_cygwin_setup.sh to trap environment problems.
-
-The script etc/check_cygwin_setup.sh will attempt to detect whether
-you have a suitable environment for building. This script may not work
-correctly if you are using ash instead of bash (see below).
-
*** Syntax errors running configure scripts, make failing with exit code 127
in inexplicable situations, etc.
＠＠ -1004,7 +998,7 ＠＠
or in /usr/openwin/lib/. If you keep yours in a different place, set the
environment variable $XKEYSYMDB to point to it before starting emacs. If
you still have the problem after doing that, perhaps your version of X is
-too old. There is a copy of the MIT X11R5 XKeysymDB file in the emacs `etc'
+too old. There is a copy of the MIT X11R6 XKeysymDB file in the emacs `etc'
directory. Try using that one.
*** My X resources used to work, and now some of them are being ignored.
1.432 +8 -0 XEmacs/xemacs/ChangeLog
(In the diff below, changes in quantity of whitespace are not shown.)
Index: ChangeLog
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/ChangeLog,v
retrieving revision 1.431
retrieving revision 1.432
diff -u -b -r1.431 -r1.432
--- ChangeLog 2005/01/27 17:42:40 1.431
+++ ChangeLog 2005/01/31 20:01:50 1.432
＠＠ -1,3 +1,11 ＠＠
+2005-01-31 Ben Wing <ben(a)xemacs.org>
+
+ * GETTING.GNU.SOFTWARE: Delete.
+ * Makefile.in.in (SOURCES):
+ Delete GETTING.GNU.SOFTWARE from SOURCES.
+ * PROBLEMS:
+ Delete reference to check_cygwin_setup.sh.
+
2005-01-26 Ben Wing <ben(a)xemacs.org>
* configure.in (AC_INIT_PARSE_ARGS):
1.24 +1 -1 XEmacs/xemacs/Makefile.in.in
(In the diff below, changes in quantity of whitespace are not shown.)
Index: Makefile.in.in
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/Makefile.in.in,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -b -r1.23 -r1.24
--- Makefile.in.in 2004/12/07 12:52:31 1.23
+++ Makefile.in.in 2005/01/31 20:01:50 1.24
＠＠ -598,7 +598,7 ＠＠
## Note: it's no disaster if these productions miss a file or two; tar
## and VC will swiftly let you know if this happens, and it is easily
## corrected.
-SOURCES = ChangeLog GETTING.GNU.SOFTWARE INSTALL Makefile.in.in PROBLEMS \
+SOURCES = ChangeLog INSTALL Makefile.in.in PROBLEMS \
README build-install.in configure make-dist move-if-change
.PHONY: unlock relock TAGS tags dist info dvi mcs
- 1 participants
- 0 comments
CVS update: MODIFIED: src ...
20 years, 1 month
CVS Monitor
CVS Monitor
User: ben
Date: 05/01/31 20:29:51
Modified: xemacs/src ChangeLog emacs.c lisp.h
Log:
define ABORT always
emacs.c: Define assert_failed() always.
lisp.h: Always define ABORT().
Revision Changes Path
1.782 +7 -0 XEmacs/xemacs/src/ChangeLog
(In the diff below, changes in quantity of whitespace are not shown.)
Index: ChangeLog
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/src/ChangeLog,v
retrieving revision 1.781
retrieving revision 1.782
diff -u -b -r1.781 -r1.782
--- ChangeLog 2005/01/29 09:15:55 1.781
+++ ChangeLog 2005/01/31 19:29:47 1.782
＠＠ -1,3 +1,10 ＠＠
+2005-01-31 Ben Wing <ben(a)xemacs.org>
+
+ * emacs.c:
+ Define assert_failed() always.
+ * lisp.h:
+ Always define ABORT().
+
2005-01-29 Ben Wing <ben(a)xemacs.org>
* alloc.c (garbage_collect_1):
1.154 +0 -2 XEmacs/xemacs/src/emacs.c
(In the diff below, changes in quantity of whitespace are not shown.)
Index: emacs.c
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/src/emacs.c,v
retrieving revision 1.153
retrieving revision 1.154
diff -u -b -r1.153 -r1.154
--- emacs.c 2005/01/28 02:36:24 1.153
+++ emacs.c 2005/01/31 19:29:48 1.154
＠＠ -3796,7 +3796,6 ＠＠
in one session without having to recompile. */
/* #define ASSERTIONS_DONT_ABORT */
-#ifdef USE_ASSERTIONS
/* This highly dubious kludge ... shut up Jamie, I'm tired of your slagging. */
/* Nonzero if handling an assertion failure. (Bumped by one each time
＠＠ -3896,7 +3895,6 ＠＠
inhibit_non_essential_conversion_operations = 0;
in_assert_failed = 0;
}
-#endif /* USE_ASSERTIONS */
/* -------------------------------------- */
/* low-memory notification */
1.122 +11 -12 XEmacs/xemacs/src/lisp.h
(In the diff below, changes in quantity of whitespace are not shown.)
Index: lisp.h
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/src/lisp.h,v
retrieving revision 1.121
retrieving revision 1.122
diff -u -b -r1.121 -r1.122
--- lisp.h 2005/01/29 09:15:59 1.121
+++ lisp.h 2005/01/31 19:29:49 1.122
＠＠ -1,7 +1,7 ＠＠
/* Fundamental definitions for XEmacs Lisp interpreter.
Copyright (C) 1985-1987, 1992-1995 Free Software Foundation, Inc.
Copyright (C) 1993-1996 Richard Mlynarik.
- Copyright (C) 1995, 1996, 2000, 2001, 2002, 2003, 2004 Ben Wing.
+ Copyright (C) 1995, 1996, 2000, 2001, 2002, 2003, 2004, 2005 Ben Wing.
This file is part of XEmacs.
＠＠ -1040,26 +1040,25 ＠＠
from error-checking macros. If we're not tricky, we just get the file
and line of the inline function, which is not very useful. */
-#ifdef USE_ASSERTIONS
/* Highly dubious kludge */
/* (thanks, Jamie, I feel better now -- ben) */
MODULE_API void assert_failed (const Ascbyte *, int, const Ascbyte *);
-# define ABORT() (assert_failed (__FILE__, __LINE__, "ABORT()"))
+#define ABORT() (assert_failed (__FILE__, __LINE__, "ABORT()"))
+
+#ifdef USE_ASSERTIONS
# define assert(x) ((x) ? (void) 0 : assert_failed (__FILE__, __LINE__, #x))
# define assert_with_message(x, msg) \
((x) ? (void) 0 : assert_failed (__FILE__, __LINE__, msg))
# define assert_at_line(x, file, line) \
((x) ? (void) 0 : assert_failed (file, line, #x))
-#else
-# ifdef DEBUG_XEMACS
+#elif defined (DEBUG_XEMACS)
# define assert(x) ((x) ? (void) 0 : (void) ABORT ())
# define assert_with_message(x, msg) ((x) ? (void) 0 : (void) ABORT ())
# define assert_at_line(x, file, line) assert (x)
-# else
+#else
# define assert(x) ((void) 0)
# define assert_with_message(x, msg)
# define assert_at_line(x, file, line) assert (x)
-# endif
#endif
/************************************************************************/
- 1 participants
- 0 comments
CVS update: MODIFIED: netinstall ...
20 years, 1 month
CVS Monitor
CVS Monitor
User: ben
Date: 05/01/31 05:06:02
Modified: xemacs/netinstall Tag: release-21-4 res.rc resource.h
Log:
fix crlf brokenness
Revision Changes Path
No revision
No revision
1.2.2.3 +546 -546 XEmacs/xemacs/netinstall/res.rc
(In the diff below, changes in quantity of whitespace are not shown.)
Index: res.rc
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/netinstall/res.rc,v
retrieving revision 1.2.2.2
retrieving revision 1.2.2.3
diff -u -b -r1.2.2.2 -r1.2.2.3
--- res.rc 2002/08/20 11:36:07 1.2.2.2
+++ res.rc 2005/01/31 04:06:01 1.2.2.3
＠＠ -516,7 +516,7 ＠＠
IDS_ERR_OPEN_READ "Can't open %s for reading: %s"
IDS_ROOT_ABSOLUTE "The install directory must be absolute, with both a drive letter and leading slash, like C:\\Cygwin"
IDS_DOWNLOAD_COMPLETE "Download Complete"
- IDS_CVSID "\n%%% $Id: res.rc,v 1.2.2.2 2002/08/20 11:36:07 stephent Exp $\n"
+ IDS_CVSID "\n%%% $Id: res.rc,v 1.2.2.3 2005/01/31 04:06:01 ben Exp $\n"
IDS_NOLOGFILE "Cannot open log file %s for writing"
IDS_UNINSTALL_COMPLETE "Uninstalls complete."
IDS_WININET "Unable to find or load the Internet Explorer 5 DLLs"
1.2.2.2 +127 -127 XEmacs/xemacs/netinstall/resource.h
(In the diff below, changes in quantity of whitespace are not shown.)
Index: resource.h
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/netinstall/resource.h,v
retrieving revision 1.2.2.1
retrieving revision 1.2.2.2
diff -u -b -r1.2.2.1 -r1.2.2.2
- 1 participants
- 0 comments
CVS update: MODIFIED: lib-src ...
20 years, 1 month
CVS Monitor
CVS Monitor
User: ben
Date: 05/01/31 05:05:04
Modified: xemacs/lib-src Tag: release-21-4 winclient.c
Log:
fix crlf brokenness
Revision Changes Path
No revision
No revision
1.3.2.2 +490 -490 XEmacs/xemacs/lib-src/winclient.c
(In the diff below, changes in quantity of whitespace are not shown.)
Index: winclient.c
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/lib-src/winclient.c,v
retrieving revision 1.3.2.1
retrieving revision 1.3.2.2
diff -u -b -r1.3.2.1 -r1.3.2.2
- 1 participants
- 0 comments
CVS update: MODIFIED: win32 ...
20 years, 1 month
CVS Monitor
CVS Monitor
User: ben
Date: 05/01/31 04:51:53
Modified: xemacsweb/Download/win32 ChangeLog index.content
Added: xemacsweb/Download/win32 optional-libs.exe
Removed: xemacsweb/Download/win32 jpeg-6b.exe patch.2.5.exe.win32.gz
png-1.0.3.exe ssh-1.2.14.exe xpm-3.4k.exe
zlib-1.1.3.exe
Log:
Update win32 optional libraries
optional-libs.exe, index.content: Update optional libraries.
Revision Changes Path
1.43 +5 -0 XEmacs/xemacsweb/Download/win32/ChangeLog
(In the diff below, changes in quantity of whitespace are not shown.)
Index: ChangeLog
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacsweb/Download/win32/ChangeLog,v
retrieving revision 1.42
retrieving revision 1.43
diff -u -b -r1.42 -r1.43
--- ChangeLog 2004/11/10 22:11:57 1.42
+++ ChangeLog 2005/01/31 03:51:48 1.43
＠＠ -1,3 +1,8 ＠＠
+2005-01-30 Ben Wing <ben(a)xemacs.org>
+
+ * optional-libs.exe: Move here, from FTP site.
+ * index.content: Update optional libraries.
+
2004-11-10 Adrian Aichner <adrian(a)xemacs.org>
* index.content: Update list of available InstallShield releases.
1.38 +14 -28 XEmacs/xemacsweb/Download/win32/index.content
(In the diff below, changes in quantity of whitespace are not shown.)
Index: index.content
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacsweb/Download/win32/index.content,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -b -r1.37 -r1.38
--- index.content 2004/11/10 22:11:58 1.37
+++ index.content 2005/01/31 03:51:48 1.38
＠＠ -153,35 +153,21 ＠＠
<h2>Various Binaries and Libraries</h2>
<p>
- Below you can find binaries of useful programs and libraries for
- use with XEmacs on Windows 9x/NT. Most of these are
- self-extracting executables. Please report back whether the
- binaries provided here work for you, if you decide to use
- them.</p>
+ The file <a href="optional-libs.exe">optional-libs.exe</a> contains
+ binaries for common graphics libraries needed for building XEmacs and for
+ zlib, needed to support the PNG library. This isa self-extracting
+ executable, which will install pre-built binaries for all of the optional
+ graphics libraries needed by XEmacs, in the correct hierarchy as expected
+ by XEmacs. Then just set the <tt>OPTIONAL_LIBRARY_DIR</tt> parameter to
+ the appropriate directory in which you installed the libraries (by
+ default, <tt>c:\src</tt>).</p>
- <dl>
- <dt>cvs-1.10.exe</dt>
- <dd>
- CVS binaries. CVS is the source-code control system used to
- maintain the XEmacs sources. See
- http://www.xemacs.org/Develop/cvsaccess.html for info on using
- CVS.</dd>
- <dt><a href="ssh-1.2.14.exe">ssh-1.2.14.exe</a></dt>
- <dd>SSH binaries. SSH is the "Secure SHell", an RSH
- replacement that provides strong encryption and is required if you get
- write privileges to the XEmacs tree. (You do NOT need this if you just
- want read-only access to the sources.)</dd>
- <dt><a href="png-1.0.3.exe">png-1.0.3.exe</a></dt>
- <dd>PNG libraries. A requirement for building XEmacs.</dd>
- <dt><a href="zlib-1.1.3.exe">zlib-1.1.3.exe</a></dt>
- <dd>ZLIB libraries. Required along with PNG.</dd>
- <dt><a href="xpm-3.4k.exe">xpm-3.4k.exe</a></dt>
- <dd>XPM libraries. A requirement for building XEmacs.</dd>
- <dt><a href="jpeg-6b.exe">jpeg-6b.exe</a></dt>
- <dd>JPEG libraries. Optional for building XEmacs.</dd>
- <dt><a href="patch.2.5.exe.win32.gz">patch.2.5.exe.win32.gz</a></dt>
- <dd>The PATCH program, for applying diffs.</dd>
- </dl>
+ <p>
+ We no longer provide binaries for CVS, SSH or patch. If you want these,
+ just install <a href="http://www.cygwin.com">Cygwin</a>, which provides
+ versions of these and all other common Unix utilities, has an easy
+ install program, and is frequently updated.
+ </p>
<!-- Keep this comment at the end of the file
Local variables:
1.1 XEmacs/xemacsweb/Download/win32/optional-libs.exe
<<Binary file>>
- 1 participants
- 0 comments