1 # help.py - help data for mercurial

     2 #

     3 # Copyright 2006 Matt Mackall <mpm@selenic.com>

     4 #

     5 # This software may be used and distributed according to the terms

     6 # of the GNU General Public License, incorporated herein by reference.

     7 

     8 helptable = {

     9     "dates|Date Formats":

    10     r'''

    11     Some commands (backout, commit, tag) allow the user to specify a date.

    12     Possible formats for dates are:

    13 

    14 YYYY-mm-dd \HH:MM[:SS] [(+|-)NNNN]::

    15     This is a subset of ISO 8601, allowing just the recommended notations

    16     for date and time. The last part represents the timezone; if omitted,

    17     local time is assumed. Examples:

    18 

    19     "2005-08-22 03:27 -0700"

    20 

    21     "2006-04-19 21:39:51"

    22 

    23 aaa bbb dd HH:MM:SS YYYY [(+|-)NNNN]::

    24     This is the date format used by the C library. Here, aaa stands for

    25     abbreviated weekday name and bbb for abbreviated month name. The last

    26     part represents the timezone; if omitted, local time is assumed.

    27     Examples:

    28 

    29     "Mon Aug 22 03:27:00 2005 -0700"

    30 

    31     "Wed Apr 19 21:39:51 2006"

    32 

    33 unixtime offset::

    34     This is the internal representation format for dates. unixtime is

    35     the number of seconds since the epoch (1970-01-01 00:00 UTC). offset

    36     is the offset of the local timezone, in seconds west of UTC (negative

    37     if the timezone is east of UTC).

    38     Examples:

    39 

    40     "1124706420 25200" (2005-08-22 03:27:00 -0700)

    41 

    42     "1145475591 -7200" (2006-04-19 21:39:51 +0200)

    43     ''',

    44 }

    45