Auto-generate citations and references.

git-svn-id: https://svn.r-project.org/R/trunk@88542 00db46b3-68df-0310-9c12-caf00c1e9a41

Author: hornik

src/library/datasets/man/HairEyeColor.Rd

@@ -1,6 +1,6 @@
 % File src/library/datasets/man/HairEyeColor.Rd
 % Part of the R package, https://www.R-project.org
-% Copyright 1995-2018 R Core Team
+% Copyright 1995-2025 R Core Team
 % Distributed under GPL 2 or later
 
 \name{HairEyeColor}
@@ -24,8 +24,8 @@
 }
 \details{
   The Hair \eqn{\times}{x} Eye table comes from a survey of students at
-  the University of Delaware reported by \bibcite{Snee (1974)}.  The split by
-  \code{Sex} was added by Friendly (1992a) for didactic purposes.
+  the University of Delaware reported by \bibcitet{R:Snee:1974}.  The split by
+  \code{Sex} was added by \bibcitet{R:Friendly:1992a} for didactic purposes.
 
   This data set is useful for illustrating various techniques for the
   analysis of contingency tables, such as the standard chi-squared test
@@ -35,31 +35,12 @@
 \source{
   \url{http://www.datavis.ca/sas/vcd/catdata/haireye.sas}
 
-  Snee (1974) gives the two-way table aggregated over \code{Sex}.  The
+  \bibcitet{R:Snee:1974} gives the two-way table aggregated over \code{Sex}.  The
   \code{Sex} split of the \sQuote{Brown hair, Brown eye} cell was
-  changed to agree with that used by Friendly (2000).
+  changed to agree with that used by \bibcitet{R:Friendly:2000}.
 }
 \references{
-  Snee, R. D. (1974).
-  Graphical display of two-way contingency tables.
-  \emph{The American Statistician}, \bold{28}, 9--12.
-  \doi{10.2307/2683520}.
-
-  Friendly, M. (1992a).
-  Graphical methods for categorical data.
-  \emph{SAS User Group International Conference Proceedings}, \bold{17},
-  190--200.
-  \url{http://datavis.ca/papers/sugi/sugi17.pdf}
-
-  Friendly, M. (1992b).
-  Mosaic displays for loglinear models.
-  \emph{Proceedings of the Statistical Graphics Section},
-  American Statistical Association, pp.\sspace{}61--68.
-  \url{http://www.datavis.ca/papers/asa92.html}
-
-  Friendly, M. (2000).
-  \emph{Visualizing Categorical Data}.
-  SAS Institute, ISBN 1-58025-660-0.
+  \bibshow{*, R:Friendly:1992b}
 }
 \seealso{
   \code{\link{chisq.test}},

src/library/datasets/man/Puromycin.Rd

@@ -1,6 +1,6 @@
 % File src/library/datasets/man/Puromycin.Rd
 % Part of the R package, https://www.R-project.org
-% Copyright 1995-2014 R Core Team
+% Copyright 1995-2025 R Core Team
 % Distributed under GPL 2 or later
 
 \name{Puromycin}
@@ -31,21 +31,16 @@
 }
 \details{
   Data on the velocity of an enzymatic reaction were obtained
-  by \bibcite{Treloar (1974)}.  The number of counts per minute of radioactive
+  by \bibcitet{R:Treloar:1974}.  The number of counts per minute of radioactive
   product from the reaction was measured as a function of substrate
   concentration in parts per million (ppm) and from these counts the
   initial rate (or velocity) of the reaction was calculated
   (counts/min/min).  The experiment was conducted once with the enzyme
   treated with \I{Puromycin}, and once with the enzyme untreated.
 }
 \source{
-  Bates, D.M. and Watts, D.G. (1988),
-  \emph{Nonlinear Regression Analysis and Its Applications},
-  Wiley, Appendix A1.3.
-
-  Treloar, M. A. (1974), \emph{Effects of Puromycin on
-    Galactosyltransferase in Golgi Membranes}, M.Sc. Thesis, U. of
-  Toronto.
+  \bibinfo{R:Bates+Watts:1988}{note}{Appendix A1.3}
+  \bibshow{*, R:Bates+Watts:1988}
 }
 
 \seealso{

src/library/datasets/man/Theoph.Rd

@@ -1,6 +1,6 @@
 % File src/library/datasets/man/Theoph.Rd
 % Part of the R package, https://www.R-project.org
-% Copyright 1995-2011 R Core Team
+% Copyright 1995-2025 R Core Team
 % Distributed under GPL 2 or later
 
 \name{Theoph}
@@ -37,32 +37,25 @@
   }
 }
 \details{
-  \bibcite{Boeckmann, Sheiner and Beal (1994)} report data from a study by
+  \bibcitet{R:Boeckmann+Sheiner+Beal:1994} report data from a study by
   Dr. Robert Upton of the kinetics of the anti-asthmatic drug
   theophylline.  Twelve subjects were given oral doses of theophylline
   then serum concentrations were measured at 11 time points over the
   next 25 hours.
 
-  These data are analyzed in \bibcite{Davidian and Giltinan (1995)} and
-  \bibcite{Pinheiro and Bates (2000)} using a two-compartment open pharmacokinetic model,
+  These data are analyzed in \bibcitet{R:Davidian+Giltinan:1995} and
+  \bibcite{R:Pinheiro+Bates:2000} using a two-compartment open pharmacokinetic model,
   for which a self-starting model function, \code{SSfol}, is available.
 
   This dataset was originally part of package \CRANpkg{nlme}, and that has
   methods (including for \code{[}, \code{as.data.frame}, \code{plot} and
   \code{print}) for its grouped-data classes.
 }
 \source{
-  Boeckmann, A. J., Sheiner, L. B. and Beal, S. L. (1994), \emph{NONMEM
-    Users Guide: Part V}, NONMEM Project Group, University of
-  California, San Francisco.
-
-  Davidian, M. and Giltinan, D. M. (1995)
-  \emph{Nonlinear Models for Repeated Measurement Data},
-  Chapman & Hall
-  (section 5.5, p.\sspace{}145 and section 6.6, p.\sspace{}176)
-
-  Pinheiro, J. C. and Bates, D. M. (2000) \emph{Mixed-effects Models in
-    S and S-PLUS}, Springer (Appendix A.29)
+  \bibinfo{R:Davidian+Giltinan:1995}{footer}{
+    (section 5.5, p.\\\\\\sspace{}145 and section 6.6, p.\\\\\\sspace{}176)}
+  \bibinfo{R:Pinheiro+Bates:2000}{footer}{(Appendix A.29)}
+  \bibshow{*}
 }
 \seealso{\code{\link{SSfol}}}
 \examples{

src/library/datasets/man/crimtab.Rd

@@ -1,6 +1,6 @@
 % File src/library/datasets/man/crimtab.Rd
 % Part of the R package, https://www.R-project.org
-% Copyright 1995-2019 R Core Team
+% Copyright 1995-2025 R Core Team
 % Distributed under GPL 2 or later
 
 \name{crimtab}
@@ -33,7 +33,7 @@
     I had endeavoured to do so empirically.  The material used was a
     correlation table containing the height and left middle finger
     measurements of 3000 criminals, from a paper by
-    \bibcite{W. R. MacDonell (1902, p.\sspace{}219)}.
+    \bibcitet{|R:MacDonell:1902|p.\\\\\\sspace{}219)}.
     The
     measurements were written 
     out on 3000 pieces of cardboard, which were then very thoroughly
@@ -47,7 +47,7 @@
     giving us the \emph{z} of Section III.}
 
   The table is in fact page 216 and not page 219 in
-  \bibcite{MacDonell (1902)}.
+  \bibcitep{R:MacDonell:1902}.
   In the \I{MacDonell} table, the middle finger lengths were given in mm
   and the heights in feet/inches intervals, they are both converted into
   cm here.  The midpoints of intervals were used, e.g., where \I{MacDonell}
@@ -66,22 +66,7 @@
   thanks to Jean R. Lobry and \enc{Anne-Béatrice}{Anne-Beatrice} Dufour.
 }
 \references{
-  Garson, J.G. (1900).
-  The metric system of identification of criminals, as used in Great
-  Britain and Ireland.
-  \emph{The Journal of the Anthropological Institute of Great Britain
-    and Ireland}, \bold{30}, 161--198.
-  \doi{10.2307/2842627}.
-
-  MacDonell, W.R. (1902).
-  On criminal anthropometry and the identification of criminals.
-  \emph{Biometrika}, \bold{1}(2), 177--227.
-  \doi{10.2307/2331487}.
-
-  Student (1908).
-  The probable error of a mean.
-  \emph{Biometrika}, \bold{6}, 1--25.
-  \doi{10.2307/2331554}.
+  \bibshow{*, R:Garson:1900, R:Student:1908}
 }
 \examples{
 require(stats)

src/library/datasets/man/faithful.Rd

@@ -1,6 +1,6 @@
 % File src/library/datasets/man/faithful.Rd
 % Part of the R package, https://www.R-project.org
-% Copyright 1995-2018 R Core Team
+% Copyright 1995-2025 R Core Team
 % Distributed under GPL 2 or later
 
 \name{faithful}
@@ -22,14 +22,7 @@
 }
 \source{W. Härdle.}
 \references{
-  \enc{Härdle}{Haerdle}, W. (1991).
-  \emph{Smoothing Techniques with Implementation in S}.
-  New York: Springer.
-
-  Azzalini, A. and Bowman, A. W. (1990).
-  A look at some data on the Old Faithful geyser.
-  \emph{Applied Statistics}, \bold{39}, 357--365.
-  \doi{10.2307/2347385}.
+  \bibshow{*, R:Härdle:1991}
 }
 \details{
   A closer look at \code{faithful$eruptions} reveals that these are
@@ -38,7 +31,7 @@
   better version of the eruption times, see the example below.
 
   There are many versions of this dataset around:
-  \bibcite{Azzalini and Bowman (1990)} use a more complete version.
+  \bibcitet{R:Azzalini+Bowman:1990} use a more complete version.
 }
 \seealso{
   \code{geyser} in package \CRANpkg{MASS} for the \I{Azzalini}--\I{Bowman} version.

src/library/datasets/man/gait.Rd

@@ -19,18 +19,6 @@
      \item{\code{Variable}}{\code{"Hip Angle"} and \code{"Knee Angle"}}
   }
 }
-\references{
-  Olshen, R. A., Biden, E. N., Wyatt, M. P., and Sutherland, D. (1989)
-  Gait Analysis and the Bootstrap.
-  \emph{Annals of Statistics} \bold{17}, 4, 1419--1440.
-  \doi{10.1214/AOS/1176347372}
-
-  Ramsay, J. O., and Silverman, B. W. (2006)
-  \emph{Functional Data Analysis}, 2nd ed., New York: Springer.
-
-  Ramsay, J. (2023)  \emph{fda: Functional Data Analysis}.
-  R package version 6.1.4, \url{https://CRAN.R-project.org/package=fda}.
-}
 \source{
   In the FDA book (2006), p.8, \emph{\dQuote{The Motion Analysis Laboratory at
   Children's Hospital, San Diego, collected these data}}.
@@ -39,10 +27,13 @@
   This is the version of the data as in the \CRANpkg{fda} package and 
   corresponding textbooks, but with named dimensions. One record appears to be 
   duplicated from the original paper,
-  \bibcite{Olshen \abbr{et al.}\sspace(1989)}, which 
+  \bibcitet{R:Olshen+Biden+Wyatt:1989}, which 
   analyses a sample of 38 boys. The \code{gait} dataset has 39 boys but 
   \code{boy19} and \code{boy26} have identical measurements.
 }
+\references{
+  \bibshow{*, R:Ramsay+Silverman:2005, R:Ramsay:2023}
+}
 \examples{
 plot(gait[, 1, ], type = "b",
      xlim = range(gait[,,1]), ylim = range(gait[,,2]), 

src/library/datasets/man/lynx.Rd

@@ -1,33 +1,23 @@
 % File src/library/datasets/man/lynx.Rd
 % Part of the R package, https://www.R-project.org
-% Copyright 1995-2018 R Core Team
+% Copyright 1995-2025 R Core Team
 % Distributed under GPL 2 or later
 
 \name{lynx}
 \docType{data}
 \alias{lynx}
 \title{Annual Canadian Lynx trappings 1821--1934}
 \description{
-  Annual numbers of lynx trappings for 1821--1934 in Canada. Taken from
-  \bibcite{Brockwell & Davis (1991)}, this appears to be the series considered
-  by \bibcite{Campbell & Walker (1977)}.
+  Annual numbers of lynx trappings for 1821--1934 in Canada.
+  Taken from \bibcitet{R:Brockwell+Davis:1991}, this appears to be the
+  series considered by \bibcitet{R:Campbell+Walker:1977}.
 }
 \usage{lynx}
 \source{
-  Brockwell, P. J. and Davis, R. A. (1991).
-  \emph{Time Series and Forecasting Methods}.  Second edition.
-  Springer. Series G (page 557).
+  \bibinfo{R:Brockwell+Davis:1991}{footer}{Series G (page 557).}
+  \bibshow{R:Brockwell+Davis:1991}
 }
 \references{
-  Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988).
-  \emph{The New S Language}.
-  Wadsworth & Brooks/Cole.
-
-  Campbell, M. J. and Walker, A. M. (1977).
-  A Survey of statistical work on the Mackenzie River series of annual
-  Canadian lynx trappings for the years 1821--1934 and  a new analysis.
-  \emph{Journal of the Royal Statistical Society Series A}, \bold{140},
-  411--431.
-  \doi{10.2307/2345277}.
+  \bibshow{R:Becker+Chambers+Wilks:1988, R:Campbell+Walker:1977}
 }
 \keyword{datasets}

src/library/datasets/man/mtcars.Rd

@@ -1,6 +1,6 @@
 % File src/library/datasets/man/mtcars.Rd
 % Part of the R package, https://www.R-project.org
-% Copyright 1995-2018 R Core Team
+% Copyright 1995-2025 R Core Team
 % Distributed under GPL 2 or later
 
 \name{mtcars}
@@ -31,12 +31,10 @@
   }
 }
 \source{
-  Henderson and Velleman (1981),
-  Building multiple regression models interactively.
-  \emph{Biometrics}, \bold{37}, 391--411.
+  \bibshow{R:Henderson+Velleman:1981}
 }
 \note{
-  \bibcite{Henderson and Velleman (1981)} comment in a footnote to Table 1:
+  \bibcitet{R:Henderson+Velleman:1981} comment in a footnote to Table 1:
   \sQuote{Hocking [original transcriber]'s noncrucial coding of the
     Mazda's rotary engine as a straight six-cylinder engine and the
     Porsche's flat engine as a V engine, as well as the inclusion of the

src/library/datasets/man/penguins.Rd

@@ -64,47 +64,31 @@ penguins_raw
 }
 \source{
   \describe{
-    \item{\enc{Adélie}{Adelie} penguins:}{Palmer Station Antarctica \acronym{LTER} and K. Gorman (2020).
-      Structural size measurements and isotopic signatures of foraging
-      among adult male and female \enc{Adélie}{Adelie} penguins (Pygoscelis adeliae)
-      nesting along the Palmer Archipelago near Palmer Station, 2007-2009
-      ver 5. Environmental Data Initiative, \doi{10.6073/pasta/98b16d7d563f265cb52372c8ca99e60f}.}
-
-    \item{Gentoo penguins:}{Palmer Station Antarctica \acronym{LTER} and K. Gorman (2020).
-      \doi{10.6073/pasta/7fca67fb28d56ee2ffa3d9370ebda689}.}
-
-    \item{Chinstrap penguins:}{Palmer Station Antarctica \acronym{LTER} and K. Gorman (2020).
-      \doi{10.6073/pasta/c14dfcfada8ea13a17536e73eb6fbe9e}.}
+    \item{\enc{Adélie}{Adelie} penguins:}{
+      \bibshow{R:Palmer_Station_Antarctica_LTER+Gorman:2020a}
+    }
+    \item{Gentoo penguins:}{
+      \bibshow{R:Palmer_Station_Antarctica_LTER+Gorman:2020b}
+    }
+    \item{Chinstrap penguins:}{
+      \bibshow{R:Palmer_Station_Antarctica_LTER+Gorman:2020c}
+    }
   }
 
   The title naming convention for the source for the Gentoo and Chinstrap
   data is that same as for \enc{Adélie}{Adelie} penguins.
 }
-\references{
-  Gorman, K. B., Williams, T. D. and Fraser, W. R. (2014)
-  Ecological Sexual Dimorphism and Environmental Variability within a
-  Community of Antarctic Penguins (Genus Pygoscelis).
-  \emph{PLoS ONE} \bold{9}, 3, e90081; \doi{10.1371/journal.pone.0090081}.
-
-  Horst, A. M., Hill, A. P. and Gorman, K. B. (2022) 
-  Palmer Archipelago Penguins Data in the palmerpenguins R Package 
-  - An Alternative to Anderson's Irises.
-  \emph{R Journal} \bold{14}, 1; \doi{10.32614/RJ-2022-020}.
-
-  Kaye, E., Turner, H., Gorman, K. B., Horst, A. M. and Hill, A. P. (2025)
-  Preparing the Palmer Penguins Data for the \pkg{datasets} Package in R. 
-  \doi{10.5281/zenodo.14902740}.
-}
 \details{
-  \bibcite{Gorman \abbr{et al.}\sspace(2014)}
+  \bibcitet{R:Gorman+Williams+Fraser:2014}
   used the data to study sex dimorphism separately for the three species.
 
-  \bibcite{Horst \abbr{et al.}\sspace(2022)} popularized the data as an illustration 
-  for different statistical methods, as an alternative to the \code{\link{iris}} data.
+  \bibcitet{R:Horst+Presmanes_Hill+Gorman:2022} popularized the data as
+  an illustration for different statistical methods, as an alternative
+  to the \code{\link{iris}} data.
 
-  \bibcite{Kaye \abbr{et al.}\sspace(2025)} provide the scripts used to create
-  these data sets from the original source data, 
-  and a notebook reproducing results from \bibcite{Gorman \abbr{et al.}\sspace(2014)}.
+  \bibcitet{R:Kaye+Turner+Gorman:2025} provide the scripts used to
+  create these data sets from the original source data, and a notebook
+  reproducing results from \bibcitet{R:Gorman+Williams+Fraser:2014}.
 }
 \note{
   These data sets are also available in the \CRANpkg{palmerpenguins} package.  
@@ -114,6 +98,9 @@ penguins_raw
   The \code{penguins} data has some shorter variable names than the \pkg{palmerpenguins} version, 
   for compact code and data display. 
 }
+\references{
+  \bibshow{*}
+}
 \examples{
 ## view summaries
 summary(penguins)