[R-pkg-devel] Public URLs for help for versions of base packages
David Hugh-Jones
d@v|dhughjone@ @end|ng |rom gm@||@com
Fri Jun 30 18:08:09 CEST 2023
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 <murdoch.duncan using gmail.com>
wrote:
> I agree, really nice.
>
> One suggestion would be to check for the existence of the corresponding
> topic link.
>
> For example,
> <https://hughjonesd.github.io/r-help/2.9.0/graphics/plot.html> links to
> <https://stat.ethz.ch/R-manual/R-patched/library/graphics/html/plot.html>,
>
> which doesn't exist. The generic is now in the base package, at
> <https://stat.ethz.ch/R-manual/R-patched/library/base/html/plot.html>.
>
> 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 <
> davidhughjones using 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 <murdoch.duncan using gmail.com
> >
> >>> 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.duncan using gmail.com
> >>>>> <mailto:murdoch.duncan using 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/
> >>>>> <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
> >>>>> <jdnewmil using dcn.davis.ca.us <mailto:jdnewmil using 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 <
> >>>>> >> davidhughjones using gmail.com <mailto:davidhughjones using 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
> >>>>> <krylov.r00t using gmail.com <mailto:krylov.r00t using gmail.com>> wrote:
> >>>>> >>>
> >>>>> >>>> On Thu, 29 Jun 2023 20:22:47 +0100
> >>>>> >>>> David Hugh-Jones <davidhughjones using gmail.com
> >>>>> <mailto:davidhughjones using 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/
> >>>>> <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
> >>>>> <
> https://svnbook.red-bean.com/nightly/en/svn.branchmerge.using.html
> >>>>>
> >>>>> >>>>
> >>>>> >>
> >>>>> >> --
> >>>>> >> Sent from my phone. Please excuse my brevity.
> >>>>> >>
> >>>>> >> ______________________________________________
> >>>>> >> R-package-devel using r-project.org
> >>>>> <mailto:R-package-devel using r-project.org> mailing list
> >>>>> >> https://stat.ethz.ch/mailman/listinfo/r-package-devel
> >>>>> <https://stat.ethz.ch/mailman/listinfo/r-package-devel>
> >>>>> >>
> >>>>>
> >>>>
> >>>> --
> >>> Sent from Gmail Mobile
> >>>
> >>
> >> [[alternative HTML version deleted]]
> >>
> >> ______________________________________________
> >> R-package-devel using r-project.org mailing list
> >> https://stat.ethz.ch/mailman/listinfo/r-package-devel
> >
> > ______________________________________________
> > R-package-devel using r-project.org mailing list
> > https://stat.ethz.ch/mailman/listinfo/r-package-devel
>
> ______________________________________________
> R-package-devel using r-project.org mailing list
> https://stat.ethz.ch/mailman/listinfo/r-package-devel
>
[[alternative HTML version deleted]]
More information about the R-package-devel
mailing list