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
|
