Mercurial > hg > xemacs-beta
view nt/README @ 5353:38e24b8be4ea
Improve the lexical scoping in #'block, #'return-from.
lisp/ChangeLog addition:
2011-02-07 Aidan Kehoe <kehoea@parhasard.net>
* bytecomp.el:
* bytecomp.el (byte-compile-initial-macro-environment):
Shadow `block', `return-from' here, we implement them differently
when byte-compiling.
* bytecomp.el (byte-compile-active-blocks): New.
* bytecomp.el (byte-compile-block-1): New.
* bytecomp.el (byte-compile-return-from-1): New.
* bytecomp.el (return-from-1): New.
* bytecomp.el (block-1): New.
These are two aliases that exist to have their own associated
byte-compile functions, which functions implement `block' and
`return-from'.
* cl-extra.el (cl-macroexpand-all):
Fix a bug here when macros in the environment have been compiled.
* cl-macs.el (block):
* cl-macs.el (return):
* cl-macs.el (return-from):
Be more careful about lexical scope in these macros.
* cl.el:
* cl.el ('cl-block-wrapper): Removed.
* cl.el ('cl-block-throw): Removed.
These aren't needed in code generated by this XEmacs. They
shouldn't be needed in code generated by XEmacs 21.4, but if it
turns out the packages do need them, we can put them back.
2011-01-30 Mike Sperber <mike@xemacs.org>
* font-lock.el (font-lock-fontify-pending-extents): Don't fail if
`font-lock-mode' is unset, which can happen in the middle of
`revert-buffer'.
2011-01-23 Aidan Kehoe <kehoea@parhasard.net>
* cl-macs.el (delete):
* cl-macs.el (delq):
* cl-macs.el (remove):
* cl-macs.el (remq):
Don't use the compiler macro if these functions were given the
wrong number of arguments, as happens in lisp-tests.el.
* cl-seq.el (remove, remq): Removed.
I added these to subr.el, and forgot to remove them from here.
2011-01-22 Aidan Kehoe <kehoea@parhasard.net>
* bytecomp.el (byte-compile-setq, byte-compile-set):
Remove kludge allowing keywords' values to be set, all the code
that does that is gone.
* cl-compat.el (elt-satisfies-test-p):
* faces.el (set-face-parent):
* faces.el (face-doc-string):
* gtk-font-menu.el:
* gtk-font-menu.el (gtk-reset-device-font-menus):
* msw-font-menu.el:
* msw-font-menu.el (mswindows-reset-device-font-menus):
* package-get.el (package-get-installedp):
* select.el (select-convert-from-image-data):
* sound.el:
* sound.el (load-sound-file):
* x-font-menu.el (x-reset-device-font-menus-core):
Don't quote keywords, they're self-quoting, and the
win from backward-compatibility is sufficiently small now that the
style problem overrides it.
2011-01-22 Aidan Kehoe <kehoea@parhasard.net>
* cl-macs.el (block, return-from): Require that NAME be a symbol
in these macros, as always documented in the #'block docstring and
as required by Common Lisp.
* descr-text.el (unidata-initialize-unihan-database):
Correct the use of non-symbols in #'block and #'return-from in
this function.
2011-01-15 Aidan Kehoe <kehoea@parhasard.net>
* cl-extra.el (concatenate): Accept more complicated TYPEs in this
function, handing the sequences over to #'coerce if we don't
understand them here.
* cl-macs.el (inline): Don't proclaim #'concatenate as inline, its
compiler macro is more useful than doing that.
2011-01-11 Aidan Kehoe <kehoea@parhasard.net>
* subr.el (delete, delq, remove, remq): Move #'remove, #'remq
here, they don't belong in cl-seq.el; move #'delete, #'delq here
from fns.c, implement them in terms of #'delete*, allowing support
for sequences generally.
* update-elc.el (do-autoload-commands): Use #'delete*, not #'delq
here, now the latter's no longer dumped.
* cl-macs.el (delete, delq): Add compiler macros transforming
#'delete and #'delq to #'delete* calls.
2011-01-10 Aidan Kehoe <kehoea@parhasard.net>
* dialog.el (make-dialog-box): Correct a misplaced parenthesis
here, thank you Mats Lidell in 87zkr9gqrh.fsf@mail.contactor.se !
2011-01-02 Aidan Kehoe <kehoea@parhasard.net>
* dialog.el (make-dialog-box):
* list-mode.el (display-completion-list):
These functions used to use cl-parsing-keywords; change them to
use defun* instead, fixing the build. (Not sure what led to me
not including this change in d1b17a33450b!)
2011-01-02 Aidan Kehoe <kehoea@parhasard.net>
* cl-macs.el (define-star-compiler-macros):
Make sure the form has ITEM and LIST specified before attempting
to change to calls with explicit tests; necessary for some tests
in lisp-tests.el to compile correctly.
(stable-union, stable-intersection): Add compiler macros for these
functions, in the same way we do for most of the other functions
in cl-seq.el.
2011-01-01 Aidan Kehoe <kehoea@parhasard.net>
* cl-macs.el (dolist, dotimes, do-symbols, macrolet)
(symbol-macrolet):
Define these macros with defmacro* instead of parsing the argument
list by hand, for the sake of style and readability; use backquote
where appropriate, instead of calling #'list and and friends, for
the same reason.
2010-12-30 Aidan Kehoe <kehoea@parhasard.net>
* x-misc.el (device-x-display):
Provide this function, documented in the Lispref for years, but
not existing previously. Thank you Julian Bradfield, thank you
Jeff Mincy.
2010-12-30 Aidan Kehoe <kehoea@parhasard.net>
* cl-seq.el:
Move the heavy lifting from this file to C. Dump the
cl-parsing-keywords macro, but don't use defun* for the functions
we define that do take keywords, dynamic scope lossage makes that
not practical.
* subr.el (sort, fillarray): Move these aliases here.
(map-plist): #'nsublis is now built-in, but at this point #'eql
isn't necessarily available as a test; use #'eq.
* obsolete.el (cl-delete-duplicates): Make this available for old
compiler macros and old code.
(memql): Document that this is equivalent to #'member*, and worse.
* cl.el (adjoin, subst): Removed. These are in C.
2010-12-30 Aidan Kehoe <kehoea@parhasard.net>
* simple.el (assoc-ignore-case): Remove a duplicate definition of
this function (it's already in subr.el).
* iso8859-1.el (char-width):
On non-Mule, make this function equivalent to that produced by
(constantly 1), but preserve its docstring.
* subr.el (subst-char-in-string): Define this in terms of
#'substitute, #'nsubstitute.
(string-width): Define this using #'reduce and #'char-width.
(char-width): Give this a simpler definition, it makes far more
sense to check for mule at load time and redefine, as we do in
iso8859-1.el.
(store-substring): Implement this in terms of #'replace, now
#'replace is cheap.
2010-12-30 Aidan Kehoe <kehoea@parhasard.net>
* update-elc.el (lisp-files-needed-for-byte-compilation)
(lisp-files-needing-early-byte-compilation):
cl-macs belongs in the former, not the latter, it is as
fundamental as bytecomp.el.
2010-12-30 Aidan Kehoe <kehoea@parhasard.net>
* cl.el:
Provde the Common Lisp program-error, type-error as error
symbols. This doesn't nearly go far enough for anyone using the
Common Lisp errors.
2010-12-29 Aidan Kehoe <kehoea@parhasard.net>
* cl-macs.el (delete-duplicates):
If the form has an incorrect number of arguments, don't attempt a
compiler macroexpansion.
2010-12-29 Aidan Kehoe <kehoea@parhasard.net>
* cl-macs.el (cl-safe-expr-p):
Forms that start with the symbol lambda are also safe.
2010-12-29 Aidan Kehoe <kehoea@parhasard.net>
* cl-macs.el (= < > <= >=):
For these functions' compiler macros, the optimisation is safe
even if the first and the last arguments have side effects, since
they're only used the once.
2010-12-29 Aidan Kehoe <kehoea@parhasard.net>
* cl-macs.el (inline-side-effect-free-compiler-macros):
Unroll a loop here at macro-expansion time, so these compiler
macros are compiled. Use #'eql instead of #'eq in a couple of
places for better style.
2010-12-29 Aidan Kehoe <kehoea@parhasard.net>
* cl-extra.el (notany, notevery): Avoid some dynamic scope
stupidity with local variable names in these functions, when they
weren't prefixed with cl-; go into some more detail in the doc
strings.
2010-12-29 Aidan Kehoe <kehoea@parhasard.net>
* byte-optimize.el (side-effect-free-fns): #'remove, #'remq are
free of side-effects.
(side-effect-and-error-free-fns):
Drop dot, dot-marker from the list.
2010-11-17 Aidan Kehoe <kehoea@parhasard.net>
* cl-extra.el (coerce):
In the argument list, name the first argument OBJECT, not X; the
former name was always used in the doc string and is clearer.
Handle vector type specifications which include the length of the
target sequence, error if there's a mismatch.
* cl-macs.el (cl-make-type-test): Handle type specifications
starting with the symbol 'eql.
2010-11-14 Aidan Kehoe <kehoea@parhasard.net>
* cl-macs.el (eql): Don't remove the byte-compile property of this
symbol. That was necessary to override a bug in bytecomp.el where
#'eql was confused with #'eq, which bug we no longer have.
If neither expression is constant, don't attempt to handle the
expression in this compiler macro, leave it to byte-compile-eql,
which produces better code anyway.
* bytecomp.el (eq): #'eql is not the function associated with the
byte-eq byte code.
(byte-compile-eql): Add an explicit compile method for this
function, for cases where the cl-macs compiler macro hasn't
reduced it to #'eq or #'equal.
2010-10-25 Aidan Kehoe <kehoea@parhasard.net>
Add compiler macros and compilation sanity-checking for various
functions that take keywords.
* byte-optimize.el (side-effect-free-fns): #'symbol-value is
side-effect free and not error free.
* bytecomp.el (byte-compile-normal-call): Check keyword argument
lists for sanity; store information about the positions where
keyword arguments start using the new byte-compile-keyword-start
property.
* cl-macs.el (cl-const-expr-val): Take a new optional argument,
cl-not-constant, defaulting to nil, in this function; return it if
the expression is not constant.
(cl-non-fixnum-number-p): Make this into a separate function, we
want to pass it to #'every.
(eql): Use it.
(define-star-compiler-macros): Use the same code to generate the
member*, assoc* and rassoc* compiler macros; special-case some
code in #'add-to-list in subr.el.
(remove, remq): Add compiler macros for these two functions, in
preparation for #'remove being in C.
(define-foo-if-compiler-macros): Transform (remove-if-not ...) calls to
(remove ... :if-not) at compile time, which will be a real win
once the latter is in C.
(define-substitute-if-compiler-macros)
(define-subst-if-compiler-macros): Similarly for these functions.
(delete-duplicates): Change this compiler macro to use
#'plists-equal; if we don't have information about the type of
SEQUENCE at compile time, don't bother attempting to inline the
call, the function will be in C soon enough.
(equalp): Remove an old commented-out compiler macro for this, if
we want to see it it's in version control.
(subst-char-in-string): Transform this to a call to nsubstitute or
nsubstitute, if that is appropriate.
* cl.el (ldiff): Don't call setf here, this makes for a load-time
dependency problem in cl-macs.el
2010-06-14 Stephen J. Turnbull <stephen@xemacs.org>
* term/vt100.el:
Refer to XEmacs, not GNU Emacs, in permissions.
* term/bg-mouse.el:
* term/sup-mouse.el:
Put copyright notice in canonical "Copyright DATE AUTHOR" form.
Refer to XEmacs, not GNU Emacs, in permissions.
* site-load.el:
Add permission boilerplate.
* mule/canna-leim.el:
* alist.el:
Refer to XEmacs, not APEL/this program, in permissions.
* mule/canna-leim.el:
Remove my copyright, I've assigned it to the FSF.
2010-06-14 Stephen J. Turnbull <stephen@xemacs.org>
* gtk.el:
* gtk-widget-accessors.el:
* gtk-package.el:
* gtk-marshal.el:
* gtk-compose.el:
* gnome.el:
Add copyright notice based on internal evidence.
2010-06-14 Stephen J. Turnbull <stephen@xemacs.org>
* easymenu.el: Add reference to COPYING to permission notice.
* gutter.el:
* gutter-items.el:
* menubar-items.el:
Fix typo "Xmacs" in permissions notice.
2010-06-14 Stephen J. Turnbull <stephen@xemacs.org>
* auto-save.el:
* font.el:
* fontconfig.el:
* mule/kinsoku.el:
Add "part of XEmacs" text to permission notice.
2010-10-14 Aidan Kehoe <kehoea@parhasard.net>
* byte-optimize.el (side-effect-free-fns):
* cl-macs.el (remf, getf):
* cl-extra.el (tailp, cl-set-getf, cl-do-remf):
* cl.el (ldiff, endp):
Tighten up Common Lisp compatibility for #'ldiff, #'endp, #'tailp;
add circularity checking for the first two.
#'cl-set-getf and #'cl-do-remf were Lisp implementations of
#'plist-put and #'plist-remprop; change the names to aliases,
changes the macros that use them to using #'plist-put and
#'plist-remprop directly.
2010-10-12 Aidan Kehoe <kehoea@parhasard.net>
* abbrev.el (fundamental-mode-abbrev-table, global-abbrev-table):
Create both these abbrev tables using the usual
#'define-abbrev-table calls, rather than attempting to
special-case them.
* cl-extra.el: Force cl-macs to be loaded here, if cl-extra.el is
being loaded interpreted. Previously other, later files would
redundantly call (load "cl-macs") when interpreted, it's more
reasonable to do it here, once.
* cmdloop.el (read-quoted-char-radix): Use defcustom here, we
don't have any dump-order dependencies that would prevent that.
* custom.el (eval-when-compile): Don't load cl-macs when
interpreted or when byte-compiling, rely on cl-extra.el in the
former case and the appropriate entry in bytecomp-load-hook in the
latter. Get rid of custom-declare-variable-list, we have no
dump-time dependencies that would require it.
* faces.el (eval-when-compile): Don't load cl-macs when
interpreted or when byte-compiling.
* packages.el: Remove some inaccurate comments.
* post-gc.el (cleanup-simple-finalizers): Use #'delete-if-not
here, now the order of preloaded-file-list has been changed to
make it available.
* subr.el (custom-declare-variable-list): Remove. No need for it.
Also remove a stub define-abbrev-table from this file, given the
current order of preloaded-file-list there's no need for it.
2010-10-10 Aidan Kehoe <kehoea@parhasard.net>
* bytecomp.el (byte-compile-constp) Forms quoted with FUNCTION are
also constant.
(byte-compile-initial-macro-environment): In #'the, if FORM is
constant and does not match TYPE, warn at byte-compile time.
2010-10-10 Aidan Kehoe <kehoea@parhasard.net>
* backquote.el (bq-vector-contents, bq-list*): Remove; the former
is equivalent to (append VECTOR nil), the latter to (list* ...).
(bq-process-2): Use (append VECTOR nil) instead of using
#'bq-vector-contents to convert to a list.
(bq-process-1): Now we use list* instead of bq-list
* subr.el (list*): Moved from cl.el, since it is now required to
be available the first time a backquoted form is encountered.
* cl.el (list*): Move to subr.el.
2010-09-16 Aidan Kehoe <kehoea@parhasard.net>
* test-harness.el (Check-Message):
Add an omitted comma here, thank you the buildbot.
2010-09-16 Aidan Kehoe <kehoea@parhasard.net>
* hash-table.el (hash-table-key-list, hash-table-value-list)
(hash-table-key-value-alist, hash-table-key-value-plist):
Remove some useless #'nreverse calls in these files; our hash
tables have no order, it's not helpful to pretend they do.
* behavior.el (read-behavior):
Do the same in this file, in some code evidently copied from
hash-table.el.
2010-09-16 Aidan Kehoe <kehoea@parhasard.net>
* info.el (Info-insert-dir):
* format.el (format-deannotate-region):
* files.el (cd, save-buffers-kill-emacs):
Use #'some, #'every and related functions for applying boolean
operations to lists, instead of rolling our own ones that cons and
don't short-circuit.
2010-09-16 Aidan Kehoe <kehoea@parhasard.net>
* bytecomp.el (byte-compile-initial-macro-environment):
* cl-macs.el (the):
Rephrase the docstring, make its implementation when compiling
files a little nicer.
2010-09-16 Aidan Kehoe <kehoea@parhasard.net>
* descr-text.el (unidata-initialize-unicodedata-database)
(unidata-initialize-unihan-database, describe-char-unicode-data)
(describe-char-unicode-data):
Wrap calls to the database functions with (with-fboundp ...),
avoiding byte compile warnings on builds without support for the
database functions.
(describe-char): (reduce #'max ...), not (apply #'max ...), no
need to cons needlessly.
(describe-char): Remove a redundant lambda wrapping
#'extent-properties.
(describe-char-unicode-data): Call #'nsubst when replacing "" with
nil in the result of #'split-string, instead of consing inside
mapcar.
2010-09-16 Aidan Kehoe <kehoea@parhasard.net>
* x-faces.el (x-available-font-sizes):
* specifier.el (let-specifier):
* package-ui.el (pui-add-required-packages):
* msw-faces.el (mswindows-available-font-sizes):
* modeline.el (modeline-minor-mode-menu):
* minibuf.el (minibuf-directory-files):
Replace the O2N (delq nil (mapcar (lambda (W) (and X Y)) Z)) with
the ON (mapcan (lambda (W) (and X (list Y))) Z) in these files.
2010-09-16 Aidan Kehoe <kehoea@parhasard.net>
* cl-macs.el (= < > <= >=):
When these functions are handed more than two arguments, and those
arguments have no side effects, transform to a series of two
argument calls, avoiding funcall in the byte-compiled code.
* mule/mule-cmds.el (finish-set-language-environment):
Take advantage of this change in a function called 256 times at
startup.
2010-09-16 Aidan Kehoe <kehoea@parhasard.net>
* bytecomp.el (byte-compile-function-form, byte-compile-quote)
(byte-compile-quote-form):
Warn at compile time, and error at runtime, if a (quote ...) or a
(function ...) form attempts to quote more than one object.
2010-09-16 Aidan Kehoe <kehoea@parhasard.net>
* byte-optimize.el (byte-optimize-apply): Transform (apply 'nconc
(mapcar ...)) to (mapcan ...); warn about use of the first idiom.
* update-elc.el (do-autoload-commands):
* packages.el (packages-find-package-library-path):
* frame.el (frame-list):
* extents.el (extent-descendants):
* etags.el (buffer-tag-table-files):
* dumped-lisp.el (preloaded-file-list):
* device.el (device-list):
* bytecomp-runtime.el (proclaim-inline, proclaim-notinline)
Use #'mapcan, not (apply #'nconc (mapcar ...) in all these files.
* bytecomp-runtime.el (eval-when-compile, eval-and-compile):
In passing, mention that these macros also evaluate the body when
interpreted.
tests/ChangeLog addition:
2011-02-07 Aidan Kehoe <kehoea@parhasard.net>
* automated/lisp-tests.el:
Test lexical scope for `block', `return-from'; add a
Known-Bug-Expect-Failure for a contorted example that fails when
byte-compiled.
| author | Aidan Kehoe <kehoea@parhasard.net> |
|---|---|
| date | Mon, 07 Feb 2011 12:01:24 +0000 (2011-02-07) |
| parents | 1cecc3e9f0a0 |
| children | 98681721a588 |
line wrap: on
line source
Building and Installing XEmacs on Windows 95/98/NT/2000/XP -*- mode:outline -*- Ben Wing based on old version by David Hobley Marc Paquette Jonathan Harris This is a port of XEmacs to Windows 95/98/ME/NT/2000/XP. If you are looking for a port of GNU Emacs, get the latest release of the 21.x series from gnu.org. NT 4.0 or later is required for building on Windows NT. Note that the developers typically use NT 4.0 and Windows 2000 or XP, and there may possibly be problems under Windows 95/98. (One developer has successfully built on Windows ME, though, which is the successor of Windows 98.) If so, please report them to xemacs-nt@xemacs.org; we are committed to maintaining compatibility with all systems listed. * Required tools and sources ============================ 1. You will need Visual C++ V6.0, Visual Studio .NET or later to compile everything. Note that Visual C++ assumes that the environment variables INCLUDE and LIB are set to specify the location of the includes and libraries. Your PATH environment variable also needs to include the Visual Studio vc\bin and sharedide\bin directories. Visual C++ V6.0 installs a batch file called vcvars32.bat in c:\Program Files\Microsoft Visual Studio\VC98\bin\ (or wherever you installed it) that you can run before building to set up all of these environment variables. Alternatively, you can choose at setup time to have these environment variables automatically set up in the registry, which is generally a good idea. Visual Studio .NET calls this batch file vsvars32.bat and installs it in $Installdir\Common7\Tools, but doesn't offer at install time to automatically set these environment variables up in the registry. 2. Grab the latest XEmacs source from http://ftp.xemacs.org/pub/xemacs/ or one of its mirrors listed at http://www.xemacs.org/Download/index.html. (NOTE: If you are behind a firewall and have problems with FTP access, the URL http://ftp.xemacs.org/pub/xemacs/ works just as well.) You'll also need the packages. You probably want to get the unified packages bundle from http://ftp.xemacs.org/pub/xemacs/packages/xemacs-sumo.tar.gz If you are building with international support, you also need http://ftp.xemacs.org/pub/xemacs/packages/xemacs-mule-sumo.tar.gz Although we don't recommend it, you can also retrieve just the packages you really need if you have an extremely slow net connection or are very short on disk space. You can find the various packages in http://ftp.xemacs.org/pub/xemacs/packages/. You will need the xemacs-base package (and mule-base, if building with international support). You'll also need the texinfo package unless you have a copy of makeinfo.exe on your machine. If you want to download additional or updated packages from within XEmacs you'll need the efs, dired and vm packages. You'll probably also want at least the edit-utils, text-modes, fsf-compat, cc-mode, prog-modes and xemacs-devel packages. Unpack the packages into "x:\your\choice\XEmacs\xemacs-packages", for example "c:\Program Files\XEmacs\xemacs-packages". 3. The native build no longer supports X Windows. There is no point, since the Cygwin build is actively maintained and supports X Windows very well. See the FAQ if you want to build with Cygwin. * Optional libraries ==================== The easiest way to get the optional libraries is to grab the appropriate set of precompiled versions for your compiler: http://www.xemacs.org/Download/win32/optional-libs.exe or for VC++ 2005 (VC8) http://www.xemacs.org/Download/win32/optional-libs-vc8.exe unpack them somewhere and set the OPTIONAL_LIBRARY_DIR in config.inc to point to where you put them. This will automatically give you all the graphics libraries. (NOTE: optional-libs.exe was compiled with VC++ .NET and may or may not work with VC++ 6.0. If not, you will have to build them yourself until we provide VC6 binaries.) * Alternative: Building the optional libraries yourself ======================================================= If you need to build the libraries yourself, grab them from http://ftp.xemacs.org/pub/xemacs/aux or get the latest version from the home page of the appropriate library, as listed on http://www.xemacs.org/Download/optLibs.html. The following instructions assume that you have the appropriate libraries and have unpacked them somewhere, e.g. c:\src. Directions for building the various libraries: 1. You really want the XPM library. Copy nt\xpm.mak from the xemacs sources to the lib/ subdirectory of the XPM sources, cd to that directory and build xpm with 'nmake -f xpm.mak'. 2. You probably also want PNG image support. Get PNG and ZLIB and read the respective READMEs for details on how to build them. cd to the ZLIB source directory and type 'nmake -f win32\Makefile.msc'. cd to the libpng source directory, rename or move the zlib directory to ..\zlib and type 'nmake -f scripts\makefile.vcawin32'. 3. If you want TIFF support, cd to the TIFF source directory and type 'nmake -f Makefile.vc'. 4. If you want JPEG support, cd to the JPEG source directory and type 'nmake -f makefile.vc'. 5. If you want X-Face support, copy nt\compface.mak from the xemacs sources to the compface directory, cd to that directory and build libcompface with 'nmake -f compface.mak'. 6. It's also possible to build the Sleepycat DB libraries. Open up the file DB-SOURCE-DIR\docs\ref\build_win\intro.html in a browser, where DB-SOURCE-DIR is the top-level source directory for the Sleepcat DB libraries, and follow the directions. You should build the `Release_static' target if you want to use the static version of this library, or the `Release' target if you want to use the DLL version of the library. To use the DLL version, you need to set BUILD_DATABASE_SHARED to 1 in config.inc. The DLL version will make the executable much smaller, but you will have to have the DLL present at run-time -- either in the same directory as the XEmacs executable or somewhere in your path. 7. It's possible, but difficult, to build shared libraries for GNU MP. (Static libraries are not yet possible, as there is no makefile.vc for this; you can't build static libraries for VC++ using MinGW.) Basically, you need to build using MinGW and then generate native import libraries. This is more or less described in the documentation, but the following procedure seems to work: -- In the top level of the GMP sources, configure using CC='gcc -mno-cygwin' configure --build=pentium3-pc-mingw32 --disable-static --enable-shared -- Edit the `libtool' script in the same directory and change the value of CC from `gcc' to `gcc -mno-cygwin'. -- Run `make'. -- Run these commands: lib /machine:IX86 /def:.libs/libgmp-3.dll-def cp .libs/libgmp-3.dll-exp libgmp-3.exp cp .libs/libgmp-3.dll . -- You should now have an import library named libgmp-3.lib and a DLL libgmp-3.dll. -- NOTE: You will need to have this DLL accessible when XEmacs runs. It either needs to be in the same directory as the XEmacs executable or in your path. 8. There are also pre-built binaries for GMP-4.1.2 at http://www.cs.nyu.edu/exact/core/gmp/. However, they don't seem to work properly for our purposes, as they require LIBC.LIB rather than MSVCRT.DLL. 9. You can build the client library for PostgreSQL by cd'ing to the src/ subdirectory of the PostgreSQL sources and running `nmake -f win32.mak'. 10. It does not appear to be very easy to build OpenLDAP under native MS Windows, as it is only experimentally supported. However, there is a mailing list for this, which contains postings of recent binaries and build patches; see http://lucas.bergmans.us/hacks/openldap/ If you know how to build OpenLDAP, please write up a description of the process and send it to us at xemacs-beta@xemacs.org. * Building ========== 1. cd to the nt subdirectory of the xemacs distribution and copy the file config.inc.samp to config.inc. Make any necessary modifications. This file controls the options that XEmacs is built with: -- If you want international (aka "Mule") support, modify the appropriate line in config.inc as follows: MULE=1 -- If you're using the pre-supplied optional library pack, all you should have to do is set OPTIONAL_LIBRARY_DIR to the top-level directory where you unpacked everything. -- By default, support is enabled for all graphics formats, but not currently for any of the other libraries in the optional library pack. If you want support for GMP, Berkeley DB or PostgreSQL, set the appropriate flag (HAVE_BIGNUM, HAVE_DATABASE or HAVE_POSTGRESQL, respectively) to 1. We do not currently enable these by default because of lack of sufficient testing, questionable usefulness in the case of Berkeley DB and PostgreSQL, excessive library size in the case of Berkeley DB (more than 2 MB for the static library!), and lack of a static library in the case of GMP. -- If you want to turn off support for any of the graphics libraries, set the appropriate flag (HAVE_XPM, HAVE_GIF, HAVE_PNG, HAVE_JPEG, HAVE_TIFF or HAVE_XFACE) to 0. -- If you have compiled some of the libraries yourself, you will have to specify the location of the top-level source directory for each of these libraries. XEmacs assumes that the directory structure under these directories is as it is in the sources, rather than in any installed format. For example, for XPM support, modify the appropriate lines in config.inc as follows: HAVE_XPM=1 XPM_DIR="x:\location\of\your\xpm\sources" Similarly for JPEG, TIFF, etc. support. For PNG support, you also need to specify ZLIB_DIR. If you want to use the DLL version of the Sleepycat DB library, set BUILD_DATABASE_SHARED to 1. You will have to have the DLL present at run-time -- either in the same directory as the XEmacs executable or somewhere in your path. -- By default, XEmacs will expect to find its packages in the subdirectories "site-packages", "mule-packages" and "xemacs-packages" under the directory "c:\Program Files\XEmacs". If you want it to look for these subdirectories elsewhere, modify the appropriate lines in config.inc as follows: PACKAGE_PREFIX="x:\your\package\directory" Make sure that the directory pointed to by PACKAGE_PREFIX contains the xemacs-packages directory into which you installed the packages. -- XEmacs can build its info files more quickly if you have a copy of the makeinfo program. If you have a copy, modify the appropriate lines in config.inc as follows: MAKEINFO="x:\location\of\makeinfo.exe" If you don't have a copy of makeinfo then you'll need to have installed the XEmacs texinfo package. 2. If you want to install XEmacs when you build it, modify the appropriate lines in config.inc as follows (you can also run XEmacs from its build directory): INSTALL_DIR="x:\your\installation\directory" (By default, XEmacs will be installed in directories under the directory "c:\Program Files\XEmacs\XEmacs-21.5".) 3. If you want the built files to go into a different tree than the source tree (e.g. this allows you to build multiple versions of XEmacs, with different configuration settings, from the same source tree), use the script `make-build-dir' to create a skeleton build tree, create a config.inc in that tree, and then run nmake from that tree. This is similar to running `configure --srcdir=PATH' under Unix. See the comments in `config.inc.samp' for more information. 4. If you want to build xemacs on the command line, use `nmake install -f xemacs.mak', or just `nmake -f xemacs.mak' if you want to run XEmacs from its build directory. nmake will build temacs, the DOC file, update the elc's, dump xemacs and (optionally) install the relevant files in the directories under the installation directory. If you chose to install XEmacs, the file that you should run to start XEmacs will be installed (by default) as "c:\Program Files\XEmacs\XEmacs-21.5\i586-pc-win32\xemacs.exe". To run from the build directory, run the file "src\xemacs.exe" off of the root of the build directory. You may want to create a shortcut to the file from your Desktop or Start Menu. 5. To build using MS Visual Studio, you can use the workspace file `nt/xemacs.dsw'. This was prepared for Visual C++ 6.0. If you are using Visual Studio .NET, open this file up inside of it and it will offer to convert it to a .NET "solution" file. The same procedure should work for newer versions of Visual Studio (e.g. Visual Studio 2005). If this doesn't work (e.g. you are using Visual C++ 5 or even earlier), just open up `nt/xemacs.mak' from within Visual Studio and it will offer to wrap this Makefile in a workspace file, from which you can build. Assuming you want to run from the build directory (which you will want to do if you are planning on doing any development work on XEmacs), use the following settings (for Visual C++ 6.0, at least) in Project/Settings...: Under the General tab: Build command line: NMAKE /f xemacs.mak Output file name: ..\src\xemacs.exe Browse info file name: ..\src\temacs.bsc Under the Debug tab: Executable for debug session: ..\src\xemacs.exe If you want to install XEmacs when it's built, change the build command line to "NMAKE install /f xemacs.mak". (You will have to make the same change even if you use the provided workspace nt/xemacs.dsw.) * Debugging under MS Developer Studio ===================================== The build process always creates debugging and "Source Browser" information in the source tree for use with DevStudio. However that information is not very useful unless you build a debug version of XEmacs: 1. Set DEBUG_XEMACS=1 and DEPEND=1 in config.inc and rebuild. 2. See instructions above for obtaining a workspace file for use with MS Developer Studio. Build and debug your XEmacs this way. 3. To display the contents of a lisp variable, type Shift-F9 (or use the menu) to bring up the QuickWatch window, type dp(variable) and click Recalculate. The output will appear in a console window, as well as in the Debug window in MS Developer Studio. 4. To display a current Lisp backtrace, type db() in the QuickWatch window, as in the previous item. 5. To view Lisp variables in the "Watch" window wrap the variable in one of the helper functions from the file src\console-msw.c, for example type DSTRING(variable) in the "Watch" window to inspect a Lisp string. 6. For further information on debugging XEmacs, see the item `How to Debug an XEmacs problem with a debugger' in the XEmacs FAQ. * Known Problems ================ Please look at the PROBLEMS file for known problems. Any other problems you need clarified, please email us and we will endeavour to provide any assistance we can: The XEmacs NT Mailing List: xemacs-nt@xemacs.org Subscribe address: xemacs-nt-request@xemacs.org Ben Wing (current primary MS Windows maintainer; author of the MS Windows Mule code and some of the dialog box code) Andy Piper (MS Windows contributor; author of the Cygwin support and the MS Windows glyph and widget code) Jonathan Harris (MS Windows contributor; original author of the MS Windows redisplay and underlying GUI code) Kirill Katsnelson (MS Windows contributor; author of the MS Windows process and printing code and some of the dialog box code; general guru on obscure MS Windows programming topics) David Hobley (early MS Windows contributor) Marc Paquette (early MS Windows contributor) August Hill (early MS Windows contributor) and others.