Mercurial > hg > xemacs-beta

comparison INSTALL @ 5118:e0db3c197671 ben-lisp-object

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
merge up to latest default branch, doesn't compile yet
author Ben Wing <ben@xemacs.org>
date Sat, 26 Dec 2009 21:18:49 -0600
parents bc4f2511bbea
children 1d775c6304d1
comparison
equal deleted inserted replaced
5117:3742ea8250b5 5118:e0db3c197671
1 XEmacs Installation Guide 1 XEmacs Installation Guide
2 2
3 Copyright (c) 1994, 1995, 1996 Board of Trustees, University of Illinois 3 Copyright (c) 1994, 1995, 1996 Board of Trustees, University of Illinois
4 Copyright (c) 1994-1999, 2003 Free Software Foundation, Inc. 4 Copyright (c) 1994-1999, 2003, 2008 Free Software Foundation, Inc.
5 5
6 Permission is granted to anyone to make or distribute verbatim copies 6 Permission is granted to anyone to make or distribute verbatim copies
7 of this document as received, in any medium, provided that the 7 of this document as received, in any medium, provided that the
8 copyright notice and permission notice are preserved, 8 copyright notice and permission notice are preserved,
9 and that the distributor grants the recipient permission 9 and that the distributor grants the recipient permission
59 installation, upgrade, and removal of applications written in Lisp. 59 installation, upgrade, and removal of applications written in Lisp.
60 60
61 PACKAGE SYSTEM 61 PACKAGE SYSTEM
62 ============== 62 ==============
63 63
64 The file README.packages contain information vital to have a fully 64 The FAQ sections 1.7 and 2.1 contain information vital to have a fully
65 working XEmacs. It includes a description of available packages, and 65 working XEmacs. It includes a description of available packages, and
66 how to bootstrap XEmacs from a minimal or a complete set of packages. 66 how to bootstrap XEmacs from a minimal or a complete set of packages.
67 This information was not included in this file only because it is too 67 This information was not included in this file only because it is too
68 large for this terse INSTALL. Please read README.packages now! 68 large for this terse INSTALL. The FAQ is available in Texinfo format
69 in man/xemacs-faq.texi, as an Info file once you build XEmacs, and
70 online at http://www.xemacs.org/Documentation/21.5/html/xemacs-faq_1.html.
69 71
70 ADD-ON LIBRARIES 72 ADD-ON LIBRARIES
71 ================ 73 ================
72 74
73 Decide which libraries you would like to use with XEmacs, but are not 75 Decide which libraries you would like to use with XEmacs, but are not
287 289
288 If you don't want X Window System support, specify `--without-x'. If 290 If you don't want X Window System support, specify `--without-x'. If
289 you omit this option, `configure' will try to autodetect whether your 291 you omit this option, `configure' will try to autodetect whether your
290 system has X Window System support, and arrange to use it if present. 292 system has X Window System support, and arrange to use it if present.
291 293
292 The `--without-xmu' option can be used if your vendor doesn't ship
293 the Xmu library.
294
295 The `--with-menubars=TYPE' option allows you to specify which X 294 The `--with-menubars=TYPE' option allows you to specify which X
296 toolkit you wish to use for the menubar. The valid options are 295 toolkit you wish to use for the menubar. The valid options are
297 `lucid', `motif' and `no'. The default is `lucid' which is a 296 `lucid', `motif' and `no'. The default is `lucid' which is a
298 Motif-lookalike menubar. We highly recommend its usage over the real 297 Motif-lookalike menubar. We highly recommend its usage over the real
299 Motif menubar. (In fact, the Motif menubar is currently broken.) If 298 Motif menubar. (In fact, the Motif menubar is currently broken.) If
377 etc/PACKAGES) installed prior to building XEmacs. 376 etc/PACKAGES) installed prior to building XEmacs.
378 377
379 The `--with-cde' option allows you to enable or disable CDE drag and 378 The `--with-cde' option allows you to enable or disable CDE drag and
380 drop support. `configure' will attempt to detect this option and 379 drop support. `configure' will attempt to detect this option and
381 define `--with-cde' for you. 380 define `--with-cde' for you.
382
383 The `--with-offix' option allows you to enable or disable OffiX drag
384 and drop support. This requires no external library support, so if
385 X11 support is available, then this option defaults to `yes'. OffiX
386 support can be explicitly disabled via the `--with-offix=no' option.
387 381
388 Internationalization Options 382 Internationalization Options
389 ---------------------------- 383 ----------------------------
390 384
391 The `--with-mule' option enables MUlti-Lingual Emacs (Mule) support, 385 The `--with-mule' option enables MUlti-Lingual Emacs (Mule) support,
569 permanent locations, with `make install'. By default, XEmacs's files 563 permanent locations, with `make install'. By default, XEmacs's files
570 are installed in the following directories: 564 are installed in the following directories:
571 565
572 `/usr/local/bin' holds the executable programs users normally run - 566 `/usr/local/bin' holds the executable programs users normally run -
573 `xemacs', `etags', `ctags', `b2m', `emacsclient', `ellcc', 567 `xemacs', `etags', `ctags', `b2m', `emacsclient', `ellcc',
574 `gnuclient', `gnudoit', `gnuattach', and `rcs-checkin'. 568 `gnuclient', `gnudoit', and `gnuattach'.
575 569
576 `/usr/local/lib/xemacs-VERSION/lisp' holds the Emacs Lisp libraries; 570 `/usr/local/lib/xemacs-VERSION/lisp' holds the Emacs Lisp libraries;
577 `VERSION' stands for the number of the XEmacs version 571 `VERSION' stands for the number of the XEmacs version
578 you are installing, like `18.59' or `19.14'. Since 572 you are installing, like `18.59' or `19.14'. Since
579 the lisp libraries change from one version of XEmacs to 573 the lisp libraries change from one version of XEmacs to
585 XEmacs searches for its lisp files in these 579 XEmacs searches for its lisp files in these
586 directories, and then in 580 directories, and then in
587 `/usr/local/lib/xemacs/site-lisp/*'. 581 `/usr/local/lib/xemacs/site-lisp/*'.
588 582
589 `/usr/local/lib/xemacs-VERSION/etc' holds the XEmacs tutorial, the 583 `/usr/local/lib/xemacs-VERSION/etc' holds the XEmacs tutorial, the
590 `yow' database, and other architecture-independent 584 Unicode database, and other architecture-independent
591 files XEmacs might need while running. VERSION is as 585 files XEmacs might need while running. VERSION is as
592 specified for `.../lisp'. 586 specified for `.../lisp'.
593 587
594 `/usr/local/lib/xemacs/lock' contains files indicating who is 588 `/usr/local/lib/xemacs/lock' contains files indicating who is
595 editing what, so XEmacs can detect editing clashes 589 editing what, so XEmacs can detect editing clashes
792 You are done with the hard part! You can remove executables and 786 You are done with the hard part! You can remove executables and
793 object files from the build directory by typing `make clean'. To also 787 object files from the build directory by typing `make clean'. To also
794 remove the files that `configure' created (so you can compile XEmacs 788 remove the files that `configure' created (so you can compile XEmacs
795 for a different configuration), type `make distclean'. 789 for a different configuration), type `make distclean'.
796 790
797 READ README.packages 791 READ THE FAQ
798 ==================== 792 ============
799 793
800 Do it! 794 Do it!
801 795
802 PROBLEMS 796 PROBLEMS
803 ======== 797 ========
804 798
805 The most common problem is that you forgot to read and follow the 799 The most common problem is that you forgot to read and follow the
806 directions in README.packages. You can not have a normal XEmacs 800 directions for installing bootstrap packages in the FAQ. You can not
807 without downloading some additional packages. 801 have a normal XEmacs without downloading some additional packages.
808 802
809 See the file PROBLEMS in this directory for a list of various problems 803 See the file PROBLEMS in this directory for a list of various problems
810 sometimes encountered, and what to do about them. PROBLEMS is also 804 sometimes encountered, and what to do about them. PROBLEMS is also
811 the place where platform-specific build notes can be found. 805 the place where platform-specific build notes can be found.
812 806
873 Run-time path-searching options: 867 Run-time path-searching options:
874 -------------------------------- 868 --------------------------------
875 869
876 --with-site-lisp Unchanged 870 --with-site-lisp Unchanged
877 --with-site-modules Unchanged 871 --with-site-modules Unchanged
878 --package-prefix --with-package-prefix
879 --package-path --with-package-path 872 --package-path --with-package-path
880 --infopath --with-infopath 873 --infopath --with-infopath
881 874
882 Window-system options: 875 Window-system options:
883 ---------------------- 876 ----------------------
895 --with-scrollbars Unchanged 888 --with-scrollbars Unchanged
896 --with-dialogs Unchanged 889 --with-dialogs Unchanged
897 --with-widgets Unchanged 890 --with-widgets Unchanged
898 --with-dragndrop Unchanged 891 --with-dragndrop Unchanged
899 --with-cde Unchanged 892 --with-cde Unchanged
900 --with-offix Unchanged
901 --with-xmu Unchanged 893 --with-xmu Unchanged
902 --external-widget --with-external-widget 894 --external-widget --with-external-widget
903 895
904 TTY (character terminal) options: 896 TTY (character terminal) options:
905 --------------------------------- 897 ---------------------------------