<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"> 

<refentry>

  <refmeta> 
    <refentrytitle>rlatex</refentrytitle> 
    <manvolnum>1</manvolnum> 
    <refmiscinfo>Alcove documentation tool-chain</refmiscinfo> 
  </refmeta> 

  <refnamediv>
    <refname>rlatex</refname>
    <refpurpose>Wrapper to run LaTeX/jadeTeX multiple times as needed</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis>
      <group choice="opt">
	<arg>env <arg choice="req">LATEXPRG=<replaceable>latex-binary</></arg></arg>
      </group>
      <command>rlatex</command>
      <arg><replaceable>latex-document</></arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>Description</title>

    <para><command>rlatex</> applies LaTeX or another LaTeX-based
    macro package (most notably jadetex, pdflatex, or pdfjadetex) to a
    given document, as many successive times as needed.</para>

    <para>It checks the output of a LaTeX pass, and launches a new
    pass when it notices specific strings which notify that the
    document's processing has not been finished.</para>
  </refsect1>

  <refsect1>
    <title>Caveats</title>

    <para>This version is mostly tuned for jadetex, and may cause some
    problems when using pure LaTeX.  This ought to be fixed some
    day.</para>
  </refsect1>


  <refsect1> 
    <title>Copyright</title> 
 
    <para>Copyright &copy; 2001-2003 Alcove &amp; Yann Dirson.</para> 
 
    <para>This <application>rlatex</> is licensed under the GNU
    General Public License, version 2.</para>
  
    <para>It is heavily derived from the <command>doc/rlatex</> script
    in the LILO source package, which is distributed under a BSD
    license.  The original script does not mention its original
    author.</para>

    <para>This documentation is licensed under the GNU Free 
    Documentation License, version 1.</para> 
  </refsect1> 

  <refsect1> 
    <title>Contact us</title> 
 
    <para><command>rlatex</> is part of the <application>sgml2x</>
    package, which is part of the <ulink
    url="http://www.alcove-labs.org/en/software/alcovebook/">AlcoveBook
    project</>.  Please use the <ulink
    url="https://savannah.gnu.org/mail/?group_id=533">AlcoveBook
    mailing lists</> to get in touch with developers and users.</para>
 
    <para>The list of bugs and feature requests is available <ulink 
    url="https://savannah.gnu.org/support/?group_id=533">through a Web 
    interface</>.  Please use it to submit problems and ideas.</para> 
  </refsect1> 

  <refsect1> 
    <title>See also</title> 
     
    <para><citerefentry> <refentrytitle>jadetex</> <manvolnum>1</>
    </citerefentry>, <citerefentry> <refentrytitle>pdfjadetex</>
    <manvolnum>1</> </citerefentry>, <citerefentry>
    <refentrytitle>latex</> <manvolnum>1</> </citerefentry>,
    <citerefentry> <refentrytitle>pdflatex</> <manvolnum>1</>
    </citerefentry>.</para>
  </refsect1>
</refentry>
