CRAN-blocking bug re a documentation alias

[dankelley]

I got as below for this and all the R packages that I maintain. I'll fix this up sometime today, likely starting with another package (plan) which is tiny and which will therefore go through tests quickly.

Dear maintainer,

You have file 'gsw/man/gsw.Rd' with \docType{package}, likely intended
as a package overview help file, but without the appropriate
PKGNAME-package \alias as per "Documenting packages" in R-exts.

This seems to be the consequence of the breaking change

 Using @docType package no longer automatically adds a -package alias.
 Instead document _PACKAGE to get all the defaults for package
 documentation.

in roxygen2 7.0.0 (2019-11-12) having gone unnoticed, see
<https://github.com/r-lib/roxygen2/issues/1491>.

As explained in the issue, to get the desired PKGNAME-package \alias
back, you should either change to the new approach and document the new
special sentinel

 "_PACKAGE"

or manually add

 @aliases gsw-package

if remaining with the old approach.

Please fix in your master sources as appropriate, and submit a fixed
version of your package within the next few months.

Best,
-k

[dankelley]

I've done a test for the plan package (see dankelley/plan#30) and I'll wait a day or so to see if that seems to have caused other problems.

[dankelley]

Fixed in "develop" branch, issue 2b662aa. A test follows.

$ Rscript -e "package?gsw"|head
gsw                    package:gsw                     R Documentation

R implementation of Thermodynamic Equation Of Seawater - 2010 (TEOS-10)

Description:

     Provides an R interface to the TEOS-10 / GSW (Gibbs Sea Water)
     library, partly for use by the ‘oce’ package (see
     <https://dankelley.github.io/oce/>) and partly for general use. It
     is assumed that users are familiar with the science and