gbranden pushed a commit to branch master
in repository groff.
commit cfe74d86f43ef9ea7fef74c4acecd77d7e02b6a3
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Apr 18 13:02:23 2024 -0500
[docs]: De-document "el" troff warning category.
* doc/groff.texi.in (if-else, Warnings):
* src/roff/troff/troff.1.man (Warnings): Do it.
Continues commit b2ea8a3d84, 5 April.
I retain some commented material as a placeholder; I think it likely
that this bit in the warning mask can be re-used as the long-discussed
"style" warning category. See <https://savannah.gnu.org/bugs/?62776>.
It appears to be good fortune that the "el" category was not already
enabled by default.
---
ChangeLog | 4 ++++
doc/groff.texi.in | 13 ++++++-------
src/roff/troff/troff.1.man | 16 ++++++++--------
3 files changed, 18 insertions(+), 15 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index a88d52c5d..c65db2611 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -97,6 +97,10 @@
* src/roff/troff/troff.h: Comment out its value in the
`warning_type` enum.
+ * doc/groff.texi.in (if-else, Warnings):
+ * src/roff/troff/troff.1.man (Warnings): De-document "el" troff
+ warning category.
+
Fixes <https://savannah.gnu.org/bugs/?65474>. Thanks to Paul
Eggert for the report.
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 9ea93db6e..dad6dd7f3 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -13159,7 +13159,6 @@ does to any other request. This fact can surprise C
programmers.
. ie \na a is true
. el a is false
.el z is false
- @error{} warning: unbalanced 'el' request
@result{} a is false
@endExample
@@ -17333,12 +17332,12 @@ default.
@itemx 8
The closing delimiter in an escape sequence was missing or mismatched.
-@item el
-@itemx 16
-@cindex @code{ie} request, and warnings
-@cindex @code{el} request, and warnings
-The @code{el} request was encountered with no prior corresponding
-@code{ie} request. @xref{if-else}.
+@c @item el
+@c @itemx 16
+@c @cindex @code{ie} request, and warnings
+@c @cindex @code{el} request, and warnings
+@c The @code{el} request was encountered with no prior corresponding
+@c @code{ie} request. @xref{if-else}.
@item scale
@itemx 32
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index 3d81f980c..2dcbe6db0 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -548,7 +548,7 @@ _
1@2@number@11@2048@tab
2@4@break@12@4096@right\-brace
3@8@delim@13@8192@missing
-4@16@el@14@16384@input
+4@16@\fIunused\fP@14@16384@input
5@32@scale@15@32768@escape
6@64@range@16@65536@space
7@128@syntax@17@131072@font
@@ -604,13 +604,13 @@ request was invoked without an argument when there was no
current
diversion.
.
.
-.TP
-.BR el "\t16"
-The
-.B el
-request was encountered with no prior corresponding
-.B ie
-request.
+.\" .TP
+.\" .BR el "\t16"
+.\" The
+.\" .B el
+.\" request was encountered with no prior corresponding
+.\" .B ie
+.\" request.
.
.
.TP
_______________________________________________
Groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
