## Installation
## Usage
```
git-cliff [FLAGS] [OPTIONS] [RANGE]
```
**Flags:**
```
-v, --verbose Increases the logging verbosity
-l, --latest Processes the commits starting from the latest tag
-u, --unreleased Processes the commits that do not belong to a tag
-h, --help Prints help information
-V, --version Prints version information
```
**Options:**
```
-c, --config Sets the configuration file [env: CONFIG=] [default: cliff.toml]
-w, --workdir Sets the working directory [env: WORKDIR=]
-r, --repository Sets the repository to parse commits from [env: REPOSITORY=]
-p, --changelog Prepends entries to the given changelog file [env: CHANGELOG=]
-o, --output Writes output to the given file [env: OUTPUT=]
-t, --tag Sets the tag for the latest version [env: TAG=]
-b, --body Sets the template for the changelog body [env: TEMPLATE=]
-s, --strip Strips the given parts from the changelog [possible values: header, footer, all]
```
**Args:**
```
Sets the commit range to process
```
### Docker
The easiest way of running **git-cliff** (in the git root directory) is to use the [available tags](https://hub.docker.com/repository/docker/orhunp/git-cliff/tags) from [Docker Hub](https://hub.docker.com/repository/docker/orhunp/git-cliff):
```sh
docker run -t -v "$(pwd)":/app/ orhunp/git-cliff:latest
```
Or you can use the image from the [GitHub Package Registry](https://github.com/orhun/git-cliff/packages/841947):
```sh
docker run -t -v "$(pwd)":/app/ docker.pkg.github.com/orhun/git-cliff/git-cliff:latest
```
Also, you can build the image yourself using `docker build -t git-cliff .` command.
## Examples
## License
GNU General Public License ([v3.0](https://www.gnu.org/licenses/gpl.txt))
## Copyright
Copyright © 2021, [git-cliff contributors](mailto:git-cliff@protonmail.com)