Fossil SCM

Improved documentation of the date and time stamps understood by most fossil commands and web pages. No non-documentation changes were made, but comments in eight source files were edited.

rberteig 2016-08-12 22:45 trunk
Commit cd77e0649a6c0bd6632f11b4b55dec02b764d174
Parent ccd8a9cbe4fc43b…
8 files changed +6 +6 +7 -1 +6 +7 -2 +7 -1 +9 -4 +6
~ src/attach.c ~ src/branch.c ~ src/checkin.c ~ src/db.c ~ src/finfo.c ~ src/info.c ~ src/timeline.c ~ src/wiki.c
M src/attach.c
+6
--- src/attach.c
+++ src/attach.c
@@ -699,10 +699,16 @@
699699
 ** with the specified timestamp.
700700
 ** -t|--technote TECHNOTE-ID Specifies the technote to be
701701
 ** updated by its technote id.
702702
 **
703703
 ** One of PAGENAME, DATETIME or TECHNOTE-ID must be specified.
704
+**
705
+** DATETIME may be "now" or "YYYY-MM-DDTHH:MM:SS.SSS". If in
706
+** year-month-day form, it may be truncated, the "T" may be replaced by
707
+** a space, and it may also name a timezone offset from UTC as "-HH:MM"
708
+** (westward) or "+HH:MM" (eastward). Either no timezone suffix or "Z"
709
+** means UTC.
704710
 */
