texinfo-commits
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

branch master updated: * doc/texinfo.texi (@verbatim): Use @example envi


From: Gavin D. Smith
Subject: branch master updated: * doc/texinfo.texi (@verbatim): Use @example environment for examples rather than @exdent with @t. Put actual tab characters in the output for the example as was shown.
Date: Sun, 04 Sep 2022 08:43:07 -0400

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

gavin pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new 9988bfe25d * doc/texinfo.texi (@verbatim): Use @example environment 
for examples rather than @exdent with @t.  Put actual tab characters in the 
output for the example as was shown.
9988bfe25d is described below

commit 9988bfe25de08701336039dade61f0915ee0a271
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Sun Sep 4 13:40:59 2022 +0100

    * doc/texinfo.texi (@verbatim): Use @example environment for
    examples rather than @exdent with @t.  Put actual tab characters
    in the output for the example as was shown.
---
 ChangeLog        |  6 ++++++
 doc/texinfo.texi | 32 +++++++++++++++-----------------
 2 files changed, 21 insertions(+), 17 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 6eeae48d36..1565e74289 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2022-09-04  Gavin Smith  <gavinsmith0123@gmail.com>
+
+       * doc/texinfo.texi (@verbatim): Use @example environment for
+       examples rather than @exdent with @t.  Put actual tab characters
+       in the output for the example as was shown.
+
 2022-09-04  Patrice Dumas  <pertusus@free.fr>
 
        * doc/texinfo.texi (Advanced Indexing): index entries should not
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index b91b498af3..8cb5675196 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -6717,23 +6717,22 @@ at the beginning of a line by itself.  The @code{@@end 
verbatim} will
 also disappear from the output.
 
 For example:
-@c oops, got to trick this a bit: can't use @end verbatim inside @verbatim
 
 @example
-@exdent @t{@@verbatim}
-@exdent @t{@{}
-@exdent @key{TAB}@t{@@command with strange characters: @@'e}
-@exdent @t{expand@key{TAB}me}
-@exdent @t{@}}
-@exdent @t{@@end verbatim}
+@@verbatim
+@{
+@var{[tab]}@@command with strange characters: @@'e
+expand@var{[tab]}me
+@}
+@@end verbatim
 @end example
 
 @noindent
-This produces:
+(where @var{[tab]} stands for a literal tab character).  This produces:
 
 @verbatim
 {
-        @command with strange characters: @'e
+       @command with strange characters: @'e
 expand me
 }
 @end verbatim
@@ -6749,14 +6748,13 @@ the ending @code{@@end verbatim} will appear in the 
output.
 You can get a ``small'' verbatim by enclosing the @code{@@verbatim} in
 an @code{@@smallformat} environment, as shown here:
 
-@c more cheating ...
-@smallexample
-@exdent @t{@@smallformat}
-@exdent @t{@@verbatim}
-@exdent @t{... still verbatim, but in a smaller font ...}
-@exdent @t{@@end verbatim}
-@exdent @t{@@end smallformat}
-@end smallexample
+@example
+@@smallformat
+@@verbatim
+... still verbatim, but in a smaller font ...
+@@end verbatim
+@@end smallformat
+@end example
 
 Finally, a word of warning: it is not reliable to use
 @code{@@verbatim} inside other Texinfo constructs.



reply via email to

[Prev in Thread] Current Thread [Next in Thread]