Skip to content

roxygen2

8.1.0

In-Line Documentation for R

507packages depend
3.1Mdownloads / year
test coverage
13/13checks pass

Overview

About
Maintained by Hadley WickhamFirst published 2011-07-2334 releasesCRAN page ↗GitHub ↗

Generate your Rd documentation, 'NAMESPACE' file, and collation field using specially formatted comments. Writing documentation in-line with code makes it easier to keep your documentation up-to-date as your requirements change. 'roxygen2' is inspired by the 'Doxygen' system for C++.

Install

Health

CRAN checks
13OK
Slowest check: 4.3 min · r-devel-windows-x86_64
Code health
Yes
Tests · ratio 1.18
not tracked
Coverage
100%
Documentation · exports
14
Dependencies · direct
Check history
  • OK2026-08-04
    13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
  • NOTE2026-08-01
    12 OK · 1 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
  • OK2026-06-08
    12 OK · 0 NOTE · 0 WARNING · 0 ERROR · 1 FAILURE
  • ERROR2026-06-05
    12 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
  • OK2026-03-25
    14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
Show 2 earlier snapshots
  • ERROR2026-03-22
    13 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
  • OK2026-03-10
    14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

Documentation
READMEYes · 247 wordsVignettesYes · dynamicpkgdown siteNoNEWSYes · 100% structuredCode of conductNoContributing guideNo
Examples that run
89%
Documented parameters
86%
Return-value docs
27%
References docs
0%

Downloads

3.1M
CRAN downloads in the past year
Rank #192 · ~8.6K/day · ~262.3K/mo
Daily download trend is not available in this view yet.
278.1K30 days
897.7K90 days
3.1M1 year
Compare downloads with other packages →
Also on114.3K r2u97 autocran250.2K conda_forge1.3K c2d4u

Repository

Repository
662Stars
239Forks
3Open issues
4Open PRs
29Releases
2,800Commits
126Contributors
rdocumentationdevtools
2,800 commits · Last activity 2026-08-04 · +1.5% stars, 30d

Stars over time

2025-08-07 · 6142026-08-15 · 662

Repository practices

Upstream repositoryBeta

11 development-tooling and community-health practices detected across 7 families in the upstream repository

Checks run against github.com/r-lib/roxygen2 on 2026-08-09.

Continuous integration (1)
GitHub Actions
Reproducibility and dev environment (1)
Dev Container
CRAN release process (2)
cran-comments.mdrevdep/
Lint, format, editor (3)
AirVS CodeRStudio project
Show all practices
Coverage (2)
Codecov.covrignore
Governance and community (1)
Support guide
Git structural (1)
.gitattributes
How this is detected·Detection ruleset v1 (2026-07-18)

Dependencies

Declared dependencies
20 external dependencies (excludes base and recommended)
Depends (1)
R >= 4.1
LinkingTo (1)
Enhances (0)
none

Code & Tests

People & History

People (5)
Maintainer (1)
Author, Maintainer, Copyright holder
Authors (4)
Author, Maintainer, Copyright holder
Author · added in 7.0.0
Author, Copyright holder
Author, Copyright holder
Copyright holders (4)
Author, Maintainer, Copyright holder
Author, Copyright holder
Author, Copyright holder
Copyright holder, Funder · added in 7.3.0
Funders (1)
Copyright holder, Funder · added in 7.3.0
Listed in earlier versions (1)
no longer listed · 4.0.2 to 7.2.3
Package Timeline

34 releases. Pick two to compare their code metrics. R releases are shown for context.

  • 8.1.0Latest
    2026-08-05 · current release · diff ↗
  • 8.0.0
    2026-05-01 · diff ↗
  • R
    R 4.6.0 released · 2026-04-24
  • 7.3.3
    2025-09-03 · diff ↗
  • R
    R 4.5.0 released · 2025-04-11
  • 7.3.2
    2024-06-28 · diff ↗
  • R
    R 4.4.0 released · 2024-04-24
  • 7.3.1
    2024-01-22 · diff ↗
  • 7.3.0
    2024-01-11 · diff ↗
  • R
    R 4.3.0 released · 2023-04-21
  • 7.2.3
    2022-12-09 · diff ↗
  • 7.2.2
    2022-11-11 · diff ↗
  • 7.2.1
    2022-07-18 · diff ↗
  • 7.2.0
    2022-05-13 · diff ↗
  • R
    R 4.2.0 released · 2022-04-22
  • 7.1.2
    2021-09-08 · diff ↗
Show 35 earlier events
  • R
    R 4.1.0 released · 2021-05-18
  • 7.1.1
    2020-06-27 · diff ↗
  • R
    R 4.0.0 released · 2020-04-24
  • 7.1.0
    2020-03-11 · diff ↗
  • 7.0.2
    2019-12-02 · diff ↗
  • 7.0.1
    2019-11-22 · diff ↗
  • 7.0.0
    2019-11-12 · diff ↗
  • R
    R 3.6.0 released · 2019-04-26
  • 6.1.1
    2018-11-07 · diff ↗
  • 6.1.0
    2018-07-27 · diff ↗
  • R
    R 3.5.0 released · 2018-04-23
  • R
    R 3.4.0 released · 2017-04-21
  • 6.0.1
    2017-02-06 · diff ↗
  • 6.0.0
    2017-01-31 · diff ↗
  • R
    R 3.3.0 released · 2016-05-03
  • 5.0.1
    2015-11-11 · diff ↗
  • 5.0.0
    2015-10-28 · diff ↗
  • R
    R 3.2.0 released · 2015-04-16
  • 4.1.1
    2015-04-15 · diff ↗
  • 4.1.0
    2014-12-13 · diff ↗
  • 4.0.2
    2014-09-02 · diff ↗
  • 4.0.1
    2014-05-17 · diff ↗
  • 4.0.0
    2014-05-02 · diff ↗
  • R
    R 3.1.0 released · 2014-04-10
  • 3.1.0
    2014-01-29 · diff ↗
  • 3.0.0
    2013-12-06 · diff ↗
  • R
    R 3.0.0 released · 2013-04-03
  • R
    R 2.15.0 released · 2012-03-30
  • 2.2.2
    2011-12-01 · diff ↗
  • 2.2.1
    2011-11-19 · diff ↗
  • 2.2
    2011-11-12 · diff ↗
  • R
    R 2.14.0 released · 2011-10-31
  • 2.1
    2011-07-29 · diff ↗
  • 2.0
    2011-07-23
  • R
    R 2.13.0 released · 2011-04-13

Package metadata

First published
2011-07-23
Total releases
34 / 15 yrs
License
MIT + file LICENSE OSI
Minimum R
≥ 4.1
Download size
296 KB
Installed size
not tracked yet
With dependencies
not tracked yet

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("roxygen2")
Wickham, H., Posit Software, PBC, Csárdi, G., Danenberg, P., & Eugster, M. (2026). roxygen2: In-Line Documentation for R (Version 8.1.0) [Computer software]. https://doi.org/10.32614/CRAN.package.roxygen2

This is what citation() produces when a package has no citation file of its own. If it prints something else, use that.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for roxygen2 version 8.1.0 [Data set]. HJJB, LLC. Data release v2026-08-15. https://doi.org/10.5281/zenodo.21843040

From data release v2026-08-15, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy