[Rd] RFE: Hierarchical Sectioning in the Entry Page to
Documentation for S4-Classes in Contributed Packages
Peter.Ruckdeschel at uni-bayreuth.de
Wed Nov 5 21:51:11 MET 2003
we are at that stage working on a package implementing the concept of
distributions as own S4-Classes. We are planning to submit a first
version to this audience by the end of November.
One issue we met is that when documenting our classes, the resulting
help-file that is displayed as first page [at least in html] when
help to our package works quite reasonable, but in our view looks a bit
not to say messy.
To our knowledge there is no standard way of avoiding this mentionned in
the FAQs and the manuals.
We would appreciate the possibility to further partition/section the
entry page of a
documentation of a package --- at best reflecting the inheritance
structure of our classes.
To be precise we would like to have the possibility to begin the entry
page with a highly
structured (in tree/graph-form?) presentation of the classes / methods
within this package
--- not at all listed in alphabetical order.
->[ for instance grouped in TeX-like sections/subsections, corresponding to
the inheritance structure of our classes, and / or one section for
function --- possibly also illustrated by an automatically placed
for the inheritance structure? --- ]
Only after this we would add the display style for the entry page
as it is at the moment as sort of an index.
We think that this way one would apprehend at first glance the
of the classes within this package and that this incremental view should
enhance the readability of the help files --- not only of ours.
On the other hand this sketched way of sectioning should be optional so
developper may confine oneself to the existing display modi.
What do you think of this proposal? And do you think it is hard to
(unfortunately we cannot offer much help in that)?
Thank you for your attention
More information about the R-devel