чување bc227639a86c4dc36f8cd54cdcb2b9ffde014ac2
родитељ f6e3227f303b4be687047c8010a4a904f8cc8d64
Аутор: Страхиња Радић <contact@strahinja.org>
Датум: Mon, 6 May 2024 22:13:21 +0200
sled.1.in: Syntax fixes; add EXIT STATUS
Signed-off-by: Страхиња Радић <contact@strahinja.org>
Diffstat:
| M | sled.1.in | | | 45 | +++++++++++++++++++++++++-------------------- |
измењених датотека: 1, додавања: 25(+), брисања: 20(-)
diff --git a/sled.1.in b/sled.1.in
@@ -12,26 +12,28 @@
.Nd Simple text editor
.Sh SYNOPSIS
.Nm
-.Fl h | \-help | Fl V | \-full\-version | Fl v | \-version |
+.Fl h | \-help | Fl V | \-full\-version | Fl v | \-version
+.Nm
.Ar filename
.Sh DESCRIPTION
.Nm
is a simple text editor with a terminal UI.
.Bl -tag -width Ds
-.It Fl h | \-help
+.It Fl h , \-help
Show option summary.
-.It Fl V | \-full\-version
+.It Fl V , \-full\-version
Show full version information: like
.Fl v ,
followed by copyright notice and defines set in
.Pa config.h .
-.It Fl v | \-version
+.It Fl v , \-version
Show version information: program version and source git repository commit date.
.El
.Ss Modes
.Nm
has four modes of operation.
.Bl -tag -width Ds
+.Tg Insert_mode
.It Sy Insert mode
The initial mode which is active on startup.
It behaves like one would expect from a
@@ -39,20 +41,23 @@ It behaves like one would expect from a
text editor: most
characters are self-inserting, arrow keys and Backspace/Delete work as expected,
and so on.
-.It Sy "Command mode"
+.Tg Command_mode
+.It Sy Command mode
Command mode behaves more like
.Xr vi 1 :
characters like \f[CR]h\fR, \f[CR]j\fR, \f[CR]k\fR, \f[CR]l\fR no longer insert
themselves but execute commands (in this case movement commands).
-.It Sy "Overwrite mode"
+.Tg Overwrite_mode
+.It Sy Overwrite mode
This is the same as insert mode, except that newly inserted characters replace
the existing ones instead of being inserted among them.
-.It Sy "Selection mode"
+.Tg Selection_mode
+.It Sy Selection mode
In this mode, moving around the file extends the selection, and most commands
that alter text instead delete the selection and exit selection mode.
.El
.
-.Ss "Global key bindings"
+.Ss Global key bindings
These are active in all modes, and are as follows:
.TS
box tab(@);
@@ -92,21 +97,21 @@ _
\f[CR]C-W\fR@Erase previous word
.TE
.
-.Ss "Insert and overwrite mode key bindings"
+.Ss Insert and overwrite mode key bindings
In
-.Sy insert mode
+.Sx Insert mode
and
-.Sy overwrite mode ,
+.Sx Overwrite mode ,
characters are self\-inserting, and \f[CR]Enter\fR inserts new line.
All the global keys apply to insert mode as well.
Entering overwrite mode switches back to insert mode when the overwrite mode is
toggled off, even when the overwrite mode was entered from the command mode.
.
-.Ss "Command mode key bindings"
+.Ss Command mode key bindings
In
-.Sy "command mode" ,
+.Sx Command mode ,
the following
-.Sy vi Ns \-like
+.Nm vi Ns \-like
keys are in effect:
.TS
box tab(@);
@@ -144,9 +149,9 @@ _
\f[CR]Z\fR@Write (save) file
.TE
.
-.Ss "Selection mode key bindings"
+.Ss Selection mode key bindings
If
-.Sy selection mode
+.Sx Selection mode
was entered from insert mode (or insert mode is activated during selection
mode), typing any self\-inserting character or activating key bindings which
modify text, like \f[CR]Delete\fR or \f[CR]C-K\fR, will erase the selected text
@@ -155,10 +160,10 @@ question, exiting the selection mode.
.Pp
Similar holds true when the selection mode is entered from the command mode or
the command mode is activated during the selection mode, except that
-.Sy vi Ns \-like
+.Nm vi Ns \-like
key bindings which modify text will have the effect on the selection.
.
-.Ss "Status line"
+.Ss Status line
Status line is comprised of a number of segments, by default four.
.Bl -bullet -width 1m
.It
@@ -174,14 +179,14 @@ Fourth segment shows quick help.
.El
.
.Sh AUTHORS
-.An "Strahinya Radich" Aq contact@strahinja.org ,
+.An Strahinya Radich Aq Mt contact@strahinja.org ,
2022\-2024
.
.Sh BUGS
Bugs can be reported using the ticket tracker at:
.Lk https://\:todo.sr.ht/\:~strahinja/\:sled
.
-.Ss "Known limitations"
+.Ss Known limitations
.Bl -bullet -width 1m
.It
UTF-8 character set is assumed.
