groff-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[groff] 03/07: grog(1): Document further limitations.


From: G. Branden Robinson
Subject: [groff] 03/07: grog(1): Document further limitations.
Date: Wed, 30 Jun 2021 05:48:20 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 611195f4b71755185a838c20e5995106c3c5a890
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Jun 30 15:48:26 2021 +1000

    grog(1): Document further limitations.
    
    * src/utils/grog/grog.1.man (Limitations): Document further restrictions
      (no changing of control characters, control structures not
      interpreted).
---
 ChangeLog                 |  6 ++++++
 src/utils/grog/grog.1.man | 39 +++++++++++++++++++++++++++++++++++++++
 2 files changed, 45 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index cb90745..48c8504 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,11 @@
 2021-06-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
+       * src/utils/grog/grog.1.man (Limitations): Document further
+       restrictions (no changing of control characters, control
+       structures not interpreted).
+
+2021-06-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
        [grog]: Refactor command-line argument handling.
 
        * src/utils/grog/grog.pl:
diff --git a/src/utils/grog/grog.1.man b/src/utils/grog/grog.1.man
index 9eb34fd..58b6e92 100644
--- a/src/utils/grog/grog.1.man
+++ b/src/utils/grog/grog.1.man
@@ -237,6 +237,45 @@ option.
 .SS Limitations
 .\" ====================================================================
 .
+.I grog
+presumes that the input does not change the control and no-break control
+characters.
+.
+.
+.P
+.I grog
+does not parse
+.I roff
+control structures
+(the
+.RB \[lq] if \[rq],
+.RB \[lq] ie \[rq],
+and
+.RB \[lq] el \[rq]
+requests)
+nor
+.IR groff 's
+.RB \[lq] while \[rq].
+.
+Thus the input
+.
+.RS
+.EX
+\&.if t .PS
+\&.if t .PE
+.EE
+.RE
+.
+will not,
+for example,
+cause
+.I grog
+to infer use of the
+.IR \%@g@pic (1)
+preprocessor.
+.
+.
+.P
 Detection of the
 .B \-s
 option



reply via email to

[Prev in Thread] Current Thread [Next in Thread]