sdn.1: take care about sentence spacing

For more info, see e.g.
https://github.com/asciidoc/asciidoc-py3/issues/137

I'll probably commit to mandoc here but scdoc is appealing.

Somewhat sadly, it explicitly suppresses sentence spacing
but I'm wondering whether it couldn't be reimplemented better,
in a more AsciiDoc-like fashion.
This commit is contained in:
Přemysl Eric Janouch 2020-10-29 19:21:24 +01:00
parent 07ef834a1e
commit c999e5a8e4
Signed by: p
GPG Key ID: A0420B94F92B9493
1 changed files with 25 additions and 16 deletions

41
sdn.1
View File

@ -1,3 +1,4 @@
\" https://mandoc.bsd.lv/man/roff.7.html#Sentence_Spacing
.Dd October 27, 2020 .Dd October 27, 2020
.Dt SDN 1 .Dt SDN 1
.Os Linux .Os Linux
@ -12,7 +13,8 @@
.Sh DESCRIPTION .Sh DESCRIPTION
.Nm .Nm
is a simple directory navigator that you can launch while editing shell is a simple directory navigator that you can launch while editing shell
commands. Use the commands.
Use the
.Xr sdn-install 1 .Xr sdn-install 1
script to integrate it with your shell, then invoke it at any time with M-o. script to integrate it with your shell, then invoke it at any time with M-o.
.Pp .Pp
@ -20,7 +22,8 @@ Press F1 to get a list of active key bindings and their assigned actions,
grouped by their contexts. grouped by their contexts.
.Pp .Pp
Program arguments are only used by integration snippets to forward the parent Program arguments are only used by integration snippets to forward the parent
shell's command line. The shell's command line.
The
.Ar point .Ar point
is given in terms of characters. is given in terms of characters.
.Sh OPTIONS .Sh OPTIONS
@ -28,9 +31,10 @@ While some behaviour can be toggled from within the program, some can only be
changed by modifying configuration files manually. changed by modifying configuration files manually.
.Pp .Pp
The files follow a simple syntax derived from the Bourne shell: each option is The files follow a simple syntax derived from the Bourne shell: each option is
on its own line, with words separated by linear whitespace. Comments start with on its own line, with words separated by linear whitespace.
a hash (#) and continue until the end of the line. All special characters may Comments start with a hash (#) and continue until the end of the line.
be quoted using either a backslash or single-quoted strings. All special characters may be quoted using either a backslash or single-quoted
strings.
.Pp .Pp
The options and the default key bindings controlling them are as follows: The options and the default key bindings controlling them are as follows:
.Bl -tag .Bl -tag
@ -46,9 +50,9 @@ If non-zero, the order of entries is reversed.
.It show-hidden Em bool No (M-.) .It show-hidden Em bool No (M-.)
If non-zero, filenames beginning with a full stop are shown. If non-zero, filenames beginning with a full stop are shown.
.It ext-helpers Em bool .It ext-helpers Em bool
If non-zero, viewers and editors are launched from the parent shell. This way If non-zero, viewers and editors are launched from the parent shell.
you can suspend them and use job control features of the shell. However it This way you can suspend them and use job control features of the shell.
also enforces any pending change to the shell's working directory. However it also enforces any pending change to the shell's working directory.
.It sort-column Em number No (< >) .It sort-column Em number No (< >)
The zero-based index of the The zero-based index of the
.Ql full-view .Ql full-view
@ -57,18 +61,20 @@ column that entries are ordered by.
.Sh ENVIRONMENT .Sh ENVIRONMENT
.Bl -tag -width 15n .Bl -tag -width 15n
.It Ev LS_COLORS .It Ev LS_COLORS
Used to retrieve filename colours. The format is described in Used to retrieve filename colours.
The format is described in
.Xr dir_colors 5 .Xr dir_colors 5
and you can use the and you can use the
.Xr dircolors 1 .Xr dircolors 1
utility to initialize this variable. utility to initialize this variable.
.It Ev PAGER .It Ev PAGER
The viewer program to be launched by the F3 key binding as well as to show The viewer program to be launched by the F3 key binding as well as to show
the internal help message. If none is set, it defaults to the internal help message.
If none is set, it defaults to
.Xr less 1 . .Xr less 1 .
.It Ev VISUAL , Ev EDITOR .It Ev VISUAL , Ev EDITOR
The editor program to be launched by the F4 key binding. If neither variable The editor program to be launched by the F4 key binding.
is set, it defaults to If neither variable is set, it defaults to
.Xr vi 1 . .Xr vi 1 .
.El .El
.Sh FILES .Sh FILES
@ -84,8 +90,9 @@ Redefine terminal attributes for UI elements.
.Ss Pa bindings .Ss Pa bindings
Key names or combinations follow the Emacs syntax for Control and Meta prefixes Key names or combinations follow the Emacs syntax for Control and Meta prefixes
and and
.Xr terminfo 5 names are used for special keys. To obtain more vifm-like .Xr terminfo 5
controls and Windows-like quit abilities: names are used for special keys.
To obtain more vifm-like controls and Windows-like quit abilities:
.Bd -literal -offset indent .Bd -literal -offset indent
normal h parent normal h parent
normal l choose normal l choose
@ -93,8 +100,10 @@ normal M-f4 quit
.Ed .Ed
.Ss Pa look .Ss Pa look
Terminal attributes are accepted in a format similar to that of Terminal attributes are accepted in a format similar to that of
.Xr git 1 , only named colours aren't supported. For a black-on-white terminal .Xr git 1 ,
supporting 256 colours, a theme such as the following may work: only named colours aren't supported.
For a black-on-white terminal supporting 256 colours, a theme such as the
following may work:
.Bd -literal -offset indent .Bd -literal -offset indent
cursor 231 202 cursor 231 202
bar 16 255 ul bar 16 255 ul