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