{smcl}
{.-}
help for {cmd:dotex} {right:(Roger Newson)}
{.-}


{title:Execute commands from a file, creating a log file in SJ LaTeX}

{p 8 27}
{cmd:dotex} {it:filename} [ {it:arguments} ] [ {cmd:,} {opt nostop} ]


{title:Description}

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


{title:Options}

{phang}
{opt nostop} allows the do-file to continue executing even if an error occurs.
Normally, Stata stops executing the do-file when it detects an error
(nonzero return code).


{title:Remarks}

{pstd}
{cmd:dotex} is adapted from  {helpb dolog}, which creates a generic text log file
instead of a SJ LaTeX file.
One do-file can be run
with either {cmd:dotex}, {helpb dolog} or {helpb do},
creating, respectively, a SJ LaTeX log, a generic text log or no log.
Further information on SJ LaTeX can be found at the
{browse "http://www.stata-journal.com/":SJ website}.
Note that it is usually sensible to include a {helpb version} statement
at the start of a do-file to be executed by {helpb do}, {helpb dolog} or {cmd:dotex},
so that the do-file will be executed in the {help version:Stata version} specified,
instead of being executed by the {help version:Stata version}
of the current version of Stata, {helpb dolog} or {cmd:dotex}.

{pstd}
{cmd:dotex} is similar to the {helpb sjlog:sjlog do} command of official Stata.
Both of these commands work by creating an intermediate {help smcl:SMCL} log file,
and then creating a version of this intermediate file translated to {help sjlatex:SJ LaTeX}.
However, {cmd:dotex} does not save the intermediate {help smcl:SMCL} log file,
and does report the date and time when this intermediate log file was opened and closed.

{pstd}
{cmd:dotex} works under {help version:version control}. As in:

{p 8 16}{inp:. version 15: dotex example1}{p_end}

{pstd}
However, for most do-files other than {help cscript:certification scripts},
it is a good idea to set the Stata version using a {helpb version} statement
inside the do-file to be executed using {cmd:dotex}.


{title:Examples}

{p 8 16}{inp:. dotex example1}{p_end}

{p 8 16}{inp:. dotex example1 argone argtwo}{p_end}


{title:Author}

{p}
Roger Newson, King's College London, UK.{break}
Email: {browse "mailto:roger.newson@kcl.ac.uk":roger.newson@kcl.ac.uk}


{title:Also see}

{psee}
Manual:  {manlink R do}, {manlink R doedit}, {manlink R log}, {manlink P version}, {manlink P smcl}
{p_end}

{psee}
{space 2}Help:  {helpb sjlatex}, {helpb sjlog}, {manhelp do R}, {manhelp run R}, {manhelp doedit R}, {manhelp log R}, {manhelp version P}, {manhelp smcl P};
{break}
{helpb dolog} if installed
{p_end}