gbranden pushed a commit to branch master
in repository groff.
commit 724d4a80603ad7539bb0e770cdfe5c94bcd07ce5
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Aug 27 01:45:18 2026 -0500
pic(1): Tighten presentation.
We already go to the trouble of explaining how delimiters work. Use
them in the synopses and drop redundant material from command
descriptions.
---
src/preproc/pic/pic.1.man | 30 ++++++------------------------
1 file changed, 6 insertions(+), 24 deletions(-)
diff --git a/src/preproc/pic/pic.1.man b/src/preproc/pic/pic.1.man
index 525cb3619..9c9cec1e0 100644
--- a/src/preproc/pic/pic.1.man
+++ b/src/preproc/pic/pic.1.man
@@ -490,7 +490,7 @@ such strings may contain the delimiter character or
unbalanced braces.
.BI for\~ variable \~=\~ expr1 " to " expr2\~\c
.RB [ by \~[ * ]\c
.IR expr3 ]\~\c
-.BI do\~ "X body X"
+.BI "do {\~" body \~}
Set
.I variable
to
@@ -534,15 +534,9 @@ If the range constraint on
isn't met,
the loop does not execute.
.
-.I X
-can be any character not in
-.IR body .
-.
.TP
-.BI if\~ expr \~then\~\c
-.IR "X if-true X" \~[\c
-.BI else\~ "Y if-false Y\c"
-]
+.BI if\~ expr "\~then {\~" if-true \~}\~\c
+.RB [ "else {\~" if-false \~} ]
Evaluate
.IR expr ;
if it is non-zero then do
@@ -550,14 +544,6 @@ if it is non-zero then do
otherwise do
.IR if-false .
.
-.I X
-can be any character not in
-.IR if-true .
-.
-.I Y
-can be any character not in
-.IR if-false .
-.
.TP
.BI print\~ arg\c
\~.\|.\|.
@@ -618,7 +604,7 @@ when formatted with
.
.
.TP
-.BI sh\~ "X command X"
+.BI "sh {" command \~}
Pass
.I command
to a shell via
@@ -639,8 +625,8 @@ at this point in the file.
.TP
.BR copy\~ [ \[dq]\c
.IB filename \[dq]\c
-.RB ]\~ thru\~\c
-.IR "X body X" \~\c \" space in roman: we must use 2-font macro with \c
+.RB ]\~ "thru {\~\c"
+.IB body \~}\~\c
.RB [ until\~ \[dq]\c
.IB word \[dq]\c
]
@@ -685,10 +671,6 @@ reads lines only until encountering one beginning with
.IR word ;
which it then discards.
.
-.I X
-can be any character not in
-.IR body .
-.
For example,
.
.RS \" now move further
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
