texinfo-commits
[Top][All Lists]
Advanced

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

branch master updated: * doc/texinfo.texi (@code{@@caption @@shortcaptio


From: Patrice Dumas
Subject: branch master updated: * doc/texinfo.texi (@code{@@caption @@shortcaption}): no multiple paragraph in @shortcaption, and document error in LaTeX with multi-paragraph @caption when there is no @shortcaption.
Date: Tue, 30 Aug 2022 10:52:52 -0400

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 adf11332c7 * doc/texinfo.texi (@code{@@caption @@shortcaption}): no 
multiple paragraph in @shortcaption, and document error in LaTeX with 
multi-paragraph @caption when there is no @shortcaption.
adf11332c7 is described below

commit adf11332c7fd3ebef2d5abe642a847c1e59e020b
Author: Patrice Dumas <pertusus@free.fr>
AuthorDate: Tue Aug 30 16:51:53 2022 +0200

    * doc/texinfo.texi (@code{@@caption @@shortcaption}): no multiple
    paragraph in @shortcaption, and document error in LaTeX with
    multi-paragraph @caption when there is no @shortcaption.
---
 ChangeLog                                   |   6 ++
 doc/texinfo.texi                            |   8 +-
 tp/t/converters_tests.t                     |   1 +
 tp/t/results/converters_tests/form_feeds.pl | 110 +++++++++++++++++++++++++++-
 4 files changed, 119 insertions(+), 6 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index d76e883ef4..e5f9f10d31 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2022-08-30  Patrice Dumas  <pertusus@free.fr>
+
+       * doc/texinfo.texi (@code{@@caption @@shortcaption}): no multiple
+       paragraph in @shortcaption, and document error in LaTeX with
+       multi-paragraph @caption when there is no @shortcaption.
+
 2022-08-30  Patrice Dumas  <pertusus@free.fr>
 
        * tp/Texinfo/Convert/Plaintext.pm (_convert),
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 5c61ab39d2..4ad7d09242 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -8035,9 +8035,11 @@ example:
 
 The text for @code{@@shortcaption} may not contain comments
 (@code{@@c}), verbatim text (@code{@@verb}), environments such as
-@code{@@example}, footnotes (@code{@@footnote}) or other complex
-constructs.  The same constraints apply to @code{@@caption} unless
-there is a @code{@@shortcaption}.
+@code{@@example}, footnotes (@code{@@footnote}), multiple paragraphs
+or other complex constructs.  The same constraints apply to
+@code{@@caption} unless there is a @code{@@shortcaption}.  In
+@LaTeX{} a multi-paragraph @code{@@caption} will lead to an error
+when formatted, unless there is a @code{@@shortcaption}.
 
 
 @node @code{@@listoffloats}
diff --git a/tp/t/converters_tests.t b/tp/t/converters_tests.t
index f9118fa44a..2b8caeaaa4 100644
--- a/tp/t/converters_tests.t
+++ b/tp/t/converters_tests.t
@@ -179,6 +179,7 @@ T
 @float
 a float
 @caption{'."\f".' within '."\f".' cation '."\f".'} '."\f".' Toto
+@shortcaption{'."\f".' shc within '."\f".' shortcaption '."\f".'} '."\f".' 
After shc
 @end float '."\f".'
 
 '],
diff --git a/tp/t/results/converters_tests/form_feeds.pl 
b/tp/t/results/converters_tests/form_feeds.pl
index 7830ca7b44..07f5dce920 100644
--- a/tp/t/results/converters_tests/form_feeds.pl
+++ b/tp/t/results/converters_tests/form_feeds.pl
@@ -845,6 +845,79 @@ $result_trees{'form_feeds'} = {
                 {
                   'parent' => {},
                   'text' => 'Toto
+'
+                }
+              ],
+              'parent' => {},
+              'type' => 'paragraph'
+            },
+            {
+              'args' => [
+                {
+                  'contents' => [
+                    {
+                      'contents' => [
+                        {
+                          'parent' => {},
+                          'text' => 'shc within '
+                        }
+                      ],
+                      'parent' => {},
+                      'type' => 'paragraph'
+                    },
+                    {
+                      'parent' => {},
+                      'text' => '',
+                      'type' => 'empty_line'
+                    },
+                    {
+                      'parent' => {},
+                      'text' => ' ',
+                      'type' => 'empty_spaces_before_paragraph'
+                    },
+                    {
+                      'contents' => [
+                        {
+                          'parent' => {},
+                          'text' => 'shortcaption '
+                        }
+                      ],
+                      'parent' => {},
+                      'type' => 'paragraph'
+                    },
+                    {
+                      'parent' => {},
+                      'text' => '',
+                      'type' => 'empty_line'
+                    }
+                  ],
+                  'parent' => {},
+                  'type' => 'brace_command_context'
+                }
+              ],
+              'cmdname' => 'shortcaption',
+              'contents' => [],
+              'extra' => {
+                'float' => {},
+                'spaces_before_argument' => ' '
+              },
+              'parent' => {},
+              'source_info' => {
+                'file_name' => '',
+                'line_nr' => 35,
+                'macro' => ''
+              }
+            },
+            {
+              'parent' => {},
+              'text' => '  ',
+              'type' => 'empty_spaces_after_close_brace'
+            },
+            {
+              'contents' => [
+                {
+                  'parent' => {},
+                  'text' => 'After shc
 '
                 }
               ],
@@ -877,7 +950,7 @@ $result_trees{'form_feeds'} = {
               'parent' => {},
               'source_info' => {
                 'file_name' => '',
-                'line_nr' => 35,
+                'line_nr' => 36,
                 'macro' => ''
               }
             }
@@ -885,6 +958,7 @@ $result_trees{'form_feeds'} = {
           'extra' => {
             'caption' => {},
             'end_command' => {},
+            'shortcaption' => {},
             'type' => {
               'normalized' => ''
             }
@@ -1051,11 +1125,25 @@ 
$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[2]{'paren
 
$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[3]{'parent'}
 = $result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29];
 
$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[4]{'contents'}[0]{'parent'}
 = $result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[4];
 
$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[4]{'parent'}
 = $result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29];
+$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[5]{'args'}[0]{'contents'}[0]{'contents'}[0]{'parent'}
 = 
$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[5]{'args'}[0]{'contents'}[0];
 
$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[5]{'args'}[0]{'contents'}[0]{'parent'}
 = 
$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[5]{'args'}[0];
+$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[5]{'args'}[0]{'contents'}[1]{'parent'}
 = 
$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[5]{'args'}[0];
+$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[5]{'args'}[0]{'contents'}[2]{'parent'}
 = 
$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[5]{'args'}[0];
+$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[5]{'args'}[0]{'contents'}[3]{'contents'}[0]{'parent'}
 = 
$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[5]{'args'}[0]{'contents'}[3];
+$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[5]{'args'}[0]{'contents'}[3]{'parent'}
 = 
$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[5]{'args'}[0];
+$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[5]{'args'}[0]{'contents'}[4]{'parent'}
 = 
$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[5]{'args'}[0];
 
$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[5]{'args'}[0]{'parent'}
 = $result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[5];
+$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[5]{'extra'}{'float'}
 = $result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29];
 
$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[5]{'parent'}
 = $result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29];
+$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[6]{'parent'}
 = $result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29];
