mirror of
https://github.com/orhun/git-cliff.git
synced 2024-09-21 04:07:49 +03:00
docs(readme): add usage section
This commit is contained in:
parent
c697b17f67
commit
c87fbbe7cf
34
README.md
34
README.md
@ -8,11 +8,41 @@
|
|||||||
|
|
||||||
## Usage
|
## 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 <PATH> Sets the configuration file [env: CONFIG=] [default: cliff.toml]
|
||||||
|
-w, --workdir <PATH> Sets the working directory [env: WORKDIR=]
|
||||||
|
-r, --repository <PATH> Sets the repository to parse commits from [env: REPOSITORY=]
|
||||||
|
-p, --changelog <PATH> Prepends entries to the given changelog file [env: CHANGELOG=]
|
||||||
|
-t, --tag <TAG> Sets the tag for the latest version [env: TAG=]
|
||||||
|
-s, --strip <PART> Strips the given parts from the changelog [possible values: header, footer, all]
|
||||||
|
```
|
||||||
|
|
||||||
|
**Args:**
|
||||||
|
|
||||||
|
```
|
||||||
|
<RANGE> Sets the commit range to process
|
||||||
|
```
|
||||||
|
|
||||||
### Docker
|
### 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):
|
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
|
```sh
|
||||||
docker run -t -v "$(pwd)":/app/ orhunp/git-cliff:latest
|
docker run -t -v "$(pwd)":/app/ orhunp/git-cliff:latest
|
||||||
```
|
```
|
||||||
@ -25,6 +55,8 @@ docker run -t -v "$(pwd)":/app/ docker.pkg.github.com/orhun/git-cliff/git-cliff:
|
|||||||
|
|
||||||
Also, you can build the image yourself using `docker build -t git-cliff .` command.
|
Also, you can build the image yourself using `docker build -t git-cliff .` command.
|
||||||
|
|
||||||
|
## Examples
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
GNU General Public License ([v3.0](https://www.gnu.org/licenses/gpl.txt))
|
GNU General Public License ([v3.0](https://www.gnu.org/licenses/gpl.txt))
|
||||||
|
Loading…
Reference in New Issue
Block a user