groff-commit
[Top][All Lists]
Advanced

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

[groff] 29/37: doc/groff.texi (Input Line Traps): Fix error.


From: G. Branden Robinson
Subject: [groff] 29/37: doc/groff.texi (Input Line Traps): Fix error.
Date: Mon, 14 Mar 2022 01:59:11 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 302af44e859f769e4e7fe87f582f2453417ba616
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Mar 13 19:28:08 2022 +1100

    doc/groff.texi (Input Line Traps): Fix error.
    
    * doc/groff.texi (Input Line Traps): Fix error; input traps do _not_
      ignore control lines.  Error appears to have crept in with the first
      version of our Texinfo manual, shipped with groff 1.14 (December
      1999).
    
    * man/groff.7.man (Request short reference): Sync with the above; this
      page was correct in groff 1.22.4 but I made it incorrect in c5ff7fd87,
      16 November 2020, thinking the Texinfo manual was right, and
      foolishingly not performing my own experiment.  To efficiently write
      documentation, we must assume that existing documentation lies all the
      time about everything.  (I've found that this practice is even more
      a survival skill for semiconductor manufacturers' data sheets.)
    
    .de X
    TRAP SPRUNG.
    ..
    .nf
    Foo.
    .it 1 X
    Bar.
    .it 1 X
    .if 1 ***
    Baz.
---
 ChangeLog       | 7 +++++++
 doc/groff.texi  | 4 +---
 man/groff.7.man | 2 +-
 3 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 7df57f0d..221d1169 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2022-03-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       * doc/groff.texi (Input Line Traps): Fix error; input traps do
+       _not_ ignore control lines.  Error appears to have crept in with
+       the first version of our Texinfo manual, shipped with groff 1.14
+       {December 1999}.
+
 2022-03-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        * font/devps/devps.am: Rename targets.
diff --git a/doc/groff.texi b/doc/groff.texi
index 82374433..21c23292 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -14109,9 +14109,7 @@ error to invoke @code{dt} in the top-level diversion.
 @cindex input line trap, setting (@code{it})
 @cindex trap, input line, setting (@code{it})
 Set an input line trap, calling macro @var{name} after the next
-@var{n}@tie{}text lines have been read; control lines are not
-counted.@footnote{@ref{Requests and Macros} defines control and text
-lines.}
+@var{n}@tie{}lines of input have been read.
 
 Consider a macro @samp{.ST @var{s n}} which sets the next
 @var{n}@tie{}input lines in the font style@tie{}@var{s}.
diff --git a/man/groff.7.man b/man/groff.7.man
index 932d37f2..13497adc 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -2293,7 +2293,7 @@ calling macro
 .IR name ,
 after the next
 .IR n\~ lines
-lines of text input have been read.
+lines of input have been read.
 .
 .
 .TPx



reply via email to

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