[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 06/09: groff(1): Recast -P option documentation.
From: |
G. Branden Robinson |
Subject: |
[groff] 06/09: groff(1): Recast -P option documentation. |
Date: |
Thu, 20 Aug 2020 09:59:02 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit 6ac3b1c67a1e57657d2587849c8efc2816bb10de
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Aug 19 19:53:34 2020 +1000
groff(1): Recast -P option documentation.
Recast for clarity, but mainly because I wanted to kill off the
page-local "Quoted" macro, which was used only twice.
---
src/roff/groff/groff.1.man | 62 ++++++++++++++++++++--------------------------
1 file changed, 27 insertions(+), 35 deletions(-)
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index a35857e..e673627 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -29,18 +29,6 @@ groff \- front-end for the groff document formatting system
.
.
.\" ====================================================================
-.\" Definitions
-.\" ====================================================================
-.
-.\" ====================================================================
-.\" 'char or string'
-.de Quoted
-. ft CR
-\[oq]\\$*\[cq]
-. ft
-..
-.
-.\" ====================================================================
.SH Synopsis
.\" ====================================================================
.
@@ -314,45 +302,49 @@ Preprocess with
.
.
.TP
-.BI \-P\ \-option
+.BI \-P\~ arg
.TQ
-.BI \-P\ \-option \ \-P\ arg
-Pass
-.I \-option
-or
-.I "\-option\~arg"
-to the postprocessor.
+.BI "\-P \-" option
+.TQ
+.BI "\-P \-" option\~ \-P\~ arg
+Pass arguments to the postprocessor.
.
-The option must be specified with the necessary preceding minus
-sign(s)
-.Quoted \-
-or
-.Quoted \-\-
+.
+.IP
+Each command-line
+.I option
+to a postprocessor must be specified with any required leading dashes
+.RB \[lq] \- \[rq]
+.\" No GNU roff postprocessor uses long options for anything except
+.\" --help or --version.
+.\"or
+.\".RB \[lq] \-\- \[rq]
because
-.B groff
-does not prepend any dashes before passing it to the postprocessor.
+.I groff
+passes the arguments as-is to the postprocessor;
+this permits arbitrary arguments to be transmitted.
.
-For example, to pass a title to the
-.B \%gxditview
-postprocessor, the shell command
+For example,
+to pass a title to the
+.I gxditview
+postprocessor,
+the shell command
.
.RS
-.IP
+.RS
.EX
-groff \-X \-P \-title \-P 'groff it' \f[I]foo\f[]
+.B groff \-X \-P \-title \-P 'trial run' mydoc.t
.EE
.RE
.
-.IP
is equivalent to
.
.RS
-.IP
.EX
-groff \-X \-Z \f[I]foo\f[] | \
-gxditview \-title 'groff it' \-
+.B groff \-X \-Z mydoc.t | gxditview \-title 'trial run' \-
.EE
.RE
+.RE
.
.
.TP
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 06/09: groff(1): Recast -P option documentation.,
G. Branden Robinson <=