.TH "GAP" "1" "@VERSION@" "GAP" "User Commands"

.SH "NAME"

gap \- Run the Groups, Algorithms and Programming system

.SH "SYNOPSIS"

.B gap

[\fIOPTIONS\fP] [\fIFILES\fP]

.SH "DESCRIPTION"

.PP

GAP is a system for computational discrete algebra, with particular emphasis

on Computational Group Theory.  GAP provides a programming language, a library

of thousands of functions implementing algebraic algorithms written in the GAP

language as well as large data libraries of algebraic objects.  GAP is used in

research and teaching for studying groups and their representations, rings,

vector spaces, algebras, combinatorial structures, and more.

.SH "OPTIONS"

Boolean options (b, e, p, q, r, A, D, M, N, O, T, X, and Y) toggle the current

value each time they are used.  Default actions are indicated first.

.PP

MEM options indicate a number of bytes.  Larger units are indicated with

trailing characters: 'k' for kilobytes, m for megabytes, and g for gigabytes.

For example, '512k' means 512 kilobytes.

.TP

\fB\-a\fP \fIMEM\fP

Set the amount of preallocated space.

.TP

\fB\-b\fP

Disable/enable the banner.

.TP

\fB\-c\fP \fIMEM\fP

Set the cache size.

.TP

\fB\-e\fP

Disable/enable quitting on Ctrl-D.

.TP

\fB\-f\fP

Force line editing.

.TP

\fB\-g\fP

Show GASMAN messages.  If this option is given once, then full garbage

collections are shown.  If it is given twice, all garbage collections are

shown.

.TP

\fB\-h\fP

Print a help message and exit.

.TP

\fB\-i\fP \fIFILE\fP

Load an alternate init file.

.TP

\fB\-l\fP \fIPATHS\fP

Set the GAP root paths.  A leading semicolon means to append PATHS to the

existing list of root paths.  A trailing semicolon means to prepend PATHS.

Otherwise, the list of root paths is replaced with PATHS.

.TP

\fB\-m\fP \fIMEM\fP

Set the initial workspace size.

.TP

\fB\-n\fP

Prevent line editing.

.TP

\fB\-o\fP \fIMEM\fP

Set the hint for the maximal workspace size.  GAP may allocate more.

.TP

\fB\-p\fP

Enable/disable emitting extra commands to the output to tell a window handler

what GAP is doing.

.TP

\fB\-q\fP

Enable/disable quiet mode.

.TP

\fB\-r\fP

Disable/enable reading of the .gaprc file.

.TP

\fB\-x\fP \fINUM\fP

Set the window width to NUM columns.

.TP

\fB\-y\fP \fINUM\fP

Set the window height to NUM rows.

.TP

\fB\-A\fP

Disable/enable autoloading of GAP packages.

.TP

\fB\-B\fP \fINAME\fP

Set the name of the current architecture.

.TP

\fB\-C\fP \fI<output>\fP \fI<input>\fP \fI<name>\fP

Compile an input file with the given name into an output file.

.TP

\fB\-D\fP

Enable/disable debugging the loading of library files.

.TP

\fB\-K\fP \fIMEM\fP

Set the maximal workspace size.  GAP never allocates more.

.TP

\fB\-L\fP \fIFILE\fP

Restore a saved workspace.

.TP

\fB\-M\fP

Disable/enable loading of compiled modules.

.TP

\fB\-N\fP

Disable/enable check for completion files.

.TP

\fB\-O\fP

Enable/disable compatibility with GAP 3, by causing false and fail to be the

same value.

.TP

\fB\-R\fP

Prevent restoring of workspace (causes -L to be ignored).

.TP

\fB\-T\fP

Disable/enable break loop.

.TP

\fB\-U\fP \fIOPTIONS\fP

Set the compile options for compiling GAP files.

.TP

\fB\-X\fP

Enable/disable CRC while reading completion.

.TP

\fB\-Y\fP

Enable/disable CRC while completing files.

.SH "SEE ALSO"

.PP

\fIgac\fP(1), \fIupdate-gap-workspace\fP(1)