SCM

SCM Repository

[inlinedocs] View of /pkg/inlinedocs/man/inlinedocs-package.Rd
ViewVC logotype

View of /pkg/inlinedocs/man/inlinedocs-package.Rd

Parent Directory Parent Directory | Revision Log Revision Log


Revision 70 - (download) (as text) (annotate)
Fri Jan 15 09:42:36 2010 UTC (9 years, 7 months ago) by kmpont
File size: 977 byte(s)
Completed experimental implementation for S3 classes using R.oo.

1) Search for comments preceding definition now uses parse on file
   insteadof grep via new method extract.file.parse. This works for more
   ways of defining values and does not require blank lines after
   definitions.

2) When an S3 generic is defined using setMethodS3:
a) the generic is documented with a copy of the inline documentation for the
   specific.
b) (Very experimental!) further definitions of the same generic inherit
   documentation from the first version defined in the same source file.
   The idea is to avoid repeating documentation when defining the generic
   repeatedly for an inheritance hierarchy.
   Thus if an argument is not documented, the documentation from the first
   version of the generic will be used. At present this applies to _all_
   documentation entries, but that may be reduced in the future.

3) Further minor tweaks:
a) fixes to work around package.skeleton issue: if a default argument
   contains a "%" character, then it should be escaped in the skeleton
   \usage, but is not, causing things to break nastily.
b) If documentation for an object contains an explicit title but no
   description, then the title is copied into the description in order
   to avoid warnings from the package checking process which requires
   description to be present. The idea here is to simplify generating
   documentation for small methods by reducing it to the bare minimum.
\name{inlinedocs-package}
\alias{inlinedocs-package}
\docType{package}
\title{Convert inline comments to documentation}
\description{Generates Rd files from R source code with comments, providing for quick, sustainable package development. The syntax keeps code and documentation close together, and is inspired by the Don't Repeat Yourself principle.}
\details{
\tabular{ll}{Package: \tab inlinedocs\cr
Title: \tab Convert inline comments to documentation\cr
Type: \tab Package\cr
Version: \tab 1.1\cr
Date: \tab 2009-11-30\cr
Author: \tab Toby Dylan Hocking, Keith Ponting\cr
Maintainer: \tab Toby Dylan Hocking <toby.hocking@inria.fr>, Keith Ponting <k.ponting@aurix.com>\cr
URL: \tab http://inlinedocs.r-forge.r-project.org\cr
Depends: \tab methods\cr
License: \tab GPL-3\cr
LazyLoad: \tab yes\cr}
}
\author{Toby Dylan Hocking <toby.hocking@inria.fr>, Keith Ponting <k.ponting@aurix.com>}
\references{
}
\keyword{ package }
\seealso{
}
\examples{}

root@r-forge.r-project.org
ViewVC Help
Powered by ViewVC 1.0.0  
Thanks to:
Vienna University of Economics and Business Powered By FusionForge