[Rd] Wrong links in help help files? (PR#14155)
Dear R developers, ?help.search ...opens a tab in my browser (Firefox 3.5.6, Win XP): http://127.0.0.1:31642/library/utils/html/help.search.html When I click on the link for "?", (http://127.0.0.1:31642/library/utils/help/?) in the last line of "Details", I get an error message: "Server error: invalid response from R". Similarly, The link to "??" (http://127.0.0.1:31642/library/utils/help/??) found under http://127.0.0.1:31642/library/utils/html/help.html "See also" gives same error message. On the other hand, in the help text for "help" (http://127.0.0.1:31642/library/utils/html/help.html) the link to "?", found under "See also", is http://127.0.0.1:31642/library/utils/html/Question.html, which seems to be the correct link. I did not manage to find anything on this topic in recent bug reports on "Documentation" and "Documentation fixed". Best regards, Henrik Pärn > sessionInfo() R version 2.10.1 (2009-12-14) i386-pc-mingw32 locale: [1] LC_COLLATE=English_United Kingdom.1252 LC_CTYPE=English_United Kingdom.1252LC_MONETARY=English_United Kingdom.1252 LC_NUMERIC=C [5] LC_TIME=English_United Kingdom.1252 attached base packages: [1] stats graphics grDevices utils datasets methods base loaded via a namespace (and not attached): [1] tools_2.10.1 -- Henrik Pärn Centre for Conservation Biology Department of Biology Norwegian University of Science and Technology NO-7491 Trondheim Norway Office: +47 73596285 Fax: +47 73596100 Mobile: +47 90989255 E-mail: henrik.p...@bio.ntnu.no __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel
[Rd] Documentation: format of read.table help text (PR#14180)
Dear R developers, I find the format of descriptions of the arguments in the read.table help text slightly inconsistent. For example, the logical arguments comes in seven different formats, more or less explicit about the consequences of a TRUE (or FALSE): 1. check.names logical. If TRUE then the names... 2. blank.lines.skip logical: if TRUE blank lines... 3. flushlogical: if TRUE, scan... 4. header a logical value indicating whether... 5. allowEscapes logical. Should C-style [...] ? 6. stringsAsFactors logical: should character [...] ? 7. strip.white logical. Used only when... First, I believe that a consistent style would make the help text easier to follow. Second, I believe that an explicit style (sth like: "logical. If TRUE/FALSE then...") is more intuitive and thus preferable over the other styles. This might apply to other help pages as well. I fully understand that the choice of style in help text is a matter of taste and not of very high priority. Nevertheless, I just wish to mention it as a potential for improvement. Thank you for your great work with R! Best regards, Henrik R version 2.10.1 (2009-12-14) i386-pc-mingw32 locale: [1] LC_COLLATE=English_United Kingdom.1252 LC_CTYPE=English_United Kingdom.1252LC_MONETARY=English_United Kingdom.1252 LC_NUMERIC=C [5] LC_TIME=English_United Kingdom.1252 attached base packages: [1] grDevices datasets splines graphics stats tcltk utils methods base other attached packages: [1] svSocket_0.9-48 TinnR_1.0.3 R2HTML_1.59-1 Hmisc_3.7-0 survival_2.35-7 loaded via a namespace (and not attached): [1] cluster_1.12.1 grid_2.10.1 lattice_0.17-26 svMisc_0.9-56 tools_2.10.1 -- Henrik Pärn Centre for Conservation Biology Department of Biology Norwegian University of Science and Technology NO-7491 Trondheim Norway Office: +47 73596285 Fax: +47 73596100 Mobile: +47 90989255 E-mail: henrik.p...@bio.ntnu.no __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel
[Rd] help text for xlim
Dear R-developers,
A student asked me today of how to specify the limits of the x-axis. I
knew that he should use xlim, but I tried to encourage him to have a try
himself with the various help functions. I do not judge if he used the
correct search strategy or right key words, but anyway here is what he
tried: he looked at ?plot. There xlim is not mentioned. He checked ?par.
There you find xlim mentioned under the xaxs argument, but not how to
specify xlim itself. He also failed with help.search("x-axis limits")
and help.search("x-axis range") and dito apropos(). Neither did
Rsitesearch() for these terms leed him reasonably straight to the xlim.
Finally, he checked under See Also: plot.default, and there xlim is
mentioned as argument, but it does not appear in the examples.
I think it is fair enough that xlim does not appear under ?plot or ?par,
but would it be possible to add an explicit xlim example under
plot.default and perhaps to make xlim more likely to be hit by
'xlim-related' searches?
Best regards,
Henrik
> sessionInfo()
R version 2.7.0 (2008-04-22)
i386-pc-mingw32
locale:
LC_COLLATE=English_United Kingdom.1252;LC_CTYPE=English_United
Kingdom.1252;LC_MONETARY=English_United
Kingdom.1252;LC_NUMERIC=C;LC_TIME=English_United Kingdom.1252
WinXP
--
Henrik Pärn
Centre for Conservation Biology
Department of Biology
Norwegian University of Science and Technology
NO-7491 Trondheim
Norway
Office: +47 73596285
Fax: +47 73596100
Mobile: +47 90989255
E-mail: [EMAIL PROTECTED]
__
R-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel
[Rd] help text in read.table
Dear R-developers, In read.table() the argument |colClasses = "NULL" can be used to skip columns and col.names to name the variables. The first time I tried to skip columns, I naively thought that /first/ the "NULL"-columns are skipped, /then/ you name only the remaining columns actually specified. Therefore, I did not provide names (i.e. "NULL") for the (large) number of columns skipped. When I got the warning message, "Error in read.table(file = file, header = header, sep = sep, quote = quote, : more columns than column names", I realized that I have to provide col.names also for the columns skipped. Now I wonder if it might be an idea to add a sentence in the help text for colnames (and maybe for colClasses) that you need to provide colnames = "NULL", for variables with colClasses = "NULL". Well, just a thought. I take the opportunity to thank you all for your excellent work with R! Best regards, Henrik | -- Henrik Pärn Centre for Conservation Biology Department of Biology Norwegian University of Science and Technology NO-7491 Trondheim Norway Office: +47 73596285 Fax: +47 73596100 Mobile: +47 90989255 E-mail: [EMAIL PROTECTED] __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel
[Rd] help text for ave()
Dear R developers, In the help text for ave() you can read in Arguments section: "... Grouping variables, typically factors, all of the same length as x" ...and in Value: "If ... is g1,g2,". I think a description in the Arguments section of how two or more grouping variables is specified together with an Example would be very helpful. In absence of a help text I just tried if the equivalent specification in tapply would work: data(warpbreaks) str(warpbreaks) 'data.frame': 54 obs. of 3 variables: $ breaks : num 26 30 54 25 70 52 51 26 67 18 ... $ wool : Factor w/ 2 levels "A","B": 1 1 1 1 1 1 1 1 1 1 ... $ tension: Factor w/ 3 levels "L","M","H": 1 1 1 1 1 1 1 1 1 2 ... ave(x = breaks, list(wool, tension), FUN = median) Is this THE way to specify two or more grouping variables in ave()? If yes, maybe it could be used as an example. Thank you all for your great work developing R! -- Henrik Pärn Centre for Conservation Biology Department of Biology Norwegian University of Science and Technology NO-7491 Trondheim Norway Office: +47 73596285 Fax: +47 73596100 Mobile: +47 90989255 E-mail: henrik.p...@bio.ntnu.no __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel
[Rd] small typo in "CHANGES IN R VERSION 2.9.0"
Hi! In the second sub-heading in this document... http://cran.r-project.org/bin/windows/base/CHANGES.R-2.9.0 ...INSTALLATION is misspelled (INSTALLATIOM).. Really no big deal, but anyway. Cheers, Henrik -- Henrik Pärn Centre for Conservation Biology Department of Biology Norwegian University of Science and Technology NO-7491 Trondheim Norway Office: +47 73596285 Fax: +47 73596100 Mobile: +47 90989255 E-mail: henrik.p...@bio.ntnu.no __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel
