[Roxygen-devel] S4 documentation

[Manuel J. A. Eugster]

On 11/14/11 6:21 PM, Hadley Wickham wrote:
>> In roxygen (v1) existing Rd files in the Rd directory are merged with
>> the documentation generated by roxygen based on the file name and
>> @rdname.
>>
>> Maybe we can implement something similar in roxygen2? Would that help?
>
> I really don't like mixing generated and hand-written files in the
> same directory - it just seems like a recipe for trouble.  (And makes
> source code control just that much more complicated)

Yes that's true. BTW: that reminds me that it would be nice to
have an indicater in Rd files which says that this Rd file is
generated by roxygen (maybe a comment). Would make a "make clean"
easier.


Manuel.