705711
 void attachment_cmd(void){
706712
 int n;
707713
 db_find_and_open_repository(0, 0);
708714
 if( g.argc<3 ){
709715
--- src/attach.c
+++ src/attach.c
@@ -699,10 +699,16 @@
699 ** with the specified timestamp.
700 ** -t|--technote TECHNOTE-ID Specifies the technote to be
701 ** updated by its technote id.
702 **
703 ** One of PAGENAME, DATETIME or TECHNOTE-ID must be specified.
 
 
 
 
 
 
704 */
705 void attachment_cmd(void){
706 int n;
707 db_find_and_open_repository(0, 0);
708 if( g.argc<3 ){
709
--- src/attach.c
+++ src/attach.c
@@ -699,10 +699,16 @@
699 ** with the specified timestamp.
700 ** -t|--technote TECHNOTE-ID Specifies the technote to be
701 ** updated by its technote id.
702 **
703 ** One of PAGENAME, DATETIME or TECHNOTE-ID must be specified.
704 **
705 ** DATETIME may be "now" or "YYYY-MM-DDTHH:MM:SS.SSS". If in
706 ** year-month-day form, it may be truncated, the "T" may be replaced by
707 ** a space, and it may also name a timezone offset from UTC as "-HH:MM"
708 ** (westward) or "+HH:MM" (eastward). Either no timezone suffix or "Z"
709 ** means UTC.
710 */
711 void attachment_cmd(void){
712 int n;
713 db_find_and_open_repository(0, 0);
714 if( g.argc<3 ){
715
M src/branch.c
+6
--- src/branch.c
+++ src/branch.c
@@ -257,10 +257,16 @@
257257
 ** --private branch is private (i.e., remains local)
258258
 ** --bgcolor COLOR use COLOR instead of automatic background
259259
 ** --nosign do not sign contents on this branch
260260
 ** --date-override DATE DATE to use instead of 'now'
261261
 ** --user-override USER USER to use instead of the current default
262
+**
263
+** DATE may be "now" or "YYYY-MM-DDTHH:MM:SS.SSS". If in
264
+** year-month-day form, it may be truncated, the "T" may be
265
+** replaced by a space, and it may also name a timezone offset
266
+** from UTC as "-HH:MM" (westward) or "+HH:MM" (eastward).
267
+** Either no timezone suffix or "Z" means UTC.
262268
 **
263269
 ** %fossil branch list ?-a|--all|-c|--closed?
264270
 ** %fossil branch ls ?-a|--all|-c|--closed?
265271
 **
266272
 ** List all branches. Use -a or --all to list all branches and
267273
--- src/branch.c
+++ src/branch.c
@@ -257,10 +257,16 @@
257 ** --private branch is private (i.e., remains local)
258 ** --bgcolor COLOR use COLOR instead of automatic background
259 ** --nosign do not sign contents on this branch
260 ** --date-override DATE DATE to use instead of 'now'
261 ** --user-override USER USER to use instead of the current default
 
 
 
 
 
 
262 **
263 ** %fossil branch list ?-a|--all|-c|--closed?
264 ** %fossil branch ls ?-a|--all|-c|--closed?
265 **
266 ** List all branches. Use -a or --all to list all branches and
267
--- src/branch.c
+++ src/branch.c
@@ -257,10 +257,16 @@
257 ** --private branch is private (i.e., remains local)
258 ** --bgcolor COLOR use COLOR instead of automatic background
259 ** --nosign do not sign contents on this branch
260 ** --date-override DATE DATE to use instead of 'now'
261 ** --user-override USER USER to use instead of the current default
262 **
263 ** DATE may be "now" or "YYYY-MM-DDTHH:MM:SS.SSS". If in
264 ** year-month-day form, it may be truncated, the "T" may be
265 ** replaced by a space, and it may also name a timezone offset
266 ** from UTC as "-HH:MM" (westward) or "+HH:MM" (eastward).
267 ** Either no timezone suffix or "Z" means UTC.
268 **
269 ** %fossil branch list ?-a|--all|-c|--closed?
270 ** %fossil branch ls ?-a|--all|-c|--closed?
271 **
272 ** List all branches. Use -a or --all to list all branches and
273
M src/checkin.c
+7 -1
--- src/checkin.c
+++ src/checkin.c
@@ -1689,12 +1689,18 @@
16891689
 ** --nosign do not attempt to sign this commit with gpg
16901690
 ** --private do not sync changes and their descendants
16911691
 ** --sha1sum verify file status using SHA1 hashing rather
16921692
 ** than relying on file mtimes
16931693
 ** --tag TAG-NAME assign given tag TAG-NAME to the check-in
1694
-** --date-override DATE DATE to use instead of 'now'
1694
+** --date-override DATETIME DATE to use instead of 'now'
16951695
 ** --user-override USER USER to use instead of the current default
1696
+**
1697
+** DATETIME may be "now" or "YYYY-MM-DDTHH:MM:SS.SSS". If in
1698
+** year-month-day form, it may be truncated, the "T" may be replaced by
1699
+** a space, and it may also name a timezone offset from UTC as "-HH:MM"
1700
+** (westward) or "+HH:MM" (eastward). Either no timezone suffix or "Z"
1701
+** means UTC.
16961702
 **
16971703
 ** See also: branch, changes, checkout, extras, sync
16981704
 */
16991705
 void commit_cmd(void){
17001706
 int hasChanges; /* True if unsaved changes exist */
17011707
--- src/checkin.c
+++ src/checkin.c
@@ -1689,12 +1689,18 @@
1689 ** --nosign do not attempt to sign this commit with gpg
1690 ** --private do not sync changes and their descendants
1691 ** --sha1sum verify file status using SHA1 hashing rather
1692 ** than relying on file mtimes
1693 ** --tag TAG-NAME assign given tag TAG-NAME to the check-in
1694 ** --date-override DATE DATE to use instead of 'now'
1695 ** --user-override USER USER to use instead of the current default
 
 
 
 
 
 
1696 **
1697 ** See also: branch, changes, checkout, extras, sync
1698 */
1699 void commit_cmd(void){
1700 int hasChanges; /* True if unsaved changes exist */
1701
--- src/checkin.c
+++ src/checkin.c
@@ -1689,12 +1689,18 @@
1689 ** --nosign do not attempt to sign this commit with gpg
1690 ** --private do not sync changes and their descendants
1691 ** --sha1sum verify file status using SHA1 hashing rather
1692 ** than relying on file mtimes
1693 ** --tag TAG-NAME assign given tag TAG-NAME to the check-in
1694 ** --date-override DATETIME DATE to use instead of 'now'
1695 ** --user-override USER USER to use instead of the current default
1696 **
1697 ** DATETIME may be "now" or "YYYY-MM-DDTHH:MM:SS.SSS". If in
1698 ** year-month-day form, it may be truncated, the "T" may be replaced by
1699 ** a space, and it may also name a timezone offset from UTC as "-HH:MM"
1700 ** (westward) or "+HH:MM" (eastward). Either no timezone suffix or "Z"
1701 ** means UTC.
1702 **
1703 ** See also: branch, changes, checkout, extras, sync
1704 */
1705 void commit_cmd(void){
1706 int hasChanges; /* True if unsaved changes exist */
1707
M src/db.c
+6
--- src/db.c
+++ src/db.c
@@ -1750,10 +1750,16 @@
17501750
 **
17511751
 ** Options:
17521752
 ** --template FILE copy settings from repository file
17531753
 ** --admin-user|-A USERNAME select given USERNAME as admin user
17541754
 ** --date-override DATETIME use DATETIME as time of the initial check-in
1755
+**
1756
+** DATETIME may be "now" or "YYYY-MM-DDTHH:MM:SS.SSS". If in
1757
+** year-month-day form, it may be truncated, the "T" may be replaced by
1758
+** a space, and it may also name a timezone offset from UTC as "-HH:MM"
1759
+** (westward) or "+HH:MM" (eastward). Either no timezone suffix or "Z"
1760
+** means UTC.
17551761
 **
17561762
 ** See also: clone
17571763
 */
17581764
 void create_repository_cmd(void){
17591765
 char *zPassword;
17601766
--- src/db.c
+++ src/db.c
@@ -1750,10 +1750,16 @@
1750 **
1751 ** Options:
1752 ** --template FILE copy settings from repository file
1753 ** --admin-user|-A USERNAME select given USERNAME as admin user
1754 ** --date-override DATETIME use DATETIME as time of the initial check-in
 
 
 
 
 
 
1755 **
1756 ** See also: clone
1757 */
1758 void create_repository_cmd(void){
1759 char *zPassword;
1760
--- src/db.c
+++ src/db.c
@@ -1750,10 +1750,16 @@
1750 **
1751 ** Options:
1752 ** --template FILE copy settings from repository file
1753 ** --admin-user|-A USERNAME select given USERNAME as admin user
1754 ** --date-override DATETIME use DATETIME as time of the initial check-in
1755 **
1756 ** DATETIME may be "now" or "YYYY-MM-DDTHH:MM:SS.SSS". If in
1757 ** year-month-day form, it may be truncated, the "T" may be replaced by
1758 ** a space, and it may also name a timezone offset from UTC as "-HH:MM"
1759 ** (westward) or "+HH:MM" (eastward). Either no timezone suffix or "Z"
1760 ** means UTC.
1761 **
1762 ** See also: clone
1763 */
1764 void create_repository_cmd(void){
1765 char *zPassword;
1766
M src/finfo.c
+7 -2
--- src/finfo.c
+++ src/finfo.c
@@ -282,17 +282,22 @@
282282
 **
283283
 ** Show the change history for a single file.
284284
 **
285285
 ** Additional query parameters:
286286
 **
287
-** a=DATE Only show changes after DATE
288
-** b=DATE Only show changes before DATE
287
+** a=DATETIME Only show changes after DATETIME
288
+** b=DATETIME Only show changes before DATETIME
289289
 ** n=NUM Show the first NUM changes only
290290
 ** brbg Background color by branch name
291291
 ** ubg Background color by user name
292292
 ** ci=UUID Ancestors of a particular check-in
293293
 ** showid Show RID values for debugging
294
+**
295
+** DATETIME may be "now" or "YYYY-MM-DDTHH:MM:SS.SSS". If in
296
+** year-month-day form, it may be truncated, and it may also name a
297
+** timezone offset from UTC as "-HH:MM" (westward) or "+HH:MM"
298
+** (eastward). Either no timezone suffix or "Z" means UTC.
294299
 */
295300
 void finfo_page(void){
296301
 Stmt q;
297302
 const char *zFilename;
298303
 char zPrevDate[20];
299304
--- src/finfo.c
+++ src/finfo.c
@@ -282,17 +282,22 @@
282 **
283 ** Show the change history for a single file.
284 **
285 ** Additional query parameters:
286 **
287 ** a=DATE Only show changes after DATE
288 ** b=DATE Only show changes before DATE
289 ** n=NUM Show the first NUM changes only
290 ** brbg Background color by branch name
291 ** ubg Background color by user name
292 ** ci=UUID Ancestors of a particular check-in
293 ** showid Show RID values for debugging
 
 
 
 
 
294 */
295 void finfo_page(void){
296 Stmt q;
297 const char *zFilename;
298 char zPrevDate[20];
299
--- src/finfo.c
+++ src/finfo.c
@@ -282,17 +282,22 @@
282 **
283 ** Show the change history for a single file.
284 **
285 ** Additional query parameters:
286 **
287 ** a=DATETIME Only show changes after DATETIME
288 ** b=DATETIME Only show changes before DATETIME
289 ** n=NUM Show the first NUM changes only
290 ** brbg Background color by branch name
291 ** ubg Background color by user name
292 ** ci=UUID Ancestors of a particular check-in
293 ** showid Show RID values for debugging
294 **
295 ** DATETIME may be "now" or "YYYY-MM-DDTHH:MM:SS.SSS". If in
296 ** year-month-day form, it may be truncated, and it may also name a
297 ** timezone offset from UTC as "-HH:MM" (westward) or "+HH:MM"
298 ** (eastward). Either no timezone suffix or "Z" means UTC.
299 */
300 void finfo_page(void){
301 Stmt q;
302 const char *zFilename;
303 char zPrevDate[20];
304
M src/info.c
+7 -1
--- src/info.c
+++ src/info.c
@@ -2825,18 +2825,24 @@
28252825
 **
28262826
 ** --author USER Make USER the author for check-in
28272827
 ** -m|--comment COMMENT Make COMMENT the check-in comment
28282828
 ** -M|--message-file FILE Read the amended comment from FILE
28292829
 ** -e|--edit-comment Launch editor to revise comment
2830
-** --date DATE Make DATE the check-in time
2830
+** --date DATETIME Make DATETIME the check-in time
28312831
 ** --bgcolor COLOR Apply COLOR to this check-in
28322832
 ** --branchcolor COLOR Apply and propagate COLOR to the branch
28332833
 ** --tag TAG Add new TAG to this check-in
28342834
 ** --cancel TAG Cancel TAG from this check-in
28352835
 ** --branch NAME Make this check-in the start of branch NAME
28362836
 ** --hide Hide branch starting from this check-in
28372837
 ** --close Mark this "leaf" as closed
2838
+**
2839
+** DATETIME may be "now" or "YYYY-MM-DDTHH:MM:SS.SSS". If in
2840
+** year-month-day form, it may be truncated, the "T" may be replaced by
2841
+** a space, and it may also name a timezone offset from UTC as "-HH:MM"
2842
+** (westward) or "+HH:MM" (eastward). Either no timezone suffix or "Z"
2843
+** means UTC.
28382844
 */
28392845
 void ci_amend_cmd(void){
28402846
 int rid;
28412847
 const char *zComment; /* Current comment on the check-in */
28422848
 const char *zNewComment; /* Revised check-in comment */
28432849
--- src/info.c
+++ src/info.c
@@ -2825,18 +2825,24 @@
2825 **
2826 ** --author USER Make USER the author for check-in
2827 ** -m|--comment COMMENT Make COMMENT the check-in comment
2828 ** -M|--message-file FILE Read the amended comment from FILE
2829 ** -e|--edit-comment Launch editor to revise comment
2830 ** --date DATE Make DATE the check-in time
2831 ** --bgcolor COLOR Apply COLOR to this check-in
2832 ** --branchcolor COLOR Apply and propagate COLOR to the branch
2833 ** --tag TAG Add new TAG to this check-in
2834 ** --cancel TAG Cancel TAG from this check-in
2835 ** --branch NAME Make this check-in the start of branch NAME
2836 ** --hide Hide branch starting from this check-in
2837 ** --close Mark this "leaf" as closed
 
 
 
 
 
 
2838 */
2839 void ci_amend_cmd(void){
2840 int rid;
2841 const char *zComment; /* Current comment on the check-in */
2842 const char *zNewComment; /* Revised check-in comment */
2843
--- src/info.c
+++ src/info.c
@@ -2825,18 +2825,24 @@
2825 **
2826 ** --author USER Make USER the author for check-in
2827 ** -m|--comment COMMENT Make COMMENT the check-in comment
2828 ** -M|--message-file FILE Read the amended comment from FILE
2829 ** -e|--edit-comment Launch editor to revise comment
2830 ** --date DATETIME Make DATETIME the check-in time
2831 ** --bgcolor COLOR Apply COLOR to this check-in
2832 ** --branchcolor COLOR Apply and propagate COLOR to the branch
2833 ** --tag TAG Add new TAG to this check-in
2834 ** --cancel TAG Cancel TAG from this check-in
2835 ** --branch NAME Make this check-in the start of branch NAME
2836 ** --hide Hide branch starting from this check-in
2837 ** --close Mark this "leaf" as closed
2838 **
2839 ** DATETIME may be "now" or "YYYY-MM-DDTHH:MM:SS.SSS". If in
2840 ** year-month-day form, it may be truncated, the "T" may be replaced by
2841 ** a space, and it may also name a timezone offset from UTC as "-HH:MM"
2842 ** (westward) or "+HH:MM" (eastward). Either no timezone suffix or "Z"
2843 ** means UTC.
2844 */
2845 void ci_amend_cmd(void){
2846 int rid;
2847 const char *zComment; /* Current comment on the check-in */
2848 const char *zNewComment; /* Revised check-in comment */
2849
M src/timeline.c
+9 -4
--- src/timeline.c
+++ src/timeline.c
@@ -2045,14 +2045,19 @@
20452045
 ** before
20462046
 ** after
20472047
 ** descendants | children
20482048
 ** ancestors | parents
20492049
 **
2050
-** The CHECKIN can be any unique prefix of 4 characters or more.
2051
-** The DATETIME should be in the ISO8601 format. For
2052
-** example: "2007-08-18 07:21:21". You can also say "current"
2053
-** for the current version or "now" for the current time.
2050
+** The CHECKIN can be any unique prefix of 4 characters or more. You
2051
+** can also say "current" for the current version.
2052
+**
2053
+** DATETIME may be "now" or "YYYY-MM-DDTHH:MM:SS.SSS". If in
2054
+** year-month-day form, it may be truncated, the "T" may be replaced by
2055
+** a space, and it may also name a timezone offset from UTC as "-HH:MM"
2056
+** (westward) or "+HH:MM" (eastward). Either no timezone suffix or "Z"
2057
+** means UTC.
2058
+**
20542059
 **
20552060
 ** Options:
20562061
 ** -n|--limit N Output the first N entries (default 20 lines).
20572062
 ** N=0 means no limit.
20582063
 ** -p|--path PATH Output items affecting PATH only.
20592064
--- src/timeline.c
+++ src/timeline.c
@@ -2045,14 +2045,19 @@
2045 ** before
2046 ** after
2047 ** descendants | children
2048 ** ancestors | parents
2049 **
2050 ** The CHECKIN can be any unique prefix of 4 characters or more.
2051 ** The DATETIME should be in the ISO8601 format. For
2052 ** example: "2007-08-18 07:21:21". You can also say "current"
2053 ** for the current version or "now" for the current time.
 
 
 
 
 
2054 **
2055 ** Options:
2056 ** -n|--limit N Output the first N entries (default 20 lines).
2057 ** N=0 means no limit.
2058 ** -p|--path PATH Output items affecting PATH only.
2059
--- src/timeline.c
+++ src/timeline.c
@@ -2045,14 +2045,19 @@
2045 ** before
2046 ** after
2047 ** descendants | children
2048 ** ancestors | parents
2049 **
2050 ** The CHECKIN can be any unique prefix of 4 characters or more. You
2051 ** can also say "current" for the current version.
2052 **
2053 ** DATETIME may be "now" or "YYYY-MM-DDTHH:MM:SS.SSS". If in
2054 ** year-month-day form, it may be truncated, the "T" may be replaced by
2055 ** a space, and it may also name a timezone offset from UTC as "-HH:MM"
2056 ** (westward) or "+HH:MM" (eastward). Either no timezone suffix or "Z"
2057 ** means UTC.
2058 **
2059 **
2060 ** Options:
2061 ** -n|--limit N Output the first N entries (default 20 lines).
2062 ** N=0 means no limit.
2063 ** -p|--path PATH Output items affecting PATH only.
2064
M src/wiki.c
+6
--- src/wiki.c
+++ src/wiki.c
@@ -1220,10 +1220,16 @@
12201220
 ** -s|--show-technote-ids The id of the tech note will be listed
12211221
 ** along side the timestamp. The tech note
12221222
 ** id will be the first word on each line.
12231223
 ** This option only applies if the
12241224
 ** --technote option is also specified.
1225
+**
1226
+** DATETIME may be "now" or "YYYY-MM-DDTHH:MM:SS.SSS". If in
1227
+** year-month-day form, it may be truncated, the "T" may be replaced by
1228
+** a space, and it may also name a timezone offset from UTC as "-HH:MM"
1229
+** (westward) or "+HH:MM" (eastward). Either no timezone suffix or "Z"
1230
+** means UTC.
12251231
 **
12261232
 */
12271233
 void wiki_cmd(void){
12281234
 int n;
12291235
 db_find_and_open_repository(0, 0);
12301236
--- src/wiki.c
+++ src/wiki.c
@@ -1220,10 +1220,16 @@
1220 ** -s|--show-technote-ids The id of the tech note will be listed
1221 ** along side the timestamp. The tech note
1222 ** id will be the first word on each line.
1223 ** This option only applies if the
1224 ** --technote option is also specified.
 
 
 
 
 
 
1225 **
1226 */
1227 void wiki_cmd(void){
1228 int n;
1229 db_find_and_open_repository(0, 0);
1230
--- src/wiki.c
+++ src/wiki.c
@@ -1220,10 +1220,16 @@
1220 ** -s|--show-technote-ids The id of the tech note will be listed
1221 ** along side the timestamp. The tech note
1222 ** id will be the first word on each line.
1223 ** This option only applies if the
1224 ** --technote option is also specified.
1225 **
1226 ** DATETIME may be "now" or "YYYY-MM-DDTHH:MM:SS.SSS". If in
1227 ** year-month-day form, it may be truncated, the "T" may be replaced by
1228 ** a space, and it may also name a timezone offset from UTC as "-HH:MM"
1229 ** (westward) or "+HH:MM" (eastward). Either no timezone suffix or "Z"
1230 ** means UTC.
1231 **
1232 */
1233 void wiki_cmd(void){
1234 int n;
1235 db_find_and_open_repository(0, 0);
1236

Keyboard Shortcuts

Open search /
Next entry (timeline) j
Previous entry (timeline) k
Open focused entry Enter
Show this help ?
Toggle theme Top nav button