assorted improvements to less.1, more.1

classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|

assorted improvements to less.1, more.1

Evan Silberman
- less(1) should explain what it does before it talks about more(1)
- reference the COMMANDS section directly when mentioning commands
- add HISTORY to less.1
- credit Garret D'Amore in AUTHORS since he is also attributed in the
  source code as a copyright holder
- it is false that more(1) can be invoked with the options of less(1)

Regards,
Evan Silberman

P.S. patch generated with got(1), neat.

diff 3474c532363343e2e65328f8389848966744ce51 99ab9c189b3b40d7b96cd17ef241b444a0bf456a
blob - 8e6971c243372003b031bba7e37bc50ff3ab8030
blob + 44d9b5001fa119c53e0cf27f9e103d23f5e48dc2
--- usr.bin/less/less.1
+++ usr.bin/less/less.1
@@ -48,30 +48,22 @@
 .Op Ar
 .Sh DESCRIPTION
 .Nm
-is a program similar to the traditional
-.Xr more 1 ,
-but with many more features.
-It displays text one screenful at a time.
-After showing each screenful, it prompts the user for a command.
+displays text one screenful at a time.
+After showing each screenful, it prompts the user for a command,
+as described in
+.Sx COMMANDS .
 When showing the last line of a file,
 .Nm
 displays a prompt indicating end of file and the name of the next file
 to examine, if any.
 It then waits for input from the user.
 .Pp
-Commands are based on both traditional
-.Xr more 1
-and
-.Xr vi 1 .
-Commands may be preceded by a decimal number,
-called
-.Ar N
-in the descriptions below.
-The number is used by some commands, as indicated.
-.Pp
-This version of
 .Nm
-also acts as
+is similar to the traditional
+.Xr more 1 ,
+but with many more features.
+.Nm
+will behave like
 .Xr more 1
 if it is called as
 .Nm more ,
@@ -757,6 +749,14 @@ command described previously
 may also be used to set (or change) an initial command for every file.
 .El
 .Sh COMMANDS
+Commands are based on both traditional
+.Xr more 1
+and
+.Xr vi 1 .
+Commands may be preceded by a decimal number,
+called
+.Ar N
+in the descriptions below.
 In the following descriptions, ^X means control-X.
 ESC stands for the ESCAPE key; for example ESC-v means the
 two character sequence "ESCAPE", then "v".
@@ -1916,5 +1916,16 @@ is used.
 .Sh SEE ALSO
 .Xr lesskey 1 ,
 .Xr more 1
+.Sh HISTORY
+Mark Nudelman created
+.Nm
+beginning in 1983; it was first published in 1985.
+.Nm
+was included in
+.Ox 2.0 .
+The present implementation is based on a fork by Garret D'Amore and
+first appeared in
+.Ox 5.9 .
 .Sh AUTHORS
-.An Mark Nudelman .
+.An Mark Nudelman Aq Mt [hidden email]
+.An Garret D'Amore
blob - 66b4ee23971952e3f9297adf54dc1a5f0276f81b
blob + e4eba49ed8b04c2a68ae66190cc1273fce350f3d
--- usr.bin/less/more.1
+++ usr.bin/less/more.1
@@ -65,17 +65,6 @@ It then waits for input from the user.
 Scrolling forward switches to the next file,
 or exits if there is none.
 .Pp
-This version of
-.Nm
-is actually
-.Xr less 1
-in disguise.
-As such, it will also accept options documented in
-.Xr less 1 .
-This manual page describes only features
-relevant to a POSIX compliant
-.Nm .
-.Pp
 The options are as follows:
 .Bl -tag -width Ds
 .It Fl c
@@ -318,5 +307,9 @@ A
 .Nm
 command appeared in
 .Bx 3.0 .
+The present implementation is actually
+.Xr less 1
+in disguise.
 .Sh AUTHORS
 .An Mark Nudelman Aq Mt [hidden email]
+.An Garret D'Amore