Re: [R-pkg-devel] Public URLs for help for versions of base packages

2023-06-30 Thread David Hugh-Jones
I think trying to guess where topics have moved will be hard. I'll consider version links. David On Fri, 30 Jun 2023 at 17:04, Duncan Murdoch wrote: > I agree, really nice. > > One suggestion would be to check for the existence of the corresponding > topic link. > > For example, >

Re: [R-pkg-devel] Public URLs for help for versions of base packages

2023-06-30 Thread Duncan Murdoch
I agree, really nice. One suggestion would be to check for the existence of the corresponding topic link. For example, links to , which doesn't exist.

Re: [R-pkg-devel] Public URLs for help for versions of base packages

2023-06-30 Thread Ben Bolker
Nice! (I like "A longer description will go here eventually.") It would be cute/handy to have navigation links available for "go to this help page in the next (previous) version of R" (if it's not a huge pain) On 2023-06-30 11:10 a.m., David Hugh-Jones wrote: OK, so I took Jeff's hint

Re: [R-pkg-devel] Public URLs for help for versions of base packages

2023-06-30 Thread David Hugh-Jones
OK, so I took Jeff's hint and did this myself! https://github.com/hughjonesd/r-help Sample page for ?plot from the first version of R (at least, the first version that is on svn): https://hughjonesd.github.io/r-help/0.60/base/plot.html Not everything is guaranteed to work, so please report

Re: [R-pkg-devel] Public URLs for help for versions of base packages

2023-06-30 Thread David Hugh-Jones
There are plenty of places to find current docs. I think it’s fine to have versioned ones also. I agree it would be a good idea to clearly signal “hey, this is an old version” - indeed I’ve been bitten by that in python before. I’m working on this now… will see what I can do. Does anyone happen

Re: [R-pkg-devel] Public URLs for help for versions of base packages

2023-06-30 Thread Duncan Murdoch
On 30/06/2023 7:57 a.m., David Hugh-Jones wrote: Static web pages get indexed by google. Isn't that an argument against having static pages? If I do a Google search for "R lm" I think it's better to find the current docs rather than dozens of obsolete versions. It's rare that someone wants

Re: [R-pkg-devel] Public URLs for help for versions of base packages

2023-06-30 Thread David Hugh-Jones
Static web pages get indexed by google. David On Fri, 30 Jun 2023 at 09:55, Duncan Murdoch wrote: > Why store them? Download the source on demand, and convert it. Seems > pretty simple. > > Duncan Murdoch > > On 30/06/2023 1:19 a.m., David Hugh-Jones wrote: > > This is for the rcheology

Re: [R-pkg-devel] Public URLs for help for versions of base packages

2023-06-30 Thread Duncan Murdoch
On 29/06/2023 4:46 p.m., Ivan Krylov wrote: On Thu, 29 Jun 2023 20:22:47 +0100 David Hugh-Jones wrote: I'm looking for a source of online help for R base packages, which covers all versions (for some reasonable value of "all"). So e.g. the equivalent of `?lm` for R 4.1.0. These live in the

Re: [R-pkg-devel] Public URLs for help for versions of base packages

2023-06-30 Thread Duncan Murdoch
Why store them? Download the source on demand, and convert it. Seems pretty simple. Duncan Murdoch On 30/06/2023 1:19 a.m., David Hugh-Jones wrote: This is for the rcheology package. I run a Shiny web app which lets you examine changes to functions across R versions:

Re: [R-pkg-devel] Public URLs for help for versions of base packages

2023-06-30 Thread Ivan Krylov
On Fri, 30 Jun 2023 06:19:33 +0100 David Hugh-Jones wrote: > it would be burdensome in terms of data (and my time) > More generally, shouldn’t there be publicly available versioned > documentation? Python has had this for a long time. CRAN has a searchable archive of R documentation for the

Re: [R-pkg-devel] Public URLs for help for versions of base packages

2023-06-29 Thread David Hugh-Jones
This is for the rcheology package. I run a Shiny web app which lets you examine changes to functions across R versions: https://hughjonesd.shinyapps.io/rcheology/ Manually storing and converting the Rd might be possible, but it would be burdensome in terms of data (and my time). And if the Rd

Re: [R-pkg-devel] Public URLs for help for versions of base packages

2023-06-29 Thread Duncan Murdoch
R includes the tools::Rd2HTML function to convert Rd source files to HTML for display. RStudio offers previews of Rd pages; presumably they use those functions. I imagine ESS does the same. If you want to do it yourself, start with ?tools::Rd2HTML. There have been changes to the specs over

Re: [R-pkg-devel] Public URLs for help for versions of base packages

2023-06-29 Thread Jeff Newmiller
Sure. On your computer. Install the old version of R and let it serve the relevant docs. Dunno of anyone doing this historical dive online for you though. Why would you want preformatted docs if you didn't have those old versions installed? On June 29, 2023 4:23:55 PM PDT, David Hugh-Jones

Re: [R-pkg-devel] Public URLs for help for versions of base packages

2023-06-29 Thread David Hugh-Jones
That’s useful to know. But is there anywhere with preformatted HTML pages? Cheers, D On Thu, 29 Jun 2023 at 21:46, Ivan Krylov wrote: > On Thu, 29 Jun 2023 20:22:47 +0100 > David Hugh-Jones wrote: > > > I'm looking for a source of online help for R base > > packages, which covers all versions

Re: [R-pkg-devel] Public URLs for help for versions of base packages

2023-06-29 Thread Ivan Krylov
On Thu, 29 Jun 2023 20:22:47 +0100 David Hugh-Jones wrote: > I'm looking for a source of online help for R base > packages, which covers all versions (for some reasonable value of > "all"). So e.g. the equivalent of `?lm` for R 4.1.0. These live in the R source tree, under src/library:

[R-pkg-devel] Public URLs for help for versions of base packages

2023-06-29 Thread David Hugh-Jones
Dear R packagers, This isn't strictly about packaging but I thought you guys might have the most relevant expertise. I'm looking for a source of online help for R base packages, which covers all versions (for some reasonable value of "all"). So e.g. the equivalent of `?lm` for R 4.1.0. Is there