search.hlp

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

{smcl}
{* 29mar2005}{...}
{cmd:help search}, {cmd:help findit} {right:dialog:  {bf:{search_d:search}}  }
{hline}

{title:Title}

{p2colset 5 19 21 2}{...}
{p2col:{bf:[R] search} {hline 2}}Search Stata documentation{p_end}
{p2colreset}{...}


{title:Syntax}

{p 8 15 2}
{cmd:search}
{it:word}
[{it:word} {it:...}]
[{cmd:,}
{it:search_options}]

{p 8 11 2}
{cmd:set searchdefault}
{c -(}{opt local}|{opt net}|{opt all}{c )-}
[{cmd:,} {opt perm:anently}]

{p 8 15 2}
{cmd:findit}
{it:word}
[{it:word} {it:...}]

{synoptset 14}
{synopthdr:search_options}
{synoptline}
{synopt:{opt local}}search using Stata's keyword database; the default{p_end}
{synopt:{opt net}}search across materials available via Stata's {opt net}
command{p_end}
{synopt:{opt all}}search across both the local keyword database and the
{opt net} material{p_end}
{synopt:{opt a:uthor}}search by author's name{p_end}
{synopt:{opt ent:ry}}search by entry ID{p_end}
{synopt:{opt ex:act}}search across both the local keyword database and the
{opt net} materials; prevents matching on abbreviations{p_end}
{synopt:{opt faq}}search the FAQs posted to the Stata web site{p_end}
{synopt:{opt h:istorical}}search entries that are of historical interest
only{p_end}
{synopt:{opt or}}list an entry if any of the words typed after {opt search}
are associated with the entry{p_end}
{synopt:{opt man:ual}}search the entries in the Stata Documentation{p_end}
{synopt:{opt sj}}search the entries in the {bf:Stata Journal} and the
{bf:STB}{p_end}
{synoptline}
{p2colreset}{...}


{title:Description}

{pstd}
{opt search} searches a keyword database and the Internet.

{pstd}
Capitalization of words following {opt search} is irrelevant, as is the
inclusion or exclusion of special characters such as commas and hyphens.

{pstd}
{opt set searchdefault} affects the default behavior of the {opt search}
command.  {opt local} is the default.

{pstd}
{opt findit} is equivalent to
{opt search} {it:word} [{it:word} {it:...}]{opt , all}.
{opt findit} results are displayed in the Viewer.
{opt findit} is the best way to search for information on a topic across
all sources, including the online help, the FAQs at the Stata web site,
the {bf:Stata Journal}, and all other Stata-related Internet sources.
From {opt findit}, you can click to go to a
source or to install additions.


{title:Options}

{phang}
{opt local}, the default (unless changed by {opt set searchdefault}),
specifies that the search be performed using only Stata's keyword database.

{phang}
{opt net} specifies that the search be performed across the materials
available via Stata's {opt net} command.  Using
{opt search} {it:word} [{it:word} {it:...}]{opt , net} is equivalent to typing
{opt net search} {it:word} [{it:word} {it:...}] (without options); see 
{helpb net}.

{phang}
{opt all} specifies that the search be performed across both the local keyword
database and the {opt net} materials.

{phang}
{opt author} specifies that the search be performed on the basis of the
author's name rather than keywords.  A search with the {opt author} option is
performed on the local keyword database only.

{phang}
{opt entry} specifies that the search be performed on the basis of entry
IDs rather than keywords.  A search with the {opt entry} option is performed
on the local keyword database only.

{phang}
{opt exact} prevents matching on abbreviations.  A search with the {opt exact}
option is performed across both the local keyword database and the {opt net}
materials.

{phang}
{opt faq} limits the search to the FAQs posted on the Stata web site:
{browse "http://www.stata.com"}.  A search with the {opt faq} option is
performed on the local keyword database only.

{phang}
{opt historical} adds to the search entries that are of historical
interest only.  By default, such entries are not listed.  Past entries are
classified historical if they discuss a feature that later became an official
part of Stata.  Updates to historical entries will always be found, even if
{opt historical} is not specified.  A search with the {opt historical} option
is performed on the local keyword database only.

