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 spec has changed
across versions, that’s another problem.

More generally, shouldn’t there be publicly available versioned
documentation? Python has had this for a long time.

David


On Fri, 30 Jun 2023 at 01:01, Jeff Newmiller 
wrote:

> 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 <
> davidhughjo...@gmail.com> wrote:
> >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 (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:
> >> https://svn.r-project.org/R/trunk/src/library/
> >>
> >> For the actual releases of R, you may have to go looking at the
> >> branches inside that repository, e.g., the following command:
> >>
> >> svn log \
> >>
> >>
> https://svn.r-project.org/R/branches/R-4-1-branch/src/library/stats/man/lm.Rd
> >>
> >> ...should tell you the history of ?lm until the latest R-4.1-patched.
> >>
> >> Do the Git mirrors track these release branches? The branching model of
> >> Subversion [*] is different from the Git model, so perhaps not.
> >>
> >> --
> >> Best regards,
> >> Ivan
> >>
> >> [*] https://svnbook.red-bean.com/nightly/en/svn.branchmerge.using.html
> >>
>
> --
> Sent from my phone. Please excuse my brevity.
>
> __
> R-package-devel@r-project.org mailing list
> https://stat.ethz.ch/mailman/listinfo/r-package-devel
>
-- 
Sent from Gmail Mobile

[[alternative HTML version deleted]]

__
R-package-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-package-devel


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 time, but I'd guess current R 
could render old Rd pages reasonably well, back to when Prof Ripley and 
I wrote Rd2HTML in R 2.9.0.  Before that, it was done by a Perl script, 
and the Rd syntax had more differences; I think the parser would likely 
die on those very old files.


Duncan Murdoch

On 29/06/2023 8:01 p.m., Jeff Newmiller wrote:

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  
wrote:

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 (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:
https://svn.r-project.org/R/trunk/src/library/

For the actual releases of R, you may have to go looking at the
branches inside that repository, e.g., the following command:

svn log \

https://svn.r-project.org/R/branches/R-4-1-branch/src/library/stats/man/lm.Rd

...should tell you the history of ?lm until the latest R-4.1-patched.

Do the Git mirrors track these release branches? The branching model of
Subversion [*] is different from the Git model, so perhaps not.

--
Best regards,
Ivan

[*] https://svnbook.red-bean.com/nightly/en/svn.branchmerge.using.html





__
R-package-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-package-devel


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  
wrote:
>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 (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:
>> https://svn.r-project.org/R/trunk/src/library/
>>
>> For the actual releases of R, you may have to go looking at the
>> branches inside that repository, e.g., the following command:
>>
>> svn log \
>>
>> https://svn.r-project.org/R/branches/R-4-1-branch/src/library/stats/man/lm.Rd
>>
>> ...should tell you the history of ?lm until the latest R-4.1-patched.
>>
>> Do the Git mirrors track these release branches? The branching model of
>> Subversion [*] is different from the Git model, so perhaps not.
>>
>> --
>> Best regards,
>> Ivan
>>
>> [*] https://svnbook.red-bean.com/nightly/en/svn.branchmerge.using.html
>>

-- 
Sent from my phone. Please excuse my brevity.

__
R-package-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-package-devel


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 (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:
> https://svn.r-project.org/R/trunk/src/library/
>
> For the actual releases of R, you may have to go looking at the
> branches inside that repository, e.g., the following command:
>
> svn log \
>
> https://svn.r-project.org/R/branches/R-4-1-branch/src/library/stats/man/lm.Rd
>
> ...should tell you the history of ?lm until the latest R-4.1-patched.
>
> Do the Git mirrors track these release branches? The branching model of
> Subversion [*] is different from the Git model, so perhaps not.
>
> --
> Best regards,
> Ivan
>
> [*] https://svnbook.red-bean.com/nightly/en/svn.branchmerge.using.html
>
-- 
Sent from Gmail Mobile

[[alternative HTML version deleted]]

__
R-package-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-package-devel


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:
https://svn.r-project.org/R/trunk/src/library/

For the actual releases of R, you may have to go looking at the
branches inside that repository, e.g., the following command:

svn log \
 https://svn.r-project.org/R/branches/R-4-1-branch/src/library/stats/man/lm.Rd

...should tell you the history of ?lm until the latest R-4.1-patched.

Do the Git mirrors track these release branches? The branching model of
Subversion [*] is different from the Git model, so perhaps not.

-- 
Best regards,
Ivan

[*] https://svnbook.red-bean.com/nightly/en/svn.branchmerge.using.html

__
R-package-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-package-devel


[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 any web page for that? Better still, an "official" source? I have
been using rdocumentation.org but it hasn't updated for a while.

Cheers,
David

[[alternative HTML version deleted]]

__
R-package-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-package-devel