R-alpha: Environment strangeness
Kurt Hornik <hornik@ci.tuwien.ac.at> writes:
Peter Dalgaard BSA writes:
Robert Gentleman <rgentlem@stat.auckland.ac.nz> writes:
Ross and I have been back and forth on this one a few times already; it's probably a faq (Kurt);
^^^^^
This belongs on the *manual page*. I suggest something along these lines:
...
Perhaps as a compromise, we could put something like the above into the man page, AND I'll add something in the FAQ?
Certainly. A "Fine points" section in the FAQ would be very nice indeed. It could contain several items of the "looks wrong, but isn't" variety as well as "debatable, but it was done this way, because..." and "bug compatible with S-Plus". On the other hand, the FAQ might not be the preferred document for online help during programming, whereas the manpages would typically be the first place to look. Therefore, it is a very good idea to put a terse description of any counterintuitive behaviour on the man page. One could probably argue that the man page addition that I suggested is a bit on the verbose side. "That won't work, do this instead" should suffice on the man page, whereas a fuller explanation could go in the FAQ.
O__ ---- Peter Dalgaard Blegdamsvej 3 c/ /'_ --- Dept. of Biostatistics 2200 Cph. N (*) \(*) -- University of Copenhagen Denmark Ph: (+45) 35327918 ~~~~~~~~~~ - (p.dalgaard@biostat.ku.dk) FAX: (+45) 35327907 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- r-devel mailing list -- Read http://www.ci.tuwien.ac.at/~hornik/R/R-FAQ.html Send "info", "help", or "[un]subscribe" (in the "body", not the subject !) To: r-devel-request@stat.math.ethz.ch =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-