Re: Help wanted: Minor *.doc -> *.tex problem

[Ethan M. <merritt@u.washington.edu>]

On Sunday 03 April 2005 08:22 am, you wrote:
> but you may want to check what's going on there...]
>
> > I found the problem because I was trying to add a new section
> > elsewhere. Adding additional levels is the only way I know of to
> > break the interactive help into shorter sections and have it
> > prompt for additional keywords. =C2=A0So it's useful in the *.gih form.
>
> Let's say: it can be, if not abused. =C2=A0A node with only one subnode
> doesn't make terribly much sense, IMHO.
>
> I don't think keeping individual nodes short would be sufficient reason
> to split them up. =C2=A0It's more important to keep up the principle of
> one subject matter <--> one node.

The issue is how to allow access to the same help section via
multiple keywords for the 'help' command.

=46or example: There is a longish section on the 'with histogram'
style. It is located with the other plot style entries as:
  5 histograms
  ?commands set style histogram

So it is already 5 levels deep.  At the end of this section is an
explanation of the 'newhistogram' command.  Unfortunately, you cannot
find it by typing 'help newhistogram'.  It was not clear to me that
I could simply add a line
  ?newhistogram
without first creating a new section heading
  6 newhistogram

Upon experimentation, I see that in fact it is possible to add
the '?<foo>' form without a corresponding '6 <foo>' form.
This allows 'help newhistogram' to work, and does not add a
separate 6th level entry to the ToC.  However, it also causes
'help set style histogram' to terminate without printing this
last section.  So there's still a problem.

It wouldn't make any sense to bump 'newhistogram' up to a
parallel 5th level entry, because it isn't a plotting style on
its own.

Suggestions?


=2D-=20
Ethan A Merritt
Biomolecular Structure Center
University of Washington 98195-7742