-------------------------------------------------------------------------------
help for dotex                                                   (Roger Newson)
-------------------------------------------------------------------------------

Execute commands from a file, creating a log file in SJ LaTeX

dotex filename [ arguments ]

Description

dotex causes Stata to execute the commands stored in filename as if they were entered from the keyboard, and echos the commands as it executes them, creating a log file filename.tex in Stata Journal (SJ) LaTeX. The LaTeX log file (or parts of it) can then be included in a SJ LaTeX file (eg a SJ submission), using the SJ LaTeX stlog environment. If filename is specified without an extension, filename.do is assumed. If filename is specified with an extension, then the log file will have .log as an additional extension (so dotex will not overwrite the original do-file). Arguments are allowed (as with do), but the nostop option is not available.

Remarks

dotex is adapted from dolog, which creates a generic text log file instead of a SJ LaTeX file. dotex is similar in function to the logopen and logclose programs, which can also be used to create SJ LaTeX log files. However, dotex has the advantage that one do-file can be run with either dotex, dolog or do, creating, respectively, a SJ LaTeX log, a generic text log or no log. Further information on SJ LaTeX can be found at the SJ website.

Examples

. dotex example1

. dotex example1 argone argtwo

Author

Roger Newson, National Heart and Lung Institute, Imperial College London, UK. Email: r.newson@imperial.ac.uk

Also see

Manual: [GSM] 14 Using the do-file editor, [GSW] 14 Using the do-file editor, [U] 18 Printing and preserving output, [U] 19 Do-files, [R] do. On-line: help for log, do, run and doedit help for dolog if installed