.TH neercs 1 "2009-11-10" "neercs"
.SH NAME
neercs \- text-mode window manager
.SH SYNOPSIS
\fBneercs\fR [\fIOPTIONS\fR] [\fIPROGRAM1\fR \fIPROGRAM2\fR...]
.SH DESCRIPTION
.PP
\fBneercs\fR manages as many terminals as you want in the same window.
.PP
If no file arguments are provided, \fBneercs\fR will launch your default shell
($SHELL environment variable).
.PP
.SH "COMMAND-LINE OPTIONS"
.PP
\fBneercs\fR has the following command-line options:
.TP 5
.BI "\-c " file
override the default configuration file to \fIfile\fP. Default is to try
\*Q/etc/neercs.conf\*U and \*Q$HOME/.neercsrc\*U.
.TP 5
.BI "\-P " pid 
Grab a running process.
.TP 5
.B \-r \fR[ \fIsession \fR]
Reattach a session.
.TP 5
.B \-R \fR[ \fIsession \fR]
Reattach a session if possible, otherwise start a new session.
.TP 5
.BI "\-S " name
Name the session \fIname\fP instead of using the pid.
.PP
.SH KEYBINDINGS
.PP
Within \fBneercs\fR, some keybindings are reminded in the status bar,
the complete list can be found in the help screen accessible with
\fBCtrl-a h\fR.
.PP
All the actions are available through \fBCtrl-a \fIX\fR with \fIX\fR
being one of the following:
.TP
.BR n " Next window"
.TP
.BR p " Previous window"
.TP
.BR w " Switch window manager"
.TP
.BR c " Create new window"
.TP
.BR m " Show/Hide Thumbnails"
.TP
.BR d " Detach"
.TP
.BR k " Close current window and kill associated process"
.TP
.BR h " Display help"

.SH CONFIGURATION FILE
The configuration file contains one setting per line in the form
\fIname\fR=\fIvalue\fR.
.PP
When a setting appears several times, last occurrence only is used.
.PP
When a setting as type \fIbool\fR, it will be true if the value is 1
or \fItrue\fR, false for any other value.
.PP
Valid settings are the following:
.TP 5
.BI window_manager= full|hsplit|vsplit|card
Use given window manager, default is vsplit.
.TP 5
.BI thumbnails= bool
Display thumbnails.
.TP 5
.BI status_bar= bool
Display status bar.
.TP 5
.BI screensaver_timeout= n
Start screensaver after \fIn\fR seconds of inactivity.
.TP 5
.BI autolock_timeout= n
Lock screen after \fIn\fR seconds of inactivity.
.TP 5
.BI lock_on_detach= bool
.Lock screen when detaching.
.TP 5
.BI socket_dir= dir
Store sockets in \fIdir\fP. Default location is taken from
\fBNEERCSDIR\fR environment variable if defined, or \fBTMPDIR\fR.
If this option is not set and none of these variables is defined,
\fI/tmp\fR will be used.
.TP 5
.BI delay= n
Wait at least \fIn\fRms between refresh.
.SH EXAMPLES
.PP
neercs top cacademo zsh
.SH SEE ALSO
.PP
\fBscreen(1)\fR
.SH AUTHOR
This manual page was written by Jean-Yves Lamoureux
<jylam@lnxscene.org> and updated by Pascal Terjan <pterjan@linuxfr.org>