.-
help for ^archdesc^, ^archlist^, ^archinst^, ^archcopy^, ^archtype^ (STB-52: ip29;
                                                           STB-54: ip29.1)
.-

Work with packages or files in Statistical Software Components archive
----------------------------------------------------------------------

    ^archdesc^ [ { package | letter } ] [^using^ filename] 
    [ ^, replace^ [^no^]^l^og  ]

    ^archlist^ [^using^ filename] [^, replace^ ]
    
    ^archlist^ letter 
    
    ^archinst^ package [ ^,^ net_install_options ] 

    ^archcopy^ filename.ext [^,^ copy_options ] 
             
    ^archtype^ filename.ext 
   

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

These commands work with files or packages from the Statistical Software
Components (SSC) archive (often called the Boston College archive). They 
require a net-aware variant of Stata 6.0.
 

^archdesc^
--------

^archdesc^ describes the contents of the archive. 

^archdesc^, with neither a letter nor a package specified, lists all 
packages in the archive. By default, it also puts a log of the listing 
in ^ssc-ideas.lst^. 

^archdesc^ letter (where letter is one of a-z or _) lists all packages in 
the archive whose names begin with that letter. 

^archdesc^ package (where package is a name two or more letters long 
beginning with a-z or _) describes that package if it exists; or 
all packages beginning with the same letter if it does not. Thus 
a faulty guess still produces information on nearby names. 

If ^archdesc^ is accompanied by logging results to a file, any 
existing logging is temporarily suspended. 


^archlist^
--------

(^archlist^ is included here for compatibility. It is considered to
have been superseded by ^archdesc^.) 

^archlist^ lists packages downloadable from the SSC archive.

If no letter is specified, it also logs what it displays, by default 
in ^ssc-ideas.lst^. Therefore, it may not be run ^quietly^ without 
suppressing its useful output. Any logging previously started will be 
suspended while it is operating.

If a single letter is specified, ^archlist^ lists packages 
whose names begin with that letter, but only on the screen.


^archinst^ 
--------

^archinst^ package installs that package from the archive. 


^archcopy^
--------

(Note: ^archcopy^ is rarely needed, given ^archinst^.)  

^archcopy^ filename.ext copies filename.ext from the SSC archive to the 
appropriate directory or folder within STBPLUS, determined 
automatically. (If curious, type ^sysdir^ to see where this is.) 
This is appropriate for individual .ado or .hlp files. 


^archtype^
-------

^archtype^ filename.ext types filename.ext from the SSC archive. 
This is appropriate for individual .ado or .hlp files. 


Options
-------

^replace^ specifies that filename is to be overwritten. 

^nolog^ overrides the default behaviour of ^archdesc^, with no specification 
of either a letter or a package, which is to log to ^ssc-ideas.lst^. 

net_install_options are options of ^net install^. See help on @net@. 

copy_options are options of ^copy^. See help on @copy@. 


Examples
--------

    . ^archdesc using ssc.txt, replace^ 

    . ^archdesc w^ 

    . ^archdesc whitetst using whitetst.txt^ 
    
    . ^archlist using ssc.txt, replace^
    
    . ^archlist a^

    . ^archinst whitetst^ 

    . ^archcopy whitetst.ado^
    . ^archcopy whitetst.hlp^ 

    . ^archtype whitetst.hlp^ 


Acknowledgements
----------------

	Helpful advice was received from Bill Gould, Jens Lauritsen, 
	Vince Wiggins and Desmond Williams. 


Authors
-------

	 Nicholas J. Cox, University of Durham
	 n.j.cox@@durham.ac.uk 
	 
	 Christopher F. Baum, Boston College
	 baum@@bc.edu


Also see
--------

On-line:  help for @copy@, @net@, @sysdir@, @type@