[groff] 75/122: gxditview(1): Recast for clarity and grammar.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 690e4059d73e6226b29a0de35cccdb6fbbfca65d
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Nov 9 21:38:49 2020 +1100

    gxditview(1): Recast for clarity and grammar.
    
    * Reorder discussion of what sorts of intermediate output can be viewed
      for clarity.
    * Use better demonstrative pronoun.
    * Append suffix to man page in example to make it (perhaps) clearer that
      a real file name is meant, not a search keyword like man(1)
      technically accepts.
    * Drop spurious word in "as be".
    * Clarify distinction between menu item labels and actions.
    * Use indefinite article to introduce a new action not bound to a menu
      item.
---
 src/devices/xditview/gxditview.1.man | 27 ++++++++++++++++-----------
 1 file changed, 16 insertions(+), 11 deletions(-)

diff --git a/src/devices/xditview/gxditview.1.man 
b/src/devices/xditview/gxditview.1.man
index 4261ca3..0cb03f9 100644
--- a/src/devices/xditview/gxditview.1.man
+++ b/src/devices/xditview/gxditview.1.man
@@ -105,13 +105,14 @@ The intermediate output format of
 is device-independent but not device-agnostic.
 .
 .I gxditview
-can view it for all typesetter devices;
-that is,
-it will not display output for terminal
-.RI ( nroff )
-devices,
+can view it for all typesetter devices,
 but the quality is device-dependent.
 .
+.I gxditview
+will not display output for terminal
+.RI ( nroff )
+devices.
+.
 .
 .PP
 The best results are achieved with the
@@ -135,7 +136,7 @@ and the base point size
 They are especially built for
 .IR gxditview .
 .
-When using one of them
+When using one of these,
 .I groff
 generates the intermediate output for this device and calls
 .I gxditview
@@ -147,7 +148,7 @@ the following command views this man page with a base point 
size of 12.
 .PP
 .RS
 .EX
-groff \-TX100\-12 \-man gxditview
+groff \-TX100\-12 \-man gxditview.1
 .EE
 .RE
 .
@@ -214,7 +215,7 @@ intermediate output.
 .
 If the filename starts with a bar or pipe symbol,
 .RB \[lq] | \[rq]
-it will be interpreted as be a command from which to read.
+it will be interpreted as a command from which to read.
 .
 .
 .TP
@@ -224,6 +225,10 @@ Exit from
 .
 .
 .PP
+The menu entries correspond to actions with similar but not identical
+names,
+which can also be accessed with keyboard accelerators.
+.
 The
 .IR n ,
 .IR Space ,
@@ -232,7 +237,7 @@ and
 .I Next
 .RI ( PgDn )
 keys are bound to the
-.B Next\~Page
+.B NextPage
 action.
 .
 The
@@ -244,7 +249,7 @@ and
 .I Prior
 .RI ( PgUp )
 keys are bound to the
-.B Previous\~Page
+.B PreviousPage
 action.
 .
 The
@@ -267,7 +272,7 @@ action.
 .
 The
 .I r
-key is bound to the
+key is bound to a
 .B Rerasterize
 action which rereads the current file,
 and redisplays the current page;