help for adodev, adoind, adofac and adoins(Roger Newson)

Reorder ado-path for developers and other independent-minded users

adodev

adoind

adofac

adoins [ path_or_codeword_list ]

where path_or_codeword_list is a list of path_or_codeword items as recognised by adopath.

Description

adodev re-orders the ado-file path to start with the Stata system folders
UPDATES, BASE, ., PERSONAL, PLUS, SITE, and OLDPLACE,
in that order.
adoind re-orders the ado-file path to start with the Stata system folders
UPDATES, BASE, PERSONAL, PLUS, SITE, ., and OLDPLACE,
in that order.
adofac re-orders the ado-file path to start with the Stata system folders
UPDATES, BASE, SITE, ., PERSONAL, PLUS, and OLDPLACE,
in that order.
adoins re-orders the ado-file path to start with the Stata system folders
UPDATES and BASE (in that order),
followed by the folders specified by the path_or_codeword_list,
followed by the Stata system folders
SITE, ., PERSONAL, PLUS, and OLDPLACE,
in that order.
All these commands preserve any existing ordering between any other folders
on the ado-file path,
while keeping UPDATES and BASE at the start of the path (for safety).

Remarks

The adodev command was written for development work,
and allows the user to develop ado-files in the current folder.
The adoind command was written for independent-minded users,
who think that they can update packages faster than their Stata site administrators
(if any Stata site administrators exist).
The adofac command restores the factory setting of the ordering between system folders,
as defined in the manuals for Stata Version 10.
The adoins command was written for independent-minded users
who want to insert other libraries of their choice
immediately after the UPDATES and BASE folders.
Note that the path_or_codeword_list for adoins can be empty or can include codewords.
Therefore, adoins is equivalent to adoind,
adoins . is equivalent to adodev,
and adoins SITE . is equivalent to adofac.

The modules of the adodev package should probably usually be used
with the adostore and adorestore modules of the adoretore packages,
so the pre-existing ado-path can be saved using adostore,
and restored afterwards using adorestore, if necessary.

Examples

.adopath

.adodev

.adoind

.adofac

The following example assumes that the current folder has a sister folder ../cprddata,
with a subfolder /ado containing ado-files.

.adopath

.adoins ../cprddata/ado

Author

Roger Newson, Imperial College London, UK.

Email: r.newson@imperial.ac.uk

Also see

Manual: [P] sysdir

Online: help for adopath, sysdir

help for (helpb adostore} if installed