help lado
-------------------------------------------------------------------------------

Title

Featured list of ado-files

Syntax lado [ stub ] , erase

where stub may be a dot, a single letter or any combination of characters that can be used for file names, or a dot followed by a single letter of any combination of characters that can be used for file names.

Description

lado is developed for ado file programmers. It returns a list of ado files stored in the working directory or in any other directory that has been set as the "ado development folder". If stub is specified, only files with names containing stub are listed. Along with the file names, the programs offer a list of click-able links for some typical tasks that one wants to do for own ado files.

Specifically, lado provides links for viewing and editing each ado file. If a help file exists links for getting help and editing the help file are also provided.

By default, the Stata do-file editor is invoked for editing ado files and help files. However, you can use a different editor by setting the global macro "MYEDITOR" to the command that opens your preferred text editor. I, for example, have the line

------------------- profile.do global MYEDITOR !emacsclient -n -------------------------------

in my profile file, which works under Linux. Windows users might prefer something along the following lines

-------------------- profile.do global MYEDITOR winexec textpad -------------------------------

Note that setting the macro MYEDITOR also affects the editor used to open do-files with ldo and the editor used to open tex-files with ltex.

By default, lado lists the ado files in the working directory. However, you can predefine an ado development directory which is then used instead of the working directory. This is done by setting the global macro "ADODEVELOPMENT" to the directory in which own ado files are created. I have

------------------------ profile.do global ADODEVELOPMENT "~/ado/cooker/" -----------------------------------

in my profile file.

The ado development folder can be overwritten interactively by typing a dot in front of or instead of the stub. The command

. lado .

will list all ado files of your current directory even if you have predefined an ado development folder. Likewise,

. lado .l

will list all ado files of your current directory starting with the letter l.

Options

erase brings up yet another click-able item which allows to erase files on disk. Clicking on that item removes the respective file immediately from the disk. The file is not moved to the recycle bin. The erase button is printed in red to indicate that it should be handled with care.

Example

. lado . lado, erase

Author

Ulrich Kohler, kohler@wzb.eu

Also see

Online: dirtools, lall, ldir, ltex, cdout, clickout, fastcd (if installed)