Improve manpage: add description and missing options, improve formatting

This commit is contained in:
suve 2017-11-06 21:48:55 +01:00
parent b9d027291e
commit b7c8108ad5

View File

@ -1,31 +1,43 @@
.TH cool-retro-term 1 "August 22 2016" .TH "COOL-RETRO-TERM" 1 "2017-11-06"
.SH NAME .SH NAME
cool-retro-term \- terminal emulator mimicking the old cathode display cool\-retro\-term \- terminal emulator mimicking an old cathode display
.SH SYNOPSIS .SH SYNOPSIS
"Usage: ./cool\-retro\-term [\-\-default\-settings] [\-\-workdir <dir>] [\-\-program <prog>] [\-p|\-\-profile <prof>] [\-\-fullscreen] [\-h|\-\-help]" \fBcool\-retro\-term\fR [\fIOPTIONS\fR]
.br
\fBcool\-retro\-term\fR [\fIOPTIONS\fR] -e \fICOMMAND\fR [\fIARGUMENT\fR...]
.SH DESCRIPTION .SH DESCRIPTION
This manual page documents briefly the This manual page documents briefly the \fBcool\-retro\-term\fR command.
.B cool-retro-term .PP
command. \fBcool\-retro\-term\fR is a terminal emulator which mimics the
look and feel of the old cathode tube screens.
It has been designed to be eye-candy,
customizable, and reasonably lightweight.
.SH OPTIONS .SH OPTIONS
.TP .TP
\fB\-\-default\-settings\fR \fB\-\-default\-settings\fR
Run cool\-retro\-term with the default settings Run with the default settings.
.TP .TP
\fB\-\-workdir\fR <dir> \fB\-e\fR \fICOMMAND\fR
Change working directory to 'dir' Command to execute. This should be used as the last option.
.TP All the arguments following \fICOMMAND\fR will be passed to said command.
\fB\-e\fR <cmd>
Command to execute. This option will catch all following arguments, so use it as the last option.
.TP .TP
\fB\-\-fullscreen\fR \fB\-\-fullscreen\fR
Run cool\-retro\-term in fullscreen. Run in fullscreen mode.
.HP
\fB\-p\fR|\-\-profile <prof> Run cool\-retro\-term with the given profile.
.TP .TP
\fB\-h\fR|\-\-help \fB\-h\fR, \fB\-\-help\fR
Print this help. Print a help screen and exit.
.TP
\fB\-p\fR \fIPROFILE\fR, \fB\-\-profile\fR \fIPROFILE\fR
Run with the given profile.
.TP
\fB\-\-workdir\fR \fIDIR\fR
Start with \fIDIR\fR as the working directory.
.TP .TP
\fB\-\-verbose\fR \fB\-\-verbose\fR
Print additional information such as profiles and settings. Print additional information such as profiles and settings.
.PP .TP
\fB\-v\fR, \fB\-\-version\fR
Print the version number and exit.
.SH LICENCE
This program is available under the terms of the GNU General Public License,
version 3 or any later version, as published by the Free Software Foundation.