+$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[7]{'contents'}[0]{'parent'}
 = $result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[7];
+$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[7]{'parent'}
 = $result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29];
+$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[8]{'args'}[0]{'contents'}[0]{'parent'}
 = 
$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[8]{'args'}[0];
+$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[8]{'args'}[0]{'parent'}
 = $result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[8];
+$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[8]{'parent'}
 = $result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29];
 $result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'extra'}{'caption'} 
= $result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[2];
-$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'extra'}{'end_command'}
 = $result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[5];
+$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'extra'}{'end_command'}
 = $result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[8];
+$result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'extra'}{'shortcaption'}
 = $result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'contents'}[5];
 $result_trees{'form_feeds'}{'contents'}[2]{'contents'}[29]{'parent'} = 
$result_trees{'form_feeds'}{'contents'}[2];
 $result_trees{'form_feeds'}{'contents'}[2]{'contents'}[30]{'parent'} = 
$result_trees{'form_feeds'}{'contents'}[2];
 $result_trees{'form_feeds'}{'contents'}[2]{'extra'}{'node_content'}[0] = 
$result_trees{'form_feeds'}{'contents'}[2]{'args'}[0]{'contents'}[0];
@@ -1096,6 +1184,7 @@ T
 @float
 a float
 @caption{ within  cation }  Toto
+@shortcaption{ shc within  shortcaption }  After shc
 @end float 
 
 ';
@@ -1129,6 +1218,7 @@ T
 
 a float
 Toto
+After shc
 
 ';
 
@@ -1173,6 +1263,12 @@ $result_floats{'form_feeds'} = {
             'float' => {}
           }
         },
+        'shortcaption' => {
+          'cmdname' => 'shortcaption',
+          'extra' => {
+            'float' => {}
+          }
+        },
         'type' => {
           'normalized' => ''
         }
@@ -1182,6 +1278,7 @@ $result_floats{'form_feeds'} = {
   ]
 };
 $result_floats{'form_feeds'}{''}[0]{'extra'}{'caption'}{'extra'}{'float'} = 
$result_floats{'form_feeds'}{''}[0];
+$result_floats{'form_feeds'}{''}[0]{'extra'}{'shortcaption'}{'extra'}{'float'} 
= $result_floats{'form_feeds'}{''}[0];
 
 
 $result_indices_sort_strings{'form_feeds'} = {
@@ -1220,6 +1317,7 @@ $result_converted{'plaintext'}->{'form_feeds'} = 'aa
 
 a float
 Toto
+After shc
 
 within
 
@@ -1272,6 +1370,7 @@ $result_converted{'html_text'}->{'form_feeds'} = '<a 
class="node-id" id="Top"></
 <div class="float">
 <p>a float
 </p><p>Toto
+</p><p>After shc
 </p><div class="caption"><p>within </p>&#12;<p>cation </p>&#12;</div></div>
 ';
 
@@ -1310,6 +1409,7 @@ $result_converted{'xml'}->{'form_feeds'} = '<node 
name="Top" spaces=" "><nodenam
 <float type="" endspaces=" ">
 <para>a float
 </para><caption spaces="\\f "><para>within </para>&formfeed; <para>cation 
</para>&formfeed;</caption> &formfeed; <para>Toto
+</para><shortcaption spaces="\\f "><para>shc within </para>&formfeed; 
<para>shortcaption </para>&formfeed;</shortcaption> &formfeed; <para>After shc
 </para></float> &formfeed;
 
 ';
@@ -1343,6 +1443,7 @@ $result_converted{'docbook'}->{'form_feeds'} = '<anchor 
id="first-node"/>
 </para></blockquote>
 <para>a float
 </para><para>Toto
+</para><para>After shc
 </para>
 ';
 
@@ -1396,10 +1497,13 @@ T
 
 \\begin{TexinfoFloat}
 a float
-\\caption{within \\par{}
+\\caption[shc within \\par{}
+ shortcaption \\par{}
+]{within \\par{}
  cation \\par{}
 }
 \\par{}Toto
+\\par{}After shc
 \\end{TexinfoFloat}
 
 ';



reply via email to

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