From a453e2675ba1827ca5e9b5429fb171173528ee91 Mon Sep 17 00:00:00 2001
From: Robson Cruz <deadpyxel@users.noreply.github.com>
Date: Sat, 6 Nov 2021 17:39:09 -0300
Subject: [PATCH] git-changelog: add page (#7359)

---
 pages/common/git-changelog.md | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 pages/common/git-changelog.md

diff --git a/pages/common/git-changelog.md b/pages/common/git-changelog.md
new file mode 100644
index 000000000..25a56ada9
--- /dev/null
+++ b/pages/common/git-changelog.md
@@ -0,0 +1,33 @@
+# git changelog
+
+> Generate a changelog report from repository commits and tags.
+> Part of `git-extras`.
+> More information: <https://github.com/tj/git-extras/blob/master/Commands.md#git-changelog>.
+
+- Update existing file or create a new `History.md` file with the commit messages since the latest Git tag:
+
+`git changelog`
+
+- List commits from the current version:
+
+`git changelog --list`
+
+- List a range of commits from the tag named `2.1.0` to now:
+
+`git changelog --list --start-tag {{2.1.0}}`
+
+- List pretty formatted range of commits between the tag `0.5.0` and the tag `1.0.0`:
+
+`git changelog --start-tag {{0.5.0}} --final-tag {{1.0.0}}`
+
+- List pretty formatted range of commits between the commit `0b97430` and the tag `1.0.0`:
+
+`git changelog --start-commit {{0b97430}} --final-tag {{1.0.0}}`
+
+- Specify `CHANGELOG.md` as the output file:
+
+`git changelog {{CHANGELOG.md}}`
+
+- Replace contents of current changelog file entirely:
+
+`git changelog --prune-old`