[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 37/46: doc/groff.texi: Update internal cross references.
From: |
G. Branden Robinson |
Subject: |
[groff] 37/46: doc/groff.texi: Update internal cross references. |
Date: |
Wed, 7 Dec 2022 04:32:37 -0500 (EST) |
gbranden pushed a commit to branch master
in repository groff.
commit fa6b2a226c1290e988812bcfb6890166d4496185
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Dec 6 21:25:27 2022 -0600
doc/groff.texi: Update internal cross references.
When discussing warnings, xref to "Warnings" node, not "Debugging".
---
doc/groff.texi | 33 ++++++++++++++++++---------------
1 file changed, 18 insertions(+), 15 deletions(-)
diff --git a/doc/groff.texi b/doc/groff.texi
index 9a9de097e..039ef4e97 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -6152,7 +6152,7 @@ Furthermore, @code{!} is recognized only at the beginning
of a numeric
expression not contained by another numeric expression. In other words,
it must be the ``outermost'' operator. Including it elsewhere in the
expression produces a warning in the @samp{number} category
-(@pxref{Debugging}), and its expression evaluates false. This
+(@pxref{Warnings}), and its expression evaluates false. This
unfortunate limitation maintains compatibility with @acronym{AT&T}
@code{troff}. You can test a numeric expression for falsity by
comparing it to a false value.
@@ -7413,7 +7413,7 @@ exist, the request is ignored.
Create an alias @var{new} for an existing register @var{old}, causing
the names to refer to the same stored object. If @var{old} is
undefined, a warning in category @samp{reg} is produced and the request
-is ignored. @xref{Debugging}, for information about the enablement and
+is ignored. @xref{Warnings}, for information about the enablement and
suppression of warnings.
@cindex alias, register, removing (@code{aln})
@@ -7445,7 +7445,7 @@ name@tie{}@var{i}, two-character name @var{id}).
@code{\n} is
interpreted even in copy mode (@pxref{Copy Mode}). If the register is
undefined, it is created, assigned a value of@tie{}@samp{0}, that value
is interpolated, and a warning in category @samp{reg} is emitted.
-@xref{Debugging}, for information about the enablement and suppression
+@xref{Warnings}, for information about the enablement and suppression
of warnings.
@Example
@@ -7572,8 +7572,9 @@ Uppercase letters: 0, A, B, C, @dots{},@tie{}Z, AA,
AB,@tie{}@enddots{}
Lowercase letters: 0, a, b, c, @dots{},@tie{}z, aa, ab,@tie{}@enddots{}
@end table
-Omitting @var{fmt} causes a warning in category @samp{missing}; see
-@ref{Debugging}. Specifying an unrecognized format is an error.
+Omitting @var{fmt} causes a warning in category @samp{missing}.
+@xref{Warnings}, for information about the enablement and suppression of
+warnings. Specifying an unrecognized format is an error.
Zero values are interpolated as @samp{0} in non-Arabic formats.
Negative quantities are prefixed with @samp{-} irrespective of format.
@@ -10661,7 +10662,7 @@ ordinary input character: that is, the character
@code{a} is not the
same as @code{\[a]}.
If @var{name} is undefined, a warning in category @samp{char} is
-produced and the escape is ignored. @xref{Debugging}, for information
+produced and the escape is ignored. @xref{Warnings}, for information
about the enablement and suppression of warnings.
GNU @code{troff} resolves @code{\[@r{@dots{}}]} with more than a single
@@ -12019,7 +12020,8 @@ contents and the @code{\*} escape sequence dereferences
its name,
interpolating its contents. If the string named by the @code{\*} escape
sequence does not exist, it is defined as empty, nothing is
interpolated, and a warning in category @samp{mac} is emitted.
-@xref{Warnings}.
+@xref{Warnings}, for information about the enablement and suppression of
+warnings.
@DefreqList {ds, name [@Var{contents}]}
@DefreqItemx {ds1, name [@Var{contents}]}
@@ -12301,7 +12303,7 @@ been defined.
Create an alias @var{new} for the existing request, string, macro, or
diversion object named @var{old}, causing the names to refer to the same
stored object. If @var{old} is undefined, a warning in category
-@samp{mac} is produced, and the request is ignored. @xref{Debugging},
+@samp{mac} is produced, and the request is ignored. @xref{Warnings},
for information about the enablement and suppression of warnings.
To understand how the @code{als} request works, consider two different
@@ -14766,11 +14768,12 @@ For orthogonality it is said that GNU @code{troff} is
in the
output is being ``diverted'' immediately to the output device).
Dereferencing an undefined diversion will create an empty one of that
-name and cause a warning in category @samp{mac} to be emitted
-(@pxref{Debugging}). A diversion does not exist for the purpose of
-testing with the @code{d} conditional operator until its initial
-definition ends (@pxref{Operators in Conditionals}). The following
-requests are used to create and alter diversions.
+name and cause a warning in category @samp{mac} to be emitted.
+@xref{Warnings}, for information about the enablement and suppression of
+warnings. A diversion does not exist for the purpose of testing with
+the @code{d} conditional operator until its initial definition ends
+(@pxref{Operators in Conditionals}). The following requests are used to
+create and alter diversions.
@DefreqList {di, [@Var{name}]}
@DefreqListEndx {da, [@Var{name}]}
@@ -14791,7 +14794,7 @@ Invoking @code{di} or @code{da} without an argument
stops diverting
output to the diversion named by the most recent corresponding request.
If @code{di} or @code{da} is called without an argument when there is no
current diversion, a warning in category @samp{di} is produced.
-@xref{Debugging}, for information about the enablement and suppression
+@xref{Warnings}, for information about the enablement and suppression
of warnings.
@Example
@@ -15485,7 +15488,7 @@ Replace the @code{so} request's control line with the
contents of the
file named by the argument, ``sourcing'' it. @var{file} is sought in
the directories specified by @option{-I} command-line option. If
@var{file} does not exist, a warning in category @samp{file} is produced
-and the request has no further effect. @xref{Debugging}, for
+and the request has no further effect. @xref{Warnings}, for
information about the enablement and suppression of warnings.
@code{so} can be useful for large documents; e.g., allowing each chapter
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 37/46: doc/groff.texi: Update internal cross references.,
G. Branden Robinson <=