On Mon, Jun 15, 2009 at 5:42 AM, Philippe Grosjean <phgrosj...@sciviews.org>wrote:
> Ironically, this function is present since the beginning, although a little > buggy. If you try this in R on a computer that is connected to the Internet: > > wikihelp <- function(topic) > browseURL(paste("http://wiki.r-project.org/rwiki/rhelp.php?id=", > topic, sep = "")) > wikihelp("barplot") > > You got the help page of ?barplot in wiki format (with a few presentation > bugs, but everything is there, basically)... plus a Wiki discussion section > where people can add more material, links, etc. > > The help page is not physically contained in the wiki page, but it is a > file stored elsewhere on the R Wiki server, and that is supposed to be > updated regularly (but it is not the case for the moment). In the wiki page > you see, there is only a ~~RDOC~~ marker indicating where to include the > help page. > > I have a problem with the R Wiki cache: until someone adds comments to such > a page, the content is not refreshed, but you just see ~~RDOC~~. > You can add the ~~NOCACHE~~ string at the page for refresh the cache every time that someone open it. > > Try, for instance: > > wikihelp("chisq.test") > > If the engine thinks 'topic' is ambiguous, it displays a list of > possibilities (i.e., our wikihelp() function is somehow a mix of help() and > of apropos()). For instance: > > wikihelp("help") > > > This should not be ambiguous, but it is considered as it currently by > rhelp.php (a minor bug probably easy to correct). > > Finally, all wiki pages are spelled with lowercase. It is the same for help > pages. So, > > wikihelp("RSiteSearch") > wikihelp("rsitesearch") > > lead to the same rdoc:utils:rsitesearch wiki page. I have no solutions for > that! > > So, to conclude, most of the required mechanism is already installed on R > Wiki. It just needs a little bit of debugging and fine-tuning to become > completely operational. A little help here would be very appreciated! > > ... and, of course, a refined version of the wikihelp() function must be > made widely available to "reveal" this function. One could even consider to > write a pager that displays local help page and warns if there are comments > on this topic posted on the wiki... or that link to a personal wiki engine > where everybody could add its own comments to the help pages, with full-text > search ability! > > Best, > > Philippe Grosjean > > ..............................................<°}))><........ > ) ) ) ) ) > ( ( ( ( ( Prof. Philippe Grosjean > ) ) ) ) ) > ( ( ( ( ( Numerical Ecology of Aquatic Systems > ) ) ) ) ) Mons-Hainaut University, Belgium > ( ( ( ( ( > .............................................................. > > > Gabor Grothendieck wrote: > >> In PHP and also in MySQL the manual has a wiki capability >> so that users can add notes at the end of each page, e.g. >> >> http://www.php.net/manual/en/functions.variable-functions.php >> >> http://dev.mysql.com/doc/refman/4.1/en/update.html >> >> That would combine documentation and wiki into one. Here it would >> involve copying the R help pages into the wiki in a readonly mode with the >> writeable wiki portion at the end of each such page. It would also be >> necessary to be able to update the help pages in the wiki when new >> versions >> became available. >> >> No explicit email group or coordination would be needed. It would also >> address >> the organization problem as they could be organized as they are now, i.e. >> into >> packages: base, stats, utils, ... >> >> It would require the development of a program to initially copy the help >> pages >> and to update them while keeping the notes in place whenever a new version >> of R came out. >> >> On Sun, Jun 14, 2009 at 5:35 PM, Peter >> Flom<peterflomconsult...@mindspring.com> wrote: >> >>> I certainly don't have anything against the WIKI, but I think that the >>> documentation >>> is where the action is, especially for newbies. It's the natural first >>> step >>> when you want to learn about a function or when you get an error message >>> you >>> don't understand. >>> >>> Peter >>> >>> Peter L. Flom, PhD >>> Statistical Consultant >>> www DOT peterflomconsulting DOT com >>> >>> ______________________________________________ >>> R-help@r-project.org mailing list >>> https://stat.ethz.ch/mailman/listinfo/r-help >>> PLEASE do read the posting guide >>> http://www.R-project.org/posting-guide.html >>> and provide commented, minimal, self-contained, reproducible code. >>> >>> >> >> > ______________________________________________ > R-help@r-project.org mailing list > https://stat.ethz.ch/mailman/listinfo/r-help > PLEASE do read the posting guide > http://www.R-project.org/posting-guide.html > and provide commented, minimal, self-contained, reproducible code. > -- Henrique Dallazuanna Curitiba-Paraná-Brasil 25° 25' 40" S 49° 16' 22" O [[alternative HTML version deleted]]
______________________________________________ R-help@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-help PLEASE do read the posting guide http://www.R-project.org/posting-guide.html and provide commented, minimal, self-contained, reproducible code.