-------------------------------------------------------------------------------
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