= Stata Log =

'''`-log-`''' wraps logging facilities.

----



== Usage ==

{{{
log using "path/to/file"
log close
}}}

Stata's rich log format uses the `.smcl` file extension.

If the '''`text`''' option is specified, or if the file extension is one of `.log` or `.txt`, then a plaintext log will instead be created.



=== Temporarily Disabling Logging ===

Some output should not be recorded. Try:

{{{
log off
display "Rather than running commands quietly, temporarily turn off logging.
log on
}}}

----



== Stored Results ==

`-log-` stores the following details:

 * log name in `r(name)`
 * log filename in `r(filename)`
 * logging status (on or off) in `r(status)`
 * log type (smcl or text) in `r(type)`

`log query _all` stores the number of open logs in `r(numlogs)`. For each open log, it stores the above details as e.g. `r(name1)`, `r(name2)`, and so on.

----



== See also ==

[[https://www.stata.com/manuals/rlog.pdf|Stata manual for -log-]]

[[https://www.stata.com/manuals/u15.pdf|Stata manual chapter 15: Saving and printing output-log files]]



----
CategoryRicottone