[groff] 02/34: doc/groff.texi: Recast `.backtrace` description.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit d78ed35dd6054a7e9fc203ac1e8c811c7a309f14
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Aug 23 15:26:17 2021 +1000

    doc/groff.texi: Recast `.backtrace` description.
---
 doc/groff.texi | 24 +++++++++---------------
 1 file changed, 9 insertions(+), 15 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 87fa241..f77bcbf 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -15384,10 +15384,11 @@ This request causes a line break.
 @Defreq {backtrace, }
 @cindex backtrace of input stack (@code{backtrace})
 @cindex input stack, backtrace (@code{backtrace})
-Print a backtrace of the input stack to the standard error stream.
+Write a backtrace of the input stack to the standard error stream.
 
-Consider the following in file @file{test}:
+Consider the following in a file @file{test}.
 
+@codequoteundirected on
 @Example
 .de xxx
 .  backtrace
@@ -15397,22 +15398,15 @@ Consider the following in file @file{test}:
 ..
 .
 .yyy
-@endExample
-
-@noindent
-On execution, @code{gtroff} prints the following:
-
-@codequoteundirected on
-@Example
-gtroff: backtrace: 'test':2: macro 'xxx'
-gtroff: backtrace: 'test':5: macro 'yyy'
-gtroff: backtrace: file 'test':8
+    @error{} troff: backtrace: 'test':2: macro 'xxx'
+    @error{} troff: backtrace: 'test':5: macro 'yyy'
+    @error{} troff: backtrace: file 'test':8
 @endExample
 @codequoteundirected off
 
-The option @option{-b} of @code{gtroff} causes a backtrace to be
-generated on each error and warning.  Warnings have to be enabled;
-@pxref{Warnings}.
+The @option{-b} option of GNU @code{troff} causes a backtrace to be
+generated on each error or warning.  Some warnings have to be enabled;
+@xref{Warnings}.
 @endDefreq
 
 @Defreg {slimit}