[PATCH] Documentation: updated documentation for git commit --date
flat view
STALE2023d
From: Chinmoy via GitGitGadget <hidden>
Date: 2021-03-28 10:20:29
Subsystem:
documentation, the rest · Maintainers:
Jonathan Corbet, Linus Torvalds
From: Chinmoy Chakraborty <redacted>
This commit lists the special strings used with `--date`
in `git-commit.txt` and also a brief explanation about
the strings in `date-formats.txt`.
Signed-off-by: Chinmoy Chakraborty <redacted>
---
Documentation: updated documentation for git commit --date
This commit lists the special strings used with --date in git-commit.txt
and also a brief explanation about the strings in date-formats.txt.
Signed-off-by: Chinmoy Chakraborty chinmoy12c@gmail.com
Related Issue
=============
#302
Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-918%2Fchinmoy12c%2Fissue_302-v1
Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-918/chinmoy12c/issue_302-v1
Pull-Request: https://github.com/gitgitgadget/git/pull/918
Documentation/date-formats.txt | 32 ++++++++++++++++++++++++++++++++
Documentation/git-commit.txt | 5 ++++-
2 files changed, 36 insertions(+), 1 deletion(-)
diff --git a/Documentation/date-formats.txt b/Documentation/date-formats.txt
index 99c455f51c04..66dae179eb66 100644
--- a/Documentation/date-formats.txt
+++ b/Documentation/date-formats.txt@@ -1,6 +1,38 @@ +[[DATE FORMATS]] DATE FORMATS ------------ +`yesterday`:: + Change commit time to yesterday, that is, 24 hours ago. + +`noon`:: + Change commit time to noon, that is 12:00. If current + time is less than 12:00, the time will be set to 12:00 + on the previous day, else it will be set to 12:00 on + the same day. + +`midnight`:: + Change commit time to midnight, that is, 00:00. + +`tea`:: + Change commit time to 17:00(tea time). If the current + time is less than 17:00, the time will be set to 17:00 + on the previous day, else it will be set to 17:00 on + the same day. + +`PM`:: + Change commit time from AM to PM. If the current time + is already greater than 12:00, then the time remains + unaltered. + +`AM`:: + Change commit time from PM to AM. If current time is + already less than 12:00, then the time remains + unaltered. + +`now`:: + Change commit time to current time. + The `GIT_AUTHOR_DATE` and `GIT_COMMITTER_DATE` environment variables support the following date formats:
diff --git a/Documentation/git-commit.txt b/Documentation/git-commit.txt
index 3c69f461c9af..b2f51cdcafaf 100644
--- a/Documentation/git-commit.txt
+++ b/Documentation/git-commit.txt@@ -176,7 +176,10 @@ See linkgit:git-rebase[1] for details. the commit author is then copied from the first such commit found. --date=<date>:: - Override the author date used in the commit. + Override the author date used in the commit. The value of <date> + may be any one of the following special values - "yesterday", + "noon", "midnight", "tea", "PM", "AM", "never", "now" + (see <<DATE FORMATS>>). -m <msg>:: --message=<msg>::
base-commit: 84d06cdc06389ae7c462434cb7b1db0980f63860 -- gitgitgadget