<p>This is a typical question for someone learning R. R's docs are essentially incomprehensible for newbies, especially if someone's learning statistics at the same time. In fact many R old dogs tell newcomers to Google the answers when they complain for poor documentation.</p>

<p>Therefore, I don't think we should be supporting R programmers here. It would only perpetuate the unacceptable state of this package's documentation. Whoever cares for R should contribute to its documentation directly. It's open source software, so it's easy enough to do.</p>

<p>Take a look at examples of F-test documentation in <a href="https://stat.ethz.ch/R-manual/R-patched/library/stats/html/var.test.html" rel="nofollow">R</a> and <a href="http://www.stata.com/manuals13/rtest.pdf" rel="nofollow">Stata</a>. R's examples are four lines of code with two lines of comments like "# Do x and y have the same variance?". Stata's doc has 10 fully documented examples with comprehensible text. The biggest difference is that Stata's help (in 19 pages!) is pretty much self-contained. This is very important for a beginner. An experienced dude will get a clue from R's doc, and will know what to do or will know where to get the rest information. The newbie will check the doc, get no idea of how to use the function and come here to ask a question. Stata and other commercial packages figured that a new user needs self-contained help sections, where the help has 99% of what you need to run the function.</p>

<p>Is it very difficult to write this in R? No. It's boring and time consuming, but whoever wrote the code must know all the stuff that Stata guys know. In fact, that's what I do quite often when using R's functions: I go pull SAS or Stata's doc to understand the method, then simply check the syntax in R's docs. This must stop. The basic usage of the R's functions should be explained in R's documentation, so we should stop supporting R users in this regard.</p>
