574c352
				GAP for Fedora
574c352
      Based on "GAP for Debian" by Bill Allombert <ballombe@debian.org>
574c352
574c352
574c352
GAP (http://www.gap-system.org) is a system for computational discrete
574c352
algebra.  Many add-on components ("packages") are available for GAP.  Most of
574c352
them not yet available from Fedora.  However, they can be installed locally in
574c352
any of the following locations:
574c352
  - /usr/local/share/gap/pkg
574c352
  - /usr/local/lib/gap/pkg
574c352
  - ~/gap/pkg
574c352
574c352
Some packages must be compiled.  The necessary tools are available in the
574c352
gap-devel package.
574c352
574c352
Saved Workspaces, or How to make GAP start faster
574c352
-------------------------------------------------
574c352
574c352
GAP starts slowly because it needs to parse all the libraries installed at
574c352
start up.  To make GAP start faster, it is possible to save the GAP workspace
574c352
and reload it at the next start up.  To support this, Fedora provides a
574c352
Debian-derived script, update-gap-workspace; see the the
574c352
update-gap-workspace(1) manual page.
574c352
574c352
Colors in the GAP shell
574c352
-----------------------
574c352
574c352
If you would like the GAP shell to display the prompt, input, etc. in color,
574c352
you can try colorprompt.g by Frank L├╝beck.  Add this line to ~/.gaprc:
574c352
574c352
ColorPrompt(true);
574c352
Jerry James b72b287
See /usr/lib/gap/lib/colorprompt.g for more information.
574c352
574c352
Browsing GAP Documentation
574c352
--------------------------
574c352
574c352
By default, GAP will display documentation in a terminal.  Other options are
574c352
available.  Insert one of the following into ~/.gaprc:
574c352
574c352
SetHelpViewer("firefox");   # Displays HTML documentation in Firefox
574c352
SetHelpViewer("konqueror"); # Displays HTML documentation in Konqueror
574c352
SetHelpViewer("lynx");      # Displays HTML documentation in Lynx
574c352
SetHelpViewer("w3m");       # Displays HTML documentation in w3m
574c352
SetHelpViewer("xdvi");      # Displays DVI documentation in xdvi
574c352
SetHelpViewer("xpdf");      # Displays PDF documentation in xpdf
574c352
SetHelpViewer("xdghtml");   # Displays HTML documentation using xdg-open
574c352
SetHelpViewer("xdgdvi");    # Displays DVI documentation using xdg-open
574c352
SetHelpViewer("xdgpdf");    # Displays PDF documentation using xdg-open
574c352
574c352
The last three are Fedora extensions.  They use xdg-open to open the
574c352
documentation files with the user's preferred applications.
574c352
574c352
Large GAP libraries are compressed
574c352
----------------------------------
574c352
574c352
To save disk space, the largest GAP libraries are compressed with gzip.  GAP
574c352
automatically decompresses them.
574c352
574c352
Supporting GAP
574c352
--------------
574c352
574c352
If you use GAP, please send a short note to support@gap-system.org stating you
574c352
use the Fedora packages of GAP so the GAP team can keep track of the number of
574c352
GAP users.  This helps them obtain funding for the project.