net.hlp

是一个经济学管理应用软件 很难找的 但是经济学学生又必须用到

{smcl}
{* *! version 1.0.0  24may2005}{...}
{cmd:help net}, {cmd:help ado}{right:dialogs:  {bf:{net "from http://www.stata.com/":net}}  {bf:{net_d:net search}}}
{right:{bf:{ado dir}}  {bf:{ado_d:ado find()}}}
{hline}

{title:Title}

{p2colset 5 16 18 2}{...}
{p2col :{hi:[R] net} {hline 2}}Install and manage user-written additions from the net{p_end}
{p2col 5 23 25 2:{hi:[R] net search} {hline 2}}Search Internet for installable packages{p_end}
{p2colreset}{...}


{title:Syntax}

{pstd}
Set current location for net

{p 8 19 2}{cmd:net} {cmd:from} {it:directory_or_url}{p_end}

{pstd}
Change into a different net directory

{p 8 19 2}{cmd:net} {cmd:cd} {it:path_or_url}{p_end}

{pstd}
Change to a different net site

{p 8 19 2}{cmd:net} {cmd:link} {it:linkname}{p_end}

{pstd}
Search for installed packages

{p 8 19 2}{cmd:net} {cmd:search} {it:word} [{it:word} {it:...}]
		[{cmd:,} {it:{help net##search_options:search_options}}]

{pstd}
Report current net location

{p 8 21 2}{cmd:net} 

{pstd}
Describe a package

{p 8 21 2}{cmd:net} {opt d:escribe} {it:pkgname}
		[{cmd:,} {opt fr:om(directory_or_url)}]

{pstd}
Set location where packages will be installed

{p 8 16 2}{cmd:net} {cmd:set} {cmd:ado} {it:dirname}{p_end}

{pstd}
Set location where ancillary files will be installed

{p 8 16 2}{cmd:net} {cmd:set} {cmd:other} {it:dirname}{p_end}

{pstd}
Report net 'from', 'ado', and 'other' settings

{p 8 16 2}{cmd:net} {opt q:uery}

{pstd}
Install ado- and help files from a package

{p 8 20 2}{cmd:net} {opt ins:tall} {it:pkgname} [{cmd:, all replace}
		{opt fr:om(directory_or_url)}]

{pstd}
Install ancillary files from a package

{p 8 20 2}{cmd:net} {cmd:get} {it:pkgname} [{cmd:, all replace}
		{opt fr:om(directory_or_url)}]

{pstd}
Shortcut to access Stata Journal net site

{p 8 20 2}{cmd:net} {cmd:sj} {it:vol}{cmd:-}{it:issue} [{it:insert}]{p_end}

{pstd}
Shortcut to access STB net site

{p 8 20 2}{cmd:net} {cmd:stb} {it:issue} [{it:insert}]

{pstd}
List installed packages

{p 8 20 2}{cmd:ado} [{cmd:,} {opt f:ind(string)} {opt fr:om(dirname)}]

{p 8 16 2}{cmd:ado} {cmd:dir} [{it:pkgid}] [{cmd:,} {opt f:ind(string)} 
{opt fr:om(dirname)}]{p_end}

{pstd}
Describe installed packages

{p 8 21 2}{cmd:ado} {opt d:escribe} [{it:pkgid}]
[{cmd:,} {opt f:ind(string)} {opt fr:om(dirname)}]{p_end}

{pstd}
Uninstall an installed package

{p 8 22 2}{cmd:ado} {opt uninstall} {it:pkgid}
[{cmd:,} {opt fr:om(dirname)}]{p_end}

{synoptset 16}{...}
{marker search_options}{...}
{synopthdr :search_options}
{synoptline}
{synopt :{opt or}}list packages that contain any of the keywords; default is all{p_end}
{synopt :{opt nosj}}search non-SJ and non-STB sources{p_end}
{synopt :{opt tocpkg}}search both tables of contents and packages (default){p_end}
{synopt :{opt toc}}search table of contents only{p_end}
{synopt :{opt pkg}}search packages only{p_end}
{synopt :{opt e:verywhere}}search packages for match{p_end}
{synopt :{opt f:ilenames}}search filenames associated with package for match{p_end}
{synopt :{opt errnone}}make return code 111 instead of 0 when no matches found{p_end}
{synoptline}
{p2colreset}{...}

    where

        {it:pkgname} is   name of a package
{p 8 23}{it:pkgid} {space 1} is {space 1} name of a package{p_end}
{p 16 23}or {space 1} a number in square brackets: {cmd:[}{it:#}{cmd:]}{p_end}
{p 8 23}{it:dirname} is {space 1} a directory name{p_end}
{p 16 23}or {space 1} {cmd:PLUS} {space 4} (default){p_end}
{p 16 23}or {space 1} {cmd:PERSONAL}{p_end}
{p 16 23}or {space 1} {cmd:SITE}


{title:Description}

{pstd}
{cmd:net} fetches and installs additions to Stata.  The additions can be
obtained from the Internet or from media.  The additions can be ado-files
(new commands), help files, or even datasets.  Collections of files are bound
together into packages.

{pstd}
{cmd:net from}
moves you to a location and displays the content page.

{pstd}
{cmd:net cd} and {cmd:net link}
change from there to other locations.  {cmd:net cd} enters subdirectories of
the original location.  {cmd:net link} jumps from one location to another,
depending on the code on the content page.

{pstd}
{cmd:net search}
searches the Internet for user-written additions to Stata,
including but not limited to user-written additions published in the Stata
Journal (SJ) and the Stata Technical Bulletin (STB).
{cmd:net search} lists the available additions that contain the specified
{it:keywords}.

{pstd}
{cmd:net describe}
lists a package-description page.  Packages are named, and you type
{cmd:net describe} {it:pkgname}.

{pstd}
{cmd:net set}
controls where files are installed by {cmd:net}.  By default, {cmd:net}
installs in the {cmd:PLUS} directory (see {helpb sysdir}).
{cmd:net set ado SITE} would cause subsequent {cmd:net} commands to install in
the {cmd:SITE} directory.  {cmd:net set other} sets where ancillary files,
such as {cmd:.dta} files, are installed.  The default is the current
directory.

{pstd}
{cmd:net query}
displays the current {cmd:net from}, {cmd:net set ado}, and
{cmd:net set other} settings.

{pstd}
{cmd:net install}
installs a package into your copy of Stata.

{pstd}
{cmd:net get}
copies any additional files (ancillary files) to your current directory (or
location determined by {cmd:net set other}).

{pstd}
{cmd:net sj} and {cmd:net stb}
make loading files from the Stata Journal
and its predecessor, the Stata Technical Bulletin easier.

{phang2}{cmd:net sj} {it:vol}{cmd:-}{it:issue}

{pstd}
is a synonym for typing

{phang2}{cmd:net from http://www.stata-journal.com/software/sj}{it:vol}{cmd:-}{it:issue}

{pstd}
while

{phang2}{cmd:net sj} {it:vol}{cmd:-}{it:issue} {it:insert}

{pstd}
is a synonym for typing

{phang2}{cmd:net from http://www.stata-journal.com/software/sj}{it:vol}{cmd:-}{it:issue}{p_end}
	{cmd:net describe} {it:insert}

{pstd}
{cmd:ado} manages the packages you have installed using {cmd:net}.  The
{cmd:ado} command allows you to list packages you have previously installed
and to uninstall them.

{pstd}
{cmd:ado dir} (same as typing {cmd:ado} without arguments)
lists the names and titles of the packages that you have installed.

{pstd}
{cmd:ado describe}
lists full package-description pages.

{pstd}
{cmd:ado uninstall}
removes packages from your computer.

{pstd}
Users can also access the {cmd:net} and {cmd:ado} features by selecting
{bf:Help > SJ and User-written Programs}.

{pstd}
Details for those wishing to produce their own package files and download
sites are provided in {help usersite} with additional examples found in
{bind:{bf:[R] net}}.


{title:Options for net search}

{phang}
{opt or} is relevant only when multiple keywords are specified.  By default,
only packages that include all the keywords are listed.  {opt or} changes this
to list packages that contain any of the keywords.

{phang}
{opt nosj} specifies that {cmd:net search} not list matches that were published in the Stata Journal or in the STB.

{phang}
{opt tocpkg}, {opt toc}, and {opt pkg} determine what is searched.  
{opt tocpkg} is the default, meaning that both tables of contents (tocs) and
packages (pkgs) are searched.  {opt toc} restricts the search to tables of
contents only.  {opt pkg} restricts the search to packages only.

{phang}
{opt everywhere} and {opt filenames} determine where in packages 
{cmd:net search} looks for {it:keywords}.  The default is {opt everywhere}.
{opt filename} restricts {cmd:net search} to search for matches only in the
filenames associated with a package.  Specifying {opt everywhere} implies 
{opt pkg}.

{phang}
{opt errnone} is a programmer's option that causes the return code to be 111
instead of 0 when no matches are found.


{title:Options for net install and net get}

{phang}
{opt all} typed with either {cmd:net install} or {cmd:net get} is equivalent
to typing {cmd:net install} followed by {cmd:net get}.

{phang}
{opt replace} specifies that the fetched files replace existing files
if any of the files already exist.

{phang}
{opt from(directory_or_url)}
when used with {cmd:net} specifies the directory or URL where installable
packages may be found.  The directory or URL is the same as the one that would
have been specified with {cmd:net from}.


{title:Options for ado commands}

{phang}
{opt find(string)} specifies that the descriptions of the packages installed
on your computer be searched, and that the package descriptions containing
{it:string} be listed.

{phang}
{opt from(dirname)} specifies where the packages are installed.  The default
is {cmd:from(PLUS)}.  {opt PLUS} is a codeword that Stata understands to
correspond to a particular directory on your computer that was set at
installation time.  On Windows computers, {opt PLUS} probably means the
directory {cmd:c:\ado\plus}, but it might mean something else.  You can find
out what it means by typing {helpb sysdir}, but this is irrelevant if you use
the defaults.


{title:Examples}

{pstd}
To view the main Stata net downloading content page, type{p_end}

{phang2}{cmd:. net from http://www.stata.com}

{pstd}
or you can instead type{p_end}

{phang2}{cmd:. net link stata}

{pstd}
and then{p_end}

{p2colset 9 35 37 2}{...}
{p2col :{cmd:. net link sj}}to see main SJ page{p_end}
{p2col :{cmd:. net link software}}to see main SJ contents page{p_end}
{p2col :{cmd:. net cd sj1-1}}to then see the SJ 1(1) contents page{p_end}
{p2col :{cmd:. net describe st0002}}to see a description of package st0002{p_end}
{p2col :{cmd:. net install st0002}}to install package st0002{p_end}
{p2col :{cmd:. net get st0002}}to obtain auxiliary files from st0002{p_end}
{p2colreset}{...}

{pstd}
Then to see what you have installed, type{p_end}

{p2colset 9 35 37 2}{...}
{p2col :{cmd:. ado}}to list packages you have installed{p_end}
{p2col :{cmd:. ado describe st0002}}to describe package st0002 you installed{p_end}
{p2col :{cmd:. ado, find("count")}}to find packages using keyword search{p_end}
{p2col :{cmd:. ado uninstall st0002}}to uninstall package st0002{p_end}
{p2colreset}{...}

{pstd}
To search over the net for what is available about "random effects"{p_end}

{phang2}{cmd:. net search random effect}


{title:Also see}

{psee}
Manual:  {bf:[R] net}

{psee}
Online:  {helpb checksum},
{helpb netio},
{helpb search},
{help sj},
{help smcl},
{helpb ssc},
{help stb},
{helpb update}, 
{help usersite}
{p_end}