-------------------------------------------------------------------------------
help for dolog                                                   (Roger Newson)
-------------------------------------------------------------------------------
 
Execute commands from a do-file, creating a log file

        dolog filename [ arguments ]


Description

dolog (like do) causes Stata to execute the commands stored in filename.do as
if they were entered from the keyboard, and echos the commands as it executes
them, creating a text log file filename.log.  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
dolog will not overwrite the original do-file).  Arguments are allowed (as with
do or run), but the nostop option is not available.


Remarks

The original version of dolog was apparently an example given as dofile in a
Stata NetCourse. This version is slightly improved.

Note that a do-file should nearly always start with a version statement at or
near the top. This is because, nearly always, we prefer the do-file to run in
the Stata version in which it was written, even if the version of Stata has
been upgraded. This practice also ensures that, if the do-file is run using
dolog, then it is run under its own Stata version, and not under the Stata
version of the current version of dolog.

An exception to this rule occurs when the do-file is a certification script.
For these, it is better to use the dologx package instead of dolog. To find
unofficial Stata packages which you might want to download, use net search or 
findit.


Examples

        . dolog trash1

        . dolog mycom argone argtwo


Author

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


Also see

    Manual:  [R] do, [R] doedit, [R] log, [P] version

      Help:  [R] do, [R] run, [R] doedit, [R] log, [P] version, [P] cscript;
             dologx if installed