Show More
@@ -1154,37 +1154,49 b' Test commands that collide with topics (' | |||||
1154 |
|
1154 | |||
1155 | Test a help topic |
|
1155 | Test a help topic | |
1156 |
|
1156 | |||
1157 |
$ hg help |
|
1157 | $ hg help dates | |
1158 | Specifying Single Revisions |
|
1158 | Date Formats | |
1159 |
"""""""""""" |
|
1159 | """""""""""" | |
1160 |
|
1160 | |||
1161 | Mercurial supports several ways to specify individual revisions. |
|
1161 | Some commands allow the user to specify a date, e.g.: | |
1162 |
|
1162 | |||
1163 | A plain integer is treated as a revision number. Negative integers are |
|
1163 | - backout, commit, import, tag: Specify the commit date. | |
1164 | treated as sequential offsets from the tip, with -1 denoting the tip, -2 |
|
1164 | - log, revert, update: Select revision(s) by date. | |
1165 | denoting the revision prior to the tip, and so forth. |
|
1165 | ||
1166 |
|
1166 | Many date formats are valid. Here are some examples: | ||
1167 | A 40-digit hexadecimal string is treated as a unique revision identifier. |
|
1167 | ||
1168 | A hexadecimal string less than 40 characters long is treated as a unique |
|
1168 | - "Wed Dec 6 13:18:29 2006" (local timezone assumed) | |
1169 | revision identifier and is referred to as a short-form identifier. A |
|
1169 | - "Dec 6 13:18 -0600" (year assumed, time offset provided) | |
1170 | short-form identifier is only valid if it is the prefix of exactly one |
|
1170 | - "Dec 6 13:18 UTC" (UTC and GMT are aliases for +0000) | |
1171 | full-length identifier. |
|
1171 | - "Dec 6" (midnight) | |
1172 |
|
1172 | - "13:18" (today assumed) | ||
1173 | Any other string is treated as a bookmark, tag, or branch name. A bookmark |
|
1173 | - "3:39" (3:39AM assumed) | |
1174 | is a movable pointer to a revision. A tag is a permanent name associated |
|
1174 | - "3:39pm" (15:39) | |
1175 | with a revision. A branch name denotes the tipmost open branch head of |
|
1175 | - "2006-12-06 13:18:29" (ISO 8601 format) | |
1176 | that branch - or if they are all closed, the tipmost closed head of the |
|
1176 | - "2006-12-6 13:18" | |
1177 | branch. Bookmark, tag, and branch names must not contain the ":" |
|
1177 | - "2006-12-6" | |
1178 | character. |
|
1178 | - "12-6" | |
1179 |
|
1179 | - "12/6" | ||
1180 | The reserved name "tip" always identifies the most recent revision. |
|
1180 | - "12/6/6" (Dec 6 2006) | |
1181 |
|
1181 | - "today" (midnight) | ||
1182 | The reserved name "null" indicates the null revision. This is the revision |
|
1182 | - "yesterday" (midnight) | |
1183 | of an empty repository, and the parent of revision 0. |
|
1183 | - "now" - right now | |
1184 |
|
1184 | |||
1185 | The reserved name "." indicates the working directory parent. If no |
|
1185 | Lastly, there is Mercurial's internal format: | |
1186 | working directory is checked out, it is equivalent to null. If an |
|
1186 | ||
1187 | uncommitted merge is in progress, "." is the revision of the first parent. |
|
1187 | - "1165411109 0" (Wed Dec 6 13:18:29 2006 UTC) | |
|
1188 | ||||
|
1189 | This is the internal representation format for dates. The first number is | |||
|
1190 | the number of seconds since the epoch (1970-01-01 00:00 UTC). The second | |||
|
1191 | is the offset of the local timezone, in seconds west of UTC (negative if | |||
|
1192 | the timezone is east of UTC). | |||
|
1193 | ||||
|
1194 | The log command also accepts date ranges: | |||
|
1195 | ||||
|
1196 | - "<DATE" - at or before a given date/time | |||
|
1197 | - ">DATE" - on or after a given date/time | |||
|
1198 | - "DATE to DATE" - a date range, inclusive | |||
|
1199 | - "-DAYS" - within a given number of days of today | |||
1188 |
|
1200 | |||
1189 | Test repeated config section name |
|
1201 | Test repeated config section name | |
1190 |
|
1202 | |||
@@ -2726,7 +2738,7 b' Dish up an empty repo; serve it cold.' | |||||
2726 | </html> |
|
2738 | </html> | |
2727 |
|
2739 | |||
2728 |
|
2740 | |||
2729 |
$ get-with-headers.py 127.0.0.1:$HGPORT "help/ |
|
2741 | $ get-with-headers.py 127.0.0.1:$HGPORT "help/dates" | |
2730 | 200 Script output follows |
|
2742 | 200 Script output follows | |
2731 |
|
2743 | |||
2732 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"> |
|
2744 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"> | |
@@ -2737,7 +2749,7 b' Dish up an empty repo; serve it cold.' | |||||
2737 | <link rel="stylesheet" href="/static/style-paper.css" type="text/css" /> |
|
2749 | <link rel="stylesheet" href="/static/style-paper.css" type="text/css" /> | |
2738 | <script type="text/javascript" src="/static/mercurial.js"></script> |
|
2750 | <script type="text/javascript" src="/static/mercurial.js"></script> | |
2739 |
|
2751 | |||
2740 |
<title>Help: |
|
2752 | <title>Help: dates</title> | |
2741 | </head> |
|
2753 | </head> | |
2742 | <body> |
|
2754 | <body> | |
2743 |
|
2755 | |||
@@ -2761,7 +2773,7 b' Dish up an empty repo; serve it cold.' | |||||
2761 |
|
2773 | |||
2762 | <div class="main"> |
|
2774 | <div class="main"> | |
2763 | <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2> |
|
2775 | <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2> | |
2764 |
<h3>Help: |
|
2776 | <h3>Help: dates</h3> | |
2765 |
|
2777 | |||
2766 | <form class="search" action="/log"> |
|
2778 | <form class="search" action="/log"> | |
2767 |
|
2779 | |||
@@ -2770,42 +2782,56 b' Dish up an empty repo; serve it cold.' | |||||
2770 | number or hash, or <a href="/help/revsets">revset expression</a>.</div> |
|
2782 | number or hash, or <a href="/help/revsets">revset expression</a>.</div> | |
2771 | </form> |
|
2783 | </form> | |
2772 | <div id="doc"> |
|
2784 | <div id="doc"> | |
2773 | <h1>Specifying Single Revisions</h1> |
|
2785 | <h1>Date Formats</h1> | |
2774 | <p> |
|
2786 | <p> | |
2775 | Mercurial supports several ways to specify individual revisions. |
|
2787 | Some commands allow the user to specify a date, e.g.: | |
2776 | </p> |
|
2788 | </p> | |
|
2789 | <ul> | |||
|
2790 | <li> backout, commit, import, tag: Specify the commit date. | |||
|
2791 | <li> log, revert, update: Select revision(s) by date. | |||
|
2792 | </ul> | |||
2777 | <p> |
|
2793 | <p> | |
2778 | A plain integer is treated as a revision number. Negative integers are |
|
2794 | Many date formats are valid. Here are some examples: | |
2779 | treated as sequential offsets from the tip, with -1 denoting the tip, |
|
|||
2780 | -2 denoting the revision prior to the tip, and so forth. |
|
|||
2781 | </p> |
|
2795 | </p> | |
|
2796 | <ul> | |||
|
2797 | <li> "Wed Dec 6 13:18:29 2006" (local timezone assumed) | |||
|
2798 | <li> "Dec 6 13:18 -0600" (year assumed, time offset provided) | |||
|
2799 | <li> "Dec 6 13:18 UTC" (UTC and GMT are aliases for +0000) | |||
|
2800 | <li> "Dec 6" (midnight) | |||
|
2801 | <li> "13:18" (today assumed) | |||
|
2802 | <li> "3:39" (3:39AM assumed) | |||
|
2803 | <li> "3:39pm" (15:39) | |||
|
2804 | <li> "2006-12-06 13:18:29" (ISO 8601 format) | |||
|
2805 | <li> "2006-12-6 13:18" | |||
|
2806 | <li> "2006-12-6" | |||
|
2807 | <li> "12-6" | |||
|
2808 | <li> "12/6" | |||
|
2809 | <li> "12/6/6" (Dec 6 2006) | |||
|
2810 | <li> "today" (midnight) | |||
|
2811 | <li> "yesterday" (midnight) | |||
|
2812 | <li> "now" - right now | |||
|
2813 | </ul> | |||
2782 | <p> |
|
2814 | <p> | |
2783 | A 40-digit hexadecimal string is treated as a unique revision identifier. |
|
2815 | Lastly, there is Mercurial's internal format: | |
2784 | A hexadecimal string less than 40 characters long is treated as a |
|
2816 | </p> | |
2785 | unique revision identifier and is referred to as a short-form |
|
2817 | <ul> | |
2786 | identifier. A short-form identifier is only valid if it is the prefix |
|
2818 | <li> "1165411109 0" (Wed Dec 6 13:18:29 2006 UTC) | |
2787 | of exactly one full-length identifier. |
|
2819 | </ul> | |
|
2820 | <p> | |||
|
2821 | This is the internal representation format for dates. The first number | |||
|
2822 | is the number of seconds since the epoch (1970-01-01 00:00 UTC). The | |||
|
2823 | second is the offset of the local timezone, in seconds west of UTC | |||
|
2824 | (negative if the timezone is east of UTC). | |||
2788 | </p> |
|
2825 | </p> | |
2789 | <p> |
|
2826 | <p> | |
2790 | Any other string is treated as a bookmark, tag, or branch name. A |
|
2827 | The log command also accepts date ranges: | |
2791 | bookmark is a movable pointer to a revision. A tag is a permanent name |
|
|||
2792 | associated with a revision. A branch name denotes the tipmost open branch head |
|
|||
2793 | of that branch - or if they are all closed, the tipmost closed head of the |
|
|||
2794 | branch. Bookmark, tag, and branch names must not contain the ":" character. |
|
|||
2795 | </p> |
|
|||
2796 | <p> |
|
|||
2797 | The reserved name "tip" always identifies the most recent revision. |
|
|||
2798 | </p> |
|
2828 | </p> | |
2799 |
< |
|
2829 | <ul> | |
2800 | The reserved name "null" indicates the null revision. This is the |
|
2830 | <li> "<DATE" - at or before a given date/time | |
2801 | revision of an empty repository, and the parent of revision 0. |
|
2831 | <li> ">DATE" - on or after a given date/time | |
2802 | </p> |
|
2832 | <li> "DATE to DATE" - a date range, inclusive | |
2803 | <p> |
|
2833 | <li> "-DAYS" - within a given number of days of today | |
2804 | The reserved name "." indicates the working directory parent. If no |
|
2834 | </ul> | |
2805 | working directory is checked out, it is equivalent to null. If an |
|
|||
2806 | uncommitted merge is in progress, "." is the revision of the first |
|
|||
2807 | parent. |
|
|||
2808 | </p> |
|
|||
2809 |
|
2835 | |||
2810 | </div> |
|
2836 | </div> | |
2811 | </div> |
|
2837 | </div> |
General Comments 0
You need to be logged in to leave comments.
Login now