Re: [Rd] promptClass("numeric")

From: Wolski <wolski_at_molgen.mpg.de>
Date: Tue 17 Aug 2004 - 00:43:56 EST

Hi!

As I said its not really a Problem. Its just an inconsistency which need is not apparent to me.

You can alternatively use promptClass or promptMethods to document methods. promptClass always generates a section:

>>>>\section{Methods}{
>>>> \describe{
>>>> \item{coerce}{\code{signature(from = "ANY", to = "numeric")}: ...
>>>> } }
>>>> }

So you can use promptClass to provide a short description to your methods.

I would use promptMethods if the methods are elaborated (like a the plotting methods in package lattice) and I would like to to provide intensive and extensive explanation with examples.

But in case if my method "foo" which is so simple (it just prints "foo") I would like to use promptClass.

Yours

Eryk.

On 8/16/2004 at 9:27 AM Deepayan Sarkar wrote:

>>>On Monday 16 August 2004 08:54, Wolski wrote:
>>>> Hi!
>>>>
>>>> Have written some functions with signature "numeric".
>>>>
>>>> eg.
>>>> setGeneric("foo",
>>>> function(object,...)
>>>> standardGeneric("foo"))
>>>> setMethod("foo",signature(object="numeric"),def = ....
>>>>
>>>> To generate the Rd file sceleton i use
>>>>
>>>> > promtClass("numeric")
>>>>
>>>> A shell of class documentation has been written to the
>>>> file 'numeric-class.Rd'.
>>>>
>>>>
>>>> but the file does contains just.
>>>>
>>>> \section{Methods}{
>>>> \describe{
>>>> \item{coerce}{\code{signature(from = "ANY", to = "numeric")}: ...
>>>> } }
>>>> }
>>>>
>>>> Were is my method "foo"?
>>>
>>>Why do you expect it to be there? If you want documentation for method
>>>definitions of foo, use promptMethods("foo"); this is indicated
>>>in ?promptClass:
>>>
>>>See Also:
>>>
>>> 'prompt' for documentation of functions, 'promptMethods' for
>>> documentation of method definitions.
>>>
>>>Hth,
>>>
>>>Deepayan

Dipl. bio-chem. Eryk Witold Wolski @ MPI-Moleculare Genetic

Ihnestrasse 63-73 14195 Berlin       'v'    
tel: 0049-30-83875219               /   \    
mail: wolski_at_molgen.mpg.de        ---W-W----    http://www.molgen.mpg.de/~wolski

______________________________________________
R-devel@stat.math.ethz.ch mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel Received on Tue Aug 17 00:49:02 2004

This archive was generated by hypermail 2.1.8 : Fri 18 Mar 2005 - 08:59:19 EST