{phang}
{opt or} specifies that an entry be listed if any of the words typed
after {opt search} are associated with the entry.  The default is to list the
entry only if all the words specified are associated with the entry.  A search
with the {opt or} option is performed on the local keyword database only.

{phang}
{opt manual} limits the search to entries in the Stata Documentation;
the search is limited to the {bf:Stata User's Guide} and all the
{bf:Stata Reference} manuals.  A search with the {opt manual} option is
performed on the local keyword database only.

{phang}
{opt sj} limits the search to entries in the {bf:Stata Journal} and its
predecessor, the {bf:Stata Technical Bulletin}; see {help sj}.  A search
with the {opt sj} option is performed on the local keyword database only.


{title:Option for set searchdefault}

{phang}
{opt permanently} specifies that, in addition to making the change right now,
the {opt searchdefault} setting be remembered and become the default setting
when you invoke Stata.


{title:Examples}

{phang}{cmd:. search kolmogorov-smirnov equality of distribution test}{p_end}
{phang}{cmd:. search normal distribution}{p_end}
{phang}{cmd:. search linear regression}{p_end}
{phang}{cmd:. search regression}{p_end}
{phang}{cmd:. search [R], entry}{p_end}
{phang}{cmd:. search STB-16, entry historical}{p_end}
{phang}{cmd:. search Salgado-Ugarte, author}


{title:Advice on using search}

{p 5 9 2}1.  Capitalization does not matter.  Search for
	{search Kolmogorov-Smirnov} or {search kolmogorov-smirnov}.

{p 5 9 2}2.  Punctuation does not matter.  Search for
	{search kolmogorov smirnov}.

{p 5 9 2}3.  Order of words does not matter.  Search for
	{search smirnov kolmogorov}.

{p 5 9 2}4.  You may abbreviate; break at the syllables: search for
	{search kol smir}.  {opt search} tends to tolerate a lot of
	abbreviation; it is better to abbreviate than to misspell.

{p 5 9 2}5.  The prepositions for, into, of, on, to, and with are ignored.  Use
	them, or omit them; it makes no difference.

{p 5 9 2}6.  {opt search} is tolerant of plurals, but it is better to look up
	the singular.  Search for {search normal distribution}, not
	{search normal distributions}.

{p 5 9 2}7.  Specify the search criterion in English, not computer jargon.

{p 5 9 2}8.  Use American spellings.

{p 5 9 2}9.  Use nouns.  Do not use "-ing" words.  Search for
	{search median test}, not {search testing medians}.

{p 4 9 2}10.  Use few words.  Every word specified further restricts the search.
	Search for {search distribution}, and you get one list; search for
	{search normal distribution}, and you get a sublist of that.

{p 4 9 2}11.  Sometimes words have more than one context.  The following words
	can be used to restrict the context:

{p 9 13 2}a.  {search data}, meaning in the context of data management.

{p 9 13 2}b.  {search statistics} (abbreviation {search stat}), meaning in the
	context of statistics.

{p 9 13 2}c.  {search graph} or {search graphs}, meaning in the context of
	statistical graphics.

{p 9 13 2}d.  {search utility} (abbreviation {search util}), meaning in the
	context of utility commands.

{p 9 13 2}e.  {search programs} or {search programming} (abbreviation
	{search prog}), meaning in the context of Stata programming.


{title:Looking up error messages}

{pstd}
In addition to serving as an index, {cmd:search} knows Stata's return codes
and can offer longer explanations than the commands issuing the errors do
themselves.  For instance, say that you use {cmd:test} and,

	{cmd:. test} {it:...}
	{err:not possible with test}
	{search r(131):r(131);}

{pstd}
131 is called the return code.  To obtain more information on 131, type

	{cmd:. search rc 131}


{title:Also see}

{psee}
Manual:  {bf:[U] 4 Stata's online help and search facilities},{break}
{bf:[R] search}

{psee}
Online:  {helpb help}, {help keyfiles}, {helpb net:net search},
{help sj}, {helpb ssc}, {help statalist}
{p_end}