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