From maechler at stat.math.ethz.ch  Fri Aug  5 14:18:48 2005
From: maechler at stat.math.ethz.ch (Martin Maechler)
Date: Fri, 5 Aug 2005 14:18:48 +0200
Subject: [Rd] R CMD check failing to warn when it should
In-Reply-To: <eb555e660508031152696cd9fd@mail.gmail.com>
References: <eb555e660508031152696cd9fd@mail.gmail.com>
Message-ID: <17139.22824.74202.313633@stat.math.ethz.ch>

>>>>> "DeepS" == Deepayan Sarkar <deepayan.sarkar at gmail.com>
>>>>>     on Wed, 3 Aug 2005 13:52:32 -0500 writes:

    DeepS> Hi, I recently made changes to lattice code which
    DeepS> needed changes in many man pages as well. Before I
    DeepS> made the appropriate changes, R CMD check was
    DeepS> flagging most of the problems correctly, except for
    DeepS> the man page for tmd. I have created a toy package
    DeepS> that shows this, available at

    DeepS> http://www.stat.wisc.edu/~deepayan/R/tmdprob_0.12-2.tar.gz

    DeepS> This passes R CMD check on R 2.1.0 and r-devel from
    DeepS> August 1, but it shouldn't because the code and
    DeepS> documentation are inconsistent.

It's because you use \synopsis{}.  
This basically breaks all 'codoc' checking and is the reason
we (mainly Kurt, but I completely agree with him) have been
thinking about deprecating its use -- possibly using a
substitute for the few cases that might need something like it.

Kurt and I (at least) would very strongly advocate not to use
\synopsis{}, and hence writing functions and methods in a way
that can be well documented with exact \usage{....}.

Martin



[Rd] R CMD check failing to warn when it should
Martin Maechler