There are two main flavors of packages.
@itemize @bullet
-@item Regular Packages
+@item
+Regular Packages
@cindex regular packages
A regular package is one in which multiple files are involved and one
may not in general safely remove any of them.
-@item Single-File Packages
+@item
+Single-File Packages
@cindex single-file packages
A single-file package is an aggregate collection of thematically
related but otherwise independent lisp files. These files are bundled
Packages".
@enumerate 1
-@item Choose a download site.
+@item
+Choose a download site.
via menu: Options -> Manages Packages -> Add Download Site
via keyb: @code{M-x customize-variable RET package-get-remote RET}
(put in the details of remote host and directory)
If the package tarballs _AND_ the package-index file are in a
local directory, you can: @code{M-x pui-add-install-directory RET}
-@item Obtain a list of packages and display the list in a buffer named
+@item
+Obtain a list of packages and display the list in a buffer named
@file{*Packages*}.
menu: Options -> Manage Packages -> List & Install
keyb: @code{M-x pui-list-packages RET}
about the package to be displayed in the minibuffer.
-@item Choose the packages you wish to install.
+@item
+Choose the packages you wish to install.
mouse: Click button 2 on the package name.
keyb: @kbd{RET} on the package name
-@item Make sure you have everything you need.
+@item
+Make sure you have everything you need.
menu: Packages -> Add Required
keyb: @kbd{r}
For novices and gurus alike, this step can save your bacon.
It's easy to forget to install a critical package.
-@item Download and install the packages.
+@item
+Download and install the packages.
menu: Packages -> Install/Remove Selected
keyb: @kbd{x}
@end enumerate
No need to panic, you don't have to go through the
@file{pkinfo/MANIFEST.pkgname} and manually delete the files. Instead, use
-@code{M-x package-admin-delete-binary-package RET}.
+@code{M-x package-get-delete-package RET}.
Note that the interactive package tools included with XEmacs already do
this for you.
This is where you set the normal packages that you
want to install. eg:
@example
- XEMACS_PACKAGES = libs/xemacs-base comm/bbdb
+ XEMACS_PACKAGES = xemacs-packages/xemacs-base xemacs-packages/bbdb
@end example
@item XEMACS_STAGING = $@{XEMACS_PACKAGES_BASE@}/../Packages
Same as for 'XEMACS_PACKAGES' except you list the Mule
packages you want to install here. eg:
@example
- MULE_PACKAGES = mule/mule-base mule/skk
+ MULE_PACKAGES = mule-packages/mule-base mule-packages/skk
@end example
@item MULE_STAGING = $@{XEMACS_PACKAGES_BASE@}/../Mule-Packages
@code{AUTHOR_VERSION}, @code{MAINTAINER}, @code{PACKAGE},
@code{PKG_TYPE}, @code{REQUIRES}, and @code{CATEGORY}. All but one were
described in the description of @file{package-info.in}. The last is an
-administrative grouping. Current categories include @code{comm},
-@code{games}, @code{libs}, @code{mule}, @code{oa}, @code{os},
-@code{prog}, and @code{wp}. @ref{Available Packages}, for a list of
-categories.
+administrative grouping. Current categories include @code{standard},
+and @code{mule}.
Next, define the variable @code{ELCS}. This contains the list of the
byte-compiled Lisp files used by the package. These files and their
looking for isn't here, please send a message to the
@email{xemacs-beta@@xemacs.org, XEmacs Beta list}.
-This data is up-to-date as of January 17, 2001.
+This data is up-to-date as of May 15, 2001.
-@subsection Library Packages (libs)
-
-These packages are required to build and support most of the rest of
-XEmacs. By design, xemacs-base is a `regular' package. Use restraint
-when adding new files there as it is required by almost everything.
+@subsection Normal Packages
+A very broad selection of elisp packages.
@table @file
@item Sun
Support for Sparcworks.
+@item ada
+Ada language support.
+
@item apel
A Portable Emacs Library. Used by XEmacs MIME support.
-@item dired
-The DIRectory EDitor is for manipulating, and running commands on
-files in a directory.
+@item auctex
+Basic TeX/LaTeX support.
-@item edebug
-A Lisp debugger.
+@item bbdb
+The Big Brother Data Base
-@item efs
-Treat files on remote systems the same as local files.
+@item build
+Build XEmacs using custom widgets.
-@item elib
-Portable Emacs Lisp utilities library.
+@item c-support
+Basic single-file add-ons for editing C code.
-@item fsf-compat
-FSF Emacs compatibility files.
+@item calc
+Emacs calculator.
-@item mail-lib
-Fundamental lisp files for providing email support.
+@item calendar
+Calendar and diary support.
-@item sounds-au
-XEmacs Sun sound files.
+@item cc-mode
+C, C++ and Java language support.
-@item sounds-wav
-XEmacs Microsoft sound files.
+@item cookie
+Spook and Yow (Zippy quotes).
-@item tooltalk
-Support for building with Tooltalk.
+@item crisp
+Crisp/Brief emulation.
-@item xemacs-base
-Fundamental XEmacs support. Install this unless you wish a totally
-naked XEmacs.
+@item debug
+GUD, gdb, dbx debugging support.
-@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.
-@end table
+@item dired
+The DIRectory EDitor is for manipulating, and running commands on
+files in a directory.
-@subsection Communications Packages (comm)
+@item edebug
+A Lisp debugger.
-These packages provide support for various communications, primarily
-email and usenet.
+@item ediff
+Interface over patch.
-@table @file
-@item bbdb
-The Big Brother Data Base
+@item edit-utils
+Single file lisp packages for various XEmacs goodies. Load this and
+weed out the junk you don't want.
+
+@item edt
+DEC EDIT/EDT emulation.
+
+@item efs
+Treat files on remote systems the same as local files.
@item eicq
ICQ Client developed and tested on Linux x86;
only supported on that platform
+@item eieio
+Enhanced Implementation of Emacs Interpreted Objects.
+
+@item elib
+Portable Emacs Lisp utilities library.
+
+@item emerge
+Another interface over patch.
+
+@item eshell
+Command shell implemented entirely in Emacs Lisp.
+
+@item eterm
+Terminal emulator.
+
@item eudc
Emacs Unified Directory Client (LDAP, PH).
@item footnote
Footnoting in mail message editing modes.
-@item gnats
-XEmacs bug reports.
+@item forms
+Forms editing support (obsolete, use the built-in Widget instead).
-@item gnus
-The Gnus Newsreader and Mailreader.
+@item frame-icon
+Provide a WM icon based on major mode.
-@item mailcrypt
-Support for messaging encryption with PGP.
+@item fsf-compat
+FSF Emacs compatibility files.
-@item mew
-Messaging in an Emacs World.
+@item games
+Tetris, Sokoban, and Snake.
-@item mh-e
-Front end support for MH.
+@item gnats
+XEmacs bug reports.
-@item net-utils
-Miscellaneous Networking Utilities. This is a single-file package and
-files may be deleted at will.
+@item gnus
+The Gnus Newsreader and Mailreader.
-@item rmail
-An obsolete Emacs mailer. If you do not already use it don't start.
+@item hm--html-menus
+HTML editing.
-@item supercite
-An Emacs citation tool. Useful with all Emacs Mailers and Newsreaders.
+@item idlwave
+Editing and Shell mode for the Interactive Data Language.
-@item tm
-Emacs MIME support. Not needed for Gnus >= 5.8.0
+@item igrep
+Enhanced front-end for Grep.
-@item vm
-An Emacs mailer.
+@item ilisp
+Front-end for Inferior Lisp.
-@item w3
-A Web browser.
+@item ispell
+Spell-checking with ispell.
-@item zenirc
-ZENIRC IRC Client.
-@end table
+@item jde
+Java language and development support.
-@subsection Games and Amusements (games)
+@item mail-lib
+Fundamental lisp files for providing email support.
-All work and no play...
+@item mailcrypt
+Support for messaging encryption with PGP.
-@table @file
-@item cookie
-Spook and Yow (Zippy quotes).
+@item mew
+Messaging in an Emacs World.
-@item games
-Tetris, Sokoban, and Snake.
+@item mh-e
+Front end support for MH.
@item mine
Minehunt.
@item misc-games
Other amusements and diversions.
-@end table
-
-@subsection Mule Support (mule)
-
-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.
-
-@table @file
-@item edict
-Lisp Interface to EDICT, Kanji Dictionary.
-
-@item egg-its
-Wnn (4.2 and 6) support. SJ3 support. Must be installed prior to
-XEmacs build.
-
-@item leim
-Quail. Used for everything other than English and Japanese.
-
-@item locale
-Used for localized menubars (French and Japanese) and localized splash
-screens (Japanese).
-
-@item lookup
-Dictionary support. (This isn't an English dictionary program)
-@item mule-base
-Basic Mule support. Must be installed prior to building with Mule.
-
-@item skk
-Another Japanese Language Input Method. Can be used without a
-separate process running as a dictionary server.
-@end table
+@item net-utils
+Miscellaneous Networking Utilities. This is a single-file package and
+files may be deleted at will.
-@subsection Productivity Packages (oa)
+@item os-utils
+Miscellaneous single-file O/S utilities, for printing, archiving,
+compression, remote shells, etc.
-Things to make life a little easier.
+@item pc
+PC style interface emulation.
-@table @file
-@item calc
-Emacs calculator.
+@item pcl-cvs
+CVS frontend.
-@item calendar
-Calendar and diary support.
+@item pcomplete
+Provides programmatic completion.
-@item edit-utils
-Single file lisp packages for various XEmacs goodies. Load this and
-weed out the junk you don't want.
+@item prog-modes
+Miscellaneous single-file lisp files for various programming languages.
-@item forms
-Forms editing support (obsolete, use the built-in Widget instead).
+@item ps-print-nomule
+Old, but no-Mule safe ps-print.
-@item frame-icon
-Provide a WM icon based on major mode.
+@item psgml
+Validated HTML/SGML editing.
-@item hm--html-menus
-HTML editing.
+@item reftex
+Emacs support for LaTeX cross-references, citations.
-@item ispell
-Spell-checking with ispell.
+@item rmail
+An obsolete Emacs mailer. If you do not already use it don't start.
-@item pc
-PC style interface emulation.
+@item scheme
+Front-end support for Inferior Scheme.
-@item psgml
-Validated HTML/SGML editing.
+@item semantic
+Semantic bovinator.
@item sgml
SGML/Linuxdoc-SGML editing.
+@item sh-script
+Support for editing shell scripts.
+
@item slider
User interface tool.
+@item sounds-au
+XEmacs Sun sound files.
+
+@item sounds-wav
+XEmacs Microsoft sound files.
+
@item speedbar
Provides a separate frame with convenient references.
@item strokes
Mouse enhancement utility.
+@item supercite
+An Emacs citation tool. Useful with all Emacs Mailers and Newsreaders.
+
+@item texinfo
+XEmacs TeXinfo support.
+
@item text-modes
Various single file lisp packages for editing text files.
+@item textools
+Single-file TeX support.
+
@item time
Display time & date on the modeline.
-@end table
-
-@subsection Operating System Utilities (os)
-
-Tools for working with the operating system.
-
-@table @file
-@item eshell
-Command shell implemented entirely in Emacs Lisp.
-@item eterm
-Terminal emulator.
+@item tm
+Emacs MIME support. Not needed for Gnus >= 5.8.0
-@item igrep
-Enhanced front-end for Grep.
+@item tooltalk
+Support for building with Tooltalk.
-@item ilisp
-Front-end for Inferior Lisp.
+@item tpu
+DEC EDIT/TPU support.
-@item os-utils
-Miscellaneous single-file O/S utilities, for printing, archiving,
-compression, remote shells, etc.
+@item vc
+Version Control for Free systems.
-@item pcomplete
-Provides programmatic completion.
+@item vc-cc
+Version Control for ClearCase. This package will shortly be
+replaced with clearcase.el
-@item ps-print-nomule
-Old, but no-Mule safe ps-print.
+@item vhdl
+Support for VHDL.
@item view-process
A Unix process browsing tool.
-@end table
-
-@subsection Program Editing Support (prog)
-
-XEmacs supports a multitude of programming languages. These
-packages will help your coding.
-
-@table @file
-@item ada
-Ada language support.
-@item c-support
-Basic single-file add-ons for editing C code.
-
-@item cc-mode
-C, C++ and Java language support.
-
-@item debug
-GUD, gdb, dbx debugging support.
-
-@item ediff
-Interface over patch.
-
-@item emerge
-Another interface over patch.
-
-@item idlwave
-Editing and Shell mode for the Interactive Data Language.
-
-@item jde
-Java language and development support.
-
-@item pcl-cvs
-CVS frontend.
+@item viper
+VI emulation support.
-@item prog-modes
-Miscellaneous single-file lisp files for various programming languages.
+@item vm
+An Emacs mailer.
-@item scheme
-Front-end support for Inferior Scheme.
+@item w3
+A Web browser.
-@item semantic
-Semantic bovinator.
+@item xemacs-base
+Fundamental XEmacs support. Install this unless you wish a totally
+naked XEmacs.
-@item sh-script
-Support for editing shell scripts.
+@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 vc
-Version Control for Free systems.
+@item xslt-process
+A minor mode for (X)Emacs which allows running an XSLT processor on a
+buffer.
-@item vc-cc
-Version Control for ClearCase. This package will shortly be
-replaced with clearcase.el
-
-@item vhdl
-Support for VHDL.
+@item zenirc
+ZENIRC IRC Client.
@end table
-@subsection Word Processing (wp)
+@subsection Mule Support (mule)
-Working with text.
+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.
@table @file
-@item auctex
-Basic TeX/LaTeX support.
-
-@item crisp
-Crisp/Brief emulation.
+@item edict
+Lisp Interface to EDICT, Kanji Dictionary.
-@item edt
-DEC EDIT/EDT emulation.
+@item egg-its
+Wnn (4.2 and 6) support. SJ3 support. Must be installed prior to
+XEmacs build.
-@item reftex
-Emacs support for LaTeX cross-references, citations.
+@item leim
+Quail. Used for everything other than English and Japanese.
-@item texinfo
-XEmacs TeXinfo support.
+@item locale
+Used for localized menubars (French and Japanese) and localized splash
+screens (Japanese).
-@item textools
-Single-file TeX support.
+@item lookup
+Dictionary support. (This isn't an English dictionary program)
-@item tpu
-DEC EDIT/TPU support.
+@item mule-base
+Basic Mule support. Must be installed prior to building with Mule.
-@item viper
-VI emulation support.
+@item skk
+Another Japanese Language Input Method. Can be used without a
+separate process running as a dictionary server.
@end table