update.hlp

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

{smcl}
{* 18mar2005}{...}
{cmd:help update}{right:dialog:  {bf:{update:update}}}
{hline}

{title:Title}

{p2colset 5 19 21 2}{...}
{p2col:{hi:[R] update} {hline 2}}Update Stata{p_end}
{p2colreset}{...}


{title:Syntax}

{pstd}
Report on update level of currently installed Stata

{p 8 26 2}{cmd:update}

{pstd}
Set update source

{p 8 26 2}{cmd:update from} {it:location}

{pstd}
Compare update level of currently installed Stata with that of source

{p 8 26 2}{cmd:update} {opt q:uery} [{cmd:,} {opt from(location)}]

{pstd}
Compare update level of ado-files of currently installed Stata with that of
source

{p 8 26 2}{cmd:update ado} [{cmd:,} {opt from(location)} {opt into(dirname)}]

{pstd}
Compare update level of executable of currently installed Stata with that of
source

{p 8 26 2}{cmd:update executable} [{cmd:,} {opt from(location)} {opt into(dirname)} {opt force}]

{pstd}
Perform update ado and update executable

{p 8 26 2}{cmd:update all} [{cmd:,} {opt from(location)}]

{pstd}
Swap newly downloaded executable with currently running executable

{p 8 26 2}{cmd:update swap} [{cmd:, clear}]

{pstd}
Set automatic updates (Windows and Macintosh only)

{p 8 26 2}(Windows and Macintosh only){p_end}
{p 8 26 2}{opt se:t} {cmd:update_query}{space 3}{c -(}{cmd:on}|{cmd:off}{c )-}{p_end}
{p 8 26 2}{opt se:t} {cmd:update_interval} {it:#} {p_end}
{p 8 26 2}{opt se:t} {cmd:update_prompt}{space 2}{c -(}{cmd:on}|{cmd:off}{c )-}


{title:Description}

{pstd}
The {opt update} command reports on the current update level and installs
official updates to Stata.  Official updates are updates to Stata as it was
originally shipped from StataCorp, not the additions to Stata published in,
for instance, the {bf:Stata Journal} (SJ) or {bf:Stata Technical Bulletin}
(STB).  Those additions are installed using the {opt net} command; see
{helpb net}.

{phang}
{opt update} without arguments reports on the update level of the currently
installed Stata.

{phang}
{opt update from} sets an update source, where {it:location} is a directory
name or URL.  If you are on the Internet, type {cmd:update from http://www.stata.com}.

{phang}
{opt update query} compares the update level of the currently installed
Stata with that available from the update source and displays a report.

{phang}
{opt update ado} compares the update level of the official ado-files of the
currently installed Stata with those available from the update source.  If the
currently installed ado-files need updating, {opt update ado} copies and
installs those files from the update source that are necessary to bring the
ado-files up to date.

{phang}
{opt update executable} compares the update level of the currently
installed Stata executable with that available from the update source.  If the
currently installed Stata needs updating, {opt update executable} copies the
new executable from the update source, but the last step of the
installation{hline 2}erasing the old executable and renaming the new
executable{hline 2}is left for you to perform.  {opt update executable}
displays instructions on how to do this.

{phang}
{opt update all} does the same as {opt update ado} followed by
{opt update executable}.

{phang}
{opt update swap} automatically swaps the newly downloaded executable
with the currently running executable.  During this process, Stata
will shut down to perform the swap before automatically launching the new
executable.  This command is only useful if it is preceded by either the
{opt update executable} or the {opt update all} commands.

{phang}
{opt set update_query} determines if {opt update query} is to be automatically
performed when Stata is launched.

{phang}
{opt set update_interval} sets the number of days to elapse before performing
the next automatic {opt update query}.  The interval starts from the last time
an {opt update query} was performed (automatically or manually).

{phang}
{opt  set update_prompt} determines whether a dialog is to be displayed before
performing an automatic {opt update query}.  The dialog allows you to perform an
{opt update query} now, perform one the next time Stata is launched, perform
one after the next interval has passed, or disable automatic {opt update query}.


{title:Options}

{phang}
{opt from(location)} specifies the location of the update source.  You can
   specify the {opt from()} option on the individual {opt update} commands or
   use the {opt update from} command.  Which you do makes no difference.

{phang}
{opt into(dirname)} specifies the name of the directory into which the updates
   are to be copied.  {it:dirname} can be a directory name or a {opt sysdir}
   codeword such as {bf:UPDATES} or {bf:STATA}; see {helpb sysdir}.

{pmore}
   In the case of {opt update ado}, the default is {cmd:into(UPDATES)}, the
   official update directory.  Network computer managers might want to specify
   {opt into()} if they want to download the updates but leave the last
   step{hline 2}copying the files into the official directory{hline 2}to do
   themselves.

{pmore}
   In the case of {opt update executable}, the default is {cmd:into(STATA)},
   the official Stata directory.  Network computer managers might want to
   specify {opt into()} so that they can copy the update into a more
   accessible directory.  In that case, the last step of copying the new
   executable over the existing executable would be left for them to perform.

{phang}
{opt force} is used with {opt update executable} to force downloading a
   new executable even if, based on the date comparison, Stata does not think
   it is necessary.  There is seldom a reason to specify this option.  There is
   no such option for {opt update ado} because, if you wanted to force the
   reinstallation of all ado-file updates, you would need only to erase the
   {bf:UPDATES} directory.  You can type {cmd:sysdir list} to see where the
   {bf:UPDATES} directory is on your computer; see {helpb sysdir}.

{phang}
{opt clear} specifies that it is okay to shut down this Stata and start the new
    one, even though the data in memory have not been saved to disk.


{title:Examples}

    {cmd:. update}{right:(report on what you have installed)         }

    {cmd:. update query}{right:(compare what you have with update source)  }

    {cmd:. update all}{right:(update ado-files and executable)           }

    {cmd:. update swap}{right:(install the new executable)                }


{title:Also see}

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

{psee}
Online:  {helpb net}, {helpb sysdir}
{p_end}