Full_Name: Dan B
Version: R 2.0.0 (2004-10-04).
OS: Fedora 2
Submission from: (NULL) (80.6.127.185)
The man page for barplot (?barplot) is confusing...
<quote>
cex.axis: expansion factor for numeric axis labels.
cex.names: expansion factor for axis names (bar labels).
</quote>
What is an 'expansion factor', and what does it do in this context?
<quote>
axis.lty: the graphics parameter 'lty' applied to the axis and tick
marks of the categorical (default horizontal) axis. Note
that by default the axis is suppressed.
</quote>
This makes no sense unless you know what it does already (which I don't). So
this is more of a programmers cleft note in a 'common language' than a
function
documentation page.
<quote>
say 'mp', giving the coordinates of _all_ the bar midpoints drawn,
</quote>
Say what?
Look at the help page for "par" for explanations of "cex" and "lty". The use of 'mp' is as a variable, as in > mp <- barplot(....) The next paragraph refers to this variable. -- Tony Plate At Monday 05:12 PM 11/1/2004, dan@bolser.co.uk wrote:>Full_Name: Dan B >Version: R 2.0.0 (2004-10-04). >OS: Fedora 2 >Submission from: (NULL) (80.6.127.185) > > >The man page for barplot (?barplot) is confusing... > ><quote> >cex.axis: expansion factor for numeric axis labels. >cex.names: expansion factor for axis names (bar labels). ></quote> > >What is an 'expansion factor', and what does it do in this context? > > ><quote> >axis.lty: the graphics parameter 'lty' applied to the axis and tick > marks of the categorical (default horizontal) axis. Note > that by default the axis is suppressed. ></quote> > >This makes no sense unless you know what it does already (which I don't). So >this is more of a programmers cleft note in a 'common language' than a >function >documentation page. > ><quote> >say 'mp', giving the coordinates of _all_ the bar midpoints drawn, ></quote> > >Say what? > >______________________________________________ >R-devel@stat.math.ethz.ch mailing list >https://stat.ethz.ch/mailman/listinfo/r-devel
> From: Tony Plate > > At Tuesday 10:00 AM 11/2/2004, Dan Bolser wrote: > > >Would you mind telling me how to get at the documentation > source code? > > Download and unpack the source, then look for the appropriate .Rd > file. For example, in my copy of the source for R-1.9.1 > (old, don't work > with this!), I find > C:\R\R-1.9.1\src\library\graphics\man\barplot.Rd (If > this is not the appropriate source file, someone please say so!)Starting with R-2.0.0, the Windows binary installer has an option for installing the Rd files for at least R itself (not sure about recommended packages), I believe exactly for the purpose that users can submit suggested patches.> >Is there a - how to change the documentation document? ( I > will make one > >if you give me some instructions.... > > I don't think such a document exists, but I'm not the person > to help with this.The `Writing R Extensions' manual has a section on how to write the Rd file. I'm not sure how one would write a document that describes how to change a Rd file...> >I guess I can just edit a copy of the source and diff the > original and > >send the diff ? > > Again, a member of R-core who might actually vet the changes > and put them > into the repository would be the appropriate one to comment on this. > > Previous topics with the subject "Help Documentation" (which > got filed with > bug report numbers 6713, 6716, and 6717) also address this > issue. (these > appeared in March 2004).When I find typos in the documentation, I just post them to R-devel. R Core has been very responsive to such posts. Best, Andy> -- Tony Plate > > ______________________________________________ > R-devel@stat.math.ethz.ch mailing list > https://stat.ethz.ch/mailman/listinfo/r-devel > >