.-
help for stbutil                              @net:from http://www.stata.com/users/wgould!http://www.stata.com/users/wgould@
.-

Install and uninstall entire issues of the STB
----------------------------------------------

	^stbutil^ ^install^ # [^, replace^]

	^stbutil^ ^uninstall^ #


Description
-----------

^stbutil^ installs and inuninstalls entire issues of the STB from 
http://www.stata.com/stb.

Typing ^stbutil^ ^install^ more than once for the same issue is safe.  In that
case, ^stbutil^ ^install^ will step through the inserts one by one and tell you
that "all files already exist and are up to date".


Options
-------

^replace^ specifies that if a file in an insert is already installed -- if the
    file is duplicated -- the new file is to replace the old.  If you do not
    specify this option, inserts with duplicated files will not be loaded.

    If you load STB issues in order -- you install, say, 47 after 46, 45, 
    etc., you are advised to specify this option.  

    Pretend STB-32 contained the insert xyz1 and that, later, issue STB-41
    contained an update to insert xyz1, called insert xyz1_1.  It would hardly
    be surprising that insert xyz1_1 contained some of the same files as the
    old insert xyz1.  Now let's pretend that you have already installed
    STB-32, meaning insert xyz1 is installed.

    If you went to install insert xyz1_1 INTERACTIVELY, you would immediately
    discover that xyz1_1 overlapped xyz1 and, considering the problem, you
    would probably uninstall xyz1 and then install xyz1_1.

    If you use ^stbutil^ ^install^, you are mindlessly installing all the STB
    inserts.  Specifying replace tells ^stbutil^ ^install^ to use the newer files
    in preference to the old.  ^stbutil^ ^install^ will not uninstall the original
    of the insert, but really that will not matter.  Stata will not become
    confused.  Even if you went back and uninstalled the original xyz1 later,
    Stata would know not to uninstall the xyz1_1 files.  Stata is very smart
    about this.

    Now pretend you installed entire STB issues the other way around.  You
    have previously installed the entirity of STB-41 and now go to install
    STB-32.  You have insert xyz1_1 installed and, if you specified ^replace^,
    you would be telling ^stbutil^ ^install^ to replace the contents xyz1_1 with
    the older xyz1.  Presumably, you would break something more modern.


Examples
--------

	. ^stbutil install 40^
	. ^stbutil install 41, replace^
	. ^stbutil install 42, replace^

	. ^stbutil uninstall 40^


Author
------

William Gould, StataCorp.


Also see
--------

On-line:  help for @net@
