[PATCH] Specified the expected formats of dates and timestamps in rev-list-options.

Rhodes, Kate· Mar 11, 2008, 03:41 UTC · lore

The docs didn't give users any indication of the expected format of dates or timestamps. Now they do.

---

Documentation/rev-list-options.txt | 9 +++++++-- 1 files changed, 7 insertions(+), 2 deletions(-)

Show changes to Documentation/rev-list-options.txt +7 −6

diff --git a/Documentation/rev-list-options.txt b/Documentation/rev- 
list-options.txt
index a8138e2..bf0b881 100644
--- a/Documentation/rev-list-options.txt
+++ b/Documentation/rev-list-options.txt
@@ -124,15 +124,20 @@ limiting may be applied.

--since='date', --after='date'::

-	Show commits more recent than a specific date.
+	Show commits more recent than a date specified relatively
+	(e.g. "2 hours ago") or with any ISO 8601 or RFC 2822
+	date syntax.
+

--until='date', --before='date'::

-	Show commits older than a specific date.
+	Show commits older than a date specified relatively (e.g.
+	"2 hours ago") or with any ISO 8601 or RFC 2822 date syntax.

--max-age='timestamp', --min-age='timestamp'::

	Limit the commits output to specified time range.
+	The 'timestamp' should be the interger seconds since the epoch.

--author='pattern', --committer='pattern'::

-- 
1.5.4.1.1278.gc75be

Junio C Hamano· Mar 11, 2008, 06:48 UTC · re: Rhodes, Kate · lore

Re: [PATCH] Specified the expected formats of dates and timestamps in rev-list-options.

"Rhodes, Kate" <masukomi@gmail.com> writes:

> The docs didn't give users any indication of the expected format of
> dates or timestamps. Now they do.
>
> ---

Please look at other commits and follow the examples. Even though you are describing what you did in the past, the title line do not use past tense (e.g. "Distimmed doshes"), but imperative mood (e.g. "Distim doshes").

Sign your patch.

Show 13 quoted lines

> --since='date', --after='date'::
>
> -	Show commits more recent than a specific date.
> +	Show commits more recent than a date specified relatively
> +	(e.g. "2 hours ago") or with any ISO 8601 or RFC 2822
> +	date syntax.
>
> --until='date', --before='date'::
>
> -	Show commits older than a specific date.
> +	Show commits older than a date specified relatively (e.g.
> +	"2 hours ago") or with any ISO 8601 or RFC 2822 date syntax.
>

s/any //;

How about giving a few examples after this entry instead?

> --max-age='timestamp', --min-age='timestamp'::
>
> 	Limit the commits output to specified time range.
> +	The 'timestamp' should be the interger seconds since the epoch.

"the number of seconds since the epoch".

Show 8 quoted lines

> --author='pattern', --committer='pattern'::
>
> --
> 1.5.4.1.1278.gc75be
> --
> To unsubscribe from this list: send the line "unsubscribe git" in
> the body of a message to majordomo@vger.kernel.org
> More majordomo info at  http://vger.kernel.org/majordomo-info.html

patchSpecified the expected formats of dates and timestamps in rev-list-options.