From bbolker at gmail.com  Mon Jul 25 19:01:59 2011
From: bbolker at gmail.com (Ben Bolker)
Date: Mon, 25 Jul 2011 13:01:59 -0400
Subject: [Rd] plot.function documentation/export?
In-Reply-To: <4E2D9FEF.3060805@statistik.tu-dortmund.de>
References: <4E2D8F83.5010707@gmail.com>
	<4E2D9FEF.3060805@statistik.tu-dortmund.de>
Message-ID: <4E2DA187.3010204@gmail.com>

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 07/25/2011 12:55 PM, Uwe Ligges wrote:
> 
> 
> On 25.07.2011 17:45, Ben Bolker wrote:
> 
>    I recently suggested to someone (
> http://stackoverflow.com/questions/6789055/r-inconsistency-why-add-t-sometimes-works-and-sometimes-not-in-the-plot-functi/6789098#6789098
> 
> ) that the should use methods("plot") or methods(class="function") to
> locate the documentation on the plot method for objects of class
> "function", but they pointed out that these don't actually work.
> 
>    I can't figure out why not: src/library/graphics/man/curve.Rd contains
> the line
> 
> \method{plot}{function}(x, y = 0, to = 1, from = y, xlim = NULL, ylab =
> NULL, \dots)
> 
> and src/library/graphics/DESCRIPTION contains
> 
> 
>> you mean the following line is in NAMESPACE rather than DESCRIPTION.
> 
> S3method(plot, "function")

  Yes, sorry.

> 
> 
>   [presumably the extra quotes are in there because function is a
> reserved word?]
> 
>   I'm not sure where else the information should be.  Searching around in
> the code tree for information on tail.function (which is listed in the
> methods:
> 
>>>> methods(class="function")
> [1] as.list.function head.function*   print.function   tail.function*
> 
> I find the same S3method syntax, so I guess the quotation marks aren't
> the problem ...
> 
>> ?tail.function
> 
>> tells us this one is from package "utils" and you can search for this
>> function in the sources of the utils package
> 
>> Or you could ask for
> 
> getAnywhere("tail.function")
> 
>> and R tells you
> 
>> A single object matching tail.function was found
>> It was found in the following places
>>   registered S3 method for tail from namespace utils
>>   namespace:utils
>> [.....]
> 
>> Best wishes,
>> Uwe
> 
> 
> 

  Sorry, I didn't frame my question very clearly.  I can find
"tail.function" just fine, or I could if I wanted to.   What I don't
know is why methods("plot") and methods(class="function") don't list
"plot.function" even though its documentation and setup seem to be
similar to "tail.function", which *does* show up in
methods(class="function") ...

  cheers
    Ben Bolker


=========

  No plot.function listing in either of these ...

> library("graphics")
> methods("plot")
 [1] plot.acf*           plot.data.frame*    plot.decomposed.ts*
 [4] plot.default        plot.dendrogram*    plot.density
 [7] plot.ecdf           plot.factor*        plot.formula*
[10] plot.hclust*        plot.histogram*     plot.HoltWinters*
[13] plot.isoreg*        plot.lm             plot.medpolish*
[16] plot.mlm            plot.ppr*           plot.prcomp*
[19] plot.princomp*      plot.profile.nls*   plot.spec
[22] plot.spec.coherency plot.spec.phase     plot.stepfun
[25] plot.stl*           plot.table*         plot.ts
[28] plot.tskernel*      plot.TukeyHSD

   Non-visible functions are asterisked
> methods(class="function")
[1] as.list.function head.function*   print.function   tail.function*

   Non-visible functions are asterisked



-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.10 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iEYEARECAAYFAk4toYcACgkQc5UpGjwzenMyFACggRdP+48u++szSbV82S4HhTxj
MJcAnAsZ0iOXAsXtSeB8PZ4JmlgUgb9t
=2lyp
-----END PGP SIGNATURE-----



[Rd] plot.function documentation/export?
Ben Bolker