[Vim-latex-cvs] vimfiles/doc latex-suite.xml,1.14,1.15 latex-suite.txt,1.37,1.38

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

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

Modified Files:
	latex-suite.xml latex-suite.txt 
Log Message:
- resync the multiple compilation documentation with the current algorithm.


Index: latex-suite.xml
===================================================================
RCS file: /cvsroot/vim-latex/vimfiles/doc/latex-suite.xml,v
retrieving revision 1.14
retrieving revision 1.15
diff -C2 -d -r1.14 -r1.15
*** latex-suite.xml	29 Aug 2003 03:44:34 -0000	1.14
--- latex-suite.xml	31 Aug 2003 09:20:36 -0000	1.15
***************
*** 1807,1829 ****
     <para>
      <orderedlist>
!      <listitem>First <literal>latex</literal> is run.</listitem>
!      <listitem>If the <literal>.aux</literal> file generated from the first
!       step above contains a <literal>\bibdata</literal> line, then it
!       means that we are using a <literal>.bib</literal> file. Therefore,
!       &ls; runs <literal>bibtex</literal>.</listitem>
       <listitem>
!       If the <literal>.bbl</literal> file changes because of this, then we
!       note that we need to rerun &latex; again.
       </listitem>
-      <listitem>If running latex generates a <literal>.idx</literal> file,
-       then we run <literal>makeindex</literal>. If the
-       <literal>.idx</literal> file is changed by
-       <literal>makeindex</literal>, then we note that we need to rerun
-       latex.</listitem>
       <listitem>Also, we check to see if the &latex; compiler gives certain
        standard warnings which notify that we need to compile once again. In
!       this case also, we note that we need to rerun &latex;.</listitem>
!      <listitem>If we found that we needed to rerun latex, then we repeat
!       the steps above.</listitem>
      </orderedlist>
     </para>
--- 1807,1845 ----
     <para>
      <orderedlist>
!      <listitem>If there was a <literal>.idx</literal> file, then remember
!       its contents.</listitem>
!      <listitem>Run <literal>latex</literal>.</listitem>
!      <listitem>If the <literal>.idx</literal> file changed due to the latex
!       compiler, then run <literal>makeindex</literal> to redo the
!       <literal>.ind</literal> file and then remember to rerun latex.
!      </listitem>
       <listitem>
!       <para>
!        If the <literal>.aux</literal> file generated by the latex
!        compiler contains a <literal>\bibdata</literal> line, then it
!        means that we are using a <literal>.bib</literal> file. Therefore,
!        run <literal>bibtex</literal>.
!       </para>
!       <note>
!        <para>
!         This means that we will always run <literal>bibtex</literal>
!         whenever we use the <literal>\bibliography</literal> command
!         whether or not we actually need to. At this time, &ls; does not
!         parse the <literal>.aux</literal> file before and after the latex
!         compiler to see if we are required to rerun
!         <literal>bibtex</literal>.
!        </para>
!       </note>
!      </listitem>
!      <listitem>
!       If the <literal>.bbl</literal> file changes because of this, then
!       remember to rerun latex again.
       </listitem>
       <listitem>Also, we check to see if the &latex; compiler gives certain
        standard warnings which notify that we need to compile once again. In
!       this case also, remember to rerun &latex;.</listitem>
!      <listitem>If we found we had to rerun latex, then we repeat
!       the steps above but not running <literal>makeindex</literal> or
!       <literal>bibtex</literal> again.</listitem>
      </orderedlist>
     </para>

Index: latex-suite.txt
===================================================================
RCS file: /cvsroot/vim-latex/vimfiles/doc/latex-suite.txt,v
retrieving revision 1.37
retrieving revision 1.38
diff -C2 -d -r1.37 -r1.38
*** latex-suite.txt	29 Aug 2003 03:44:34 -0000	1.37
--- latex-suite.txt	31 Aug 2003 09:20:36 -0000	1.38
***************
*** 1475,1495 ****
  be some other compiler such as pdflatex for generating pdf output.
  
! 1. First latex is run.
  
! 2. If the .aux file generated from the first step above contains a \bibdata
!    line, then it means that we are using a .bib file. Therefore, Latex-Suite
!    runs bibtex.
  
! 3. If the .bbl file changes because of this, then we note that we need to rerun
!    LaTeX again.
  
! 4. If running latex generates a .idx file, then we run makeindex. If the .idx
!    file is changed by makeindex, then we note that we need to rerun latex.
  
! 5. Also, we check to see if the LaTeX compiler gives certain standard warnings
!    which notify that we need to compile once again. In this case also, we note
!    that we need to rerun LaTeX.
  
! 6. If we found that we needed to rerun latex, then we repeat the steps above.
  
  The LaTeX file is compiled atmost 5 times using this logic. These steps will
--- 1475,1501 ----
  be some other compiler such as pdflatex for generating pdf output.
  
! 1. If there was a .idx file, then remember its contents.
  
! 2. Run latex.
  
! 3. If the .idx file changed due to the latex compiler, then run makeindex to
!    redo the .ind file and then remember to rerun latex.
  
! 4. If the .aux file generated by the latex compiler contains a \bibdata line,
!    then it means that we are using a .bib file. Therefore, run bibtex.
!    
!    NOTE: This means that we will always run bibtex whenever we use the
!          \bibliography command whether or not we actually need to. At this time,
!          Latex-Suite does not parse the .aux file before and after the latex
!          compiler to see if we are required to rerun bibtex.
  
! 5. If the .bbl file changes because of this, then remember to rerun latex again.
  
! 6. Also, we check to see if the LaTeX compiler gives certain standard warnings
!    which notify that we need to compile once again. In this case also, remember
!    to rerun LaTeX.
! 
! 7. If we found we had to rerun latex, then we repeat the steps above but not
!    running makeindex or bibtex again.
  
  The LaTeX file is compiled atmost 5 times using this logic. These steps will