Skip to content

Commit

Permalink
chore: add note to the FAQ for git version support (#569)
Browse files Browse the repository at this point in the history
* chore: add note to the FAQ for git version support in the use of `git log --pretty`

Co-authored-by: fisher <[email protected]>
  • Loading branch information
steveukx and fishbar authored Feb 6, 2021
1 parent de3e831 commit 65bae89
Showing 1 changed file with 11 additions and 1 deletion.
12 changes: 11 additions & 1 deletion readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -641,7 +641,17 @@ There are a few potential reasons:
to output its logs add `@kwsites/file-exists` to your `DEBUG` environment variable. eg:

`DEBUG=@kwsites/file-exists,simple-git node ./your-app.js`


### Log format fails

The properties of `git log` are fetched using the `--pretty=format` argument which supports different tokens depending
on the version of `git` - for example the `%D` token used to show the refs was added in git `2.2.3`, for any version
before that please ensure you are supplying your own format object with properties supported by the version of git you
are using.

For more details of the supported tokens, please see the
[official `git log` documentation](https://git-scm.com/docs/git-log#_pretty_formats)

### Log response properties are out of order

The properties of `git.log` are fetched using the character sequence ` ò ` as a delimiter. If your commit messages
Expand Down

0 comments on commit 65bae89

Please sign in to comment.