`lifecycle_linter` is returning false positives for `ggplot2::labs()`

[stephenashton-dhsc]

The lifecycle_linter is reporting (falsely) that ggplot2::labs is superseded.

This is in fact the replacement function to ggplot2::xlab and ggplot2::ylab, which are superseded (although are declared in the same file, labels.R).

[stephenashton-dhsc]

I suspect this is as they share documentation - ggplot2::labs does not have a lifecycle badge or tag, but ggplot2::xlab adds to this documentation and does include a badge, so (presumably) is flagging all of the functions with that shared documentation with the same status.

This is the roxygen2 tags from from ggplot2::xlab, which is what I believe is triggering the false positive across everything within man/lab.Rd:

#' @rdname labs
#' @export
#' @description
#' `r lifecycle::badge("superseded")`: `xlab()`, `ylab()` and `ggtitle()` are
#' superseded. It is recommended to use the `labs(x, y, title, subtitle)`
#' arguments instead.
xlab <- function(label) {
  lifecycle::signal_stage("superseded", "xlab()", "labs(x)")
  labs(x = label)
}