_findhlpalias.hlp

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

{smcl}
{* 10mar2005}{...}
{cmd:help find_hlp_file}, {cmd:help _findhlpalias}{...}
{right:also see:  {help undocumented}}
{hline}

{title:Title}

    {cmd:find_hlp_file} {hline 2} Find help file


{title:Syntax}

{p 8 16 2}
{cmd:find_hlp_file}
{it:commandname_or_abbreviation}

{p 8 16 2}
{cmd:_findhlpalias}
{it:commandname_or_abbreviation}


{title:Description}

{pstd}
{cmd:find_hlp_file} locates the help for
{it:commandname_or_abbreviation}.

{pstd}
{cmd:_findhlpalias}
assists in locating help files associated with
{it:commandname_or_abbreviation}.


{title:Remarks}

{pstd}
The help file associated with {it:commandname_or_abbreviation} might be in

	{it:commandname_or_abbreviation}{cmd:.hlp}
    or
	{it:somethingelse}{cmd:.hlp}

{pstd}
The system files {cmd:ahelp_alias.maint}, {cmd:bhelp_alias.maint}, ...
{cmd:zhelp_alias.maint} list the aliases.  The right way to find the
{cmd:.hlp} file associated with {cmd:`name'} is

	{cmd:find_hlp_file `name'}

{pstd}
Returned in {cmd:r(result)} will be the base name of the help file -- the
name without the {cmd:.hlp} suffix -- or an error message will be
displayed and r(111) returned.

{pstd}
{cmd:find_hlp_file} is implemented in terms of {cmd:_findhlpalias}.
{cmd:_findhlpalias} searches the appropriate {cmd:.maint} file for
{it:commandname_or_abbreviation} and, if found, returns in {cmd:r(name)} the
aliased name.  If not found, no error message is displayed and returned is
r(111).

{pstd}
Thus, the code for {cmd:find_hlp_file} reads, roughly,

	{cmd}program find_hlp_file, rclass
		args name

		capture which `name'.hlp
		if _rc==0 {
			return local result "`name'"
			exit
		}
		capture _findhlpalias `name'
		if _rc==0 {
			local alias "`r(name)'"
			capture which `alias'.hlp
			if _rc==0 {
				return local result "`alias'"
				exit
			}
		}
		display as err "help for `name' not found"
		exit 111
	end{txt}


{title:Saved results}

{pstd}
{cmd:find_hlp_file} returns in {cmd:r(result)} the base name of the help file
without the {cmd:.hlp} suffix.  If no .hlp file exists for
{it:commandname_or_abbreviation}, an error is returned:  "help for ___ not
found"; r(111).

{pstd}
{cmd:_findhlpalias} returns in {cmd:r(name)} the alias (base name)
associated with
{it:commandname_or_abbreviation}.  If there is no alias associated with
{it:commandname_or_abbreviation}, no error message is displayed, but
returned is r(111).


{title:Also see}

{psee}
Online:  {helpb findfile},
{helpb help},
{helpb which}
{p_end}