# doclisting

doclisting automatically generates itemized lists of methods for a
generic function, suitable for inclusion in roxygen2 documentation. Each
method links to its help topic, and methods from other packages are
clearly labeled.

## Installation

You can install the released version from CRAN:

``` r
install.packages("doclisting")
```

Or the development version from GitHub:

``` r
pak::pak("hadley/doclisting")
```

## Usage

[`methods_list()`](https://doclisting.r-lib.org/reference/methods_list.md)
and
[`methods_inline()`](https://doclisting.r-lib.org/reference/methods_list.md)
generate Rd markup listing all methods for a generic:

``` r
cat(doclisting::methods_list("mean"))
#> \itemize{
#>   \item \code{\link[=Dates]{Date}}
#>   \item \code{default}
#>   \item \code{\link[=difftime]{difftime}}
#>   \item \code{\link[=DateTimeClasses]{POSIXct}}
#>   \item \code{\link[=DateTimeClasses]{POSIXlt}}
#>   \item \code{quosure} (\pkg{rlang})
#> }
cat(doclisting::methods_inline("mean"))
#> \code{\link[=Dates]{Date}}, \code{default}, \code{\link[=difftime]{difftime}},
#> \code{\link[=DateTimeClasses]{POSIXct}},
#> \code{\link[=DateTimeClasses]{POSIXlt}}, \code{quosure} (\pkg{rlang})
```

You can use it in roxygen2 documentation in two ways:

- Compute methods when the package is documented (i.e. at
  `devtools::document()` time), use inline R code in your roxygen
  comment:

  ``` R
  #' @description
  #' `r doclisting::methods_list("my_generic")`
  ```

  You’ll need to add `doclisting` to `Suggests`.

- Compute methods when documentation is rendered (i.e. at `?` time), use
  an Rd code block:

  ``` R
  #' @description
  #' `Rd doclisting::methods_list("my_generic")`
  ```

  You’ll need to add `doclisting` to `Imports` and add dummy call to
  [`methods_list()`](https://doclisting.r-lib.org/reference/methods_list.md)
  to eliminate the R CMD check note:

  ``` r
  ignore_unused_imports <- function() {
      doclisting::methods_list
  }
  ```

# Package index

## List methods

- [`methods_list()`](https://doclisting.r-lib.org/reference/methods_list.md)
  [`methods_inline()`](https://doclisting.r-lib.org/reference/methods_list.md)
  : List methods for a generic