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,
>  links to
> ,
>
> which doesn't exist.  The generic is now in the base package, at
> .
>
> Duncan Murdoch
>
> On 30/06/2023 11:37 a.m., Ben Bolker wrote:
> > 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 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 bugs if you find
> any.
> >>
> >> Cheers,
> >> David
> >>
> >>
> >> On Fri, 30 Jun 2023 at 13:23, David Hugh-Jones <
> davidhughjo...@gmail.com>
> >> wrote:
> >>
> >>>
> >>> 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 to know if it’s possible to create 00index files
> >>> without installing the relevant package? (Loading R 0.60 is
> challenging…)
> >>>
> >>> D
> >>>
> >>>
> >>>
> >>> On Fri, 30 Jun 2023 at 13:02, Duncan Murdoch  >
> >>> wrote:
> >>>
>  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 to see
>  changes across versions, so doing that should take extra work.
> 
>  Duncan Murdoch
> 
> >
> > David
> >
> >
> > On Fri, 30 Jun 2023 at 09:55, Duncan Murdoch <
> murdoch.dun...@gmail.com
> > > 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 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
> >   mailto:jdnew...@dcn.davis.ca.us>>
> >> 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
> >   mailto:krylov.r...@gmail.com>> 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
> >

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.  The generic is now in the base package, at 
.


Duncan Murdoch

On 30/06/2023 11:37 a.m., Ben Bolker wrote:

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 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 bugs if you find any.

Cheers,
David


On Fri, 30 Jun 2023 at 13:23, David Hugh-Jones 
wrote:



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 to know if it’s possible to create 00index files
without installing the relevant package? (Loading R 0.60 is challenging…)

D



On Fri, 30 Jun 2023 at 13:02, Duncan Murdoch 
wrote:


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 to see
changes across versions, so doing that should take extra work.

Duncan Murdoch



David


On Fri, 30 Jun 2023 at 09:55, Duncan Murdoch mailto:murdoch.dun...@gmail.com>> 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 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
  mailto:jdnew...@dcn.davis.ca.us>>
   > 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
  mailto:krylov.r...@gmail.com>> wrote:
   >>>
    On Thu, 29 Jun 2023 20:22:47 +0100
    David Hugh-Jones mailto:davidhughjo...@gmail.com>> 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
<
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.

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 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 bugs if you find any.

Cheers,
David


On Fri, 30 Jun 2023 at 13:23, David Hugh-Jones 
wrote:



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 to know if it’s possible to create 00index files
without installing the relevant package? (Loading R 0.60 is challenging…)

D



On Fri, 30 Jun 2023 at 13:02, Duncan Murdoch 
wrote:


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 to see
changes across versions, so doing that should take extra work.

Duncan Murdoch



David


On Fri, 30 Jun 2023 at 09:55, Duncan Murdoch mailto:murdoch.dun...@gmail.com>> 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 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
 mailto:jdnew...@dcn.davis.ca.us>>
  > 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
 mailto:krylov.r...@gmail.com>> wrote:
  >>>
   On Thu, 29 Jun 2023 20:22:47 +0100
   David Hugh-Jones mailto:davidhughjo...@gmail.com>> 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
<
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-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 bugs if you find any.

Cheers,
David


On Fri, 30 Jun 2023 at 13:23, David Hugh-Jones 
wrote:

>
> 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 to know if it’s possible to create 00index files
> without installing the relevant package? (Loading R 0.60 is challenging…)
>
> D
>
>
>
> On Fri, 30 Jun 2023 at 13:02, Duncan Murdoch 
> wrote:
>
>> 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 to see
>> changes across versions, so doing that should take extra work.
>>
>> Duncan Murdoch
>>
>> >
>> > 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 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
>> > mailto:jdnew...@dcn.davis.ca.us>>
>> >  > 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
>> > mailto:krylov.r...@gmail.com>> 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
>> <
>> 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.
>> >  >>
>> >  >>

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 to know if it’s possible to create 00index files without
installing the relevant package? (Loading R 0.60 is challenging…)

D



On Fri, 30 Jun 2023 at 13:02, Duncan Murdoch 
wrote:

> 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 to see
> changes across versions, so doing that should take extra work.
>
> Duncan Murdoch
>
> >
> > 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 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
> > mailto:jdnew...@dcn.davis.ca.us>>
> >  > 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
> > mailto:krylov.r...@gmail.com>> 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
> <
> 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-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 to see 
changes across versions, so doing that should take extra work.


Duncan Murdoch



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 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
mailto:jdnew...@dcn.davis.ca.us>>
 > 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
mailto:krylov.r...@gmail.com>> wrote:
 >>>
  On Thu, 29 Jun 2023 20:22:47 +0100
  David Hugh-Jones mailto:davidhughjo...@gmail.com>> 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

 >>



__
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-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 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
> >>
>
>

[[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-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 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.



The wch/r-source mirror tracks the releases.  It takes svn tags and 
branches and converts them all to git branches.  For example, here's the 
help for Rd2HTML from R 2.9.0:



https://github.com/wch/r-source/blob/tags/R-2-9-0/src/library/tools/man/Rd2HTML.Rd

Duncan Murdoch

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

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



__
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-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 whole CRAN at
https://search.r-project.org/, but only for the latest version of
everything. I would expect adding support for the whole history of R
base packages to be burdensome in terms of their time too, even without
considering the history of CRAN package documentation.

I suppose you could apply for a grant from the R Consortium (which
reports revenue similar to that of the Python Software Foundation) in
September or wait until next January or February and propose a Google
Summer of Docs project in order to have it done, but people in general
seem to dislike having to support infrastructure forever from now on for
projects that linearly grow in size.

-- 
Best regards,
Ivan

__
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 
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