Re: Missing action list in lesskey man page

Hi Ingo and Theo,
thanks for sharing your opinions and thanks for the very thorough
response, Ingo! I learned a few things while reading it and appreciate
your suggested patch. I especially like the introduced bullet points and
find they make the man page easier to read.

"Theo de Raadt" <deraadt@openbsd.org> wrote:
> Ingo Schwarze <schwarze@usta.de> wrote:
>
> > >> I'd much prefer to have
> > >> the actions explained in the lesskey(1) man page.
> >
> > No way. Copying half of the less(1) manual to the lesskey(1) manual
> > would result in a maintenance nightmare.
>
> I agree. This is not the first time one has to read two related pages
> to gain understanding, rather than reading one monster combined or
> duplicated page -- which can muddle up other learning patterns.

I understand your concerns and think I might had made up my mind a
little to quickly. Let me take one step back: I thought something was
missing from the man page, because I initially thought, that lesskey was
meant to provide ways to extend less. I thought, that it would allow
me to bind shell scripts to keys or something similar. Now that I'm a
little more familiar with lesskey, I can see that this assumption was
wrong.

lesskey is only meant to change the default key bindings. If I
understood this earlier on, it would probably have saved me the
confusion. Maybe the purpose of lesskey could be clarified a bit more in
the man page. What do you think?

Greetings,
Richard Ulmer

Index: lesskey.1
===================================================================
RCS file: /cvs/src/usr.bin/less/lesskey.1,v
retrieving revision 1.17
diff -u -p -u -r1.17 lesskey.1
--- lesskey.1 7 Dec 2021 13:26:49 -0000 1.17
+++ lesskey.1 7 Dec 2021 18:49:26 -0000
@@ -27,7 +27,7 @@
.Os
.Sh NAME
.Nm lesskey
-.Nd specify key bindings for less
+.Nd customize key bindings for less
.Sh SYNOPSIS
.Nm lesskey
.Oo Fl o Ar output
@@ -37,8 +37,8 @@
.Fl V | -version
.Sh DESCRIPTION
.Nm
-is used to specify a set of key bindings to be used by
-.Xr less 1 .
+is used to change the default key bindings of
+.Xr less 1 to match personal preference.
The input file is a text file which describes the key bindings.
If the input file is
.Sq - ,