Ben Bolker bbol...@gmail.com
on Thu, 28 Apr 2011 10:06:01 -0400 writes:
would it be possible / make sense to copy some of the
information in ?news into the R-exts manual, where package
writers are most likely (?) to look for it?
sure...
The information therein seems more appropriate for the
extensions manual ...
you mean when we (R core) add extensions to package handling, Rd
syntax, the C API, ... and only report it in NEWS instead of
also updating the R Extensions manual?
Well, that happens as you can imagine.
In some cases, the entry in NEWS will say that a feature is
experimental, so we don't want to document it yet in stone, as
we expect the details to change.
But apart from those, I'm sure it will also happen otherwise,
since most of R core have more fun writing code than manuals
but when we are called to duty we typically eventually oblige ;-)
So, yes indeed, it makes very much sense to keep the manual as
up-to-date as possible, and some of us consider the manual to
be an important part of R's source tarball.
So, patches and even other (concrete!) proposals for
improvement are welcome.
Ideally using texinfo syntax or even better a patch towards
a current version of the manual
Rsource/doc/manual/R-exts.texi
from subversion, a nightly tarball, or simply
https://svn.r-project.org/R/trunk/doc/manual/R-exts.texi
With many thanks in advance,
Martin Maechler,
ETH Zurich
__
R-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel
