[Vim-latex-cvs] vimfiles/doc latex-suite.xml,1.29,1.30 latex-suite.txt,1.50,1.51

[<sri...@us...>]

Update of /cvsroot/vim-latex/vimfiles/doc
In directory sc8-pr-cvs1:/tmp/cvs-serv31767

Modified Files:
	latex-suite.xml latex-suite.txt 
Log Message:


Index: latex-suite.xml
===================================================================
RCS file: /cvsroot/vim-latex/vimfiles/doc/latex-suite.xml,v
retrieving revision 1.29
retrieving revision 1.30
diff -C2 -d -r1.29 -r1.30
*** latex-suite.xml	2 Dec 2003 11:42:41 -0000	1.29
--- latex-suite.xml	2 Dec 2003 12:00:21 -0000	1.30
***************
*** 2236,2241 ****
       This entry defines which commands will be folded. It is a comma
       seperated string of words each of which defines a single command.
!      The defualt setting is
!      <programlisting>footnote,intertext</programlisting>
       The words need not be standard Latex commands. You can use whatever
       words you like. Each word will fold all commands whose name begins
--- 2236,2240 ----
       This entry defines which commands will be folded. It is a comma
       seperated string of words each of which defines a single command.
!      The default setting is empty, i.e no commands are folded.
       The words need not be standard Latex commands. You can use whatever
       words you like. Each word will fold all commands whose name begins
***************
*** 2244,2247 ****
--- 2243,2268 ----
       variable.
      </para>
+     <note>
+      <para>
+       It is very difficult to fold commands reliably because it is very
+       difficult to create a regexp which will match a line containing
+       unmatched parentheses (or curly brackets), but will not match a line
+       containing matched parentheses.
+      </para>
+      <para>
+       Just to make things safer, only lines which start a command but do
+       not contain additional curly braces after the command has started are
+       folded. In other words, if you wanted to fold the the command
+       <literal>"mycommand"</literal>, then the  lines
+       <programlisting>\mycommand{This is a line
+ and some more text on the next line
+ }</programlisting>
+       will be folded, but the lines
+       <programlisting>\mycommand{This is a \textbf{line}
+ and some more text
+ }</programlisting>
+       will not be folded. This is a bug which is very difficult to fix.
+      </para>
+     </note>
      <para>
       See also <link linkend="fold-setting-advanced">advanced fold

Index: latex-suite.txt
===================================================================
RCS file: /cvsroot/vim-latex/vimfiles/doc/latex-suite.txt,v
retrieving revision 1.50
retrieving revision 1.51
diff -C2 -d -r1.50 -r1.51
*** latex-suite.txt	2 Dec 2003 11:42:41 -0000	1.50
--- latex-suite.txt	2 Dec 2003 12:00:22 -0000	1.51
***************
*** 1835,1844 ****
  
  This entry defines which commands will be folded. It is a comma seperated string
! of words each of which defines a single command. The defualt setting is  >
!     footnote,intertext
! The words need not be standard Latex commands. You can use whatever words you
! like. Each word will fold all commands whose name begins with that word as in
! the case of the Tex_FoldedEnvironments [|ls_a_ci|] variable.
  
  See also advanced fold settings [|ls_a_cl|].
  
--- 1835,1863 ----
  
  This entry defines which commands will be folded. It is a comma seperated string
! of words each of which defines a single command. The defualt setting is empty,
! i.e no commands are folded. The words need not be standard Latex commands. You
! can use whatever words you like. Each word will fold all commands whose name
! begins with that word as in the case of the Tex_FoldedEnvironments [|ls_a_ci|]
! variable.
  
+ NOTE: It is very difficult to fold commands reliably because it is very
+       difficult to create a regexp which will match a line containing unmatched
+       parentheses (or curly brackets), but will not match a line containing
+       matched parentheses.
+       
+       Just to make things safer, only lines which start a command but do not
+       contain additional curly braces after the command has started are folded.
+       In other words, if you wanted to fold the the command "mycommand", then
+       the lines  >
+           \mycommand{This is a line
+           and some more text on the next line
+           }
+ <     will be folded, but the lines  >
+           \mycommand{This is a \textbf{line}
+           and some more text
+           }
+ <     will not be folded. This is a bug which is very difficult to fix.
+       
+       
  See also advanced fold settings [|ls_a_cl|].