* New warnings from texinfo 7
@ 2022-11-08 9:39 Robert Pluim
2022-11-08 12:25 ` Eli Zaretskii
0 siblings, 1 reply; 3+ messages in thread
From: Robert Pluim @ 2022-11-08 9:39 UTC (permalink / raw)
To: emacs-devel
Texinfo 7 now warns about @xref and similar inside @w. The only place
this affects in our documentation is ede.texi. Any objections to the
following?
diff --git a/doc/misc/ede.texi b/doc/misc/ede.texi
index c0c2ef93d9..7a26fe0e57 100644
--- a/doc/misc/ede.texi
+++ b/doc/misc/ede.texi
@@ -1432,7 +1432,7 @@ ede-project-placeholder
@item ede-project-placeholder
@table @asis
@item Children:
-@w{@xref{ede-project}.}
+@xref{ede-project}.
@end table
@end table
@end table
@@ -1515,12 +1515,12 @@ ede-project
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-project-placeholder}.}
+@item @xref{ede-project-placeholder}.
@table @code
@item ede-project
@table @asis
@item Children:
-@w{@xref{ede-cpp-root-project},} @w{ede-emacs-project,} @w{ede-linux-project,} @w{ede-maven-project,} @w{@xref{ede-simple-project},} @w{@xref{ede-simple-base-project},} @w{@xref{ede-proj-project},} @w{@xref{project-am-makefile},} @w{@xref{ede-step-project}.}
+@xref{ede-cpp-root-project}, @w{ede-emacs-project,} @w{ede-linux-project,} @w{ede-maven-project,} @xref{ede-simple-project}, @xref{ede-simple-base-project}, @xref{ede-proj-project}, @xref{project-am-makefile}, @xref{ede-step-project}.
@end table
@end table
@end table
@@ -1801,9 +1801,9 @@ ede-cpp-root-project
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-project-placeholder}.}
+@item @xref{ede-project-placeholder}.
@table @code
-@item @w{@xref{ede-project}.}
+@item @xref{ede-project}.
@table @code
@item ede-cpp-root-project
No children
@@ -1923,9 +1923,9 @@ ede-simple-project
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-project-placeholder}.}
+@item @xref{ede-project-placeholder}.
@table @code
-@item @w{@xref{ede-project}.}
+@item @xref{ede-project}.
@table @code
@item ede-simple-project
No children
@@ -1953,9 +1953,9 @@ ede-simple-base-project
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-project-placeholder}.}
+@item @xref{ede-project-placeholder}.
@table @code
-@item @w{@xref{ede-project}.}
+@item @xref{ede-project}.
@table @code
@item ede-simple-base-project
No children
@@ -1983,9 +1983,9 @@ ede-proj-project
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-project-placeholder}.}
+@item @xref{ede-project-placeholder}.
@table @code
-@item @w{@xref{ede-project}.}
+@item @xref{ede-project}.
@table @code
@item ede-proj-project
No children
@@ -2173,9 +2173,9 @@ project-am-makefile
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-project-placeholder}.}
+@item @xref{ede-project-placeholder}.
@table @code
-@item @w{@xref{ede-project}.}
+@item @xref{ede-project}.
@table @code
@item project-am-makefile
No children
@@ -2215,9 +2215,9 @@ ede-step-project
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-project-placeholder}.}
+@item @xref{ede-project-placeholder}.
@table @code
-@item @w{@xref{ede-project}.}
+@item @xref{ede-project}.
@table @code
@item ede-step-project
No children
@@ -2371,7 +2371,7 @@ ede-target
@item ede-target
@table @asis
@item Children:
-@w{ede-cpp-root-target,} @w{ede-emacs-target-c,} @w{ede-emacs-target-el,} @w{ede-emacs-target-misc,} @w{ede-linux-target-c,} @w{ede-linux-target-misc,} @w{ede-maven-target-java,} @w{ede-maven-target-c,} @w{ede-maven-target-misc,} @w{ede-simple-target,} @w{@xref{ede-proj-target},} @w{@xref{project-am-target}.}
+@w{ede-cpp-root-target,} @w{ede-emacs-target-c,} @w{ede-emacs-target-el,} @w{ede-emacs-target-misc,} @w{ede-linux-target-c,} @w{ede-linux-target-misc,} @w{ede-maven-target-java,} @w{ede-maven-target-c,} @w{ede-maven-target-misc,} @w{ede-simple-target,} @xref{ede-proj-target}, @xref{project-am-target}.
@end table
@end table
@end table
@@ -2577,12 +2577,12 @@ ede-proj-target
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-target}.}
+@item @xref{ede-target}.
@table @code
@item ede-proj-target
@table @asis
@item Children:
-@w{@xref{ede-proj-target-makefile},} @w{ede-proj-target-aux,} @w{@xref{ede-proj-target-scheme}.}
+@xref{ede-proj-target-makefile}, @w{ede-proj-target-aux,} @xref{ede-proj-target-scheme}.
@end table
@end table
@end table
@@ -2766,14 +2766,14 @@ ede-proj-target-makefile
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-target}.}
+@item @xref{ede-target}.
@table @code
-@item @w{@xref{ede-proj-target}.}
+@item @xref{ede-proj-target}.
@table @code
@item ede-proj-target-makefile
@table @asis
@item Children:
-@w{@xref{semantic-ede-proj-target-grammar},} @w{@xref{ede-proj-target-makefile-objectcode},} @w{@xref{ede-proj-target-elisp},} @w{@xref{ede-proj-target-makefile-miscelaneous},} @w{@xref{ede-proj-target-makefile-info}.}
+@xref{semantic-ede-proj-target-grammar}, @xref{ede-proj-target-makefile-objectcode}, @xref{ede-proj-target-elisp}, @xref{ede-proj-target-makefile-miscelaneous}, @xref{ede-proj-target-makefile-info}.
@end table
@end table
@end table
@@ -2864,11 +2864,11 @@ semantic-ede-proj-target-grammar
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-target}.}
+@item @xref{ede-target}.
@table @code
-@item @w{@xref{ede-proj-target}.}
+@item @xref{ede-proj-target}.
@table @code
-@item @w{@xref{ede-proj-target-makefile}.}
+@item @xref{ede-proj-target-makefile}.
@table @code
@item semantic-ede-proj-target-grammar
No children
@@ -2918,16 +2918,16 @@ ede-proj-target-makefile-objectcode
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-target}.}
+@item @xref{ede-target}.
@table @code
-@item @w{@xref{ede-proj-target}.}
+@item @xref{ede-proj-target}.
@table @code
-@item @w{@xref{ede-proj-target-makefile}.}
+@item @xref{ede-proj-target-makefile}.
@table @code
@item ede-proj-target-makefile-objectcode
@table @asis
@item Children:
-@w{@xref{ede-proj-target-makefile-archive},} @w{@xref{ede-proj-target-makefile-program}.}
+@xref{ede-proj-target-makefile-archive}, @xref{ede-proj-target-makefile-program}.
@end table
@end table
@end table
@@ -2980,13 +2980,13 @@ ede-proj-target-makefile-archive
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-target}.}
+@item @xref{ede-target}.
@table @code
-@item @w{@xref{ede-proj-target}.}
+@item @xref{ede-proj-target}.
@table @code
-@item @w{@xref{ede-proj-target-makefile}.}
+@item @xref{ede-proj-target-makefile}.
@table @code
-@item @w{@xref{ede-proj-target-makefile-objectcode}.}
+@item @xref{ede-proj-target-makefile-objectcode}.
@table @code
@item ede-proj-target-makefile-archive
No children
@@ -3023,18 +3023,18 @@ ede-proj-target-makefile-program
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-target}.}
+@item @xref{ede-target}.
@table @code
-@item @w{@xref{ede-proj-target}.}
+@item @xref{ede-proj-target}.
@table @code
-@item @w{@xref{ede-proj-target-makefile}.}
+@item @xref{ede-proj-target-makefile}.
@table @code
-@item @w{@xref{ede-proj-target-makefile-objectcode}.}
+@item @xref{ede-proj-target-makefile-objectcode}.
@table @code
@item ede-proj-target-makefile-program
@table @asis
@item Children:
-@w{@xref{ede-proj-target-makefile-shared-object}.}
+@xref{ede-proj-target-makefile-shared-object}.
@end table
@end table
@end table
@@ -3102,15 +3102,15 @@ ede-proj-target-makefile-shared-object
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-target}.}
+@item @xref{ede-target}.
@table @code
-@item @w{@xref{ede-proj-target}.}
+@item @xref{ede-proj-target}.
@table @code
-@item @w{@xref{ede-proj-target-makefile}.}
+@item @xref{ede-proj-target-makefile}.
@table @code
-@item @w{@xref{ede-proj-target-makefile-objectcode}.}
+@item @xref{ede-proj-target-makefile-objectcode}.
@table @code
-@item @w{@xref{ede-proj-target-makefile-program}.}
+@item @xref{ede-proj-target-makefile-program}.
@table @code
@item ede-proj-target-makefile-shared-object
No children
@@ -3162,16 +3162,16 @@ ede-proj-target-elisp
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-target}.}
+@item @xref{ede-target}.
@table @code
-@item @w{@xref{ede-proj-target}.}
+@item @xref{ede-proj-target}.
@table @code
-@item @w{@xref{ede-proj-target-makefile}.}
+@item @xref{ede-proj-target-makefile}.
@table @code
@item ede-proj-target-elisp
@table @asis
@item Children:
-@w{@xref{ede-proj-target-elisp-autoloads}.}
+@xref{ede-proj-target-elisp-autoloads}.
@end table
@end table
@end table
@@ -3238,13 +3238,13 @@ ede-proj-target-elisp-autoloads
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-target}.}
+@item @xref{ede-target}.
@table @code
-@item @w{@xref{ede-proj-target}.}
+@item @xref{ede-proj-target}.
@table @code
-@item @w{@xref{ede-proj-target-makefile}.}
+@item @xref{ede-proj-target-makefile}.
@table @code
-@item @w{@xref{ede-proj-target-elisp}.}
+@item @xref{ede-proj-target-elisp}.
@table @code
@item ede-proj-target-elisp-autoloads
No children
@@ -3353,11 +3353,11 @@ ede-proj-target-makefile-miscelaneous
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-target}.}
+@item @xref{ede-target}.
@table @code
-@item @w{@xref{ede-proj-target}.}
+@item @xref{ede-proj-target}.
@table @code
-@item @w{@xref{ede-proj-target-makefile}.}
+@item @xref{ede-proj-target-makefile}.
@table @code
@item ede-proj-target-makefile-miscelaneous
No children
@@ -3409,11 +3409,11 @@ ede-proj-target-makefile-info
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-target}.}
+@item @xref{ede-target}.
@table @code
-@item @w{@xref{ede-proj-target}.}
+@item @xref{ede-proj-target}.
@table @code
-@item @w{@xref{ede-proj-target-makefile}.}
+@item @xref{ede-proj-target-makefile}.
@table @code
@item ede-proj-target-makefile-info
No children
@@ -3495,9 +3495,9 @@ ede-proj-target-scheme
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-target}.}
+@item @xref{ede-target}.
@table @code
-@item @w{@xref{ede-proj-target}.}
+@item @xref{ede-proj-target}.
@table @code
@item ede-proj-target-scheme
No children
@@ -3539,12 +3539,12 @@ project-am-target
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-target}.}
+@item @xref{ede-target}.
@table @code
@item project-am-target
@table @asis
@item Children:
-@w{@xref{project-am-objectcode},} @w{project-am-header,} @w{@xref{project-am-lisp},} @w{@xref{project-am-texinfo},} @w{@xref{project-am-man}.}
+@xref{project-am-objectcode}, @w{project-am-header,} @xref{project-am-lisp}, @xref{project-am-texinfo}, @xref{project-am-man}.
@end table
@end table
@end table
@@ -3577,14 +3577,14 @@ project-am-objectcode
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-target}.}
+@item @xref{ede-target}.
@table @code
-@item @w{@xref{project-am-target}.}
+@item @xref{project-am-target}.
@table @code
@item project-am-objectcode
@table @asis
@item Children:
-@w{@xref{project-am-program},} @w{project-am-lib.}
+@xref{project-am-program}, @w{project-am-lib.}
@end table
@end table
@end table
@@ -3622,11 +3622,11 @@ project-am-program
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-target}.}
+@item @xref{ede-target}.
@table @code
-@item @w{@xref{project-am-target}.}
+@item @xref{project-am-target}.
@table @code
-@item @w{@xref{project-am-objectcode}.}
+@item @xref{project-am-objectcode}.
@table @code
@item project-am-program
No children
@@ -3660,9 +3660,9 @@ project-am-header-noinst
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-target}.}
+@item @xref{ede-target}.
@table @code
-@item @w{@xref{project-am-target}.}
+@item @xref{project-am-target}.
@table @code
@item @w{project-am-header.}
@table @code
@@ -3693,9 +3693,9 @@ project-am-header-inst
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-target}.}
+@item @xref{ede-target}.
@table @code
-@item @w{@xref{project-am-target}.}
+@item @xref{project-am-target}.
@table @code
@item @w{project-am-header.}
@table @code
@@ -3726,9 +3726,9 @@ project-am-lisp
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-target}.}
+@item @xref{ede-target}.
@table @code
-@item @w{@xref{project-am-target}.}
+@item @xref{project-am-target}.
@table @code
@item project-am-lisp
No children
@@ -3756,9 +3756,9 @@ project-am-texinfo
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-target}.}
+@item @xref{ede-target}.
@table @code
-@item @w{@xref{project-am-target}.}
+@item @xref{project-am-target}.
@table @code
@item project-am-texinfo
No children
@@ -3808,9 +3808,9 @@ project-am-man
@table @code
@item eieio-speedbar-directory-button
@table @code
-@item @w{@xref{ede-target}.}
+@item @xref{ede-target}.
@table @code
-@item @w{@xref{project-am-target}.}
+@item @xref{project-am-target}.
@table @code
@item project-am-man
No children
@@ -3963,7 +3963,7 @@ ede-compilation-program
@item ede-compilation-program
@table @asis
@item Children:
-@w{@xref{ede-compiler},} @w{@xref{ede-linker}.}
+@xref{ede-compiler}, @xref{ede-linker}.
@end table
@end table
@end table
@@ -4071,12 +4071,12 @@ ede-compiler
@table @code
@item eieio-instance-inheritor
@table @code
-@item @w{@xref{ede-compilation-program}.}
+@item @xref{ede-compilation-program}.
@table @code
@item ede-compiler
@table @asis
@item Children:
-@w{@xref{ede-object-compiler},} @w{semantic-ede-grammar-compiler-class.}
+@xref{ede-object-compiler}, @w{semantic-ede-grammar-compiler-class.}
@end table
@end table
@@ -4179,9 +4179,9 @@ ede-object-compiler
@table @code
@item eieio-instance-inheritor
@table @code
-@item @w{@xref{ede-compilation-program}.}
+@item @xref{ede-compilation-program}.
@table @code
-@item @w{@xref{ede-compiler}.}
+@item @xref{ede-compiler}.
@table @code
@item ede-object-compiler
No children
@@ -4222,7 +4222,7 @@ ede-linker
@table @code
@item eieio-instance-inheritor
@table @code
-@item @w{@xref{ede-compilation-program}.}
+@item @xref{ede-compilation-program}.
@table @code
@item ede-linker
No children
^ permalink raw reply related [flat|nested] 3+ messages in thread
* Re: New warnings from texinfo 7
2022-11-08 9:39 New warnings from texinfo 7 Robert Pluim
@ 2022-11-08 12:25 ` Eli Zaretskii
2022-11-08 13:19 ` Robert Pluim
0 siblings, 1 reply; 3+ messages in thread
From: Eli Zaretskii @ 2022-11-08 12:25 UTC (permalink / raw)
To: Robert Pluim; +Cc: emacs-devel
> From: Robert Pluim <rpluim@gmail.com>
> Date: Tue, 08 Nov 2022 10:39:53 +0100
>
>
> Texinfo 7 now warns about @xref and similar inside @w. The only place
> this affects in our documentation is ede.texi. Any objections to the
> following?
None. They were mistakes to begin with, AFAIU.
Thanks.
P.S. Btw, making the text of an @item be @xref is bad Texinfo style,
it only looks good in the HTML output.
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: New warnings from texinfo 7
2022-11-08 12:25 ` Eli Zaretskii
@ 2022-11-08 13:19 ` Robert Pluim
0 siblings, 0 replies; 3+ messages in thread
From: Robert Pluim @ 2022-11-08 13:19 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: emacs-devel
>>>>> On Tue, 08 Nov 2022 14:25:26 +0200, Eli Zaretskii <eliz@gnu.org> said:
>> From: Robert Pluim <rpluim@gmail.com>
>> Date: Tue, 08 Nov 2022 10:39:53 +0100
>>
>>
>> Texinfo 7 now warns about @xref and similar inside @w. The only place
>> this affects in our documentation is ede.texi. Any objections to the
>> following?
Eli> None. They were mistakes to begin with, AFAIU.
OK, pushed
Eli> Thanks.
Eli> P.S. Btw, making the text of an @item be @xref is bad Texinfo style,
Eli> it only looks good in the HTML output.
I didnʼt know that. Fixing that looks like a bigger job.
Robert
--
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2022-11-08 13:19 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-11-08 9:39 New warnings from texinfo 7 Robert Pluim
2022-11-08 12:25 ` Eli Zaretskii
2022-11-08 13:19 ` Robert Pluim
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).