574c35
.TH "GAP" "1" "@VERSION@" "GAP" "User Commands"
574c35
.SH "NAME"
574c35
gap \- Run the Groups, Algorithms and Programming system
574c35
.SH "SYNOPSIS"
574c35
.B gap
574c35
[\fIOPTIONS\fP] [\fIFILES\fP]
574c35
.SH "DESCRIPTION"
574c35
.PP
574c35
GAP is a system for computational discrete algebra, with particular emphasis
574c35
on Computational Group Theory.  GAP provides a programming language, a library
574c35
of thousands of functions implementing algebraic algorithms written in the GAP
574c35
language as well as large data libraries of algebraic objects.  GAP is used in
574c35
research and teaching for studying groups and their representations, rings,
574c35
vector spaces, algebras, combinatorial structures, and more.
574c35
.SH "OPTIONS"
574c35
Boolean options (b, e, p, q, r, A, D, M, N, O, T, X, and Y) toggle the current
574c35
value each time they are used.  Default actions are indicated first.
574c35
.PP
574c35
MEM options indicate a number of bytes.  Larger units are indicated with
574c35
trailing characters: 'k' for kilobytes, m for megabytes, and g for gigabytes.
574c35
For example, '512k' means 512 kilobytes.
574c35
.TP
574c35
\fB\-a\fP \fIMEM\fP
574c35
Set the amount of preallocated space.
574c35
.TP
574c35
\fB\-b\fP
574c35
Disable/enable the banner.
574c35
.TP
574c35
\fB\-c\fP \fIMEM\fP
574c35
Set the cache size.
574c35
.TP
574c35
\fB\-e\fP
574c35
Disable/enable quitting on Ctrl-D.
574c35
.TP
574c35
\fB\-f\fP
574c35
Force line editing.
574c35
.TP
574c35
\fB\-g\fP
574c35
Show GASMAN messages.  If this option is given once, then full garbage
574c35
collections are shown.  If it is given twice, all garbage collections are
574c35
shown.
574c35
.TP
574c35
\fB\-h\fP
574c35
Print a help message and exit.
574c35
.TP
574c35
\fB\-i\fP \fIFILE\fP
574c35
Load an alternate init file.
574c35
.TP
574c35
\fB\-l\fP \fIPATHS\fP
574c35
Set the GAP root paths.  A leading semicolon means to append PATHS to the
574c35
existing list of root paths.  A trailing semicolon means to prepend PATHS.
574c35
Otherwise, the list of root paths is replaced with PATHS.
574c35
.TP
574c35
\fB\-m\fP \fIMEM\fP
574c35
Set the initial workspace size.
574c35
.TP
574c35
\fB\-n\fP
574c35
Prevent line editing.
574c35
.TP
574c35
\fB\-o\fP \fIMEM\fP
574c35
Set the hint for the maximal workspace size.  GAP may allocate more.
574c35
.TP
574c35
\fB\-p\fP
574c35
Enable/disable emitting extra commands to the output to tell a window handler
574c35
what GAP is doing.
574c35
.TP
574c35
\fB\-q\fP
574c35
Enable/disable quiet mode.
574c35
.TP
574c35
\fB\-r\fP
574c35
Disable/enable reading of the .gaprc file.
574c35
.TP
574c35
\fB\-x\fP \fINUM\fP
574c35
Set the window width to NUM columns.
574c35
.TP
574c35
\fB\-y\fP \fINUM\fP
574c35
Set the window height to NUM rows.
574c35
.TP
574c35
\fB\-A\fP
574c35
Disable/enable autoloading of GAP packages.
574c35
.TP
574c35
\fB\-B\fP \fINAME\fP
574c35
Set the name of the current architecture.
574c35
.TP
574c35
\fB\-C\fP \fI<output>\fP \fI<input>\fP \fI<name>\fP
574c35
Compile an input file with the given name into an output file.
574c35
.TP
574c35
\fB\-D\fP
574c35
Enable/disable debugging the loading of library files.
574c35
.TP
574c35
\fB\-K\fP \fIMEM\fP
574c35
Set the maximal workspace size.  GAP never allocates more.
574c35
.TP
574c35
\fB\-L\fP \fIFILE\fP
574c35
Restore a saved workspace.
574c35
.TP
574c35
\fB\-M\fP
574c35
Disable/enable loading of compiled modules.
574c35
.TP
574c35
\fB\-N\fP
574c35
Disable/enable check for completion files.
574c35
.TP
574c35
\fB\-O\fP
574c35
Enable/disable compatibility with GAP 3, by causing false and fail to be the
574c35
same value.
574c35
.TP
574c35
\fB\-R\fP
574c35
Prevent restoring of workspace (causes -L to be ignored).
574c35
.TP
574c35
\fB\-T\fP
574c35
Disable/enable break loop.
574c35
.TP
574c35
\fB\-U\fP \fIOPTIONS\fP
574c35
Set the compile options for compiling GAP files.
574c35
.TP
574c35
\fB\-X\fP
574c35
Enable/disable CRC while reading completion.
574c35
.TP
574c35
\fB\-Y\fP
574c35
Enable/disable CRC while completing files.
574c35
.SH "SEE ALSO"
574c35
.PP
574c35
\fIgac\fP(1), \fIupdate-gap-workspace\fP(1)