Fossil

Check-in [cd77e064]
Login

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment: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.
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: cd77e0649a6c0bd6632f11b4b55dec02b764d174
User & Date: rberteig 2016-08-12 22:45:05
Context
2016-08-15
15:18
update change-log check-in: 4f3054bc user: jan.nijtmans tags: trunk
2016-08-12
22:45
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. check-in: cd77e064 user: rberteig tags: trunk
13:44
Add experimental 'raw' mode for embedded TH1 docs feature. check-in: ccd8a9cb user: mistachkin tags: trunk
Changes
Hide Diffs Side-by-Side Diffs Ignore Whitespace Patch

Changes to src/attach.c.

   697    697   **                                     is to be made. The attachment will be
   698    698   **                                     to the most recently modified tech note
   699    699   **                                     with the specified timestamp.
   700    700   **         -t|--technote TECHNOTE-ID   Specifies the technote to be
   701    701   **                                     updated by its technote id.
   702    702   **
   703    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.
   704    710   */
   705    711   void attachment_cmd(void){
   706    712     int n;
   707    713     db_find_and_open_repository(0, 0);
   708    714     if( g.argc<3 ){
   709    715       goto attachment_cmd_usage;
   710    716     }

Changes to src/branch.c.

   255    255   **        Create a new branch BRANCH-NAME off of check-in BASIS.
   256    256   **        Supported options for this subcommand include:
   257    257   **        --private             branch is private (i.e., remains local)
   258    258   **        --bgcolor COLOR       use COLOR instead of automatic background
   259    259   **        --nosign              do not sign contents on this branch
   260    260   **        --date-override DATE  DATE to use instead of 'now'
   261    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.
   262    268   **
   263    269   **    %fossil branch list ?-a|--all|-c|--closed?
   264    270   **    %fossil branch ls ?-a|--all|-c|--closed?
   265    271   **
   266    272   **        List all branches.  Use -a or --all to list all branches and
   267    273   **        -c or --closed to list all closed branches.  The default is to
   268    274   **        show only open branches.

Changes to src/checkin.c.

  1687   1687   **    -n|--dry-run               If given, display instead of run actions
  1688   1688   **    --no-warnings              omit all warnings about file contents
  1689   1689   **    --nosign                   do not attempt to sign this commit with gpg
  1690   1690   **    --private                  do not sync changes and their descendants
  1691   1691   **    --sha1sum                  verify file status using SHA1 hashing rather
  1692   1692   **                               than relying on file mtimes
  1693   1693   **    --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'
  1695   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.
  1696   1702   **
  1697   1703   ** See also: branch, changes, checkout, extras, sync
  1698   1704   */
  1699   1705   void commit_cmd(void){
  1700   1706     int hasChanges;        /* True if unsaved changes exist */
  1701   1707     int vid;               /* blob-id of parent version */
  1702   1708     int nrid;              /* blob-id of a modified file */

Changes to src/db.c.

  1748   1748   ** default users "anonymous", "nobody", "reader", "developer", and their
  1749   1749   ** associated permissions will be copied.
  1750   1750   **
  1751   1751   ** Options:
  1752   1752   **    --template      FILE      copy settings from repository file
  1753   1753   **    --admin-user|-A USERNAME  select given USERNAME as admin user
  1754   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.
  1755   1761   **
  1756   1762   ** See also: clone
  1757   1763   */
  1758   1764   void create_repository_cmd(void){
  1759   1765     char *zPassword;
  1760   1766     const char *zTemplate;      /* Repository from which to copy settings */
  1761   1767     const char *zDate;          /* Date of the initial check-in */

Changes to src/finfo.c.

   280    280   ** WEBPAGE: finfo
   281    281   ** URL: /finfo?name=FILENAME
   282    282   **
   283    283   ** Show the change history for a single file.
   284    284   **
   285    285   ** Additional query parameters:
   286    286   **
   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
   289    289   **    n=NUM      Show the first NUM changes only
   290    290   **    brbg       Background color by branch name
   291    291   **    ubg        Background color by user name
   292    292   **    ci=UUID    Ancestors of a particular check-in
   293    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.
   294    299   */
   295    300   void finfo_page(void){
   296    301     Stmt q;
   297    302     const char *zFilename;
   298    303     char zPrevDate[20];
   299    304     const char *zA;
   300    305     const char *zB;

Changes to src/info.c.

  2823   2823   **
  2824   2824   ** Options:
  2825   2825   **
  2826   2826   **    --author USER           Make USER the author for check-in
  2827   2827   **    -m|--comment COMMENT    Make COMMENT the check-in comment
  2828   2828   **    -M|--message-file FILE  Read the amended comment from FILE
  2829   2829   **    -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
  2831   2831   **    --bgcolor COLOR         Apply COLOR to this check-in
  2832   2832   **    --branchcolor COLOR     Apply and propagate COLOR to the branch
  2833   2833   **    --tag TAG               Add new TAG to this check-in
  2834   2834   **    --cancel TAG            Cancel TAG from this check-in
  2835   2835   **    --branch NAME           Make this check-in the start of branch NAME
  2836   2836   **    --hide                  Hide branch starting from this check-in
  2837   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.
  2838   2844   */
  2839   2845   void ci_amend_cmd(void){
  2840   2846     int rid;
  2841   2847     const char *zComment;         /* Current comment on the check-in */
  2842   2848     const char *zNewComment;      /* Revised check-in comment */
  2843   2849     const char *zComFile;         /* Filename from which to read comment */
  2844   2850     const char *zUser;            /* Current user for the check-in */

Changes to src/timeline.c.

  2043   2043   ** of one of these keywords:
  2044   2044   **
  2045   2045   **     before
  2046   2046   **     after
  2047   2047   **     descendants | children
  2048   2048   **     ancestors | parents
  2049   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.
         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  +**
  2054   2059   **
  2055   2060   ** Options:
  2056   2061   **   -n|--limit N         Output the first N entries (default 20 lines).
  2057   2062   **                        N=0 means no limit.
  2058   2063   **   -p|--path PATH       Output items affecting PATH only.
  2059   2064   **                        PATH can be a file or a sub directory.
  2060   2065   **   --offset P           skip P changes

Changes to src/wiki.c.

  1218   1218   **                                     of timestamp with the most recent
  1219   1219   **                                     first.
  1220   1220   **         -s|--show-technote-ids      The id of the tech note will be listed
  1221   1221   **                                     along side the timestamp. The tech note
  1222   1222   **                                     id will be the first word on each line.
  1223   1223   **                                     This option only applies if the
  1224   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.
  1225   1231   **
  1226   1232   */
  1227   1233   void wiki_cmd(void){
  1228   1234     int n;
  1229   1235     db_find_and_open_repository(0, 0);
  1230   1236     if( g.argc<3 ){
  1231   1237       goto wiki_cmd_usage;