Skip to content

Documentation suggestion!

1 message · Brian Ripley

#
That's easy, and done now.
There is no `graphic' keyword.  locator and identify have keyword
`iplot', `Interacting with Plots'.  See below.
It took `graphic' from the title for locator, not the keyword.
[Actually, there is only one set of sources: it is the Windows source too.]
Really there is not just one help system, but several.  The `keywords'
are a misnomer carried over from S3:  they are in fact categories used
by the HTML search system, and by help.search.  On Windows the CHTML
and WinHelp help systems have full-text-search by default, and we are
looking at ways of providing FTS and approximate matching on other platforms.

I think had you done a search under HTML help, it would have been more
obvious from the categories presented to you.  I would also commend
CHTML full-text searches to you.

We are aware that the help system could be improved, and I have already
suggested real keywords for a future version.


Another issue that is just as important is the contents of the help.  I
realised recently that the documentation for many of the basic graphics
operations is incomplete (they accept many more forms of input via
xy.coords, NAs can be used to break lines, polygons are supposed to be
automatically closed, and so on).