Mercurial > hg > xemacs-beta

comparison INSTALL @ 5150:0353d546dc1e

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Reflect change from `lib' to `share' in INSTALL. 2010-03-18 Mike Sperber <mike@xemacs.org> * INSTALL: Reflect change from `lib' to `share'; also, document how to invoke configure to get the old setting.
author Mike Sperber <sperber@deinprogramm.de>
date Thu, 18 Mar 2010 13:45:34 +0100
parents 1d775c6304d1
children 3889ef128488
comparison
equal deleted inserted replaced
5149:b72f27a08ed5 5150:0353d546dc1e
255 255
256 The `--prefix=PREFIXDIR' option specifies where the installation process 256 The `--prefix=PREFIXDIR' option specifies where the installation process
257 should put XEmacs and its data files. This defaults to `/usr/local'. 257 should put XEmacs and its data files. This defaults to `/usr/local'.
258 - XEmacs (and the other utilities users run) go in PREFIXDIR/bin 258 - XEmacs (and the other utilities users run) go in PREFIXDIR/bin
259 (unless the `--exec-prefix' option says otherwise). 259 (unless the `--exec-prefix' option says otherwise).
260 - The architecture-independent files go in PREFIXDIR/lib/xemacs-VERSION 260 - The architecture-independent files go in PREFIXDIR/share/xemacs-VERSION
261 (where VERSION is the version number of XEmacs, like `21.0'). 261 (where VERSION is the version number of XEmacs, like `21.0').
262 - The architecture-dependent files go in 262 - The architecture-dependent files go in
263 PREFIXDIR/lib/xemacs-VERSION/CONFIGURATION-NAME 263 PREFIXDIR/lib/xemacs-VERSION/CONFIGURATION-NAME
264 (where CONFIGURATION-NAME is the host type, like mips-dec-ultrix4.2), 264 (where CONFIGURATION-NAME is the host type, like mips-dec-ultrix4.2),
265 unless the `--exec-prefix' option says otherwise. 265 unless the `--exec-prefix' option says otherwise.
281 installation around (as whole) at will. This is true for binary kits, 281 installation around (as whole) at will. This is true for binary kits,
282 for instance. Therefore, you can specify --without-prefix on the 282 for instance. Therefore, you can specify --without-prefix on the
283 configure command line to prevent the installation prefix to become 283 configure command line to prevent the installation prefix to become
284 part of the generated executable; everything else will continue to 284 part of the generated executable; everything else will continue to
285 work as usual. 285 work as usual.
286
287 Unlike previous versions of XEmacs (21.4 or earlier),
288 architecture-independent files (in particular, the Lisp files and
289 package hierarchies) by default get installed under `/usr/local/share'
290 rather than `/usr/local/lib'. To create a setup as in previous
291 versions, use the `--datadir=/usr/local/lib' option to configure.
286 292
287 Configuring Feature Support 293 Configuring Feature Support
288 --------------------------- 294 ---------------------------
289 295
290 If you don't want X Window System support, specify `--without-x'. If 296 If you don't want X Window System support, specify `--without-x'. If
565 571
566 `/usr/local/bin' holds the executable programs users normally run - 572 `/usr/local/bin' holds the executable programs users normally run -
567 `xemacs', `etags', `ctags', `b2m', `emacsclient', `ellcc', 573 `xemacs', `etags', `ctags', `b2m', `emacsclient', `ellcc',
568 `gnuclient', `gnudoit', and `gnuattach'. 574 `gnuclient', `gnudoit', and `gnuattach'.
569 575
570 `/usr/local/lib/xemacs-VERSION/lisp' holds the Emacs Lisp libraries; 576 `/usr/local/share/xemacs-VERSION/lisp' holds the Emacs Lisp libraries;
571 `VERSION' stands for the number of the XEmacs version 577 `VERSION' stands for the number of the XEmacs version
572 you are installing, like `18.59' or `19.14'. Since 578 you are installing, like `18.59' or `19.14'. Since
573 the lisp libraries change from one version of XEmacs to 579 the lisp libraries change from one version of XEmacs to
574 another, including the version number in the path 580 another, including the version number in the path
575 allows you to have several versions of XEmacs installed 581 allows you to have several versions of XEmacs installed
576 at the same time; this means that you don't have to 582 at the same time; this means that you don't have to
577 make XEmacs unavailable while installing a new version. 583 make XEmacs unavailable while installing a new version.
578 584
579 XEmacs searches for its lisp files in these 585 XEmacs searches for its lisp files in these
580 directories, and then in 586 directories, and then in
581 `/usr/local/lib/xemacs/site-lisp/*'. 587 `/usr/local/share/xemacs/site-lisp/*'.
582 588
583 `/usr/local/lib/xemacs-VERSION/etc' holds the XEmacs tutorial, the 589 `/usr/local/share/xemacs-VERSION/etc' holds the XEmacs tutorial, the
584 Unicode database, and other architecture-independent 590 Unicode database, and other architecture-independent
585 files XEmacs might need while running. VERSION is as 591 files XEmacs might need while running. VERSION is as
586 specified for `.../lisp'. 592 specified for `.../lisp'.
587 593
588 `/usr/local/lib/xemacs/lock' contains files indicating who is 594 `/usr/local/share/xemacs/lock' contains files indicating who is
589 editing what, so XEmacs can detect editing clashes 595 editing what, so XEmacs can detect editing clashes
590 between users. 596 between users.
591 597
592 `/usr/local/lib/xemacs-VERSION/CONFIGURATION-NAME' contains executable 598 `/usr/local/lib/xemacs-VERSION/CONFIGURATION-NAME' contains executable
593 programs used by XEmacs that users are not expected to 599 programs used by XEmacs that users are not expected to
612 618
613 XEmacs searches for modules in this directory, or any 619 XEmacs searches for modules in this directory, or any
614 sub-directory of it, and then in 620 sub-directory of it, and then in
615 `/usr/local/lib/xemacs/site-modules/*'. 621 `/usr/local/lib/xemacs/site-modules/*'.
616 622
617 `/usr/local/lib/xemacs-VERSION/info' holds the on-line documentation 623 `/usr/local/share/xemacs-VERSION/info' holds the on-line documentation
618 for XEmacs, known as "info files". 624 for XEmacs, known as "info files".
619 625
620 `/usr/local/man/man1' holds the man pages for the programs installed 626 `/usr/local/man/man1' holds the man pages for the programs installed
621 in `/usr/local/bin'. 627 in `/usr/local/bin'.
622 628
640 `bindir' indicates where to put executable programs that users can 646 `bindir' indicates where to put executable programs that users can
641 run. This defaults to /usr/local/bin. 647 run. This defaults to /usr/local/bin.
642 648
643 `datadir' indicates where to put the architecture-independent 649 `datadir' indicates where to put the architecture-independent
644 read-only data files that XEmacs refers to while it runs; it 650 read-only data files that XEmacs refers to while it runs; it
645 defaults to /usr/local/lib. We create the following 651 defaults to /usr/local/data. We create the following
646 subdirectories under `datadir': 652 subdirectories under `datadir':
647 - `xemacs-VERSION/lisp', containing the XEmacs lisp libraries, and 653 - `xemacs-VERSION/lisp', containing the XEmacs lisp libraries, and
648 654
649 - `xemacs-VERSION/etc', containing the XEmacs tutorial and the 655 - `xemacs-VERSION/etc', containing the XEmacs tutorial and the
650 `yow' database. 656 `yow' database.
652 like `18.59' or `19.14'. Since these files vary from one version 658 like `18.59' or `19.14'. Since these files vary from one version
653 of XEmacs to another, including the version number in the path 659 of XEmacs to another, including the version number in the path
654 allows you to have several versions of XEmacs installed at the 660 allows you to have several versions of XEmacs installed at the
655 same time; this means that you don't have to make XEmacs 661 same time; this means that you don't have to make XEmacs
656 unavailable while installing a new version. 662 unavailable while installing a new version.
663
664 `datarootdir' indicates where to put the documentation. (Usually,
665 this is identical to `datadir'---in the default configuration
666 `datadir' is set to the value of `datarootdir'.)
667 Specifically, the man pages are put in the `man' subdirectory
668 of `datarootdir', and the info pages are put in the
669 `xemacs/info' subdirectory.
657 670
658 `statedir' indicates where to put architecture-independent data files 671 `statedir' indicates where to put architecture-independent data files
659 that XEmacs modifies while it runs; it defaults to 672 that XEmacs modifies while it runs; it defaults to
660 /usr/local/lib as well. We create the following 673 /usr/local/lib as well. We create the following
661 subdirectories under `statedir': 674 subdirectories under `statedir':
678 systems installed at the same time; this is useful for sites 691 systems installed at the same time; this is useful for sites
679 at which different kinds of machines share the file system 692 at which different kinds of machines share the file system
680 XEmacs is installed on. 693 XEmacs is installed on.
681 694
682 `infodir' indicates where to put the info files distributed with 695 `infodir' indicates where to put the info files distributed with
683 XEmacs; it defaults to `/usr/local/lib/xemacs-VERSION/info'. 696 XEmacs; it defaults to `/usr/local/share/xemacs-VERSION/info'.
684 697
685 `mandir' indicates where to put the man pages for XEmacs and its 698 `mandir' indicates where to put the man pages for XEmacs and its
686 utilities (like `etags'); it defaults to 699 utilities (like `etags'); it defaults to
687 `/usr/local/man/man1'. 700 `/usr/local/man/man1'.
688 701
708 The above variables serve analogous purposes in the makefiles for all 721 The above variables serve analogous purposes in the makefiles for all
709 GNU software; here are some variables specific to XEmacs. 722 GNU software; here are some variables specific to XEmacs.
710 723
711 `lispdir' indicates where XEmacs installs and expects its lisp 724 `lispdir' indicates where XEmacs installs and expects its lisp
712 libraries. Its default value, based on `datadir' (see above), 725 libraries. Its default value, based on `datadir' (see above),
713 is `/usr/local/lib/xemacs-VERSION/lisp' (where `VERSION' is as 726 is `/usr/local/share/xemacs-VERSION/lisp' (where `VERSION' is as
714 described above). 727 described above).
715 728
716 `sitelispdir' indicates where XEmacs should search for lisp libraries 729 `sitelispdir' indicates where XEmacs should search for lisp libraries
717 specific to your site. XEmacs checks them in order before 730 specific to your site. XEmacs checks them in order before
718 checking `lispdir'. Its default value, based on `datadir' 731 checking `lispdir'. Its default value, based on `datadir'
719 (see above), is `/usr/local/lib/xemacs/site-lisp'. 732 (see above), is `/usr/local/share/xemacs/site-lisp'.
720 733
721 `etcdir' indicates where XEmacs should install and expect the rest of 734 `etcdir' indicates where XEmacs should install and expect the rest of
722 its architecture-independent data, like the tutorial and yow 735 its architecture-independent data, like the tutorial and yow
723 database. Its default value, based on `datadir' 736 database. Its default value, based on `datadir'
724 (see above), is `/usr/local/lib/xemacs-VERSION/etc' (where 737 (see above), is `/usr/local/share/xemacs-VERSION/etc' (where
725 `VERSION' is as described above). 738 `VERSION' is as described above).
726 739
727 `lockdir' indicates the directory where XEmacs keeps track of its 740 `lockdir' indicates the directory where XEmacs keeps track of its
728 locking information. Its default value, based on `statedir' 741 locking information. Its default value, based on `statedir'
729 (see above), is `/usr/local/lib/xemacs/lock'. 742 (see above), is `/usr/local/share/xemacs/lock'.
730 743
731 `archlibdir' indicates where XEmacs installs and expects the 744 `archlibdir' indicates where XEmacs installs and expects the
732 executable files and other architecture-dependent data it uses 745 executable files and other architecture-dependent data it uses
733 while running. Its default value, based on `libdir' (see 746 while running. Its default value, based on `libdir' (see
734 above), is `/usr/local/lib/xemacs-VERSION/CONFIGURATION-NAME' 747 above), is `/usr/local/lib/xemacs-VERSION/CONFIGURATION-NAME'