branch master updated: * doc/texinfo.texi (@code{@@inforef}): remove examples.

[Patrice Dumas]

This is an automated email from the git hooks/post-receive script.

pertusus pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new 6b5db3b6e5 * doc/texinfo.texi (@code{@@inforef}): remove examples.
6b5db3b6e5 is described below

commit 6b5db3b6e5517cd61f61b300ab6efbc5faa31b28
Author: Patrice Dumas <pertusus@free.fr>
AuthorDate: Wed Aug 17 08:23:31 2022 +0200

    * doc/texinfo.texi (@code{@@inforef}): remove examples.
---
 ChangeLog        | 10 +++++++---
 doc/texinfo.texi | 36 +-----------------------------------
 2 files changed, 8 insertions(+), 38 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index c3a22b6482..cf6eefee41 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2022-08-17  Patrice Dumas  <pertusus@free.fr>
+
+       * doc/texinfo.texi (@code{@@inforef}): remove examples.
+
 2022-08-16  Patrice Dumas  <pertusus@free.fr>
 
        * tp/Texinfo/Convert/HTML.pm (_convert_xref_commands): remove
@@ -16,9 +20,9 @@
        with all the information on that subject being there.
 
        (Cross Reference Commands, Cross Reference Parts)
-       (Four and Five Arguments, @code{@@ref}, @code{@@pxref}): avoid naming
-       specific formats when not needed (or incorrect).  Use specific
-       format when needed.
+       (Four and Five Arguments, @code{@@ref}, @code{@@pxref}, @code{@@url})
+       (Xref Link Basics): avoid naming specific formats when not needed
+       or incorrect.  Use specific format when needed.
 
        (Four and Five Arguments): add a sentence on HTML.
        Expand on the cases of only a fourth or only a fifth argument.
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 9aca6cb089..1abf7ba64c 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -5017,7 +5017,7 @@ manuals or general web pages, keep working.
 documents---even from a printed manual.  This was originally
 used for Info files that were not generated from any Texinfo source.
 The command is now obsolete and should not be used.  In addition
-to having little use, similar formatting can be obtained with
+to having little use, similar output can be obtained with
 @code{@@xref}, @code{@@ref} or @code{@@pxref} with the Info
 file name as fourth argument and no fifth argument.
 
@@ -5042,40 +5042,6 @@ The template is:
 @@inforef@{@var{node-name}, @var{cross-reference-name}, @var{info-file-name}@}
 @end example
 
-@need 800
-@noindent
-For example,
-
-@example
-@group
-@@inforef@{Advanced, Advanced Info commands, info@},
-for more information.
-@end group
-@end example
-
-@need 800
-@noindent
-produces (in Info):
-
-@example
-@group
-*Note Advanced Info commands: (info)Advanced,
-for more information.
-@end group
-@end example
-
-@need 800
-@noindent
-and (in the printed output):
-
-@quotation
-See Info file @file{info}, node @samp{Advanced}, for more information.
-@end quotation
-
-(This particular example is not realistic, since the Info manual is
-written in Texinfo, so all formats are available.  In fact, we don't
-know of any extant Info-only manuals.)
-
 
 @node @code{@@url}
 @section @code{@@url}, @code{@@uref@{@var{url}[, @var{text}][, 
@var{replacement}]@}}