help ltex
-------------------------------------------------------------------------------

Title

    Featured list of LaTeX files in the working directory

Syntax
        ltex [ stub ] , erase

    where stub may be a single letter or any combination of characters that
    can be used for filenames.

Description

    ltex returns a list of LaTex files that are stored in the working
    directory. If stub is specified, only files with names containing stub
    are listed. Along with the file names, the programs offer a list of
    click-able links for some typical tasks that one wants to do for LaTeX
    files.

    Specifically, ltex provides links for viewing, editing, and typesetting
    each of the LaTeX files in the working directory.

    By default, the Stata do-file editor is invoked when clicking the
    edit-item of the ltex-output. However, you can use a different editor by
    setting the global macro "MYEDITOR" to the command that opens your
    preferred text editor. I, for example, have the line

        ------------------- profile.do
        global MYEDITOR !emacsclient -n
        -------------------------------

    in my profile file, which works under Linux. Windows users might prefer
    something along the following lines

        -------------------- profile.do
        global MYEDITOR winexec textpad
        -------------------------------

    Note that setting the macro MYEDITOR also affects the editor used to open
    do-files with ldo.

    Typesetting the LaTeX-file is done with the pdflatex, which produces PDF
    output. After typesetting, the created file is opened immediately.
    Typesetting requires that LaTeX is installed properly on your computer.
    Opening the created PDF requires that a previewer for PDF files is
    installed on the computer. By default, acrobat reader is assumed as
    previewer, but this can be changed by setting the global macro
    "MYPDFVIEWER". I, for example have the

        ------------------- profile.do
        global MYPDFVIEWER xpdf
        -------------------------------

    in my profile file.


Technical note

    LaTeX files produced by Stata are often incomplete in the sense that they
    don't have a preamble. Before typesetting ltex therefore looks in the
    first 30 rows of the file whether there is a preamble or not. If not,
    ltex tries to run the file with a minimal preamble. This works sometimes,
    but sometimes not.

Options

    erase brings up yet another click-able item which allows to erase files
        on disk. Clicking on that item removes the respective file
        immediately from the disk. The file is not moved to the recycle bin.
        The erase button is printed in red to indicate that it should be
        handled with care.


Example

        . ltex

Author

    Ulrich Kohler, kohler@wzb.eu

Also see

    Online: ldta, cdout, clickout, fastcd (if installed)