.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH GAP "1" "April 2024" "The GAP team" "User Commands"
.SH NAME
GAP \- Groups, Algorithms and Programming
.SH SYNOPSIS
.B gap
[\fI\,OPTIONS\/\fR] [\fI\,FILES\/\fR]
.SH DESCRIPTION
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.
.SS "Startup:"
.TP
\fB\-h\fR, \fB\-\-help\fR
print this help and exit
.TP
\fB\-\-version\fR
print the GAP version and exit
.TP
\fB\-\-print\-gaproot\fR
print the primary GAP root and exit
.TP
\fB\-b\fR, \fB\-\-banner\fR
disable/enable the banner
.TP
\fB\-c\fR
<expr>    execute the expression <expr>
.TP
\fB\-\-systemfile\fR
<file>    read this file after 'lib/system.g'
.SS "Input/output:"
.TP
\fB\-q\fR, \fB\-\-quiet\fR
enable/disable quiet mode
.TP
\fB\-e\fR
disable/enable quitting on <ctrl>\-D
.TP
\fB\-f\fR
force line editing
.TP
\fB\-n\fR
prevent line editing
.TP
\fB\-E\fR, \fB\-\-readline\fR
disable/enable use of readline library (if
possible)
.TP
\fB\-x\fR, \fB\-\-width\fR
<num>     set line width
.TP
\fB\-y\fR, \fB\-\-lines\fR
<num>     set number of lines
.TP
\fB\-p\fR
enable/disable package output mode
(for use by XGAP and similar interfaces)
.SS "Memory:"
.IP
(may use postfix 'k' = *1024, 'm' = *1024*1024,
.IP
\&'g' = *1024*1024*1024):
.TP
\fB\-g\fR, \fB\-\-gasinfo\fR
show GASMAN messages (full/all/no garbage
collections)
(only available if GAP uses GASMAN)
.TP
\fB\-m\fR, \fB\-\-minworkspace\fR
<mem>     set the initial workspace size
.TP
\fB\-o\fR, \fB\-\-maxworkspace\fR
<mem>     set workspace size where GAP will warn about
excessive memory usage (GAP may allocate more)
(only available if GAP uses GASMAN)
.TP
\fB\-K\fR, \fB\-\-limitworkspace\fR <mem>
set maximal workspace size (GAP never
allocates more)
.TP
\fB\-s\fR
<mem>     set the initially mapped virtual memory
(only available if GAP uses GASMAN)
.SS "Roots:"
.TP
\fB\-l\fR, \fB\-\-roots\fR
<paths>   set or modify the GAP root paths
Directories are separated using ';'.
Putting ';' on the start/end of list appends
directories to the end/start of existing list
of root paths
.TP
\fB\-r\fR
disable/enable user GAP root dir
GAPInfo.UserGapRoot
.SS "Loading:"
.TP
\fB\-A\fR
disable/enable autoloading of suggested
GAP packages
.TP
\fB\-D\fR
enable/disable debugging the loading of files
.TP
\fB\-M\fR
disable/enable loading of compiled modules
.SS "Error handling, REPL:"
.TP
\fB\-T\fR, \fB\-\-nobreakloop\fR
disable/enable break loop and error traceback
.TP
\fB\-\-alwaystrace\fR
always print error traceback
(overrides behaviour of \fB\-T\fR)
.TP
\fB\-\-quitonbreak\fR
quit GAP with non\-zero return value instead
of entering break loop
.TP
\fB\-\-norepl\fR
Disable the GAP read\-evaluate\-print loop (REPL)
.TP
\fB\-\-nointeract\fR
Start GAP in non\-interactive mode (disable REPL
and break loop)
.SS "Workspaces:"
.IP
(only available if GAP uses GASMAN)
\fB\-L\fR                   <file>    restore a saved workspace
\fB\-R\fR                             prevent restoring of workspace (ignoring \fB\-L\fR)
.SS "Profiling:"
.TP
\fB\-\-prof\fR
<file>    Run ProfileLineByLine(<file>) on GAP start
.TP
\fB\-\-memprof\fR
<file>    Run ProfileLineByLine(<file>) on GAP start
with recordMem := true
.TP
\fB\-\-cover\fR
<file>    Run CoverageLineByLine(<file>) on GAP start
.PP
Internal developer tools
.TP
\fB\-N\fR
do not use hidden implications
.TP
\fB\-O\fR
disable/enable loading of obsolete files
.TP
\fB\-\-bare\fR
Attempt to start GAP without even needed
packages
.IP
Short boolean options toggle the current value each time they are called.
Default actions are indicated first.
.SH AUTHORS
The GAP Group <http://www.gap-system.org>
.SH COPYRIGHT
     Copyright (1988--2024) by its authors.

     GAP  is free software; you can redistribute it and/or modify it under
the  terms  of  the  GNU  General  Public  License as published by the Free
Software  Foundation;  either version 2 of the License, or (at your option)
any  later  version. 
.SH "SEE ALSO"
.I gac(1)
.I update-gap-workspace(1)
.P
You can read the complete manual in /usr/share/gap/doc or you can use the online help system. Type ?help inside GAP to access it.
Type 
.P
?Reference: options!under UNIX
.P
to access the full documentation of options.
.P