-------------------------------------------------------------------------------
help for cleanlog                                         version 1.5 25mar2010
-------------------------------------------------------------------------------

Cleans command syntxax out of log files

cleanlog using logfilename , saving(outputfilename) [replace noheader]

Description

cleanlog takes a plain text or SMCL log file as input and writes a new log file cleaned of all command syntax. It also removes some extraneous material such as the lines of dots sometimes displayed for entertainment purposes. It also optionally removes the log "headers". Note that if cleanlog does not remove all of the extraneous material you might like it to, some commands, like bootstrap, have their own options for reducing the amount of output they produce.

Options

saving(outputfilename) specifies the name of the cleaned log file to be written. This is a required option. replace allows the user to overwrite a previous cleaned log. It does not overwrite the original uncleaned log.

noheader removes the "headers" (i.e., the log file path, type and date) created in the log file by the log command.

Examples

. cleanlog using test.log, s(test_clean.log)

. cleanlog using test.smcl, s(test_clean.smcl)

Author

Lee E. Sieswerda Thunder Bay District Health Unit Lee.Sieswerda@tbdhu.com

Acknowledgements

Nicholas J. Cox made significant improvements to the code. Richard Tucker suggested the addition of the noheader option. Ronnie Babigumira noticed a flaw wherein numbered lines were inappropriately deleted.