On Mon, Jun 15, 2009 at 5:42 AM, Philippe Grosjean
<phgrosjean@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<peterflomconsulting@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]]


