Correct word usage of "timezone" in "Documentation" directory
"timezone" is two words, not one (i.e. "time zone" is correct). Correct this in these files: -- date-formats.txt -- git-blame.txt -- git-cvsimport.txt -- git-fast-import.txt -- git-svn.txt -- gitweb.conf.txt -- rev-list-options.txt Signed-off-by: Jason St. John <jstjohn@purdue.edu> Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
parent
0ecd94d7d7
commit
0ffa154b5b
@ -8,9 +8,9 @@ endif::git-commit[]
|
|||||||
support the following date formats:
|
support the following date formats:
|
||||||
|
|
||||||
Git internal format::
|
Git internal format::
|
||||||
It is `<unix timestamp> <timezone offset>`, where `<unix
|
It is `<unix timestamp> <time zone offset>`, where `<unix
|
||||||
timestamp>` is the number of seconds since the UNIX epoch.
|
timestamp>` is the number of seconds since the UNIX epoch.
|
||||||
`<timezone offset>` is a positive or negative offset from UTC.
|
`<time zone offset>` is a positive or negative offset from UTC.
|
||||||
For example CET (which is 2 hours ahead UTC) is `+0200`.
|
For example CET (which is 2 hours ahead UTC) is `+0200`.
|
||||||
|
|
||||||
RFC 2822::
|
RFC 2822::
|
||||||
|
@ -103,7 +103,7 @@ This header line is followed by the following information
|
|||||||
at least once for each commit:
|
at least once for each commit:
|
||||||
|
|
||||||
- the author name ("author"), email ("author-mail"), time
|
- the author name ("author"), email ("author-mail"), time
|
||||||
("author-time"), and timezone ("author-tz"); similarly
|
("author-time"), and time zone ("author-tz"); similarly
|
||||||
for committer.
|
for committer.
|
||||||
- the filename in the commit that the line is attributed to.
|
- the filename in the commit that the line is attributed to.
|
||||||
- the first line of the commit log message ("summary").
|
- the first line of the commit log message ("summary").
|
||||||
|
@ -144,7 +144,7 @@ This option can be used several times to provide several detection regexes.
|
|||||||
CVS by default uses the Unix username when writing its
|
CVS by default uses the Unix username when writing its
|
||||||
commit logs. Using this option and an author-conv-file
|
commit logs. Using this option and an author-conv-file
|
||||||
maps the name recorded in CVS to author name, e-mail and
|
maps the name recorded in CVS to author name, e-mail and
|
||||||
optional timezone:
|
optional time zone:
|
||||||
+
|
+
|
||||||
---------
|
---------
|
||||||
exon=Andreas Ericsson <ae@op5.se>
|
exon=Andreas Ericsson <ae@op5.se>
|
||||||
@ -154,7 +154,7 @@ This option can be used several times to provide several detection regexes.
|
|||||||
+
|
+
|
||||||
'git cvsimport' will make it appear as those authors had
|
'git cvsimport' will make it appear as those authors had
|
||||||
their GIT_AUTHOR_NAME and GIT_AUTHOR_EMAIL set properly
|
their GIT_AUTHOR_NAME and GIT_AUTHOR_EMAIL set properly
|
||||||
all along. If a timezone is specified, GIT_AUTHOR_DATE will
|
all along. If a time zone is specified, GIT_AUTHOR_DATE will
|
||||||
have the corresponding offset applied.
|
have the corresponding offset applied.
|
||||||
+
|
+
|
||||||
For convenience, this data is saved to `$GIT_DIR/cvs-authors`
|
For convenience, this data is saved to `$GIT_DIR/cvs-authors`
|
||||||
|
@ -251,7 +251,7 @@ advisement to help formatting routines display the timestamp.
|
|||||||
If the local offset is not available in the source material, use
|
If the local offset is not available in the source material, use
|
||||||
``+0000'', or the most common local offset. For example many
|
``+0000'', or the most common local offset. For example many
|
||||||
organizations have a CVS repository which has only ever been accessed
|
organizations have a CVS repository which has only ever been accessed
|
||||||
by users who are located in the same location and timezone. In this
|
by users who are located in the same location and time zone. In this
|
||||||
case a reasonable offset from UTC could be assumed.
|
case a reasonable offset from UTC could be assumed.
|
||||||
+
|
+
|
||||||
Unlike the `rfc2822` format, this format is very strict. Any
|
Unlike the `rfc2822` format, this format is very strict. Any
|
||||||
@ -271,7 +271,7 @@ the malformed string. There are also some types of malformed
|
|||||||
strings which Git will parse wrong, and yet consider valid.
|
strings which Git will parse wrong, and yet consider valid.
|
||||||
Seriously malformed strings will be rejected.
|
Seriously malformed strings will be rejected.
|
||||||
+
|
+
|
||||||
Unlike the `raw` format above, the timezone/UTC offset information
|
Unlike the `raw` format above, the time zone/UTC offset information
|
||||||
contained in an RFC 2822 date string is used to adjust the date
|
contained in an RFC 2822 date string is used to adjust the date
|
||||||
value to UTC prior to storage. Therefore it is important that
|
value to UTC prior to storage. Therefore it is important that
|
||||||
this information be as accurate as possible.
|
this information be as accurate as possible.
|
||||||
@ -287,13 +287,13 @@ format, or its format is easily convertible to it, as there is no
|
|||||||
ambiguity in parsing.
|
ambiguity in parsing.
|
||||||
|
|
||||||
`now`::
|
`now`::
|
||||||
Always use the current time and timezone. The literal
|
Always use the current time and time zone. The literal
|
||||||
`now` must always be supplied for `<when>`.
|
`now` must always be supplied for `<when>`.
|
||||||
+
|
+
|
||||||
This is a toy format. The current time and timezone of this system
|
This is a toy format. The current time and time zone of this system
|
||||||
is always copied into the identity string at the time it is being
|
is always copied into the identity string at the time it is being
|
||||||
created by fast-import. There is no way to specify a different time or
|
created by fast-import. There is no way to specify a different time or
|
||||||
timezone.
|
time zone.
|
||||||
+
|
+
|
||||||
This particular format is supplied as it's short to implement and
|
This particular format is supplied as it's short to implement and
|
||||||
may be useful to a process that wants to create a new commit
|
may be useful to a process that wants to create a new commit
|
||||||
|
@ -124,15 +124,15 @@ This automatically updates the rev_map if needed (see
|
|||||||
'$GIT_DIR/svn/\*\*/.rev_map.*' in the FILES section below for details).
|
'$GIT_DIR/svn/\*\*/.rev_map.*' in the FILES section below for details).
|
||||||
|
|
||||||
--localtime;;
|
--localtime;;
|
||||||
Store Git commit times in the local timezone instead of UTC. This
|
Store Git commit times in the local time zone instead of UTC. This
|
||||||
makes 'git log' (even without --date=local) show the same times
|
makes 'git log' (even without --date=local) show the same times
|
||||||
that `svn log` would in the local timezone.
|
that `svn log` would in the local time zone.
|
||||||
+
|
+
|
||||||
This doesn't interfere with interoperating with the Subversion
|
This doesn't interfere with interoperating with the Subversion
|
||||||
repository you cloned from, but if you wish for your local Git
|
repository you cloned from, but if you wish for your local Git
|
||||||
repository to be able to interoperate with someone else's local Git
|
repository to be able to interoperate with someone else's local Git
|
||||||
repository, either don't use this option or you should both use it in
|
repository, either don't use this option or you should both use it in
|
||||||
the same local timezone.
|
the same local time zone.
|
||||||
|
|
||||||
--parent;;
|
--parent;;
|
||||||
Fetch only from the SVN parent of the current HEAD.
|
Fetch only from the SVN parent of the current HEAD.
|
||||||
|
@ -822,18 +822,18 @@ timed::
|
|||||||
Project specific override is not supported.
|
Project specific override is not supported.
|
||||||
|
|
||||||
javascript-timezone::
|
javascript-timezone::
|
||||||
Enable and configure the ability to change a common timezone for dates
|
Enable and configure the ability to change a common time zone for dates
|
||||||
in gitweb output via JavaScript. Dates in gitweb output include
|
in gitweb output via JavaScript. Dates in gitweb output include
|
||||||
authordate and committerdate in "commit", "commitdiff" and "log"
|
authordate and committerdate in "commit", "commitdiff" and "log"
|
||||||
views, and taggerdate in "tag" view. Enabled by default.
|
views, and taggerdate in "tag" view. Enabled by default.
|
||||||
+
|
+
|
||||||
The value is a list of three values: a default timezone (for if the client
|
The value is a list of three values: a default time zone (for if the client
|
||||||
hasn't selected some other timezone and saved it in a cookie), a name of cookie
|
hasn't selected some other time zone and saved it in a cookie), a name of cookie
|
||||||
where to store selected timezone, and a CSS class used to mark up
|
where to store selected time zone, and a CSS class used to mark up
|
||||||
dates for manipulation. If you want to turn this feature off, set "default"
|
dates for manipulation. If you want to turn this feature off, set "default"
|
||||||
to empty list: `[]`.
|
to empty list: `[]`.
|
||||||
+
|
+
|
||||||
Typical gitweb config files will only change starting (default) timezone,
|
Typical gitweb config files will only change starting (default) time zone,
|
||||||
and leave other elements at their default values:
|
and leave other elements at their default values:
|
||||||
+
|
+
|
||||||
---------------------------------------------------------------------------
|
---------------------------------------------------------------------------
|
||||||
@ -843,9 +843,9 @@ $feature{'javascript-timezone'}{'default'}[0] = "utc";
|
|||||||
The example configuration presented here is guaranteed to be backwards
|
The example configuration presented here is guaranteed to be backwards
|
||||||
and forward compatible.
|
and forward compatible.
|
||||||
+
|
+
|
||||||
Timezone values can be "local" (for local timezone that browser uses), "utc"
|
Time zone values can be "local" (for local time zone that browser uses), "utc"
|
||||||
(what gitweb uses when JavaScript or this feature is disabled), or numerical
|
(what gitweb uses when JavaScript or this feature is disabled), or numerical
|
||||||
timezones in the form of "+/-HHMM", such as "+0200".
|
time zones in the form of "+/-HHMM", such as "+0200".
|
||||||
+
|
+
|
||||||
Project specific override is not supported.
|
Project specific override is not supported.
|
||||||
|
|
||||||
|
@ -720,7 +720,7 @@ include::pretty-options.txt[]
|
|||||||
`--date=relative` shows dates relative to the current time,
|
`--date=relative` shows dates relative to the current time,
|
||||||
e.g. "2 hours ago".
|
e.g. "2 hours ago".
|
||||||
+
|
+
|
||||||
`--date=local` shows timestamps in user's local timezone.
|
`--date=local` shows timestamps in user's local time zone.
|
||||||
+
|
+
|
||||||
`--date=iso` (or `--date=iso8601`) shows timestamps in ISO 8601 format.
|
`--date=iso` (or `--date=iso8601`) shows timestamps in ISO 8601 format.
|
||||||
+
|
+
|
||||||
@ -731,7 +731,7 @@ format, often found in E-mail messages.
|
|||||||
+
|
+
|
||||||
`--date=raw` shows the date in the internal raw Git format `%s %z` format.
|
`--date=raw` shows the date in the internal raw Git format `%s %z` format.
|
||||||
+
|
+
|
||||||
`--date=default` shows timestamps in the original timezone
|
`--date=default` shows timestamps in the original time zone
|
||||||
(either committer's or author's).
|
(either committer's or author's).
|
||||||
|
|
||||||
ifdef::git-rev-list[]
|
ifdef::git-rev-list[]
|
||||||
|
Loading…
Reference in New Issue
Block a user