The problems reported about Ben Jann's jmp.hlp file
do not appear to be a viewer problem; rather, they
appear to result from a formatting problem within
the help file. The "Examples" section of the file
is formatted as follows:
----------------------------------
{title:Examples}
{p 4 4 2} Decomposition of the gender wage gap using the residuals/prices
of the male model as benchmark:
{com}. regress lnwage educ exp exp2 if sex==1
. estimates store male
. regress lnwage educ exp exp2 if sex==2
. estimates store female
. jmp male female, statistics(mean median)
{p 4 4 2} ... subdividing the quantity effect Q between education and experience:
{com}. jmp male female, blocks(educ=educ, exp=exp*)
{p 4 4 2} ... using a the average residual distribution and the prices of
a pooled model as benchmark:
. regress lnwage educ exp exp2 if sex==1 | sex==2
. jmp male female, ref(.)
-----------------------------------
I suspect the first error is in the accidental substitution
of {com} for {cmd} to format "command" language above.
Secondly, even if {com} had been a viable substitute for {cmd},
it is not structured correctly. The correct general form is:
{directive: text to be formatted}
That is, a brace followed by the directive, followed by a colon,
followed by the text to be formatted, followed by a closing brace.
Substituting {cmd} for {com} and formatting it correctly,
as below, results in proper display in both the Stata Results
Window and Viewer.
-----------------------------------
{title:Examples}
{p 4 4 2} Decomposition of the gender wage gap using the residuals/prices
of the male model as benchmark:
{cmd:. regress lnwage educ exp exp2 if sex==1}
{cmd:. estimates store male}
{cmd:. regress lnwage educ exp exp2 if sex==2}
{cmd:. estimates store female}
{cmd:. jmp male female, statistics(mean median)}
{p 4 4 2} ... subdividing the quantity effect Q between education and experience:
{cmd:. jmp male female, blocks(educ=educ, exp=exp*)}
{p 4 4 2} ... using a the average residual distribution and the prices of
a pooled model as benchmark:
{cmd:. regress lnwage educ exp exp2 if sex==1 | sex==2}
{cmd:. jmp male female, ref(.)}
------------------------------------
Tom
Thomas J. Steichen
[email protected]
----------------------------------------------------------------------------
Facts do not cease to exist because they are ignored. - Aldous Huxley
----------------------------------------------------------------------------
> -----Original Message-----
> From: [email protected]
> [mailto:[email protected]] On Behalf Of
> Chris Ruebeck
> Sent: Thursday, January 27, 2005 2:45 PM
> To: [email protected]
> Subject: Re: st: Corrupt display of helpfiles in the Viewer
>
>
> As the offlist reporter of this bug, the details on my case
> are: Mac OS
> X 10.3.7, Stata 8.2 executable and ado-file updates 10 Jan
> 2005. Ben's
> jmp.hlp file (_after_ being installed on my machine and restarting
> Stata) displays as expected until the line ". jmp male female,
> statistics(mean median)". That line is white, as expected, but the
> following lines are also all white instead of some switching back to
> green. The linked commands _do_ appear in blue (turquoise).
>
> Chris
>
> On Jan 27, 2005, at 5:03 AM, Ulrich Kohler wrote:
> >
> > Confirmed with Stata 8.2 for Linux
> >
> > . query born
> > 10 Jan 2005
> >
> > Jann, Ben wrote:
> >> Someone reported to me offlist that the helpfile of the new -jmp-
> >> package seems to be corrupt. To display the file, type
> >>
> >> rnethelp "http://fmwww.bc.edu/RePEc/bocode/j/jmp.hlp";
> >>
> >> in the Viewer (-rnethelp- only works in the Viewer).
> >>
> >> Although I cannot confirm the problem in this specific case (on my
> >> system the file is being displayed correctly), I suspect
> that there
> >> is something wrong with Stata's Viewer. I myself have
> stumbled over
> >> the problem once in a while that a helpfile was not displayed
> >> correctly (at some point in the helpfile, the interpretation of
> >> paragraph stops and the remaining text is being displayed
> >> unstructured) if the file was directly drawn from the net.
> However,
> >> there does not seem to be anything
> >> wrong with these file, because after installing the
> packages, the help
> >> files could be displayed without problems. An example for
> such a file
> >> -
> >> at least on my system - is the help file of the -statsmat-
> package on
> >> SSC. Type
> >>
> >> rnethelp "http://fmwww.bc.edu/repec/bocode/s/statsmat.hlp";
> >>
> >> in the Viewer.
> >>
> >> A work around, of course, is to install the package and
> then view the
> >> help file that has been copied to the local system. Nonetheless, I
> >> think that this is a problem which should be taken care of.
> >>
> >> Unfortunately, I could not figure out yet what is actally going
> >> wrong. In addition, the problem seems to depend on the specific
> >> system (I am using Stata 8.2, everything updated, on Win XP 2002
> >> SP2).
> >>
> >> Do others experience similar problems? Does anyone have a clue why
> >> this
> >> happens?
>
> *
> * For searches and help try:
> * http://www.stata.com/support/faqs/res/findit.html
> * http://www.stata.com/support/statalist/faq
> * http://www.ats.ucla.edu/stat/stata/
>
-----------------------------------------
CONFIDENTIALITY NOTE: This e-mail message, including any attachment(s),
contains information that may be confidential, protected by the attorney-
client or other legal privileges, and/or proprietary non-public
information. If you are not an intended recipient of this message or an
authorized assistant to an intended recipient, please notify the sender by
replying to this message and then delete it from your system. Use,
dissemination, distribution, or reproduction of this message and/or any of
its attachments (if any) by unintended recipients is not authorized and
may be unlawful.
*
* For searches and help try:
* http://www.stata.com/support/faqs/res/findit.html
* http://www.stata.com/support/statalist/faq
* http://www.ats.ucla.edu/stat/stata/
