-------------------------------------------------------------------------------
help for witch                                    Version 1.0.1, T. J. Steichen
-------------------------------------------------------------------------------

Display location and version of all ado-related files

witch fname[.ftype] [, noall noalltypes]

Description

witch is a more comprehensive version of the Stata-supplied command which. Like which, it looks for file fname.ftype along the S_ADO path. Unlike which, it reports the location of all files matching fname.ftype found along the search path, not just the first one.

Further, if ".ftype" is omitted, witch automatically searches along the ado-path for fname with all .ftype's .ado, .hlp, .dlg, .idlg, .class, .scheme, and .style. (which would search only for fname.ado.)

If Stata is unable to find fname.ftype as any of the above filetypes, the message "file fname.* not found along adopath" is displayed and the return code set to 111.

If any files are found, witch displays the full path and filename along with, if the file is ASCII, all lines in the file that begin with "*!" in the first column, for each file found.

Option

noall forces witch to report only the location of the first file matching the fname.ftype.

noalltypes forces witch to report only the location of files matching fname.ado.

Comment

witch uses the Stata-supplied command which as its internal engine, iteratively invoking

which fname.ftype, all with the allowed .ftype's and slightly formatting the combined output.

Examples

. witch metareg

. witch metareg.dlg

. witch metareg, noallt

. witch metareg, noa

Author

Thomas J. Steichen, steichen@triad.rr.com

Also see

Manual: [R] which

Online: help for findfile, version