gbranden pushed a commit to branch master
in repository groff.
commit cd0348c21cc000939dbadcda90c77ef0e590d879
Author: G. Branden Robinson <[email protected]>
AuthorDate: Wed Aug 26 23:53:40 2026 -0500
pic(1): Revise "reset" command description.
* Rewrite synopsis to more accurately reflect its syntax. All arguments
are optional, and spaces after commas can be in any multiplicity.
It's hard to express the last detail in synopsis language. We'd need
ERE quantifiers like `+` or `{1,}` for that.
In fact, pic's grammar is weird in a couple of ways. See also "copy ...
thru", where's no _lexical_ difference between the form of the command
that names a macro and the one that doesn't. Instead, the argument
after "thru" is looked up as a macro first, and if the lookup fails,
it's interpreted as a delimited string. Ugh!
Looks like I'll have an opportunity to offend Kernighan's acolytes by
proposing a reform one of these days.
---
src/preproc/pic/pic.1.man | 24 ++++++++++++------------
1 file changed, 12 insertions(+), 12 deletions(-)
diff --git a/src/preproc/pic/pic.1.man b/src/preproc/pic/pic.1.man
index 7262e6aaa..37addc277 100644
--- a/src/preproc/pic/pic.1.man
+++ b/src/preproc/pic/pic.1.man
@@ -728,26 +728,26 @@ its first character is interpreted as a delimiter.
.
.
.TP
-.B reset
+.BR reset\~ [\c
+.IR pvar\~ .\|.\|.]
.TQ
.BI reset\~ pvar1\c
-.RB [ , ]\~\c
-.IR pvar2 \~.\|.\|.
-Reset predefined variables
-.IR pvar1 ,
-.I pvar2
+.RB [ , "[ ] \c"
+.IR pvar2 \~.\|.\|.]
+Reset predefined global variables
+.I pvar
\&.\|.\|.\& to their default values;
-if no arguments are given,
-reset all predefined variables to their default values.
+without arguments,
+reset all such variables to their default values.
.
-Variable names may be separated by commas,
-spaces,
+Variable names may be separated by commas, \" at most one at a time
+spaces, \" in any quantity (at least one if no comma)
or both.
.
Assigning a value to
.B scale
-also causes all predefined variables that control dimensions to be reset
-to their default values times the new value of
+also causes all predefined global variables that control dimensions
+to be reset to their default values times the new value of
.BR scale .
.
.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
