desc_bump_version: Increase the version number in DESCRIPTION

desc_bump_versionR Documentation

Increase the version number in DESCRIPTION


The which parameter specifies which component to increase. It can be a string referring to a component: major, minor, patch or dev, or an integer scalar, for the latter components are counted from one, and the beginning. I.e. component one is equivalent to major.


desc_bump_version(which, file = ".", normalize = FALSE)



Which component to increase. See details below.


DESCRIPTION file to use. By default the DESCRIPTION file of the current package (i.e. the package the working directory is part of) is used.


Whether to "normalize" (reorder and reformat) the fields when writing back the result. See desc_normalize().


If a component is bumped, then the ones after it are zeroed out. Trailing zero components are omitted from the new version number, but if the old version number had at least two or three components, then the one will also have two or three.

The bumping of the dev version (the fourth component) is special: if the original version number had less than four components, and the dev version is bumped, then it is set to 9000 instead of 1. This is a convention often used by R developers, it was originally invented by Winston Chang.

Both $set_version() and $bump_version() use dots to separate the version number components.

See Also

Other version numbers: desc_get_version(), desc_set_version()

r-lib/desc documentation built on Sept. 17, 2022, 5:07 p.m.