Mercurial > hg-stable
comparison mercurial/help.py @ 6163:1f733c2f0165
Document log date ranges and mention 'hg help dates' for all commands (issue998)
author | Thomas Arendsen Hein <thomas@intevation.de> |
---|---|
date | Fri, 22 Feb 2008 21:18:48 +0100 |
parents | f077815932ce |
children | 2713e42dcf4e |
comparison
equal
deleted
inserted
replaced
6162:554715e584e6 | 6163:1f733c2f0165 |
---|---|
6 # of the GNU General Public License, incorporated herein by reference. | 6 # of the GNU General Public License, incorporated herein by reference. |
7 | 7 |
8 helptable = { | 8 helptable = { |
9 "dates|Date Formats": | 9 "dates|Date Formats": |
10 r''' | 10 r''' |
11 Some commands (backout, commit, tag) allow the user to specify a date. | 11 Some commands allow the user to specify a date: |
12 Many date formats are acceptible. Here are some examples: | 12 backout, commit, import, tag: Specify the commit date. |
13 log, revert, update: Select revision(s) by date. | |
14 | |
15 Many date formats are valid. Here are some examples: | |
13 | 16 |
14 "Wed Dec 6 13:18:29 2006" (local timezone assumed) | 17 "Wed Dec 6 13:18:29 2006" (local timezone assumed) |
15 "Dec 6 13:18 -0600" (year assumed, time offset provided) | 18 "Dec 6 13:18 -0600" (year assumed, time offset provided) |
16 "Dec 6 13:18 UTC" (UTC and GMT are aliases for +0000) | 19 "Dec 6 13:18 UTC" (UTC and GMT are aliases for +0000) |
17 "Dec 6" (midnight) | 20 "Dec 6" (midnight) |
31 | 34 |
32 This is the internal representation format for dates. unixtime is | 35 This is the internal representation format for dates. unixtime is |
33 the number of seconds since the epoch (1970-01-01 00:00 UTC). offset | 36 the number of seconds since the epoch (1970-01-01 00:00 UTC). offset |
34 is the offset of the local timezone, in seconds west of UTC (negative | 37 is the offset of the local timezone, in seconds west of UTC (negative |
35 if the timezone is east of UTC). | 38 if the timezone is east of UTC). |
39 | |
40 The log command also accepts date ranges: | |
41 | |
42 "<{date}" - on or before a given date | |
43 ">{date}" - on or after a given date | |
44 "{date} to {date}" - a date range, inclusive | |
45 "-{days}" - within a given number of days of today | |
36 ''', | 46 ''', |
37 | 47 |
38 'environment|env|Environment Variables': | 48 'environment|env|Environment Variables': |
39 r''' | 49 r''' |
40 HG:: | 50 HG:: |