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

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

[Rhodes, Kate]

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(-)

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

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

[Junio C Hamano]

"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.

> --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".

> --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