Fossil SCM
Make use of the improved /help/CMD syntax everywhere, in place of the legacy /help?cmd=CMD syntax.
Commit
c64f28d26c7fd701c7ab1a2e06bbfedf6662c118fa92e6303d64673e5d3d792c
Parent
cc09064f5c2e79e…
68 files changed
+24
-10
+3
-3
+2
-2
+1
-1
+1
-1
+1
-1
+3
-3
+1
-1
+3
-3
+11
-11
+11
-11
+8
-8
+5
-5
+2
-2
+7
-7
+6
-6
+5
-5
+2
-2
+6
-6
+1
-1
+3
-3
+2
-2
+343
-343
+8
-8
+1
-1
+1
-1
+1
-1
+2
-2
+4
-4
+1
-1
+4
-4
+6
-6
+5
-5
+2
-2
+1
-1
+1
-1
+1
-1
+1
-1
+9
-9
+22
-22
+24
-24
+18
-18
+2
-2
+1
-1
+7
-7
+1
-1
+2
-2
+4
-4
+1
-1
+1
-1
+4
-4
+1
-1
+1
-1
+3
-3
+1
-1
+1
-1
+1
-1
+4
-4
+1
-1
+1
-1
+7
-7
+2
-2
+2
-2
+8
-8
+7
-7
+1
-1
+1
-1
+6
-6
~
src/dispatch.c
~
src/doc.c
~
src/forum.c
~
src/markdown.md
~
src/search.c
~
src/security_audit.c
~
src/setup.c
~
src/timeline.c
~
www/aboutcgi.wiki
~
www/aboutdownload.wiki
~
www/alerts.md
~
www/antibot.wiki
~
www/backoffice.md
~
www/backup.md
~
www/blame.wiki
~
www/blockchain.md
~
www/branching.wiki
~
www/build.wiki
~
www/caps/admin-v-setup.md
~
www/caps/login-groups.md
~
www/caps/ref.html
~
www/cgi.wiki
~
www/changes.wiki
~
www/chat.md
~
www/childprojects.wiki
~
www/chroot.md
~
www/ckout-workflows.md
~
www/co-vs-up.md
~
www/concepts.wiki
~
www/contribute.wiki
~
www/customskin.md
~
www/defcsp.md
~
www/delta_format.wiki
~
www/embeddeddoc.wiki
~
www/env-opts.md
~
www/event.wiki
~
www/fileedit-page.md
~
www/forum.wiki
~
www/fossil-v-git.wiki
~
www/gitusers.md
~
www/globs.md
~
www/glossary.md
~
www/hashes.md
~
www/hashpolicy.wiki
~
www/hints.wiki
~
www/inout.wiki
~
www/interwiki.md
~
www/javascript.md
~
www/json-api/intro.md
~
www/loadmgmt.md
~
www/makefile.wiki
~
www/mdtest/test1.md
~
www/mirrorlimitations.md
~
www/mirrortogithub.md
~
www/password.wiki
~
www/patchcmd.md
~
www/private.wiki
~
www/quickstart.wiki
~
www/rebaseharm.md
~
www/selfhost.wiki
~
www/server/index.html
~
www/server/windows/service.md
~
www/serverext.wiki
~
www/ssl-server.md
~
www/sync.wiki
~
www/tech_overview.wiki
~
www/th1.md
~
www/unvers.wiki
+24
-10
| --- src/dispatch.c | ||
| +++ src/dispatch.c | ||
| @@ -275,11 +275,11 @@ | ||
| 275 | 275 | char c = z[i]; |
| 276 | 276 | if( c=='[' && (j = help_is_link(z+i, n-i))>0 ){ |
| 277 | 277 | if( i ) blob_append(pOut, z, i); |
| 278 | 278 | z += i+2; |
| 279 | 279 | n -= i+2; |
| 280 | - blob_appendf(pOut, "<a href='%R/help?cmd=%.*s'>%.*s</a>", | |
| 280 | + blob_appendf(pOut, "<a href='%R/help/%.*s'>%.*s</a>", | |
| 281 | 281 | j-3, z, j-3, z); |
| 282 | 282 | z += j-1; |
| 283 | 283 | n -= j-1; |
| 284 | 284 | i = 0; |
| 285 | 285 | }else if( c=='%' && n-i>=7 && strncmp(z+i,"%fossil",7)==0 ){ |
| @@ -835,18 +835,27 @@ | ||
| 835 | 835 | return 0; |
| 836 | 836 | } |
| 837 | 837 | |
| 838 | 838 | /* |
| 839 | 839 | ** WEBPAGE: help |
| 840 | -** URL: /help?name=CMD | |
| 840 | +** URL: /help/CMD or /help/www/PAGE | |
| 841 | 841 | ** |
| 842 | -** Show the built-in help text for CMD. CMD can be a command-line interface | |
| 843 | -** command or a page name from the web interface or a setting. | |
| 842 | +** Show the built-in help text for CMD or PAGE. CMD can be a command-line | |
| 843 | +** interface command or a setting name. PAGE is the name of a | |
| 844 | +** web interface. /help//PAGE also works if the double-/ makes it through | |
| 845 | +** the main web server. | |
| 846 | +** | |
| 844 | 847 | ** Query parameters: |
| 845 | 848 | ** |
| 846 | 849 | ** name=CMD Show help for CMD where CMD is a command name or |
| 847 | -** webpage name or setting name. | |
| 850 | +** or setting name. If CMD beings with "/" it is | |
| 851 | +** interpreted as a PAGE name. | |
| 852 | +** | |
| 853 | +** name=www/PAGE Show help for web page PAGE. | |
| 854 | +** | |
| 855 | +** name=/PAGE The initial "www/" on web-page help can be abbreiated as | |
| 856 | +** just "/" | |
| 848 | 857 | ** |
| 849 | 858 | ** plaintext Show the help within <pre>...</pre>, as if it were |
| 850 | 859 | ** displayed using the "fossil help" command. |
| 851 | 860 | ** |
| 852 | 861 | ** raw Show the raw help text without any formatting. |
| @@ -863,10 +872,15 @@ | ||
| 863 | 872 | |
| 864 | 873 | style_set_current_feature("tkt"); |
| 865 | 874 | style_submenu_element("Topic-List", "%R/help"); |
| 866 | 875 | if( search_restrict(SRCH_HELP)!=0 ){ |
| 867 | 876 | style_submenu_element("Search","%R/search?y=h"); |
| 877 | + } | |
| 878 | + if( strncmp(zCmd,"www/",4)==0 && zCmd[4]!=0 ){ | |
| 879 | + /* Use https://domain/fossil/help/www/timeline or similar with the "www" | |
| 880 | + ** intermediate tag to view web-page documention. */ | |
| 881 | + zCmd += 3; | |
| 868 | 882 | } |
| 869 | 883 | rc = dispatch_name_search(zCmd, CMDFLAG_ANY|CMDFLAG_PREFIX, &pCmd); |
| 870 | 884 | if( pCmd ){ |
| 871 | 885 | style_header("Help: %s", pCmd->zName); |
| 872 | 886 | }else{ |
| @@ -935,11 +949,11 @@ | ||
| 935 | 949 | const char *zBoldOff = aCommand[i].eCmdFlags&CMDFLAG_1ST_TIER?"</b>":""; |
| 936 | 950 | if( '/'==*z || strncmp(z,"test",4)==0 ) continue; |
| 937 | 951 | if( (aCommand[i].eCmdFlags & CMDFLAG_SETTING)!=0 ) continue; |
| 938 | 952 | else if( (aCommand[i].eCmdFlags & CMDFLAG_HIDDEN)!=0 ) continue; |
| 939 | 953 | else if( (aCommand[i].eCmdFlags & CMDFLAG_ALIAS)!=0 ) continue; |
| 940 | - @ <li><a href="%R/help?cmd=%s(z)">%s(zBoldOn)%s(z)%s(zBoldOff)</a> | |
| 954 | + @ <li><a href="%R/help/%s(z)">%s(zBoldOn)%s(z)%s(zBoldOff)</a> | |
| 941 | 955 | /* Output aliases */ |
| 942 | 956 | if( occHelp[aCommand[i].iHelp] > 1 ){ |
| 943 | 957 | int j; |
| 944 | 958 | int aliases[MX_HELP_DUP], nAliases=0; |
| 945 | 959 | for(j=0; j<occHelp[aCommand[i].iHelp]; j++){ |
| @@ -952,11 +966,11 @@ | ||
| 952 | 966 | } |
| 953 | 967 | if( nAliases>0 ){ |
| 954 | 968 | int k; |
| 955 | 969 | @(\ |
| 956 | 970 | for(k=0; k<nAliases; k++){ |
| 957 | - @<a href="%R/help?cmd=%s(aCommand[aliases[k]].zName)">\ | |
| 971 | + @<a href="%R/help/%s(aCommand[aliases[k]].zName)">\ | |
| 958 | 972 | @%s(aCommand[aliases[k]].zName)</a>%s((k<nAliases-1)?", ":"")\ |
| 959 | 973 | } |
| 960 | 974 | @)\ |
| 961 | 975 | } |
| 962 | 976 | } |
| @@ -972,11 +986,11 @@ | ||
| 972 | 986 | for(i=0; i<MX_COMMAND; i++){ |
| 973 | 987 | const char *z = aCommand[i].zName; |
| 974 | 988 | if( '/'!=*z ) continue; |
| 975 | 989 | else if( (aCommand[i].eCmdFlags & CMDFLAG_HIDDEN)!=0 ) continue; |
| 976 | 990 | if( aCommand[i].zHelp[0] ){ |
| 977 | - @ <li><a href="%R/help?cmd=%s(z)">%s(z+1)</a></li> | |
| 991 | + @ <li><a href="%R/help/www%s(z)">%s(z+1)</a></li> | |
| 978 | 992 | }else{ |
| 979 | 993 | @ <li>%s(z+1)</li> |
| 980 | 994 | } |
| 981 | 995 | } |
| 982 | 996 | @ </ul></div> |
| @@ -988,11 +1002,11 @@ | ||
| 988 | 1002 | for(i=0; i<MX_COMMAND; i++){ |
| 989 | 1003 | const char *z = aCommand[i].zName; |
| 990 | 1004 | if( strncmp(z,"test",4)!=0 ) continue; |
| 991 | 1005 | else if( (aCommand[i].eCmdFlags & CMDFLAG_HIDDEN)!=0 ) continue; |
| 992 | 1006 | if( aCommand[i].zHelp[0] ){ |
| 993 | - @ <li><a href="%R/help?cmd=%s(z)">%s(z)</a></li> | |
| 1007 | + @ <li><a href="%R/help/%s(z)">%s(z)</a></li> | |
| 994 | 1008 | }else{ |
| 995 | 1009 | @ <li>%s(z)</li> |
| 996 | 1010 | } |
| 997 | 1011 | } |
| 998 | 1012 | @ </ul></div> |
| @@ -1004,11 +1018,11 @@ | ||
| 1004 | 1018 | for(i=0; i<MX_COMMAND; i++){ |
| 1005 | 1019 | const char *z = aCommand[i].zName; |
| 1006 | 1020 | if( (aCommand[i].eCmdFlags & CMDFLAG_SETTING)==0 ) continue; |
| 1007 | 1021 | else if( (aCommand[i].eCmdFlags & CMDFLAG_HIDDEN)!=0 ) continue; |
| 1008 | 1022 | if( aCommand[i].zHelp[0] ){ |
| 1009 | - @ <li><a href="%R/help?cmd=%s(z)">%s(z)</a></li> | |
| 1023 | + @ <li><a href="%R/help/%s(z)">%s(z)</a></li> | |
| 1010 | 1024 | }else{ |
| 1011 | 1025 | @ <li>%s(z)</li> |
| 1012 | 1026 | } |
| 1013 | 1027 | } |
| 1014 | 1028 | @ </ul></div> |
| 1015 | 1029 |
| --- src/dispatch.c | |
| +++ src/dispatch.c | |
| @@ -275,11 +275,11 @@ | |
| 275 | char c = z[i]; |
| 276 | if( c=='[' && (j = help_is_link(z+i, n-i))>0 ){ |
| 277 | if( i ) blob_append(pOut, z, i); |
| 278 | z += i+2; |
| 279 | n -= i+2; |
| 280 | blob_appendf(pOut, "<a href='%R/help?cmd=%.*s'>%.*s</a>", |
| 281 | j-3, z, j-3, z); |
| 282 | z += j-1; |
| 283 | n -= j-1; |
| 284 | i = 0; |
| 285 | }else if( c=='%' && n-i>=7 && strncmp(z+i,"%fossil",7)==0 ){ |
| @@ -835,18 +835,27 @@ | |
| 835 | return 0; |
| 836 | } |
| 837 | |
| 838 | /* |
| 839 | ** WEBPAGE: help |
| 840 | ** URL: /help?name=CMD |
| 841 | ** |
| 842 | ** Show the built-in help text for CMD. CMD can be a command-line interface |
| 843 | ** command or a page name from the web interface or a setting. |
| 844 | ** Query parameters: |
| 845 | ** |
| 846 | ** name=CMD Show help for CMD where CMD is a command name or |
| 847 | ** webpage name or setting name. |
| 848 | ** |
| 849 | ** plaintext Show the help within <pre>...</pre>, as if it were |
| 850 | ** displayed using the "fossil help" command. |
| 851 | ** |
| 852 | ** raw Show the raw help text without any formatting. |
| @@ -863,10 +872,15 @@ | |
| 863 | |
| 864 | style_set_current_feature("tkt"); |
| 865 | style_submenu_element("Topic-List", "%R/help"); |
| 866 | if( search_restrict(SRCH_HELP)!=0 ){ |
| 867 | style_submenu_element("Search","%R/search?y=h"); |
| 868 | } |
| 869 | rc = dispatch_name_search(zCmd, CMDFLAG_ANY|CMDFLAG_PREFIX, &pCmd); |
| 870 | if( pCmd ){ |
| 871 | style_header("Help: %s", pCmd->zName); |
| 872 | }else{ |
| @@ -935,11 +949,11 @@ | |
| 935 | const char *zBoldOff = aCommand[i].eCmdFlags&CMDFLAG_1ST_TIER?"</b>":""; |
| 936 | if( '/'==*z || strncmp(z,"test",4)==0 ) continue; |
| 937 | if( (aCommand[i].eCmdFlags & CMDFLAG_SETTING)!=0 ) continue; |
| 938 | else if( (aCommand[i].eCmdFlags & CMDFLAG_HIDDEN)!=0 ) continue; |
| 939 | else if( (aCommand[i].eCmdFlags & CMDFLAG_ALIAS)!=0 ) continue; |
| 940 | @ <li><a href="%R/help?cmd=%s(z)">%s(zBoldOn)%s(z)%s(zBoldOff)</a> |
| 941 | /* Output aliases */ |
| 942 | if( occHelp[aCommand[i].iHelp] > 1 ){ |
| 943 | int j; |
| 944 | int aliases[MX_HELP_DUP], nAliases=0; |
| 945 | for(j=0; j<occHelp[aCommand[i].iHelp]; j++){ |
| @@ -952,11 +966,11 @@ | |
| 952 | } |
| 953 | if( nAliases>0 ){ |
| 954 | int k; |
| 955 | @(\ |
| 956 | for(k=0; k<nAliases; k++){ |
| 957 | @<a href="%R/help?cmd=%s(aCommand[aliases[k]].zName)">\ |
| 958 | @%s(aCommand[aliases[k]].zName)</a>%s((k<nAliases-1)?", ":"")\ |
| 959 | } |
| 960 | @)\ |
| 961 | } |
| 962 | } |
| @@ -972,11 +986,11 @@ | |
| 972 | for(i=0; i<MX_COMMAND; i++){ |
| 973 | const char *z = aCommand[i].zName; |
| 974 | if( '/'!=*z ) continue; |
| 975 | else if( (aCommand[i].eCmdFlags & CMDFLAG_HIDDEN)!=0 ) continue; |
| 976 | if( aCommand[i].zHelp[0] ){ |
| 977 | @ <li><a href="%R/help?cmd=%s(z)">%s(z+1)</a></li> |
| 978 | }else{ |
| 979 | @ <li>%s(z+1)</li> |
| 980 | } |
| 981 | } |
| 982 | @ </ul></div> |
| @@ -988,11 +1002,11 @@ | |
| 988 | for(i=0; i<MX_COMMAND; i++){ |
| 989 | const char *z = aCommand[i].zName; |
| 990 | if( strncmp(z,"test",4)!=0 ) continue; |
| 991 | else if( (aCommand[i].eCmdFlags & CMDFLAG_HIDDEN)!=0 ) continue; |
| 992 | if( aCommand[i].zHelp[0] ){ |
| 993 | @ <li><a href="%R/help?cmd=%s(z)">%s(z)</a></li> |
| 994 | }else{ |
| 995 | @ <li>%s(z)</li> |
| 996 | } |
| 997 | } |
| 998 | @ </ul></div> |
| @@ -1004,11 +1018,11 @@ | |
| 1004 | for(i=0; i<MX_COMMAND; i++){ |
| 1005 | const char *z = aCommand[i].zName; |
| 1006 | if( (aCommand[i].eCmdFlags & CMDFLAG_SETTING)==0 ) continue; |
| 1007 | else if( (aCommand[i].eCmdFlags & CMDFLAG_HIDDEN)!=0 ) continue; |
| 1008 | if( aCommand[i].zHelp[0] ){ |
| 1009 | @ <li><a href="%R/help?cmd=%s(z)">%s(z)</a></li> |
| 1010 | }else{ |
| 1011 | @ <li>%s(z)</li> |
| 1012 | } |
| 1013 | } |
| 1014 | @ </ul></div> |
| 1015 |
| --- src/dispatch.c | |
| +++ src/dispatch.c | |
| @@ -275,11 +275,11 @@ | |
| 275 | char c = z[i]; |
| 276 | if( c=='[' && (j = help_is_link(z+i, n-i))>0 ){ |
| 277 | if( i ) blob_append(pOut, z, i); |
| 278 | z += i+2; |
| 279 | n -= i+2; |
| 280 | blob_appendf(pOut, "<a href='%R/help/%.*s'>%.*s</a>", |
| 281 | j-3, z, j-3, z); |
| 282 | z += j-1; |
| 283 | n -= j-1; |
| 284 | i = 0; |
| 285 | }else if( c=='%' && n-i>=7 && strncmp(z+i,"%fossil",7)==0 ){ |
| @@ -835,18 +835,27 @@ | |
| 835 | return 0; |
| 836 | } |
| 837 | |
| 838 | /* |
| 839 | ** WEBPAGE: help |
| 840 | ** URL: /help/CMD or /help/www/PAGE |
| 841 | ** |
| 842 | ** Show the built-in help text for CMD or PAGE. CMD can be a command-line |
| 843 | ** interface command or a setting name. PAGE is the name of a |
| 844 | ** web interface. /help//PAGE also works if the double-/ makes it through |
| 845 | ** the main web server. |
| 846 | ** |
| 847 | ** Query parameters: |
| 848 | ** |
| 849 | ** name=CMD Show help for CMD where CMD is a command name or |
| 850 | ** or setting name. If CMD beings with "/" it is |
| 851 | ** interpreted as a PAGE name. |
| 852 | ** |
| 853 | ** name=www/PAGE Show help for web page PAGE. |
| 854 | ** |
| 855 | ** name=/PAGE The initial "www/" on web-page help can be abbreiated as |
| 856 | ** just "/" |
| 857 | ** |
| 858 | ** plaintext Show the help within <pre>...</pre>, as if it were |
| 859 | ** displayed using the "fossil help" command. |
| 860 | ** |
| 861 | ** raw Show the raw help text without any formatting. |
| @@ -863,10 +872,15 @@ | |
| 872 | |
| 873 | style_set_current_feature("tkt"); |
| 874 | style_submenu_element("Topic-List", "%R/help"); |
| 875 | if( search_restrict(SRCH_HELP)!=0 ){ |
| 876 | style_submenu_element("Search","%R/search?y=h"); |
| 877 | } |
| 878 | if( strncmp(zCmd,"www/",4)==0 && zCmd[4]!=0 ){ |
| 879 | /* Use https://domain/fossil/help/www/timeline or similar with the "www" |
| 880 | ** intermediate tag to view web-page documention. */ |
| 881 | zCmd += 3; |
| 882 | } |
| 883 | rc = dispatch_name_search(zCmd, CMDFLAG_ANY|CMDFLAG_PREFIX, &pCmd); |
| 884 | if( pCmd ){ |
| 885 | style_header("Help: %s", pCmd->zName); |
| 886 | }else{ |
| @@ -935,11 +949,11 @@ | |
| 949 | const char *zBoldOff = aCommand[i].eCmdFlags&CMDFLAG_1ST_TIER?"</b>":""; |
| 950 | if( '/'==*z || strncmp(z,"test",4)==0 ) continue; |
| 951 | if( (aCommand[i].eCmdFlags & CMDFLAG_SETTING)!=0 ) continue; |
| 952 | else if( (aCommand[i].eCmdFlags & CMDFLAG_HIDDEN)!=0 ) continue; |
| 953 | else if( (aCommand[i].eCmdFlags & CMDFLAG_ALIAS)!=0 ) continue; |
| 954 | @ <li><a href="%R/help/%s(z)">%s(zBoldOn)%s(z)%s(zBoldOff)</a> |
| 955 | /* Output aliases */ |
| 956 | if( occHelp[aCommand[i].iHelp] > 1 ){ |
| 957 | int j; |
| 958 | int aliases[MX_HELP_DUP], nAliases=0; |
| 959 | for(j=0; j<occHelp[aCommand[i].iHelp]; j++){ |
| @@ -952,11 +966,11 @@ | |
| 966 | } |
| 967 | if( nAliases>0 ){ |
| 968 | int k; |
| 969 | @(\ |
| 970 | for(k=0; k<nAliases; k++){ |
| 971 | @<a href="%R/help/%s(aCommand[aliases[k]].zName)">\ |
| 972 | @%s(aCommand[aliases[k]].zName)</a>%s((k<nAliases-1)?", ":"")\ |
| 973 | } |
| 974 | @)\ |
| 975 | } |
| 976 | } |
| @@ -972,11 +986,11 @@ | |
| 986 | for(i=0; i<MX_COMMAND; i++){ |
| 987 | const char *z = aCommand[i].zName; |
| 988 | if( '/'!=*z ) continue; |
| 989 | else if( (aCommand[i].eCmdFlags & CMDFLAG_HIDDEN)!=0 ) continue; |
| 990 | if( aCommand[i].zHelp[0] ){ |
| 991 | @ <li><a href="%R/help/www%s(z)">%s(z+1)</a></li> |
| 992 | }else{ |
| 993 | @ <li>%s(z+1)</li> |
| 994 | } |
| 995 | } |
| 996 | @ </ul></div> |
| @@ -988,11 +1002,11 @@ | |
| 1002 | for(i=0; i<MX_COMMAND; i++){ |
| 1003 | const char *z = aCommand[i].zName; |
| 1004 | if( strncmp(z,"test",4)!=0 ) continue; |
| 1005 | else if( (aCommand[i].eCmdFlags & CMDFLAG_HIDDEN)!=0 ) continue; |
| 1006 | if( aCommand[i].zHelp[0] ){ |
| 1007 | @ <li><a href="%R/help/%s(z)">%s(z)</a></li> |
| 1008 | }else{ |
| 1009 | @ <li>%s(z)</li> |
| 1010 | } |
| 1011 | } |
| 1012 | @ </ul></div> |
| @@ -1004,11 +1018,11 @@ | |
| 1018 | for(i=0; i<MX_COMMAND; i++){ |
| 1019 | const char *z = aCommand[i].zName; |
| 1020 | if( (aCommand[i].eCmdFlags & CMDFLAG_SETTING)==0 ) continue; |
| 1021 | else if( (aCommand[i].eCmdFlags & CMDFLAG_HIDDEN)!=0 ) continue; |
| 1022 | if( aCommand[i].zHelp[0] ){ |
| 1023 | @ <li><a href="%R/help/%s(z)">%s(z)</a></li> |
| 1024 | }else{ |
| 1025 | @ <li>%s(z)</li> |
| 1026 | } |
| 1027 | } |
| 1028 | @ </ul></div> |
| 1029 |
+3
-3
| --- src/doc.c | ||
| +++ src/doc.c | ||
| @@ -520,20 +520,20 @@ | ||
| 520 | 520 | char *zCustomList = 0; /* value of the mimetypes setting */ |
| 521 | 521 | int nCustomEntries = 0; /* number of entries in the mimetypes |
| 522 | 522 | ** setting */ |
| 523 | 523 | mimetype_verify(); |
| 524 | 524 | style_header("Mimetype List"); |
| 525 | - @ <p>The Fossil <a href="%R/help?cmd=/doc">/doc</a> page uses filename | |
| 525 | + @ <p>The Fossil <a href="%R/help/www/doc">/doc</a> page uses filename | |
| 526 | 526 | @ suffixes and the following tables to guess at the appropriate mimetype |
| 527 | 527 | @ for each document. Mimetypes may be customized and overridden using |
| 528 | - @ <a href="%R/help?cmd=mimetypes">the mimetypes config setting</a>.</p> | |
| 528 | + @ <a href="%R/help/mimetypes">the mimetypes config setting</a>.</p> | |
| 529 | 529 | zCustomList = db_get("mimetypes",0); |
| 530 | 530 | if( zCustomList!=0 ){ |
| 531 | 531 | Blob list, entry, key, val; |
| 532 | 532 | @ <h1>Repository-specific mimetypes</h1> |
| 533 | 533 | @ <p>The following extension-to-mimetype mappings are defined via |
| 534 | - @ the <a href="%R/help?cmd=mimetypes">mimetypes setting</a>.</p> | |
| 534 | + @ the <a href="%R/help/mimetypes">mimetypes setting</a>.</p> | |
| 535 | 535 | @ <table class='sortable mimetypetable' border=1 cellpadding=0 \ |
| 536 | 536 | @ data-column-types='tt' data-init-sort='0'> |
| 537 | 537 | @ <thead> |
| 538 | 538 | @ <tr><th>Suffix<th>Mimetype |
| 539 | 539 | @ </thead> |
| 540 | 540 |
| --- src/doc.c | |
| +++ src/doc.c | |
| @@ -520,20 +520,20 @@ | |
| 520 | char *zCustomList = 0; /* value of the mimetypes setting */ |
| 521 | int nCustomEntries = 0; /* number of entries in the mimetypes |
| 522 | ** setting */ |
| 523 | mimetype_verify(); |
| 524 | style_header("Mimetype List"); |
| 525 | @ <p>The Fossil <a href="%R/help?cmd=/doc">/doc</a> page uses filename |
| 526 | @ suffixes and the following tables to guess at the appropriate mimetype |
| 527 | @ for each document. Mimetypes may be customized and overridden using |
| 528 | @ <a href="%R/help?cmd=mimetypes">the mimetypes config setting</a>.</p> |
| 529 | zCustomList = db_get("mimetypes",0); |
| 530 | if( zCustomList!=0 ){ |
| 531 | Blob list, entry, key, val; |
| 532 | @ <h1>Repository-specific mimetypes</h1> |
| 533 | @ <p>The following extension-to-mimetype mappings are defined via |
| 534 | @ the <a href="%R/help?cmd=mimetypes">mimetypes setting</a>.</p> |
| 535 | @ <table class='sortable mimetypetable' border=1 cellpadding=0 \ |
| 536 | @ data-column-types='tt' data-init-sort='0'> |
| 537 | @ <thead> |
| 538 | @ <tr><th>Suffix<th>Mimetype |
| 539 | @ </thead> |
| 540 |
| --- src/doc.c | |
| +++ src/doc.c | |
| @@ -520,20 +520,20 @@ | |
| 520 | char *zCustomList = 0; /* value of the mimetypes setting */ |
| 521 | int nCustomEntries = 0; /* number of entries in the mimetypes |
| 522 | ** setting */ |
| 523 | mimetype_verify(); |
| 524 | style_header("Mimetype List"); |
| 525 | @ <p>The Fossil <a href="%R/help/www/doc">/doc</a> page uses filename |
| 526 | @ suffixes and the following tables to guess at the appropriate mimetype |
| 527 | @ for each document. Mimetypes may be customized and overridden using |
| 528 | @ <a href="%R/help/mimetypes">the mimetypes config setting</a>.</p> |
| 529 | zCustomList = db_get("mimetypes",0); |
| 530 | if( zCustomList!=0 ){ |
| 531 | Blob list, entry, key, val; |
| 532 | @ <h1>Repository-specific mimetypes</h1> |
| 533 | @ <p>The following extension-to-mimetype mappings are defined via |
| 534 | @ the <a href="%R/help/mimetypes">mimetypes setting</a>.</p> |
| 535 | @ <table class='sortable mimetypetable' border=1 cellpadding=0 \ |
| 536 | @ data-column-types='tt' data-init-sort='0'> |
| 537 | @ <thead> |
| 538 | @ <tr><th>Suffix<th>Mimetype |
| 539 | @ </thead> |
| 540 |
+2
-2
| --- src/forum.c | ||
| +++ src/forum.c | ||
| @@ -1912,18 +1912,18 @@ | ||
| 1912 | 1912 | zQP[1] = zQP[0]; |
| 1913 | 1913 | zQP[2] = 0; |
| 1914 | 1914 | if( pSetting->width==0 ){ |
| 1915 | 1915 | /* Boolean setting */ |
| 1916 | 1916 | @ <tr><td align="right"> |
| 1917 | - @ <a href='%R/help?cmd=%h(pSetting->name)'>%h(pSetting->name)</a>: | |
| 1917 | + @ <a href='%R/help/%h(pSetting->name)'>%h(pSetting->name)</a>: | |
| 1918 | 1918 | @ </td><td> |
| 1919 | 1919 | onoff_attribute("", zQP, pSetting->name/*works-like:"x"*/, 0, 0); |
| 1920 | 1920 | @ </td></tr> |
| 1921 | 1921 | }else{ |
| 1922 | 1922 | /* Text value setting */ |
| 1923 | 1923 | @ <tr><td align="right"> |
| 1924 | - @ <a href='%R/help?cmd=%h(pSetting->name)'>%h(pSetting->name)</a>: | |
| 1924 | + @ <a href='%R/help/%h(pSetting->name)'>%h(pSetting->name)</a>: | |
| 1925 | 1925 | @ </td><td> |
| 1926 | 1926 | entry_attribute("", 25, pSetting->name, zQP/*works-like:""*/, |
| 1927 | 1927 | pSetting->def, 0); |
| 1928 | 1928 | @ </td></tr> |
| 1929 | 1929 | } |
| 1930 | 1930 |
| --- src/forum.c | |
| +++ src/forum.c | |
| @@ -1912,18 +1912,18 @@ | |
| 1912 | zQP[1] = zQP[0]; |
| 1913 | zQP[2] = 0; |
| 1914 | if( pSetting->width==0 ){ |
| 1915 | /* Boolean setting */ |
| 1916 | @ <tr><td align="right"> |
| 1917 | @ <a href='%R/help?cmd=%h(pSetting->name)'>%h(pSetting->name)</a>: |
| 1918 | @ </td><td> |
| 1919 | onoff_attribute("", zQP, pSetting->name/*works-like:"x"*/, 0, 0); |
| 1920 | @ </td></tr> |
| 1921 | }else{ |
| 1922 | /* Text value setting */ |
| 1923 | @ <tr><td align="right"> |
| 1924 | @ <a href='%R/help?cmd=%h(pSetting->name)'>%h(pSetting->name)</a>: |
| 1925 | @ </td><td> |
| 1926 | entry_attribute("", 25, pSetting->name, zQP/*works-like:""*/, |
| 1927 | pSetting->def, 0); |
| 1928 | @ </td></tr> |
| 1929 | } |
| 1930 |
| --- src/forum.c | |
| +++ src/forum.c | |
| @@ -1912,18 +1912,18 @@ | |
| 1912 | zQP[1] = zQP[0]; |
| 1913 | zQP[2] = 0; |
| 1914 | if( pSetting->width==0 ){ |
| 1915 | /* Boolean setting */ |
| 1916 | @ <tr><td align="right"> |
| 1917 | @ <a href='%R/help/%h(pSetting->name)'>%h(pSetting->name)</a>: |
| 1918 | @ </td><td> |
| 1919 | onoff_attribute("", zQP, pSetting->name/*works-like:"x"*/, 0, 0); |
| 1920 | @ </td></tr> |
| 1921 | }else{ |
| 1922 | /* Text value setting */ |
| 1923 | @ <tr><td align="right"> |
| 1924 | @ <a href='%R/help/%h(pSetting->name)'>%h(pSetting->name)</a>: |
| 1925 | @ </td><td> |
| 1926 | entry_attribute("", 25, pSetting->name, zQP/*works-like:""*/, |
| 1927 | pSetting->def, 0); |
| 1928 | @ </td></tr> |
| 1929 | } |
| 1930 |
+1
-1
| --- src/markdown.md | ||
| +++ src/markdown.md | ||
| @@ -188,11 +188,11 @@ | ||
| 188 | 188 | |
| 189 | 189 | ## Miscellaneous ## |
| 190 | 190 | |
| 191 | 191 | > * In-line images are made using **\!\[alt-text\]\(image-URL\)**. |
| 192 | 192 | > * Use HTML for advanced formatting such as forms, noting that certain |
| 193 | -> tags are [disallowed in some contexts](/help?cmd=safe-html). | |
| 193 | +> tags are [disallowed in some contexts](/help/safe-html). | |
| 194 | 194 | > * **\<!--** HTML-style comments **-->** are supported. |
| 195 | 195 | > * Escape special characters (ex: **\[** **\(** **\|** **\***) |
| 196 | 196 | > using backslash (ex: **\\\[** **\\\(** **\\\|** **\\\***). |
| 197 | 197 | > * A line consisting of **---**, **\*\*\***, or **\_\_\_** is a horizontal |
| 198 | 198 | > rule. Spaces and extra **-**/**\***/**_** are allowed. |
| 199 | 199 |
| --- src/markdown.md | |
| +++ src/markdown.md | |
| @@ -188,11 +188,11 @@ | |
| 188 | |
| 189 | ## Miscellaneous ## |
| 190 | |
| 191 | > * In-line images are made using **\!\[alt-text\]\(image-URL\)**. |
| 192 | > * Use HTML for advanced formatting such as forms, noting that certain |
| 193 | > tags are [disallowed in some contexts](/help?cmd=safe-html). |
| 194 | > * **\<!--** HTML-style comments **-->** are supported. |
| 195 | > * Escape special characters (ex: **\[** **\(** **\|** **\***) |
| 196 | > using backslash (ex: **\\\[** **\\\(** **\\\|** **\\\***). |
| 197 | > * A line consisting of **---**, **\*\*\***, or **\_\_\_** is a horizontal |
| 198 | > rule. Spaces and extra **-**/**\***/**_** are allowed. |
| 199 |
| --- src/markdown.md | |
| +++ src/markdown.md | |
| @@ -188,11 +188,11 @@ | |
| 188 | |
| 189 | ## Miscellaneous ## |
| 190 | |
| 191 | > * In-line images are made using **\!\[alt-text\]\(image-URL\)**. |
| 192 | > * Use HTML for advanced formatting such as forms, noting that certain |
| 193 | > tags are [disallowed in some contexts](/help/safe-html). |
| 194 | > * **\<!--** HTML-style comments **-->** are supported. |
| 195 | > * Escape special characters (ex: **\[** **\(** **\|** **\***) |
| 196 | > using backslash (ex: **\\\[** **\\\(** **\\\|** **\\\***). |
| 197 | > * A line consisting of **---**, **\*\*\***, or **\_\_\_** is a horizontal |
| 198 | > rule. Spaces and extra **-**/**\***/**_** are allowed. |
| 199 |
+1
-1
| --- src/search.c | ||
| +++ src/search.c | ||
| @@ -983,11 +983,11 @@ | ||
| 983 | 983 | zPrefix = "Built-in help for the"; |
| 984 | 984 | } |
| 985 | 985 | db_multi_exec( |
| 986 | 986 | "INSERT INTO x(label,url,score,id,snip)" |
| 987 | 987 | " SELECT format('%q \"%%s\" %%s',name,type)," |
| 988 | - " '/help?cmd='||name," | |
| 988 | + " '/help/'||name," | |
| 989 | 989 | " search_score()," |
| 990 | 990 | " 'h'||rowid," |
| 991 | 991 | " search_snippet()" |
| 992 | 992 | " FROM helptext" |
| 993 | 993 | " WHERE search_match(format('the \"%%s\" %%s',name,type)," |
| 994 | 994 |
| --- src/search.c | |
| +++ src/search.c | |
| @@ -983,11 +983,11 @@ | |
| 983 | zPrefix = "Built-in help for the"; |
| 984 | } |
| 985 | db_multi_exec( |
| 986 | "INSERT INTO x(label,url,score,id,snip)" |
| 987 | " SELECT format('%q \"%%s\" %%s',name,type)," |
| 988 | " '/help?cmd='||name," |
| 989 | " search_score()," |
| 990 | " 'h'||rowid," |
| 991 | " search_snippet()" |
| 992 | " FROM helptext" |
| 993 | " WHERE search_match(format('the \"%%s\" %%s',name,type)," |
| 994 |
| --- src/search.c | |
| +++ src/search.c | |
| @@ -983,11 +983,11 @@ | |
| 983 | zPrefix = "Built-in help for the"; |
| 984 | } |
| 985 | db_multi_exec( |
| 986 | "INSERT INTO x(label,url,score,id,snip)" |
| 987 | " SELECT format('%q \"%%s\" %%s',name,type)," |
| 988 | " '/help/'||name," |
| 989 | " search_score()," |
| 990 | " 'h'||rowid," |
| 991 | " search_snippet()" |
| 992 | " FROM helptext" |
| 993 | " WHERE search_match(format('the \"%%s\" %%s',name,type)," |
| 994 |
+1
-1
| --- src/security_audit.c | ||
| +++ src/security_audit.c | ||
| @@ -369,11 +369,11 @@ | ||
| 369 | 369 | zVulnReport = db_get("vuln-report","log"); |
| 370 | 370 | if( fossil_strcmp(zVulnReport,"block")!=0 |
| 371 | 371 | && fossil_strcmp(zVulnReport,"fatal")!=0 |
| 372 | 372 | ){ |
| 373 | 373 | @ <li><p><b>WARNING:</b> |
| 374 | - @ The <a href="%R/help?cmd=vuln-report">vuln-report setting</a> | |
| 374 | + @ The <a href="%R/help/vuln-report">vuln-report setting</a> | |
| 375 | 375 | @ has a value of "%h(zVulnReport)". This disables defenses against |
| 376 | 376 | @ XSS or SQL-injection vulnerabilities caused by coding errors in |
| 377 | 377 | @ custom TH1 scripts. For the best security, change |
| 378 | 378 | @ the value of the vuln-report setting to "block" or "fatal". |
| 379 | 379 | } |
| 380 | 380 |
| --- src/security_audit.c | |
| +++ src/security_audit.c | |
| @@ -369,11 +369,11 @@ | |
| 369 | zVulnReport = db_get("vuln-report","log"); |
| 370 | if( fossil_strcmp(zVulnReport,"block")!=0 |
| 371 | && fossil_strcmp(zVulnReport,"fatal")!=0 |
| 372 | ){ |
| 373 | @ <li><p><b>WARNING:</b> |
| 374 | @ The <a href="%R/help?cmd=vuln-report">vuln-report setting</a> |
| 375 | @ has a value of "%h(zVulnReport)". This disables defenses against |
| 376 | @ XSS or SQL-injection vulnerabilities caused by coding errors in |
| 377 | @ custom TH1 scripts. For the best security, change |
| 378 | @ the value of the vuln-report setting to "block" or "fatal". |
| 379 | } |
| 380 |
| --- src/security_audit.c | |
| +++ src/security_audit.c | |
| @@ -369,11 +369,11 @@ | |
| 369 | zVulnReport = db_get("vuln-report","log"); |
| 370 | if( fossil_strcmp(zVulnReport,"block")!=0 |
| 371 | && fossil_strcmp(zVulnReport,"fatal")!=0 |
| 372 | ){ |
| 373 | @ <li><p><b>WARNING:</b> |
| 374 | @ The <a href="%R/help/vuln-report">vuln-report setting</a> |
| 375 | @ has a value of "%h(zVulnReport)". This disables defenses against |
| 376 | @ XSS or SQL-injection vulnerabilities caused by coding errors in |
| 377 | @ custom TH1 scripts. For the best security, change |
| 378 | @ the value of the vuln-report setting to "block" or "fatal". |
| 379 | } |
| 380 |
+3
-3
| --- src/setup.c | ||
| +++ src/setup.c | ||
| @@ -1175,11 +1175,11 @@ | ||
| 1175 | 1175 | continue; |
| 1176 | 1176 | } |
| 1177 | 1177 | onoff_attribute("", pSet->name, |
| 1178 | 1178 | pSet->var!=0 ? pSet->var : pSet->name /*works-like:"x"*/, |
| 1179 | 1179 | is_truth(pSet->def), hasVersionableValue); |
| 1180 | - @ <a href='%R/help?cmd=%s(pSet->name)'>%h(pSet->name)</a> | |
| 1180 | + @ <a href='%R/help/%s(pSet->name)'>%h(pSet->name)</a> | |
| 1181 | 1181 | if( pSet->versionable ){ |
| 1182 | 1182 | @ (v)<br> |
| 1183 | 1183 | } else { |
| 1184 | 1184 | @ <br> |
| 1185 | 1185 | } |
| @@ -1194,11 +1194,11 @@ | ||
| 1194 | 1194 | (db_get_versioned(pSet->name, NULL, NULL)!=0); |
| 1195 | 1195 | if( bIfChng && setting_has_default_value(pSet, db_get(pSet->name,0)) ){ |
| 1196 | 1196 | continue; |
| 1197 | 1197 | } |
| 1198 | 1198 | @ <tr><td> |
| 1199 | - @ <a href='%R/help?cmd=%s(pSet->name)'>%h(pSet->name)</a> | |
| 1199 | + @ <a href='%R/help/%s(pSet->name)'>%h(pSet->name)</a> | |
| 1200 | 1200 | if( pSet->versionable ){ |
| 1201 | 1201 | @ (v) |
| 1202 | 1202 | } else { |
| 1203 | 1203 | @ |
| 1204 | 1204 | } |
| @@ -1215,11 +1215,11 @@ | ||
| 1215 | 1215 | if( pSet->width>0 && pSet->forceTextArea ){ |
| 1216 | 1216 | int hasVersionableValue = db_get_versioned(pSet->name, NULL, NULL)!=0; |
| 1217 | 1217 | if( bIfChng && setting_has_default_value(pSet, db_get(pSet->name,0)) ){ |
| 1218 | 1218 | continue; |
| 1219 | 1219 | } |
| 1220 | - @ <a href='%R/help?cmd=%s(pSet->name)'>%s(pSet->name)</a> | |
| 1220 | + @ <a href='%R/help/%s(pSet->name)'>%s(pSet->name)</a> | |
| 1221 | 1221 | if( pSet->versionable ){ |
| 1222 | 1222 | @ (v)<br> |
| 1223 | 1223 | } else { |
| 1224 | 1224 | @ <br> |
| 1225 | 1225 | } |
| 1226 | 1226 |
| --- src/setup.c | |
| +++ src/setup.c | |
| @@ -1175,11 +1175,11 @@ | |
| 1175 | continue; |
| 1176 | } |
| 1177 | onoff_attribute("", pSet->name, |
| 1178 | pSet->var!=0 ? pSet->var : pSet->name /*works-like:"x"*/, |
| 1179 | is_truth(pSet->def), hasVersionableValue); |
| 1180 | @ <a href='%R/help?cmd=%s(pSet->name)'>%h(pSet->name)</a> |
| 1181 | if( pSet->versionable ){ |
| 1182 | @ (v)<br> |
| 1183 | } else { |
| 1184 | @ <br> |
| 1185 | } |
| @@ -1194,11 +1194,11 @@ | |
| 1194 | (db_get_versioned(pSet->name, NULL, NULL)!=0); |
| 1195 | if( bIfChng && setting_has_default_value(pSet, db_get(pSet->name,0)) ){ |
| 1196 | continue; |
| 1197 | } |
| 1198 | @ <tr><td> |
| 1199 | @ <a href='%R/help?cmd=%s(pSet->name)'>%h(pSet->name)</a> |
| 1200 | if( pSet->versionable ){ |
| 1201 | @ (v) |
| 1202 | } else { |
| 1203 | @ |
| 1204 | } |
| @@ -1215,11 +1215,11 @@ | |
| 1215 | if( pSet->width>0 && pSet->forceTextArea ){ |
| 1216 | int hasVersionableValue = db_get_versioned(pSet->name, NULL, NULL)!=0; |
| 1217 | if( bIfChng && setting_has_default_value(pSet, db_get(pSet->name,0)) ){ |
| 1218 | continue; |
| 1219 | } |
| 1220 | @ <a href='%R/help?cmd=%s(pSet->name)'>%s(pSet->name)</a> |
| 1221 | if( pSet->versionable ){ |
| 1222 | @ (v)<br> |
| 1223 | } else { |
| 1224 | @ <br> |
| 1225 | } |
| 1226 |
| --- src/setup.c | |
| +++ src/setup.c | |
| @@ -1175,11 +1175,11 @@ | |
| 1175 | continue; |
| 1176 | } |
| 1177 | onoff_attribute("", pSet->name, |
| 1178 | pSet->var!=0 ? pSet->var : pSet->name /*works-like:"x"*/, |
| 1179 | is_truth(pSet->def), hasVersionableValue); |
| 1180 | @ <a href='%R/help/%s(pSet->name)'>%h(pSet->name)</a> |
| 1181 | if( pSet->versionable ){ |
| 1182 | @ (v)<br> |
| 1183 | } else { |
| 1184 | @ <br> |
| 1185 | } |
| @@ -1194,11 +1194,11 @@ | |
| 1194 | (db_get_versioned(pSet->name, NULL, NULL)!=0); |
| 1195 | if( bIfChng && setting_has_default_value(pSet, db_get(pSet->name,0)) ){ |
| 1196 | continue; |
| 1197 | } |
| 1198 | @ <tr><td> |
| 1199 | @ <a href='%R/help/%s(pSet->name)'>%h(pSet->name)</a> |
| 1200 | if( pSet->versionable ){ |
| 1201 | @ (v) |
| 1202 | } else { |
| 1203 | @ |
| 1204 | } |
| @@ -1215,11 +1215,11 @@ | |
| 1215 | if( pSet->width>0 && pSet->forceTextArea ){ |
| 1216 | int hasVersionableValue = db_get_versioned(pSet->name, NULL, NULL)!=0; |
| 1217 | if( bIfChng && setting_has_default_value(pSet, db_get(pSet->name,0)) ){ |
| 1218 | continue; |
| 1219 | } |
| 1220 | @ <a href='%R/help/%s(pSet->name)'>%s(pSet->name)</a> |
| 1221 | if( pSet->versionable ){ |
| 1222 | @ (v)<br> |
| 1223 | } else { |
| 1224 | @ <br> |
| 1225 | } |
| 1226 |
+1
-1
| --- src/timeline.c | ||
| +++ src/timeline.c | ||
| @@ -2045,11 +2045,11 @@ | ||
| 2045 | 2045 | zBisect = 0; |
| 2046 | 2046 | } |
| 2047 | 2047 | |
| 2048 | 2048 | style_header("Timeline"); |
| 2049 | 2049 | if( advancedMenu ){ |
| 2050 | - style_submenu_element("Help", "%R/help?cmd=/timeline"); | |
| 2050 | + style_submenu_element("Help", "%R/help/www/timeline"); | |
| 2051 | 2051 | } |
| 2052 | 2052 | login_anonymous_available(); |
| 2053 | 2053 | timeline_temp_table(); |
| 2054 | 2054 | blob_zero(&sql); |
| 2055 | 2055 | blob_zero(&desc); |
| 2056 | 2056 |
| --- src/timeline.c | |
| +++ src/timeline.c | |
| @@ -2045,11 +2045,11 @@ | |
| 2045 | zBisect = 0; |
| 2046 | } |
| 2047 | |
| 2048 | style_header("Timeline"); |
| 2049 | if( advancedMenu ){ |
| 2050 | style_submenu_element("Help", "%R/help?cmd=/timeline"); |
| 2051 | } |
| 2052 | login_anonymous_available(); |
| 2053 | timeline_temp_table(); |
| 2054 | blob_zero(&sql); |
| 2055 | blob_zero(&desc); |
| 2056 |
| --- src/timeline.c | |
| +++ src/timeline.c | |
| @@ -2045,11 +2045,11 @@ | |
| 2045 | zBisect = 0; |
| 2046 | } |
| 2047 | |
| 2048 | style_header("Timeline"); |
| 2049 | if( advancedMenu ){ |
| 2050 | style_submenu_element("Help", "%R/help/www/timeline"); |
| 2051 | } |
| 2052 | login_anonymous_available(); |
| 2053 | timeline_temp_table(); |
| 2054 | blob_zero(&sql); |
| 2055 | blob_zero(&desc); |
| 2056 |
+3
-3
| --- www/aboutcgi.wiki | ||
| +++ www/aboutcgi.wiki | ||
| @@ -131,11 +131,11 @@ | ||
| 131 | 131 | |
| 132 | 132 | Usually, the webpage being requested is the first term of the |
| 133 | 133 | PATH_INFO environment variable. (Exceptions to this rule are noted |
| 134 | 134 | in the sequel.) For our example, the first term of PATH_INFO |
| 135 | 135 | is "timeline", which means that Fossil will generate |
| 136 | -the [/help?cmd=/timeline|/timeline] webpage. | |
| 136 | +the [/help/www/timeline|/timeline] webpage. | |
| 137 | 137 | |
| 138 | 138 | With Fossil, terms of PATH_INFO beyond the webpage name are converted into |
| 139 | 139 | the "name" query parameter. Hence, the following two URLs mean |
| 140 | 140 | exactly the same thing to Fossil: |
| 141 | 141 | <ol type='A'> |
| @@ -143,11 +143,11 @@ | ||
| 143 | 143 | <li> [https://fossil-scm.org/home/info?name=c14ecc43] |
| 144 | 144 | </ol> |
| 145 | 145 | |
| 146 | 146 | In both cases, the CGI script is called "/fossil". For case (A), |
| 147 | 147 | the PATH_INFO variable will be "info/c14ecc43" and so the |
| 148 | -"[/help?cmd=/info|/info]" webpage will be generated and the suffix of | |
| 148 | +"[/help/www/info|/info]" webpage will be generated and the suffix of | |
| 149 | 149 | PATH_INFO will be converted into the "name" query parameter, which |
| 150 | 150 | identifies the artifact about which information is requested. |
| 151 | 151 | In case (B), the PATH_INFO is just "info", but the same "name" |
| 152 | 152 | query parameter is set explicitly by the URL itself. |
| 153 | 153 | |
| @@ -282,11 +282,11 @@ | ||
| 282 | 282 | can then reference various properties values. |
| 283 | 283 | Fossil does not care where the value of each property comes from (POST |
| 284 | 284 | content, cookies, or query parameters) only that the property exists |
| 285 | 285 | and has a value.</p></li> |
| 286 | 286 | <li><p> |
| 287 | -The "[/help?cmd=ui|fossil ui]" and "[/help?cmd=server|fossil server]" commands | |
| 287 | +The "[/help/ui|fossil ui]" and "[/help/server|fossil server]" commands | |
| 288 | 288 | are implemented using a simple built-in web server that accepts incoming HTTP |
| 289 | 289 | requests, translates each request into a CGI invocation, then creates a |
| 290 | 290 | separate child Fossil process to handle each request. In other words, CGI |
| 291 | 291 | is used internally to implement "fossil ui/server". |
| 292 | 292 | <br><br> |
| 293 | 293 |
| --- www/aboutcgi.wiki | |
| +++ www/aboutcgi.wiki | |
| @@ -131,11 +131,11 @@ | |
| 131 | |
| 132 | Usually, the webpage being requested is the first term of the |
| 133 | PATH_INFO environment variable. (Exceptions to this rule are noted |
| 134 | in the sequel.) For our example, the first term of PATH_INFO |
| 135 | is "timeline", which means that Fossil will generate |
| 136 | the [/help?cmd=/timeline|/timeline] webpage. |
| 137 | |
| 138 | With Fossil, terms of PATH_INFO beyond the webpage name are converted into |
| 139 | the "name" query parameter. Hence, the following two URLs mean |
| 140 | exactly the same thing to Fossil: |
| 141 | <ol type='A'> |
| @@ -143,11 +143,11 @@ | |
| 143 | <li> [https://fossil-scm.org/home/info?name=c14ecc43] |
| 144 | </ol> |
| 145 | |
| 146 | In both cases, the CGI script is called "/fossil". For case (A), |
| 147 | the PATH_INFO variable will be "info/c14ecc43" and so the |
| 148 | "[/help?cmd=/info|/info]" webpage will be generated and the suffix of |
| 149 | PATH_INFO will be converted into the "name" query parameter, which |
| 150 | identifies the artifact about which information is requested. |
| 151 | In case (B), the PATH_INFO is just "info", but the same "name" |
| 152 | query parameter is set explicitly by the URL itself. |
| 153 | |
| @@ -282,11 +282,11 @@ | |
| 282 | can then reference various properties values. |
| 283 | Fossil does not care where the value of each property comes from (POST |
| 284 | content, cookies, or query parameters) only that the property exists |
| 285 | and has a value.</p></li> |
| 286 | <li><p> |
| 287 | The "[/help?cmd=ui|fossil ui]" and "[/help?cmd=server|fossil server]" commands |
| 288 | are implemented using a simple built-in web server that accepts incoming HTTP |
| 289 | requests, translates each request into a CGI invocation, then creates a |
| 290 | separate child Fossil process to handle each request. In other words, CGI |
| 291 | is used internally to implement "fossil ui/server". |
| 292 | <br><br> |
| 293 |
| --- www/aboutcgi.wiki | |
| +++ www/aboutcgi.wiki | |
| @@ -131,11 +131,11 @@ | |
| 131 | |
| 132 | Usually, the webpage being requested is the first term of the |
| 133 | PATH_INFO environment variable. (Exceptions to this rule are noted |
| 134 | in the sequel.) For our example, the first term of PATH_INFO |
| 135 | is "timeline", which means that Fossil will generate |
| 136 | the [/help/www/timeline|/timeline] webpage. |
| 137 | |
| 138 | With Fossil, terms of PATH_INFO beyond the webpage name are converted into |
| 139 | the "name" query parameter. Hence, the following two URLs mean |
| 140 | exactly the same thing to Fossil: |
| 141 | <ol type='A'> |
| @@ -143,11 +143,11 @@ | |
| 143 | <li> [https://fossil-scm.org/home/info?name=c14ecc43] |
| 144 | </ol> |
| 145 | |
| 146 | In both cases, the CGI script is called "/fossil". For case (A), |
| 147 | the PATH_INFO variable will be "info/c14ecc43" and so the |
| 148 | "[/help/www/info|/info]" webpage will be generated and the suffix of |
| 149 | PATH_INFO will be converted into the "name" query parameter, which |
| 150 | identifies the artifact about which information is requested. |
| 151 | In case (B), the PATH_INFO is just "info", but the same "name" |
| 152 | query parameter is set explicitly by the URL itself. |
| 153 | |
| @@ -282,11 +282,11 @@ | |
| 282 | can then reference various properties values. |
| 283 | Fossil does not care where the value of each property comes from (POST |
| 284 | content, cookies, or query parameters) only that the property exists |
| 285 | and has a value.</p></li> |
| 286 | <li><p> |
| 287 | The "[/help/ui|fossil ui]" and "[/help/server|fossil server]" commands |
| 288 | are implemented using a simple built-in web server that accepts incoming HTTP |
| 289 | requests, translates each request into a CGI invocation, then creates a |
| 290 | separate child Fossil process to handle each request. In other words, CGI |
| 291 | is used internally to implement "fossil ui/server". |
| 292 | <br><br> |
| 293 |
+11
-11
| --- www/aboutdownload.wiki | ||
| +++ www/aboutdownload.wiki | ||
| @@ -4,29 +4,29 @@ | ||
| 4 | 4 | |
| 5 | 5 | The [/uv/download.html|Download] page for the Fossil self-hosting |
| 6 | 6 | repository is implemented using [./unvers.wiki|unversioned files]. |
| 7 | 7 | The "download.html" screen itself, and the various build products |
| 8 | 8 | are all stored as unversioned content. The download.html page |
| 9 | -uses XMLHttpRequest() to retrieve the [/help?cmd=/juvlist|/juvlist] webpage | |
| 9 | +uses XMLHttpRequest() to retrieve the [/help/www/juvlist|/juvlist] webpage | |
| 10 | 10 | for a list of all unversioned files. Javascript in the |
| 11 | 11 | [/uv/download.js?mimetype=text/plain|download.js] file (which is |
| 12 | 12 | sourced by "download.html") then figures out which unversioned files are |
| 13 | 13 | build products and paints appropriate icons on the displayed |
| 14 | 14 | download page. |
| 15 | 15 | |
| 16 | 16 | Except, the "Source Tarball" download products are not stored as |
| 17 | 17 | unversioned files. They are computed on-demand by the |
| 18 | -[/help?cmd=/tarball|/tarball web page]. | |
| 18 | +[/help/www/tarball|/tarball web page]. | |
| 19 | 19 | |
| 20 | 20 | When a new version is generated, the developers use the |
| 21 | -[/help?cmd=uv|fossil uv edit] command to make minor changes | |
| 21 | +[/help/uv|fossil uv edit] command to make minor changes | |
| 22 | 22 | to the "[/uv/download.js?mimetype=text/plain|download.js]" |
| 23 | 23 | file so that it knows about the |
| 24 | 24 | new version number. Then the developers run |
| 25 | -the [/help?cmd=uv|fossil uv add] command for each | |
| 25 | +the [/help/uv|fossil uv add] command for each | |
| 26 | 26 | build product. Finally, the |
| 27 | -[/help?cmd=uv|fossil uv sync] command is run to push all | |
| 27 | +[/help/uv|fossil uv sync] command is run to push all | |
| 28 | 28 | the content up to servers. All |
| 29 | 29 | [./selfhost.wiki|three self-hosting repositories] for Fossil |
| 30 | 30 | are updated automatically. |
| 31 | 31 | |
| 32 | 32 | <h2>2.0 Details</h2> |
| @@ -51,11 +51,11 @@ | ||
| 51 | 51 | "[./embeddeddoc.wiki|embedded documentation]" for further details on |
| 52 | 52 | how this <div class='fossil-doc'> markup works. |
| 53 | 53 | |
| 54 | 54 | With each new release, the "releases" variable in the javascript on |
| 55 | 55 | the [/uv/download.js?mimetype=text/plain|download.js] page is |
| 56 | -edited (using "[/help?cmd=uv|fossil uv edit download.js]") to add | |
| 56 | +edited (using "[/help/uv|fossil uv edit download.js]") to add | |
| 57 | 57 | details of the release. |
| 58 | 58 | |
| 59 | 59 | When the JavaScript in the "download.js" file runs, it requests |
| 60 | 60 | a listing of all unversioned content using the /juvlist URL. |
| 61 | 61 | ([/juvlist|sample /juvlist output]). The content of the download page is |
| @@ -65,25 +65,25 @@ | ||
| 65 | 65 | Build products need to be constructed on different machines. The precompiled |
| 66 | 66 | binary for Linux is compiled on Linux, the precompiled binary for Windows |
| 67 | 67 | is compiled on Windows11, and so forth. After a new release is tagged, |
| 68 | 68 | the release manager goes around to each of the target platforms, checks |
| 69 | 69 | out the release and compiles it, then runs |
| 70 | -[/help?cmd=uv|fossil uv add] for the build product followed by | |
| 71 | -[/help?cmd=uv|fossil uv sync] to push the new build product to the | |
| 70 | +[/help/uv|fossil uv add] for the build product followed by | |
| 71 | +[/help/uv|fossil uv sync] to push the new build product to the | |
| 72 | 72 | [./selfhost.wiki|various servers]. This process is repeated for |
| 73 | 73 | each build product. |
| 74 | 74 | |
| 75 | 75 | When older builds are retired from the download page, the |
| 76 | 76 | [/uv/download.js?mimetype=text/plain|download.js] page is again |
| 77 | 77 | edited to remove the corresponding entry from the "release" variable |
| 78 | 78 | and the edit is synced using |
| 79 | -[/help?cmd=uv|fossil uv sync]. This causes the build products to | |
| 79 | +[/help/uv|fossil uv sync]. This causes the build products to | |
| 80 | 80 | disappear from the download page immediately. But those build products |
| 81 | 81 | are still taking up space in the unversioned content table of the |
| 82 | 82 | server repository. To purge the obsolete build products, one or |
| 83 | -more [/help?cmd=uv|fossil uv rm] commands are run, followed by | |
| 84 | -another [/help?cmd=uv|fossil uv sync]. It is important to purge | |
| 83 | +more [/help/uv|fossil uv rm] commands are run, followed by | |
| 84 | +another [/help/uv|fossil uv sync]. It is important to purge | |
| 85 | 85 | obsolete build products since they take up a lot of space. |
| 86 | 86 | At [/repo-tabsize] you can see that the unversioned table takes up |
| 87 | 87 | a substantial fraction of the repository. |
| 88 | 88 | |
| 89 | 89 | <h2>3.0 Security</h2> |
| 90 | 90 |
| --- www/aboutdownload.wiki | |
| +++ www/aboutdownload.wiki | |
| @@ -4,29 +4,29 @@ | |
| 4 | |
| 5 | The [/uv/download.html|Download] page for the Fossil self-hosting |
| 6 | repository is implemented using [./unvers.wiki|unversioned files]. |
| 7 | The "download.html" screen itself, and the various build products |
| 8 | are all stored as unversioned content. The download.html page |
| 9 | uses XMLHttpRequest() to retrieve the [/help?cmd=/juvlist|/juvlist] webpage |
| 10 | for a list of all unversioned files. Javascript in the |
| 11 | [/uv/download.js?mimetype=text/plain|download.js] file (which is |
| 12 | sourced by "download.html") then figures out which unversioned files are |
| 13 | build products and paints appropriate icons on the displayed |
| 14 | download page. |
| 15 | |
| 16 | Except, the "Source Tarball" download products are not stored as |
| 17 | unversioned files. They are computed on-demand by the |
| 18 | [/help?cmd=/tarball|/tarball web page]. |
| 19 | |
| 20 | When a new version is generated, the developers use the |
| 21 | [/help?cmd=uv|fossil uv edit] command to make minor changes |
| 22 | to the "[/uv/download.js?mimetype=text/plain|download.js]" |
| 23 | file so that it knows about the |
| 24 | new version number. Then the developers run |
| 25 | the [/help?cmd=uv|fossil uv add] command for each |
| 26 | build product. Finally, the |
| 27 | [/help?cmd=uv|fossil uv sync] command is run to push all |
| 28 | the content up to servers. All |
| 29 | [./selfhost.wiki|three self-hosting repositories] for Fossil |
| 30 | are updated automatically. |
| 31 | |
| 32 | <h2>2.0 Details</h2> |
| @@ -51,11 +51,11 @@ | |
| 51 | "[./embeddeddoc.wiki|embedded documentation]" for further details on |
| 52 | how this <div class='fossil-doc'> markup works. |
| 53 | |
| 54 | With each new release, the "releases" variable in the javascript on |
| 55 | the [/uv/download.js?mimetype=text/plain|download.js] page is |
| 56 | edited (using "[/help?cmd=uv|fossil uv edit download.js]") to add |
| 57 | details of the release. |
| 58 | |
| 59 | When the JavaScript in the "download.js" file runs, it requests |
| 60 | a listing of all unversioned content using the /juvlist URL. |
| 61 | ([/juvlist|sample /juvlist output]). The content of the download page is |
| @@ -65,25 +65,25 @@ | |
| 65 | Build products need to be constructed on different machines. The precompiled |
| 66 | binary for Linux is compiled on Linux, the precompiled binary for Windows |
| 67 | is compiled on Windows11, and so forth. After a new release is tagged, |
| 68 | the release manager goes around to each of the target platforms, checks |
| 69 | out the release and compiles it, then runs |
| 70 | [/help?cmd=uv|fossil uv add] for the build product followed by |
| 71 | [/help?cmd=uv|fossil uv sync] to push the new build product to the |
| 72 | [./selfhost.wiki|various servers]. This process is repeated for |
| 73 | each build product. |
| 74 | |
| 75 | When older builds are retired from the download page, the |
| 76 | [/uv/download.js?mimetype=text/plain|download.js] page is again |
| 77 | edited to remove the corresponding entry from the "release" variable |
| 78 | and the edit is synced using |
| 79 | [/help?cmd=uv|fossil uv sync]. This causes the build products to |
| 80 | disappear from the download page immediately. But those build products |
| 81 | are still taking up space in the unversioned content table of the |
| 82 | server repository. To purge the obsolete build products, one or |
| 83 | more [/help?cmd=uv|fossil uv rm] commands are run, followed by |
| 84 | another [/help?cmd=uv|fossil uv sync]. It is important to purge |
| 85 | obsolete build products since they take up a lot of space. |
| 86 | At [/repo-tabsize] you can see that the unversioned table takes up |
| 87 | a substantial fraction of the repository. |
| 88 | |
| 89 | <h2>3.0 Security</h2> |
| 90 |
| --- www/aboutdownload.wiki | |
| +++ www/aboutdownload.wiki | |
| @@ -4,29 +4,29 @@ | |
| 4 | |
| 5 | The [/uv/download.html|Download] page for the Fossil self-hosting |
| 6 | repository is implemented using [./unvers.wiki|unversioned files]. |
| 7 | The "download.html" screen itself, and the various build products |
| 8 | are all stored as unversioned content. The download.html page |
| 9 | uses XMLHttpRequest() to retrieve the [/help/www/juvlist|/juvlist] webpage |
| 10 | for a list of all unversioned files. Javascript in the |
| 11 | [/uv/download.js?mimetype=text/plain|download.js] file (which is |
| 12 | sourced by "download.html") then figures out which unversioned files are |
| 13 | build products and paints appropriate icons on the displayed |
| 14 | download page. |
| 15 | |
| 16 | Except, the "Source Tarball" download products are not stored as |
| 17 | unversioned files. They are computed on-demand by the |
| 18 | [/help/www/tarball|/tarball web page]. |
| 19 | |
| 20 | When a new version is generated, the developers use the |
| 21 | [/help/uv|fossil uv edit] command to make minor changes |
| 22 | to the "[/uv/download.js?mimetype=text/plain|download.js]" |
| 23 | file so that it knows about the |
| 24 | new version number. Then the developers run |
| 25 | the [/help/uv|fossil uv add] command for each |
| 26 | build product. Finally, the |
| 27 | [/help/uv|fossil uv sync] command is run to push all |
| 28 | the content up to servers. All |
| 29 | [./selfhost.wiki|three self-hosting repositories] for Fossil |
| 30 | are updated automatically. |
| 31 | |
| 32 | <h2>2.0 Details</h2> |
| @@ -51,11 +51,11 @@ | |
| 51 | "[./embeddeddoc.wiki|embedded documentation]" for further details on |
| 52 | how this <div class='fossil-doc'> markup works. |
| 53 | |
| 54 | With each new release, the "releases" variable in the javascript on |
| 55 | the [/uv/download.js?mimetype=text/plain|download.js] page is |
| 56 | edited (using "[/help/uv|fossil uv edit download.js]") to add |
| 57 | details of the release. |
| 58 | |
| 59 | When the JavaScript in the "download.js" file runs, it requests |
| 60 | a listing of all unversioned content using the /juvlist URL. |
| 61 | ([/juvlist|sample /juvlist output]). The content of the download page is |
| @@ -65,25 +65,25 @@ | |
| 65 | Build products need to be constructed on different machines. The precompiled |
| 66 | binary for Linux is compiled on Linux, the precompiled binary for Windows |
| 67 | is compiled on Windows11, and so forth. After a new release is tagged, |
| 68 | the release manager goes around to each of the target platforms, checks |
| 69 | out the release and compiles it, then runs |
| 70 | [/help/uv|fossil uv add] for the build product followed by |
| 71 | [/help/uv|fossil uv sync] to push the new build product to the |
| 72 | [./selfhost.wiki|various servers]. This process is repeated for |
| 73 | each build product. |
| 74 | |
| 75 | When older builds are retired from the download page, the |
| 76 | [/uv/download.js?mimetype=text/plain|download.js] page is again |
| 77 | edited to remove the corresponding entry from the "release" variable |
| 78 | and the edit is synced using |
| 79 | [/help/uv|fossil uv sync]. This causes the build products to |
| 80 | disappear from the download page immediately. But those build products |
| 81 | are still taking up space in the unversioned content table of the |
| 82 | server repository. To purge the obsolete build products, one or |
| 83 | more [/help/uv|fossil uv rm] commands are run, followed by |
| 84 | another [/help/uv|fossil uv sync]. It is important to purge |
| 85 | obsolete build products since they take up a lot of space. |
| 86 | At [/repo-tabsize] you can see that the unversioned table takes up |
| 87 | a substantial fraction of the repository. |
| 88 | |
| 89 | <h2>3.0 Security</h2> |
| 90 |
+11
-11
| --- www/alerts.md | ||
| +++ www/alerts.md | ||
| @@ -3,11 +3,11 @@ | ||
| 3 | 3 | ## Overview |
| 4 | 4 | |
| 5 | 5 | Beginning with version 2.7, Fossil can send email messages to |
| 6 | 6 | subscribers to alert them to changes in the repository: |
| 7 | 7 | |
| 8 | - * New [checkins](/help?cmd=ci) | |
| 8 | + * New [checkins](/help/ci) | |
| 9 | 9 | * [Ticket](./tickets.wiki) changes |
| 10 | 10 | * [Wiki](./wikitheory.wiki) page changes |
| 11 | 11 | * New and edited [forum](./forum.wiki) posts |
| 12 | 12 | * Users receiving [new permissions](./caps/index.md) (admins only) |
| 13 | 13 | * Announcements |
| @@ -541,26 +541,26 @@ | ||
| 541 | 541 | control the email alert system, some of which have not been mentioned so |
| 542 | 542 | far: |
| 543 | 543 | |
| 544 | 544 | Commands: |
| 545 | 545 | |
| 546 | - * The [`alerts`](/help?cmd=alerts) command | |
| 547 | - * The [`test-alert`](/help?cmd=test-alert) command | |
| 548 | - * The [`test-add-alerts`](/help?cmd=test-add-alerts) command | |
| 546 | + * The [`alerts`](/help/alerts) command | |
| 547 | + * The [`test-alert`](/help/test-alert) command | |
| 548 | + * The [`test-add-alerts`](/help/test-add-alerts) command | |
| 549 | 549 | |
| 550 | 550 | Web pages available to users and subscribers: |
| 551 | 551 | |
| 552 | - * The [`/subscribe`](/help?cmd=/subscribe) page | |
| 553 | - * The [`/alerts`](/help?cmd=/alerts) page | |
| 554 | - * The [`/unsubscribe`](/help?cmd=/unsubscribe) page | |
| 555 | - * The [`/renew`](/help?cmd=/renew) page | |
| 556 | - * The [`/contact_admin`](/help?cmd=/contact_admin) page | |
| 552 | + * The [`/subscribe`](/help/www/subscribe) page | |
| 553 | + * The [`/alerts`](/help/www/alerts) page | |
| 554 | + * The [`/unsubscribe`](/help/www/unsubscribe) page | |
| 555 | + * The [`/renew`](/help/www/renew) page | |
| 556 | + * The [`/contact_admin`](/help/www/contact_admin) page | |
| 557 | 557 | |
| 558 | 558 | Administrator-only web pages: |
| 559 | 559 | |
| 560 | - * The [`/setup_notification`](/help?cmd=/setup_notification) page | |
| 561 | - * The [`/subscribers`](/help?cmd=/subscribers) page | |
| 560 | + * The [`/setup_notification`](/help/www/setup_notification) page | |
| 561 | + * The [`/subscribers`](/help/www/subscribers) page | |
| 562 | 562 | |
| 563 | 563 | |
| 564 | 564 | <a id="design"></a> |
| 565 | 565 | ## Design of Email Alerts |
| 566 | 566 | |
| 567 | 567 |
| --- www/alerts.md | |
| +++ www/alerts.md | |
| @@ -3,11 +3,11 @@ | |
| 3 | ## Overview |
| 4 | |
| 5 | Beginning with version 2.7, Fossil can send email messages to |
| 6 | subscribers to alert them to changes in the repository: |
| 7 | |
| 8 | * New [checkins](/help?cmd=ci) |
| 9 | * [Ticket](./tickets.wiki) changes |
| 10 | * [Wiki](./wikitheory.wiki) page changes |
| 11 | * New and edited [forum](./forum.wiki) posts |
| 12 | * Users receiving [new permissions](./caps/index.md) (admins only) |
| 13 | * Announcements |
| @@ -541,26 +541,26 @@ | |
| 541 | control the email alert system, some of which have not been mentioned so |
| 542 | far: |
| 543 | |
| 544 | Commands: |
| 545 | |
| 546 | * The [`alerts`](/help?cmd=alerts) command |
| 547 | * The [`test-alert`](/help?cmd=test-alert) command |
| 548 | * The [`test-add-alerts`](/help?cmd=test-add-alerts) command |
| 549 | |
| 550 | Web pages available to users and subscribers: |
| 551 | |
| 552 | * The [`/subscribe`](/help?cmd=/subscribe) page |
| 553 | * The [`/alerts`](/help?cmd=/alerts) page |
| 554 | * The [`/unsubscribe`](/help?cmd=/unsubscribe) page |
| 555 | * The [`/renew`](/help?cmd=/renew) page |
| 556 | * The [`/contact_admin`](/help?cmd=/contact_admin) page |
| 557 | |
| 558 | Administrator-only web pages: |
| 559 | |
| 560 | * The [`/setup_notification`](/help?cmd=/setup_notification) page |
| 561 | * The [`/subscribers`](/help?cmd=/subscribers) page |
| 562 | |
| 563 | |
| 564 | <a id="design"></a> |
| 565 | ## Design of Email Alerts |
| 566 | |
| 567 |
| --- www/alerts.md | |
| +++ www/alerts.md | |
| @@ -3,11 +3,11 @@ | |
| 3 | ## Overview |
| 4 | |
| 5 | Beginning with version 2.7, Fossil can send email messages to |
| 6 | subscribers to alert them to changes in the repository: |
| 7 | |
| 8 | * New [checkins](/help/ci) |
| 9 | * [Ticket](./tickets.wiki) changes |
| 10 | * [Wiki](./wikitheory.wiki) page changes |
| 11 | * New and edited [forum](./forum.wiki) posts |
| 12 | * Users receiving [new permissions](./caps/index.md) (admins only) |
| 13 | * Announcements |
| @@ -541,26 +541,26 @@ | |
| 541 | control the email alert system, some of which have not been mentioned so |
| 542 | far: |
| 543 | |
| 544 | Commands: |
| 545 | |
| 546 | * The [`alerts`](/help/alerts) command |
| 547 | * The [`test-alert`](/help/test-alert) command |
| 548 | * The [`test-add-alerts`](/help/test-add-alerts) command |
| 549 | |
| 550 | Web pages available to users and subscribers: |
| 551 | |
| 552 | * The [`/subscribe`](/help/www/subscribe) page |
| 553 | * The [`/alerts`](/help/www/alerts) page |
| 554 | * The [`/unsubscribe`](/help/www/unsubscribe) page |
| 555 | * The [`/renew`](/help/www/renew) page |
| 556 | * The [`/contact_admin`](/help/www/contact_admin) page |
| 557 | |
| 558 | Administrator-only web pages: |
| 559 | |
| 560 | * The [`/setup_notification`](/help/www/setup_notification) page |
| 561 | * The [`/subscribers`](/help/www/subscribers) page |
| 562 | |
| 563 | |
| 564 | <a id="design"></a> |
| 565 | ## Design of Email Alerts |
| 566 | |
| 567 |
+8
-8
| --- www/antibot.wiki | ||
| +++ www/antibot.wiki | ||
| @@ -85,11 +85,11 @@ | ||
| 85 | 85 | to "play nicely" on the internet and are quite open |
| 86 | 86 | about the fact that they are a robot. And so the UserAgent string |
| 87 | 87 | provides a good first-guess about whether or not a request originates |
| 88 | 88 | from a human or a robot. |
| 89 | 89 | |
| 90 | -The [/help?cmd=auto-hyperlink|auto-hyperlink] setting, shown as | |
| 90 | +The [/help/auto-hyperlink|auto-hyperlink] setting, shown as | |
| 91 | 91 | "<b>Enable hyperlinks based on User-Agent and/or Javascript</b>" on |
| 92 | 92 | the Robot Defense Settings page, |
| 93 | 93 | can be set to "UserAgent only" or "UserAgent and Javascript" or "off". |
| 94 | 94 | If the UserAgent string looks like a human and not a robot, then |
| 95 | 95 | Fossil will enable hyperlinks even if the <b>Hyperlink</b> capability |
| @@ -110,11 +110,11 @@ | ||
| 110 | 110 | UserAgent string. Most robots do not bother to run JavaScript and |
| 111 | 111 | so to the robot the empty anchor tag will be useless. But all modern |
| 112 | 112 | web browsers implement JavaScript, so hyperlinks will show up |
| 113 | 113 | normally for human users. |
| 114 | 114 | |
| 115 | -If the [/help?cmd=auto-hyperlink|"auto-hyperlink"] setting is (2) | |
| 115 | +If the [/help/auto-hyperlink|"auto-hyperlink"] setting is (2) | |
| 116 | 116 | "<b>Enable hyperlinks using User-Agent and/or Javascript</b>", |
| 117 | 117 | then there are now two additional sub-settings that control when |
| 118 | 118 | hyperlinks are enabled. |
| 119 | 119 | |
| 120 | 120 | The first new sub-setting is a delay (in milliseconds) before setting |
| @@ -134,11 +134,11 @@ | ||
| 134 | 134 | of how expensive pages can be disabled when the server is under heavy |
| 135 | 135 | load. |
| 136 | 136 | |
| 137 | 137 | <h2>Do Not Allow Robot Access To Certain Pages</h2> |
| 138 | 138 | |
| 139 | -The [/help?cmd=robot-restrict|robot-restrict setting] is a comma-separated | |
| 139 | +The [/help/robot-restrict|robot-restrict setting] is a comma-separated | |
| 140 | 140 | list of GLOB patterns for pages for which robot access is prohibited. |
| 141 | 141 | The default value is: |
| 142 | 142 | |
| 143 | 143 | <blockquote><pre> |
| 144 | 144 | timelineX,diff,annotate,fileage,file,finfo,reports |
| @@ -168,16 +168,16 @@ | ||
| 168 | 168 | The special "zip" keyword also matches "/tarball/" and "/sqlar/". |
| 169 | 169 | |
| 170 | 170 | * <b>zipX →</b> |
| 171 | 171 | This is like "zip" in that it restricts access to "/zip/", "/tarball"/ |
| 172 | 172 | and "/sqlar/" but with exceptions:<ol type="a"> |
| 173 | - <li><p> If the [/help?cmd=robot-zip-leaf|robot-zip-leaf] setting is | |
| 173 | + <li><p> If the [/help/robot-zip-leaf|robot-zip-leaf] setting is | |
| 174 | 174 | true, then tarballs of leaf check-ins are allowed. This permits |
| 175 | 175 | URLs that attempt to download the latest check-in on trunk or |
| 176 | 176 | from a named branch, for example. |
| 177 | 177 | <li><p> If a check-in has a tag that matches the GLOB list in |
| 178 | - [/help?cmd=robot-zip-tag|robot-zip-tag], then tarballs of that | |
| 178 | + [/help/robot-zip-tag|robot-zip-tag], then tarballs of that | |
| 179 | 179 | check-in are allowed. This allow check-ins tagged with |
| 180 | 180 | "release" or "allow-robots" (for example) to be downloaded |
| 181 | 181 | without restriction. |
| 182 | 182 | </ol> |
| 183 | 183 | The "zipX" restriction is not in the default robot-restrict setting. |
| @@ -191,26 +191,26 @@ | ||
| 191 | 191 | * <b>annotate →</b> |
| 192 | 192 | This also matches /blame/ and /praise/. |
| 193 | 193 | |
| 194 | 194 | Other special keywords may be added in the future. |
| 195 | 195 | |
| 196 | -The default [/help?cmd=robot-restrict|robot-restrict] | |
| 196 | +The default [/help/robot-restrict|robot-restrict] | |
| 197 | 197 | setting has been shown in practice to do a good job of keeping |
| 198 | 198 | robots from consuming all available CPU and bandwidth while will |
| 199 | 199 | still allowing humans access to the full power of the site without |
| 200 | 200 | having to be logged in. |
| 201 | 201 | |
| 202 | 202 | One possible enhancement is to add "zipX" to the |
| 203 | -[/help?cmd=robot-restrict|robot-restrict] setting, | |
| 203 | +[/help/robot-restrict|robot-restrict] setting, | |
| 204 | 204 | and enable [help?cmd=robot-zip-leaf|robot-zip-leaf] |
| 205 | 205 | and configure [help?cmd=robot-zip-tag|robot-zip-tag]. |
| 206 | 206 | Do this if you find that robots downloading lots of |
| 207 | 207 | obscure tarballs is causing load issues on your site. |
| 208 | 208 | |
| 209 | 209 | <h2>Anti-robot Exception RegExps</h2> |
| 210 | 210 | |
| 211 | -The [/help?cmd=robot-exception|robot-exception setting] under the name | |
| 211 | +The [/help/robot-exception|robot-exception setting] under the name | |
| 212 | 212 | of <b>Exceptions to anti-robot restrictions</b> is a list of |
| 213 | 213 | [/re_rules|regular expressions], one per line, that match |
| 214 | 214 | URIs that will bypass the captcha and allow robots full access. The |
| 215 | 215 | intent of this setting is to allow automated build scripts |
| 216 | 216 | to download specific tarballs of project snapshots. |
| 217 | 217 |
| --- www/antibot.wiki | |
| +++ www/antibot.wiki | |
| @@ -85,11 +85,11 @@ | |
| 85 | to "play nicely" on the internet and are quite open |
| 86 | about the fact that they are a robot. And so the UserAgent string |
| 87 | provides a good first-guess about whether or not a request originates |
| 88 | from a human or a robot. |
| 89 | |
| 90 | The [/help?cmd=auto-hyperlink|auto-hyperlink] setting, shown as |
| 91 | "<b>Enable hyperlinks based on User-Agent and/or Javascript</b>" on |
| 92 | the Robot Defense Settings page, |
| 93 | can be set to "UserAgent only" or "UserAgent and Javascript" or "off". |
| 94 | If the UserAgent string looks like a human and not a robot, then |
| 95 | Fossil will enable hyperlinks even if the <b>Hyperlink</b> capability |
| @@ -110,11 +110,11 @@ | |
| 110 | UserAgent string. Most robots do not bother to run JavaScript and |
| 111 | so to the robot the empty anchor tag will be useless. But all modern |
| 112 | web browsers implement JavaScript, so hyperlinks will show up |
| 113 | normally for human users. |
| 114 | |
| 115 | If the [/help?cmd=auto-hyperlink|"auto-hyperlink"] setting is (2) |
| 116 | "<b>Enable hyperlinks using User-Agent and/or Javascript</b>", |
| 117 | then there are now two additional sub-settings that control when |
| 118 | hyperlinks are enabled. |
| 119 | |
| 120 | The first new sub-setting is a delay (in milliseconds) before setting |
| @@ -134,11 +134,11 @@ | |
| 134 | of how expensive pages can be disabled when the server is under heavy |
| 135 | load. |
| 136 | |
| 137 | <h2>Do Not Allow Robot Access To Certain Pages</h2> |
| 138 | |
| 139 | The [/help?cmd=robot-restrict|robot-restrict setting] is a comma-separated |
| 140 | list of GLOB patterns for pages for which robot access is prohibited. |
| 141 | The default value is: |
| 142 | |
| 143 | <blockquote><pre> |
| 144 | timelineX,diff,annotate,fileage,file,finfo,reports |
| @@ -168,16 +168,16 @@ | |
| 168 | The special "zip" keyword also matches "/tarball/" and "/sqlar/". |
| 169 | |
| 170 | * <b>zipX →</b> |
| 171 | This is like "zip" in that it restricts access to "/zip/", "/tarball"/ |
| 172 | and "/sqlar/" but with exceptions:<ol type="a"> |
| 173 | <li><p> If the [/help?cmd=robot-zip-leaf|robot-zip-leaf] setting is |
| 174 | true, then tarballs of leaf check-ins are allowed. This permits |
| 175 | URLs that attempt to download the latest check-in on trunk or |
| 176 | from a named branch, for example. |
| 177 | <li><p> If a check-in has a tag that matches the GLOB list in |
| 178 | [/help?cmd=robot-zip-tag|robot-zip-tag], then tarballs of that |
| 179 | check-in are allowed. This allow check-ins tagged with |
| 180 | "release" or "allow-robots" (for example) to be downloaded |
| 181 | without restriction. |
| 182 | </ol> |
| 183 | The "zipX" restriction is not in the default robot-restrict setting. |
| @@ -191,26 +191,26 @@ | |
| 191 | * <b>annotate →</b> |
| 192 | This also matches /blame/ and /praise/. |
| 193 | |
| 194 | Other special keywords may be added in the future. |
| 195 | |
| 196 | The default [/help?cmd=robot-restrict|robot-restrict] |
| 197 | setting has been shown in practice to do a good job of keeping |
| 198 | robots from consuming all available CPU and bandwidth while will |
| 199 | still allowing humans access to the full power of the site without |
| 200 | having to be logged in. |
| 201 | |
| 202 | One possible enhancement is to add "zipX" to the |
| 203 | [/help?cmd=robot-restrict|robot-restrict] setting, |
| 204 | and enable [help?cmd=robot-zip-leaf|robot-zip-leaf] |
| 205 | and configure [help?cmd=robot-zip-tag|robot-zip-tag]. |
| 206 | Do this if you find that robots downloading lots of |
| 207 | obscure tarballs is causing load issues on your site. |
| 208 | |
| 209 | <h2>Anti-robot Exception RegExps</h2> |
| 210 | |
| 211 | The [/help?cmd=robot-exception|robot-exception setting] under the name |
| 212 | of <b>Exceptions to anti-robot restrictions</b> is a list of |
| 213 | [/re_rules|regular expressions], one per line, that match |
| 214 | URIs that will bypass the captcha and allow robots full access. The |
| 215 | intent of this setting is to allow automated build scripts |
| 216 | to download specific tarballs of project snapshots. |
| 217 |
| --- www/antibot.wiki | |
| +++ www/antibot.wiki | |
| @@ -85,11 +85,11 @@ | |
| 85 | to "play nicely" on the internet and are quite open |
| 86 | about the fact that they are a robot. And so the UserAgent string |
| 87 | provides a good first-guess about whether or not a request originates |
| 88 | from a human or a robot. |
| 89 | |
| 90 | The [/help/auto-hyperlink|auto-hyperlink] setting, shown as |
| 91 | "<b>Enable hyperlinks based on User-Agent and/or Javascript</b>" on |
| 92 | the Robot Defense Settings page, |
| 93 | can be set to "UserAgent only" or "UserAgent and Javascript" or "off". |
| 94 | If the UserAgent string looks like a human and not a robot, then |
| 95 | Fossil will enable hyperlinks even if the <b>Hyperlink</b> capability |
| @@ -110,11 +110,11 @@ | |
| 110 | UserAgent string. Most robots do not bother to run JavaScript and |
| 111 | so to the robot the empty anchor tag will be useless. But all modern |
| 112 | web browsers implement JavaScript, so hyperlinks will show up |
| 113 | normally for human users. |
| 114 | |
| 115 | If the [/help/auto-hyperlink|"auto-hyperlink"] setting is (2) |
| 116 | "<b>Enable hyperlinks using User-Agent and/or Javascript</b>", |
| 117 | then there are now two additional sub-settings that control when |
| 118 | hyperlinks are enabled. |
| 119 | |
| 120 | The first new sub-setting is a delay (in milliseconds) before setting |
| @@ -134,11 +134,11 @@ | |
| 134 | of how expensive pages can be disabled when the server is under heavy |
| 135 | load. |
| 136 | |
| 137 | <h2>Do Not Allow Robot Access To Certain Pages</h2> |
| 138 | |
| 139 | The [/help/robot-restrict|robot-restrict setting] is a comma-separated |
| 140 | list of GLOB patterns for pages for which robot access is prohibited. |
| 141 | The default value is: |
| 142 | |
| 143 | <blockquote><pre> |
| 144 | timelineX,diff,annotate,fileage,file,finfo,reports |
| @@ -168,16 +168,16 @@ | |
| 168 | The special "zip" keyword also matches "/tarball/" and "/sqlar/". |
| 169 | |
| 170 | * <b>zipX →</b> |
| 171 | This is like "zip" in that it restricts access to "/zip/", "/tarball"/ |
| 172 | and "/sqlar/" but with exceptions:<ol type="a"> |
| 173 | <li><p> If the [/help/robot-zip-leaf|robot-zip-leaf] setting is |
| 174 | true, then tarballs of leaf check-ins are allowed. This permits |
| 175 | URLs that attempt to download the latest check-in on trunk or |
| 176 | from a named branch, for example. |
| 177 | <li><p> If a check-in has a tag that matches the GLOB list in |
| 178 | [/help/robot-zip-tag|robot-zip-tag], then tarballs of that |
| 179 | check-in are allowed. This allow check-ins tagged with |
| 180 | "release" or "allow-robots" (for example) to be downloaded |
| 181 | without restriction. |
| 182 | </ol> |
| 183 | The "zipX" restriction is not in the default robot-restrict setting. |
| @@ -191,26 +191,26 @@ | |
| 191 | * <b>annotate →</b> |
| 192 | This also matches /blame/ and /praise/. |
| 193 | |
| 194 | Other special keywords may be added in the future. |
| 195 | |
| 196 | The default [/help/robot-restrict|robot-restrict] |
| 197 | setting has been shown in practice to do a good job of keeping |
| 198 | robots from consuming all available CPU and bandwidth while will |
| 199 | still allowing humans access to the full power of the site without |
| 200 | having to be logged in. |
| 201 | |
| 202 | One possible enhancement is to add "zipX" to the |
| 203 | [/help/robot-restrict|robot-restrict] setting, |
| 204 | and enable [help?cmd=robot-zip-leaf|robot-zip-leaf] |
| 205 | and configure [help?cmd=robot-zip-tag|robot-zip-tag]. |
| 206 | Do this if you find that robots downloading lots of |
| 207 | obscure tarballs is causing load issues on your site. |
| 208 | |
| 209 | <h2>Anti-robot Exception RegExps</h2> |
| 210 | |
| 211 | The [/help/robot-exception|robot-exception setting] under the name |
| 212 | of <b>Exceptions to anti-robot restrictions</b> is a list of |
| 213 | [/re_rules|regular expressions], one per line, that match |
| 214 | URIs that will bypass the captcha and allow robots full access. The |
| 215 | intent of this setting is to allow automated build scripts |
| 216 | to download specific tarballs of project snapshots. |
| 217 |
+5
-5
| --- www/backoffice.md | ||
| +++ www/backoffice.md | ||
| @@ -34,15 +34,15 @@ | ||
| 34 | 34 | process is already assigned to do the work, then a new backoffice process |
| 35 | 35 | is started to do the work. |
| 36 | 36 | |
| 37 | 37 | This happens for every webpage, regardless of how that webpage is launched, |
| 38 | 38 | and regardless of the purpose of the webpage. This also happens on the |
| 39 | -server for "[fossil sync](/help?cmd=sync)" and | |
| 40 | -[fossil clone](/help?cmd=clone)" commands which are implemented as | |
| 39 | +server for "[fossil sync](/help/sync)" and | |
| 40 | +[fossil clone](/help/clone)" commands which are implemented as | |
| 41 | 41 | web requests - albeit requests that the human user never sees. |
| 42 | 42 | Web requests can arrive at the Fossil server via direct TCP/IP (for example |
| 43 | -when Fossil is started using commands like "[fossil server](/help?cmd=server)") | |
| 43 | +when Fossil is started using commands like "[fossil server](/help/server)") | |
| 44 | 44 | or via [CGI](./server/any/cgi.md) or |
| 45 | 45 | [SCGI](./server/any/scgi.md) or via SSH. |
| 46 | 46 | A backoffice process might be started regardless of the origin of the |
| 47 | 47 | request. |
| 48 | 48 | |
| @@ -100,11 +100,11 @@ | ||
| 100 | 100 | [Fossil Forum](https://fossil-scm.org/forum) so that we can perhaps |
| 101 | 101 | fix the problem.) For now, the backoffice must be run manually |
| 102 | 102 | on OpenBSD systems. |
| 103 | 103 | |
| 104 | 104 | To set up fully-manual backoffice, first disable the automatic backoffice |
| 105 | -using the "[backoffice-disable](/help?cmd=backoffice-disable)" setting. | |
| 105 | +using the "[backoffice-disable](/help/backoffice-disable)" setting. | |
| 106 | 106 | |
| 107 | 107 | fossil setting backoffice-disable on |
| 108 | 108 | |
| 109 | 109 | Then arrange to invoke the backoffice separately using a command |
| 110 | 110 | like this: |
| @@ -111,11 +111,11 @@ | ||
| 111 | 111 | |
| 112 | 112 | fossil backoffice --poll 30 _REPOSITORY-LIST_ |
| 113 | 113 | |
| 114 | 114 | Multiple repositories can be named. This one command will handle |
| 115 | 115 | launching the backoffice for all of them. There are additional useful |
| 116 | -command-line options. See the "[fossil backoffice](/help?cmd=backoffice)" | |
| 116 | +command-line options. See the "[fossil backoffice](/help/backoffice)" | |
| 117 | 117 | documentation for details. |
| 118 | 118 | |
| 119 | 119 | The backoffice processes run manually using the "fossil backoffice" |
| 120 | 120 | command do not normally use a lease. That means that if you run the |
| 121 | 121 | "fossil backoffice" command with --poll and you forget to disable |
| 122 | 122 |
| --- www/backoffice.md | |
| +++ www/backoffice.md | |
| @@ -34,15 +34,15 @@ | |
| 34 | process is already assigned to do the work, then a new backoffice process |
| 35 | is started to do the work. |
| 36 | |
| 37 | This happens for every webpage, regardless of how that webpage is launched, |
| 38 | and regardless of the purpose of the webpage. This also happens on the |
| 39 | server for "[fossil sync](/help?cmd=sync)" and |
| 40 | [fossil clone](/help?cmd=clone)" commands which are implemented as |
| 41 | web requests - albeit requests that the human user never sees. |
| 42 | Web requests can arrive at the Fossil server via direct TCP/IP (for example |
| 43 | when Fossil is started using commands like "[fossil server](/help?cmd=server)") |
| 44 | or via [CGI](./server/any/cgi.md) or |
| 45 | [SCGI](./server/any/scgi.md) or via SSH. |
| 46 | A backoffice process might be started regardless of the origin of the |
| 47 | request. |
| 48 | |
| @@ -100,11 +100,11 @@ | |
| 100 | [Fossil Forum](https://fossil-scm.org/forum) so that we can perhaps |
| 101 | fix the problem.) For now, the backoffice must be run manually |
| 102 | on OpenBSD systems. |
| 103 | |
| 104 | To set up fully-manual backoffice, first disable the automatic backoffice |
| 105 | using the "[backoffice-disable](/help?cmd=backoffice-disable)" setting. |
| 106 | |
| 107 | fossil setting backoffice-disable on |
| 108 | |
| 109 | Then arrange to invoke the backoffice separately using a command |
| 110 | like this: |
| @@ -111,11 +111,11 @@ | |
| 111 | |
| 112 | fossil backoffice --poll 30 _REPOSITORY-LIST_ |
| 113 | |
| 114 | Multiple repositories can be named. This one command will handle |
| 115 | launching the backoffice for all of them. There are additional useful |
| 116 | command-line options. See the "[fossil backoffice](/help?cmd=backoffice)" |
| 117 | documentation for details. |
| 118 | |
| 119 | The backoffice processes run manually using the "fossil backoffice" |
| 120 | command do not normally use a lease. That means that if you run the |
| 121 | "fossil backoffice" command with --poll and you forget to disable |
| 122 |
| --- www/backoffice.md | |
| +++ www/backoffice.md | |
| @@ -34,15 +34,15 @@ | |
| 34 | process is already assigned to do the work, then a new backoffice process |
| 35 | is started to do the work. |
| 36 | |
| 37 | This happens for every webpage, regardless of how that webpage is launched, |
| 38 | and regardless of the purpose of the webpage. This also happens on the |
| 39 | server for "[fossil sync](/help/sync)" and |
| 40 | [fossil clone](/help/clone)" commands which are implemented as |
| 41 | web requests - albeit requests that the human user never sees. |
| 42 | Web requests can arrive at the Fossil server via direct TCP/IP (for example |
| 43 | when Fossil is started using commands like "[fossil server](/help/server)") |
| 44 | or via [CGI](./server/any/cgi.md) or |
| 45 | [SCGI](./server/any/scgi.md) or via SSH. |
| 46 | A backoffice process might be started regardless of the origin of the |
| 47 | request. |
| 48 | |
| @@ -100,11 +100,11 @@ | |
| 100 | [Fossil Forum](https://fossil-scm.org/forum) so that we can perhaps |
| 101 | fix the problem.) For now, the backoffice must be run manually |
| 102 | on OpenBSD systems. |
| 103 | |
| 104 | To set up fully-manual backoffice, first disable the automatic backoffice |
| 105 | using the "[backoffice-disable](/help/backoffice-disable)" setting. |
| 106 | |
| 107 | fossil setting backoffice-disable on |
| 108 | |
| 109 | Then arrange to invoke the backoffice separately using a command |
| 110 | like this: |
| @@ -111,11 +111,11 @@ | |
| 111 | |
| 112 | fossil backoffice --poll 30 _REPOSITORY-LIST_ |
| 113 | |
| 114 | Multiple repositories can be named. This one command will handle |
| 115 | launching the backoffice for all of them. There are additional useful |
| 116 | command-line options. See the "[fossil backoffice](/help/backoffice)" |
| 117 | documentation for details. |
| 118 | |
| 119 | The backoffice processes run manually using the "fossil backoffice" |
| 120 | command do not normally use a lease. That means that if you run the |
| 121 | "fossil backoffice" command with --poll and you forget to disable |
| 122 |
+2
-2
| --- www/backup.md | ||
| +++ www/backup.md | ||
| @@ -68,11 +68,11 @@ | ||
| 68 | 68 | #### <a id="other-cfg"></a> Others |
| 69 | 69 | |
| 70 | 70 | A repo’s URL aliases, [interwiki configuration](./interwiki.md), and |
| 71 | 71 | [ticket customizations](./custom_tcket.wiki) also do not normally sync. |
| 72 | 72 | |
| 73 | -[cfg]: /help?cmd=configuration | |
| 73 | +[cfg]: /help/configuration | |
| 74 | 74 | |
| 75 | 75 | |
| 76 | 76 | |
| 77 | 77 | ## <a id="private"></a> Private Branches |
| 78 | 78 | |
| @@ -289,11 +289,11 @@ | ||
| 289 | 289 | find them in a newly-created repo DB. We get around this by passing |
| 290 | 290 | the `--no-repository` flag, which suppresses this behavior. Doing it |
| 291 | 291 | this way saves you from needing to go and build a matching version of |
| 292 | 292 | `sqlite3` just to restore the backup. |
| 293 | 293 | |
| 294 | -[bu]: /help?cmd=backup | |
| 294 | +[bu]: /help/backup | |
| 295 | 295 | [grcp]: https://www.grc.com/passwords.htm |
| 296 | 296 | [hb]: https://brew.sh |
| 297 | 297 | [hbul]: https://docs.brew.sh/FAQ#what-does-keg-only-mean |
| 298 | 298 | [lz4]: https://lz4.github.io/lz4/ |
| 299 | 299 | [pbr]: ./private.wiki |
| 300 | 300 |
| --- www/backup.md | |
| +++ www/backup.md | |
| @@ -68,11 +68,11 @@ | |
| 68 | #### <a id="other-cfg"></a> Others |
| 69 | |
| 70 | A repo’s URL aliases, [interwiki configuration](./interwiki.md), and |
| 71 | [ticket customizations](./custom_tcket.wiki) also do not normally sync. |
| 72 | |
| 73 | [cfg]: /help?cmd=configuration |
| 74 | |
| 75 | |
| 76 | |
| 77 | ## <a id="private"></a> Private Branches |
| 78 | |
| @@ -289,11 +289,11 @@ | |
| 289 | find them in a newly-created repo DB. We get around this by passing |
| 290 | the `--no-repository` flag, which suppresses this behavior. Doing it |
| 291 | this way saves you from needing to go and build a matching version of |
| 292 | `sqlite3` just to restore the backup. |
| 293 | |
| 294 | [bu]: /help?cmd=backup |
| 295 | [grcp]: https://www.grc.com/passwords.htm |
| 296 | [hb]: https://brew.sh |
| 297 | [hbul]: https://docs.brew.sh/FAQ#what-does-keg-only-mean |
| 298 | [lz4]: https://lz4.github.io/lz4/ |
| 299 | [pbr]: ./private.wiki |
| 300 |
| --- www/backup.md | |
| +++ www/backup.md | |
| @@ -68,11 +68,11 @@ | |
| 68 | #### <a id="other-cfg"></a> Others |
| 69 | |
| 70 | A repo’s URL aliases, [interwiki configuration](./interwiki.md), and |
| 71 | [ticket customizations](./custom_tcket.wiki) also do not normally sync. |
| 72 | |
| 73 | [cfg]: /help/configuration |
| 74 | |
| 75 | |
| 76 | |
| 77 | ## <a id="private"></a> Private Branches |
| 78 | |
| @@ -289,11 +289,11 @@ | |
| 289 | find them in a newly-created repo DB. We get around this by passing |
| 290 | the `--no-repository` flag, which suppresses this behavior. Doing it |
| 291 | this way saves you from needing to go and build a matching version of |
| 292 | `sqlite3` just to restore the backup. |
| 293 | |
| 294 | [bu]: /help/backup |
| 295 | [grcp]: https://www.grc.com/passwords.htm |
| 296 | [hb]: https://brew.sh |
| 297 | [hbul]: https://docs.brew.sh/FAQ#what-does-keg-only-mean |
| 298 | [lz4]: https://lz4.github.io/lz4/ |
| 299 | [pbr]: ./private.wiki |
| 300 |
+7
-7
| --- www/blame.wiki | ||
| +++ www/blame.wiki | ||
| @@ -1,15 +1,15 @@ | ||
| 1 | 1 | <title>The Annotate Algorithm</title> |
| 2 | 2 | |
| 3 | 3 | <h2>1.0 Introduction</h2> |
| 4 | 4 | |
| 5 | -The [/help?cmd=annotate|fossil annotate], | |
| 6 | -[/help?cmd=blame|fossil blame], and | |
| 7 | -[/help?cmd=praise|fossil praise] commands, and the | |
| 8 | -[/help?cmd=/annotate|/annotate], | |
| 9 | -[/help?cmd=/blame|/blame], and | |
| 10 | -[/help?cmd=/praise|/praise] web pages are all used to show the most | |
| 5 | +The [/help/annotate|fossil annotate], | |
| 6 | +[/help/blame|fossil blame], and | |
| 7 | +[/help/praise|fossil praise] commands, and the | |
| 8 | +[/help/www/annotate|/annotate], | |
| 9 | +[/help/www/blame|/blame], and | |
| 10 | +[/help/www/praise|/praise] web pages are all used to show the most | |
| 11 | 11 | recent check-in that modified each line of a particular file. |
| 12 | 12 | This article overviews the algorithm used to compute the annotation |
| 13 | 13 | for a file in Fossil. |
| 14 | 14 | |
| 15 | 15 | <h2>2.0 Algorithm</h2> |
| @@ -45,11 +45,11 @@ | ||
| 45 | 45 | |
| 46 | 46 | The time-consuming part of this algorithm is step 6b - computing the |
| 47 | 47 | diff from all historical versions of the file to the version of the file |
| 48 | 48 | under analysis. For a large file that has many historical changes, this |
| 49 | 49 | can take several seconds. For this reason, the default |
| 50 | -[/help?cmd=/annotate|/annotate] webpage only shows those lines that were | |
| 50 | +[/help/www/annotate|/annotate] webpage only shows those lines that were | |
| 51 | 51 | changed by the 20 most recent modifications to the file. This allows |
| 52 | 52 | the loop on step 6 to terminate after only 19 diffs instead of the hundreds |
| 53 | 53 | or thousands of diffs that might be required for a frequently modified file. |
| 54 | 54 | |
| 55 | 55 | As currently implemented (as of 2015-12-12) the annotate algorithm does not |
| 56 | 56 |
| --- www/blame.wiki | |
| +++ www/blame.wiki | |
| @@ -1,15 +1,15 @@ | |
| 1 | <title>The Annotate Algorithm</title> |
| 2 | |
| 3 | <h2>1.0 Introduction</h2> |
| 4 | |
| 5 | The [/help?cmd=annotate|fossil annotate], |
| 6 | [/help?cmd=blame|fossil blame], and |
| 7 | [/help?cmd=praise|fossil praise] commands, and the |
| 8 | [/help?cmd=/annotate|/annotate], |
| 9 | [/help?cmd=/blame|/blame], and |
| 10 | [/help?cmd=/praise|/praise] web pages are all used to show the most |
| 11 | recent check-in that modified each line of a particular file. |
| 12 | This article overviews the algorithm used to compute the annotation |
| 13 | for a file in Fossil. |
| 14 | |
| 15 | <h2>2.0 Algorithm</h2> |
| @@ -45,11 +45,11 @@ | |
| 45 | |
| 46 | The time-consuming part of this algorithm is step 6b - computing the |
| 47 | diff from all historical versions of the file to the version of the file |
| 48 | under analysis. For a large file that has many historical changes, this |
| 49 | can take several seconds. For this reason, the default |
| 50 | [/help?cmd=/annotate|/annotate] webpage only shows those lines that were |
| 51 | changed by the 20 most recent modifications to the file. This allows |
| 52 | the loop on step 6 to terminate after only 19 diffs instead of the hundreds |
| 53 | or thousands of diffs that might be required for a frequently modified file. |
| 54 | |
| 55 | As currently implemented (as of 2015-12-12) the annotate algorithm does not |
| 56 |
| --- www/blame.wiki | |
| +++ www/blame.wiki | |
| @@ -1,15 +1,15 @@ | |
| 1 | <title>The Annotate Algorithm</title> |
| 2 | |
| 3 | <h2>1.0 Introduction</h2> |
| 4 | |
| 5 | The [/help/annotate|fossil annotate], |
| 6 | [/help/blame|fossil blame], and |
| 7 | [/help/praise|fossil praise] commands, and the |
| 8 | [/help/www/annotate|/annotate], |
| 9 | [/help/www/blame|/blame], and |
| 10 | [/help/www/praise|/praise] web pages are all used to show the most |
| 11 | recent check-in that modified each line of a particular file. |
| 12 | This article overviews the algorithm used to compute the annotation |
| 13 | for a file in Fossil. |
| 14 | |
| 15 | <h2>2.0 Algorithm</h2> |
| @@ -45,11 +45,11 @@ | |
| 45 | |
| 46 | The time-consuming part of this algorithm is step 6b - computing the |
| 47 | diff from all historical versions of the file to the version of the file |
| 48 | under analysis. For a large file that has many historical changes, this |
| 49 | can take several seconds. For this reason, the default |
| 50 | [/help/www/annotate|/annotate] webpage only shows those lines that were |
| 51 | changed by the 20 most recent modifications to the file. This allows |
| 52 | the loop on step 6 to terminate after only 19 diffs instead of the hundreds |
| 53 | or thousands of diffs that might be required for a frequently modified file. |
| 54 | |
| 55 | As currently implemented (as of 2015-12-12) the annotate algorithm does not |
| 56 |
+6
-6
| --- www/blockchain.md | ||
| +++ www/blockchain.md | ||
| @@ -208,11 +208,11 @@ | ||
| 208 | 208 | this makes it “not a blockchain” is a subjective matter. |
| 209 | 209 | |
| 210 | 210 | [arh]: ./hooks.md |
| 211 | 211 | [bse]: https://www.researchgate.net/publication/311572122_What_is_Blockchain_a_Gentle_Introduction |
| 212 | 212 | [caps]: ./caps/ |
| 213 | -[cs]: /help?cmd=clearsign | |
| 213 | +[cs]: /help/clearsign | |
| 214 | 214 | [dboc]: https://en.wikipedia.org/wiki/Debasement |
| 215 | 215 | [dsig]: https://en.wikipedia.org/wiki/Digital_signature |
| 216 | 216 | [fb]: ./branching.wiki |
| 217 | 217 | [GPG]: https://gnupg.org/ |
| 218 | 218 | [PGP]: https://www.openpgp.org/ |
| @@ -278,11 +278,11 @@ | ||
| 278 | 278 | [ctcp]: ./cap-theorem.md#cp |
| 279 | 279 | [cap]: https://en.wikipedia.org/wiki/CAP_theorem |
| 280 | 280 | [dlt]: https://en.wikipedia.org/wiki/Distributed_ledger |
| 281 | 281 | [DVCS]: https://en.wikipedia.org/wiki/Distributed_version_control |
| 282 | 282 | [fc]: https://en.wikipedia.org/wiki/Fiat_money |
| 283 | -[purge]: /help?cmd=purge | |
| 283 | +[purge]: /help/purge | |
| 284 | 284 | [shun]: ./shunning.wiki |
| 285 | 285 | |
| 286 | 286 | |
| 287 | 287 | <a id="dpc"></a> |
| 288 | 288 | ## Distributed Partial Consensus |
| @@ -335,11 +335,11 @@ | ||
| 335 | 335 | sending each an HTTP GET `/info` query for the artifact ID, concluding |
| 336 | 336 | that the commit is legitimate once you get enough HTTP 200 status codes back. All of this is |
| 337 | 337 | hypothetical, because Fossil doesn’t do this today. |
| 338 | 338 | |
| 339 | 339 | [AGI]: https://en.wikipedia.org/wiki/Artificial_general_intelligence |
| 340 | -[rcks]: /help?cmd=repo-cksum | |
| 340 | +[rcks]: /help/repo-cksum | |
| 341 | 341 | |
| 342 | 342 | |
| 343 | 343 | |
| 344 | 344 | <a id="anon"></a> |
| 345 | 345 | ## Anonymity |
| @@ -447,14 +447,14 @@ | ||
| 447 | 447 | self-contained, and with a smaller attack surface. |
| 448 | 448 | |
| 449 | 449 | |
| 450 | 450 | [alert]: ./alerts.md |
| 451 | 451 | [capi]: ./caps/ref.html#i |
| 452 | -[mrep]: /help?cmd=remote | |
| 452 | +[mrep]: /help/remote | |
| 453 | 453 | [scost]: https://en.wikipedia.org/wiki/Software_development_effort_estimation |
| 454 | -[scrub]: /help?cmd=scrub | |
| 455 | -[sreg]: /help?cmd=self-register | |
| 454 | +[scrub]: /help/scrub | |
| 455 | +[sreg]: /help/self-register | |
| 456 | 456 | |
| 457 | 457 | |
| 458 | 458 | # Conclusion |
| 459 | 459 | |
| 460 | 460 | This author believes it is technologically indefensible to call Fossil a |
| 461 | 461 |
| --- www/blockchain.md | |
| +++ www/blockchain.md | |
| @@ -208,11 +208,11 @@ | |
| 208 | this makes it “not a blockchain” is a subjective matter. |
| 209 | |
| 210 | [arh]: ./hooks.md |
| 211 | [bse]: https://www.researchgate.net/publication/311572122_What_is_Blockchain_a_Gentle_Introduction |
| 212 | [caps]: ./caps/ |
| 213 | [cs]: /help?cmd=clearsign |
| 214 | [dboc]: https://en.wikipedia.org/wiki/Debasement |
| 215 | [dsig]: https://en.wikipedia.org/wiki/Digital_signature |
| 216 | [fb]: ./branching.wiki |
| 217 | [GPG]: https://gnupg.org/ |
| 218 | [PGP]: https://www.openpgp.org/ |
| @@ -278,11 +278,11 @@ | |
| 278 | [ctcp]: ./cap-theorem.md#cp |
| 279 | [cap]: https://en.wikipedia.org/wiki/CAP_theorem |
| 280 | [dlt]: https://en.wikipedia.org/wiki/Distributed_ledger |
| 281 | [DVCS]: https://en.wikipedia.org/wiki/Distributed_version_control |
| 282 | [fc]: https://en.wikipedia.org/wiki/Fiat_money |
| 283 | [purge]: /help?cmd=purge |
| 284 | [shun]: ./shunning.wiki |
| 285 | |
| 286 | |
| 287 | <a id="dpc"></a> |
| 288 | ## Distributed Partial Consensus |
| @@ -335,11 +335,11 @@ | |
| 335 | sending each an HTTP GET `/info` query for the artifact ID, concluding |
| 336 | that the commit is legitimate once you get enough HTTP 200 status codes back. All of this is |
| 337 | hypothetical, because Fossil doesn’t do this today. |
| 338 | |
| 339 | [AGI]: https://en.wikipedia.org/wiki/Artificial_general_intelligence |
| 340 | [rcks]: /help?cmd=repo-cksum |
| 341 | |
| 342 | |
| 343 | |
| 344 | <a id="anon"></a> |
| 345 | ## Anonymity |
| @@ -447,14 +447,14 @@ | |
| 447 | self-contained, and with a smaller attack surface. |
| 448 | |
| 449 | |
| 450 | [alert]: ./alerts.md |
| 451 | [capi]: ./caps/ref.html#i |
| 452 | [mrep]: /help?cmd=remote |
| 453 | [scost]: https://en.wikipedia.org/wiki/Software_development_effort_estimation |
| 454 | [scrub]: /help?cmd=scrub |
| 455 | [sreg]: /help?cmd=self-register |
| 456 | |
| 457 | |
| 458 | # Conclusion |
| 459 | |
| 460 | This author believes it is technologically indefensible to call Fossil a |
| 461 |
| --- www/blockchain.md | |
| +++ www/blockchain.md | |
| @@ -208,11 +208,11 @@ | |
| 208 | this makes it “not a blockchain” is a subjective matter. |
| 209 | |
| 210 | [arh]: ./hooks.md |
| 211 | [bse]: https://www.researchgate.net/publication/311572122_What_is_Blockchain_a_Gentle_Introduction |
| 212 | [caps]: ./caps/ |
| 213 | [cs]: /help/clearsign |
| 214 | [dboc]: https://en.wikipedia.org/wiki/Debasement |
| 215 | [dsig]: https://en.wikipedia.org/wiki/Digital_signature |
| 216 | [fb]: ./branching.wiki |
| 217 | [GPG]: https://gnupg.org/ |
| 218 | [PGP]: https://www.openpgp.org/ |
| @@ -278,11 +278,11 @@ | |
| 278 | [ctcp]: ./cap-theorem.md#cp |
| 279 | [cap]: https://en.wikipedia.org/wiki/CAP_theorem |
| 280 | [dlt]: https://en.wikipedia.org/wiki/Distributed_ledger |
| 281 | [DVCS]: https://en.wikipedia.org/wiki/Distributed_version_control |
| 282 | [fc]: https://en.wikipedia.org/wiki/Fiat_money |
| 283 | [purge]: /help/purge |
| 284 | [shun]: ./shunning.wiki |
| 285 | |
| 286 | |
| 287 | <a id="dpc"></a> |
| 288 | ## Distributed Partial Consensus |
| @@ -335,11 +335,11 @@ | |
| 335 | sending each an HTTP GET `/info` query for the artifact ID, concluding |
| 336 | that the commit is legitimate once you get enough HTTP 200 status codes back. All of this is |
| 337 | hypothetical, because Fossil doesn’t do this today. |
| 338 | |
| 339 | [AGI]: https://en.wikipedia.org/wiki/Artificial_general_intelligence |
| 340 | [rcks]: /help/repo-cksum |
| 341 | |
| 342 | |
| 343 | |
| 344 | <a id="anon"></a> |
| 345 | ## Anonymity |
| @@ -447,14 +447,14 @@ | |
| 447 | self-contained, and with a smaller attack surface. |
| 448 | |
| 449 | |
| 450 | [alert]: ./alerts.md |
| 451 | [capi]: ./caps/ref.html#i |
| 452 | [mrep]: /help/remote |
| 453 | [scost]: https://en.wikipedia.org/wiki/Software_development_effort_estimation |
| 454 | [scrub]: /help/scrub |
| 455 | [sreg]: /help/self-register |
| 456 | |
| 457 | |
| 458 | # Conclusion |
| 459 | |
| 460 | This author believes it is technologically indefensible to call Fossil a |
| 461 |
+5
-5
| --- www/branching.wiki | ||
| +++ www/branching.wiki | ||
| @@ -75,11 +75,11 @@ | ||
| 75 | 75 | But perhaps Bob is off-network when he does his commit, so he has no way |
| 76 | 76 | of knowing that Alice has already committed her changes. Or, it could |
| 77 | 77 | be that Bob has turned off "autosync" mode in Fossil. Or, maybe Bob |
| 78 | 78 | just doesn't want to merge in Alice's changes before he has saved his |
| 79 | 79 | own, so he forces the commit to occur using the "--allow-fork" option to |
| 80 | -the <b>[/help?cmd=commit | fossil commit]</b> command. For any of these | |
| 80 | +the <b>[/help/commit | fossil commit]</b> command. For any of these | |
| 81 | 81 | reasons, two commits against check-in 2 have occurred, so the DAG now |
| 82 | 82 | has two leaves. |
| 83 | 83 | |
| 84 | 84 | In such a condition, a person working with this repository has a |
| 85 | 85 | dilemma: which version of the project is the "latest" in the sense of |
| @@ -111,11 +111,11 @@ | ||
| 111 | 111 | easier to justify, since presumably the lone developer is never confused |
| 112 | 112 | about why there are two or more leaves on that branch. Further |
| 113 | 113 | justifications for intentional forking are [#forking | given below]. |
| 114 | 114 | |
| 115 | 115 | Let us return to Figure 2. To resolve such situations before they can |
| 116 | -become a real problem, Alice can use the <b>[/help?cmd=merge | fossil | |
| 116 | +become a real problem, Alice can use the <b>[/help/merge | fossil | |
| 117 | 117 | merge]</b> command to merge Bob's changes into her local copy of |
| 118 | 118 | check-in 3. Without arguments, that command merges all leaves on the |
| 119 | 119 | current branch. Alice can then verify that the merge is sensible and if |
| 120 | 120 | so, commit the results as check-in 5. This results in a DAG as shown in |
| 121 | 121 | Figure 3. |
| @@ -349,11 +349,11 @@ | ||
| 349 | 349 | refusing the check-in simply because it would create a fork. |
| 350 | 350 | <br><br> |
| 351 | 351 | If you are writing such a tool — e.g. a shell script to make |
| 352 | 352 | multiple manipulations on a Fossil repo — it's better to make it |
| 353 | 353 | smart enough to detect this condition and cope with it, such as |
| 354 | - by making a call to <b>[/help?cmd=update | fossil update]</b> | |
| 354 | + by making a call to <b>[/help/update | fossil update]</b> | |
| 355 | 355 | and checking for a merge conflict. That said, if the alternative is |
| 356 | 356 | losing information, you may feel justified in creating forks that an |
| 357 | 357 | interactive user must later manually clean up with <b>fossil merge</b> |
| 358 | 358 | commands.</p></li> |
| 359 | 359 | </ol> |
| @@ -600,11 +600,11 @@ | ||
| 600 | 600 | to that branch with a <b>fossil update $BRANCH</b> command. (There is an |
| 601 | 601 | implicit autosync in that command, if the option was enabled at the |
| 602 | 602 | time of the update.)</p></li> |
| 603 | 603 | |
| 604 | 604 | <li><p>The same thing, only in a fresh checkout directory with a |
| 605 | - <b>[/help?cmd=open | fossil open $REPO $BRANCH]</b> command.</p></li> | |
| 605 | + <b>[/help/open | fossil open $REPO $BRANCH]</b> command.</p></li> | |
| 606 | 606 | |
| 607 | 607 | <li><p>Alan makes his check-in 3 while Betty has check-in 1 or 2 as |
| 608 | 608 | the tip in her local clone, but because she's working with an |
| 609 | 609 | autosync'd connection to the same upstream repository as Alan, on |
| 610 | 610 | attempting what will become check-in 4, she gets the "would fork" |
| @@ -751,11 +751,11 @@ | ||
| 751 | 751 | is especially useful with utility branches. There are several of these |
| 752 | 752 | in the SQLite and Fossil repositories: "broken-build," "declined," |
| 753 | 753 | "mistake," etc. As you might guess from these names, such branch names |
| 754 | 754 | are used in renaming the tip of one branch to shunt it off away from the |
| 755 | 755 | mainline of that branch due to some human error. (See |
| 756 | -<b>[/help?cmd=amend | fossil | |
| 756 | +<b>[/help/amend | fossil | |
| 757 | 757 | amend]</b> and the Fossil UI check-in amendment features.) This is a |
| 758 | 758 | workaround for Fossil's [./shunning.wiki|normal inability to forget |
| 759 | 759 | history]: we usually don't want to actually <i>remove</i> history, but |
| 760 | 760 | would like to sometimes set some of it aside under a new label. |
| 761 | 761 | |
| 762 | 762 |
| --- www/branching.wiki | |
| +++ www/branching.wiki | |
| @@ -75,11 +75,11 @@ | |
| 75 | But perhaps Bob is off-network when he does his commit, so he has no way |
| 76 | of knowing that Alice has already committed her changes. Or, it could |
| 77 | be that Bob has turned off "autosync" mode in Fossil. Or, maybe Bob |
| 78 | just doesn't want to merge in Alice's changes before he has saved his |
| 79 | own, so he forces the commit to occur using the "--allow-fork" option to |
| 80 | the <b>[/help?cmd=commit | fossil commit]</b> command. For any of these |
| 81 | reasons, two commits against check-in 2 have occurred, so the DAG now |
| 82 | has two leaves. |
| 83 | |
| 84 | In such a condition, a person working with this repository has a |
| 85 | dilemma: which version of the project is the "latest" in the sense of |
| @@ -111,11 +111,11 @@ | |
| 111 | easier to justify, since presumably the lone developer is never confused |
| 112 | about why there are two or more leaves on that branch. Further |
| 113 | justifications for intentional forking are [#forking | given below]. |
| 114 | |
| 115 | Let us return to Figure 2. To resolve such situations before they can |
| 116 | become a real problem, Alice can use the <b>[/help?cmd=merge | fossil |
| 117 | merge]</b> command to merge Bob's changes into her local copy of |
| 118 | check-in 3. Without arguments, that command merges all leaves on the |
| 119 | current branch. Alice can then verify that the merge is sensible and if |
| 120 | so, commit the results as check-in 5. This results in a DAG as shown in |
| 121 | Figure 3. |
| @@ -349,11 +349,11 @@ | |
| 349 | refusing the check-in simply because it would create a fork. |
| 350 | <br><br> |
| 351 | If you are writing such a tool — e.g. a shell script to make |
| 352 | multiple manipulations on a Fossil repo — it's better to make it |
| 353 | smart enough to detect this condition and cope with it, such as |
| 354 | by making a call to <b>[/help?cmd=update | fossil update]</b> |
| 355 | and checking for a merge conflict. That said, if the alternative is |
| 356 | losing information, you may feel justified in creating forks that an |
| 357 | interactive user must later manually clean up with <b>fossil merge</b> |
| 358 | commands.</p></li> |
| 359 | </ol> |
| @@ -600,11 +600,11 @@ | |
| 600 | to that branch with a <b>fossil update $BRANCH</b> command. (There is an |
| 601 | implicit autosync in that command, if the option was enabled at the |
| 602 | time of the update.)</p></li> |
| 603 | |
| 604 | <li><p>The same thing, only in a fresh checkout directory with a |
| 605 | <b>[/help?cmd=open | fossil open $REPO $BRANCH]</b> command.</p></li> |
| 606 | |
| 607 | <li><p>Alan makes his check-in 3 while Betty has check-in 1 or 2 as |
| 608 | the tip in her local clone, but because she's working with an |
| 609 | autosync'd connection to the same upstream repository as Alan, on |
| 610 | attempting what will become check-in 4, she gets the "would fork" |
| @@ -751,11 +751,11 @@ | |
| 751 | is especially useful with utility branches. There are several of these |
| 752 | in the SQLite and Fossil repositories: "broken-build," "declined," |
| 753 | "mistake," etc. As you might guess from these names, such branch names |
| 754 | are used in renaming the tip of one branch to shunt it off away from the |
| 755 | mainline of that branch due to some human error. (See |
| 756 | <b>[/help?cmd=amend | fossil |
| 757 | amend]</b> and the Fossil UI check-in amendment features.) This is a |
| 758 | workaround for Fossil's [./shunning.wiki|normal inability to forget |
| 759 | history]: we usually don't want to actually <i>remove</i> history, but |
| 760 | would like to sometimes set some of it aside under a new label. |
| 761 | |
| 762 |
| --- www/branching.wiki | |
| +++ www/branching.wiki | |
| @@ -75,11 +75,11 @@ | |
| 75 | But perhaps Bob is off-network when he does his commit, so he has no way |
| 76 | of knowing that Alice has already committed her changes. Or, it could |
| 77 | be that Bob has turned off "autosync" mode in Fossil. Or, maybe Bob |
| 78 | just doesn't want to merge in Alice's changes before he has saved his |
| 79 | own, so he forces the commit to occur using the "--allow-fork" option to |
| 80 | the <b>[/help/commit | fossil commit]</b> command. For any of these |
| 81 | reasons, two commits against check-in 2 have occurred, so the DAG now |
| 82 | has two leaves. |
| 83 | |
| 84 | In such a condition, a person working with this repository has a |
| 85 | dilemma: which version of the project is the "latest" in the sense of |
| @@ -111,11 +111,11 @@ | |
| 111 | easier to justify, since presumably the lone developer is never confused |
| 112 | about why there are two or more leaves on that branch. Further |
| 113 | justifications for intentional forking are [#forking | given below]. |
| 114 | |
| 115 | Let us return to Figure 2. To resolve such situations before they can |
| 116 | become a real problem, Alice can use the <b>[/help/merge | fossil |
| 117 | merge]</b> command to merge Bob's changes into her local copy of |
| 118 | check-in 3. Without arguments, that command merges all leaves on the |
| 119 | current branch. Alice can then verify that the merge is sensible and if |
| 120 | so, commit the results as check-in 5. This results in a DAG as shown in |
| 121 | Figure 3. |
| @@ -349,11 +349,11 @@ | |
| 349 | refusing the check-in simply because it would create a fork. |
| 350 | <br><br> |
| 351 | If you are writing such a tool — e.g. a shell script to make |
| 352 | multiple manipulations on a Fossil repo — it's better to make it |
| 353 | smart enough to detect this condition and cope with it, such as |
| 354 | by making a call to <b>[/help/update | fossil update]</b> |
| 355 | and checking for a merge conflict. That said, if the alternative is |
| 356 | losing information, you may feel justified in creating forks that an |
| 357 | interactive user must later manually clean up with <b>fossil merge</b> |
| 358 | commands.</p></li> |
| 359 | </ol> |
| @@ -600,11 +600,11 @@ | |
| 600 | to that branch with a <b>fossil update $BRANCH</b> command. (There is an |
| 601 | implicit autosync in that command, if the option was enabled at the |
| 602 | time of the update.)</p></li> |
| 603 | |
| 604 | <li><p>The same thing, only in a fresh checkout directory with a |
| 605 | <b>[/help/open | fossil open $REPO $BRANCH]</b> command.</p></li> |
| 606 | |
| 607 | <li><p>Alan makes his check-in 3 while Betty has check-in 1 or 2 as |
| 608 | the tip in her local clone, but because she's working with an |
| 609 | autosync'd connection to the same upstream repository as Alan, on |
| 610 | attempting what will become check-in 4, she gets the "would fork" |
| @@ -751,11 +751,11 @@ | |
| 751 | is especially useful with utility branches. There are several of these |
| 752 | in the SQLite and Fossil repositories: "broken-build," "declined," |
| 753 | "mistake," etc. As you might guess from these names, such branch names |
| 754 | are used in renaming the tip of one branch to shunt it off away from the |
| 755 | mainline of that branch due to some human error. (See |
| 756 | <b>[/help/amend | fossil |
| 757 | amend]</b> and the Fossil UI check-in amendment features.) This is a |
| 758 | workaround for Fossil's [./shunning.wiki|normal inability to forget |
| 759 | history]: we usually don't want to actually <i>remove</i> history, but |
| 760 | would like to sometimes set some of it aside under a new label. |
| 761 | |
| 762 |
+2
-2
| --- www/build.wiki | ||
| +++ www/build.wiki | ||
| @@ -335,11 +335,11 @@ | ||
| 335 | 335 | change at any time. It is only known to work on Linux systems and has |
| 336 | 336 | been seen to work on x86/64 and ARM. |
| 337 | 337 | |
| 338 | 338 | Fossil has builtin support for processing specific features using |
| 339 | 339 | <tt>libfuzzer</tt>. The features which can be tested this way are |
| 340 | -found in the help text for the [/help?cmd=test-fuzz|test-fuzz | |
| 340 | +found in the help text for the [/help/test-fuzz|test-fuzz | |
| 341 | 341 | command]. |
| 342 | 342 | |
| 343 | 343 | Fuzzing requires: |
| 344 | 344 | |
| 345 | 345 | * The clang C compiler. |
| @@ -510,11 +510,11 @@ | ||
| 510 | 510 | "should" (as of this writing) suffice. Any older version may or may not |
| 511 | 511 | work.</div> |
| 512 | 512 | |
| 513 | 513 | After that succeeds, we need to run the normal build so that those |
| 514 | 514 | generated files can be compiled in to the fossil binary, accessible |
| 515 | -via the [/help?cmd=/builtin|/builtin page]: | |
| 515 | +via the [/help/www/builtin|/builtin page]: | |
| 516 | 516 | |
| 517 | 517 | <pre><code>$ make</code></pre> |
| 518 | 518 | |
| 519 | 519 | Before checking in those newly-built files, they need to be tested by |
| 520 | 520 | running the [/pikchrshow] page. If that page loads, the compilation |
| 521 | 521 |
| --- www/build.wiki | |
| +++ www/build.wiki | |
| @@ -335,11 +335,11 @@ | |
| 335 | change at any time. It is only known to work on Linux systems and has |
| 336 | been seen to work on x86/64 and ARM. |
| 337 | |
| 338 | Fossil has builtin support for processing specific features using |
| 339 | <tt>libfuzzer</tt>. The features which can be tested this way are |
| 340 | found in the help text for the [/help?cmd=test-fuzz|test-fuzz |
| 341 | command]. |
| 342 | |
| 343 | Fuzzing requires: |
| 344 | |
| 345 | * The clang C compiler. |
| @@ -510,11 +510,11 @@ | |
| 510 | "should" (as of this writing) suffice. Any older version may or may not |
| 511 | work.</div> |
| 512 | |
| 513 | After that succeeds, we need to run the normal build so that those |
| 514 | generated files can be compiled in to the fossil binary, accessible |
| 515 | via the [/help?cmd=/builtin|/builtin page]: |
| 516 | |
| 517 | <pre><code>$ make</code></pre> |
| 518 | |
| 519 | Before checking in those newly-built files, they need to be tested by |
| 520 | running the [/pikchrshow] page. If that page loads, the compilation |
| 521 |
| --- www/build.wiki | |
| +++ www/build.wiki | |
| @@ -335,11 +335,11 @@ | |
| 335 | change at any time. It is only known to work on Linux systems and has |
| 336 | been seen to work on x86/64 and ARM. |
| 337 | |
| 338 | Fossil has builtin support for processing specific features using |
| 339 | <tt>libfuzzer</tt>. The features which can be tested this way are |
| 340 | found in the help text for the [/help/test-fuzz|test-fuzz |
| 341 | command]. |
| 342 | |
| 343 | Fuzzing requires: |
| 344 | |
| 345 | * The clang C compiler. |
| @@ -510,11 +510,11 @@ | |
| 510 | "should" (as of this writing) suffice. Any older version may or may not |
| 511 | work.</div> |
| 512 | |
| 513 | After that succeeds, we need to run the normal build so that those |
| 514 | generated files can be compiled in to the fossil binary, accessible |
| 515 | via the [/help/www/builtin|/builtin page]: |
| 516 | |
| 517 | <pre><code>$ make</code></pre> |
| 518 | |
| 519 | Before checking in those newly-built files, they need to be tested by |
| 520 | running the [/pikchrshow] page. If that page loads, the compilation |
| 521 |
+6
-6
| --- www/caps/admin-v-setup.md | ||
| +++ www/caps/admin-v-setup.md | ||
| @@ -261,13 +261,13 @@ | ||
| 261 | 261 | |
| 262 | 262 | Setup users can do many things that Admin users cannot. They may not |
| 263 | 263 | only use all of the Admin UI features, they may also: |
| 264 | 264 | |
| 265 | 265 | * See record IDs (RIDs) on screens that show them |
| 266 | -* See the MIME type of attachments on [`/ainfo` pages](/help?cmd=/ainfo) | |
| 267 | -* See a remote repo’s HTTP [cache status](/help?cmd=/cachestat) | |
| 268 | - and [pull cache entries](/help?cmd=/cacheget) | |
| 266 | +* See the MIME type of attachments on [`/ainfo` pages](/help/www/ainfo) | |
| 267 | +* See a remote repo’s HTTP [cache status](/help/www/cachestat) | |
| 268 | + and [pull cache entries](/help/www/cacheget) | |
| 269 | 269 | * Edit a Setup user’s account! |
| 270 | 270 | |
| 271 | 271 | The “Admin” feature of Fossil UI is so-named because Admin users can use |
| 272 | 272 | about half of its functions, but only Setup can use these pages: |
| 273 | 273 | |
| @@ -395,11 +395,11 @@ | ||
| 395 | 395 | |
| 396 | 396 | |
| 397 | 397 | ### <a id="y"></a>Write Unversioned |
| 398 | 398 | |
| 399 | 399 | Fossil currently doesn’t distinguish the sub-operations of |
| 400 | -[`fossil uv`](/help?cmd=uv); they’re all covered by [**WrUnver**][capy] | |
| 400 | +[`fossil uv`](/help/uv); they’re all covered by [**WrUnver**][capy] | |
| 401 | 401 | (“y”) capability. Since some of these operations are unconditionally |
| 402 | 402 | destructive due to the nature of unversioned content, and since this |
| 403 | 403 | goes against Fossil’s philosophy of immutable history, nobody gets cap |
| 404 | 404 | “y” on a Fossil repo by default, not even the Setup or Admin users. A |
| 405 | 405 | Setup or Admin user must grant cap “y” to someone — not necessarily |
| @@ -446,16 +446,16 @@ | ||
| 446 | 446 | [capa]: ./ref.html#a |
| 447 | 447 | [caps]: ./ref.html#s |
| 448 | 448 | [capx]: ./ref.html#x |
| 449 | 449 | [capy]: ./ref.html#y |
| 450 | 450 | |
| 451 | -[fcp]: https://fossil-scm.org/home/help?cmd=configuration | |
| 451 | +[fcp]: https://fossil-scm.org/home/help/configuration | |
| 452 | 452 | [fdp]: ../fossil-v-git.wiki#devorg |
| 453 | 453 | [forum]: https://fossil-scm.org/forum/ |
| 454 | -[fui]: /help?cmd=ui | |
| 454 | +[fui]: /help/ui | |
| 455 | 455 | [lg]: ./login-groups.md |
| 456 | 456 | [rs]: https://fossil-scm.org/home/doc/trunk/www/settings.wiki |
| 457 | 457 | [sia]: https://fossil-scm.org/home/artifact?ln=1259-1260&name=0fda31b6683c206a |
| 458 | 458 | [snoy]: https://fossil-scm.org/forum/forumpost/00e1c4ecff |
| 459 | 459 | [th1]: ../th1.md |
| 460 | 460 | [tt]: https://en.wikipedia.org/wiki/Tiger_team#Security |
| 461 | 461 | [webo]: ./#webonly |
| 462 | 462 |
| --- www/caps/admin-v-setup.md | |
| +++ www/caps/admin-v-setup.md | |
| @@ -261,13 +261,13 @@ | |
| 261 | |
| 262 | Setup users can do many things that Admin users cannot. They may not |
| 263 | only use all of the Admin UI features, they may also: |
| 264 | |
| 265 | * See record IDs (RIDs) on screens that show them |
| 266 | * See the MIME type of attachments on [`/ainfo` pages](/help?cmd=/ainfo) |
| 267 | * See a remote repo’s HTTP [cache status](/help?cmd=/cachestat) |
| 268 | and [pull cache entries](/help?cmd=/cacheget) |
| 269 | * Edit a Setup user’s account! |
| 270 | |
| 271 | The “Admin” feature of Fossil UI is so-named because Admin users can use |
| 272 | about half of its functions, but only Setup can use these pages: |
| 273 | |
| @@ -395,11 +395,11 @@ | |
| 395 | |
| 396 | |
| 397 | ### <a id="y"></a>Write Unversioned |
| 398 | |
| 399 | Fossil currently doesn’t distinguish the sub-operations of |
| 400 | [`fossil uv`](/help?cmd=uv); they’re all covered by [**WrUnver**][capy] |
| 401 | (“y”) capability. Since some of these operations are unconditionally |
| 402 | destructive due to the nature of unversioned content, and since this |
| 403 | goes against Fossil’s philosophy of immutable history, nobody gets cap |
| 404 | “y” on a Fossil repo by default, not even the Setup or Admin users. A |
| 405 | Setup or Admin user must grant cap “y” to someone — not necessarily |
| @@ -446,16 +446,16 @@ | |
| 446 | [capa]: ./ref.html#a |
| 447 | [caps]: ./ref.html#s |
| 448 | [capx]: ./ref.html#x |
| 449 | [capy]: ./ref.html#y |
| 450 | |
| 451 | [fcp]: https://fossil-scm.org/home/help?cmd=configuration |
| 452 | [fdp]: ../fossil-v-git.wiki#devorg |
| 453 | [forum]: https://fossil-scm.org/forum/ |
| 454 | [fui]: /help?cmd=ui |
| 455 | [lg]: ./login-groups.md |
| 456 | [rs]: https://fossil-scm.org/home/doc/trunk/www/settings.wiki |
| 457 | [sia]: https://fossil-scm.org/home/artifact?ln=1259-1260&name=0fda31b6683c206a |
| 458 | [snoy]: https://fossil-scm.org/forum/forumpost/00e1c4ecff |
| 459 | [th1]: ../th1.md |
| 460 | [tt]: https://en.wikipedia.org/wiki/Tiger_team#Security |
| 461 | [webo]: ./#webonly |
| 462 |
| --- www/caps/admin-v-setup.md | |
| +++ www/caps/admin-v-setup.md | |
| @@ -261,13 +261,13 @@ | |
| 261 | |
| 262 | Setup users can do many things that Admin users cannot. They may not |
| 263 | only use all of the Admin UI features, they may also: |
| 264 | |
| 265 | * See record IDs (RIDs) on screens that show them |
| 266 | * See the MIME type of attachments on [`/ainfo` pages](/help/www/ainfo) |
| 267 | * See a remote repo’s HTTP [cache status](/help/www/cachestat) |
| 268 | and [pull cache entries](/help/www/cacheget) |
| 269 | * Edit a Setup user’s account! |
| 270 | |
| 271 | The “Admin” feature of Fossil UI is so-named because Admin users can use |
| 272 | about half of its functions, but only Setup can use these pages: |
| 273 | |
| @@ -395,11 +395,11 @@ | |
| 395 | |
| 396 | |
| 397 | ### <a id="y"></a>Write Unversioned |
| 398 | |
| 399 | Fossil currently doesn’t distinguish the sub-operations of |
| 400 | [`fossil uv`](/help/uv); they’re all covered by [**WrUnver**][capy] |
| 401 | (“y”) capability. Since some of these operations are unconditionally |
| 402 | destructive due to the nature of unversioned content, and since this |
| 403 | goes against Fossil’s philosophy of immutable history, nobody gets cap |
| 404 | “y” on a Fossil repo by default, not even the Setup or Admin users. A |
| 405 | Setup or Admin user must grant cap “y” to someone — not necessarily |
| @@ -446,16 +446,16 @@ | |
| 446 | [capa]: ./ref.html#a |
| 447 | [caps]: ./ref.html#s |
| 448 | [capx]: ./ref.html#x |
| 449 | [capy]: ./ref.html#y |
| 450 | |
| 451 | [fcp]: https://fossil-scm.org/home/help/configuration |
| 452 | [fdp]: ../fossil-v-git.wiki#devorg |
| 453 | [forum]: https://fossil-scm.org/forum/ |
| 454 | [fui]: /help/ui |
| 455 | [lg]: ./login-groups.md |
| 456 | [rs]: https://fossil-scm.org/home/doc/trunk/www/settings.wiki |
| 457 | [sia]: https://fossil-scm.org/home/artifact?ln=1259-1260&name=0fda31b6683c206a |
| 458 | [snoy]: https://fossil-scm.org/forum/forumpost/00e1c4ecff |
| 459 | [th1]: ../th1.md |
| 460 | [tt]: https://en.wikipedia.org/wiki/Tiger_team#Security |
| 461 | [webo]: ./#webonly |
| 462 |
+1
-1
| --- www/caps/login-groups.md | ||
| +++ www/caps/login-groups.md | ||
| @@ -117,11 +117,11 @@ | ||
| 117 | 117 | you into both A and B, within the restrictions set out above. |
| 118 | 118 | |
| 119 | 119 | Changes are transitive in the same way, provided you check that “apply |
| 120 | 120 | to all” box on the user edit screen. |
| 121 | 121 | |
| 122 | -[lg]: /help?cmd=login-group | |
| 122 | +[lg]: /help/login-group | |
| 123 | 123 | [sh]: ../server/any/http-over-ssh.md |
| 124 | 124 | [wo]: ./index.md#webonly |
| 125 | 125 | |
| 126 | 126 | ----- |
| 127 | 127 | |
| 128 | 128 |
| --- www/caps/login-groups.md | |
| +++ www/caps/login-groups.md | |
| @@ -117,11 +117,11 @@ | |
| 117 | you into both A and B, within the restrictions set out above. |
| 118 | |
| 119 | Changes are transitive in the same way, provided you check that “apply |
| 120 | to all” box on the user edit screen. |
| 121 | |
| 122 | [lg]: /help?cmd=login-group |
| 123 | [sh]: ../server/any/http-over-ssh.md |
| 124 | [wo]: ./index.md#webonly |
| 125 | |
| 126 | ----- |
| 127 | |
| 128 |
| --- www/caps/login-groups.md | |
| +++ www/caps/login-groups.md | |
| @@ -117,11 +117,11 @@ | |
| 117 | you into both A and B, within the restrictions set out above. |
| 118 | |
| 119 | Changes are transitive in the same way, provided you check that “apply |
| 120 | to all” box on the user edit screen. |
| 121 | |
| 122 | [lg]: /help/login-group |
| 123 | [sh]: ../server/any/http-over-ssh.md |
| 124 | [wo]: ./index.md#webonly |
| 125 | |
| 126 | ----- |
| 127 | |
| 128 |
+3
-3
| --- www/caps/ref.html | ||
| +++ www/caps/ref.html | ||
| @@ -315,13 +315,13 @@ | ||
| 315 | 315 | <tr id="z"> |
| 316 | 316 | <th>z</th> |
| 317 | 317 | <th>Zip</th> |
| 318 | 318 | <td> |
| 319 | 319 | Pull archives of particular repository versions via <a |
| 320 | - href="/help?cmd=/zip"><tt>/zip</tt></a>, <a | |
| 321 | - href="/help?cmd=/tarball"><tt>/tarball</tt></a>, and <a | |
| 322 | - href="/help?cmd=/sqlar"><tt>/sqlar</tt></a> URLs. This is an | |
| 320 | + href="/help/www/zip"><tt>/zip</tt></a>, <a | |
| 321 | + href="/help/www/tarball"><tt>/tarball</tt></a>, and <a | |
| 322 | + href="/help/www/sqlar"><tt>/sqlar</tt></a> URLs. This is an | |
| 323 | 323 | expensive capability to grant, because creating such archives can |
| 324 | 324 | put a large load on <a href="../server/">a Fossil server</a> which |
| 325 | 325 | you may then need to <a href="../loadmgmt.md">manage</a>. |
| 326 | 326 | Mnemonic: <b>z</b>ip file download. |
| 327 | 327 | </td> |
| 328 | 328 |
| --- www/caps/ref.html | |
| +++ www/caps/ref.html | |
| @@ -315,13 +315,13 @@ | |
| 315 | <tr id="z"> |
| 316 | <th>z</th> |
| 317 | <th>Zip</th> |
| 318 | <td> |
| 319 | Pull archives of particular repository versions via <a |
| 320 | href="/help?cmd=/zip"><tt>/zip</tt></a>, <a |
| 321 | href="/help?cmd=/tarball"><tt>/tarball</tt></a>, and <a |
| 322 | href="/help?cmd=/sqlar"><tt>/sqlar</tt></a> URLs. This is an |
| 323 | expensive capability to grant, because creating such archives can |
| 324 | put a large load on <a href="../server/">a Fossil server</a> which |
| 325 | you may then need to <a href="../loadmgmt.md">manage</a>. |
| 326 | Mnemonic: <b>z</b>ip file download. |
| 327 | </td> |
| 328 |
| --- www/caps/ref.html | |
| +++ www/caps/ref.html | |
| @@ -315,13 +315,13 @@ | |
| 315 | <tr id="z"> |
| 316 | <th>z</th> |
| 317 | <th>Zip</th> |
| 318 | <td> |
| 319 | Pull archives of particular repository versions via <a |
| 320 | href="/help/www/zip"><tt>/zip</tt></a>, <a |
| 321 | href="/help/www/tarball"><tt>/tarball</tt></a>, and <a |
| 322 | href="/help/www/sqlar"><tt>/sqlar</tt></a> URLs. This is an |
| 323 | expensive capability to grant, because creating such archives can |
| 324 | put a large load on <a href="../server/">a Fossil server</a> which |
| 325 | you may then need to <a href="../loadmgmt.md">manage</a>. |
| 326 | Mnemonic: <b>z</b>ip file download. |
| 327 | </td> |
| 328 |
+2
-2
| --- www/cgi.wiki | ||
| +++ www/cgi.wiki | ||
| @@ -72,11 +72,11 @@ | ||
| 72 | 72 | and if the PATH_INFO string is empty, then Fossil will show a list |
| 73 | 73 | of available Fossil repositories. |
| 74 | 74 | |
| 75 | 75 | The "skin" of the reply is determined by the first |
| 76 | 76 | repository in the list that has a non-zero |
| 77 | -[/help?cmd=repolist-skin|repolist-skin] setting. | |
| 77 | +[/help/repolist-skin|repolist-skin] setting. | |
| 78 | 78 | |
| 79 | 79 | If no repository has such a non-zero repolist-skin setting, then |
| 80 | 80 | the repository list is generic HTML without any decoration, with |
| 81 | 81 | the page title taken from the <tt>FOSSIL_REPOLIST_TITLE</tt> |
| 82 | 82 | environment variable. The variable can be defined in the CGI |
| @@ -193,11 +193,11 @@ | ||
| 193 | 193 | repo name is "*", then an unconditional redirect to URL is taken. |
| 194 | 194 | |
| 195 | 195 | |
| 196 | 196 | <h2 id="jsmode">jsmode: <i>VALUE</i></h2> |
| 197 | 197 | |
| 198 | -Specifies the delivery mode for JavaScript files. See "[/help?cmd=http | | |
| 198 | +Specifies the delivery mode for JavaScript files. See "[/help/http | | |
| 199 | 199 | http --jsmode]" for the allowed values and their meanings. |
| 200 | 200 | |
| 201 | 201 | |
| 202 | 202 | <h2 id="mainmenu">mainmenu: <i>FILE</i></h2> |
| 203 | 203 | |
| 204 | 204 |
| --- www/cgi.wiki | |
| +++ www/cgi.wiki | |
| @@ -72,11 +72,11 @@ | |
| 72 | and if the PATH_INFO string is empty, then Fossil will show a list |
| 73 | of available Fossil repositories. |
| 74 | |
| 75 | The "skin" of the reply is determined by the first |
| 76 | repository in the list that has a non-zero |
| 77 | [/help?cmd=repolist-skin|repolist-skin] setting. |
| 78 | |
| 79 | If no repository has such a non-zero repolist-skin setting, then |
| 80 | the repository list is generic HTML without any decoration, with |
| 81 | the page title taken from the <tt>FOSSIL_REPOLIST_TITLE</tt> |
| 82 | environment variable. The variable can be defined in the CGI |
| @@ -193,11 +193,11 @@ | |
| 193 | repo name is "*", then an unconditional redirect to URL is taken. |
| 194 | |
| 195 | |
| 196 | <h2 id="jsmode">jsmode: <i>VALUE</i></h2> |
| 197 | |
| 198 | Specifies the delivery mode for JavaScript files. See "[/help?cmd=http | |
| 199 | http --jsmode]" for the allowed values and their meanings. |
| 200 | |
| 201 | |
| 202 | <h2 id="mainmenu">mainmenu: <i>FILE</i></h2> |
| 203 | |
| 204 |
| --- www/cgi.wiki | |
| +++ www/cgi.wiki | |
| @@ -72,11 +72,11 @@ | |
| 72 | and if the PATH_INFO string is empty, then Fossil will show a list |
| 73 | of available Fossil repositories. |
| 74 | |
| 75 | The "skin" of the reply is determined by the first |
| 76 | repository in the list that has a non-zero |
| 77 | [/help/repolist-skin|repolist-skin] setting. |
| 78 | |
| 79 | If no repository has such a non-zero repolist-skin setting, then |
| 80 | the repository list is generic HTML without any decoration, with |
| 81 | the page title taken from the <tt>FOSSIL_REPOLIST_TITLE</tt> |
| 82 | environment variable. The variable can be defined in the CGI |
| @@ -193,11 +193,11 @@ | |
| 193 | repo name is "*", then an unconditional redirect to URL is taken. |
| 194 | |
| 195 | |
| 196 | <h2 id="jsmode">jsmode: <i>VALUE</i></h2> |
| 197 | |
| 198 | Specifies the delivery mode for JavaScript files. See "[/help/http | |
| 199 | http --jsmode]" for the allowed values and their meanings. |
| 200 | |
| 201 | |
| 202 | <h2 id="mainmenu">mainmenu: <i>FILE</i></h2> |
| 203 | |
| 204 |
+343
-343
| --- www/changes.wiki | ||
| +++ www/changes.wiki | ||
| @@ -2,73 +2,73 @@ | ||
| 2 | 2 | |
| 3 | 3 | <h2 id='v2_28'>Changes for version 2.28 (pending)</h2><ol> |
| 4 | 4 | <li> Improvements to [./antibot.wiki|anti-robot defenses]:<ol type="a"> |
| 5 | 5 | <li> The default configuration now allows robots to download any tarball |
| 6 | 6 | or similar, to better support of automated build systems. |
| 7 | - <li> No special tag "zipX" for the [/help?cmd=robot-restrict|robot-restrict] | |
| 7 | + <li> No special tag "zipX" for the [/help/robot-restrict|robot-restrict] | |
| 8 | 8 | setting blocks robot access to tarballs, but with exceptions to support |
| 9 | 9 | automated build systems. |
| 10 | 10 | </ol> |
| 11 | 11 | <li> A drop-down menu of recent branches is now possible for the submenu, and |
| 12 | 12 | is used in the code browser. |
| 13 | - <li> The [/help?cmd=timeline|timeline command] is enhanced with the new | |
| 13 | + <li> The [/help/timeline|timeline command] is enhanced with the new | |
| 14 | 14 | "<tt>-u|--for-user</tt>" option. |
| 15 | 15 | </ol> |
| 16 | 16 | |
| 17 | 17 | <h2 id='v2_27'>Changes for version 2.27 (2025-09-30)</h2><ol> |
| 18 | 18 | <li> Close a potential Denial-of-Service attack against any public-facing Fossil |
| 19 | 19 | server involving exponential behavior in Fossil's regexp implementation. |
| 20 | - <li> Fix a SQL injection on the [/help?cmd=/file|/file page]. Thanks to | |
| 20 | + <li> Fix a SQL injection on the [/help/www/file|/file page]. Thanks to | |
| 21 | 21 | additional defenses built into Fossil, as well as good luck, this injection |
| 22 | 22 | is not exploitable for either data exfiltration or privilege escalation. The |
| 23 | 23 | only possible result of invoking the injection is a harmless SQL syntax error. |
| 24 | 24 | <li> Strengthen robot defenses to help prevent public-facing servers from being |
| 25 | 25 | overwhelmed by the latest generation of AI spiders. |
| 26 | 26 | <ol type="a"> |
| 27 | 27 | <li> New javascript captcha used to restrict access by user "nobody" to pages |
| 28 | - listed in the [/help?cmd=robot-restrict|robot-restrict setting]. | |
| 29 | - <li> The [/help?cmd=robot-exception|robot-exception setting] is available to allow | |
| 28 | + listed in the [/help/robot-restrict|robot-restrict setting]. | |
| 29 | + <li> The [/help/robot-exception|robot-exception setting] is available to allow | |
| 30 | 30 | access to pages that match a regular expression. Use this, for example, to |
| 31 | 31 | allow curl scripts and similar to download release tarballs. |
| 32 | 32 | <li> Require at least an anonymous login to access the /blame page and similar. |
| 33 | 33 | </ol> |
| 34 | - <li> [/help?cmd=/timeline|Timeline] enhancements: | |
| 34 | + <li> [/help/www/timeline|Timeline] enhancements: | |
| 35 | 35 | <ol type="a"> |
| 36 | - <li> The chng= query parameter on the [/help?cmd=/timeline|timeline page] | |
| 36 | + <li> The chng= query parameter on the [/help/www/timeline|timeline page] | |
| 37 | 37 | so that it works with other query parameters like p=, d=, from=, and to=. |
| 38 | 38 | <li> Always include nodes identify by sel1= and sel2= in the /timeline display. |
| 39 | 39 | <li> Improved title when p= and d= are different. |
| 40 | 40 | </ol> |
| 41 | - <li> Enable the --editor option on the [/help?cmd=amend|fossil amend] command. | |
| 41 | + <li> Enable the --editor option on the [/help/amend|fossil amend] command. | |
| 42 | 42 | <li> When walking the filesystem looking for Fossil repositories, avoid descending |
| 43 | 43 | into directories named "/proc". |
| 44 | 44 | <li> Reduce memory requirements for sending authenticated sync protocol |
| 45 | 45 | messages. |
| 46 | 46 | <li> Show numstat-style change statistics in the /info and /ckout pages. |
| 47 | - <li> Add the [/help?cmd=stash | stash rename] subcommand. | |
| 48 | - <li> Add the "-h" option to the "[/help?cmd=ls|ls]" command to display | |
| 47 | + <li> Add the [/help/stash | stash rename] subcommand. | |
| 48 | + <li> Add the "-h" option to the "[/help/ls|ls]" command to display | |
| 49 | 49 | file hashes for a specific check-in when in verbose mode. |
| 50 | 50 | </ol> |
| 51 | 51 | |
| 52 | 52 | <h2 id='v2_26'>Changes for version 2.26 (2025-04-30)</h2><ol> |
| 53 | - <li>Enhancements to [/help?cmd=diff|fossil diff] and similar: | |
| 53 | + <li>Enhancements to [/help/diff|fossil diff] and similar: | |
| 54 | 54 | <ol type="a"> |
| 55 | 55 | <li> The argument to the --from option can be a directory name, causing |
| 56 | 56 | Fossil to use files under that directory as the baseline for the diff. |
| 57 | - <li> For "gdiff", if no [/help?cmd=gdiff-command|gdiff-command setting] | |
| 57 | + <li> For "gdiff", if no [/help/gdiff-command|gdiff-command setting] | |
| 58 | 58 | is defined, Fossil tries to do a --tk diff if "tclsh" and "wish" |
| 59 | 59 | are available, or a --by diff if not. |
| 60 | 60 | <li> The "Reload" button is added to --tk diffs, to bring the displayed |
| 61 | 61 | diff up to date with the latest changes on disk. |
| 62 | 62 | <li> Add the "Hide diffs/Show diffs" toggle to web-UI diff pages that show |
| 63 | 63 | diffs of multiple files. |
| 64 | 64 | </ol> |
| 65 | - <li>Added the [/help?cmd=/ckout|/ckout web page] to provide information | |
| 65 | + <li>Added the [/help/www/ckout|/ckout web page] to provide information | |
| 66 | 66 | about pending changes in a working check-out |
| 67 | - <li>Enhancements to the [/help?cmd=ui|fossil ui] command: | |
| 67 | + <li>Enhancements to the [/help/ui|fossil ui] command: | |
| 68 | 68 | <ol type="a"> |
| 69 | - <li> Defaults to using the new [/help?cmd=/ckout|/ckout page] as its | |
| 69 | + <li> Defaults to using the new [/help/www/ckout|/ckout page] as its | |
| 70 | 70 | start page. Or, if the new "--from PATH" option is present, the |
| 71 | 71 | default start page becomes "/ckout?exbase=PATH". |
| 72 | 72 | <li> The new "--extpage FILENAME" option opens the named file as if it |
| 73 | 73 | where in a [./serverext.wiki|CGI extension]. Example usage: the |
| 74 | 74 | person editing this change log has |
| @@ -76,25 +76,25 @@ | ||
| 76 | 76 | press "Reload" on the web browser to view edits. |
| 77 | 77 | <li> Accept both IPv4 and IPv6 connections on all platforms, including |
| 78 | 78 | Windows and OpenBSD. This also applies to the "fossil server" |
| 79 | 79 | command. |
| 80 | 80 | </ol> |
| 81 | - <li>Enhancements to [/help?cmd=merge|fossil merge]: | |
| 81 | + <li>Enhancements to [/help/merge|fossil merge]: | |
| 82 | 82 | <ol type="a"> |
| 83 | - <li> Added the [/help?cmd=merge-info|fossil merge-info] command and | |
| 83 | + <li> Added the [/help/merge-info|fossil merge-info] command and | |
| 84 | 84 | especially the --tk option to that command, to provide analysis |
| 85 | 85 | of the most recent merge or update operation. |
| 86 | 86 | <li> When a merge conflict occurs, a new section is added to the conflict |
| 87 | 87 | text that shows Fossil's suggested resolution to the conflict. |
| 88 | 88 | </ol> |
| 89 | - <li>Enhancements to [/help?cmd=commit|fossil commit]: | |
| 89 | + <li>Enhancements to [/help/commit|fossil commit]: | |
| 90 | 90 | <ol type="a"> |
| 91 | 91 | <li> If Fossil sees potential formatting mistakes (ex: bad hyperlinks) |
| 92 | 92 | in the check-in comment, it will alert the developer and give |
| 93 | 93 | him or her the opportunity to edit the comment before continuing. |
| 94 | 94 | This feature is controllable by the |
| 95 | - [/help?cmd=verify-comments|verify-comments setting]. | |
| 95 | + [/help/verify-comments|verify-comments setting]. | |
| 96 | 96 | <li> The new "--if-changes" option causes the commit to become |
| 97 | 97 | a quiet no-op if there are no pending changes. |
| 98 | 98 | <li> Added the ability to sign check-ins with SSH keys. Artifacts signed |
| 99 | 99 | this way are ignored by all previous fossil versions, as if they |
| 100 | 100 | were plain-text file content instead of Fossil artifacts. |
| @@ -106,13 +106,13 @@ | ||
| 106 | 106 | </ol> |
| 107 | 107 | <li>Deprecate the --comfmtflags and --comment-format global options and |
| 108 | 108 | no longer list them in the built-in help, but keep them working for |
| 109 | 109 | backwards compatibility. |
| 110 | 110 | Alternative TTY comment formatting can still be specified using the |
| 111 | - [/help?cmd=comment-format|comment-format setting], if desired. The | |
| 111 | + [/help/comment-format|comment-format setting], if desired. The | |
| 112 | 112 | default comment format is now called "canonical", not "legacy". |
| 113 | - <li>Enhancements to the [/help?cmd=/timeline|/timeline page]: | |
| 113 | + <li>Enhancements to the [/help/www/timeline|/timeline page]: | |
| 114 | 114 | <ol type="a"> |
| 115 | 115 | <li> Added the "ml=" ("Merge-in List") query parameter that works |
| 116 | 116 | like "rl=" ("Related List") but adds "mionly" style related |
| 117 | 117 | check-ins instead of the full "rel" style. |
| 118 | 118 | <li> For "tl=", "rl=", and "ml=", the order of the branches in the |
| @@ -141,33 +141,33 @@ | ||
| 141 | 141 | in which case the timeline shows those check-ins that are both |
| 142 | 142 | ancestors of p= and descendants of d=. |
| 143 | 143 | <li> The saturation and intensity of user-specified checkin and branch |
| 144 | 144 | background colors are automatically adjusted to keep the colors |
| 145 | 145 | compatible with the current skin, unless the |
| 146 | - [/help?cmd=raw-bgcolor|raw-bgcolor setting] is turned on. | |
| 146 | + [/help/raw-bgcolor|raw-bgcolor setting] is turned on. | |
| 147 | 147 | </ol> |
| 148 | - <li>The [/help?cmd=/docfile|/docfile webpage] was added. It works like | |
| 148 | + <li>The [/help/www/docfile|/docfile webpage] was added. It works like | |
| 149 | 149 | /doc but keeps the title of markdown documents with the document rather |
| 150 | 150 | that moving it up to the page title. |
| 151 | - <li>Added the [/help?cmd=/clusterlist|/clusterlist page] for analysis | |
| 151 | + <li>Added the [/help/www/clusterlist|/clusterlist page] for analysis | |
| 152 | 152 | and debugging |
| 153 | 153 | <li>Added the "artifact_to_json(NAME)" SQL function that returns a JSON |
| 154 | 154 | decoding of the artifact described by NAME. |
| 155 | - <li>Improvements to the [/help?cmd=patch|fossil patch] command: | |
| 155 | + <li>Improvements to the [/help/patch|fossil patch] command: | |
| 156 | 156 | <ol type="a"> |
| 157 | 157 | <li> Fix a bug in "fossil patch create" that causes |
| 158 | - [/help?cmd=revert|fossil revert] operations that happened | |
| 159 | - on individualfiles after a [/help?cmd=merge|fossil merge] | |
| 158 | + [/help/revert|fossil revert] operations that happened | |
| 159 | + on individualfiles after a [/help/merge|fossil merge] | |
| 160 | 160 | to be omitted from the patch. |
| 161 | - <li> Added the [/help?cmd=patch|patch alias] command for managing | |
| 161 | + <li> Added the [/help/patch|patch alias] command for managing | |
| 162 | 162 | aliases for remote checkout names. |
| 163 | 163 | </ol> |
| 164 | - <li>Enhancements to on-line help and the [/help?cmd=help|fossil help] command: | |
| 164 | + <li>Enhancements to on-line help and the [/help/help|fossil help] command: | |
| 165 | 165 | <ol type="a"> |
| 166 | 166 | <li> Add the ability to search the help text, either in the UI |
| 167 | - (on the [/help?cmd=/search|/search page]) or from the command-line | |
| 168 | - (using the "[/help?cmd=search|fossil search -h PATTERN]" command.) | |
| 167 | + (on the [/help/www/search|/search page]) or from the command-line | |
| 168 | + (using the "[/help/search|fossil search -h PATTERN]" command.) | |
| 169 | 169 | <li> Accepts an optional SUBCOMMAND argument following the |
| 170 | 170 | COMMAND argument and only shows results for the specified |
| 171 | 171 | subcommand, not the entire command. |
| 172 | 172 | <li> The -u (--usage) option shows only the command-line syntax |
| 173 | 173 | <li> The -o (--options) option shows only the command-line options |
| @@ -183,11 +183,11 @@ | ||
| 183 | 183 | <li> Link the version field in ticket view to a matching checkin or tag. |
| 184 | 184 | <li> Show creation time in report and ticket view. |
| 185 | 185 | <li> Show previous comments in edit ticket as reference. |
| 186 | 186 | </ol> |
| 187 | 187 | <li>Added the "hash" query parameter to the |
| 188 | - [/help?cmd=/whatis|/whatis webpage]. | |
| 188 | + [/help/www/whatis|/whatis webpage]. | |
| 189 | 189 | <li>Add a "user permissions changes" [/doc/trunk/www/alerts.md|subscription] |
| 190 | 190 | which alerts subscribers when an admin creates a new user or |
| 191 | 191 | when a user's permissions change. |
| 192 | 192 | <li>If the FOSSIL_REPOLIST_SHOW environment variable exists and contains |
| 193 | 193 | the substring "description", then the project description for each repository |
| @@ -199,44 +199,44 @@ | ||
| 199 | 199 | <ol type="a"> |
| 200 | 200 | <li> TH1 now makes a distinction between |
| 201 | 201 | [/doc/trunk/www/th1.md#taint|tainted and untainted string values]. |
| 202 | 202 | This makes it more difficult to write custom TH1 scripts that |
| 203 | 203 | contain XSS or SQL-injection bugs. The |
| 204 | - [/help?cmd=vuln-report|vuln-report] setting was added to control | |
| 204 | + [/help/vuln-report|vuln-report] setting was added to control | |
| 205 | 205 | what Fossil does when it encounters a potential TH1 |
| 206 | 206 | security problem. |
| 207 | - <li> The "--th" option was removed from the [/help?cmd=pikchr|fossil pikchr] | |
| 207 | + <li> The "--th" option was removed from the [/help/pikchr|fossil pikchr] | |
| 208 | 208 | command. |
| 209 | 209 | <li> The "enable_htmlify" TH1 command was removed. |
| 210 | 210 | </ol> |
| 211 | - <li>Make [/help?cmd=/chat|/chat] better-behaved during server outages, reducing | |
| 211 | + <li>Make [/help/www/chat|/chat] better-behaved during server outages, reducing | |
| 212 | 212 | the frequency of reconnection attempts over time and providing feedback |
| 213 | 213 | to the user when the connection is down. |
| 214 | - <li>The [/help?cmd=/sqlar|/sqlar] page does not work for users who are not logged | |
| 214 | + <li>The [/help/www/sqlar|/sqlar] page does not work for users who are not logged | |
| 215 | 215 | in, nor are links to that page displayed to users who are not logged in. Being |
| 216 | 216 | logged in as "anonymous" is sufficient to overcome this restriction, assuming |
| 217 | 217 | that "anonymous" can download tarballs and ZIP archives. |
| 218 | 218 | <li>Many other minor fixes and additions. |
| 219 | 219 | </ol> |
| 220 | 220 | |
| 221 | 221 | <h2 id='v2_25'>Changes for version 2.25 (2024-11-06)</h2> |
| 222 | 222 | |
| 223 | - * The "[/help?cmd=ui|fossil ui /]" command now works even for repositories | |
| 223 | + * The "[/help/ui|fossil ui /]" command now works even for repositories | |
| 224 | 224 | that have non-ASCII filenames |
| 225 | - * Add the [/help?cmd=tree|fossil tree] command. | |
| 225 | + * Add the [/help/tree|fossil tree] command. | |
| 226 | 226 | * On case-insensitive filesystems, store files using the filesystem's |
| 227 | 227 | preferred case rather than the case typed in by the user. |
| 228 | 228 | * Change the name "fossil cherry-pick" command to "fossil cherrypick", |
| 229 | 229 | which is more familiar to Git users. Retain the legacy name for |
| 230 | 230 | compatibility. |
| 231 | - * Add new query parameters to the [/help?cmd=/timeline|/timeline page]: | |
| 231 | + * Add new query parameters to the [/help/www/timeline|/timeline page]: | |
| 232 | 232 | d2=, p2=, and dp2=. |
| 233 | - * Add options to the [/help?cmd=tag|fossil tag] command that will list tag values. | |
| 234 | - * Add the -b|--brief option to the [/help?cmd=status|fossil status] command. | |
| 235 | - * Add ability to upload unversioned files via the [/help?cmd=/uvlist|/uvlist page]. | |
| 236 | - * Add history search to the [/help?cmd=/chat|/chat page]. | |
| 237 | - * Add Unix socket support to the [/help?cmd=server|server command]. | |
| 233 | + * Add options to the [/help/tag|fossil tag] command that will list tag values. | |
| 234 | + * Add the -b|--brief option to the [/help/status|fossil status] command. | |
| 235 | + * Add ability to upload unversioned files via the [/help/www/uvlist|/uvlist page]. | |
| 236 | + * Add history search to the [/help/www/chat|/chat page]. | |
| 237 | + * Add Unix socket support to the [/help/server|server command]. | |
| 238 | 238 | * On Windows, use the root certificates managed by the operating system |
| 239 | 239 | (requires OpenSSL 3.2.0 or greater). |
| 240 | 240 | * Take into account zero-width and double-width unicode characters when |
| 241 | 241 | formatting the command-line timeline. |
| 242 | 242 | * Update the built-in SQLite to version 3.47.0. Precompiled binaries are |
| @@ -273,11 +273,11 @@ | ||
| 273 | 273 | </ul> |
| 274 | 274 | * If an "ssh:" sync fails in a way that suggests that the fossil executable |
| 275 | 275 | could not be found on the remote host, then retry after adding a PATH= |
| 276 | 276 | prefix to the command. This helps "ssh:" to "just work" when the server |
| 277 | 277 | is a Mac. |
| 278 | - * Enhancements to the [/help?cmd=/timeline|/timeline page]: | |
| 278 | + * Enhancements to the [/help/www/timeline|/timeline page]: | |
| 279 | 279 | <ul> |
| 280 | 280 | <li> Add the x= query paramater |
| 281 | 281 | <li> Add the shortcut tl= and rl= query parameters |
| 282 | 282 | <li> Add support for from=,ft= and from=,bt= query parameter combinations |
| 283 | 283 | <li> Automatically highlight the endpoints for from=,to= queries. |
| @@ -287,16 +287,16 @@ | ||
| 287 | 287 | * Moved the /museum/repo.fossil file referenced from the Dockerfile from |
| 288 | 288 | the ENTRYPOINT to the CMD part to allow use of --repolist mode. |
| 289 | 289 | * The [/uvlist] page now shows the hash algorithm used so that |
| 290 | 290 | viewers don't have to guess. The hash is shown in a fixed-width |
| 291 | 291 | font for a more visually pleasing display. |
| 292 | - * If the [/help?cmd=autosync|autosync setting] contains keyword "all", | |
| 292 | + * If the [/help/autosync|autosync setting] contains keyword "all", | |
| 293 | 293 | the automatic sync occurs against all defined remote repositories, not |
| 294 | 294 | just the default. |
| 295 | 295 | * Markdown formatter: improved handling of indented fenced code blocks |
| 296 | 296 | that contain blank lines. |
| 297 | - * When doing a "[/help?cmd=add|fossil add]" on a system with case-insensitive | |
| 297 | + * When doing a "[/help/add|fossil add]" on a system with case-insensitive | |
| 298 | 298 | but case-preserving filenames (Mac and Windows) try to use the filename |
| 299 | 299 | case as it is known to the filesystem, not the case entered by the |
| 300 | 300 | user on the command-line. See |
| 301 | 301 | [forum:/forumpost/30d9c0d131610f53|forum thread 30d9c0d131610f53]. |
| 302 | 302 | * Fix problems with one-click unsubscribe on email notifications. |
| @@ -310,17 +310,17 @@ | ||
| 310 | 310 | <h2 id='v2_23'>Changes for version 2.23 (2023-11-01)</h2> |
| 311 | 311 | |
| 312 | 312 | * Add ability to "close" forum threads, such that unprivileged users |
| 313 | 313 | may no longer respond to them. Only administrators can close |
| 314 | 314 | threads or respond to them by default, and the |
| 315 | - [/help?cmd=forum-close-policy|forum-close-policy setting] can be | |
| 315 | + [/help/forum-close-policy|forum-close-policy setting] can be | |
| 316 | 316 | used to add that capability to moderators. |
| 317 | - * Add the [/help?cmd=all|fossil all whatis] command. | |
| 318 | - * The [/help?cmd=status|fossil status] command and relevant UI pages now | |
| 317 | + * Add the [/help/all|fossil all whatis] command. | |
| 318 | + * The [/help/status|fossil status] command and relevant UI pages now | |
| 319 | 319 | correctly report files which were both renamed <b>and</b> edited as such. |
| 320 | 320 | * Show default value of settings that have a default in |
| 321 | - [/help?cmd=help|fossil help SETTING] output. | |
| 321 | + [/help/help|fossil help SETTING] output. | |
| 322 | 322 | * On timeline graphs, show closed check-ins using an X in the middle of the |
| 323 | 323 | node circle or box. |
| 324 | 324 | * New options for email notification: Get email only for the first |
| 325 | 325 | post in each new thread, and/or posts that are in reply to my posts. |
| 326 | 326 | * Fix a regression bug introduced in version 2.22 that caused FTS5 searches |
| @@ -333,35 +333,35 @@ | ||
| 333 | 333 | <li> Better defense against cross-site request forgery (CSRF) |
| 334 | 334 | attacks. |
| 335 | 335 | <li> Improvements to static analysis of source code (the codecheck1.c |
| 336 | 336 | file in the source tree). |
| 337 | 337 | </ul> |
| 338 | - * Enhance the [/help?cmd=/dir|treeview file listings] | |
| 338 | + * Enhance the [/help/www/dir|treeview file listings] | |
| 339 | 339 | ([/dir?type=tree&ci=trunk|example]) by displaying file sizes |
| 340 | 340 | and adding the option to sort by file size. |
| 341 | - * The [/help?cmd=fts-config|fossil fts-config] command now shows how much | |
| 341 | + * The [/help/fts-config|fossil fts-config] command now shows how much | |
| 342 | 342 | repository space is used by the full-text index. |
| 343 | 343 | * Changing a setting to an empty string is now the same as deleting the |
| 344 | 344 | setting, in most cases. There are a few exceptions, indicated by the |
| 345 | 345 | keep-empty flag on the setting definition. |
| 346 | - * The [/help?cmd=branch|fossil branch list] command can now filter branches | |
| 346 | + * The [/help/branch|fossil branch list] command can now filter branches | |
| 347 | 347 | that have/have not been merged into the current branch. |
| 348 | 348 | * Improvements to interactions with remote repositories over SSH: |
| 349 | 349 | <ul> |
| 350 | 350 | <li> Print the text of the SSH command that is run to do remote interaction, |
| 351 | 351 | for full disclosure to the operator. |
| 352 | - <li> Add a PATH= argument to the [/help?cmd=ui|fossil ui remote:/] and | |
| 353 | - [/help?cmd=patch|fossil patch push/pull remote:...] commands so that | |
| 352 | + <li> Add a PATH= argument to the [/help/ui|fossil ui remote:/] and | |
| 353 | + [/help/patch|fossil patch push/pull remote:...] commands so that | |
| 354 | 354 | they work when the "remote" machine is a Mac and the "fossil" |
| 355 | 355 | executable is in the $HOME/bin directory. |
| 356 | 356 | </ul> |
| 357 | 357 | * Update built-in libraries SQLite, ZLib, Pikchr to their latest versions. |
| 358 | 358 | * Documentation enhancements and typo fixes. |
| 359 | 359 | |
| 360 | 360 | |
| 361 | 361 | <h2 id='v2_22'>Changes for version 2.22 (2023-05-31)</h2> |
| 362 | - * Enhancements to the [/help?cmd=/timeline|/timeline webpage]: <ol type="a"> | |
| 362 | + * Enhancements to the [/help/www/timeline|/timeline webpage]: <ol type="a"> | |
| 363 | 363 | <li> Add the ft=TAG query parameter which in combination with d=Y |
| 364 | 364 | shows all descendants of Y up to TAG |
| 365 | 365 | <li> Enhance the s=PATTERN (search) query parameter so that forum post |
| 366 | 366 | text is also searched when the "vfx" query parameter is used |
| 367 | 367 | <li> Fix the u= (user) query parameter so that it works with a= and b= |
| @@ -385,56 +385,56 @@ | ||
| 385 | 385 | searching in Chinese. |
| 386 | 386 | * Comment lines (starting with a '#') are now supported inside |
| 387 | 387 | [./settings.wiki#versionable|versioned settings]. |
| 388 | 388 | * Default permissions for anonymous users in new repositories are |
| 389 | 389 | changed to "hz". |
| 390 | - * The [/help?cmd=status|fossil status] command now detects when a | |
| 390 | + * The [/help/status|fossil status] command now detects when a | |
| 391 | 391 | file used to be a symlink and has been replaced by a regular file. |
| 392 | 392 | (It previously checked for the inverse case only.) |
| 393 | - * The [/help?cmd=empty-dirs|empty-dirs setting] now reuses the same | |
| 393 | + * The [/help/empty-dirs|empty-dirs setting] now reuses the same | |
| 394 | 394 | parser as the *-glob settings instead of its prior idiosyncratic |
| 395 | 395 | parser, allowing quoted whitespace in patterns. |
| 396 | - * Enhancements to the [/help?cmd=/reports|/reports webpage]: | |
| 396 | + * Enhancements to the [/help/www/reports|/reports webpage]: | |
| 397 | 397 | <ol type="a"> |
| 398 | 398 | <li> The by-week, by-month, and by-year options now show an estimated |
| 399 | 399 | size of the current week, month, or year as a dashed box. |
| 400 | 400 | <li> New sub-categories "Merge Check-ins" and "Non-Merge Check-ins". |
| 401 | 401 | </ol> |
| 402 | 402 | |
| 403 | 403 | <h2 id='v2_21'>Changes for version 2.21 (2023-02-25)</h2> |
| 404 | 404 | * Users can request a password reset. This feature is disabled by default. |
| 405 | - Use the new [/help?cmd=self-pw-reset|self-pw-reset property] to enable it. | |
| 406 | - New web pages [/help?cmd=/resetpw|/resetpw] and | |
| 407 | - [/help?cmd=/reqpwreset|/reqpwreset] added. | |
| 408 | - * Add the [/help?cmd=repack|fossil repack] command (together with | |
| 409 | - [/help?cmd=all|fossil all repack]) as a convenient way to optimize the | |
| 405 | + Use the new [/help/self-pw-reset|self-pw-reset property] to enable it. | |
| 406 | + New web pages [/help/www/resetpw|/resetpw] and | |
| 407 | + [/help/www/reqpwreset|/reqpwreset] added. | |
| 408 | + * Add the [/help/repack|fossil repack] command (together with | |
| 409 | + [/help/all|fossil all repack]) as a convenient way to optimize the | |
| 410 | 410 | size of one or all of the repositories on a system. |
| 411 | 411 | * Add the ability to put text descriptions on ticket report formats. |
| 412 | 412 | * Upgrade the test-find-pivot command to the [/help/merge-base|merge-base command]. |
| 413 | - * The [/help?cmd=/chat|/chat page] can now embed fossil-rendered | |
| 413 | + * The [/help/www/chat|/chat page] can now embed fossil-rendered | |
| 414 | 414 | views of wiki/markdown/pikchr file attachments with the caveat that such |
| 415 | 415 | embedding happens in an iframe and thus does not inherit styles and such |
| 416 | 416 | from the containing browser window. |
| 417 | - * The [/help?cmd=all|fossil all remote] subcommand added to "fossil all". | |
| 417 | + * The [/help/all|fossil all remote] subcommand added to "fossil all". | |
| 418 | 418 | * Passwords for remembered remote repositories are now stored as irreversible |
| 419 | 419 | hashes rather than obscured clear-text, for improved security. |
| 420 | 420 | * Add the "nossl" and "nocompress" options to CGI. |
| 421 | 421 | * Update search infrastructure from FTS4 to FTS5. |
| 422 | - * Add the [/help?cmd=/deltachain|/deltachain] page for debugging purposes. | |
| 422 | + * Add the [/help/www/deltachain|/deltachain] page for debugging purposes. | |
| 423 | 423 | * Writes to the database are disabled by default if the HTTP request |
| 424 | 424 | does not come from the same origin. This enhancement is a defense in depth |
| 425 | 425 | measure only; it does not address any known vulnerabilities. |
| 426 | 426 | * Improvements to automatic detection and mitigation of attacks from |
| 427 | 427 | malicious robots. |
| 428 | 428 | |
| 429 | 429 | <h2 id='v2_20'>Changes for version 2.20 (2022-11-16)</h2> |
| 430 | - * Added the [/help?cmd=chat-timeline-user|chat-timeline-user setting]. If | |
| 430 | + * Added the [/help/chat-timeline-user|chat-timeline-user setting]. If | |
| 431 | 431 | it is not an empty string, then any changes that would appear on the timeline |
| 432 | 432 | are announced in [./chat.md|the chat room]. |
| 433 | 433 | * The /unsubscribe page now requests confirmation. [./alerts.md|Email notifications] |
| 434 | 434 | now contain only an "Unsubscribe" link, and not a link to subscription management. |
| 435 | - * Added the "[/help?cmd=branch|fossil branch lsh]" subcommand to list the | |
| 435 | + * Added the "[/help/branch|fossil branch lsh]" subcommand to list the | |
| 436 | 436 | most recently modified branches. |
| 437 | 437 | * More elements of the /info page are now inside of an accordion. |
| 438 | 438 | * Replace the <tt>--dryrun</tt> flag with <tt>--dry-run</tt> in all |
| 439 | 439 | commands which still used the former name, for consistency. |
| 440 | 440 | * Rebuilt [/file/Dockerfile | the stock Dockerfile] to create a "from scratch" |
| @@ -464,11 +464,11 @@ | ||
| 464 | 464 | accomplished using a Common Table Expression in the underlying SQL. |
| 465 | 465 | * Sort tag listings (command line and webpage) by taking numbers into |
| 466 | 466 | consideration so as to cater for tags that follow semantic versioning. |
| 467 | 467 | * On the wiki listings, omit by default wiki pages that are associated with |
| 468 | 468 | check-ins and branches. |
| 469 | - * Add the new "[/help?cmd=describe|fossil describe]" command. | |
| 469 | + * Add the new "[/help/describe|fossil describe]" command. | |
| 470 | 470 | * Markdown subsystem extended with [../src/markdown.md#ftnts|footnotes support]. |
| 471 | 471 | See corresponding [../test/markdown-test3.md|test cases], |
| 472 | 472 | [/wiki?name=branch/markdown-footnotes#il|known limitations] and |
| 473 | 473 | [forum:/forumthread/ee1f1597e46ec07a|discussion]. |
| 474 | 474 | * Add the new special name "start:BRANCH" to refer to the first check-in of |
| @@ -480,96 +480,96 @@ | ||
| 480 | 480 | operation. Also require explicit "system" proxy setting to use |
| 481 | 481 | "http_proxy" environment variable. |
| 482 | 482 | * Reimplemented the [/pikchrshow] app to use a WebAssembly build of |
| 483 | 483 | pikchr so that it can render pikchrs on the client instead of requiring |
| 484 | 484 | a server round-trip. |
| 485 | - * Add the [/help?cmd=email-listid|email-listid setting]. If set, it is | |
| 485 | + * Add the [/help/email-listid|email-listid setting]. If set, it is | |
| 486 | 486 | used as the List-ID header for all outbound notification emails. |
| 487 | - * Add the "--branch" option to the "[/help?cmd=timeline|timeline]" command | |
| 487 | + * Add the "--branch" option to the "[/help/timeline|timeline]" command | |
| 488 | 488 | to restrict the displayed items to a specific branch. |
| 489 | - * Add the "--versions" option to "[/help?cmd=diff|fossil diff]" | |
| 489 | + * Add the "--versions" option to "[/help/diff|fossil diff]" | |
| 490 | 490 | to display details about the compared versions into the patch header. |
| 491 | 491 | * Numerous other minor enhancements. |
| 492 | 492 | |
| 493 | 493 | <h2 id='v2_18'>Changes for version 2.18 (2022-02-23)</h2> |
| 494 | 494 | * Added support for [./ssl-server.md|SSL/TLS server mode] for commands |
| 495 | - like "[/help?cmd=server|fossil server]" and "[/help?cmd=http|fossil http]" | |
| 496 | - * The new [/help?cmd=cherry-pick|cherry-pick command] is an alias for | |
| 497 | - [/help?cmd=merge|merge --cherrypick]. | |
| 498 | - * Add new setting "[/help?cmd=large-file-size|large-file-size]". If the size | |
| 495 | + like "[/help/server|fossil server]" and "[/help/http|fossil http]" | |
| 496 | + * The new [/help/cherry-pick|cherry-pick command] is an alias for | |
| 497 | + [/help/merge|merge --cherrypick]. | |
| 498 | + * Add new setting "[/help/large-file-size|large-file-size]". If the size | |
| 499 | 499 | of any file in a commit exceeds this size, a warning is issued. |
| 500 | - * Query parameter "year=YYYY" is now accepted by [/help?cmd=/timeline|/timeline]. | |
| 501 | - * The [/help?cmd=tar|tar] and [/help?cmd=zip|zip commands] no longer | |
| 500 | + * Query parameter "year=YYYY" is now accepted by [/help/www/timeline|/timeline]. | |
| 501 | + * The [/help/tar|tar] and [/help/zip|zip commands] no longer | |
| 502 | 502 | sterilize the manifest file. |
| 503 | 503 | * Further improvement to diff alignment in cases that involve both |
| 504 | 504 | edits and indentation changes. |
| 505 | 505 | * [/doc/trunk/www/chat.md|Chat] improvements:<ul> |
| 506 | - <li> [/help?cmd=/chat|The /chat page] input options have been reworked | |
| 506 | + <li> [/help/www/chat|The /chat page] input options have been reworked | |
| 507 | 507 | again for better cross-browser portability. |
| 508 | - <li> When sending a [/help?cmd=/chat|/chat] message fails, it is no longer | |
| 508 | + <li> When sending a [/help/www/chat|/chat] message fails, it is no longer | |
| 509 | 509 | immediately lost and sending may optionally be retried. |
| 510 | - <li> [/help?cmd=/chat|/chat] can now optionally embed attachments of certain | |
| 510 | + <li> [/help/www/chat|/chat] can now optionally embed attachments of certain | |
| 511 | 511 | types directly into message bodies via an iframe. |
| 512 | - <li> Add the "--as FILENAME" option to the "[/help?cmd=chat|fossil chat send]" | |
| 512 | + <li> Add the "--as FILENAME" option to the "[/help/chat|fossil chat send]" | |
| 513 | 513 | command. |
| 514 | - <li> Added the "[/help?cmd=chat|fossil chat pull]" command, available to | |
| 514 | + <li> Added the "[/help/chat|fossil chat pull]" command, available to | |
| 515 | 515 | administrators only, for backing up the chat conversation. |
| 516 | 516 | </ul> |
| 517 | - * Promote the test-detach command into the [/help?cmd=detach|detach command]. | |
| 518 | - * For "[/help?cmd=pull|fossil pull]" with the --from-parent-project option, | |
| 517 | + * Promote the test-detach command into the [/help/detach|detach command]. | |
| 518 | + * For "[/help/pull|fossil pull]" with the --from-parent-project option, | |
| 519 | 519 | if no URL is specified then use the last URL from the most recent prior |
| 520 | 520 | "fossil pull --from-parent-project". |
| 521 | 521 | * Add options --project-name and --project-desc to the |
| 522 | - "[/help?cmd=init|fossil init]" command. | |
| 523 | - * The [/help?cmd=/ext|/ext page] generates the SERVER_SOFTWARE environment | |
| 522 | + "[/help/init|fossil init]" command. | |
| 523 | + * The [/help/www/ext|/ext page] generates the SERVER_SOFTWARE environment | |
| 524 | 524 | variable for clients. |
| 525 | 525 | * Fix the REQUEST_URI [/doc/trunk/www/aboutcgi.wiki#cgivar|CGI variable] such |
| 526 | 526 | that it includes the query string. This is how most other systems understand |
| 527 | 527 | REQUEST_URI. |
| 528 | - * Added the --transport-command option to [/help?cmd=sync|fossil sync] | |
| 528 | + * Added the --transport-command option to [/help/sync|fossil sync] | |
| 529 | 529 | and similar. |
| 530 | 530 | |
| 531 | 531 | <h2 id='v2_17'>Changes for version 2.17 (2021-10-09)</h2> |
| 532 | 532 | |
| 533 | 533 | * Major improvements to the "diff" subsystem, including: <ul> |
| 534 | - <li> Added new [/help?cmd=diff|formatting options]: --by, -b, --webpage, --json, --tcl. | |
| 534 | + <li> Added new [/help/diff|formatting options]: --by, -b, --webpage, --json, --tcl. | |
| 535 | 535 | <li> Partial-line matching for unified diffs |
| 536 | 536 | <li> Better partial-line matching for side-by-side diffs |
| 537 | 537 | <li> Buttons on web-based diffs to show more context |
| 538 | 538 | <li> Performance improvements |
| 539 | 539 | </ul> |
| 540 | - * The --branchcolor option on [/help?cmd=commit|fossil commit] and | |
| 541 | - [/help?cmd=amend|fossil amend] can now take the value "auto" to | |
| 540 | + * The --branchcolor option on [/help/commit|fossil commit] and | |
| 541 | + [/help/amend|fossil amend] can now take the value "auto" to | |
| 542 | 542 | force Fossil to use its built-in automatic color choosing algorithm. |
| 543 | 543 | * Fossil now [./concepts.wiki#workflow|autosyncs] prior to running |
| 544 | - [/help?cmd=open|fossil open]. | |
| 545 | - * Add the [/help?cmd=ticket-default-report|ticket-default-report setting], | |
| 544 | + [/help/open|fossil open]. | |
| 545 | + * Add the [/help/ticket-default-report|ticket-default-report setting], | |
| 546 | 546 | which if set to the title of a ticket report causes that ticket report |
| 547 | 547 | to be displayed below the search box in the /ticket page. |
| 548 | - * The "nc" query parameter to the [/help?cmd=/timeline|/timeline] page | |
| 548 | + * The "nc" query parameter to the [/help/www/timeline|/timeline] page | |
| 549 | 549 | causes all graph coloring to be omitted. |
| 550 | - * Improvements and bug fixes to the new "[/help?cmd=ui|fossil ui REMOTE]" | |
| 550 | + * Improvements and bug fixes to the new "[/help/ui|fossil ui REMOTE]" | |
| 551 | 551 | feature so that it works better on a wider variety of platforms. |
| 552 | - * In [/help?cmd=/wikiedit|/wikiedit], show the list of attachments for | |
| 552 | + * In [/help/www/wikiedit|/wikiedit], show the list of attachments for | |
| 553 | 553 | the current page and list URLs suitable for pasting them into the page. |
| 554 | - * Add the --no-http-compression option to [/help?cmd=sync|fossil sync] | |
| 554 | + * Add the --no-http-compression option to [/help/sync|fossil sync] | |
| 555 | 555 | and similar. |
| 556 | - * Print total payload bytes on a [/help?cmd=sync|fossil sync] when using | |
| 556 | + * Print total payload bytes on a [/help/sync|fossil sync] when using | |
| 557 | 557 | the --verbose option. |
| 558 | 558 | * Add the <tt>close</tt>, <tt>reopen</tt>, <tt>hide</tt>, and |
| 559 | - </tt>unhide</tt> subcommands to [/help?cmd=branch|the branch command]. | |
| 560 | - * The "-p" option to [/help?cmd=branch|fossil branch list] shows only | |
| 559 | + </tt>unhide</tt> subcommands to [/help/branch|the branch command]. | |
| 560 | + * The "-p" option to [/help/branch|fossil branch list] shows only | |
| 561 | 561 | private branches. |
| 562 | 562 | * The [/md_rules|Markdown formatter] now interprets the content of |
| 563 | 563 | block HTML markup (such as <table>) in most cases. Only content |
| 564 | 564 | of <pre> and <script> is passed through verbatim. |
| 565 | - * The [/help?cmd=wiki|wiki list command] no longer lists "deleted" | |
| 565 | + * The [/help/wiki|wiki list command] no longer lists "deleted" | |
| 566 | 566 | pages by default. Use the new <tt>--all</tt> option to include deleted |
| 567 | 567 | pages in the output. |
| 568 | - * The [/help?cmd=all|fossil all git status] command only shows reports for | |
| 568 | + * The [/help/all|fossil all git status] command only shows reports for | |
| 569 | 569 | the subset of repositories that have a configured Git export. |
| 570 | - * The [/help?cmd=/chat|/chat] configuration was reimplemented and | |
| 570 | + * The [/help/www/chat|/chat] configuration was reimplemented and | |
| 571 | 571 | provides new options, including the ability for a repository |
| 572 | 572 | administrator to |
| 573 | 573 | [./chat.md#notifications|extend the selection of notification sounds] |
| 574 | 574 | using unversioned files. |
| 575 | 575 | * Chat now uses fossil's full complement of markdown features, |
| @@ -578,14 +578,14 @@ | ||
| 578 | 578 | markdown-processed when they are sent instead of when they |
| 579 | 579 | are saved. |
| 580 | 580 | * Added a chat message preview mode so messages can be previewed |
| 581 | 581 | before being sent. Similarly, added a per-message ability to view |
| 582 | 582 | the raw un-parsed message text. |
| 583 | - * The hotkey to activate preview mode in [/help?cmd=/wikiedit|/wikiedit], | |
| 584 | - [/help?cmd=/fileedit|/fileedit], and [/help?cmd=/pikchrshow|/pikchrshow] | |
| 583 | + * The hotkey to activate preview mode in [/help/www/wikiedit|/wikiedit], | |
| 584 | + [/help/www/fileedit|/fileedit], and [/help/www/pikchrshow|/pikchrshow] | |
| 585 | 585 | was changed from ctrl-enter to shift-enter in order to align with |
| 586 | - [/help?cmd=/chat|/chat]'s new preview feature and related future | |
| 586 | + [/help/www/chat|/chat]'s new preview feature and related future | |
| 587 | 587 | changes. |
| 588 | 588 | |
| 589 | 589 | <h2 id='v2_16'>Changes for Version 2.16 (2021-07-02)</h2> |
| 590 | 590 | * <b>Security:</b> Fix the client-side TLS so that it verifies that the |
| 591 | 591 | server hostname matches its certificate. |
| @@ -592,11 +592,11 @@ | ||
| 592 | 592 | * The default "ssh" command on Windows is changed to "ssh" instead of the |
| 593 | 593 | legacy "plink", as ssh is now generally available on Windows systems. |
| 594 | 594 | Installations that still need to use the legacy "plink" can make that |
| 595 | 595 | happen by running: '<tt>fossil set ssh-command "plink -ssh" --global</tt>'. |
| 596 | 596 | * Added the [./patchcmd.md|fossil patch] command. |
| 597 | - * The [/help?cmd=ui|fossil ui] command is enhanced in multiple ways:<ol> | |
| 597 | + * The [/help/ui|fossil ui] command is enhanced in multiple ways:<ol> | |
| 598 | 598 | <li> The REPOSITORY argument can be the name of a check-out directory. |
| 599 | 599 | <li> If the REPOSITORY argument is prefixed by "HOST:" or "USER@HOST:" |
| 600 | 600 | then the ui is run on the remote machine and tunnelled back to the local |
| 601 | 601 | machine using ssh. (The latest version of fossil must be installed on |
| 602 | 602 | both the local and the remote for this to work correctly.) |
| @@ -605,25 +605,25 @@ | ||
| 605 | 605 | * The [/brlist|/brlist web page] allows the user to |
| 606 | 606 | select multiple branches to be displayed together in a single |
| 607 | 607 | timeline. |
| 608 | 608 | * The [./forum.wiki|Forum] provides a hyperlink on the author of each |
| 609 | 609 | post that goes to a timeline of recent posts by that same author. |
| 610 | - * Added the "[/help?cmd=bisect|fossil bisect run]" command for improved | |
| 610 | + * Added the "[/help/bisect|fossil bisect run]" command for improved | |
| 611 | 611 | automation of bisects. |
| 612 | - * The [/help?cmd=merge|fossil merge] command now does a better job merging | |
| 612 | + * The [/help/merge|fossil merge] command now does a better job merging | |
| 613 | 613 | branches where files have been renamed between the current branch and the |
| 614 | 614 | branch being merged. |
| 615 | - * The [/help?cmd=open|fossil open] command allows the repository file | |
| 615 | + * The [/help/open|fossil open] command allows the repository file | |
| 616 | 616 | to be inside the working directory without requiring the --force flag. |
| 617 | - * The [/help?cmd=/wikiedit|/wikiedit] and [/help?cmd=/wikinew|/wikinew] | |
| 617 | + * The [/help/www/wikiedit|/wikiedit] and [/help/www/wikinew|/wikinew] | |
| 618 | 618 | pages now default to markdown format. |
| 619 | - * The [/help?cmd=/login|/login] page now links to a user's forum post | |
| 619 | + * The [/help/www/login|/login] page now links to a user's forum post | |
| 620 | 620 | timeline if the repository has forum posts. |
| 621 | 621 | * Tags may now be propagated for forum posts, wiki pages, and technotes. |
| 622 | - The [/help?cmd=tag|tag command] can now manipulate and list such tags. | |
| 622 | + The [/help/tag|tag command] can now manipulate and list such tags. | |
| 623 | 623 | * [./caps/login-groups.md|Login-Groups] are now shown on the repository |
| 624 | - list of the "[/help?cmd=all|fossil all ui]" command. | |
| 624 | + list of the "[/help/all|fossil all ui]" command. | |
| 625 | 625 | * Administrators can configure [./alerts.md|email alerts] to expire |
| 626 | 626 | a specific number of days (ex: 365) after the last user contact with |
| 627 | 627 | the Fossil server. This prevents alert emails being sent to |
| 628 | 628 | abandoned email accounts forever. |
| 629 | 629 | * SQL that defines [/tktsetup_tab|database objects for tickets] now |
| @@ -640,11 +640,11 @@ | ||
| 640 | 640 | * <b>Patch 2.15.1:</b> Fix a data exfiltration bug in the server. <b>Upgrading to |
| 641 | 641 | the patch is recommended.</b> |
| 642 | 642 | * The [./defcsp.md|default CSP] has been relaxed slightly to allow |
| 643 | 643 | images to be loaded from any URL. All other resources are still |
| 644 | 644 | locked down by default. |
| 645 | - * The built-in skins all use the "[/help?cmd=mainmenu|mainmenu]" | |
| 645 | + * The built-in skins all use the "[/help/mainmenu|mainmenu]" | |
| 646 | 646 | setting to determine the content of the main menu. |
| 647 | 647 | The ability to edit the |
| 648 | 648 | "mainmenu" setting is added on the /Admin/Configuration page. |
| 649 | 649 | * The hamburger menu is now available on most of the built-in skins. |
| 650 | 650 | * Any built-in skin named "X" can be used instead of the standard |
| @@ -654,40 +654,40 @@ | ||
| 654 | 654 | included. The [/skins] page may be used to select a skin. |
| 655 | 655 | * The [/cookies] page now gives the user an opportunity to delete |
| 656 | 656 | individual cookies. And the /cookies page is linked from the |
| 657 | 657 | /sitemap, so that it appears in hamburger menus. |
| 658 | 658 | * The [/sitemap] extensions are now specified by a single new |
| 659 | - "[/help?cmd=sitemap-extra|sitemap-extra setting]", | |
| 659 | + "[/help/sitemap-extra|sitemap-extra setting]", | |
| 660 | 660 | rather than a cluster of various |
| 661 | 661 | "sitemap-*" settings. The older settings are no longer used. |
| 662 | 662 | <b>This change might require minor server configuration |
| 663 | 663 | adjustments on servers that use /sitemap extensions.</b> |
| 664 | 664 | The /Admin/Configuration page provides the ability to edit |
| 665 | 665 | the new "sitemap-extra" setting. |
| 666 | 666 | * Added the "--ckout-alias NAME" option to |
| 667 | - [/help?cmd=ui|fossil ui], [/help?cmd=server|fossil server], and | |
| 668 | - [/help?cmd=http|fossil http]. This option causes Fossil to | |
| 667 | + [/help/ui|fossil ui], [/help/server|fossil server], and | |
| 668 | + [/help/http|fossil http]. This option causes Fossil to | |
| 669 | 669 | understand URIs of the form "/doc/NAME/..." as if they were |
| 670 | - "[/help?cmd=/doc|/doc/ckout/...]", to facilitate testing of | |
| 670 | + "[/help/www/doc|/doc/ckout/...]", to facilitate testing of | |
| 671 | 671 | [./embeddeddoc.wiki|embedded documentation] changes prior to |
| 672 | 672 | check-in. |
| 673 | 673 | * For diff web pages, if the diff type (unified versus side-by-side) |
| 674 | 674 | is not specified by a query parameter, and if the |
| 675 | - "[/help?cmd=preferred-diff-type|preferred-diff-type]" | |
| 675 | + "[/help/preferred-diff-type|preferred-diff-type]" | |
| 676 | 676 | setting is omitted or less than 1, then select the diff type based |
| 677 | 677 | on a guess of whether or not the request is coming from a mobile |
| 678 | 678 | device. Mobile gets unified and desktop gets side-by-side. |
| 679 | 679 | * The various pages which show diffs now have toggles to show/hide |
| 680 | 680 | individual diffs. |
| 681 | - * Add the "[/help?cmd=preferred-diff-type|preferred-diff-type]" | |
| 681 | + * Add the "[/help/preferred-diff-type|preferred-diff-type]" | |
| 682 | 682 | setting to allow an admin to force a default diff type. |
| 683 | 683 | * The "pikchr-background" setting is now available in |
| 684 | 684 | "detail.txt" skin files, for better control of Pikchr |
| 685 | 685 | colors in inverted color schemes. |
| 686 | 686 | * Add the <tt>--list</tt> option to the |
| 687 | - [/help?cmd=tarball|tarball], | |
| 688 | - [/help?cmd=zip|zip], and [/help?cmd=sqlar|sqlar] | |
| 687 | + [/help/tarball|tarball], | |
| 688 | + [/help/zip|zip], and [/help/sqlar|sqlar] | |
| 689 | 689 | commands. |
| 690 | 690 | * The javascript used to implement the hamburger menu on the |
| 691 | 691 | default built-in skin has been made generic so that it is usable |
| 692 | 692 | by a variety of skins, and promoted to an ordinary built-in |
| 693 | 693 | javascript file. |
| @@ -695,24 +695,24 @@ | ||
| 695 | 695 | "[/doc/trunk/www/th1.md#bireqjs|builtin_request_js]", |
| 696 | 696 | "[/doc/trunk/www/th1.md#capexpr|capexpr]", |
| 697 | 697 | "foreach", "lappend", and "string match" |
| 698 | 698 | * The [/help/leaves|leaves command] now shows the branch point |
| 699 | 699 | of each leaf. |
| 700 | - * The [/help?cmd=add|fossil add] command refuses to add files whose | |
| 700 | + * The [/help/add|fossil add] command refuses to add files whose | |
| 701 | 701 | names are reserved by Windows (ex: "aux") unless the --allow-reserved |
| 702 | 702 | option is included. This helps prevent Unix users from accidentally |
| 703 | 703 | creating check-ins that are unreadable by Windows users. |
| 704 | - * Add the "re=" query parameter to the [/help?cmd=/dir|/dir] webpage, | |
| 705 | - for symmetry with the [/help?cmd=/tree|/tree] page. | |
| 704 | + * Add the "re=" query parameter to the [/help/www/dir|/dir] webpage, | |
| 705 | + for symmetry with the [/help/www/tree|/tree] page. | |
| 706 | 706 | * Update the built-in SQLite to version 3.35.0. |
| 707 | 707 | * The ./configure script now has the --print-minimum-sqlite-version option |
| 708 | 708 | that prints the minimum SQLite version required by the current version |
| 709 | 709 | of Fossil. This might be used by integrators who insist on building |
| 710 | 710 | Fossil to link against the system SQLite library rather than the |
| 711 | 711 | built-in copy of SQLite, to verify that their system SQLite library |
| 712 | 712 | is recent enough. |
| 713 | - * Webpage that shows [/help?cmd=/whistory|history of a wiki page] | |
| 713 | + * Webpage that shows [/help/www/whistory|history of a wiki page] | |
| 714 | 714 | gained client-side UI to help with comparison between two arbitrary |
| 715 | 715 | versions of a wiki (by the means of anchoring a "baseline" version) |
| 716 | 716 | and the ability to squeeze several sequential edits made by the same |
| 717 | 717 | user into a single "recycled" row (the latest edit in that sequence). |
| 718 | 718 | |
| @@ -732,40 +732,40 @@ | ||
| 732 | 732 | version 2.14 and then later downgrade or otherwise use an earlier |
| 733 | 733 | version of Fossil, the email notification mechanism may fail |
| 734 | 734 | to send out notifications for some events, due to the missing |
| 735 | 735 | trigger. If you want to |
| 736 | 736 | permanently downgrade an installation, then you should run |
| 737 | - "[/help?cmd=rebuild|fossil rebuild]" after the downgrade | |
| 737 | + "[/help/rebuild|fossil rebuild]" after the downgrade | |
| 738 | 738 | to get email notifications working again. If you are not using |
| 739 | 739 | email notification, then the schema change will not affect you in |
| 740 | 740 | any way. |
| 741 | 741 | * <b>Schema Update Notice #2:</b> |
| 742 | 742 | This release changes how the descriptions of wiki edits are stored |
| 743 | 743 | in the EVENT table, for improved display on timelines. You must |
| 744 | - run "[/help?cmd=rebuild|fossil rebuild]" to take advantage of | |
| 744 | + run "[/help/rebuild|fossil rebuild]" to take advantage of | |
| 745 | 745 | this enhancement. Everything will still work without |
| 746 | 746 | "fossil rebuild", except you will get goofy descriptions of |
| 747 | 747 | wiki updates in the timeline. |
| 748 | 748 | * Add support for [./chat.md|Fossil chat]. |
| 749 | - * The "[/help?cmd=clone|fossil clone]" command is enhanced so that | |
| 749 | + * The "[/help/clone|fossil clone]" command is enhanced so that | |
| 750 | 750 | if the repository filename is omitted, an appropriate name is derived |
| 751 | 751 | from the remote URL and the newly cloned repo is opened. This makes |
| 752 | 752 | the clone command work more like Git, thus making it easier for |
| 753 | 753 | people transitioning from Git. |
| 754 | - * Added the --mainbranch option to the [/help?cmd=git|fossil git export] | |
| 754 | + * Added the --mainbranch option to the [/help/git|fossil git export] | |
| 755 | 755 | command. |
| 756 | 756 | * Added the --format option to the |
| 757 | - "[/help?cmd=timeline|fossil timeline]" command. | |
| 757 | + "[/help/timeline|fossil timeline]" command. | |
| 758 | 758 | * Enhance the --numstat option on the |
| 759 | - "[/help?cmd=diff|fossil diff]" command so that it shows a total | |
| 759 | + "[/help/diff|fossil diff]" command so that it shows a total | |
| 760 | 760 | number of lines added and deleted and total number of files |
| 761 | 761 | modified. |
| 762 | - * Add the "contact" sub-command to [/help?cmd=user|fossil user]. | |
| 763 | - * Added commands "[/help?cmd=all|fossil all git export]" and | |
| 764 | - "[/help?cmd=all|fossil all git status]". | |
| 762 | + * Add the "contact" sub-command to [/help/user|fossil user]. | |
| 763 | + * Added commands "[/help/all|fossil all git export]" and | |
| 764 | + "[/help/all|fossil all git status]". | |
| 765 | 765 | * Added the "df=CHECKIN" query parameter to the |
| 766 | - [/help?cmd=/timeline|/timeline page]. | |
| 766 | + [/help/www/timeline|/timeline page]. | |
| 767 | 767 | * Improvements to the "[/sitemap]" page. Add subpages |
| 768 | 768 | [/sitemap-timeline] and [/sitemap-test]. |
| 769 | 769 | * Better text position in cylinder objects of Pikchr diagrams. |
| 770 | 770 | * New "details.txt" settings available to custom skins to better control |
| 771 | 771 | the rendering of Pikchr diagrams: |
| @@ -787,24 +787,24 @@ | ||
| 787 | 787 | * Added support for [./interwiki.md|interwiki links]. |
| 788 | 788 | * Enable <del> and <ins> markup in wiki. |
| 789 | 789 | * Improvements to the Forum threading display. |
| 790 | 790 | * Added support for embedding [./pikchr.md|pikchr] |
| 791 | 791 | markup in markdown and fossil-wiki content. |
| 792 | - * The new "[/help?cmd=pikchr|pikchr]" command can render | |
| 792 | + * The new "[/help/pikchr|pikchr]" command can render | |
| 793 | 793 | pikchr scripts, optionally pre-processed with |
| 794 | 794 | [/doc/trunk/www/th1.md|TH1] blocks and variables exactly like |
| 795 | 795 | site skins are. |
| 796 | - * The new [/help?cmd=/pikchrshow|pikchrshow] page provides an | |
| 796 | + * The new [/help/www/pikchrshow|pikchrshow] page provides an | |
| 797 | 797 | editor and previewer for pikchr markup. |
| 798 | - * In [/help?cmd=/wikiedit|/wikiedit] and | |
| 799 | - [/help?cmd=/fileedit|/fileedit], Ctrl-Enter can now be used | |
| 798 | + * In [/help/www/wikiedit|/wikiedit] and | |
| 799 | + [/help/www/fileedit|/fileedit], Ctrl-Enter can now be used | |
| 800 | 800 | initiate a preview and to toggle between the editor and preview |
| 801 | 801 | tabs. |
| 802 | 802 | * The <tt>/artifact</tt> and <tt>/file</tt> views, when in |
| 803 | 803 | line-number mode, now support interactive selection of a range |
| 804 | 804 | of lines to hyperlink to. |
| 805 | - * Enhance the [/help?cmd=/finfo|/finfo] webpage so that when query | |
| 805 | + * Enhance the [/help/www/finfo|/finfo] webpage so that when query | |
| 806 | 806 | parameters identify both a filename and a checkin, the resulting |
| 807 | 807 | graph tracks the identified file across renames. |
| 808 | 808 | * The built-in SQLite is updated to an alpha of version 3.34.0, and |
| 809 | 809 | the minimum SQLite version is increased to 3.34.0 because the |
| 810 | 810 | /finfo change in the previous bullet depends on enhancements to |
| @@ -813,18 +813,18 @@ | ||
| 813 | 813 | * Countless other minor refinements and documentation improvements. |
| 814 | 814 | |
| 815 | 815 | <h2 id='v2_12'>Changes for Version 2.12.1 (2020-08-20)</h2> |
| 816 | 816 | |
| 817 | 817 | * (2.12.1): Fix client-side vulnerabilities discovered by Max Justicz. |
| 818 | - * Security fix in the "[/help?cmd=git|fossil git export]" command. | |
| 818 | + * Security fix in the "[/help/git|fossil git export]" command. | |
| 819 | 819 | The same fix is also backported to version 2.10.1 and 2.11.1. |
| 820 | 820 | New "safety-net" features were added to prevent similar problems |
| 821 | 821 | in the future. |
| 822 | 822 | * Enhancements to the graph display for cases when there are |
| 823 | 823 | many cherry-pick merges into a single check-in. |
| 824 | 824 | [/timeline?f=2d75e87b760c0a9|Example] |
| 825 | - * Enhance the [/help?cmd=open|fossil open] command with the new | |
| 825 | + * Enhance the [/help/open|fossil open] command with the new | |
| 826 | 826 | --workdir option and the ability to accept a URL as the repository |
| 827 | 827 | name, causing the remote repository to be cloned automatically. |
| 828 | 828 | Do not allow "fossil open" to open in a non-empty working directory |
| 829 | 829 | unless the --keep option or the new --force option is used. |
| 830 | 830 | * Enhance the markdown formatter to more closely follow the |
| @@ -833,65 +833,65 @@ | ||
| 833 | 833 | Underscores in the middle of identifiers (ex: fossil_printf()) |
| 834 | 834 | no longer need to be escaped. |
| 835 | 835 | * The markdown-to-html translator can prevent unsafe HTML |
| 836 | 836 | (for example: <script>) on user-contributed pages like forum and |
| 837 | 837 | tickets and wiki. The admin can adjust this behavior using |
| 838 | - the [/help?cmd=safe-html|safe-html setting] on the Admin/Wiki page. | |
| 838 | + the [/help/safe-html|safe-html setting] on the Admin/Wiki page. | |
| 839 | 839 | The default is to disallow unsafe HTML everywhere. |
| 840 | 840 | [https://fossil-scm.org/forum/forumpost/3714e6568f|Example]. |
| 841 | 841 | * Added the "collapse" and "expand" capability for long forum posts. |
| 842 | 842 | [https://fossil-scm.org/forum/forumpost/9297029862|Example] |
| 843 | - * The "[/help?cmd=remote-url|fossil remote]" command now has options for | |
| 843 | + * The "[/help/remote-url|fossil remote]" command now has options for | |
| 844 | 844 | specifying multiple persistent remotes with symbolic names. Currently |
| 845 | 845 | only one remote can be used at a time, but that might change in the |
| 846 | 846 | future. |
| 847 | 847 | * Add the "Remember me?" checkbox on the login page. Use a session |
| 848 | 848 | cookie for the login if it is not checked. |
| 849 | - * Added the experimental "[/help?cmd=hook|fossil hook]" command for | |
| 849 | + * Added the experimental "[/help/hook|fossil hook]" command for | |
| 850 | 850 | managing "hook scripts" that run before checkin or after a push. |
| 851 | - * Enhance the [/help?cmd=revert|fossil revert] command so that it | |
| 851 | + * Enhance the [/help/revert|fossil revert] command so that it | |
| 852 | 852 | is able to revert all files beneath a directory. |
| 853 | - * Add the [/help?cmd=bisect|fossil bisect skip] command. | |
| 854 | - * Add the [/help?cmd=backup|fossil backup] command. | |
| 855 | - * Enhance [/help?cmd=bisect|fossil bisect ui] so that it shows all unchecked | |
| 853 | + * Add the [/help/bisect|fossil bisect skip] command. | |
| 854 | + * Add the [/help/backup|fossil backup] command. | |
| 855 | + * Enhance [/help/bisect|fossil bisect ui] so that it shows all unchecked | |
| 856 | 856 | check-ins in between the innermost "good" and "bad" check-ins. |
| 857 | - * Added the <tt>--reset</tt> flag to the "[/help?cmd=add|fossil add]", | |
| 858 | - "[/help?cmd=rm|fossil rm]", and | |
| 859 | - "[/help?cmd=addremove|fossil addremove]" commands. | |
| 857 | + * Added the <tt>--reset</tt> flag to the "[/help/add|fossil add]", | |
| 858 | + "[/help/rm|fossil rm]", and | |
| 859 | + "[/help/addremove|fossil addremove]" commands. | |
| 860 | 860 | * Added the "<tt>--min</tt> <i>N</i>" and "<tt>--logfile</tt> <i>FILENAME</i>" |
| 861 | - flags to the [/help?cmd=backoffice|backoffice] command, as well as other | |
| 861 | + flags to the [/help/backoffice|backoffice] command, as well as other | |
| 862 | 862 | enhancements to make the backoffice command a viable replacement for |
| 863 | 863 | automatic backoffice. Other incremental backoffice improvements. |
| 864 | - * Added the [/help?cmd=/fileedit|/fileedit page], which allows | |
| 864 | + * Added the [/help/www/fileedit|/fileedit page], which allows | |
| 865 | 865 | editing of text files online. Requires explicit activation by |
| 866 | 866 | a setup user. |
| 867 | 867 | * Translate built-in help text into HTML for display on web pages. |
| 868 | - [/help?cmd=help|Example]. | |
| 869 | - * On the [/help?cmd=/timeline|/timeline] webpage, the combination | |
| 868 | + [/help/help|Example]. | |
| 869 | + * On the [/help/www/timeline|/timeline] webpage, the combination | |
| 870 | 870 | of query parameters "p=CHECKIN" and "bt=ANCESTOR" draws all |
| 871 | 871 | ancestors of CHECKIN going back to ANCESTOR. For example, |
| 872 | 872 | [/timeline?p=202006271506&bt=version-2.11] shows all ancestors |
| 873 | 873 | of the checkin that occurred on 2020-06-27 15:06 going back to |
| 874 | 874 | the 2.11 release. |
| 875 | 875 | * Update the built-in SQLite so that the |
| 876 | - "[/help?cmd=sql|fossil sql]" command supports new output | |
| 876 | + "[/help/sql|fossil sql]" command supports new output | |
| 877 | 877 | modes ".mode box" and ".mode json". |
| 878 | 878 | * Add the "<tt>obscure()</tt>" SQL function to the |
| 879 | - "[/help?cmd=sql|fossil sql]" command. | |
| 879 | + "[/help/sql|fossil sql]" command. | |
| 880 | 880 | * Added virtual tables "<tt>helptext</tt>" and "<tt>builtin</tt>" to |
| 881 | - the "[/help?cmd=sql|fossil sql]" command, providing access to the | |
| 881 | + the "[/help/sql|fossil sql]" command, providing access to the | |
| 882 | 882 | dispatch table including all help text, and the builtin data files, |
| 883 | 883 | respectively. |
| 884 | 884 | * [./delta_format.wiki|Delta compression] is now applied to forum edits. |
| 885 | - * The [/help?cmd=/wikiedit|wiki editor] has been modernized and is | |
| 885 | + * The [/help/www/wikiedit|wiki editor] has been modernized and is | |
| 886 | 886 | now Ajax-based. The WYSIWYG editing option for Fossil-format wiki |
| 887 | 887 | pages was removed. (Please let us know, via the site's Forum menu, |
| 888 | 888 | if that removal unduly impacts you.) This also changes the semantics |
| 889 | 889 | of the wiki "Sandbox": that pseudo-page may be freely edited but |
| 890 | - no longer saved via the UI (the [/help?cmd=wiki|wiki CLI command] | |
| 890 | + no longer saved via the UI (the [/help/wiki|wiki CLI command] | |
| 891 | 891 | can, though). |
| 892 | - * The [/help?cmd=allow-symlinks|allow-symlinks setting] no longer | |
| 892 | + * The [/help/allow-symlinks|allow-symlinks setting] no longer | |
| 893 | 893 | syncs. It must be activated individually on any clones which require |
| 894 | 894 | symlinks. |
| 895 | 895 | * Countless documentation enhancements. |
| 896 | 896 | |
| 897 | 897 | <h2 id='v2_11'>Changes for Version 2.11 (2020-05-25)</h2> |
| @@ -903,46 +903,46 @@ | ||
| 903 | 903 | can now omit punctation. So, for example, "202004181942" and |
| 904 | 904 | "2020-04-18 19:42" mean the same thing. |
| 905 | 905 | * Enhance backlink processing so that it works with Markdown-formatted |
| 906 | 906 | tickets and so that it works for wiki pages. |
| 907 | 907 | Ticket [a3572c6a5b47cd5a]. |
| 908 | - <ul><li> "[/help?cmd=rebuild|fossil rebuild]" is needed to | |
| 908 | + <ul><li> "[/help/rebuild|fossil rebuild]" is needed to | |
| 909 | 909 | take full advantage of this fix. Fossil will continue |
| 910 | 910 | to work without the rebuild, but the new backlinks will be missing.</ul> |
| 911 | 911 | * The algorithm for finding the |
| 912 | 912 | [./tech_overview.wiki#configloc|location of the configuration database] |
| 913 | 913 | is enhanced to be XDG-compliant. |
| 914 | 914 | * Add a hide/show feature to |
| 915 | 915 | [./wikitheory.wiki#assocwiki|associated wiki] display on |
| 916 | 916 | check-in and branch information pages. |
| 917 | - * Enhance the "[/help?cmd=info|fossil info]" command so that it | |
| 917 | + * Enhance the "[/help/info|fossil info]" command so that it | |
| 918 | 918 | works with no arguments even if not within an open check-out. |
| 919 | 919 | * Many improvements to the forum and especially email notification |
| 920 | 920 | of forum posts, in response to community feedback after switching |
| 921 | 921 | SQLite support from a mailing list over to the forum. |
| 922 | 922 | * Minimum length of a self-registered user ID increased from 3 to 6 |
| 923 | 923 | characters. |
| 924 | 924 | * When the "vfx" query parameter is used on the |
| 925 | - "[/help?cmd=/timeline|/timeline]" page, it causes the complete | |
| 925 | + "[/help/www/timeline|/timeline]" page, it causes the complete | |
| 926 | 926 | text of forum posts to be displayed. |
| 927 | - * Rework the "[/help?cmd=grep|fossil grep]" command to be more useful. | |
| 928 | - * Expose the [/help?cmd=redirect-to-https|redirect-to-https] | |
| 929 | - setting to the [/help?cmd=settings|settings] command. | |
| 927 | + * Rework the "[/help/grep|fossil grep]" command to be more useful. | |
| 928 | + * Expose the [/help/redirect-to-https|redirect-to-https] | |
| 929 | + setting to the [/help/settings|settings] command. | |
| 930 | 930 | * Improve support for CGI on IIS web servers. |
| 931 | 931 | * The [./serverext.wiki|/ext page] can now render index files, |
| 932 | 932 | in the same way as the embedded docs. |
| 933 | 933 | * Most commands now support the Unix-conventional "<tt>--</tt>" |
| 934 | 934 | flag to treat all following arguments as filenames |
| 935 | 935 | instead of flags. |
| 936 | - * Added the [/help?cmd=mimetypes|mimetypes config setting] | |
| 936 | + * Added the [/help/mimetypes|mimetypes config setting] | |
| 937 | 937 | (versionable) to enable mimetype overrides and custom definitions. |
| 938 | 938 | * Add an option on the /Admin/Timeline setup page to set a default |
| 939 | 939 | timeline style other than "Modern". |
| 940 | 940 | * In [./embeddeddoc.wiki|embedded documentation], hyperlink URLs |
| 941 | 941 | of the form "/doc/$CURRENT/..." the "$CURRENT" text is translated |
| 942 | 942 | into the check-in hash for the document currently being viewed. |
| 943 | - * Added the [/help?cmd=/phantoms|/phantoms] webpage that shows all | |
| 943 | + * Added the [/help/www/phantoms|/phantoms] webpage that shows all | |
| 944 | 944 | phantom artifacts. |
| 945 | 945 | * Enhancements to phantom processing to try to reduce |
| 946 | 946 | bandwidth-using chatter about phantoms on the sync protocol. |
| 947 | 947 | * Security: Fossil now assumes that the schema of every |
| 948 | 948 | database it opens has been tampered with by an adversary and takes |
| @@ -950,23 +950,23 @@ | ||
| 950 | 950 | * Security: Fossil now puts the Content-Security-Policy in the |
| 951 | 951 | HTTP reply header, in addition to also leaving it in the |
| 952 | 952 | HTML <head> section, so that it is always available, even |
| 953 | 953 | if a custom skin overrides the HTML <head> and omits |
| 954 | 954 | the CSP in the process. |
| 955 | - * Output of the [/help?cmd=diff|fossil diff -y] command automatically | |
| 955 | + * Output of the [/help/diff|fossil diff -y] command automatically | |
| 956 | 956 | adjusts according to the terminal width. |
| 957 | 957 | * The Content-Security-Policy is now set using the |
| 958 | - [/help?cmd=default-csp|default-csp setting]. | |
| 959 | - * Merge conflicts caused via the [/help?cmd=merge|merge] and | |
| 960 | - [/help?cmd=update|update] commands no longer leave temporary | |
| 958 | + [/help/default-csp|default-csp setting]. | |
| 959 | + * Merge conflicts caused via the [/help/merge|merge] and | |
| 960 | + [/help/update|update] commands no longer leave temporary | |
| 961 | 961 | files behind unless the new <tt>--keep-merge-files</tt> flag |
| 962 | 962 | is used. |
| 963 | - * The [/help?cmd=/artifact_stats|/artifact_stats page] is now accessible | |
| 963 | + * The [/help/www/artifact_stats|/artifact_stats page] is now accessible | |
| 964 | 964 | to all users if the new "artifact_stats_enable" setting is turned |
| 965 | 965 | on. There is a new checkbox under the /Admin/Access menu to turn |
| 966 | 966 | that capability on and off. |
| 967 | - * Add the [/help?cmd=tls-config|fossil tls-config] command for viewing | |
| 967 | + * Add the [/help/tls-config|fossil tls-config] command for viewing | |
| 968 | 968 | the TLS configuration and the list of SSL Cert exceptions. |
| 969 | 969 | * Captchas all include a button to read the captcha using an audio |
| 970 | 970 | file, so that they can be completed by the visually impaired. |
| 971 | 971 | * Stop using the IP address as part of the login cookie. |
| 972 | 972 | * Bug fix: fix the SSL cert validation logic so that if an exception |
| @@ -987,27 +987,27 @@ | ||
| 987 | 987 | <h2 id='v2_10'>Changes for Version 2.10 (2019-10-04)</h2> |
| 988 | 988 | |
| 989 | 989 | * (2.10.2): backport security fixes from 2.12.1 |
| 990 | 990 | * (2.10.1): backport security fix for the "fossil git export" command. |
| 991 | 991 | * Added support for [./serverext.wiki|CGI-based Server Extensions]. |
| 992 | - * Added the [/help?cmd=repolist-skin|repolist-skin] setting used to | |
| 992 | + * Added the [/help/repolist-skin|repolist-skin] setting used to | |
| 993 | 993 | add style to repository list pages. |
| 994 | 994 | * Enhance the hierarchical display of Forum threads to do less |
| 995 | 995 | indentation and to provide links back to the previous message |
| 996 | 996 | in the thread. Provide sequential numbers for all messages in |
| 997 | 997 | a forum thread. |
| 998 | 998 | * Add support for fenced code blocks and improved hyperlink |
| 999 | 999 | processing to the [/md_rules|markdown formatter]. |
| 1000 | 1000 | * Add support for hyperlinks to wiki pages in the |
| 1001 | 1001 | [/md_rules|markdown formatter]. |
| 1002 | - * Enhance the [/help?cmd=/stat|/stat] page so that it gives the | |
| 1002 | + * Enhance the [/help/www/stat|/stat] page so that it gives the | |
| 1003 | 1003 | option to show a breakdown of forum posts. |
| 1004 | 1004 | * The special check-in name "merge-in:BRANCH" means the source of |
| 1005 | 1005 | the most recent merge-in from the parent branch of BRANCH. |
| 1006 | 1006 | * Add hyperlinks to branch-diffs on the /info page and from |
| 1007 | 1007 | timelines of a branch. |
| 1008 | - * Add graphical context on the [/help?cmd=/vdiff|/vdiff] page. | |
| 1008 | + * Add graphical context on the [/help/www/vdiff|/vdiff] page. | |
| 1009 | 1009 | * Uppercase query parameters, POST parameters, and cookie names are |
| 1010 | 1010 | converted to all lowercase and entered into the parameter set, |
| 1011 | 1011 | instead of being discarded. |
| 1012 | 1012 | * Change the default [./hashpolicy.wiki|hash policy] to SHA3. |
| 1013 | 1013 | * Timeout [./server/any/cgi.md|CGI requests] after 300 seconds, or |
| @@ -1020,14 +1020,14 @@ | ||
| 1020 | 1020 | * Performance optimizations. |
| 1021 | 1021 | * Many documentation improvements. |
| 1022 | 1022 | |
| 1023 | 1023 | <h2 id='v2_9'>Changes for Version 2.9 (2019-07-13)</h2> |
| 1024 | 1024 | |
| 1025 | - * Added the [/help?cmd=git|fossil git export] command and instructions | |
| 1025 | + * Added the [/help/git|fossil git export] command and instructions | |
| 1026 | 1026 | for [./mirrortogithub.md|creating a GitHub mirror of a Fossil project]. |
| 1027 | 1027 | * Improved handling of relative hyperlinks on the |
| 1028 | - [/help?cmd=/artifact|/artifact] pages for wiki. For example, | |
| 1028 | + [/help/www/artifact|/artifact] pages for wiki. For example, | |
| 1029 | 1029 | hyperlinks and the lizard <img> now work correctly |
| 1030 | 1030 | for both [/artifact/2ff24ab0887cf522] and |
| 1031 | 1031 | [/doc/0d7ac90d575004c2415/www/index.wiki]. |
| 1032 | 1032 | * Enhancements to the timeline graph layout, to show more information |
| 1033 | 1033 | with less clutter. |
| @@ -1036,28 +1036,28 @@ | ||
| 1036 | 1036 | configuration. |
| 1037 | 1037 | * Copy buttons added to various check-in hash and branch name links. |
| 1038 | 1038 | * Double-clicking on a /timeline graph node now jumps to the /info page |
| 1039 | 1039 | for the check-in. So, repurpose the timestamp hyperlink to show all |
| 1040 | 1040 | activity around that check-in in time. |
| 1041 | - * Added the [/help?cmd=touch|fossil touch] command, and the --setmtime | |
| 1042 | - option on the [/help?cmd=open|fossil open] and | |
| 1043 | - [/help?cmd=update|fossil update] commands. | |
| 1041 | + * Added the [/help/touch|fossil touch] command, and the --setmtime | |
| 1042 | + option on the [/help/open|fossil open] and | |
| 1043 | + [/help/update|fossil update] commands. | |
| 1044 | 1044 | * Many documentation enhancements. |
| 1045 | - * For the "[/help?cmd=update|fossil update]" and | |
| 1046 | - "[/help?cmd=checkout|fossil checkout]" commands, if a | |
| 1045 | + * For the "[/help/update|fossil update]" and | |
| 1046 | + "[/help/checkout|fossil checkout]" commands, if a | |
| 1047 | 1047 | managed file is removed because it is no longer part of the target |
| 1048 | 1048 | check-in and the directory containing the file is empty after the |
| 1049 | 1049 | file is removed and the directory is not the current working |
| 1050 | - directory and is not on the [/help?cmd=empty-dirs|empty-dirs] | |
| 1050 | + directory and is not on the [/help/empty-dirs|empty-dirs] | |
| 1051 | 1051 | list, then also remove the directory. |
| 1052 | 1052 | * Update internal Unicode character tables, used in regular expression |
| 1053 | 1053 | handling, from version 11.0 to 12.1. |
| 1054 | - * In "[/help?cmd=regexp|fossil regexp]", "[/help?cmd=grep|fossil grep]" | |
| 1054 | + * In "[/help/regexp|fossil regexp]", "[/help/grep|fossil grep]" | |
| 1055 | 1055 | and the TH1 "regexp" command, the -nocase option now removes multiple |
| 1056 | 1056 | diacritics from the same character (derived from SQLite's |
| 1057 | 1057 | remove_diacritics=2) |
| 1058 | - * Added the [/help?cmd=/secureraw|/secureraw] page that requires the | |
| 1058 | + * Added the [/help/www/secureraw|/secureraw] page that requires the | |
| 1059 | 1059 | complete SHA1 or SHA3 hash, not just a prefix, before it will deliver |
| 1060 | 1060 | content. |
| 1061 | 1061 | * Accept purely numeric ISO8601 date/time strings as long as they |
| 1062 | 1062 | do not conflict with a hash. Example: "20190510134217" instead of |
| 1063 | 1063 | "2019-05-10 13:42:17". This helps keep URLs shorter and less |
| @@ -1070,19 +1070,19 @@ | ||
| 1070 | 1070 | extra path element is not needed. |
| 1071 | 1071 | * If an automatic sync gets a permanent redirect request, then update |
| 1072 | 1072 | the saved remote URL to the new address. |
| 1073 | 1073 | * Temporary filenames (for example used for external "diff" commands) |
| 1074 | 1074 | try to preserve the suffix of the original file. |
| 1075 | - * Added the [/help?cmd=/thisdayinhistory|/thisdayinhistory] web page. | |
| 1076 | - * Enhanced parsing of [/help?cmd=/timeline|/timeline] query parameters | |
| 1075 | + * Added the [/help/www/thisdayinhistory|/thisdayinhistory] web page. | |
| 1076 | + * Enhanced parsing of [/help/www/timeline|/timeline] query parameters | |
| 1077 | 1077 | "ymd=", "ym=", and "yw=". All arguments are option (in which case they |
| 1078 | 1078 | default to the current time) and all accept ISO8601 date/times without |
| 1079 | 1079 | punctuation. |
| 1080 | 1080 | * Automatically disapprove pending moderation requests for a user when |
| 1081 | 1081 | that user is deleted. This helps in dealing with spam-bots. |
| 1082 | 1082 | * Improvements to the "Capability Summary" section in the |
| 1083 | - [/help?cmd=/secaudit0|Security Audit] web-page. | |
| 1083 | + [/help/www/secaudit0|Security Audit] web-page. | |
| 1084 | 1084 | * Use new "ci-lock" and "ci-lock-failed" pragmas in the |
| 1085 | 1085 | [./sync.wiki|sync protocol] to try to prevent accident forks |
| 1086 | 1086 | caused by concurrent commits when operating in auto-sync mode. |
| 1087 | 1087 | * Fix a bug ([https://fossil-scm.org/forum/forumpost/c51b9a1169|details]) |
| 1088 | 1088 | that can cause repository databases to be overwritten with debugging |
| @@ -1183,11 +1183,11 @@ | ||
| 1183 | 1183 | included in the header or footer. |
| 1184 | 1184 | * Add the [./backoffice.md|backoffice]. |
| 1185 | 1185 | * Update internal Unicode character tables, used in regular expression |
| 1186 | 1186 | handling, from version 10.0 to 11.0. |
| 1187 | 1187 | * Improvements to the "Security Audit" administration page |
| 1188 | - * Add the [/help?cmd=branch|fossil branch current] command. | |
| 1188 | + * Add the [/help/branch|fossil branch current] command. | |
| 1189 | 1189 | * Add the [./grep.md|grep] command. |
| 1190 | 1190 | * Update the built-in SQLite to version 3.25.1. |
| 1191 | 1191 | * Some code and interfaces are in place to support sending and |
| 1192 | 1192 | receiving email directly via SMTP, but this feature is not yet |
| 1193 | 1193 | complete or ready for production use. |
| @@ -1206,20 +1206,20 @@ | ||
| 1206 | 1206 | same as "Verbose" in the previous release. The "Verbose" mode is |
| 1207 | 1207 | now like "Compact" except the extra check-in details are shown by |
| 1208 | 1208 | default. |
| 1209 | 1209 | * Add support for ETags:, Last-Modified:, and If-Modified-Since: |
| 1210 | 1210 | cache control mechanisms. |
| 1211 | - * Enhance the [/help?cmd=/tarball|/tarball], | |
| 1212 | - [/help?cmd=/zip|/zip], and | |
| 1213 | - [/help?cmd=/sqlar|/sqlar] pages so that the checkin | |
| 1211 | + * Enhance the [/help/www/tarball|/tarball], | |
| 1212 | + [/help/www/zip|/zip], and | |
| 1213 | + [/help/www/sqlar|/sqlar] pages so that the checkin | |
| 1214 | 1214 | name to be downloaded can be expressed as part of the URI, |
| 1215 | 1215 | and without the need for query parameters. |
| 1216 | - * On the [/help?cmd=/timeline|/timeline] webpage, add the days=N | |
| 1216 | + * On the [/help/www/timeline|/timeline] webpage, add the days=N | |
| 1217 | 1217 | query parameter and enhance the ymd=DATE and yw=DATE query parameters |
| 1218 | 1218 | to accept 'now' as an argument to show the latest day or week. |
| 1219 | 1219 | * In the web page that comes up in response to the |
| 1220 | - [/help?cmd=all|fossil all ui] command, show the last modification | |
| 1220 | + [/help/all|fossil all ui] command, show the last modification | |
| 1221 | 1221 | time for each repository, and allow click-to-sort on the modification |
| 1222 | 1222 | time column. |
| 1223 | 1223 | * In the tarball cache replacement algorithm, give extra weight to |
| 1224 | 1224 | tarballs that have been accessed more than once. |
| 1225 | 1225 | * Additional defenses against web-based attacks. There have not been |
| @@ -1266,35 +1266,35 @@ | ||
| 1266 | 1266 | to define their own URLs on the web interface that are rewritten to |
| 1267 | 1267 | built-in URLs with specific parameters. Create and configure URL Aliases |
| 1268 | 1268 | using the /Setup/URL_Aliases menu option in the web interface. |
| 1269 | 1269 | * Add tech-note search capability. |
| 1270 | 1270 | * Add the -r|--revision and -o|--origin options to the |
| 1271 | - [/help?cmd=annotate|annotate] command. | |
| 1272 | - * Add the origin= query parameter to the [/help?cmd=/annotate|/annotate] | |
| 1271 | + [/help/annotate|annotate] command. | |
| 1272 | + * Add the origin= query parameter to the [/help/www/annotate|/annotate] | |
| 1273 | 1273 | webpage. |
| 1274 | - * The [/help?cmd=annotate|fossil annotate] command and the | |
| 1275 | - [/help?cmd=/annotate|/annotate] web page go backwards in time as far | |
| 1274 | + * The [/help/annotate|fossil annotate] command and the | |
| 1275 | + [/help/www/annotate|/annotate] web page go backwards in time as far | |
| 1276 | 1276 | as can be computed in 30 milliseconds by default, rather than stopping |
| 1277 | 1277 | after 20 steps. The new limit= query parameter or the --limit command-line |
| 1278 | 1278 | option can be used to alter this timeout. |
| 1279 | 1279 | * Provide separate [/help#settings|on-line help screens for each setting]. |
| 1280 | 1280 | * Back out support for the --no-dir-symlinks option |
| 1281 | 1281 | * Remove support from the legacy configuration sync protocol. The only |
| 1282 | 1282 | way now to do a configuration push or pull is to use the new protocol that |
| 1283 | 1283 | was added in 2011. |
| 1284 | - * Add the from= and to= query parameters to [/help?cmd=/fdiff|/fdiff] | |
| 1284 | + * Add the from= and to= query parameters to [/help/www/fdiff|/fdiff] | |
| 1285 | 1285 | in order to get a diff of two files in the same check-in. |
| 1286 | 1286 | * Fix the "ssh://" protocol to prevent an attack whereby the attacker convinces |
| 1287 | 1287 | a victim to run a "clone" with a dodgy URL and thereby gains access to their |
| 1288 | 1288 | system. |
| 1289 | 1289 | * Provide a checkbox that will temporarily disable all ad-units. |
| 1290 | - * Improvements to the [/help?cmd=/stat|/stat] page | |
| 1291 | - * Various new hyperlinks to the [/help?cmd=/bloblist|/bloblist] | |
| 1292 | - and [/help?cmd=/bigbloblist|/bigbloblist] pages. | |
| 1293 | - * Correct the [/help?cmd=/doc|/doc] page to support read-only repositories. | |
| 1294 | - * Correct [/help?cmd=/zip|/zip], [/help?cmd=/tarball|/tarball], | |
| 1295 | - [/help?cmd=zip|zip], and [/help?cmd=tarball|tarball] pages and commands to | |
| 1290 | + * Improvements to the [/help/www/stat|/stat] page | |
| 1291 | + * Various new hyperlinks to the [/help/www/bloblist|/bloblist] | |
| 1292 | + and [/help/www/bigbloblist|/bigbloblist] pages. | |
| 1293 | + * Correct the [/help/www/doc|/doc] page to support read-only repositories. | |
| 1294 | + * Correct [/help/www/zip|/zip], [/help/www/tarball|/tarball], | |
| 1295 | + [/help/zip|zip], and [/help/tarball|tarball] pages and commands to | |
| 1296 | 1296 | honor the versioned manifest setting when outside of an open checkout |
| 1297 | 1297 | directory. |
| 1298 | 1298 | * The admin-log and access-log settings are now on by default for |
| 1299 | 1299 | new repositories. |
| 1300 | 1300 | * Update the built-in SQLite to version 3.21.0. |
| @@ -1302,34 +1302,34 @@ | ||
| 1302 | 1302 | <h2 id='v2_3'>Changes for Version 2.3 (2017-07-21)</h2> |
| 1303 | 1303 | |
| 1304 | 1304 | * Update the built-in SQLite to version 3.20.0 (beta). |
| 1305 | 1305 | * Update internal Unicode character tables, used in regular expression |
| 1306 | 1306 | handling, from version 9.0 to 10.0. |
| 1307 | - * Show the last-sync-URL on the [/help?cmd=/urllist|/urllist] page. | |
| 1307 | + * Show the last-sync-URL on the [/help/www/urllist|/urllist] page. | |
| 1308 | 1308 | * Added the "Event Summary" activity report. |
| 1309 | 1309 | [/reports?type=ci&view=lastchng|example] |
| 1310 | 1310 | * Added the "Security Audit" page, available to administrators only |
| 1311 | 1311 | * Added the Last Login time to the user list page, for administrators only |
| 1312 | - * Added the --numstat option to the [/help?cmd=diff|fossil diff] command | |
| 1312 | + * Added the --numstat option to the [/help/diff|fossil diff] command | |
| 1313 | 1313 | * Limit the size of the heap and stack on unix systems, as a proactive |
| 1314 | 1314 | defense against the |
| 1315 | 1315 | [https://www.qualys.com/2017/06/19/stack-clash/stack-clash.txt|Stack Clash] |
| 1316 | 1316 | attack. |
| 1317 | 1317 | * Fix "database locked" warnings caused by "PRAGMA optimize". |
| 1318 | 1318 | * Fix a potential XSS vulnerability on the |
| 1319 | - [/help?cmd=/help|/help] webpage. | |
| 1319 | + [/help/www/help|/help] webpage. | |
| 1320 | 1320 | * Documentation updates |
| 1321 | 1321 | |
| 1322 | 1322 | <h2 id='v2_2'>Changes for Version 2.2 (2017-04-11)</h2> |
| 1323 | 1323 | |
| 1324 | 1324 | * GIT comment tags are now handled by Fossil during import/export. |
| 1325 | 1325 | * Show the content of README files on directory listings. |
| 1326 | 1326 | ([/file/skins|example]) |
| 1327 | 1327 | * Support for Basic Authentication if enabled (default off). |
| 1328 | 1328 | * Show the hash algorithms used on the |
| 1329 | - [/help?cmd=/rcvfromlist|/rcvfromlist] page. | |
| 1330 | - * The [/help?cmd=/tarball|/tarball] and [/help?cmd=/zip|/zip] pages | |
| 1329 | + [/help/www/rcvfromlist|/rcvfromlist] page. | |
| 1330 | + * The [/help/www/tarball|/tarball] and [/help/www/zip|/zip] pages | |
| 1331 | 1331 | now use the the r= query parameter |
| 1332 | 1332 | to select which check-in to deliver. The uuid= query parameter |
| 1333 | 1333 | is still accepted for backwards compatibility. |
| 1334 | 1334 | * Update the built-in SQLite to version 3.18.0. |
| 1335 | 1335 | * Run "[https://www.sqlite.org/pragma.html#pragma_optimize|PRAGMA optimize]" |
| @@ -1338,12 +1338,12 @@ | ||
| 1338 | 1338 | <h2 id='v2_1'>Changes for Version 2.1 (2017-03-10)</h2> |
| 1339 | 1339 | |
| 1340 | 1340 | * Add support for [./hashpolicy.wiki|hash policies] that control which |
| 1341 | 1341 | of the Hardened-SHA1 or SHA3-256 algorithms is used to name new |
| 1342 | 1342 | artifacts. |
| 1343 | - * Add the "gshow" and "gcat" subcommands to [/help?cmd=stash|fossil stash]. | |
| 1344 | - * Add the [/help?cmd=/juvlist|/juvlist] web page and use it to construct | |
| 1343 | + * Add the "gshow" and "gcat" subcommands to [/help/stash|fossil stash]. | |
| 1344 | + * Add the [/help/www/juvlist|/juvlist] web page and use it to construct | |
| 1345 | 1345 | the [/uv/download.html|Download Page] of the Fossil self-hosting website |
| 1346 | 1346 | using Ajax. |
| 1347 | 1347 | |
| 1348 | 1348 | <h2 id='v2_0'>Changes for Version 2.0 (2017-03-03)</h2> |
| 1349 | 1349 | |
| @@ -1351,23 +1351,23 @@ | ||
| 1351 | 1351 | [https://github.com/cr-marcstevens/sha1collisiondetection|hardened SHA1] |
| 1352 | 1352 | implementation by Marc Stevens and Dan Shumow. |
| 1353 | 1353 | * Add the ability to read and understand |
| 1354 | 1354 | [./fileformat.wiki#names|artifact names] that are based on SHA3-256 |
| 1355 | 1355 | rather than SHA1, but do not actually generate any such names. |
| 1356 | - * Added the [/help?cmd=sha3sum|sha3sum] command. | |
| 1356 | + * Added the [/help/sha3sum|sha3sum] command. | |
| 1357 | 1357 | * Update the built-in SQLite to version 3.17.0. |
| 1358 | 1358 | |
| 1359 | 1359 | <h2 id='v1_37'>Changes for Version 1.37 (2017-01-16)</h2> |
| 1360 | 1360 | |
| 1361 | 1361 | * Add checkbox widgets to various web pages. See [/technote/8d18bf27e9| |
| 1362 | 1362 | this technote] for more information. To get the checkboxes to look as |
| 1363 | 1363 | intended, you must update the CSS in your repository and all clones. |
| 1364 | 1364 | * Add the [/help/all|fossil all ui] command |
| 1365 | - * Add the [/help?cmd=/file|/file] webpage | |
| 1366 | - * Enhance the [/help?cmd=/brlist|/brlist] webpage to make use of branch colors. | |
| 1365 | + * Add the [/help/www/file|/file] webpage | |
| 1366 | + * Enhance the [/help/www/brlist|/brlist] webpage to make use of branch colors. | |
| 1367 | 1367 | * Add support for the ms=EXACT|LIKE|GLOB|REGEXP query parameter on the |
| 1368 | - [/help?cmd=/timeline|/timeline] webpage, with associated form widgets. | |
| 1368 | + [/help/www/timeline|/timeline] webpage, with associated form widgets. | |
| 1369 | 1369 | * Enhance the [/help/changes|changes] and [/help/status|status] commands |
| 1370 | 1370 | with many new filter options so that specific kinds of changes can be |
| 1371 | 1371 | found without having to pipe through grep or sed. |
| 1372 | 1372 | * Enhanced the [/help/sqlite3|fossil sql] command so that it opens the |
| 1373 | 1373 | [./tech_overview.wiki#localdb|checkout database] and the |
| @@ -1380,11 +1380,11 @@ | ||
| 1380 | 1380 | </ul> |
| 1381 | 1381 | * Rename crnl-glob [/help/settings|setting] to crlf-glob, but keep |
| 1382 | 1382 | crnl-glob as a compatibility alias. |
| 1383 | 1383 | * Added the --command option to the [/help/diff|diff] command. |
| 1384 | 1384 | * Fix a C99-ism that prevents the 1.36 release from building with MSVC. |
| 1385 | - * Fix [/help?cmd=ticket|ticket set] when using the "+" prefix with fields | |
| 1385 | + * Fix [/help/ticket|ticket set] when using the "+" prefix with fields | |
| 1386 | 1386 | from the "ticketchng" table. |
| 1387 | 1387 | * Remove the "fusefs" command from builds that do not have the underlying |
| 1388 | 1388 | support enabled. |
| 1389 | 1389 | * Fixes for incremental git import/export. |
| 1390 | 1390 | * Minor security enhancements to |
| @@ -1394,58 +1394,58 @@ | ||
| 1394 | 1394 | |
| 1395 | 1395 | |
| 1396 | 1396 | <h2 id='v1_36'>Changes for Version 1.36 (2016-10-24)</h2> |
| 1397 | 1397 | |
| 1398 | 1398 | * Add support for [./unvers.wiki|unversioned content], |
| 1399 | - the [/help?cmd=unversioned|fossil unversioned] command and the | |
| 1400 | - [/help?cmd=/uv|/uv] and [/uvlist] web pages. | |
| 1399 | + the [/help/unversioned|fossil unversioned] command and the | |
| 1400 | + [/help/www/uv|/uv] and [/uvlist] web pages. | |
| 1401 | 1401 | * The [/uv/download.html|download page] is moved into |
| 1402 | 1402 | [./unvers.wiki|unversioned content] so that the self-hosting Fossil |
| 1403 | 1403 | websites no longer uses any external content. |
| 1404 | 1404 | * Added the "Search" button to the graphical diff generated by |
| 1405 | - the --tk option on the [/help?cmd=diff|diff] command. | |
| 1405 | + the --tk option on the [/help/diff|diff] command. | |
| 1406 | 1406 | * Added the "--checkin VERSION" option to the |
| 1407 | - [/help?cmd=diff|diff] command. | |
| 1408 | - * Various performance enhancements to the [/help?cmd=diff|diff] command. | |
| 1407 | + [/help/diff|diff] command. | |
| 1408 | + * Various performance enhancements to the [/help/diff|diff] command. | |
| 1409 | 1409 | * Update internal Unicode character tables, used in regular expression |
| 1410 | 1410 | handling, from version 8.0 to 9.0. |
| 1411 | 1411 | * Update the built-in SQLite to version 3.15. Fossil now requires |
| 1412 | 1412 | the SQLITE_DBCONFIG_MAINDBNAME interface of SQLite which is only available |
| 1413 | 1413 | in SQLite version 3.15 and later and so Fossil will not work with |
| 1414 | 1414 | earlier SQLite versions. |
| 1415 | 1415 | * Fix [https://www.mail-archive.com/[email protected]/msg23618.html|multi-line timeline bug] |
| 1416 | - * Enhance the [/help?cmd=purge|fossil purge] command. | |
| 1417 | - * New command [/help?cmd=shell|fossil shell]. | |
| 1416 | + * Enhance the [/help/purge|fossil purge] command. | |
| 1417 | + * New command [/help/shell|fossil shell]. | |
| 1418 | 1418 | * SQL parameters whose names are all lower-case in Ticket Report SQL |
| 1419 | 1419 | queries are filled in using HTTP query parameter values. |
| 1420 | 1420 | * Added support for [./childprojects.wiki|child projects] that are |
| 1421 | 1421 | able to pull from their parent but not push. |
| 1422 | 1422 | * Added the -nocomplain option to the TH1 "query" command. |
| 1423 | 1423 | * Added support for the chng=GLOBLIST query parameter on the |
| 1424 | - [/help?cmd=/timeline|/timeline] webpage. | |
| 1424 | + [/help/www/timeline|/timeline] webpage. | |
| 1425 | 1425 | |
| 1426 | 1426 | <h2 id='v1_35'>Changes for Version 1.35 (2016-06-14)</h2> |
| 1427 | 1427 | |
| 1428 | 1428 | * Enable symlinks by default on all non-Windows platforms. |
| 1429 | 1429 | * Enhance the [/md_rules|Markdown formatting] so that hyperlinks that begin |
| 1430 | 1430 | with "/" are relative to the root of the Fossil repository. |
| 1431 | - * Rework the [/help?cmd=/setup_ulist|/setup_list page] (the User List page) | |
| 1431 | + * Rework the [/help/www/setup_ulist|/setup_list page] (the User List page) | |
| 1432 | 1432 | to display all users in a click-to-sort table. |
| 1433 | 1433 | * Fix backslash-octal escape on filenames while importing from git |
| 1434 | 1434 | * When markdown documents begin with <h1> HTML elements, use that |
| 1435 | 1435 | header at the document title. |
| 1436 | - * Added the [/help?cmd=/bigbloblist|/bigbloblist page]. | |
| 1437 | - * Enhance the [/help?cmd=/finfo|/finfo page] so that when it is showing | |
| 1436 | + * Added the [/help/www/bigbloblist|/bigbloblist page]. | |
| 1437 | + * Enhance the [/help/www/finfo|/finfo page] so that when it is showing | |
| 1438 | 1438 | the ancestors of a particular file version, it only shows direct |
| 1439 | 1439 | ancestors and omits changes on branches, thus making it show the same set |
| 1440 | - of ancestors that are used for [/help?cmd=/blame|/blame]. | |
| 1441 | - * Added the --page option to the [/help?cmd=ui|fossil ui] command | |
| 1442 | - * Added the [/help?cmd=bisect|fossil bisect ui] command | |
| 1443 | - * Enhanced the [/help?cmd=diff|fossil diff] command so that it accepts | |
| 1440 | + of ancestors that are used for [/help/www/blame|/blame]. | |
| 1441 | + * Added the --page option to the [/help/ui|fossil ui] command | |
| 1442 | + * Added the [/help/bisect|fossil bisect ui] command | |
| 1443 | + * Enhanced the [/help/diff|fossil diff] command so that it accepts | |
| 1444 | 1444 | directory names as arguments and computes diffs on all files contained |
| 1445 | 1445 | within those directories. |
| 1446 | - * Fix the [/help?cmd=add|fossil add] command so that it shows "SKIP" for | |
| 1446 | + * Fix the [/help/add|fossil add] command so that it shows "SKIP" for | |
| 1447 | 1447 | files added that were already under management. |
| 1448 | 1448 | * TH1 enhancements: |
| 1449 | 1449 | <ul><li>Add <nowiki>[array exists]</nowiki> command.</li> |
| 1450 | 1450 | <li>Add minimal <nowiki>[array names]</nowiki> command.</li> |
| 1451 | 1451 | <li>Add tcl_platform(engine) and tcl_platform(platform) array |
| @@ -1453,32 +1453,32 @@ | ||
| 1453 | 1453 | </ul> |
| 1454 | 1454 | * Get autosetup working with MinGW. |
| 1455 | 1455 | * Fix autosetup detection of zlib in the source tree. |
| 1456 | 1456 | * Added autosetup detection of OpenSSL when it may be present under the |
| 1457 | 1457 | "compat" subdirectory of the source tree. |
| 1458 | - * Added the [/help?cmd=reparent|fossil reparent] command | |
| 1459 | - * Added --include and --exclude options to [/help?cmd=tarball|fossil tarball] | |
| 1460 | - and [/help?cmd=zip|fossil zip] and the in= and ex= query parameters to the | |
| 1461 | - [/help?cmd=/tarball|/tarball] and [/help?cmd=/zip|/zip] web pages. | |
| 1458 | + * Added the [/help/reparent|fossil reparent] command | |
| 1459 | + * Added --include and --exclude options to [/help/tarball|fossil tarball] | |
| 1460 | + and [/help/zip|fossil zip] and the in= and ex= query parameters to the | |
| 1461 | + [/help/www/tarball|/tarball] and [/help/www/zip|/zip] web pages. | |
| 1462 | 1462 | * Add support for [./encryptedrepos.wiki|encrypted Fossil repositories]. |
| 1463 | 1463 | * If the FOSSIL_PWREADER environment variable is set, then use the program it |
| 1464 | 1464 | names in place of getpass() to read passwords and passphrases |
| 1465 | 1465 | * Option --baseurl now works on Windows. |
| 1466 | 1466 | * Numerous documentation improvements. |
| 1467 | 1467 | * Update the built-in SQLite to version 3.13.0. |
| 1468 | 1468 | |
| 1469 | 1469 | <h2 id='v1_34'>Changes for Version 1.34 (2015-11-02)</h2> |
| 1470 | 1470 | |
| 1471 | - * Make the [/help?cmd=clean|fossil clean] command undoable for files less | |
| 1471 | + * Make the [/help/clean|fossil clean] command undoable for files less | |
| 1472 | 1472 | than 10MiB. |
| 1473 | 1473 | * Update internal Unicode character tables, used in regular expression |
| 1474 | 1474 | handling, from version 7.0 to 8.0. |
| 1475 | - * Add the new [/help?cmd=amend|amend] command which is used to modify | |
| 1475 | + * Add the new [/help/amend|amend] command which is used to modify | |
| 1476 | 1476 | tags of a "check-in". |
| 1477 | - * Fix bug in [/help?cmd=import|import] command, handling version 3 of | |
| 1477 | + * Fix bug in [/help/import|import] command, handling version 3 of | |
| 1478 | 1478 | the svndump format for subversion. |
| 1479 | - * Add the [/help?cmd=all|all cache] command. | |
| 1479 | + * Add the [/help/all|all cache] command. | |
| 1480 | 1480 | * TH1 enhancements: |
| 1481 | 1481 | <ul><li>Add minimal <nowiki>[lsearch]</nowiki> command. Only exact |
| 1482 | 1482 | case-sensitive matching is supported.</li> |
| 1483 | 1483 | <li>Add the <nowiki>[glob_match]</nowiki>, <nowiki>[markdown]</nowiki>, |
| 1484 | 1484 | <nowiki>[dir]</nowiki>, and <nowiki>[encode64]</nowiki> commands.</li> |
| @@ -1485,106 +1485,106 @@ | ||
| 1485 | 1485 | <li>Add the <nowiki>[tclIsSafe] and [tclMakeSafe]</nowiki> commands to |
| 1486 | 1486 | the Tcl integration subsystem.</li> |
| 1487 | 1487 | <li>Add 'double', 'integer', and 'list' classes to the |
| 1488 | 1488 | <nowiki>[string is]</nowiki> command.</li> |
| 1489 | 1489 | </ul> |
| 1490 | - * Add the --undo option to the [/help?cmd=diff|diff] command. | |
| 1490 | + * Add the --undo option to the [/help/diff|diff] command. | |
| 1491 | 1491 | * Build-in Antirez's "linenoise" command-line editing library for use with |
| 1492 | - the [/help?cmd=sqlite3|fossil sql] command on Unix platforms. | |
| 1493 | - * Add [/help?cmd=stash|stash cat] as an alias for the | |
| 1494 | - [/help?cmd=stash|stash show] command. | |
| 1495 | - * Automatically pull before [/help?cmd=merge|fossil merge] when auto-sync | |
| 1492 | + the [/help/sqlite3|fossil sql] command on Unix platforms. | |
| 1493 | + * Add [/help/stash|stash cat] as an alias for the | |
| 1494 | + [/help/stash|stash show] command. | |
| 1495 | + * Automatically pull before [/help/merge|fossil merge] when auto-sync | |
| 1496 | 1496 | is enabled. |
| 1497 | - * Fix --hard option to [/help?cmd=mv|fossil mv] and [/help?cmd=rm|fossil rm] | |
| 1497 | + * Fix --hard option to [/help/mv|fossil mv] and [/help/rm|fossil rm] | |
| 1498 | 1498 | to enable them to work properly with certain relative paths. |
| 1499 | 1499 | * Change the mimetype for ".n" and ".man" files to text/plain. |
| 1500 | - * Display improvements in the [/help?cmd=bisect|fossil bisect chart] command. | |
| 1500 | + * Display improvements in the [/help/bisect|fossil bisect chart] command. | |
| 1501 | 1501 | * Updated the built-in SQLite to version 3.9.1 and activated JSON1 and FTS5 |
| 1502 | 1502 | support (both currently unused within Fossil). |
| 1503 | 1503 | |
| 1504 | 1504 | <h2 id='v1_33'>Changes for Version 1.33 (2015-05-23)</h2> |
| 1505 | - * Improved fork detection on [/help?cmd=update|fossil update], | |
| 1506 | - [/help?cmd=status|fossil status] and related commands. | |
| 1505 | + * Improved fork detection on [/help/update|fossil update], | |
| 1506 | + [/help/status|fossil status] and related commands. | |
| 1507 | 1507 | * Change the default skin to what used to be called "San Francisco Modern". |
| 1508 | 1508 | * Add the [/repo-tabsize] web page |
| 1509 | - * Add [/help?cmd=import|fossil import --svn], for importing a subversion | |
| 1509 | + * Add [/help/import|fossil import --svn], for importing a subversion | |
| 1510 | 1510 | repository into fossil which was exported using "svnadmin dump". |
| 1511 | - * Add the "--compress-only" option to [/help?cmd=rebuild|fossil rebuild]. | |
| 1511 | + * Add the "--compress-only" option to [/help/rebuild|fossil rebuild]. | |
| 1512 | 1512 | * Use a pie chart on the [/reports?view=byuser] page. |
| 1513 | - * Enhanced [/help?cmd=clean|fossil clean --verily] so that it ignores | |
| 1513 | + * Enhanced [/help/clean|fossil clean --verily] so that it ignores | |
| 1514 | 1514 | keep-glob and ignore-glob settings. Added the -x alias for --verily. |
| 1515 | - * Add the --soft and --hard options to [/help?cmd=rm|fossil rm] and | |
| 1516 | - [/help?cmd=mv|fossil mv]. The default is still --soft, but that is | |
| 1515 | + * Add the --soft and --hard options to [/help/rm|fossil rm] and | |
| 1516 | + [/help/mv|fossil mv]. The default is still --soft, but that is | |
| 1517 | 1517 | now configurable at compile-time or by the mv-rm-files setting. |
| 1518 | 1518 | * Improved ability to [./customgraph.md|customize the timeline graph]. |
| 1519 | 1519 | * Improvements to the [/sitemap] page. |
| 1520 | - * Automatically adjust the [/help?cmd=timeline|CLI timeline] to the terminal | |
| 1520 | + * Automatically adjust the [/help/timeline|CLI timeline] to the terminal | |
| 1521 | 1521 | width on Linux. |
| 1522 | 1522 | * Added <nowiki>[info commands] and [info vars]</nowiki> commands to TH1. |
| 1523 | 1523 | These commands perform the same function as their Tcl counterparts, |
| 1524 | 1524 | except they do not accept a pattern argument. |
| 1525 | 1525 | * Fix some obscure issues with TH1 expression processing. |
| 1526 | 1526 | * Fix titles in search results for documents that are not wiki, markdown, |
| 1527 | 1527 | or HTML. |
| 1528 | 1528 | * Formally translate TH1 to Tcl return codes and vice-versa, where |
| 1529 | 1529 | necessary, in the Tcl integration subsystem. |
| 1530 | - * Add [/help?cmd=leaves|fossil leaves -multiple], for finding multiple | |
| 1530 | + * Add [/help/leaves|fossil leaves -multiple], for finding multiple | |
| 1531 | 1531 | leaves on the same branch. |
| 1532 | 1532 | * Added the "Blitz" skin option. |
| 1533 | 1533 | * Removed the ".fossil-settings/keep-glob" file. It should not have been |
| 1534 | 1534 | checked into the repository. |
| 1535 | 1535 | * Update the built-in SQLite to version 3.8.10.2. |
| 1536 | - * Make [/help?cmd=open|fossil open] honor ".fossil-settings/allow-symlinks". | |
| 1537 | - * Allow [/help?cmd=add|fossil add] to be used on symlinks to nonexistent or | |
| 1538 | - unreadable files in the same way as [/help?cmd=addremove|fossil addremove]. | |
| 1536 | + * Make [/help/open|fossil open] honor ".fossil-settings/allow-symlinks". | |
| 1537 | + * Allow [/help/add|fossil add] to be used on symlinks to nonexistent or | |
| 1538 | + unreadable files in the same way as [/help/addremove|fossil addremove]. | |
| 1539 | 1539 | * Added fork warning to be issued if sync produced a fork |
| 1540 | - * Update the [/help?cmd=/info|info] page to report when a file becomes a | |
| 1540 | + * Update the [/help/www/info|info] page to report when a file becomes a | |
| 1541 | 1541 | symlink. Additionally show the UUID for files whose types have changed |
| 1542 | 1542 | without changing contents or symlink target. |
| 1543 | - * Have [/help?cmd=changes|fossil changes] and | |
| 1544 | - [/help?cmd=status|fossil status] report when executable or symlink status | |
| 1543 | + * Have [/help/changes|fossil changes] and | |
| 1544 | + [/help/status|fossil status] report when executable or symlink status | |
| 1545 | 1545 | changes on otherwise unmodified files. |
| 1546 | - * Permit filtering weekday and file [/help?cmd=/reports|reports] by user. | |
| 1546 | + * Permit filtering weekday and file [/help/www/reports|reports] by user. | |
| 1547 | 1547 | Also ensure the user parameter is preserved when changing types. Add a |
| 1548 | 1548 | field for direct entry of the user name to each applicable report. |
| 1549 | - * Create parent directories of [/help?cmd=settings|empty-dirs] if they don't | |
| 1549 | + * Create parent directories of [/help/settings|empty-dirs] if they don't | |
| 1550 | 1550 | already exist. |
| 1551 | 1551 | * Inhibit timeline links to wiki pages that have been deleted. |
| 1552 | 1552 | |
| 1553 | 1553 | <h2 id='v1_33'>Changes for Version 1.32 (2015-03-14)</h2> |
| 1554 | - * When creating a new repository using [/help?cmd=init|fossil init], ensure | |
| 1554 | + * When creating a new repository using [/help/init|fossil init], ensure | |
| 1555 | 1555 | that the new repository is fully compatible with historical versions of |
| 1556 | 1556 | Fossil by having a valid manifest as RID 1. |
| 1557 | 1557 | * Anti-aliased rendering of arrowheads on timeline graphs. |
| 1558 | 1558 | * Added vi/less-style key bindings to the --tk diff GUI. |
| 1559 | 1559 | * Documentation updates to fix spellings and changes all "checkins" to |
| 1560 | 1560 | "check-ins". |
| 1561 | 1561 | * Add the --repolist option to server commands such as |
| 1562 | - [/help?cmd=server|fossil server] or [/help?cmd=http|fossil http]. | |
| 1562 | + [/help/server|fossil server] or [/help/http|fossil http]. | |
| 1563 | 1563 | * Added the "Xekri" skin. |
| 1564 | 1564 | * Enhance the "ln=" query parameter on artifact displays to accept multiple |
| 1565 | 1565 | ranges, separate by spaces (or "+" when URL-encoded). |
| 1566 | - * Added [/help?cmd=forget|fossil forget] as an alias for | |
| 1567 | - [/help?cmd=rm|fossil rm]. | |
| 1566 | + * Added [/help/forget|fossil forget] as an alias for | |
| 1567 | + [/help/rm|fossil rm]. | |
| 1568 | 1568 | |
| 1569 | 1569 | <h2 id='v1_31'>Changes For Version 1.31 (2015-02-23)</h2> |
| 1570 | 1570 | * Change the auxiliary schema by adding columns MLINK.ISAUX and MLINK.PMID |
| 1571 | 1571 | columns to the schema, to support better drawing of file change graphs. |
| 1572 | - A [/help?cmd=rebuild|fossil rebuild] is recommended but is not required. | |
| 1572 | + A [/help/rebuild|fossil rebuild] is recommended but is not required. | |
| 1573 | 1573 | so that the new graph drawing logic can work effectively. |
| 1574 | 1574 | * Added [/search|search] over Check-in comments, Documents, Tickets and |
| 1575 | 1575 | Wiki. Disabled by default. The search can be either a full-scan or it |
| 1576 | 1576 | can use an index that is kept up-to-date automatically. The new |
| 1577 | - /srchsetup web-page and the [/help?cmd=fts-config|fts-config] command | |
| 1577 | + /srchsetup web-page and the [/help/fts-config|fts-config] command | |
| 1578 | 1578 | were added to help configure the search capability. Expect further |
| 1579 | 1579 | enhancements to the search capabilities in subsequent releases. |
| 1580 | 1580 | * Added form elements to some submenus (in particular the /timeline) |
| 1581 | 1581 | for easier operation. |
| 1582 | - * Added the --ifneeded option to [/help?cmd=rebuild|fossil rebuild]. | |
| 1582 | + * Added the --ifneeded option to [/help/rebuild|fossil rebuild]. | |
| 1583 | 1583 | * Added "override skins" using the "skin:" line of the CGI script or |
| 1584 | - using the --skin LABEL option on the [/help?cmd=server|server], | |
| 1585 | - [/help?cmd=ui|ui], or [/help?cmd=http|http] commands. | |
| 1584 | + using the --skin LABEL option on the [/help/server|server], | |
| 1585 | + [/help/ui|ui], or [/help/http|http] commands. | |
| 1586 | 1586 | * Embedded html documents that begin with |
| 1587 | 1587 | <doc class="fossil-doc"> are displayed with standard |
| 1588 | 1588 | headers and footers added. |
| 1589 | 1589 | * Allow <div style='...'> markup in [/wiki_rules|wiki]. |
| 1590 | 1590 | * Renamed "Events" to "Technical Notes", while updating the technote |
| @@ -1591,24 +1591,24 @@ | ||
| 1591 | 1591 | display and control pages. Add support for technotes as plain text |
| 1592 | 1592 | or as Markdown. |
| 1593 | 1593 | * Added the [/md_rules] pages containing summary instructions on the |
| 1594 | 1594 | Markdown format. |
| 1595 | 1595 | * Added the --repolist and --nojail options to the various server commands |
| 1596 | - (ex: [/help?cmd=server|fossil server]). | |
| 1597 | - * Added the [/help?cmd=all|fossil all add] subcommand to "fossil all". | |
| 1596 | + (ex: [/help/server|fossil server]). | |
| 1597 | + * Added the [/help/all|fossil all add] subcommand to "fossil all". | |
| 1598 | 1598 | * Improvements to the /login page. Some hyperlinks to pages that require |
| 1599 | 1599 | "anonymous" privileges are displayed even if the current user is "nobody" |
| 1600 | 1600 | but automatically redirect to /login. |
| 1601 | - * The [/help?cmd=/doc|/doc] web-page will now try to deliver the file | |
| 1601 | + * The [/help/www/doc|/doc] web-page will now try to deliver the file | |
| 1602 | 1602 | "404.md" from the top-level directory (if such a file exists) in |
| 1603 | 1603 | place of its built-in 404 text. |
| 1604 | 1604 | * Download of Tarballs and ZIP Archives by user "nobody" is now enabled |
| 1605 | 1605 | by default in new repositories. |
| 1606 | 1606 | * Enhancements to the table sorting controls. More display tables |
| 1607 | 1607 | are now sortable. |
| 1608 | - * Add IPv6 support to [/help?cmd=sync|fossil sync] and | |
| 1609 | - [/help?cmd=clone|fossil clone] | |
| 1608 | + * Add IPv6 support to [/help/sync|fossil sync] and | |
| 1609 | + [/help/clone|fossil clone] | |
| 1610 | 1610 | * Add more skins such as "San Francisco Modern" and "Eagle". |
| 1611 | 1611 | * During shutdown, check to see if the check-out database (".fslckout") |
| 1612 | 1612 | contains a lot of free space, and if it does, VACUUM it. |
| 1613 | 1613 | * Added the [/mimetype_list] page. |
| 1614 | 1614 | * Added the [/hash-collisions] page. |
| @@ -1616,14 +1616,14 @@ | ||
| 1616 | 1616 | ticket reports. |
| 1617 | 1617 | * Break out the components (css, footer, and header) for the |
| 1618 | 1618 | various built-in skins into separate files in the source tree. |
| 1619 | 1619 | |
| 1620 | 1620 | <h2 id='v1_30'>Changes For Version 1.30 (2015-01-19)</h2> |
| 1621 | - * Added the [/help?cmd=bundle|fossil bundle] command. | |
| 1622 | - * Added the [/help?cmd=purge|fossil purge] command. | |
| 1623 | - * Added the [/help?cmd=publish|fossil publish] command. | |
| 1624 | - * Added the [/help?cmd=unpublished|fossil unpublished] command. | |
| 1621 | + * Added the [/help/bundle|fossil bundle] command. | |
| 1622 | + * Added the [/help/purge|fossil purge] command. | |
| 1623 | + * Added the [/help/publish|fossil publish] command. | |
| 1624 | + * Added the [/help/unpublished|fossil unpublished] command. | |
| 1625 | 1625 | * Enhance the [/tree] webpage to show the age of each file with the option |
| 1626 | 1626 | to sort by age. |
| 1627 | 1627 | * Enhance the [/brlist] webpage to show additional information about each branch |
| 1628 | 1628 | and to be sortable by clicking on column headers. |
| 1629 | 1629 | * Add support for Docker. Just install docker and type |
| @@ -1633,17 +1633,17 @@ | ||
| 1633 | 1633 | copies of all historical check-ins. This only works on systems that |
| 1634 | 1634 | support FuseFS. |
| 1635 | 1635 | * Add the administrative log that records all configuration. |
| 1636 | 1636 | * Added the [/sitemap] webpage. |
| 1637 | 1637 | * Added the [/bloblist] web page. |
| 1638 | - * Let [/help?cmd=new|fossil new] no longer create an initial empty commit | |
| 1638 | + * Let [/help/new|fossil new] no longer create an initial empty commit | |
| 1639 | 1639 | by default. The first commit after checking out an empty repository will |
| 1640 | 1640 | become the initial commit. |
| 1641 | - * Added the [/help?cmd=all|fossil all dbstat] and | |
| 1642 | - [/help?cmd=all|fossil all info] commands. | |
| 1641 | + * Added the [/help/all|fossil all dbstat] and | |
| 1642 | + [/help/all|fossil all info] commands. | |
| 1643 | 1643 | * Update SQLite to version 3.8.8. |
| 1644 | - * Added the --verily option to the [/help?cmd=clean|fossil clean] command. | |
| 1644 | + * Added the --verily option to the [/help/clean|fossil clean] command. | |
| 1645 | 1645 | * Add the "autosync-tries" setting to control the number of autosync attempts |
| 1646 | 1646 | before returning an error. |
| 1647 | 1647 | * Added a compile-time option (--with-miniz) to build using miniz instead |
| 1648 | 1648 | of zlib. Disabled by default. |
| 1649 | 1649 | * Support customization of commands and webpages, including the ability to |
| @@ -1653,12 +1653,12 @@ | ||
| 1653 | 1653 | [trace], [getParameter], [setParameter], [artifact], and |
| 1654 | 1654 | [globalState]</nowiki> commands to TH1, primarily for use by TH1 hooks. |
| 1655 | 1655 | * Automatically adjust the width of command-line timeline output according to the |
| 1656 | 1656 | detected width of the terminal. |
| 1657 | 1657 | * Prompt the user to optionally fix invalid UTF-8 at check-in. |
| 1658 | - * Added a line-number toggle option to the [/help?cmd=/info|/info] | |
| 1659 | - and [/help?cmd=/artifact|/artifact] pages. | |
| 1658 | + * Added a line-number toggle option to the [/help/www/info|/info] | |
| 1659 | + and [/help/www/artifact|/artifact] pages. | |
| 1660 | 1660 | * Most commands now issue errors rather than silently ignoring unrecognized |
| 1661 | 1661 | command-line options. |
| 1662 | 1662 | * Use full 40-character SHA1 hashes (instead of abbreviations) in most |
| 1663 | 1663 | internal URLs. |
| 1664 | 1664 | * The "ssh:" sync method on Windows now uses "plink.exe" instead of "ssh" as |
| @@ -1672,11 +1672,11 @@ | ||
| 1672 | 1672 | * Fix a rare and long-standing sync protocol bug |
| 1673 | 1673 | that would silently prevent the sync from running to completion. Before |
| 1674 | 1674 | this bug-fix it was sometimes necessary to do "fossil sync --verily" to |
| 1675 | 1675 | get two repositories in sync. |
| 1676 | 1676 | * Add the [/finfo?name=src/foci.c|files_of_checkin] virtual table - useful |
| 1677 | - for ad hoc queries in the [/help?cmd=sqlite3|fossil sql] interface, | |
| 1677 | + for ad hoc queries in the [/help/sqlite3|fossil sql] interface, | |
| 1678 | 1678 | and also used internally. |
| 1679 | 1679 | * Added the "$secureurl" TH1 variable for use in headers and footers. |
| 1680 | 1680 | * (Internal:) Add the ability to include resources as separate files in the |
| 1681 | 1681 | source tree that are converted into constant byte arrays in the compiled |
| 1682 | 1682 | binary. Use this feature to store the Tk script that implements the --tk |
| @@ -1696,143 +1696,143 @@ | ||
| 1696 | 1696 | * The [/reports] page now requires Read ("o") permissions. The "byweek" |
| 1697 | 1697 | report now properly propagates the selected year through the event type |
| 1698 | 1698 | filter links. |
| 1699 | 1699 | * The [/help/info | info command] now shows leaf status of the checkout. |
| 1700 | 1700 | * Add support for tunneling https through a http proxy (Ticket [e854101c4f]). |
| 1701 | - * Add option --empty to the "[/help?cmd=open | fossil open]" command. | |
| 1702 | - * Enhanced [/help?cmd=/fileage|the fileage page] to support a glob parameter. | |
| 1701 | + * Add option --empty to the "[/help/open | fossil open]" command. | |
| 1702 | + * Enhanced [/help/www/fileage|the fileage page] to support a glob parameter. | |
| 1703 | 1703 | * Add -w|--ignore-all-space and -Z|--ignore-trailing-space options to |
| 1704 | - [/help?cmd=annotate|fossil annotate], [/help?cmd=blame|fossil blame], | |
| 1705 | - [/help?cmd=diff|fossil (g)diff], [/help?cmd=stash|fossil stash diff]. | |
| 1706 | - * Add --strip-trailing-cr option to [/help?cmd=diff|fossil (g)diff] and | |
| 1707 | - [/help?cmd=stash|fossil stash diff]. | |
| 1704 | + [/help/annotate|fossil annotate], [/help/blame|fossil blame], | |
| 1705 | + [/help/diff|fossil (g)diff], [/help/stash|fossil stash diff]. | |
| 1706 | + * Add --strip-trailing-cr option to [/help/diff|fossil (g)diff] and | |
| 1707 | + [/help/stash|fossil stash diff]. | |
| 1708 | 1708 | * Add button "Ignore Whitespace" to /annotate, /blame, /ci, /fdiff |
| 1709 | 1709 | and /vdiff UI pages. |
| 1710 | 1710 | * Enhance [/reports?view=byweekday|/reports] with a "byweekday" view. |
| 1711 | - * Enhance the [/help?cmd=cat|fossil cat] command so that it works outside | |
| 1711 | + * Enhance the [/help/cat|fossil cat] command so that it works outside | |
| 1712 | 1712 | of a checkout when using the -R command-line option. |
| 1713 | 1713 | * Use full-length SHA1 hashes, not abbreviations, in most hyperlinks. |
| 1714 | 1714 | * Correctly render the <title> markup on wiki pages in the |
| 1715 | - [/help?cmd=/artifact|/artifact] webpage. | |
| 1716 | - * Enhance the [/help?cmd=whatis|fossil whatis] command to report on attachments | |
| 1717 | - and cluster artifacts. Added the [/help?cmd=test-whatis-all] command for | |
| 1715 | + [/help/www/artifact|/artifact] webpage. | |
| 1716 | + * Enhance the [/help/whatis|fossil whatis] command to report on attachments | |
| 1717 | + and cluster artifacts. Added the [/help/test-whatis-all] command for | |
| 1718 | 1718 | testing purposes. |
| 1719 | - * Add support for HTTP Basic Authentication on [/help?cmd=clone|clone] and | |
| 1720 | - [/help?cmd=sync|sync]. | |
| 1721 | - * Fix the [/help?cmd=stash|stash] so that it remembers added files and re-adds | |
| 1719 | + * Add support for HTTP Basic Authentication on [/help/clone|clone] and | |
| 1720 | + [/help/sync|sync]. | |
| 1721 | + * Fix the [/help/stash|stash] so that it remembers added files and re-adds | |
| 1722 | 1722 | them when the stash is applied. |
| 1723 | 1723 | * Fix the server so that it avoids writing to the database (and thus avoids |
| 1724 | 1724 | database locking issues) on a |
| 1725 | - [/help?cmd=pull|pull] or [/help?cmd=clone|clone]. | |
| 1725 | + [/help/pull|pull] or [/help/clone|clone]. | |
| 1726 | 1726 | * Add support for [./server.wiki#loadmgmt|server load management] using both |
| 1727 | - a cache of expensive pages (the [/help?cmd=cache|fossil cache] command) | |
| 1727 | + a cache of expensive pages (the [/help/cache|fossil cache] command) | |
| 1728 | 1728 | and by rejecting expensive page requests when the server load average is too |
| 1729 | 1729 | high. |
| 1730 | - * Add the [/help?cmd=praise|fossil praise] command as an alias for | |
| 1731 | - [/help?cmd=blame|fossil blame] for subversion compatibility. | |
| 1732 | - * Enhance the [/help?cmd=test-diff|fossil test-diff] command with -y or --tk | |
| 1730 | + * Add the [/help/praise|fossil praise] command as an alias for | |
| 1731 | + [/help/blame|fossil blame] for subversion compatibility. | |
| 1732 | + * Enhance the [/help/test-diff|fossil test-diff] command with -y or --tk | |
| 1733 | 1733 | options so that it shows both filenames above their respective columns in |
| 1734 | 1734 | the side-by-side diff output. |
| 1735 | - * Issue a warning if a [/help?cmd=add|fossil add] command tries to add a file | |
| 1735 | + * Issue a warning if a [/help/add|fossil add] command tries to add a file | |
| 1736 | 1736 | that matches the ignore-glob. |
| 1737 | - * Add option -W|--width to "[/help?cmd=stash|fossil stash ls]" | |
| 1738 | - and "[/help?cmd=leaves|fossil leaves]" commands. | |
| 1737 | + * Add option -W|--width to "[/help/stash|fossil stash ls]" | |
| 1738 | + and "[/help/leaves|fossil leaves]" commands. | |
| 1739 | 1739 | * Enhance support for running as the root user. Now works on Haiku. |
| 1740 | - * Added the <tt>-empty</tt> option to [/help?cmd=new|fossil new], which | |
| 1740 | + * Added the <tt>-empty</tt> option to [/help/new|fossil new], which | |
| 1741 | 1741 | causes it to not create an initial empty commit. The first commit after |
| 1742 | 1742 | checking out a repo created this way will become the initial commit. |
| 1743 | 1743 | * Enhance sync operations by committing each round-trip to minimize number |
| 1744 | 1744 | of retransmits when autosync fails. Include option for |
| 1745 | - [/help?cmd=update| fossil update] and [/help?cmd=merge| fossil merge] to | |
| 1745 | + [/help/update| fossil update] and [/help/merge| fossil merge] to | |
| 1746 | 1746 | continue even if missing content. |
| 1747 | 1747 | * Minor portability fixes for platforms where the char type is unsigned |
| 1748 | 1748 | by default. |
| 1749 | 1749 | |
| 1750 | 1750 | <h2>Changes For Version 1.28 (2014-01-27)</h2> |
| 1751 | - * Enhance [/help?cmd=/reports | /reports] to support event type filtering. | |
| 1751 | + * Enhance [/help/www/reports | /reports] to support event type filtering. | |
| 1752 | 1752 | * When cloning a repository, the user name passed via the URL (if any) |
| 1753 | 1753 | is now used as the default local admin user's name. |
| 1754 | 1754 | * Enhance the SSH transport mechanism so that it runs a single instance of |
| 1755 | 1755 | the "fossil" executable on the remote side, obviating the need for a shell |
| 1756 | 1756 | on the remote side. Some users may need to add the "?fossil=/path/to/fossil" |
| 1757 | 1757 | query parameter to "ssh:" URIs if their fossil binary is not in a standard |
| 1758 | 1758 | place. |
| 1759 | - * Add the "[/help?cmd=blame | fossil blame]" command that works just like | |
| 1759 | + * Add the "[/help/blame | fossil blame]" command that works just like | |
| 1760 | 1760 | "fossil annotate" but uses a different output format that includes the |
| 1761 | 1761 | user who made each change and omits line numbers. |
| 1762 | 1762 | * Add the "Tarball and ZIP-archive Prefix" configuration parameter under |
| 1763 | 1763 | Admin/Configuration. |
| 1764 | 1764 | * Fix CGI processing so that it works on web servers that do not |
| 1765 | 1765 | supply REQUEST_URI. |
| 1766 | 1766 | * Add options --dirsonly, --emptydirs, and --allckouts to the |
| 1767 | - "[/help?cmd=clean | fossil clean]" command. | |
| 1767 | + "[/help/clean | fossil clean]" command. | |
| 1768 | 1768 | * Ten-fold performance improvement in large "fossil blame" or |
| 1769 | 1769 | "fossil annotate" commands. |
| 1770 | - * Add option -W|--width and --offset to "[/help?cmd=timeline | fossil timeline]" | |
| 1771 | - and "[/help?cmd=finfo | fossil finfo]" commands. | |
| 1772 | - * Option -n|--limit of "[/help?cmd=timeline | fossil timeline]" now | |
| 1770 | + * Add option -W|--width and --offset to "[/help/timeline | fossil timeline]" | |
| 1771 | + and "[/help/finfo | fossil finfo]" commands. | |
| 1772 | + * Option -n|--limit of "[/help/timeline | fossil timeline]" now | |
| 1773 | 1773 | specifies the number of entries, just like all other commands which |
| 1774 | 1774 | have the -n|--limit option. The various timeline-related functions |
| 1775 | 1775 | now output "--- ?? limit (??) reached ---" at the end whenever |
| 1776 | 1776 | appropriate. Use "-n 0" if no limit is desired. |
| 1777 | 1777 | * Fix handling of password embedded in Fossil URL. |
| 1778 | - * New <tt>--once</tt> option to [/help?cmd=clone | fossil clone] command | |
| 1778 | + * New <tt>--once</tt> option to [/help/clone | fossil clone] command | |
| 1779 | 1779 | which does not store the URL or password when cloning. |
| 1780 | - * Modify [/help?cmd=ui | fossil ui] to respect "default user" in an open | |
| 1780 | + * Modify [/help/ui | fossil ui] to respect "default user" in an open | |
| 1781 | 1781 | repository. |
| 1782 | 1782 | * Fossil now hides check-ins that have the "hidden" tag in timeline webpages. |
| 1783 | 1783 | * Enhance <tt>/ci_edit</tt> page to add the "hidden" tag to check-ins. |
| 1784 | 1784 | * Advanced possibilities for commit and ticket change notifications over |
| 1785 | 1785 | http using TH1 scripting. |
| 1786 | 1786 | * Add --sha1sum and --integrate options |
| 1787 | - to the "[/help?cmd=commit | fossil commit]" command. | |
| 1787 | + to the "[/help/commit | fossil commit]" command. | |
| 1788 | 1788 | * Add the "clean" and "extra" subcommands to the |
| 1789 | - "[/help?cmd=all | fossil all]" command | |
| 1790 | - * Add the --whatif option to "[/help?cmd=clean|fossil clean]" that works the | |
| 1789 | + "[/help/all | fossil all]" command | |
| 1790 | + * Add the --whatif option to "[/help/clean|fossil clean]" that works the | |
| 1791 | 1791 | same as "--dry-run", |
| 1792 | 1792 | so that the name does not collide with the --dry-run option of "fossil all". |
| 1793 | 1793 | * Provide a configuration option to show dates on the web timeline |
| 1794 | 1794 | as "YYMMMDD HH:MM" |
| 1795 | 1795 | * Add an option to the "stats" webpage that allows an administrator to see |
| 1796 | 1796 | the current repository schema. |
| 1797 | - * Enhancements to the "[/help?cmd=/vdiff|/vdiff]" webpage for more difference | |
| 1797 | + * Enhancements to the "[/help/www/vdiff|/vdiff]" webpage for more difference | |
| 1798 | 1798 | display options. |
| 1799 | 1799 | * Added the "[/tree?ci=trunk&expand | /tree]" webpage as an alternative |
| 1800 | 1800 | to "/dir" and make it the default way of showing file lists. |
| 1801 | 1801 | * Send gzipped HTTP responses to clients that support it. |
| 1802 | 1802 | |
| 1803 | 1803 | <h2>Changes For Version 1.27 (2013-09-11)</h2> |
| 1804 | - * Enhance the [/help?cmd=changes | fossil changes], | |
| 1805 | - [/help?cmd=clean | fossil clean], [/help?cmd=extras | fossil extras], | |
| 1806 | - [/help?cmd=ls | fossil ls] and [/help?cmd=status | fossil status] commands | |
| 1804 | + * Enhance the [/help/changes | fossil changes], | |
| 1805 | + [/help/clean | fossil clean], [/help/extras | fossil extras], | |
| 1806 | + [/help/ls | fossil ls] and [/help/status | fossil status] commands | |
| 1807 | 1807 | to restrict operation to files and directories named on the command-line. |
| 1808 | - * New --integrate option to [/help?cmd=merge | fossil merge], which | |
| 1808 | + * New --integrate option to [/help/merge | fossil merge], which | |
| 1809 | 1809 | automatically closes the merged branch when committing. |
| 1810 | 1810 | * Renamed <tt>/stats_report</tt> page to [/reports]. Graph width is now |
| 1811 | 1811 | relative, not absolute. |
| 1812 | 1812 | * Added <tt>yw=YYYY-WW</tt> (year-week) filter to timeline to limit the results |
| 1813 | 1813 | to a specific year and calendar week number, e.g. [/timeline?yw=2013-01]. |
| 1814 | 1814 | * Updates to SQLite to prevent opening a repository file using file descriptors |
| 1815 | 1815 | 1 or 2 on Unix. This fixes a bug under which an assertion failure could |
| 1816 | 1816 | overwrite part of a repository database file, corrupting it. |
| 1817 | 1817 | * Added support for unlimited line lengths in side-by-side diffs. |
| 1818 | - * New --close option to [/help?cmd=commit | fossil commit], which | |
| 1818 | + * New --close option to [/help/commit | fossil commit], which | |
| 1819 | 1819 | immediately closes the branch being committed. |
| 1820 | - * Added <tt>chart</tt> option to [/help?cmd=bisect | fossil bisect]. | |
| 1820 | + * Added <tt>chart</tt> option to [/help/bisect | fossil bisect]. | |
| 1821 | 1821 | * Improvements to the "human or bot?" determination. |
| 1822 | 1822 | * Reports errors about missing CGI-standard environment variables for HTTP |
| 1823 | 1823 | servers which do not support them. |
| 1824 | 1824 | * Minor improvements to sync support on Windows. |
| 1825 | - * Added <tt>--scgi</tt> option to [/help?cmd=server | fossil server]. | |
| 1825 | + * Added <tt>--scgi</tt> option to [/help/server | fossil server]. | |
| 1826 | 1826 | * Internal improvements to the sync process. |
| 1827 | 1827 | * The internals of the JSON API are now MIT-licensed, so downstream |
| 1828 | 1828 | users/packagers are no longer affected by the "do no evil" license |
| 1829 | 1829 | clause. |
| 1830 | 1830 | |
| 1831 | 1831 | <h2>Changes For Version 1.26 (2013-06-18)</h2> |
| 1832 | - * The argument to the --port option for the [/help?cmd=ui | fossil ui] and | |
| 1833 | - [/help?cmd=server | fossil server] commands can take an IP address in addition | |
| 1832 | + * The argument to the --port option for the [/help/ui | fossil ui] and | |
| 1833 | + [/help/server | fossil server] commands can take an IP address in addition | |
| 1834 | 1834 | to the port number, causing Fossil to bind to just that one IP address. |
| 1835 | 1835 | * After prompting for a password, also ask if that password should be |
| 1836 | 1836 | remembered. |
| 1837 | 1837 | * Performance improvements to the diff engine. |
| 1838 | 1838 | * Fix the side-by-side diff engine to work better with multi-byte Unicode text. |
| @@ -1839,11 +1839,11 @@ | ||
| 1839 | 1839 | * Color-coding in the web-based annotation (blame) display. Fix the annotation |
| 1840 | 1840 | engine so that it is no longer confused by time-warps. |
| 1841 | 1841 | * The markdown formatter is now available by default and can be used for |
| 1842 | 1842 | tickets, wiki, and embedded documentation. |
| 1843 | 1843 | * Add subcommands "fossil bisect log" and "fossil bisect status" to the |
| 1844 | - [/help?cmd=bisect | fossil bisect] command, as well as other bisect enhancements. | |
| 1844 | + [/help/bisect | fossil bisect] command, as well as other bisect enhancements. | |
| 1845 | 1845 | * Enhanced defenses that prevent spiders from using excessive CPU and bandwidth. |
| 1846 | 1846 | * Consistent use of the -n or --dry-run command line options. |
| 1847 | 1847 | * Win32: Fossil now understands Cygwin paths containing one or more of |
| 1848 | 1848 | the characters <nowiki>"*:<>?|</nowiki>. Those are normally forbidden in |
| 1849 | 1849 | win32. This means that the win32 fossil.exe is better usable in a Cygwin |
| 1850 | 1850 |
| --- www/changes.wiki | |
| +++ www/changes.wiki | |
| @@ -2,73 +2,73 @@ | |
| 2 | |
| 3 | <h2 id='v2_28'>Changes for version 2.28 (pending)</h2><ol> |
| 4 | <li> Improvements to [./antibot.wiki|anti-robot defenses]:<ol type="a"> |
| 5 | <li> The default configuration now allows robots to download any tarball |
| 6 | or similar, to better support of automated build systems. |
| 7 | <li> No special tag "zipX" for the [/help?cmd=robot-restrict|robot-restrict] |
| 8 | setting blocks robot access to tarballs, but with exceptions to support |
| 9 | automated build systems. |
| 10 | </ol> |
| 11 | <li> A drop-down menu of recent branches is now possible for the submenu, and |
| 12 | is used in the code browser. |
| 13 | <li> The [/help?cmd=timeline|timeline command] is enhanced with the new |
| 14 | "<tt>-u|--for-user</tt>" option. |
| 15 | </ol> |
| 16 | |
| 17 | <h2 id='v2_27'>Changes for version 2.27 (2025-09-30)</h2><ol> |
| 18 | <li> Close a potential Denial-of-Service attack against any public-facing Fossil |
| 19 | server involving exponential behavior in Fossil's regexp implementation. |
| 20 | <li> Fix a SQL injection on the [/help?cmd=/file|/file page]. Thanks to |
| 21 | additional defenses built into Fossil, as well as good luck, this injection |
| 22 | is not exploitable for either data exfiltration or privilege escalation. The |
| 23 | only possible result of invoking the injection is a harmless SQL syntax error. |
| 24 | <li> Strengthen robot defenses to help prevent public-facing servers from being |
| 25 | overwhelmed by the latest generation of AI spiders. |
| 26 | <ol type="a"> |
| 27 | <li> New javascript captcha used to restrict access by user "nobody" to pages |
| 28 | listed in the [/help?cmd=robot-restrict|robot-restrict setting]. |
| 29 | <li> The [/help?cmd=robot-exception|robot-exception setting] is available to allow |
| 30 | access to pages that match a regular expression. Use this, for example, to |
| 31 | allow curl scripts and similar to download release tarballs. |
| 32 | <li> Require at least an anonymous login to access the /blame page and similar. |
| 33 | </ol> |
| 34 | <li> [/help?cmd=/timeline|Timeline] enhancements: |
| 35 | <ol type="a"> |
| 36 | <li> The chng= query parameter on the [/help?cmd=/timeline|timeline page] |
| 37 | so that it works with other query parameters like p=, d=, from=, and to=. |
| 38 | <li> Always include nodes identify by sel1= and sel2= in the /timeline display. |
| 39 | <li> Improved title when p= and d= are different. |
| 40 | </ol> |
| 41 | <li> Enable the --editor option on the [/help?cmd=amend|fossil amend] command. |
| 42 | <li> When walking the filesystem looking for Fossil repositories, avoid descending |
| 43 | into directories named "/proc". |
| 44 | <li> Reduce memory requirements for sending authenticated sync protocol |
| 45 | messages. |
| 46 | <li> Show numstat-style change statistics in the /info and /ckout pages. |
| 47 | <li> Add the [/help?cmd=stash | stash rename] subcommand. |
| 48 | <li> Add the "-h" option to the "[/help?cmd=ls|ls]" command to display |
| 49 | file hashes for a specific check-in when in verbose mode. |
| 50 | </ol> |
| 51 | |
| 52 | <h2 id='v2_26'>Changes for version 2.26 (2025-04-30)</h2><ol> |
| 53 | <li>Enhancements to [/help?cmd=diff|fossil diff] and similar: |
| 54 | <ol type="a"> |
| 55 | <li> The argument to the --from option can be a directory name, causing |
| 56 | Fossil to use files under that directory as the baseline for the diff. |
| 57 | <li> For "gdiff", if no [/help?cmd=gdiff-command|gdiff-command setting] |
| 58 | is defined, Fossil tries to do a --tk diff if "tclsh" and "wish" |
| 59 | are available, or a --by diff if not. |
| 60 | <li> The "Reload" button is added to --tk diffs, to bring the displayed |
| 61 | diff up to date with the latest changes on disk. |
| 62 | <li> Add the "Hide diffs/Show diffs" toggle to web-UI diff pages that show |
| 63 | diffs of multiple files. |
| 64 | </ol> |
| 65 | <li>Added the [/help?cmd=/ckout|/ckout web page] to provide information |
| 66 | about pending changes in a working check-out |
| 67 | <li>Enhancements to the [/help?cmd=ui|fossil ui] command: |
| 68 | <ol type="a"> |
| 69 | <li> Defaults to using the new [/help?cmd=/ckout|/ckout page] as its |
| 70 | start page. Or, if the new "--from PATH" option is present, the |
| 71 | default start page becomes "/ckout?exbase=PATH". |
| 72 | <li> The new "--extpage FILENAME" option opens the named file as if it |
| 73 | where in a [./serverext.wiki|CGI extension]. Example usage: the |
| 74 | person editing this change log has |
| @@ -76,25 +76,25 @@ | |
| 76 | press "Reload" on the web browser to view edits. |
| 77 | <li> Accept both IPv4 and IPv6 connections on all platforms, including |
| 78 | Windows and OpenBSD. This also applies to the "fossil server" |
| 79 | command. |
| 80 | </ol> |
| 81 | <li>Enhancements to [/help?cmd=merge|fossil merge]: |
| 82 | <ol type="a"> |
| 83 | <li> Added the [/help?cmd=merge-info|fossil merge-info] command and |
| 84 | especially the --tk option to that command, to provide analysis |
| 85 | of the most recent merge or update operation. |
| 86 | <li> When a merge conflict occurs, a new section is added to the conflict |
| 87 | text that shows Fossil's suggested resolution to the conflict. |
| 88 | </ol> |
| 89 | <li>Enhancements to [/help?cmd=commit|fossil commit]: |
| 90 | <ol type="a"> |
| 91 | <li> If Fossil sees potential formatting mistakes (ex: bad hyperlinks) |
| 92 | in the check-in comment, it will alert the developer and give |
| 93 | him or her the opportunity to edit the comment before continuing. |
| 94 | This feature is controllable by the |
| 95 | [/help?cmd=verify-comments|verify-comments setting]. |
| 96 | <li> The new "--if-changes" option causes the commit to become |
| 97 | a quiet no-op if there are no pending changes. |
| 98 | <li> Added the ability to sign check-ins with SSH keys. Artifacts signed |
| 99 | this way are ignored by all previous fossil versions, as if they |
| 100 | were plain-text file content instead of Fossil artifacts. |
| @@ -106,13 +106,13 @@ | |
| 106 | </ol> |
| 107 | <li>Deprecate the --comfmtflags and --comment-format global options and |
| 108 | no longer list them in the built-in help, but keep them working for |
| 109 | backwards compatibility. |
| 110 | Alternative TTY comment formatting can still be specified using the |
| 111 | [/help?cmd=comment-format|comment-format setting], if desired. The |
| 112 | default comment format is now called "canonical", not "legacy". |
| 113 | <li>Enhancements to the [/help?cmd=/timeline|/timeline page]: |
| 114 | <ol type="a"> |
| 115 | <li> Added the "ml=" ("Merge-in List") query parameter that works |
| 116 | like "rl=" ("Related List") but adds "mionly" style related |
| 117 | check-ins instead of the full "rel" style. |
| 118 | <li> For "tl=", "rl=", and "ml=", the order of the branches in the |
| @@ -141,33 +141,33 @@ | |
| 141 | in which case the timeline shows those check-ins that are both |
| 142 | ancestors of p= and descendants of d=. |
| 143 | <li> The saturation and intensity of user-specified checkin and branch |
| 144 | background colors are automatically adjusted to keep the colors |
| 145 | compatible with the current skin, unless the |
| 146 | [/help?cmd=raw-bgcolor|raw-bgcolor setting] is turned on. |
| 147 | </ol> |
| 148 | <li>The [/help?cmd=/docfile|/docfile webpage] was added. It works like |
| 149 | /doc but keeps the title of markdown documents with the document rather |
| 150 | that moving it up to the page title. |
| 151 | <li>Added the [/help?cmd=/clusterlist|/clusterlist page] for analysis |
| 152 | and debugging |
| 153 | <li>Added the "artifact_to_json(NAME)" SQL function that returns a JSON |
| 154 | decoding of the artifact described by NAME. |
| 155 | <li>Improvements to the [/help?cmd=patch|fossil patch] command: |
| 156 | <ol type="a"> |
| 157 | <li> Fix a bug in "fossil patch create" that causes |
| 158 | [/help?cmd=revert|fossil revert] operations that happened |
| 159 | on individualfiles after a [/help?cmd=merge|fossil merge] |
| 160 | to be omitted from the patch. |
| 161 | <li> Added the [/help?cmd=patch|patch alias] command for managing |
| 162 | aliases for remote checkout names. |
| 163 | </ol> |
| 164 | <li>Enhancements to on-line help and the [/help?cmd=help|fossil help] command: |
| 165 | <ol type="a"> |
| 166 | <li> Add the ability to search the help text, either in the UI |
| 167 | (on the [/help?cmd=/search|/search page]) or from the command-line |
| 168 | (using the "[/help?cmd=search|fossil search -h PATTERN]" command.) |
| 169 | <li> Accepts an optional SUBCOMMAND argument following the |
| 170 | COMMAND argument and only shows results for the specified |
| 171 | subcommand, not the entire command. |
| 172 | <li> The -u (--usage) option shows only the command-line syntax |
| 173 | <li> The -o (--options) option shows only the command-line options |
| @@ -183,11 +183,11 @@ | |
| 183 | <li> Link the version field in ticket view to a matching checkin or tag. |
| 184 | <li> Show creation time in report and ticket view. |
| 185 | <li> Show previous comments in edit ticket as reference. |
| 186 | </ol> |
| 187 | <li>Added the "hash" query parameter to the |
| 188 | [/help?cmd=/whatis|/whatis webpage]. |
| 189 | <li>Add a "user permissions changes" [/doc/trunk/www/alerts.md|subscription] |
| 190 | which alerts subscribers when an admin creates a new user or |
| 191 | when a user's permissions change. |
| 192 | <li>If the FOSSIL_REPOLIST_SHOW environment variable exists and contains |
| 193 | the substring "description", then the project description for each repository |
| @@ -199,44 +199,44 @@ | |
| 199 | <ol type="a"> |
| 200 | <li> TH1 now makes a distinction between |
| 201 | [/doc/trunk/www/th1.md#taint|tainted and untainted string values]. |
| 202 | This makes it more difficult to write custom TH1 scripts that |
| 203 | contain XSS or SQL-injection bugs. The |
| 204 | [/help?cmd=vuln-report|vuln-report] setting was added to control |
| 205 | what Fossil does when it encounters a potential TH1 |
| 206 | security problem. |
| 207 | <li> The "--th" option was removed from the [/help?cmd=pikchr|fossil pikchr] |
| 208 | command. |
| 209 | <li> The "enable_htmlify" TH1 command was removed. |
| 210 | </ol> |
| 211 | <li>Make [/help?cmd=/chat|/chat] better-behaved during server outages, reducing |
| 212 | the frequency of reconnection attempts over time and providing feedback |
| 213 | to the user when the connection is down. |
| 214 | <li>The [/help?cmd=/sqlar|/sqlar] page does not work for users who are not logged |
| 215 | in, nor are links to that page displayed to users who are not logged in. Being |
| 216 | logged in as "anonymous" is sufficient to overcome this restriction, assuming |
| 217 | that "anonymous" can download tarballs and ZIP archives. |
| 218 | <li>Many other minor fixes and additions. |
| 219 | </ol> |
| 220 | |
| 221 | <h2 id='v2_25'>Changes for version 2.25 (2024-11-06)</h2> |
| 222 | |
| 223 | * The "[/help?cmd=ui|fossil ui /]" command now works even for repositories |
| 224 | that have non-ASCII filenames |
| 225 | * Add the [/help?cmd=tree|fossil tree] command. |
| 226 | * On case-insensitive filesystems, store files using the filesystem's |
| 227 | preferred case rather than the case typed in by the user. |
| 228 | * Change the name "fossil cherry-pick" command to "fossil cherrypick", |
| 229 | which is more familiar to Git users. Retain the legacy name for |
| 230 | compatibility. |
| 231 | * Add new query parameters to the [/help?cmd=/timeline|/timeline page]: |
| 232 | d2=, p2=, and dp2=. |
| 233 | * Add options to the [/help?cmd=tag|fossil tag] command that will list tag values. |
| 234 | * Add the -b|--brief option to the [/help?cmd=status|fossil status] command. |
| 235 | * Add ability to upload unversioned files via the [/help?cmd=/uvlist|/uvlist page]. |
| 236 | * Add history search to the [/help?cmd=/chat|/chat page]. |
| 237 | * Add Unix socket support to the [/help?cmd=server|server command]. |
| 238 | * On Windows, use the root certificates managed by the operating system |
| 239 | (requires OpenSSL 3.2.0 or greater). |
| 240 | * Take into account zero-width and double-width unicode characters when |
| 241 | formatting the command-line timeline. |
| 242 | * Update the built-in SQLite to version 3.47.0. Precompiled binaries are |
| @@ -273,11 +273,11 @@ | |
| 273 | </ul> |
| 274 | * If an "ssh:" sync fails in a way that suggests that the fossil executable |
| 275 | could not be found on the remote host, then retry after adding a PATH= |
| 276 | prefix to the command. This helps "ssh:" to "just work" when the server |
| 277 | is a Mac. |
| 278 | * Enhancements to the [/help?cmd=/timeline|/timeline page]: |
| 279 | <ul> |
| 280 | <li> Add the x= query paramater |
| 281 | <li> Add the shortcut tl= and rl= query parameters |
| 282 | <li> Add support for from=,ft= and from=,bt= query parameter combinations |
| 283 | <li> Automatically highlight the endpoints for from=,to= queries. |
| @@ -287,16 +287,16 @@ | |
| 287 | * Moved the /museum/repo.fossil file referenced from the Dockerfile from |
| 288 | the ENTRYPOINT to the CMD part to allow use of --repolist mode. |
| 289 | * The [/uvlist] page now shows the hash algorithm used so that |
| 290 | viewers don't have to guess. The hash is shown in a fixed-width |
| 291 | font for a more visually pleasing display. |
| 292 | * If the [/help?cmd=autosync|autosync setting] contains keyword "all", |
| 293 | the automatic sync occurs against all defined remote repositories, not |
| 294 | just the default. |
| 295 | * Markdown formatter: improved handling of indented fenced code blocks |
| 296 | that contain blank lines. |
| 297 | * When doing a "[/help?cmd=add|fossil add]" on a system with case-insensitive |
| 298 | but case-preserving filenames (Mac and Windows) try to use the filename |
| 299 | case as it is known to the filesystem, not the case entered by the |
| 300 | user on the command-line. See |
| 301 | [forum:/forumpost/30d9c0d131610f53|forum thread 30d9c0d131610f53]. |
| 302 | * Fix problems with one-click unsubscribe on email notifications. |
| @@ -310,17 +310,17 @@ | |
| 310 | <h2 id='v2_23'>Changes for version 2.23 (2023-11-01)</h2> |
| 311 | |
| 312 | * Add ability to "close" forum threads, such that unprivileged users |
| 313 | may no longer respond to them. Only administrators can close |
| 314 | threads or respond to them by default, and the |
| 315 | [/help?cmd=forum-close-policy|forum-close-policy setting] can be |
| 316 | used to add that capability to moderators. |
| 317 | * Add the [/help?cmd=all|fossil all whatis] command. |
| 318 | * The [/help?cmd=status|fossil status] command and relevant UI pages now |
| 319 | correctly report files which were both renamed <b>and</b> edited as such. |
| 320 | * Show default value of settings that have a default in |
| 321 | [/help?cmd=help|fossil help SETTING] output. |
| 322 | * On timeline graphs, show closed check-ins using an X in the middle of the |
| 323 | node circle or box. |
| 324 | * New options for email notification: Get email only for the first |
| 325 | post in each new thread, and/or posts that are in reply to my posts. |
| 326 | * Fix a regression bug introduced in version 2.22 that caused FTS5 searches |
| @@ -333,35 +333,35 @@ | |
| 333 | <li> Better defense against cross-site request forgery (CSRF) |
| 334 | attacks. |
| 335 | <li> Improvements to static analysis of source code (the codecheck1.c |
| 336 | file in the source tree). |
| 337 | </ul> |
| 338 | * Enhance the [/help?cmd=/dir|treeview file listings] |
| 339 | ([/dir?type=tree&ci=trunk|example]) by displaying file sizes |
| 340 | and adding the option to sort by file size. |
| 341 | * The [/help?cmd=fts-config|fossil fts-config] command now shows how much |
| 342 | repository space is used by the full-text index. |
| 343 | * Changing a setting to an empty string is now the same as deleting the |
| 344 | setting, in most cases. There are a few exceptions, indicated by the |
| 345 | keep-empty flag on the setting definition. |
| 346 | * The [/help?cmd=branch|fossil branch list] command can now filter branches |
| 347 | that have/have not been merged into the current branch. |
| 348 | * Improvements to interactions with remote repositories over SSH: |
| 349 | <ul> |
| 350 | <li> Print the text of the SSH command that is run to do remote interaction, |
| 351 | for full disclosure to the operator. |
| 352 | <li> Add a PATH= argument to the [/help?cmd=ui|fossil ui remote:/] and |
| 353 | [/help?cmd=patch|fossil patch push/pull remote:...] commands so that |
| 354 | they work when the "remote" machine is a Mac and the "fossil" |
| 355 | executable is in the $HOME/bin directory. |
| 356 | </ul> |
| 357 | * Update built-in libraries SQLite, ZLib, Pikchr to their latest versions. |
| 358 | * Documentation enhancements and typo fixes. |
| 359 | |
| 360 | |
| 361 | <h2 id='v2_22'>Changes for version 2.22 (2023-05-31)</h2> |
| 362 | * Enhancements to the [/help?cmd=/timeline|/timeline webpage]: <ol type="a"> |
| 363 | <li> Add the ft=TAG query parameter which in combination with d=Y |
| 364 | shows all descendants of Y up to TAG |
| 365 | <li> Enhance the s=PATTERN (search) query parameter so that forum post |
| 366 | text is also searched when the "vfx" query parameter is used |
| 367 | <li> Fix the u= (user) query parameter so that it works with a= and b= |
| @@ -385,56 +385,56 @@ | |
| 385 | searching in Chinese. |
| 386 | * Comment lines (starting with a '#') are now supported inside |
| 387 | [./settings.wiki#versionable|versioned settings]. |
| 388 | * Default permissions for anonymous users in new repositories are |
| 389 | changed to "hz". |
| 390 | * The [/help?cmd=status|fossil status] command now detects when a |
| 391 | file used to be a symlink and has been replaced by a regular file. |
| 392 | (It previously checked for the inverse case only.) |
| 393 | * The [/help?cmd=empty-dirs|empty-dirs setting] now reuses the same |
| 394 | parser as the *-glob settings instead of its prior idiosyncratic |
| 395 | parser, allowing quoted whitespace in patterns. |
| 396 | * Enhancements to the [/help?cmd=/reports|/reports webpage]: |
| 397 | <ol type="a"> |
| 398 | <li> The by-week, by-month, and by-year options now show an estimated |
| 399 | size of the current week, month, or year as a dashed box. |
| 400 | <li> New sub-categories "Merge Check-ins" and "Non-Merge Check-ins". |
| 401 | </ol> |
| 402 | |
| 403 | <h2 id='v2_21'>Changes for version 2.21 (2023-02-25)</h2> |
| 404 | * Users can request a password reset. This feature is disabled by default. |
| 405 | Use the new [/help?cmd=self-pw-reset|self-pw-reset property] to enable it. |
| 406 | New web pages [/help?cmd=/resetpw|/resetpw] and |
| 407 | [/help?cmd=/reqpwreset|/reqpwreset] added. |
| 408 | * Add the [/help?cmd=repack|fossil repack] command (together with |
| 409 | [/help?cmd=all|fossil all repack]) as a convenient way to optimize the |
| 410 | size of one or all of the repositories on a system. |
| 411 | * Add the ability to put text descriptions on ticket report formats. |
| 412 | * Upgrade the test-find-pivot command to the [/help/merge-base|merge-base command]. |
| 413 | * The [/help?cmd=/chat|/chat page] can now embed fossil-rendered |
| 414 | views of wiki/markdown/pikchr file attachments with the caveat that such |
| 415 | embedding happens in an iframe and thus does not inherit styles and such |
| 416 | from the containing browser window. |
| 417 | * The [/help?cmd=all|fossil all remote] subcommand added to "fossil all". |
| 418 | * Passwords for remembered remote repositories are now stored as irreversible |
| 419 | hashes rather than obscured clear-text, for improved security. |
| 420 | * Add the "nossl" and "nocompress" options to CGI. |
| 421 | * Update search infrastructure from FTS4 to FTS5. |
| 422 | * Add the [/help?cmd=/deltachain|/deltachain] page for debugging purposes. |
| 423 | * Writes to the database are disabled by default if the HTTP request |
| 424 | does not come from the same origin. This enhancement is a defense in depth |
| 425 | measure only; it does not address any known vulnerabilities. |
| 426 | * Improvements to automatic detection and mitigation of attacks from |
| 427 | malicious robots. |
| 428 | |
| 429 | <h2 id='v2_20'>Changes for version 2.20 (2022-11-16)</h2> |
| 430 | * Added the [/help?cmd=chat-timeline-user|chat-timeline-user setting]. If |
| 431 | it is not an empty string, then any changes that would appear on the timeline |
| 432 | are announced in [./chat.md|the chat room]. |
| 433 | * The /unsubscribe page now requests confirmation. [./alerts.md|Email notifications] |
| 434 | now contain only an "Unsubscribe" link, and not a link to subscription management. |
| 435 | * Added the "[/help?cmd=branch|fossil branch lsh]" subcommand to list the |
| 436 | most recently modified branches. |
| 437 | * More elements of the /info page are now inside of an accordion. |
| 438 | * Replace the <tt>--dryrun</tt> flag with <tt>--dry-run</tt> in all |
| 439 | commands which still used the former name, for consistency. |
| 440 | * Rebuilt [/file/Dockerfile | the stock Dockerfile] to create a "from scratch" |
| @@ -464,11 +464,11 @@ | |
| 464 | accomplished using a Common Table Expression in the underlying SQL. |
| 465 | * Sort tag listings (command line and webpage) by taking numbers into |
| 466 | consideration so as to cater for tags that follow semantic versioning. |
| 467 | * On the wiki listings, omit by default wiki pages that are associated with |
| 468 | check-ins and branches. |
| 469 | * Add the new "[/help?cmd=describe|fossil describe]" command. |
| 470 | * Markdown subsystem extended with [../src/markdown.md#ftnts|footnotes support]. |
| 471 | See corresponding [../test/markdown-test3.md|test cases], |
| 472 | [/wiki?name=branch/markdown-footnotes#il|known limitations] and |
| 473 | [forum:/forumthread/ee1f1597e46ec07a|discussion]. |
| 474 | * Add the new special name "start:BRANCH" to refer to the first check-in of |
| @@ -480,96 +480,96 @@ | |
| 480 | operation. Also require explicit "system" proxy setting to use |
| 481 | "http_proxy" environment variable. |
| 482 | * Reimplemented the [/pikchrshow] app to use a WebAssembly build of |
| 483 | pikchr so that it can render pikchrs on the client instead of requiring |
| 484 | a server round-trip. |
| 485 | * Add the [/help?cmd=email-listid|email-listid setting]. If set, it is |
| 486 | used as the List-ID header for all outbound notification emails. |
| 487 | * Add the "--branch" option to the "[/help?cmd=timeline|timeline]" command |
| 488 | to restrict the displayed items to a specific branch. |
| 489 | * Add the "--versions" option to "[/help?cmd=diff|fossil diff]" |
| 490 | to display details about the compared versions into the patch header. |
| 491 | * Numerous other minor enhancements. |
| 492 | |
| 493 | <h2 id='v2_18'>Changes for version 2.18 (2022-02-23)</h2> |
| 494 | * Added support for [./ssl-server.md|SSL/TLS server mode] for commands |
| 495 | like "[/help?cmd=server|fossil server]" and "[/help?cmd=http|fossil http]" |
| 496 | * The new [/help?cmd=cherry-pick|cherry-pick command] is an alias for |
| 497 | [/help?cmd=merge|merge --cherrypick]. |
| 498 | * Add new setting "[/help?cmd=large-file-size|large-file-size]". If the size |
| 499 | of any file in a commit exceeds this size, a warning is issued. |
| 500 | * Query parameter "year=YYYY" is now accepted by [/help?cmd=/timeline|/timeline]. |
| 501 | * The [/help?cmd=tar|tar] and [/help?cmd=zip|zip commands] no longer |
| 502 | sterilize the manifest file. |
| 503 | * Further improvement to diff alignment in cases that involve both |
| 504 | edits and indentation changes. |
| 505 | * [/doc/trunk/www/chat.md|Chat] improvements:<ul> |
| 506 | <li> [/help?cmd=/chat|The /chat page] input options have been reworked |
| 507 | again for better cross-browser portability. |
| 508 | <li> When sending a [/help?cmd=/chat|/chat] message fails, it is no longer |
| 509 | immediately lost and sending may optionally be retried. |
| 510 | <li> [/help?cmd=/chat|/chat] can now optionally embed attachments of certain |
| 511 | types directly into message bodies via an iframe. |
| 512 | <li> Add the "--as FILENAME" option to the "[/help?cmd=chat|fossil chat send]" |
| 513 | command. |
| 514 | <li> Added the "[/help?cmd=chat|fossil chat pull]" command, available to |
| 515 | administrators only, for backing up the chat conversation. |
| 516 | </ul> |
| 517 | * Promote the test-detach command into the [/help?cmd=detach|detach command]. |
| 518 | * For "[/help?cmd=pull|fossil pull]" with the --from-parent-project option, |
| 519 | if no URL is specified then use the last URL from the most recent prior |
| 520 | "fossil pull --from-parent-project". |
| 521 | * Add options --project-name and --project-desc to the |
| 522 | "[/help?cmd=init|fossil init]" command. |
| 523 | * The [/help?cmd=/ext|/ext page] generates the SERVER_SOFTWARE environment |
| 524 | variable for clients. |
| 525 | * Fix the REQUEST_URI [/doc/trunk/www/aboutcgi.wiki#cgivar|CGI variable] such |
| 526 | that it includes the query string. This is how most other systems understand |
| 527 | REQUEST_URI. |
| 528 | * Added the --transport-command option to [/help?cmd=sync|fossil sync] |
| 529 | and similar. |
| 530 | |
| 531 | <h2 id='v2_17'>Changes for version 2.17 (2021-10-09)</h2> |
| 532 | |
| 533 | * Major improvements to the "diff" subsystem, including: <ul> |
| 534 | <li> Added new [/help?cmd=diff|formatting options]: --by, -b, --webpage, --json, --tcl. |
| 535 | <li> Partial-line matching for unified diffs |
| 536 | <li> Better partial-line matching for side-by-side diffs |
| 537 | <li> Buttons on web-based diffs to show more context |
| 538 | <li> Performance improvements |
| 539 | </ul> |
| 540 | * The --branchcolor option on [/help?cmd=commit|fossil commit] and |
| 541 | [/help?cmd=amend|fossil amend] can now take the value "auto" to |
| 542 | force Fossil to use its built-in automatic color choosing algorithm. |
| 543 | * Fossil now [./concepts.wiki#workflow|autosyncs] prior to running |
| 544 | [/help?cmd=open|fossil open]. |
| 545 | * Add the [/help?cmd=ticket-default-report|ticket-default-report setting], |
| 546 | which if set to the title of a ticket report causes that ticket report |
| 547 | to be displayed below the search box in the /ticket page. |
| 548 | * The "nc" query parameter to the [/help?cmd=/timeline|/timeline] page |
| 549 | causes all graph coloring to be omitted. |
| 550 | * Improvements and bug fixes to the new "[/help?cmd=ui|fossil ui REMOTE]" |
| 551 | feature so that it works better on a wider variety of platforms. |
| 552 | * In [/help?cmd=/wikiedit|/wikiedit], show the list of attachments for |
| 553 | the current page and list URLs suitable for pasting them into the page. |
| 554 | * Add the --no-http-compression option to [/help?cmd=sync|fossil sync] |
| 555 | and similar. |
| 556 | * Print total payload bytes on a [/help?cmd=sync|fossil sync] when using |
| 557 | the --verbose option. |
| 558 | * Add the <tt>close</tt>, <tt>reopen</tt>, <tt>hide</tt>, and |
| 559 | </tt>unhide</tt> subcommands to [/help?cmd=branch|the branch command]. |
| 560 | * The "-p" option to [/help?cmd=branch|fossil branch list] shows only |
| 561 | private branches. |
| 562 | * The [/md_rules|Markdown formatter] now interprets the content of |
| 563 | block HTML markup (such as <table>) in most cases. Only content |
| 564 | of <pre> and <script> is passed through verbatim. |
| 565 | * The [/help?cmd=wiki|wiki list command] no longer lists "deleted" |
| 566 | pages by default. Use the new <tt>--all</tt> option to include deleted |
| 567 | pages in the output. |
| 568 | * The [/help?cmd=all|fossil all git status] command only shows reports for |
| 569 | the subset of repositories that have a configured Git export. |
| 570 | * The [/help?cmd=/chat|/chat] configuration was reimplemented and |
| 571 | provides new options, including the ability for a repository |
| 572 | administrator to |
| 573 | [./chat.md#notifications|extend the selection of notification sounds] |
| 574 | using unversioned files. |
| 575 | * Chat now uses fossil's full complement of markdown features, |
| @@ -578,14 +578,14 @@ | |
| 578 | markdown-processed when they are sent instead of when they |
| 579 | are saved. |
| 580 | * Added a chat message preview mode so messages can be previewed |
| 581 | before being sent. Similarly, added a per-message ability to view |
| 582 | the raw un-parsed message text. |
| 583 | * The hotkey to activate preview mode in [/help?cmd=/wikiedit|/wikiedit], |
| 584 | [/help?cmd=/fileedit|/fileedit], and [/help?cmd=/pikchrshow|/pikchrshow] |
| 585 | was changed from ctrl-enter to shift-enter in order to align with |
| 586 | [/help?cmd=/chat|/chat]'s new preview feature and related future |
| 587 | changes. |
| 588 | |
| 589 | <h2 id='v2_16'>Changes for Version 2.16 (2021-07-02)</h2> |
| 590 | * <b>Security:</b> Fix the client-side TLS so that it verifies that the |
| 591 | server hostname matches its certificate. |
| @@ -592,11 +592,11 @@ | |
| 592 | * The default "ssh" command on Windows is changed to "ssh" instead of the |
| 593 | legacy "plink", as ssh is now generally available on Windows systems. |
| 594 | Installations that still need to use the legacy "plink" can make that |
| 595 | happen by running: '<tt>fossil set ssh-command "plink -ssh" --global</tt>'. |
| 596 | * Added the [./patchcmd.md|fossil patch] command. |
| 597 | * The [/help?cmd=ui|fossil ui] command is enhanced in multiple ways:<ol> |
| 598 | <li> The REPOSITORY argument can be the name of a check-out directory. |
| 599 | <li> If the REPOSITORY argument is prefixed by "HOST:" or "USER@HOST:" |
| 600 | then the ui is run on the remote machine and tunnelled back to the local |
| 601 | machine using ssh. (The latest version of fossil must be installed on |
| 602 | both the local and the remote for this to work correctly.) |
| @@ -605,25 +605,25 @@ | |
| 605 | * The [/brlist|/brlist web page] allows the user to |
| 606 | select multiple branches to be displayed together in a single |
| 607 | timeline. |
| 608 | * The [./forum.wiki|Forum] provides a hyperlink on the author of each |
| 609 | post that goes to a timeline of recent posts by that same author. |
| 610 | * Added the "[/help?cmd=bisect|fossil bisect run]" command for improved |
| 611 | automation of bisects. |
| 612 | * The [/help?cmd=merge|fossil merge] command now does a better job merging |
| 613 | branches where files have been renamed between the current branch and the |
| 614 | branch being merged. |
| 615 | * The [/help?cmd=open|fossil open] command allows the repository file |
| 616 | to be inside the working directory without requiring the --force flag. |
| 617 | * The [/help?cmd=/wikiedit|/wikiedit] and [/help?cmd=/wikinew|/wikinew] |
| 618 | pages now default to markdown format. |
| 619 | * The [/help?cmd=/login|/login] page now links to a user's forum post |
| 620 | timeline if the repository has forum posts. |
| 621 | * Tags may now be propagated for forum posts, wiki pages, and technotes. |
| 622 | The [/help?cmd=tag|tag command] can now manipulate and list such tags. |
| 623 | * [./caps/login-groups.md|Login-Groups] are now shown on the repository |
| 624 | list of the "[/help?cmd=all|fossil all ui]" command. |
| 625 | * Administrators can configure [./alerts.md|email alerts] to expire |
| 626 | a specific number of days (ex: 365) after the last user contact with |
| 627 | the Fossil server. This prevents alert emails being sent to |
| 628 | abandoned email accounts forever. |
| 629 | * SQL that defines [/tktsetup_tab|database objects for tickets] now |
| @@ -640,11 +640,11 @@ | |
| 640 | * <b>Patch 2.15.1:</b> Fix a data exfiltration bug in the server. <b>Upgrading to |
| 641 | the patch is recommended.</b> |
| 642 | * The [./defcsp.md|default CSP] has been relaxed slightly to allow |
| 643 | images to be loaded from any URL. All other resources are still |
| 644 | locked down by default. |
| 645 | * The built-in skins all use the "[/help?cmd=mainmenu|mainmenu]" |
| 646 | setting to determine the content of the main menu. |
| 647 | The ability to edit the |
| 648 | "mainmenu" setting is added on the /Admin/Configuration page. |
| 649 | * The hamburger menu is now available on most of the built-in skins. |
| 650 | * Any built-in skin named "X" can be used instead of the standard |
| @@ -654,40 +654,40 @@ | |
| 654 | included. The [/skins] page may be used to select a skin. |
| 655 | * The [/cookies] page now gives the user an opportunity to delete |
| 656 | individual cookies. And the /cookies page is linked from the |
| 657 | /sitemap, so that it appears in hamburger menus. |
| 658 | * The [/sitemap] extensions are now specified by a single new |
| 659 | "[/help?cmd=sitemap-extra|sitemap-extra setting]", |
| 660 | rather than a cluster of various |
| 661 | "sitemap-*" settings. The older settings are no longer used. |
| 662 | <b>This change might require minor server configuration |
| 663 | adjustments on servers that use /sitemap extensions.</b> |
| 664 | The /Admin/Configuration page provides the ability to edit |
| 665 | the new "sitemap-extra" setting. |
| 666 | * Added the "--ckout-alias NAME" option to |
| 667 | [/help?cmd=ui|fossil ui], [/help?cmd=server|fossil server], and |
| 668 | [/help?cmd=http|fossil http]. This option causes Fossil to |
| 669 | understand URIs of the form "/doc/NAME/..." as if they were |
| 670 | "[/help?cmd=/doc|/doc/ckout/...]", to facilitate testing of |
| 671 | [./embeddeddoc.wiki|embedded documentation] changes prior to |
| 672 | check-in. |
| 673 | * For diff web pages, if the diff type (unified versus side-by-side) |
| 674 | is not specified by a query parameter, and if the |
| 675 | "[/help?cmd=preferred-diff-type|preferred-diff-type]" |
| 676 | setting is omitted or less than 1, then select the diff type based |
| 677 | on a guess of whether or not the request is coming from a mobile |
| 678 | device. Mobile gets unified and desktop gets side-by-side. |
| 679 | * The various pages which show diffs now have toggles to show/hide |
| 680 | individual diffs. |
| 681 | * Add the "[/help?cmd=preferred-diff-type|preferred-diff-type]" |
| 682 | setting to allow an admin to force a default diff type. |
| 683 | * The "pikchr-background" setting is now available in |
| 684 | "detail.txt" skin files, for better control of Pikchr |
| 685 | colors in inverted color schemes. |
| 686 | * Add the <tt>--list</tt> option to the |
| 687 | [/help?cmd=tarball|tarball], |
| 688 | [/help?cmd=zip|zip], and [/help?cmd=sqlar|sqlar] |
| 689 | commands. |
| 690 | * The javascript used to implement the hamburger menu on the |
| 691 | default built-in skin has been made generic so that it is usable |
| 692 | by a variety of skins, and promoted to an ordinary built-in |
| 693 | javascript file. |
| @@ -695,24 +695,24 @@ | |
| 695 | "[/doc/trunk/www/th1.md#bireqjs|builtin_request_js]", |
| 696 | "[/doc/trunk/www/th1.md#capexpr|capexpr]", |
| 697 | "foreach", "lappend", and "string match" |
| 698 | * The [/help/leaves|leaves command] now shows the branch point |
| 699 | of each leaf. |
| 700 | * The [/help?cmd=add|fossil add] command refuses to add files whose |
| 701 | names are reserved by Windows (ex: "aux") unless the --allow-reserved |
| 702 | option is included. This helps prevent Unix users from accidentally |
| 703 | creating check-ins that are unreadable by Windows users. |
| 704 | * Add the "re=" query parameter to the [/help?cmd=/dir|/dir] webpage, |
| 705 | for symmetry with the [/help?cmd=/tree|/tree] page. |
| 706 | * Update the built-in SQLite to version 3.35.0. |
| 707 | * The ./configure script now has the --print-minimum-sqlite-version option |
| 708 | that prints the minimum SQLite version required by the current version |
| 709 | of Fossil. This might be used by integrators who insist on building |
| 710 | Fossil to link against the system SQLite library rather than the |
| 711 | built-in copy of SQLite, to verify that their system SQLite library |
| 712 | is recent enough. |
| 713 | * Webpage that shows [/help?cmd=/whistory|history of a wiki page] |
| 714 | gained client-side UI to help with comparison between two arbitrary |
| 715 | versions of a wiki (by the means of anchoring a "baseline" version) |
| 716 | and the ability to squeeze several sequential edits made by the same |
| 717 | user into a single "recycled" row (the latest edit in that sequence). |
| 718 | |
| @@ -732,40 +732,40 @@ | |
| 732 | version 2.14 and then later downgrade or otherwise use an earlier |
| 733 | version of Fossil, the email notification mechanism may fail |
| 734 | to send out notifications for some events, due to the missing |
| 735 | trigger. If you want to |
| 736 | permanently downgrade an installation, then you should run |
| 737 | "[/help?cmd=rebuild|fossil rebuild]" after the downgrade |
| 738 | to get email notifications working again. If you are not using |
| 739 | email notification, then the schema change will not affect you in |
| 740 | any way. |
| 741 | * <b>Schema Update Notice #2:</b> |
| 742 | This release changes how the descriptions of wiki edits are stored |
| 743 | in the EVENT table, for improved display on timelines. You must |
| 744 | run "[/help?cmd=rebuild|fossil rebuild]" to take advantage of |
| 745 | this enhancement. Everything will still work without |
| 746 | "fossil rebuild", except you will get goofy descriptions of |
| 747 | wiki updates in the timeline. |
| 748 | * Add support for [./chat.md|Fossil chat]. |
| 749 | * The "[/help?cmd=clone|fossil clone]" command is enhanced so that |
| 750 | if the repository filename is omitted, an appropriate name is derived |
| 751 | from the remote URL and the newly cloned repo is opened. This makes |
| 752 | the clone command work more like Git, thus making it easier for |
| 753 | people transitioning from Git. |
| 754 | * Added the --mainbranch option to the [/help?cmd=git|fossil git export] |
| 755 | command. |
| 756 | * Added the --format option to the |
| 757 | "[/help?cmd=timeline|fossil timeline]" command. |
| 758 | * Enhance the --numstat option on the |
| 759 | "[/help?cmd=diff|fossil diff]" command so that it shows a total |
| 760 | number of lines added and deleted and total number of files |
| 761 | modified. |
| 762 | * Add the "contact" sub-command to [/help?cmd=user|fossil user]. |
| 763 | * Added commands "[/help?cmd=all|fossil all git export]" and |
| 764 | "[/help?cmd=all|fossil all git status]". |
| 765 | * Added the "df=CHECKIN" query parameter to the |
| 766 | [/help?cmd=/timeline|/timeline page]. |
| 767 | * Improvements to the "[/sitemap]" page. Add subpages |
| 768 | [/sitemap-timeline] and [/sitemap-test]. |
| 769 | * Better text position in cylinder objects of Pikchr diagrams. |
| 770 | * New "details.txt" settings available to custom skins to better control |
| 771 | the rendering of Pikchr diagrams: |
| @@ -787,24 +787,24 @@ | |
| 787 | * Added support for [./interwiki.md|interwiki links]. |
| 788 | * Enable <del> and <ins> markup in wiki. |
| 789 | * Improvements to the Forum threading display. |
| 790 | * Added support for embedding [./pikchr.md|pikchr] |
| 791 | markup in markdown and fossil-wiki content. |
| 792 | * The new "[/help?cmd=pikchr|pikchr]" command can render |
| 793 | pikchr scripts, optionally pre-processed with |
| 794 | [/doc/trunk/www/th1.md|TH1] blocks and variables exactly like |
| 795 | site skins are. |
| 796 | * The new [/help?cmd=/pikchrshow|pikchrshow] page provides an |
| 797 | editor and previewer for pikchr markup. |
| 798 | * In [/help?cmd=/wikiedit|/wikiedit] and |
| 799 | [/help?cmd=/fileedit|/fileedit], Ctrl-Enter can now be used |
| 800 | initiate a preview and to toggle between the editor and preview |
| 801 | tabs. |
| 802 | * The <tt>/artifact</tt> and <tt>/file</tt> views, when in |
| 803 | line-number mode, now support interactive selection of a range |
| 804 | of lines to hyperlink to. |
| 805 | * Enhance the [/help?cmd=/finfo|/finfo] webpage so that when query |
| 806 | parameters identify both a filename and a checkin, the resulting |
| 807 | graph tracks the identified file across renames. |
| 808 | * The built-in SQLite is updated to an alpha of version 3.34.0, and |
| 809 | the minimum SQLite version is increased to 3.34.0 because the |
| 810 | /finfo change in the previous bullet depends on enhancements to |
| @@ -813,18 +813,18 @@ | |
| 813 | * Countless other minor refinements and documentation improvements. |
| 814 | |
| 815 | <h2 id='v2_12'>Changes for Version 2.12.1 (2020-08-20)</h2> |
| 816 | |
| 817 | * (2.12.1): Fix client-side vulnerabilities discovered by Max Justicz. |
| 818 | * Security fix in the "[/help?cmd=git|fossil git export]" command. |
| 819 | The same fix is also backported to version 2.10.1 and 2.11.1. |
| 820 | New "safety-net" features were added to prevent similar problems |
| 821 | in the future. |
| 822 | * Enhancements to the graph display for cases when there are |
| 823 | many cherry-pick merges into a single check-in. |
| 824 | [/timeline?f=2d75e87b760c0a9|Example] |
| 825 | * Enhance the [/help?cmd=open|fossil open] command with the new |
| 826 | --workdir option and the ability to accept a URL as the repository |
| 827 | name, causing the remote repository to be cloned automatically. |
| 828 | Do not allow "fossil open" to open in a non-empty working directory |
| 829 | unless the --keep option or the new --force option is used. |
| 830 | * Enhance the markdown formatter to more closely follow the |
| @@ -833,65 +833,65 @@ | |
| 833 | Underscores in the middle of identifiers (ex: fossil_printf()) |
| 834 | no longer need to be escaped. |
| 835 | * The markdown-to-html translator can prevent unsafe HTML |
| 836 | (for example: <script>) on user-contributed pages like forum and |
| 837 | tickets and wiki. The admin can adjust this behavior using |
| 838 | the [/help?cmd=safe-html|safe-html setting] on the Admin/Wiki page. |
| 839 | The default is to disallow unsafe HTML everywhere. |
| 840 | [https://fossil-scm.org/forum/forumpost/3714e6568f|Example]. |
| 841 | * Added the "collapse" and "expand" capability for long forum posts. |
| 842 | [https://fossil-scm.org/forum/forumpost/9297029862|Example] |
| 843 | * The "[/help?cmd=remote-url|fossil remote]" command now has options for |
| 844 | specifying multiple persistent remotes with symbolic names. Currently |
| 845 | only one remote can be used at a time, but that might change in the |
| 846 | future. |
| 847 | * Add the "Remember me?" checkbox on the login page. Use a session |
| 848 | cookie for the login if it is not checked. |
| 849 | * Added the experimental "[/help?cmd=hook|fossil hook]" command for |
| 850 | managing "hook scripts" that run before checkin or after a push. |
| 851 | * Enhance the [/help?cmd=revert|fossil revert] command so that it |
| 852 | is able to revert all files beneath a directory. |
| 853 | * Add the [/help?cmd=bisect|fossil bisect skip] command. |
| 854 | * Add the [/help?cmd=backup|fossil backup] command. |
| 855 | * Enhance [/help?cmd=bisect|fossil bisect ui] so that it shows all unchecked |
| 856 | check-ins in between the innermost "good" and "bad" check-ins. |
| 857 | * Added the <tt>--reset</tt> flag to the "[/help?cmd=add|fossil add]", |
| 858 | "[/help?cmd=rm|fossil rm]", and |
| 859 | "[/help?cmd=addremove|fossil addremove]" commands. |
| 860 | * Added the "<tt>--min</tt> <i>N</i>" and "<tt>--logfile</tt> <i>FILENAME</i>" |
| 861 | flags to the [/help?cmd=backoffice|backoffice] command, as well as other |
| 862 | enhancements to make the backoffice command a viable replacement for |
| 863 | automatic backoffice. Other incremental backoffice improvements. |
| 864 | * Added the [/help?cmd=/fileedit|/fileedit page], which allows |
| 865 | editing of text files online. Requires explicit activation by |
| 866 | a setup user. |
| 867 | * Translate built-in help text into HTML for display on web pages. |
| 868 | [/help?cmd=help|Example]. |
| 869 | * On the [/help?cmd=/timeline|/timeline] webpage, the combination |
| 870 | of query parameters "p=CHECKIN" and "bt=ANCESTOR" draws all |
| 871 | ancestors of CHECKIN going back to ANCESTOR. For example, |
| 872 | [/timeline?p=202006271506&bt=version-2.11] shows all ancestors |
| 873 | of the checkin that occurred on 2020-06-27 15:06 going back to |
| 874 | the 2.11 release. |
| 875 | * Update the built-in SQLite so that the |
| 876 | "[/help?cmd=sql|fossil sql]" command supports new output |
| 877 | modes ".mode box" and ".mode json". |
| 878 | * Add the "<tt>obscure()</tt>" SQL function to the |
| 879 | "[/help?cmd=sql|fossil sql]" command. |
| 880 | * Added virtual tables "<tt>helptext</tt>" and "<tt>builtin</tt>" to |
| 881 | the "[/help?cmd=sql|fossil sql]" command, providing access to the |
| 882 | dispatch table including all help text, and the builtin data files, |
| 883 | respectively. |
| 884 | * [./delta_format.wiki|Delta compression] is now applied to forum edits. |
| 885 | * The [/help?cmd=/wikiedit|wiki editor] has been modernized and is |
| 886 | now Ajax-based. The WYSIWYG editing option for Fossil-format wiki |
| 887 | pages was removed. (Please let us know, via the site's Forum menu, |
| 888 | if that removal unduly impacts you.) This also changes the semantics |
| 889 | of the wiki "Sandbox": that pseudo-page may be freely edited but |
| 890 | no longer saved via the UI (the [/help?cmd=wiki|wiki CLI command] |
| 891 | can, though). |
| 892 | * The [/help?cmd=allow-symlinks|allow-symlinks setting] no longer |
| 893 | syncs. It must be activated individually on any clones which require |
| 894 | symlinks. |
| 895 | * Countless documentation enhancements. |
| 896 | |
| 897 | <h2 id='v2_11'>Changes for Version 2.11 (2020-05-25)</h2> |
| @@ -903,46 +903,46 @@ | |
| 903 | can now omit punctation. So, for example, "202004181942" and |
| 904 | "2020-04-18 19:42" mean the same thing. |
| 905 | * Enhance backlink processing so that it works with Markdown-formatted |
| 906 | tickets and so that it works for wiki pages. |
| 907 | Ticket [a3572c6a5b47cd5a]. |
| 908 | <ul><li> "[/help?cmd=rebuild|fossil rebuild]" is needed to |
| 909 | take full advantage of this fix. Fossil will continue |
| 910 | to work without the rebuild, but the new backlinks will be missing.</ul> |
| 911 | * The algorithm for finding the |
| 912 | [./tech_overview.wiki#configloc|location of the configuration database] |
| 913 | is enhanced to be XDG-compliant. |
| 914 | * Add a hide/show feature to |
| 915 | [./wikitheory.wiki#assocwiki|associated wiki] display on |
| 916 | check-in and branch information pages. |
| 917 | * Enhance the "[/help?cmd=info|fossil info]" command so that it |
| 918 | works with no arguments even if not within an open check-out. |
| 919 | * Many improvements to the forum and especially email notification |
| 920 | of forum posts, in response to community feedback after switching |
| 921 | SQLite support from a mailing list over to the forum. |
| 922 | * Minimum length of a self-registered user ID increased from 3 to 6 |
| 923 | characters. |
| 924 | * When the "vfx" query parameter is used on the |
| 925 | "[/help?cmd=/timeline|/timeline]" page, it causes the complete |
| 926 | text of forum posts to be displayed. |
| 927 | * Rework the "[/help?cmd=grep|fossil grep]" command to be more useful. |
| 928 | * Expose the [/help?cmd=redirect-to-https|redirect-to-https] |
| 929 | setting to the [/help?cmd=settings|settings] command. |
| 930 | * Improve support for CGI on IIS web servers. |
| 931 | * The [./serverext.wiki|/ext page] can now render index files, |
| 932 | in the same way as the embedded docs. |
| 933 | * Most commands now support the Unix-conventional "<tt>--</tt>" |
| 934 | flag to treat all following arguments as filenames |
| 935 | instead of flags. |
| 936 | * Added the [/help?cmd=mimetypes|mimetypes config setting] |
| 937 | (versionable) to enable mimetype overrides and custom definitions. |
| 938 | * Add an option on the /Admin/Timeline setup page to set a default |
| 939 | timeline style other than "Modern". |
| 940 | * In [./embeddeddoc.wiki|embedded documentation], hyperlink URLs |
| 941 | of the form "/doc/$CURRENT/..." the "$CURRENT" text is translated |
| 942 | into the check-in hash for the document currently being viewed. |
| 943 | * Added the [/help?cmd=/phantoms|/phantoms] webpage that shows all |
| 944 | phantom artifacts. |
| 945 | * Enhancements to phantom processing to try to reduce |
| 946 | bandwidth-using chatter about phantoms on the sync protocol. |
| 947 | * Security: Fossil now assumes that the schema of every |
| 948 | database it opens has been tampered with by an adversary and takes |
| @@ -950,23 +950,23 @@ | |
| 950 | * Security: Fossil now puts the Content-Security-Policy in the |
| 951 | HTTP reply header, in addition to also leaving it in the |
| 952 | HTML <head> section, so that it is always available, even |
| 953 | if a custom skin overrides the HTML <head> and omits |
| 954 | the CSP in the process. |
| 955 | * Output of the [/help?cmd=diff|fossil diff -y] command automatically |
| 956 | adjusts according to the terminal width. |
| 957 | * The Content-Security-Policy is now set using the |
| 958 | [/help?cmd=default-csp|default-csp setting]. |
| 959 | * Merge conflicts caused via the [/help?cmd=merge|merge] and |
| 960 | [/help?cmd=update|update] commands no longer leave temporary |
| 961 | files behind unless the new <tt>--keep-merge-files</tt> flag |
| 962 | is used. |
| 963 | * The [/help?cmd=/artifact_stats|/artifact_stats page] is now accessible |
| 964 | to all users if the new "artifact_stats_enable" setting is turned |
| 965 | on. There is a new checkbox under the /Admin/Access menu to turn |
| 966 | that capability on and off. |
| 967 | * Add the [/help?cmd=tls-config|fossil tls-config] command for viewing |
| 968 | the TLS configuration and the list of SSL Cert exceptions. |
| 969 | * Captchas all include a button to read the captcha using an audio |
| 970 | file, so that they can be completed by the visually impaired. |
| 971 | * Stop using the IP address as part of the login cookie. |
| 972 | * Bug fix: fix the SSL cert validation logic so that if an exception |
| @@ -987,27 +987,27 @@ | |
| 987 | <h2 id='v2_10'>Changes for Version 2.10 (2019-10-04)</h2> |
| 988 | |
| 989 | * (2.10.2): backport security fixes from 2.12.1 |
| 990 | * (2.10.1): backport security fix for the "fossil git export" command. |
| 991 | * Added support for [./serverext.wiki|CGI-based Server Extensions]. |
| 992 | * Added the [/help?cmd=repolist-skin|repolist-skin] setting used to |
| 993 | add style to repository list pages. |
| 994 | * Enhance the hierarchical display of Forum threads to do less |
| 995 | indentation and to provide links back to the previous message |
| 996 | in the thread. Provide sequential numbers for all messages in |
| 997 | a forum thread. |
| 998 | * Add support for fenced code blocks and improved hyperlink |
| 999 | processing to the [/md_rules|markdown formatter]. |
| 1000 | * Add support for hyperlinks to wiki pages in the |
| 1001 | [/md_rules|markdown formatter]. |
| 1002 | * Enhance the [/help?cmd=/stat|/stat] page so that it gives the |
| 1003 | option to show a breakdown of forum posts. |
| 1004 | * The special check-in name "merge-in:BRANCH" means the source of |
| 1005 | the most recent merge-in from the parent branch of BRANCH. |
| 1006 | * Add hyperlinks to branch-diffs on the /info page and from |
| 1007 | timelines of a branch. |
| 1008 | * Add graphical context on the [/help?cmd=/vdiff|/vdiff] page. |
| 1009 | * Uppercase query parameters, POST parameters, and cookie names are |
| 1010 | converted to all lowercase and entered into the parameter set, |
| 1011 | instead of being discarded. |
| 1012 | * Change the default [./hashpolicy.wiki|hash policy] to SHA3. |
| 1013 | * Timeout [./server/any/cgi.md|CGI requests] after 300 seconds, or |
| @@ -1020,14 +1020,14 @@ | |
| 1020 | * Performance optimizations. |
| 1021 | * Many documentation improvements. |
| 1022 | |
| 1023 | <h2 id='v2_9'>Changes for Version 2.9 (2019-07-13)</h2> |
| 1024 | |
| 1025 | * Added the [/help?cmd=git|fossil git export] command and instructions |
| 1026 | for [./mirrortogithub.md|creating a GitHub mirror of a Fossil project]. |
| 1027 | * Improved handling of relative hyperlinks on the |
| 1028 | [/help?cmd=/artifact|/artifact] pages for wiki. For example, |
| 1029 | hyperlinks and the lizard <img> now work correctly |
| 1030 | for both [/artifact/2ff24ab0887cf522] and |
| 1031 | [/doc/0d7ac90d575004c2415/www/index.wiki]. |
| 1032 | * Enhancements to the timeline graph layout, to show more information |
| 1033 | with less clutter. |
| @@ -1036,28 +1036,28 @@ | |
| 1036 | configuration. |
| 1037 | * Copy buttons added to various check-in hash and branch name links. |
| 1038 | * Double-clicking on a /timeline graph node now jumps to the /info page |
| 1039 | for the check-in. So, repurpose the timestamp hyperlink to show all |
| 1040 | activity around that check-in in time. |
| 1041 | * Added the [/help?cmd=touch|fossil touch] command, and the --setmtime |
| 1042 | option on the [/help?cmd=open|fossil open] and |
| 1043 | [/help?cmd=update|fossil update] commands. |
| 1044 | * Many documentation enhancements. |
| 1045 | * For the "[/help?cmd=update|fossil update]" and |
| 1046 | "[/help?cmd=checkout|fossil checkout]" commands, if a |
| 1047 | managed file is removed because it is no longer part of the target |
| 1048 | check-in and the directory containing the file is empty after the |
| 1049 | file is removed and the directory is not the current working |
| 1050 | directory and is not on the [/help?cmd=empty-dirs|empty-dirs] |
| 1051 | list, then also remove the directory. |
| 1052 | * Update internal Unicode character tables, used in regular expression |
| 1053 | handling, from version 11.0 to 12.1. |
| 1054 | * In "[/help?cmd=regexp|fossil regexp]", "[/help?cmd=grep|fossil grep]" |
| 1055 | and the TH1 "regexp" command, the -nocase option now removes multiple |
| 1056 | diacritics from the same character (derived from SQLite's |
| 1057 | remove_diacritics=2) |
| 1058 | * Added the [/help?cmd=/secureraw|/secureraw] page that requires the |
| 1059 | complete SHA1 or SHA3 hash, not just a prefix, before it will deliver |
| 1060 | content. |
| 1061 | * Accept purely numeric ISO8601 date/time strings as long as they |
| 1062 | do not conflict with a hash. Example: "20190510134217" instead of |
| 1063 | "2019-05-10 13:42:17". This helps keep URLs shorter and less |
| @@ -1070,19 +1070,19 @@ | |
| 1070 | extra path element is not needed. |
| 1071 | * If an automatic sync gets a permanent redirect request, then update |
| 1072 | the saved remote URL to the new address. |
| 1073 | * Temporary filenames (for example used for external "diff" commands) |
| 1074 | try to preserve the suffix of the original file. |
| 1075 | * Added the [/help?cmd=/thisdayinhistory|/thisdayinhistory] web page. |
| 1076 | * Enhanced parsing of [/help?cmd=/timeline|/timeline] query parameters |
| 1077 | "ymd=", "ym=", and "yw=". All arguments are option (in which case they |
| 1078 | default to the current time) and all accept ISO8601 date/times without |
| 1079 | punctuation. |
| 1080 | * Automatically disapprove pending moderation requests for a user when |
| 1081 | that user is deleted. This helps in dealing with spam-bots. |
| 1082 | * Improvements to the "Capability Summary" section in the |
| 1083 | [/help?cmd=/secaudit0|Security Audit] web-page. |
| 1084 | * Use new "ci-lock" and "ci-lock-failed" pragmas in the |
| 1085 | [./sync.wiki|sync protocol] to try to prevent accident forks |
| 1086 | caused by concurrent commits when operating in auto-sync mode. |
| 1087 | * Fix a bug ([https://fossil-scm.org/forum/forumpost/c51b9a1169|details]) |
| 1088 | that can cause repository databases to be overwritten with debugging |
| @@ -1183,11 +1183,11 @@ | |
| 1183 | included in the header or footer. |
| 1184 | * Add the [./backoffice.md|backoffice]. |
| 1185 | * Update internal Unicode character tables, used in regular expression |
| 1186 | handling, from version 10.0 to 11.0. |
| 1187 | * Improvements to the "Security Audit" administration page |
| 1188 | * Add the [/help?cmd=branch|fossil branch current] command. |
| 1189 | * Add the [./grep.md|grep] command. |
| 1190 | * Update the built-in SQLite to version 3.25.1. |
| 1191 | * Some code and interfaces are in place to support sending and |
| 1192 | receiving email directly via SMTP, but this feature is not yet |
| 1193 | complete or ready for production use. |
| @@ -1206,20 +1206,20 @@ | |
| 1206 | same as "Verbose" in the previous release. The "Verbose" mode is |
| 1207 | now like "Compact" except the extra check-in details are shown by |
| 1208 | default. |
| 1209 | * Add support for ETags:, Last-Modified:, and If-Modified-Since: |
| 1210 | cache control mechanisms. |
| 1211 | * Enhance the [/help?cmd=/tarball|/tarball], |
| 1212 | [/help?cmd=/zip|/zip], and |
| 1213 | [/help?cmd=/sqlar|/sqlar] pages so that the checkin |
| 1214 | name to be downloaded can be expressed as part of the URI, |
| 1215 | and without the need for query parameters. |
| 1216 | * On the [/help?cmd=/timeline|/timeline] webpage, add the days=N |
| 1217 | query parameter and enhance the ymd=DATE and yw=DATE query parameters |
| 1218 | to accept 'now' as an argument to show the latest day or week. |
| 1219 | * In the web page that comes up in response to the |
| 1220 | [/help?cmd=all|fossil all ui] command, show the last modification |
| 1221 | time for each repository, and allow click-to-sort on the modification |
| 1222 | time column. |
| 1223 | * In the tarball cache replacement algorithm, give extra weight to |
| 1224 | tarballs that have been accessed more than once. |
| 1225 | * Additional defenses against web-based attacks. There have not been |
| @@ -1266,35 +1266,35 @@ | |
| 1266 | to define their own URLs on the web interface that are rewritten to |
| 1267 | built-in URLs with specific parameters. Create and configure URL Aliases |
| 1268 | using the /Setup/URL_Aliases menu option in the web interface. |
| 1269 | * Add tech-note search capability. |
| 1270 | * Add the -r|--revision and -o|--origin options to the |
| 1271 | [/help?cmd=annotate|annotate] command. |
| 1272 | * Add the origin= query parameter to the [/help?cmd=/annotate|/annotate] |
| 1273 | webpage. |
| 1274 | * The [/help?cmd=annotate|fossil annotate] command and the |
| 1275 | [/help?cmd=/annotate|/annotate] web page go backwards in time as far |
| 1276 | as can be computed in 30 milliseconds by default, rather than stopping |
| 1277 | after 20 steps. The new limit= query parameter or the --limit command-line |
| 1278 | option can be used to alter this timeout. |
| 1279 | * Provide separate [/help#settings|on-line help screens for each setting]. |
| 1280 | * Back out support for the --no-dir-symlinks option |
| 1281 | * Remove support from the legacy configuration sync protocol. The only |
| 1282 | way now to do a configuration push or pull is to use the new protocol that |
| 1283 | was added in 2011. |
| 1284 | * Add the from= and to= query parameters to [/help?cmd=/fdiff|/fdiff] |
| 1285 | in order to get a diff of two files in the same check-in. |
| 1286 | * Fix the "ssh://" protocol to prevent an attack whereby the attacker convinces |
| 1287 | a victim to run a "clone" with a dodgy URL and thereby gains access to their |
| 1288 | system. |
| 1289 | * Provide a checkbox that will temporarily disable all ad-units. |
| 1290 | * Improvements to the [/help?cmd=/stat|/stat] page |
| 1291 | * Various new hyperlinks to the [/help?cmd=/bloblist|/bloblist] |
| 1292 | and [/help?cmd=/bigbloblist|/bigbloblist] pages. |
| 1293 | * Correct the [/help?cmd=/doc|/doc] page to support read-only repositories. |
| 1294 | * Correct [/help?cmd=/zip|/zip], [/help?cmd=/tarball|/tarball], |
| 1295 | [/help?cmd=zip|zip], and [/help?cmd=tarball|tarball] pages and commands to |
| 1296 | honor the versioned manifest setting when outside of an open checkout |
| 1297 | directory. |
| 1298 | * The admin-log and access-log settings are now on by default for |
| 1299 | new repositories. |
| 1300 | * Update the built-in SQLite to version 3.21.0. |
| @@ -1302,34 +1302,34 @@ | |
| 1302 | <h2 id='v2_3'>Changes for Version 2.3 (2017-07-21)</h2> |
| 1303 | |
| 1304 | * Update the built-in SQLite to version 3.20.0 (beta). |
| 1305 | * Update internal Unicode character tables, used in regular expression |
| 1306 | handling, from version 9.0 to 10.0. |
| 1307 | * Show the last-sync-URL on the [/help?cmd=/urllist|/urllist] page. |
| 1308 | * Added the "Event Summary" activity report. |
| 1309 | [/reports?type=ci&view=lastchng|example] |
| 1310 | * Added the "Security Audit" page, available to administrators only |
| 1311 | * Added the Last Login time to the user list page, for administrators only |
| 1312 | * Added the --numstat option to the [/help?cmd=diff|fossil diff] command |
| 1313 | * Limit the size of the heap and stack on unix systems, as a proactive |
| 1314 | defense against the |
| 1315 | [https://www.qualys.com/2017/06/19/stack-clash/stack-clash.txt|Stack Clash] |
| 1316 | attack. |
| 1317 | * Fix "database locked" warnings caused by "PRAGMA optimize". |
| 1318 | * Fix a potential XSS vulnerability on the |
| 1319 | [/help?cmd=/help|/help] webpage. |
| 1320 | * Documentation updates |
| 1321 | |
| 1322 | <h2 id='v2_2'>Changes for Version 2.2 (2017-04-11)</h2> |
| 1323 | |
| 1324 | * GIT comment tags are now handled by Fossil during import/export. |
| 1325 | * Show the content of README files on directory listings. |
| 1326 | ([/file/skins|example]) |
| 1327 | * Support for Basic Authentication if enabled (default off). |
| 1328 | * Show the hash algorithms used on the |
| 1329 | [/help?cmd=/rcvfromlist|/rcvfromlist] page. |
| 1330 | * The [/help?cmd=/tarball|/tarball] and [/help?cmd=/zip|/zip] pages |
| 1331 | now use the the r= query parameter |
| 1332 | to select which check-in to deliver. The uuid= query parameter |
| 1333 | is still accepted for backwards compatibility. |
| 1334 | * Update the built-in SQLite to version 3.18.0. |
| 1335 | * Run "[https://www.sqlite.org/pragma.html#pragma_optimize|PRAGMA optimize]" |
| @@ -1338,12 +1338,12 @@ | |
| 1338 | <h2 id='v2_1'>Changes for Version 2.1 (2017-03-10)</h2> |
| 1339 | |
| 1340 | * Add support for [./hashpolicy.wiki|hash policies] that control which |
| 1341 | of the Hardened-SHA1 or SHA3-256 algorithms is used to name new |
| 1342 | artifacts. |
| 1343 | * Add the "gshow" and "gcat" subcommands to [/help?cmd=stash|fossil stash]. |
| 1344 | * Add the [/help?cmd=/juvlist|/juvlist] web page and use it to construct |
| 1345 | the [/uv/download.html|Download Page] of the Fossil self-hosting website |
| 1346 | using Ajax. |
| 1347 | |
| 1348 | <h2 id='v2_0'>Changes for Version 2.0 (2017-03-03)</h2> |
| 1349 | |
| @@ -1351,23 +1351,23 @@ | |
| 1351 | [https://github.com/cr-marcstevens/sha1collisiondetection|hardened SHA1] |
| 1352 | implementation by Marc Stevens and Dan Shumow. |
| 1353 | * Add the ability to read and understand |
| 1354 | [./fileformat.wiki#names|artifact names] that are based on SHA3-256 |
| 1355 | rather than SHA1, but do not actually generate any such names. |
| 1356 | * Added the [/help?cmd=sha3sum|sha3sum] command. |
| 1357 | * Update the built-in SQLite to version 3.17.0. |
| 1358 | |
| 1359 | <h2 id='v1_37'>Changes for Version 1.37 (2017-01-16)</h2> |
| 1360 | |
| 1361 | * Add checkbox widgets to various web pages. See [/technote/8d18bf27e9| |
| 1362 | this technote] for more information. To get the checkboxes to look as |
| 1363 | intended, you must update the CSS in your repository and all clones. |
| 1364 | * Add the [/help/all|fossil all ui] command |
| 1365 | * Add the [/help?cmd=/file|/file] webpage |
| 1366 | * Enhance the [/help?cmd=/brlist|/brlist] webpage to make use of branch colors. |
| 1367 | * Add support for the ms=EXACT|LIKE|GLOB|REGEXP query parameter on the |
| 1368 | [/help?cmd=/timeline|/timeline] webpage, with associated form widgets. |
| 1369 | * Enhance the [/help/changes|changes] and [/help/status|status] commands |
| 1370 | with many new filter options so that specific kinds of changes can be |
| 1371 | found without having to pipe through grep or sed. |
| 1372 | * Enhanced the [/help/sqlite3|fossil sql] command so that it opens the |
| 1373 | [./tech_overview.wiki#localdb|checkout database] and the |
| @@ -1380,11 +1380,11 @@ | |
| 1380 | </ul> |
| 1381 | * Rename crnl-glob [/help/settings|setting] to crlf-glob, but keep |
| 1382 | crnl-glob as a compatibility alias. |
| 1383 | * Added the --command option to the [/help/diff|diff] command. |
| 1384 | * Fix a C99-ism that prevents the 1.36 release from building with MSVC. |
| 1385 | * Fix [/help?cmd=ticket|ticket set] when using the "+" prefix with fields |
| 1386 | from the "ticketchng" table. |
| 1387 | * Remove the "fusefs" command from builds that do not have the underlying |
| 1388 | support enabled. |
| 1389 | * Fixes for incremental git import/export. |
| 1390 | * Minor security enhancements to |
| @@ -1394,58 +1394,58 @@ | |
| 1394 | |
| 1395 | |
| 1396 | <h2 id='v1_36'>Changes for Version 1.36 (2016-10-24)</h2> |
| 1397 | |
| 1398 | * Add support for [./unvers.wiki|unversioned content], |
| 1399 | the [/help?cmd=unversioned|fossil unversioned] command and the |
| 1400 | [/help?cmd=/uv|/uv] and [/uvlist] web pages. |
| 1401 | * The [/uv/download.html|download page] is moved into |
| 1402 | [./unvers.wiki|unversioned content] so that the self-hosting Fossil |
| 1403 | websites no longer uses any external content. |
| 1404 | * Added the "Search" button to the graphical diff generated by |
| 1405 | the --tk option on the [/help?cmd=diff|diff] command. |
| 1406 | * Added the "--checkin VERSION" option to the |
| 1407 | [/help?cmd=diff|diff] command. |
| 1408 | * Various performance enhancements to the [/help?cmd=diff|diff] command. |
| 1409 | * Update internal Unicode character tables, used in regular expression |
| 1410 | handling, from version 8.0 to 9.0. |
| 1411 | * Update the built-in SQLite to version 3.15. Fossil now requires |
| 1412 | the SQLITE_DBCONFIG_MAINDBNAME interface of SQLite which is only available |
| 1413 | in SQLite version 3.15 and later and so Fossil will not work with |
| 1414 | earlier SQLite versions. |
| 1415 | * Fix [https://www.mail-archive.com/[email protected]/msg23618.html|multi-line timeline bug] |
| 1416 | * Enhance the [/help?cmd=purge|fossil purge] command. |
| 1417 | * New command [/help?cmd=shell|fossil shell]. |
| 1418 | * SQL parameters whose names are all lower-case in Ticket Report SQL |
| 1419 | queries are filled in using HTTP query parameter values. |
| 1420 | * Added support for [./childprojects.wiki|child projects] that are |
| 1421 | able to pull from their parent but not push. |
| 1422 | * Added the -nocomplain option to the TH1 "query" command. |
| 1423 | * Added support for the chng=GLOBLIST query parameter on the |
| 1424 | [/help?cmd=/timeline|/timeline] webpage. |
| 1425 | |
| 1426 | <h2 id='v1_35'>Changes for Version 1.35 (2016-06-14)</h2> |
| 1427 | |
| 1428 | * Enable symlinks by default on all non-Windows platforms. |
| 1429 | * Enhance the [/md_rules|Markdown formatting] so that hyperlinks that begin |
| 1430 | with "/" are relative to the root of the Fossil repository. |
| 1431 | * Rework the [/help?cmd=/setup_ulist|/setup_list page] (the User List page) |
| 1432 | to display all users in a click-to-sort table. |
| 1433 | * Fix backslash-octal escape on filenames while importing from git |
| 1434 | * When markdown documents begin with <h1> HTML elements, use that |
| 1435 | header at the document title. |
| 1436 | * Added the [/help?cmd=/bigbloblist|/bigbloblist page]. |
| 1437 | * Enhance the [/help?cmd=/finfo|/finfo page] so that when it is showing |
| 1438 | the ancestors of a particular file version, it only shows direct |
| 1439 | ancestors and omits changes on branches, thus making it show the same set |
| 1440 | of ancestors that are used for [/help?cmd=/blame|/blame]. |
| 1441 | * Added the --page option to the [/help?cmd=ui|fossil ui] command |
| 1442 | * Added the [/help?cmd=bisect|fossil bisect ui] command |
| 1443 | * Enhanced the [/help?cmd=diff|fossil diff] command so that it accepts |
| 1444 | directory names as arguments and computes diffs on all files contained |
| 1445 | within those directories. |
| 1446 | * Fix the [/help?cmd=add|fossil add] command so that it shows "SKIP" for |
| 1447 | files added that were already under management. |
| 1448 | * TH1 enhancements: |
| 1449 | <ul><li>Add <nowiki>[array exists]</nowiki> command.</li> |
| 1450 | <li>Add minimal <nowiki>[array names]</nowiki> command.</li> |
| 1451 | <li>Add tcl_platform(engine) and tcl_platform(platform) array |
| @@ -1453,32 +1453,32 @@ | |
| 1453 | </ul> |
| 1454 | * Get autosetup working with MinGW. |
| 1455 | * Fix autosetup detection of zlib in the source tree. |
| 1456 | * Added autosetup detection of OpenSSL when it may be present under the |
| 1457 | "compat" subdirectory of the source tree. |
| 1458 | * Added the [/help?cmd=reparent|fossil reparent] command |
| 1459 | * Added --include and --exclude options to [/help?cmd=tarball|fossil tarball] |
| 1460 | and [/help?cmd=zip|fossil zip] and the in= and ex= query parameters to the |
| 1461 | [/help?cmd=/tarball|/tarball] and [/help?cmd=/zip|/zip] web pages. |
| 1462 | * Add support for [./encryptedrepos.wiki|encrypted Fossil repositories]. |
| 1463 | * If the FOSSIL_PWREADER environment variable is set, then use the program it |
| 1464 | names in place of getpass() to read passwords and passphrases |
| 1465 | * Option --baseurl now works on Windows. |
| 1466 | * Numerous documentation improvements. |
| 1467 | * Update the built-in SQLite to version 3.13.0. |
| 1468 | |
| 1469 | <h2 id='v1_34'>Changes for Version 1.34 (2015-11-02)</h2> |
| 1470 | |
| 1471 | * Make the [/help?cmd=clean|fossil clean] command undoable for files less |
| 1472 | than 10MiB. |
| 1473 | * Update internal Unicode character tables, used in regular expression |
| 1474 | handling, from version 7.0 to 8.0. |
| 1475 | * Add the new [/help?cmd=amend|amend] command which is used to modify |
| 1476 | tags of a "check-in". |
| 1477 | * Fix bug in [/help?cmd=import|import] command, handling version 3 of |
| 1478 | the svndump format for subversion. |
| 1479 | * Add the [/help?cmd=all|all cache] command. |
| 1480 | * TH1 enhancements: |
| 1481 | <ul><li>Add minimal <nowiki>[lsearch]</nowiki> command. Only exact |
| 1482 | case-sensitive matching is supported.</li> |
| 1483 | <li>Add the <nowiki>[glob_match]</nowiki>, <nowiki>[markdown]</nowiki>, |
| 1484 | <nowiki>[dir]</nowiki>, and <nowiki>[encode64]</nowiki> commands.</li> |
| @@ -1485,106 +1485,106 @@ | |
| 1485 | <li>Add the <nowiki>[tclIsSafe] and [tclMakeSafe]</nowiki> commands to |
| 1486 | the Tcl integration subsystem.</li> |
| 1487 | <li>Add 'double', 'integer', and 'list' classes to the |
| 1488 | <nowiki>[string is]</nowiki> command.</li> |
| 1489 | </ul> |
| 1490 | * Add the --undo option to the [/help?cmd=diff|diff] command. |
| 1491 | * Build-in Antirez's "linenoise" command-line editing library for use with |
| 1492 | the [/help?cmd=sqlite3|fossil sql] command on Unix platforms. |
| 1493 | * Add [/help?cmd=stash|stash cat] as an alias for the |
| 1494 | [/help?cmd=stash|stash show] command. |
| 1495 | * Automatically pull before [/help?cmd=merge|fossil merge] when auto-sync |
| 1496 | is enabled. |
| 1497 | * Fix --hard option to [/help?cmd=mv|fossil mv] and [/help?cmd=rm|fossil rm] |
| 1498 | to enable them to work properly with certain relative paths. |
| 1499 | * Change the mimetype for ".n" and ".man" files to text/plain. |
| 1500 | * Display improvements in the [/help?cmd=bisect|fossil bisect chart] command. |
| 1501 | * Updated the built-in SQLite to version 3.9.1 and activated JSON1 and FTS5 |
| 1502 | support (both currently unused within Fossil). |
| 1503 | |
| 1504 | <h2 id='v1_33'>Changes for Version 1.33 (2015-05-23)</h2> |
| 1505 | * Improved fork detection on [/help?cmd=update|fossil update], |
| 1506 | [/help?cmd=status|fossil status] and related commands. |
| 1507 | * Change the default skin to what used to be called "San Francisco Modern". |
| 1508 | * Add the [/repo-tabsize] web page |
| 1509 | * Add [/help?cmd=import|fossil import --svn], for importing a subversion |
| 1510 | repository into fossil which was exported using "svnadmin dump". |
| 1511 | * Add the "--compress-only" option to [/help?cmd=rebuild|fossil rebuild]. |
| 1512 | * Use a pie chart on the [/reports?view=byuser] page. |
| 1513 | * Enhanced [/help?cmd=clean|fossil clean --verily] so that it ignores |
| 1514 | keep-glob and ignore-glob settings. Added the -x alias for --verily. |
| 1515 | * Add the --soft and --hard options to [/help?cmd=rm|fossil rm] and |
| 1516 | [/help?cmd=mv|fossil mv]. The default is still --soft, but that is |
| 1517 | now configurable at compile-time or by the mv-rm-files setting. |
| 1518 | * Improved ability to [./customgraph.md|customize the timeline graph]. |
| 1519 | * Improvements to the [/sitemap] page. |
| 1520 | * Automatically adjust the [/help?cmd=timeline|CLI timeline] to the terminal |
| 1521 | width on Linux. |
| 1522 | * Added <nowiki>[info commands] and [info vars]</nowiki> commands to TH1. |
| 1523 | These commands perform the same function as their Tcl counterparts, |
| 1524 | except they do not accept a pattern argument. |
| 1525 | * Fix some obscure issues with TH1 expression processing. |
| 1526 | * Fix titles in search results for documents that are not wiki, markdown, |
| 1527 | or HTML. |
| 1528 | * Formally translate TH1 to Tcl return codes and vice-versa, where |
| 1529 | necessary, in the Tcl integration subsystem. |
| 1530 | * Add [/help?cmd=leaves|fossil leaves -multiple], for finding multiple |
| 1531 | leaves on the same branch. |
| 1532 | * Added the "Blitz" skin option. |
| 1533 | * Removed the ".fossil-settings/keep-glob" file. It should not have been |
| 1534 | checked into the repository. |
| 1535 | * Update the built-in SQLite to version 3.8.10.2. |
| 1536 | * Make [/help?cmd=open|fossil open] honor ".fossil-settings/allow-symlinks". |
| 1537 | * Allow [/help?cmd=add|fossil add] to be used on symlinks to nonexistent or |
| 1538 | unreadable files in the same way as [/help?cmd=addremove|fossil addremove]. |
| 1539 | * Added fork warning to be issued if sync produced a fork |
| 1540 | * Update the [/help?cmd=/info|info] page to report when a file becomes a |
| 1541 | symlink. Additionally show the UUID for files whose types have changed |
| 1542 | without changing contents or symlink target. |
| 1543 | * Have [/help?cmd=changes|fossil changes] and |
| 1544 | [/help?cmd=status|fossil status] report when executable or symlink status |
| 1545 | changes on otherwise unmodified files. |
| 1546 | * Permit filtering weekday and file [/help?cmd=/reports|reports] by user. |
| 1547 | Also ensure the user parameter is preserved when changing types. Add a |
| 1548 | field for direct entry of the user name to each applicable report. |
| 1549 | * Create parent directories of [/help?cmd=settings|empty-dirs] if they don't |
| 1550 | already exist. |
| 1551 | * Inhibit timeline links to wiki pages that have been deleted. |
| 1552 | |
| 1553 | <h2 id='v1_33'>Changes for Version 1.32 (2015-03-14)</h2> |
| 1554 | * When creating a new repository using [/help?cmd=init|fossil init], ensure |
| 1555 | that the new repository is fully compatible with historical versions of |
| 1556 | Fossil by having a valid manifest as RID 1. |
| 1557 | * Anti-aliased rendering of arrowheads on timeline graphs. |
| 1558 | * Added vi/less-style key bindings to the --tk diff GUI. |
| 1559 | * Documentation updates to fix spellings and changes all "checkins" to |
| 1560 | "check-ins". |
| 1561 | * Add the --repolist option to server commands such as |
| 1562 | [/help?cmd=server|fossil server] or [/help?cmd=http|fossil http]. |
| 1563 | * Added the "Xekri" skin. |
| 1564 | * Enhance the "ln=" query parameter on artifact displays to accept multiple |
| 1565 | ranges, separate by spaces (or "+" when URL-encoded). |
| 1566 | * Added [/help?cmd=forget|fossil forget] as an alias for |
| 1567 | [/help?cmd=rm|fossil rm]. |
| 1568 | |
| 1569 | <h2 id='v1_31'>Changes For Version 1.31 (2015-02-23)</h2> |
| 1570 | * Change the auxiliary schema by adding columns MLINK.ISAUX and MLINK.PMID |
| 1571 | columns to the schema, to support better drawing of file change graphs. |
| 1572 | A [/help?cmd=rebuild|fossil rebuild] is recommended but is not required. |
| 1573 | so that the new graph drawing logic can work effectively. |
| 1574 | * Added [/search|search] over Check-in comments, Documents, Tickets and |
| 1575 | Wiki. Disabled by default. The search can be either a full-scan or it |
| 1576 | can use an index that is kept up-to-date automatically. The new |
| 1577 | /srchsetup web-page and the [/help?cmd=fts-config|fts-config] command |
| 1578 | were added to help configure the search capability. Expect further |
| 1579 | enhancements to the search capabilities in subsequent releases. |
| 1580 | * Added form elements to some submenus (in particular the /timeline) |
| 1581 | for easier operation. |
| 1582 | * Added the --ifneeded option to [/help?cmd=rebuild|fossil rebuild]. |
| 1583 | * Added "override skins" using the "skin:" line of the CGI script or |
| 1584 | using the --skin LABEL option on the [/help?cmd=server|server], |
| 1585 | [/help?cmd=ui|ui], or [/help?cmd=http|http] commands. |
| 1586 | * Embedded html documents that begin with |
| 1587 | <doc class="fossil-doc"> are displayed with standard |
| 1588 | headers and footers added. |
| 1589 | * Allow <div style='...'> markup in [/wiki_rules|wiki]. |
| 1590 | * Renamed "Events" to "Technical Notes", while updating the technote |
| @@ -1591,24 +1591,24 @@ | |
| 1591 | display and control pages. Add support for technotes as plain text |
| 1592 | or as Markdown. |
| 1593 | * Added the [/md_rules] pages containing summary instructions on the |
| 1594 | Markdown format. |
| 1595 | * Added the --repolist and --nojail options to the various server commands |
| 1596 | (ex: [/help?cmd=server|fossil server]). |
| 1597 | * Added the [/help?cmd=all|fossil all add] subcommand to "fossil all". |
| 1598 | * Improvements to the /login page. Some hyperlinks to pages that require |
| 1599 | "anonymous" privileges are displayed even if the current user is "nobody" |
| 1600 | but automatically redirect to /login. |
| 1601 | * The [/help?cmd=/doc|/doc] web-page will now try to deliver the file |
| 1602 | "404.md" from the top-level directory (if such a file exists) in |
| 1603 | place of its built-in 404 text. |
| 1604 | * Download of Tarballs and ZIP Archives by user "nobody" is now enabled |
| 1605 | by default in new repositories. |
| 1606 | * Enhancements to the table sorting controls. More display tables |
| 1607 | are now sortable. |
| 1608 | * Add IPv6 support to [/help?cmd=sync|fossil sync] and |
| 1609 | [/help?cmd=clone|fossil clone] |
| 1610 | * Add more skins such as "San Francisco Modern" and "Eagle". |
| 1611 | * During shutdown, check to see if the check-out database (".fslckout") |
| 1612 | contains a lot of free space, and if it does, VACUUM it. |
| 1613 | * Added the [/mimetype_list] page. |
| 1614 | * Added the [/hash-collisions] page. |
| @@ -1616,14 +1616,14 @@ | |
| 1616 | ticket reports. |
| 1617 | * Break out the components (css, footer, and header) for the |
| 1618 | various built-in skins into separate files in the source tree. |
| 1619 | |
| 1620 | <h2 id='v1_30'>Changes For Version 1.30 (2015-01-19)</h2> |
| 1621 | * Added the [/help?cmd=bundle|fossil bundle] command. |
| 1622 | * Added the [/help?cmd=purge|fossil purge] command. |
| 1623 | * Added the [/help?cmd=publish|fossil publish] command. |
| 1624 | * Added the [/help?cmd=unpublished|fossil unpublished] command. |
| 1625 | * Enhance the [/tree] webpage to show the age of each file with the option |
| 1626 | to sort by age. |
| 1627 | * Enhance the [/brlist] webpage to show additional information about each branch |
| 1628 | and to be sortable by clicking on column headers. |
| 1629 | * Add support for Docker. Just install docker and type |
| @@ -1633,17 +1633,17 @@ | |
| 1633 | copies of all historical check-ins. This only works on systems that |
| 1634 | support FuseFS. |
| 1635 | * Add the administrative log that records all configuration. |
| 1636 | * Added the [/sitemap] webpage. |
| 1637 | * Added the [/bloblist] web page. |
| 1638 | * Let [/help?cmd=new|fossil new] no longer create an initial empty commit |
| 1639 | by default. The first commit after checking out an empty repository will |
| 1640 | become the initial commit. |
| 1641 | * Added the [/help?cmd=all|fossil all dbstat] and |
| 1642 | [/help?cmd=all|fossil all info] commands. |
| 1643 | * Update SQLite to version 3.8.8. |
| 1644 | * Added the --verily option to the [/help?cmd=clean|fossil clean] command. |
| 1645 | * Add the "autosync-tries" setting to control the number of autosync attempts |
| 1646 | before returning an error. |
| 1647 | * Added a compile-time option (--with-miniz) to build using miniz instead |
| 1648 | of zlib. Disabled by default. |
| 1649 | * Support customization of commands and webpages, including the ability to |
| @@ -1653,12 +1653,12 @@ | |
| 1653 | [trace], [getParameter], [setParameter], [artifact], and |
| 1654 | [globalState]</nowiki> commands to TH1, primarily for use by TH1 hooks. |
| 1655 | * Automatically adjust the width of command-line timeline output according to the |
| 1656 | detected width of the terminal. |
| 1657 | * Prompt the user to optionally fix invalid UTF-8 at check-in. |
| 1658 | * Added a line-number toggle option to the [/help?cmd=/info|/info] |
| 1659 | and [/help?cmd=/artifact|/artifact] pages. |
| 1660 | * Most commands now issue errors rather than silently ignoring unrecognized |
| 1661 | command-line options. |
| 1662 | * Use full 40-character SHA1 hashes (instead of abbreviations) in most |
| 1663 | internal URLs. |
| 1664 | * The "ssh:" sync method on Windows now uses "plink.exe" instead of "ssh" as |
| @@ -1672,11 +1672,11 @@ | |
| 1672 | * Fix a rare and long-standing sync protocol bug |
| 1673 | that would silently prevent the sync from running to completion. Before |
| 1674 | this bug-fix it was sometimes necessary to do "fossil sync --verily" to |
| 1675 | get two repositories in sync. |
| 1676 | * Add the [/finfo?name=src/foci.c|files_of_checkin] virtual table - useful |
| 1677 | for ad hoc queries in the [/help?cmd=sqlite3|fossil sql] interface, |
| 1678 | and also used internally. |
| 1679 | * Added the "$secureurl" TH1 variable for use in headers and footers. |
| 1680 | * (Internal:) Add the ability to include resources as separate files in the |
| 1681 | source tree that are converted into constant byte arrays in the compiled |
| 1682 | binary. Use this feature to store the Tk script that implements the --tk |
| @@ -1696,143 +1696,143 @@ | |
| 1696 | * The [/reports] page now requires Read ("o") permissions. The "byweek" |
| 1697 | report now properly propagates the selected year through the event type |
| 1698 | filter links. |
| 1699 | * The [/help/info | info command] now shows leaf status of the checkout. |
| 1700 | * Add support for tunneling https through a http proxy (Ticket [e854101c4f]). |
| 1701 | * Add option --empty to the "[/help?cmd=open | fossil open]" command. |
| 1702 | * Enhanced [/help?cmd=/fileage|the fileage page] to support a glob parameter. |
| 1703 | * Add -w|--ignore-all-space and -Z|--ignore-trailing-space options to |
| 1704 | [/help?cmd=annotate|fossil annotate], [/help?cmd=blame|fossil blame], |
| 1705 | [/help?cmd=diff|fossil (g)diff], [/help?cmd=stash|fossil stash diff]. |
| 1706 | * Add --strip-trailing-cr option to [/help?cmd=diff|fossil (g)diff] and |
| 1707 | [/help?cmd=stash|fossil stash diff]. |
| 1708 | * Add button "Ignore Whitespace" to /annotate, /blame, /ci, /fdiff |
| 1709 | and /vdiff UI pages. |
| 1710 | * Enhance [/reports?view=byweekday|/reports] with a "byweekday" view. |
| 1711 | * Enhance the [/help?cmd=cat|fossil cat] command so that it works outside |
| 1712 | of a checkout when using the -R command-line option. |
| 1713 | * Use full-length SHA1 hashes, not abbreviations, in most hyperlinks. |
| 1714 | * Correctly render the <title> markup on wiki pages in the |
| 1715 | [/help?cmd=/artifact|/artifact] webpage. |
| 1716 | * Enhance the [/help?cmd=whatis|fossil whatis] command to report on attachments |
| 1717 | and cluster artifacts. Added the [/help?cmd=test-whatis-all] command for |
| 1718 | testing purposes. |
| 1719 | * Add support for HTTP Basic Authentication on [/help?cmd=clone|clone] and |
| 1720 | [/help?cmd=sync|sync]. |
| 1721 | * Fix the [/help?cmd=stash|stash] so that it remembers added files and re-adds |
| 1722 | them when the stash is applied. |
| 1723 | * Fix the server so that it avoids writing to the database (and thus avoids |
| 1724 | database locking issues) on a |
| 1725 | [/help?cmd=pull|pull] or [/help?cmd=clone|clone]. |
| 1726 | * Add support for [./server.wiki#loadmgmt|server load management] using both |
| 1727 | a cache of expensive pages (the [/help?cmd=cache|fossil cache] command) |
| 1728 | and by rejecting expensive page requests when the server load average is too |
| 1729 | high. |
| 1730 | * Add the [/help?cmd=praise|fossil praise] command as an alias for |
| 1731 | [/help?cmd=blame|fossil blame] for subversion compatibility. |
| 1732 | * Enhance the [/help?cmd=test-diff|fossil test-diff] command with -y or --tk |
| 1733 | options so that it shows both filenames above their respective columns in |
| 1734 | the side-by-side diff output. |
| 1735 | * Issue a warning if a [/help?cmd=add|fossil add] command tries to add a file |
| 1736 | that matches the ignore-glob. |
| 1737 | * Add option -W|--width to "[/help?cmd=stash|fossil stash ls]" |
| 1738 | and "[/help?cmd=leaves|fossil leaves]" commands. |
| 1739 | * Enhance support for running as the root user. Now works on Haiku. |
| 1740 | * Added the <tt>-empty</tt> option to [/help?cmd=new|fossil new], which |
| 1741 | causes it to not create an initial empty commit. The first commit after |
| 1742 | checking out a repo created this way will become the initial commit. |
| 1743 | * Enhance sync operations by committing each round-trip to minimize number |
| 1744 | of retransmits when autosync fails. Include option for |
| 1745 | [/help?cmd=update| fossil update] and [/help?cmd=merge| fossil merge] to |
| 1746 | continue even if missing content. |
| 1747 | * Minor portability fixes for platforms where the char type is unsigned |
| 1748 | by default. |
| 1749 | |
| 1750 | <h2>Changes For Version 1.28 (2014-01-27)</h2> |
| 1751 | * Enhance [/help?cmd=/reports | /reports] to support event type filtering. |
| 1752 | * When cloning a repository, the user name passed via the URL (if any) |
| 1753 | is now used as the default local admin user's name. |
| 1754 | * Enhance the SSH transport mechanism so that it runs a single instance of |
| 1755 | the "fossil" executable on the remote side, obviating the need for a shell |
| 1756 | on the remote side. Some users may need to add the "?fossil=/path/to/fossil" |
| 1757 | query parameter to "ssh:" URIs if their fossil binary is not in a standard |
| 1758 | place. |
| 1759 | * Add the "[/help?cmd=blame | fossil blame]" command that works just like |
| 1760 | "fossil annotate" but uses a different output format that includes the |
| 1761 | user who made each change and omits line numbers. |
| 1762 | * Add the "Tarball and ZIP-archive Prefix" configuration parameter under |
| 1763 | Admin/Configuration. |
| 1764 | * Fix CGI processing so that it works on web servers that do not |
| 1765 | supply REQUEST_URI. |
| 1766 | * Add options --dirsonly, --emptydirs, and --allckouts to the |
| 1767 | "[/help?cmd=clean | fossil clean]" command. |
| 1768 | * Ten-fold performance improvement in large "fossil blame" or |
| 1769 | "fossil annotate" commands. |
| 1770 | * Add option -W|--width and --offset to "[/help?cmd=timeline | fossil timeline]" |
| 1771 | and "[/help?cmd=finfo | fossil finfo]" commands. |
| 1772 | * Option -n|--limit of "[/help?cmd=timeline | fossil timeline]" now |
| 1773 | specifies the number of entries, just like all other commands which |
| 1774 | have the -n|--limit option. The various timeline-related functions |
| 1775 | now output "--- ?? limit (??) reached ---" at the end whenever |
| 1776 | appropriate. Use "-n 0" if no limit is desired. |
| 1777 | * Fix handling of password embedded in Fossil URL. |
| 1778 | * New <tt>--once</tt> option to [/help?cmd=clone | fossil clone] command |
| 1779 | which does not store the URL or password when cloning. |
| 1780 | * Modify [/help?cmd=ui | fossil ui] to respect "default user" in an open |
| 1781 | repository. |
| 1782 | * Fossil now hides check-ins that have the "hidden" tag in timeline webpages. |
| 1783 | * Enhance <tt>/ci_edit</tt> page to add the "hidden" tag to check-ins. |
| 1784 | * Advanced possibilities for commit and ticket change notifications over |
| 1785 | http using TH1 scripting. |
| 1786 | * Add --sha1sum and --integrate options |
| 1787 | to the "[/help?cmd=commit | fossil commit]" command. |
| 1788 | * Add the "clean" and "extra" subcommands to the |
| 1789 | "[/help?cmd=all | fossil all]" command |
| 1790 | * Add the --whatif option to "[/help?cmd=clean|fossil clean]" that works the |
| 1791 | same as "--dry-run", |
| 1792 | so that the name does not collide with the --dry-run option of "fossil all". |
| 1793 | * Provide a configuration option to show dates on the web timeline |
| 1794 | as "YYMMMDD HH:MM" |
| 1795 | * Add an option to the "stats" webpage that allows an administrator to see |
| 1796 | the current repository schema. |
| 1797 | * Enhancements to the "[/help?cmd=/vdiff|/vdiff]" webpage for more difference |
| 1798 | display options. |
| 1799 | * Added the "[/tree?ci=trunk&expand | /tree]" webpage as an alternative |
| 1800 | to "/dir" and make it the default way of showing file lists. |
| 1801 | * Send gzipped HTTP responses to clients that support it. |
| 1802 | |
| 1803 | <h2>Changes For Version 1.27 (2013-09-11)</h2> |
| 1804 | * Enhance the [/help?cmd=changes | fossil changes], |
| 1805 | [/help?cmd=clean | fossil clean], [/help?cmd=extras | fossil extras], |
| 1806 | [/help?cmd=ls | fossil ls] and [/help?cmd=status | fossil status] commands |
| 1807 | to restrict operation to files and directories named on the command-line. |
| 1808 | * New --integrate option to [/help?cmd=merge | fossil merge], which |
| 1809 | automatically closes the merged branch when committing. |
| 1810 | * Renamed <tt>/stats_report</tt> page to [/reports]. Graph width is now |
| 1811 | relative, not absolute. |
| 1812 | * Added <tt>yw=YYYY-WW</tt> (year-week) filter to timeline to limit the results |
| 1813 | to a specific year and calendar week number, e.g. [/timeline?yw=2013-01]. |
| 1814 | * Updates to SQLite to prevent opening a repository file using file descriptors |
| 1815 | 1 or 2 on Unix. This fixes a bug under which an assertion failure could |
| 1816 | overwrite part of a repository database file, corrupting it. |
| 1817 | * Added support for unlimited line lengths in side-by-side diffs. |
| 1818 | * New --close option to [/help?cmd=commit | fossil commit], which |
| 1819 | immediately closes the branch being committed. |
| 1820 | * Added <tt>chart</tt> option to [/help?cmd=bisect | fossil bisect]. |
| 1821 | * Improvements to the "human or bot?" determination. |
| 1822 | * Reports errors about missing CGI-standard environment variables for HTTP |
| 1823 | servers which do not support them. |
| 1824 | * Minor improvements to sync support on Windows. |
| 1825 | * Added <tt>--scgi</tt> option to [/help?cmd=server | fossil server]. |
| 1826 | * Internal improvements to the sync process. |
| 1827 | * The internals of the JSON API are now MIT-licensed, so downstream |
| 1828 | users/packagers are no longer affected by the "do no evil" license |
| 1829 | clause. |
| 1830 | |
| 1831 | <h2>Changes For Version 1.26 (2013-06-18)</h2> |
| 1832 | * The argument to the --port option for the [/help?cmd=ui | fossil ui] and |
| 1833 | [/help?cmd=server | fossil server] commands can take an IP address in addition |
| 1834 | to the port number, causing Fossil to bind to just that one IP address. |
| 1835 | * After prompting for a password, also ask if that password should be |
| 1836 | remembered. |
| 1837 | * Performance improvements to the diff engine. |
| 1838 | * Fix the side-by-side diff engine to work better with multi-byte Unicode text. |
| @@ -1839,11 +1839,11 @@ | |
| 1839 | * Color-coding in the web-based annotation (blame) display. Fix the annotation |
| 1840 | engine so that it is no longer confused by time-warps. |
| 1841 | * The markdown formatter is now available by default and can be used for |
| 1842 | tickets, wiki, and embedded documentation. |
| 1843 | * Add subcommands "fossil bisect log" and "fossil bisect status" to the |
| 1844 | [/help?cmd=bisect | fossil bisect] command, as well as other bisect enhancements. |
| 1845 | * Enhanced defenses that prevent spiders from using excessive CPU and bandwidth. |
| 1846 | * Consistent use of the -n or --dry-run command line options. |
| 1847 | * Win32: Fossil now understands Cygwin paths containing one or more of |
| 1848 | the characters <nowiki>"*:<>?|</nowiki>. Those are normally forbidden in |
| 1849 | win32. This means that the win32 fossil.exe is better usable in a Cygwin |
| 1850 |
| --- www/changes.wiki | |
| +++ www/changes.wiki | |
| @@ -2,73 +2,73 @@ | |
| 2 | |
| 3 | <h2 id='v2_28'>Changes for version 2.28 (pending)</h2><ol> |
| 4 | <li> Improvements to [./antibot.wiki|anti-robot defenses]:<ol type="a"> |
| 5 | <li> The default configuration now allows robots to download any tarball |
| 6 | or similar, to better support of automated build systems. |
| 7 | <li> No special tag "zipX" for the [/help/robot-restrict|robot-restrict] |
| 8 | setting blocks robot access to tarballs, but with exceptions to support |
| 9 | automated build systems. |
| 10 | </ol> |
| 11 | <li> A drop-down menu of recent branches is now possible for the submenu, and |
| 12 | is used in the code browser. |
| 13 | <li> The [/help/timeline|timeline command] is enhanced with the new |
| 14 | "<tt>-u|--for-user</tt>" option. |
| 15 | </ol> |
| 16 | |
| 17 | <h2 id='v2_27'>Changes for version 2.27 (2025-09-30)</h2><ol> |
| 18 | <li> Close a potential Denial-of-Service attack against any public-facing Fossil |
| 19 | server involving exponential behavior in Fossil's regexp implementation. |
| 20 | <li> Fix a SQL injection on the [/help/www/file|/file page]. Thanks to |
| 21 | additional defenses built into Fossil, as well as good luck, this injection |
| 22 | is not exploitable for either data exfiltration or privilege escalation. The |
| 23 | only possible result of invoking the injection is a harmless SQL syntax error. |
| 24 | <li> Strengthen robot defenses to help prevent public-facing servers from being |
| 25 | overwhelmed by the latest generation of AI spiders. |
| 26 | <ol type="a"> |
| 27 | <li> New javascript captcha used to restrict access by user "nobody" to pages |
| 28 | listed in the [/help/robot-restrict|robot-restrict setting]. |
| 29 | <li> The [/help/robot-exception|robot-exception setting] is available to allow |
| 30 | access to pages that match a regular expression. Use this, for example, to |
| 31 | allow curl scripts and similar to download release tarballs. |
| 32 | <li> Require at least an anonymous login to access the /blame page and similar. |
| 33 | </ol> |
| 34 | <li> [/help/www/timeline|Timeline] enhancements: |
| 35 | <ol type="a"> |
| 36 | <li> The chng= query parameter on the [/help/www/timeline|timeline page] |
| 37 | so that it works with other query parameters like p=, d=, from=, and to=. |
| 38 | <li> Always include nodes identify by sel1= and sel2= in the /timeline display. |
| 39 | <li> Improved title when p= and d= are different. |
| 40 | </ol> |
| 41 | <li> Enable the --editor option on the [/help/amend|fossil amend] command. |
| 42 | <li> When walking the filesystem looking for Fossil repositories, avoid descending |
| 43 | into directories named "/proc". |
| 44 | <li> Reduce memory requirements for sending authenticated sync protocol |
| 45 | messages. |
| 46 | <li> Show numstat-style change statistics in the /info and /ckout pages. |
| 47 | <li> Add the [/help/stash | stash rename] subcommand. |
| 48 | <li> Add the "-h" option to the "[/help/ls|ls]" command to display |
| 49 | file hashes for a specific check-in when in verbose mode. |
| 50 | </ol> |
| 51 | |
| 52 | <h2 id='v2_26'>Changes for version 2.26 (2025-04-30)</h2><ol> |
| 53 | <li>Enhancements to [/help/diff|fossil diff] and similar: |
| 54 | <ol type="a"> |
| 55 | <li> The argument to the --from option can be a directory name, causing |
| 56 | Fossil to use files under that directory as the baseline for the diff. |
| 57 | <li> For "gdiff", if no [/help/gdiff-command|gdiff-command setting] |
| 58 | is defined, Fossil tries to do a --tk diff if "tclsh" and "wish" |
| 59 | are available, or a --by diff if not. |
| 60 | <li> The "Reload" button is added to --tk diffs, to bring the displayed |
| 61 | diff up to date with the latest changes on disk. |
| 62 | <li> Add the "Hide diffs/Show diffs" toggle to web-UI diff pages that show |
| 63 | diffs of multiple files. |
| 64 | </ol> |
| 65 | <li>Added the [/help/www/ckout|/ckout web page] to provide information |
| 66 | about pending changes in a working check-out |
| 67 | <li>Enhancements to the [/help/ui|fossil ui] command: |
| 68 | <ol type="a"> |
| 69 | <li> Defaults to using the new [/help/www/ckout|/ckout page] as its |
| 70 | start page. Or, if the new "--from PATH" option is present, the |
| 71 | default start page becomes "/ckout?exbase=PATH". |
| 72 | <li> The new "--extpage FILENAME" option opens the named file as if it |
| 73 | where in a [./serverext.wiki|CGI extension]. Example usage: the |
| 74 | person editing this change log has |
| @@ -76,25 +76,25 @@ | |
| 76 | press "Reload" on the web browser to view edits. |
| 77 | <li> Accept both IPv4 and IPv6 connections on all platforms, including |
| 78 | Windows and OpenBSD. This also applies to the "fossil server" |
| 79 | command. |
| 80 | </ol> |
| 81 | <li>Enhancements to [/help/merge|fossil merge]: |
| 82 | <ol type="a"> |
| 83 | <li> Added the [/help/merge-info|fossil merge-info] command and |
| 84 | especially the --tk option to that command, to provide analysis |
| 85 | of the most recent merge or update operation. |
| 86 | <li> When a merge conflict occurs, a new section is added to the conflict |
| 87 | text that shows Fossil's suggested resolution to the conflict. |
| 88 | </ol> |
| 89 | <li>Enhancements to [/help/commit|fossil commit]: |
| 90 | <ol type="a"> |
| 91 | <li> If Fossil sees potential formatting mistakes (ex: bad hyperlinks) |
| 92 | in the check-in comment, it will alert the developer and give |
| 93 | him or her the opportunity to edit the comment before continuing. |
| 94 | This feature is controllable by the |
| 95 | [/help/verify-comments|verify-comments setting]. |
| 96 | <li> The new "--if-changes" option causes the commit to become |
| 97 | a quiet no-op if there are no pending changes. |
| 98 | <li> Added the ability to sign check-ins with SSH keys. Artifacts signed |
| 99 | this way are ignored by all previous fossil versions, as if they |
| 100 | were plain-text file content instead of Fossil artifacts. |
| @@ -106,13 +106,13 @@ | |
| 106 | </ol> |
| 107 | <li>Deprecate the --comfmtflags and --comment-format global options and |
| 108 | no longer list them in the built-in help, but keep them working for |
| 109 | backwards compatibility. |
| 110 | Alternative TTY comment formatting can still be specified using the |
| 111 | [/help/comment-format|comment-format setting], if desired. The |
| 112 | default comment format is now called "canonical", not "legacy". |
| 113 | <li>Enhancements to the [/help/www/timeline|/timeline page]: |
| 114 | <ol type="a"> |
| 115 | <li> Added the "ml=" ("Merge-in List") query parameter that works |
| 116 | like "rl=" ("Related List") but adds "mionly" style related |
| 117 | check-ins instead of the full "rel" style. |
| 118 | <li> For "tl=", "rl=", and "ml=", the order of the branches in the |
| @@ -141,33 +141,33 @@ | |
| 141 | in which case the timeline shows those check-ins that are both |
| 142 | ancestors of p= and descendants of d=. |
| 143 | <li> The saturation and intensity of user-specified checkin and branch |
| 144 | background colors are automatically adjusted to keep the colors |
| 145 | compatible with the current skin, unless the |
| 146 | [/help/raw-bgcolor|raw-bgcolor setting] is turned on. |
| 147 | </ol> |
| 148 | <li>The [/help/www/docfile|/docfile webpage] was added. It works like |
| 149 | /doc but keeps the title of markdown documents with the document rather |
| 150 | that moving it up to the page title. |
| 151 | <li>Added the [/help/www/clusterlist|/clusterlist page] for analysis |
| 152 | and debugging |
| 153 | <li>Added the "artifact_to_json(NAME)" SQL function that returns a JSON |
| 154 | decoding of the artifact described by NAME. |
| 155 | <li>Improvements to the [/help/patch|fossil patch] command: |
| 156 | <ol type="a"> |
| 157 | <li> Fix a bug in "fossil patch create" that causes |
| 158 | [/help/revert|fossil revert] operations that happened |
| 159 | on individualfiles after a [/help/merge|fossil merge] |
| 160 | to be omitted from the patch. |
| 161 | <li> Added the [/help/patch|patch alias] command for managing |
| 162 | aliases for remote checkout names. |
| 163 | </ol> |
| 164 | <li>Enhancements to on-line help and the [/help/help|fossil help] command: |
| 165 | <ol type="a"> |
| 166 | <li> Add the ability to search the help text, either in the UI |
| 167 | (on the [/help/www/search|/search page]) or from the command-line |
| 168 | (using the "[/help/search|fossil search -h PATTERN]" command.) |
| 169 | <li> Accepts an optional SUBCOMMAND argument following the |
| 170 | COMMAND argument and only shows results for the specified |
| 171 | subcommand, not the entire command. |
| 172 | <li> The -u (--usage) option shows only the command-line syntax |
| 173 | <li> The -o (--options) option shows only the command-line options |
| @@ -183,11 +183,11 @@ | |
| 183 | <li> Link the version field in ticket view to a matching checkin or tag. |
| 184 | <li> Show creation time in report and ticket view. |
| 185 | <li> Show previous comments in edit ticket as reference. |
| 186 | </ol> |
| 187 | <li>Added the "hash" query parameter to the |
| 188 | [/help/www/whatis|/whatis webpage]. |
| 189 | <li>Add a "user permissions changes" [/doc/trunk/www/alerts.md|subscription] |
| 190 | which alerts subscribers when an admin creates a new user or |
| 191 | when a user's permissions change. |
| 192 | <li>If the FOSSIL_REPOLIST_SHOW environment variable exists and contains |
| 193 | the substring "description", then the project description for each repository |
| @@ -199,44 +199,44 @@ | |
| 199 | <ol type="a"> |
| 200 | <li> TH1 now makes a distinction between |
| 201 | [/doc/trunk/www/th1.md#taint|tainted and untainted string values]. |
| 202 | This makes it more difficult to write custom TH1 scripts that |
| 203 | contain XSS or SQL-injection bugs. The |
| 204 | [/help/vuln-report|vuln-report] setting was added to control |
| 205 | what Fossil does when it encounters a potential TH1 |
| 206 | security problem. |
| 207 | <li> The "--th" option was removed from the [/help/pikchr|fossil pikchr] |
| 208 | command. |
| 209 | <li> The "enable_htmlify" TH1 command was removed. |
| 210 | </ol> |
| 211 | <li>Make [/help/www/chat|/chat] better-behaved during server outages, reducing |
| 212 | the frequency of reconnection attempts over time and providing feedback |
| 213 | to the user when the connection is down. |
| 214 | <li>The [/help/www/sqlar|/sqlar] page does not work for users who are not logged |
| 215 | in, nor are links to that page displayed to users who are not logged in. Being |
| 216 | logged in as "anonymous" is sufficient to overcome this restriction, assuming |
| 217 | that "anonymous" can download tarballs and ZIP archives. |
| 218 | <li>Many other minor fixes and additions. |
| 219 | </ol> |
| 220 | |
| 221 | <h2 id='v2_25'>Changes for version 2.25 (2024-11-06)</h2> |
| 222 | |
| 223 | * The "[/help/ui|fossil ui /]" command now works even for repositories |
| 224 | that have non-ASCII filenames |
| 225 | * Add the [/help/tree|fossil tree] command. |
| 226 | * On case-insensitive filesystems, store files using the filesystem's |
| 227 | preferred case rather than the case typed in by the user. |
| 228 | * Change the name "fossil cherry-pick" command to "fossil cherrypick", |
| 229 | which is more familiar to Git users. Retain the legacy name for |
| 230 | compatibility. |
| 231 | * Add new query parameters to the [/help/www/timeline|/timeline page]: |
| 232 | d2=, p2=, and dp2=. |
| 233 | * Add options to the [/help/tag|fossil tag] command that will list tag values. |
| 234 | * Add the -b|--brief option to the [/help/status|fossil status] command. |
| 235 | * Add ability to upload unversioned files via the [/help/www/uvlist|/uvlist page]. |
| 236 | * Add history search to the [/help/www/chat|/chat page]. |
| 237 | * Add Unix socket support to the [/help/server|server command]. |
| 238 | * On Windows, use the root certificates managed by the operating system |
| 239 | (requires OpenSSL 3.2.0 or greater). |
| 240 | * Take into account zero-width and double-width unicode characters when |
| 241 | formatting the command-line timeline. |
| 242 | * Update the built-in SQLite to version 3.47.0. Precompiled binaries are |
| @@ -273,11 +273,11 @@ | |
| 273 | </ul> |
| 274 | * If an "ssh:" sync fails in a way that suggests that the fossil executable |
| 275 | could not be found on the remote host, then retry after adding a PATH= |
| 276 | prefix to the command. This helps "ssh:" to "just work" when the server |
| 277 | is a Mac. |
| 278 | * Enhancements to the [/help/www/timeline|/timeline page]: |
| 279 | <ul> |
| 280 | <li> Add the x= query paramater |
| 281 | <li> Add the shortcut tl= and rl= query parameters |
| 282 | <li> Add support for from=,ft= and from=,bt= query parameter combinations |
| 283 | <li> Automatically highlight the endpoints for from=,to= queries. |
| @@ -287,16 +287,16 @@ | |
| 287 | * Moved the /museum/repo.fossil file referenced from the Dockerfile from |
| 288 | the ENTRYPOINT to the CMD part to allow use of --repolist mode. |
| 289 | * The [/uvlist] page now shows the hash algorithm used so that |
| 290 | viewers don't have to guess. The hash is shown in a fixed-width |
| 291 | font for a more visually pleasing display. |
| 292 | * If the [/help/autosync|autosync setting] contains keyword "all", |
| 293 | the automatic sync occurs against all defined remote repositories, not |
| 294 | just the default. |
| 295 | * Markdown formatter: improved handling of indented fenced code blocks |
| 296 | that contain blank lines. |
| 297 | * When doing a "[/help/add|fossil add]" on a system with case-insensitive |
| 298 | but case-preserving filenames (Mac and Windows) try to use the filename |
| 299 | case as it is known to the filesystem, not the case entered by the |
| 300 | user on the command-line. See |
| 301 | [forum:/forumpost/30d9c0d131610f53|forum thread 30d9c0d131610f53]. |
| 302 | * Fix problems with one-click unsubscribe on email notifications. |
| @@ -310,17 +310,17 @@ | |
| 310 | <h2 id='v2_23'>Changes for version 2.23 (2023-11-01)</h2> |
| 311 | |
| 312 | * Add ability to "close" forum threads, such that unprivileged users |
| 313 | may no longer respond to them. Only administrators can close |
| 314 | threads or respond to them by default, and the |
| 315 | [/help/forum-close-policy|forum-close-policy setting] can be |
| 316 | used to add that capability to moderators. |
| 317 | * Add the [/help/all|fossil all whatis] command. |
| 318 | * The [/help/status|fossil status] command and relevant UI pages now |
| 319 | correctly report files which were both renamed <b>and</b> edited as such. |
| 320 | * Show default value of settings that have a default in |
| 321 | [/help/help|fossil help SETTING] output. |
| 322 | * On timeline graphs, show closed check-ins using an X in the middle of the |
| 323 | node circle or box. |
| 324 | * New options for email notification: Get email only for the first |
| 325 | post in each new thread, and/or posts that are in reply to my posts. |
| 326 | * Fix a regression bug introduced in version 2.22 that caused FTS5 searches |
| @@ -333,35 +333,35 @@ | |
| 333 | <li> Better defense against cross-site request forgery (CSRF) |
| 334 | attacks. |
| 335 | <li> Improvements to static analysis of source code (the codecheck1.c |
| 336 | file in the source tree). |
| 337 | </ul> |
| 338 | * Enhance the [/help/www/dir|treeview file listings] |
| 339 | ([/dir?type=tree&ci=trunk|example]) by displaying file sizes |
| 340 | and adding the option to sort by file size. |
| 341 | * The [/help/fts-config|fossil fts-config] command now shows how much |
| 342 | repository space is used by the full-text index. |
| 343 | * Changing a setting to an empty string is now the same as deleting the |
| 344 | setting, in most cases. There are a few exceptions, indicated by the |
| 345 | keep-empty flag on the setting definition. |
| 346 | * The [/help/branch|fossil branch list] command can now filter branches |
| 347 | that have/have not been merged into the current branch. |
| 348 | * Improvements to interactions with remote repositories over SSH: |
| 349 | <ul> |
| 350 | <li> Print the text of the SSH command that is run to do remote interaction, |
| 351 | for full disclosure to the operator. |
| 352 | <li> Add a PATH= argument to the [/help/ui|fossil ui remote:/] and |
| 353 | [/help/patch|fossil patch push/pull remote:...] commands so that |
| 354 | they work when the "remote" machine is a Mac and the "fossil" |
| 355 | executable is in the $HOME/bin directory. |
| 356 | </ul> |
| 357 | * Update built-in libraries SQLite, ZLib, Pikchr to their latest versions. |
| 358 | * Documentation enhancements and typo fixes. |
| 359 | |
| 360 | |
| 361 | <h2 id='v2_22'>Changes for version 2.22 (2023-05-31)</h2> |
| 362 | * Enhancements to the [/help/www/timeline|/timeline webpage]: <ol type="a"> |
| 363 | <li> Add the ft=TAG query parameter which in combination with d=Y |
| 364 | shows all descendants of Y up to TAG |
| 365 | <li> Enhance the s=PATTERN (search) query parameter so that forum post |
| 366 | text is also searched when the "vfx" query parameter is used |
| 367 | <li> Fix the u= (user) query parameter so that it works with a= and b= |
| @@ -385,56 +385,56 @@ | |
| 385 | searching in Chinese. |
| 386 | * Comment lines (starting with a '#') are now supported inside |
| 387 | [./settings.wiki#versionable|versioned settings]. |
| 388 | * Default permissions for anonymous users in new repositories are |
| 389 | changed to "hz". |
| 390 | * The [/help/status|fossil status] command now detects when a |
| 391 | file used to be a symlink and has been replaced by a regular file. |
| 392 | (It previously checked for the inverse case only.) |
| 393 | * The [/help/empty-dirs|empty-dirs setting] now reuses the same |
| 394 | parser as the *-glob settings instead of its prior idiosyncratic |
| 395 | parser, allowing quoted whitespace in patterns. |
| 396 | * Enhancements to the [/help/www/reports|/reports webpage]: |
| 397 | <ol type="a"> |
| 398 | <li> The by-week, by-month, and by-year options now show an estimated |
| 399 | size of the current week, month, or year as a dashed box. |
| 400 | <li> New sub-categories "Merge Check-ins" and "Non-Merge Check-ins". |
| 401 | </ol> |
| 402 | |
| 403 | <h2 id='v2_21'>Changes for version 2.21 (2023-02-25)</h2> |
| 404 | * Users can request a password reset. This feature is disabled by default. |
| 405 | Use the new [/help/self-pw-reset|self-pw-reset property] to enable it. |
| 406 | New web pages [/help/www/resetpw|/resetpw] and |
| 407 | [/help/www/reqpwreset|/reqpwreset] added. |
| 408 | * Add the [/help/repack|fossil repack] command (together with |
| 409 | [/help/all|fossil all repack]) as a convenient way to optimize the |
| 410 | size of one or all of the repositories on a system. |
| 411 | * Add the ability to put text descriptions on ticket report formats. |
| 412 | * Upgrade the test-find-pivot command to the [/help/merge-base|merge-base command]. |
| 413 | * The [/help/www/chat|/chat page] can now embed fossil-rendered |
| 414 | views of wiki/markdown/pikchr file attachments with the caveat that such |
| 415 | embedding happens in an iframe and thus does not inherit styles and such |
| 416 | from the containing browser window. |
| 417 | * The [/help/all|fossil all remote] subcommand added to "fossil all". |
| 418 | * Passwords for remembered remote repositories are now stored as irreversible |
| 419 | hashes rather than obscured clear-text, for improved security. |
| 420 | * Add the "nossl" and "nocompress" options to CGI. |
| 421 | * Update search infrastructure from FTS4 to FTS5. |
| 422 | * Add the [/help/www/deltachain|/deltachain] page for debugging purposes. |
| 423 | * Writes to the database are disabled by default if the HTTP request |
| 424 | does not come from the same origin. This enhancement is a defense in depth |
| 425 | measure only; it does not address any known vulnerabilities. |
| 426 | * Improvements to automatic detection and mitigation of attacks from |
| 427 | malicious robots. |
| 428 | |
| 429 | <h2 id='v2_20'>Changes for version 2.20 (2022-11-16)</h2> |
| 430 | * Added the [/help/chat-timeline-user|chat-timeline-user setting]. If |
| 431 | it is not an empty string, then any changes that would appear on the timeline |
| 432 | are announced in [./chat.md|the chat room]. |
| 433 | * The /unsubscribe page now requests confirmation. [./alerts.md|Email notifications] |
| 434 | now contain only an "Unsubscribe" link, and not a link to subscription management. |
| 435 | * Added the "[/help/branch|fossil branch lsh]" subcommand to list the |
| 436 | most recently modified branches. |
| 437 | * More elements of the /info page are now inside of an accordion. |
| 438 | * Replace the <tt>--dryrun</tt> flag with <tt>--dry-run</tt> in all |
| 439 | commands which still used the former name, for consistency. |
| 440 | * Rebuilt [/file/Dockerfile | the stock Dockerfile] to create a "from scratch" |
| @@ -464,11 +464,11 @@ | |
| 464 | accomplished using a Common Table Expression in the underlying SQL. |
| 465 | * Sort tag listings (command line and webpage) by taking numbers into |
| 466 | consideration so as to cater for tags that follow semantic versioning. |
| 467 | * On the wiki listings, omit by default wiki pages that are associated with |
| 468 | check-ins and branches. |
| 469 | * Add the new "[/help/describe|fossil describe]" command. |
| 470 | * Markdown subsystem extended with [../src/markdown.md#ftnts|footnotes support]. |
| 471 | See corresponding [../test/markdown-test3.md|test cases], |
| 472 | [/wiki?name=branch/markdown-footnotes#il|known limitations] and |
| 473 | [forum:/forumthread/ee1f1597e46ec07a|discussion]. |
| 474 | * Add the new special name "start:BRANCH" to refer to the first check-in of |
| @@ -480,96 +480,96 @@ | |
| 480 | operation. Also require explicit "system" proxy setting to use |
| 481 | "http_proxy" environment variable. |
| 482 | * Reimplemented the [/pikchrshow] app to use a WebAssembly build of |
| 483 | pikchr so that it can render pikchrs on the client instead of requiring |
| 484 | a server round-trip. |
| 485 | * Add the [/help/email-listid|email-listid setting]. If set, it is |
| 486 | used as the List-ID header for all outbound notification emails. |
| 487 | * Add the "--branch" option to the "[/help/timeline|timeline]" command |
| 488 | to restrict the displayed items to a specific branch. |
| 489 | * Add the "--versions" option to "[/help/diff|fossil diff]" |
| 490 | to display details about the compared versions into the patch header. |
| 491 | * Numerous other minor enhancements. |
| 492 | |
| 493 | <h2 id='v2_18'>Changes for version 2.18 (2022-02-23)</h2> |
| 494 | * Added support for [./ssl-server.md|SSL/TLS server mode] for commands |
| 495 | like "[/help/server|fossil server]" and "[/help/http|fossil http]" |
| 496 | * The new [/help/cherry-pick|cherry-pick command] is an alias for |
| 497 | [/help/merge|merge --cherrypick]. |
| 498 | * Add new setting "[/help/large-file-size|large-file-size]". If the size |
| 499 | of any file in a commit exceeds this size, a warning is issued. |
| 500 | * Query parameter "year=YYYY" is now accepted by [/help/www/timeline|/timeline]. |
| 501 | * The [/help/tar|tar] and [/help/zip|zip commands] no longer |
| 502 | sterilize the manifest file. |
| 503 | * Further improvement to diff alignment in cases that involve both |
| 504 | edits and indentation changes. |
| 505 | * [/doc/trunk/www/chat.md|Chat] improvements:<ul> |
| 506 | <li> [/help/www/chat|The /chat page] input options have been reworked |
| 507 | again for better cross-browser portability. |
| 508 | <li> When sending a [/help/www/chat|/chat] message fails, it is no longer |
| 509 | immediately lost and sending may optionally be retried. |
| 510 | <li> [/help/www/chat|/chat] can now optionally embed attachments of certain |
| 511 | types directly into message bodies via an iframe. |
| 512 | <li> Add the "--as FILENAME" option to the "[/help/chat|fossil chat send]" |
| 513 | command. |
| 514 | <li> Added the "[/help/chat|fossil chat pull]" command, available to |
| 515 | administrators only, for backing up the chat conversation. |
| 516 | </ul> |
| 517 | * Promote the test-detach command into the [/help/detach|detach command]. |
| 518 | * For "[/help/pull|fossil pull]" with the --from-parent-project option, |
| 519 | if no URL is specified then use the last URL from the most recent prior |
| 520 | "fossil pull --from-parent-project". |
| 521 | * Add options --project-name and --project-desc to the |
| 522 | "[/help/init|fossil init]" command. |
| 523 | * The [/help/www/ext|/ext page] generates the SERVER_SOFTWARE environment |
| 524 | variable for clients. |
| 525 | * Fix the REQUEST_URI [/doc/trunk/www/aboutcgi.wiki#cgivar|CGI variable] such |
| 526 | that it includes the query string. This is how most other systems understand |
| 527 | REQUEST_URI. |
| 528 | * Added the --transport-command option to [/help/sync|fossil sync] |
| 529 | and similar. |
| 530 | |
| 531 | <h2 id='v2_17'>Changes for version 2.17 (2021-10-09)</h2> |
| 532 | |
| 533 | * Major improvements to the "diff" subsystem, including: <ul> |
| 534 | <li> Added new [/help/diff|formatting options]: --by, -b, --webpage, --json, --tcl. |
| 535 | <li> Partial-line matching for unified diffs |
| 536 | <li> Better partial-line matching for side-by-side diffs |
| 537 | <li> Buttons on web-based diffs to show more context |
| 538 | <li> Performance improvements |
| 539 | </ul> |
| 540 | * The --branchcolor option on [/help/commit|fossil commit] and |
| 541 | [/help/amend|fossil amend] can now take the value "auto" to |
| 542 | force Fossil to use its built-in automatic color choosing algorithm. |
| 543 | * Fossil now [./concepts.wiki#workflow|autosyncs] prior to running |
| 544 | [/help/open|fossil open]. |
| 545 | * Add the [/help/ticket-default-report|ticket-default-report setting], |
| 546 | which if set to the title of a ticket report causes that ticket report |
| 547 | to be displayed below the search box in the /ticket page. |
| 548 | * The "nc" query parameter to the [/help/www/timeline|/timeline] page |
| 549 | causes all graph coloring to be omitted. |
| 550 | * Improvements and bug fixes to the new "[/help/ui|fossil ui REMOTE]" |
| 551 | feature so that it works better on a wider variety of platforms. |
| 552 | * In [/help/www/wikiedit|/wikiedit], show the list of attachments for |
| 553 | the current page and list URLs suitable for pasting them into the page. |
| 554 | * Add the --no-http-compression option to [/help/sync|fossil sync] |
| 555 | and similar. |
| 556 | * Print total payload bytes on a [/help/sync|fossil sync] when using |
| 557 | the --verbose option. |
| 558 | * Add the <tt>close</tt>, <tt>reopen</tt>, <tt>hide</tt>, and |
| 559 | </tt>unhide</tt> subcommands to [/help/branch|the branch command]. |
| 560 | * The "-p" option to [/help/branch|fossil branch list] shows only |
| 561 | private branches. |
| 562 | * The [/md_rules|Markdown formatter] now interprets the content of |
| 563 | block HTML markup (such as <table>) in most cases. Only content |
| 564 | of <pre> and <script> is passed through verbatim. |
| 565 | * The [/help/wiki|wiki list command] no longer lists "deleted" |
| 566 | pages by default. Use the new <tt>--all</tt> option to include deleted |
| 567 | pages in the output. |
| 568 | * The [/help/all|fossil all git status] command only shows reports for |
| 569 | the subset of repositories that have a configured Git export. |
| 570 | * The [/help/www/chat|/chat] configuration was reimplemented and |
| 571 | provides new options, including the ability for a repository |
| 572 | administrator to |
| 573 | [./chat.md#notifications|extend the selection of notification sounds] |
| 574 | using unversioned files. |
| 575 | * Chat now uses fossil's full complement of markdown features, |
| @@ -578,14 +578,14 @@ | |
| 578 | markdown-processed when they are sent instead of when they |
| 579 | are saved. |
| 580 | * Added a chat message preview mode so messages can be previewed |
| 581 | before being sent. Similarly, added a per-message ability to view |
| 582 | the raw un-parsed message text. |
| 583 | * The hotkey to activate preview mode in [/help/www/wikiedit|/wikiedit], |
| 584 | [/help/www/fileedit|/fileedit], and [/help/www/pikchrshow|/pikchrshow] |
| 585 | was changed from ctrl-enter to shift-enter in order to align with |
| 586 | [/help/www/chat|/chat]'s new preview feature and related future |
| 587 | changes. |
| 588 | |
| 589 | <h2 id='v2_16'>Changes for Version 2.16 (2021-07-02)</h2> |
| 590 | * <b>Security:</b> Fix the client-side TLS so that it verifies that the |
| 591 | server hostname matches its certificate. |
| @@ -592,11 +592,11 @@ | |
| 592 | * The default "ssh" command on Windows is changed to "ssh" instead of the |
| 593 | legacy "plink", as ssh is now generally available on Windows systems. |
| 594 | Installations that still need to use the legacy "plink" can make that |
| 595 | happen by running: '<tt>fossil set ssh-command "plink -ssh" --global</tt>'. |
| 596 | * Added the [./patchcmd.md|fossil patch] command. |
| 597 | * The [/help/ui|fossil ui] command is enhanced in multiple ways:<ol> |
| 598 | <li> The REPOSITORY argument can be the name of a check-out directory. |
| 599 | <li> If the REPOSITORY argument is prefixed by "HOST:" or "USER@HOST:" |
| 600 | then the ui is run on the remote machine and tunnelled back to the local |
| 601 | machine using ssh. (The latest version of fossil must be installed on |
| 602 | both the local and the remote for this to work correctly.) |
| @@ -605,25 +605,25 @@ | |
| 605 | * The [/brlist|/brlist web page] allows the user to |
| 606 | select multiple branches to be displayed together in a single |
| 607 | timeline. |
| 608 | * The [./forum.wiki|Forum] provides a hyperlink on the author of each |
| 609 | post that goes to a timeline of recent posts by that same author. |
| 610 | * Added the "[/help/bisect|fossil bisect run]" command for improved |
| 611 | automation of bisects. |
| 612 | * The [/help/merge|fossil merge] command now does a better job merging |
| 613 | branches where files have been renamed between the current branch and the |
| 614 | branch being merged. |
| 615 | * The [/help/open|fossil open] command allows the repository file |
| 616 | to be inside the working directory without requiring the --force flag. |
| 617 | * The [/help/www/wikiedit|/wikiedit] and [/help/www/wikinew|/wikinew] |
| 618 | pages now default to markdown format. |
| 619 | * The [/help/www/login|/login] page now links to a user's forum post |
| 620 | timeline if the repository has forum posts. |
| 621 | * Tags may now be propagated for forum posts, wiki pages, and technotes. |
| 622 | The [/help/tag|tag command] can now manipulate and list such tags. |
| 623 | * [./caps/login-groups.md|Login-Groups] are now shown on the repository |
| 624 | list of the "[/help/all|fossil all ui]" command. |
| 625 | * Administrators can configure [./alerts.md|email alerts] to expire |
| 626 | a specific number of days (ex: 365) after the last user contact with |
| 627 | the Fossil server. This prevents alert emails being sent to |
| 628 | abandoned email accounts forever. |
| 629 | * SQL that defines [/tktsetup_tab|database objects for tickets] now |
| @@ -640,11 +640,11 @@ | |
| 640 | * <b>Patch 2.15.1:</b> Fix a data exfiltration bug in the server. <b>Upgrading to |
| 641 | the patch is recommended.</b> |
| 642 | * The [./defcsp.md|default CSP] has been relaxed slightly to allow |
| 643 | images to be loaded from any URL. All other resources are still |
| 644 | locked down by default. |
| 645 | * The built-in skins all use the "[/help/mainmenu|mainmenu]" |
| 646 | setting to determine the content of the main menu. |
| 647 | The ability to edit the |
| 648 | "mainmenu" setting is added on the /Admin/Configuration page. |
| 649 | * The hamburger menu is now available on most of the built-in skins. |
| 650 | * Any built-in skin named "X" can be used instead of the standard |
| @@ -654,40 +654,40 @@ | |
| 654 | included. The [/skins] page may be used to select a skin. |
| 655 | * The [/cookies] page now gives the user an opportunity to delete |
| 656 | individual cookies. And the /cookies page is linked from the |
| 657 | /sitemap, so that it appears in hamburger menus. |
| 658 | * The [/sitemap] extensions are now specified by a single new |
| 659 | "[/help/sitemap-extra|sitemap-extra setting]", |
| 660 | rather than a cluster of various |
| 661 | "sitemap-*" settings. The older settings are no longer used. |
| 662 | <b>This change might require minor server configuration |
| 663 | adjustments on servers that use /sitemap extensions.</b> |
| 664 | The /Admin/Configuration page provides the ability to edit |
| 665 | the new "sitemap-extra" setting. |
| 666 | * Added the "--ckout-alias NAME" option to |
| 667 | [/help/ui|fossil ui], [/help/server|fossil server], and |
| 668 | [/help/http|fossil http]. This option causes Fossil to |
| 669 | understand URIs of the form "/doc/NAME/..." as if they were |
| 670 | "[/help/www/doc|/doc/ckout/...]", to facilitate testing of |
| 671 | [./embeddeddoc.wiki|embedded documentation] changes prior to |
| 672 | check-in. |
| 673 | * For diff web pages, if the diff type (unified versus side-by-side) |
| 674 | is not specified by a query parameter, and if the |
| 675 | "[/help/preferred-diff-type|preferred-diff-type]" |
| 676 | setting is omitted or less than 1, then select the diff type based |
| 677 | on a guess of whether or not the request is coming from a mobile |
| 678 | device. Mobile gets unified and desktop gets side-by-side. |
| 679 | * The various pages which show diffs now have toggles to show/hide |
| 680 | individual diffs. |
| 681 | * Add the "[/help/preferred-diff-type|preferred-diff-type]" |
| 682 | setting to allow an admin to force a default diff type. |
| 683 | * The "pikchr-background" setting is now available in |
| 684 | "detail.txt" skin files, for better control of Pikchr |
| 685 | colors in inverted color schemes. |
| 686 | * Add the <tt>--list</tt> option to the |
| 687 | [/help/tarball|tarball], |
| 688 | [/help/zip|zip], and [/help/sqlar|sqlar] |
| 689 | commands. |
| 690 | * The javascript used to implement the hamburger menu on the |
| 691 | default built-in skin has been made generic so that it is usable |
| 692 | by a variety of skins, and promoted to an ordinary built-in |
| 693 | javascript file. |
| @@ -695,24 +695,24 @@ | |
| 695 | "[/doc/trunk/www/th1.md#bireqjs|builtin_request_js]", |
| 696 | "[/doc/trunk/www/th1.md#capexpr|capexpr]", |
| 697 | "foreach", "lappend", and "string match" |
| 698 | * The [/help/leaves|leaves command] now shows the branch point |
| 699 | of each leaf. |
| 700 | * The [/help/add|fossil add] command refuses to add files whose |
| 701 | names are reserved by Windows (ex: "aux") unless the --allow-reserved |
| 702 | option is included. This helps prevent Unix users from accidentally |
| 703 | creating check-ins that are unreadable by Windows users. |
| 704 | * Add the "re=" query parameter to the [/help/www/dir|/dir] webpage, |
| 705 | for symmetry with the [/help/www/tree|/tree] page. |
| 706 | * Update the built-in SQLite to version 3.35.0. |
| 707 | * The ./configure script now has the --print-minimum-sqlite-version option |
| 708 | that prints the minimum SQLite version required by the current version |
| 709 | of Fossil. This might be used by integrators who insist on building |
| 710 | Fossil to link against the system SQLite library rather than the |
| 711 | built-in copy of SQLite, to verify that their system SQLite library |
| 712 | is recent enough. |
| 713 | * Webpage that shows [/help/www/whistory|history of a wiki page] |
| 714 | gained client-side UI to help with comparison between two arbitrary |
| 715 | versions of a wiki (by the means of anchoring a "baseline" version) |
| 716 | and the ability to squeeze several sequential edits made by the same |
| 717 | user into a single "recycled" row (the latest edit in that sequence). |
| 718 | |
| @@ -732,40 +732,40 @@ | |
| 732 | version 2.14 and then later downgrade or otherwise use an earlier |
| 733 | version of Fossil, the email notification mechanism may fail |
| 734 | to send out notifications for some events, due to the missing |
| 735 | trigger. If you want to |
| 736 | permanently downgrade an installation, then you should run |
| 737 | "[/help/rebuild|fossil rebuild]" after the downgrade |
| 738 | to get email notifications working again. If you are not using |
| 739 | email notification, then the schema change will not affect you in |
| 740 | any way. |
| 741 | * <b>Schema Update Notice #2:</b> |
| 742 | This release changes how the descriptions of wiki edits are stored |
| 743 | in the EVENT table, for improved display on timelines. You must |
| 744 | run "[/help/rebuild|fossil rebuild]" to take advantage of |
| 745 | this enhancement. Everything will still work without |
| 746 | "fossil rebuild", except you will get goofy descriptions of |
| 747 | wiki updates in the timeline. |
| 748 | * Add support for [./chat.md|Fossil chat]. |
| 749 | * The "[/help/clone|fossil clone]" command is enhanced so that |
| 750 | if the repository filename is omitted, an appropriate name is derived |
| 751 | from the remote URL and the newly cloned repo is opened. This makes |
| 752 | the clone command work more like Git, thus making it easier for |
| 753 | people transitioning from Git. |
| 754 | * Added the --mainbranch option to the [/help/git|fossil git export] |
| 755 | command. |
| 756 | * Added the --format option to the |
| 757 | "[/help/timeline|fossil timeline]" command. |
| 758 | * Enhance the --numstat option on the |
| 759 | "[/help/diff|fossil diff]" command so that it shows a total |
| 760 | number of lines added and deleted and total number of files |
| 761 | modified. |
| 762 | * Add the "contact" sub-command to [/help/user|fossil user]. |
| 763 | * Added commands "[/help/all|fossil all git export]" and |
| 764 | "[/help/all|fossil all git status]". |
| 765 | * Added the "df=CHECKIN" query parameter to the |
| 766 | [/help/www/timeline|/timeline page]. |
| 767 | * Improvements to the "[/sitemap]" page. Add subpages |
| 768 | [/sitemap-timeline] and [/sitemap-test]. |
| 769 | * Better text position in cylinder objects of Pikchr diagrams. |
| 770 | * New "details.txt" settings available to custom skins to better control |
| 771 | the rendering of Pikchr diagrams: |
| @@ -787,24 +787,24 @@ | |
| 787 | * Added support for [./interwiki.md|interwiki links]. |
| 788 | * Enable <del> and <ins> markup in wiki. |
| 789 | * Improvements to the Forum threading display. |
| 790 | * Added support for embedding [./pikchr.md|pikchr] |
| 791 | markup in markdown and fossil-wiki content. |
| 792 | * The new "[/help/pikchr|pikchr]" command can render |
| 793 | pikchr scripts, optionally pre-processed with |
| 794 | [/doc/trunk/www/th1.md|TH1] blocks and variables exactly like |
| 795 | site skins are. |
| 796 | * The new [/help/www/pikchrshow|pikchrshow] page provides an |
| 797 | editor and previewer for pikchr markup. |
| 798 | * In [/help/www/wikiedit|/wikiedit] and |
| 799 | [/help/www/fileedit|/fileedit], Ctrl-Enter can now be used |
| 800 | initiate a preview and to toggle between the editor and preview |
| 801 | tabs. |
| 802 | * The <tt>/artifact</tt> and <tt>/file</tt> views, when in |
| 803 | line-number mode, now support interactive selection of a range |
| 804 | of lines to hyperlink to. |
| 805 | * Enhance the [/help/www/finfo|/finfo] webpage so that when query |
| 806 | parameters identify both a filename and a checkin, the resulting |
| 807 | graph tracks the identified file across renames. |
| 808 | * The built-in SQLite is updated to an alpha of version 3.34.0, and |
| 809 | the minimum SQLite version is increased to 3.34.0 because the |
| 810 | /finfo change in the previous bullet depends on enhancements to |
| @@ -813,18 +813,18 @@ | |
| 813 | * Countless other minor refinements and documentation improvements. |
| 814 | |
| 815 | <h2 id='v2_12'>Changes for Version 2.12.1 (2020-08-20)</h2> |
| 816 | |
| 817 | * (2.12.1): Fix client-side vulnerabilities discovered by Max Justicz. |
| 818 | * Security fix in the "[/help/git|fossil git export]" command. |
| 819 | The same fix is also backported to version 2.10.1 and 2.11.1. |
| 820 | New "safety-net" features were added to prevent similar problems |
| 821 | in the future. |
| 822 | * Enhancements to the graph display for cases when there are |
| 823 | many cherry-pick merges into a single check-in. |
| 824 | [/timeline?f=2d75e87b760c0a9|Example] |
| 825 | * Enhance the [/help/open|fossil open] command with the new |
| 826 | --workdir option and the ability to accept a URL as the repository |
| 827 | name, causing the remote repository to be cloned automatically. |
| 828 | Do not allow "fossil open" to open in a non-empty working directory |
| 829 | unless the --keep option or the new --force option is used. |
| 830 | * Enhance the markdown formatter to more closely follow the |
| @@ -833,65 +833,65 @@ | |
| 833 | Underscores in the middle of identifiers (ex: fossil_printf()) |
| 834 | no longer need to be escaped. |
| 835 | * The markdown-to-html translator can prevent unsafe HTML |
| 836 | (for example: <script>) on user-contributed pages like forum and |
| 837 | tickets and wiki. The admin can adjust this behavior using |
| 838 | the [/help/safe-html|safe-html setting] on the Admin/Wiki page. |
| 839 | The default is to disallow unsafe HTML everywhere. |
| 840 | [https://fossil-scm.org/forum/forumpost/3714e6568f|Example]. |
| 841 | * Added the "collapse" and "expand" capability for long forum posts. |
| 842 | [https://fossil-scm.org/forum/forumpost/9297029862|Example] |
| 843 | * The "[/help/remote-url|fossil remote]" command now has options for |
| 844 | specifying multiple persistent remotes with symbolic names. Currently |
| 845 | only one remote can be used at a time, but that might change in the |
| 846 | future. |
| 847 | * Add the "Remember me?" checkbox on the login page. Use a session |
| 848 | cookie for the login if it is not checked. |
| 849 | * Added the experimental "[/help/hook|fossil hook]" command for |
| 850 | managing "hook scripts" that run before checkin or after a push. |
| 851 | * Enhance the [/help/revert|fossil revert] command so that it |
| 852 | is able to revert all files beneath a directory. |
| 853 | * Add the [/help/bisect|fossil bisect skip] command. |
| 854 | * Add the [/help/backup|fossil backup] command. |
| 855 | * Enhance [/help/bisect|fossil bisect ui] so that it shows all unchecked |
| 856 | check-ins in between the innermost "good" and "bad" check-ins. |
| 857 | * Added the <tt>--reset</tt> flag to the "[/help/add|fossil add]", |
| 858 | "[/help/rm|fossil rm]", and |
| 859 | "[/help/addremove|fossil addremove]" commands. |
| 860 | * Added the "<tt>--min</tt> <i>N</i>" and "<tt>--logfile</tt> <i>FILENAME</i>" |
| 861 | flags to the [/help/backoffice|backoffice] command, as well as other |
| 862 | enhancements to make the backoffice command a viable replacement for |
| 863 | automatic backoffice. Other incremental backoffice improvements. |
| 864 | * Added the [/help/www/fileedit|/fileedit page], which allows |
| 865 | editing of text files online. Requires explicit activation by |
| 866 | a setup user. |
| 867 | * Translate built-in help text into HTML for display on web pages. |
| 868 | [/help/help|Example]. |
| 869 | * On the [/help/www/timeline|/timeline] webpage, the combination |
| 870 | of query parameters "p=CHECKIN" and "bt=ANCESTOR" draws all |
| 871 | ancestors of CHECKIN going back to ANCESTOR. For example, |
| 872 | [/timeline?p=202006271506&bt=version-2.11] shows all ancestors |
| 873 | of the checkin that occurred on 2020-06-27 15:06 going back to |
| 874 | the 2.11 release. |
| 875 | * Update the built-in SQLite so that the |
| 876 | "[/help/sql|fossil sql]" command supports new output |
| 877 | modes ".mode box" and ".mode json". |
| 878 | * Add the "<tt>obscure()</tt>" SQL function to the |
| 879 | "[/help/sql|fossil sql]" command. |
| 880 | * Added virtual tables "<tt>helptext</tt>" and "<tt>builtin</tt>" to |
| 881 | the "[/help/sql|fossil sql]" command, providing access to the |
| 882 | dispatch table including all help text, and the builtin data files, |
| 883 | respectively. |
| 884 | * [./delta_format.wiki|Delta compression] is now applied to forum edits. |
| 885 | * The [/help/www/wikiedit|wiki editor] has been modernized and is |
| 886 | now Ajax-based. The WYSIWYG editing option for Fossil-format wiki |
| 887 | pages was removed. (Please let us know, via the site's Forum menu, |
| 888 | if that removal unduly impacts you.) This also changes the semantics |
| 889 | of the wiki "Sandbox": that pseudo-page may be freely edited but |
| 890 | no longer saved via the UI (the [/help/wiki|wiki CLI command] |
| 891 | can, though). |
| 892 | * The [/help/allow-symlinks|allow-symlinks setting] no longer |
| 893 | syncs. It must be activated individually on any clones which require |
| 894 | symlinks. |
| 895 | * Countless documentation enhancements. |
| 896 | |
| 897 | <h2 id='v2_11'>Changes for Version 2.11 (2020-05-25)</h2> |
| @@ -903,46 +903,46 @@ | |
| 903 | can now omit punctation. So, for example, "202004181942" and |
| 904 | "2020-04-18 19:42" mean the same thing. |
| 905 | * Enhance backlink processing so that it works with Markdown-formatted |
| 906 | tickets and so that it works for wiki pages. |
| 907 | Ticket [a3572c6a5b47cd5a]. |
| 908 | <ul><li> "[/help/rebuild|fossil rebuild]" is needed to |
| 909 | take full advantage of this fix. Fossil will continue |
| 910 | to work without the rebuild, but the new backlinks will be missing.</ul> |
| 911 | * The algorithm for finding the |
| 912 | [./tech_overview.wiki#configloc|location of the configuration database] |
| 913 | is enhanced to be XDG-compliant. |
| 914 | * Add a hide/show feature to |
| 915 | [./wikitheory.wiki#assocwiki|associated wiki] display on |
| 916 | check-in and branch information pages. |
| 917 | * Enhance the "[/help/info|fossil info]" command so that it |
| 918 | works with no arguments even if not within an open check-out. |
| 919 | * Many improvements to the forum and especially email notification |
| 920 | of forum posts, in response to community feedback after switching |
| 921 | SQLite support from a mailing list over to the forum. |
| 922 | * Minimum length of a self-registered user ID increased from 3 to 6 |
| 923 | characters. |
| 924 | * When the "vfx" query parameter is used on the |
| 925 | "[/help/www/timeline|/timeline]" page, it causes the complete |
| 926 | text of forum posts to be displayed. |
| 927 | * Rework the "[/help/grep|fossil grep]" command to be more useful. |
| 928 | * Expose the [/help/redirect-to-https|redirect-to-https] |
| 929 | setting to the [/help/settings|settings] command. |
| 930 | * Improve support for CGI on IIS web servers. |
| 931 | * The [./serverext.wiki|/ext page] can now render index files, |
| 932 | in the same way as the embedded docs. |
| 933 | * Most commands now support the Unix-conventional "<tt>--</tt>" |
| 934 | flag to treat all following arguments as filenames |
| 935 | instead of flags. |
| 936 | * Added the [/help/mimetypes|mimetypes config setting] |
| 937 | (versionable) to enable mimetype overrides and custom definitions. |
| 938 | * Add an option on the /Admin/Timeline setup page to set a default |
| 939 | timeline style other than "Modern". |
| 940 | * In [./embeddeddoc.wiki|embedded documentation], hyperlink URLs |
| 941 | of the form "/doc/$CURRENT/..." the "$CURRENT" text is translated |
| 942 | into the check-in hash for the document currently being viewed. |
| 943 | * Added the [/help/www/phantoms|/phantoms] webpage that shows all |
| 944 | phantom artifacts. |
| 945 | * Enhancements to phantom processing to try to reduce |
| 946 | bandwidth-using chatter about phantoms on the sync protocol. |
| 947 | * Security: Fossil now assumes that the schema of every |
| 948 | database it opens has been tampered with by an adversary and takes |
| @@ -950,23 +950,23 @@ | |
| 950 | * Security: Fossil now puts the Content-Security-Policy in the |
| 951 | HTTP reply header, in addition to also leaving it in the |
| 952 | HTML <head> section, so that it is always available, even |
| 953 | if a custom skin overrides the HTML <head> and omits |
| 954 | the CSP in the process. |
| 955 | * Output of the [/help/diff|fossil diff -y] command automatically |
| 956 | adjusts according to the terminal width. |
| 957 | * The Content-Security-Policy is now set using the |
| 958 | [/help/default-csp|default-csp setting]. |
| 959 | * Merge conflicts caused via the [/help/merge|merge] and |
| 960 | [/help/update|update] commands no longer leave temporary |
| 961 | files behind unless the new <tt>--keep-merge-files</tt> flag |
| 962 | is used. |
| 963 | * The [/help/www/artifact_stats|/artifact_stats page] is now accessible |
| 964 | to all users if the new "artifact_stats_enable" setting is turned |
| 965 | on. There is a new checkbox under the /Admin/Access menu to turn |
| 966 | that capability on and off. |
| 967 | * Add the [/help/tls-config|fossil tls-config] command for viewing |
| 968 | the TLS configuration and the list of SSL Cert exceptions. |
| 969 | * Captchas all include a button to read the captcha using an audio |
| 970 | file, so that they can be completed by the visually impaired. |
| 971 | * Stop using the IP address as part of the login cookie. |
| 972 | * Bug fix: fix the SSL cert validation logic so that if an exception |
| @@ -987,27 +987,27 @@ | |
| 987 | <h2 id='v2_10'>Changes for Version 2.10 (2019-10-04)</h2> |
| 988 | |
| 989 | * (2.10.2): backport security fixes from 2.12.1 |
| 990 | * (2.10.1): backport security fix for the "fossil git export" command. |
| 991 | * Added support for [./serverext.wiki|CGI-based Server Extensions]. |
| 992 | * Added the [/help/repolist-skin|repolist-skin] setting used to |
| 993 | add style to repository list pages. |
| 994 | * Enhance the hierarchical display of Forum threads to do less |
| 995 | indentation and to provide links back to the previous message |
| 996 | in the thread. Provide sequential numbers for all messages in |
| 997 | a forum thread. |
| 998 | * Add support for fenced code blocks and improved hyperlink |
| 999 | processing to the [/md_rules|markdown formatter]. |
| 1000 | * Add support for hyperlinks to wiki pages in the |
| 1001 | [/md_rules|markdown formatter]. |
| 1002 | * Enhance the [/help/www/stat|/stat] page so that it gives the |
| 1003 | option to show a breakdown of forum posts. |
| 1004 | * The special check-in name "merge-in:BRANCH" means the source of |
| 1005 | the most recent merge-in from the parent branch of BRANCH. |
| 1006 | * Add hyperlinks to branch-diffs on the /info page and from |
| 1007 | timelines of a branch. |
| 1008 | * Add graphical context on the [/help/www/vdiff|/vdiff] page. |
| 1009 | * Uppercase query parameters, POST parameters, and cookie names are |
| 1010 | converted to all lowercase and entered into the parameter set, |
| 1011 | instead of being discarded. |
| 1012 | * Change the default [./hashpolicy.wiki|hash policy] to SHA3. |
| 1013 | * Timeout [./server/any/cgi.md|CGI requests] after 300 seconds, or |
| @@ -1020,14 +1020,14 @@ | |
| 1020 | * Performance optimizations. |
| 1021 | * Many documentation improvements. |
| 1022 | |
| 1023 | <h2 id='v2_9'>Changes for Version 2.9 (2019-07-13)</h2> |
| 1024 | |
| 1025 | * Added the [/help/git|fossil git export] command and instructions |
| 1026 | for [./mirrortogithub.md|creating a GitHub mirror of a Fossil project]. |
| 1027 | * Improved handling of relative hyperlinks on the |
| 1028 | [/help/www/artifact|/artifact] pages for wiki. For example, |
| 1029 | hyperlinks and the lizard <img> now work correctly |
| 1030 | for both [/artifact/2ff24ab0887cf522] and |
| 1031 | [/doc/0d7ac90d575004c2415/www/index.wiki]. |
| 1032 | * Enhancements to the timeline graph layout, to show more information |
| 1033 | with less clutter. |
| @@ -1036,28 +1036,28 @@ | |
| 1036 | configuration. |
| 1037 | * Copy buttons added to various check-in hash and branch name links. |
| 1038 | * Double-clicking on a /timeline graph node now jumps to the /info page |
| 1039 | for the check-in. So, repurpose the timestamp hyperlink to show all |
| 1040 | activity around that check-in in time. |
| 1041 | * Added the [/help/touch|fossil touch] command, and the --setmtime |
| 1042 | option on the [/help/open|fossil open] and |
| 1043 | [/help/update|fossil update] commands. |
| 1044 | * Many documentation enhancements. |
| 1045 | * For the "[/help/update|fossil update]" and |
| 1046 | "[/help/checkout|fossil checkout]" commands, if a |
| 1047 | managed file is removed because it is no longer part of the target |
| 1048 | check-in and the directory containing the file is empty after the |
| 1049 | file is removed and the directory is not the current working |
| 1050 | directory and is not on the [/help/empty-dirs|empty-dirs] |
| 1051 | list, then also remove the directory. |
| 1052 | * Update internal Unicode character tables, used in regular expression |
| 1053 | handling, from version 11.0 to 12.1. |
| 1054 | * In "[/help/regexp|fossil regexp]", "[/help/grep|fossil grep]" |
| 1055 | and the TH1 "regexp" command, the -nocase option now removes multiple |
| 1056 | diacritics from the same character (derived from SQLite's |
| 1057 | remove_diacritics=2) |
| 1058 | * Added the [/help/www/secureraw|/secureraw] page that requires the |
| 1059 | complete SHA1 or SHA3 hash, not just a prefix, before it will deliver |
| 1060 | content. |
| 1061 | * Accept purely numeric ISO8601 date/time strings as long as they |
| 1062 | do not conflict with a hash. Example: "20190510134217" instead of |
| 1063 | "2019-05-10 13:42:17". This helps keep URLs shorter and less |
| @@ -1070,19 +1070,19 @@ | |
| 1070 | extra path element is not needed. |
| 1071 | * If an automatic sync gets a permanent redirect request, then update |
| 1072 | the saved remote URL to the new address. |
| 1073 | * Temporary filenames (for example used for external "diff" commands) |
| 1074 | try to preserve the suffix of the original file. |
| 1075 | * Added the [/help/www/thisdayinhistory|/thisdayinhistory] web page. |
| 1076 | * Enhanced parsing of [/help/www/timeline|/timeline] query parameters |
| 1077 | "ymd=", "ym=", and "yw=". All arguments are option (in which case they |
| 1078 | default to the current time) and all accept ISO8601 date/times without |
| 1079 | punctuation. |
| 1080 | * Automatically disapprove pending moderation requests for a user when |
| 1081 | that user is deleted. This helps in dealing with spam-bots. |
| 1082 | * Improvements to the "Capability Summary" section in the |
| 1083 | [/help/www/secaudit0|Security Audit] web-page. |
| 1084 | * Use new "ci-lock" and "ci-lock-failed" pragmas in the |
| 1085 | [./sync.wiki|sync protocol] to try to prevent accident forks |
| 1086 | caused by concurrent commits when operating in auto-sync mode. |
| 1087 | * Fix a bug ([https://fossil-scm.org/forum/forumpost/c51b9a1169|details]) |
| 1088 | that can cause repository databases to be overwritten with debugging |
| @@ -1183,11 +1183,11 @@ | |
| 1183 | included in the header or footer. |
| 1184 | * Add the [./backoffice.md|backoffice]. |
| 1185 | * Update internal Unicode character tables, used in regular expression |
| 1186 | handling, from version 10.0 to 11.0. |
| 1187 | * Improvements to the "Security Audit" administration page |
| 1188 | * Add the [/help/branch|fossil branch current] command. |
| 1189 | * Add the [./grep.md|grep] command. |
| 1190 | * Update the built-in SQLite to version 3.25.1. |
| 1191 | * Some code and interfaces are in place to support sending and |
| 1192 | receiving email directly via SMTP, but this feature is not yet |
| 1193 | complete or ready for production use. |
| @@ -1206,20 +1206,20 @@ | |
| 1206 | same as "Verbose" in the previous release. The "Verbose" mode is |
| 1207 | now like "Compact" except the extra check-in details are shown by |
| 1208 | default. |
| 1209 | * Add support for ETags:, Last-Modified:, and If-Modified-Since: |
| 1210 | cache control mechanisms. |
| 1211 | * Enhance the [/help/www/tarball|/tarball], |
| 1212 | [/help/www/zip|/zip], and |
| 1213 | [/help/www/sqlar|/sqlar] pages so that the checkin |
| 1214 | name to be downloaded can be expressed as part of the URI, |
| 1215 | and without the need for query parameters. |
| 1216 | * On the [/help/www/timeline|/timeline] webpage, add the days=N |
| 1217 | query parameter and enhance the ymd=DATE and yw=DATE query parameters |
| 1218 | to accept 'now' as an argument to show the latest day or week. |
| 1219 | * In the web page that comes up in response to the |
| 1220 | [/help/all|fossil all ui] command, show the last modification |
| 1221 | time for each repository, and allow click-to-sort on the modification |
| 1222 | time column. |
| 1223 | * In the tarball cache replacement algorithm, give extra weight to |
| 1224 | tarballs that have been accessed more than once. |
| 1225 | * Additional defenses against web-based attacks. There have not been |
| @@ -1266,35 +1266,35 @@ | |
| 1266 | to define their own URLs on the web interface that are rewritten to |
| 1267 | built-in URLs with specific parameters. Create and configure URL Aliases |
| 1268 | using the /Setup/URL_Aliases menu option in the web interface. |
| 1269 | * Add tech-note search capability. |
| 1270 | * Add the -r|--revision and -o|--origin options to the |
| 1271 | [/help/annotate|annotate] command. |
| 1272 | * Add the origin= query parameter to the [/help/www/annotate|/annotate] |
| 1273 | webpage. |
| 1274 | * The [/help/annotate|fossil annotate] command and the |
| 1275 | [/help/www/annotate|/annotate] web page go backwards in time as far |
| 1276 | as can be computed in 30 milliseconds by default, rather than stopping |
| 1277 | after 20 steps. The new limit= query parameter or the --limit command-line |
| 1278 | option can be used to alter this timeout. |
| 1279 | * Provide separate [/help#settings|on-line help screens for each setting]. |
| 1280 | * Back out support for the --no-dir-symlinks option |
| 1281 | * Remove support from the legacy configuration sync protocol. The only |
| 1282 | way now to do a configuration push or pull is to use the new protocol that |
| 1283 | was added in 2011. |
| 1284 | * Add the from= and to= query parameters to [/help/www/fdiff|/fdiff] |
| 1285 | in order to get a diff of two files in the same check-in. |
| 1286 | * Fix the "ssh://" protocol to prevent an attack whereby the attacker convinces |
| 1287 | a victim to run a "clone" with a dodgy URL and thereby gains access to their |
| 1288 | system. |
| 1289 | * Provide a checkbox that will temporarily disable all ad-units. |
| 1290 | * Improvements to the [/help/www/stat|/stat] page |
| 1291 | * Various new hyperlinks to the [/help/www/bloblist|/bloblist] |
| 1292 | and [/help/www/bigbloblist|/bigbloblist] pages. |
| 1293 | * Correct the [/help/www/doc|/doc] page to support read-only repositories. |
| 1294 | * Correct [/help/www/zip|/zip], [/help/www/tarball|/tarball], |
| 1295 | [/help/zip|zip], and [/help/tarball|tarball] pages and commands to |
| 1296 | honor the versioned manifest setting when outside of an open checkout |
| 1297 | directory. |
| 1298 | * The admin-log and access-log settings are now on by default for |
| 1299 | new repositories. |
| 1300 | * Update the built-in SQLite to version 3.21.0. |
| @@ -1302,34 +1302,34 @@ | |
| 1302 | <h2 id='v2_3'>Changes for Version 2.3 (2017-07-21)</h2> |
| 1303 | |
| 1304 | * Update the built-in SQLite to version 3.20.0 (beta). |
| 1305 | * Update internal Unicode character tables, used in regular expression |
| 1306 | handling, from version 9.0 to 10.0. |
| 1307 | * Show the last-sync-URL on the [/help/www/urllist|/urllist] page. |
| 1308 | * Added the "Event Summary" activity report. |
| 1309 | [/reports?type=ci&view=lastchng|example] |
| 1310 | * Added the "Security Audit" page, available to administrators only |
| 1311 | * Added the Last Login time to the user list page, for administrators only |
| 1312 | * Added the --numstat option to the [/help/diff|fossil diff] command |
| 1313 | * Limit the size of the heap and stack on unix systems, as a proactive |
| 1314 | defense against the |
| 1315 | [https://www.qualys.com/2017/06/19/stack-clash/stack-clash.txt|Stack Clash] |
| 1316 | attack. |
| 1317 | * Fix "database locked" warnings caused by "PRAGMA optimize". |
| 1318 | * Fix a potential XSS vulnerability on the |
| 1319 | [/help/www/help|/help] webpage. |
| 1320 | * Documentation updates |
| 1321 | |
| 1322 | <h2 id='v2_2'>Changes for Version 2.2 (2017-04-11)</h2> |
| 1323 | |
| 1324 | * GIT comment tags are now handled by Fossil during import/export. |
| 1325 | * Show the content of README files on directory listings. |
| 1326 | ([/file/skins|example]) |
| 1327 | * Support for Basic Authentication if enabled (default off). |
| 1328 | * Show the hash algorithms used on the |
| 1329 | [/help/www/rcvfromlist|/rcvfromlist] page. |
| 1330 | * The [/help/www/tarball|/tarball] and [/help/www/zip|/zip] pages |
| 1331 | now use the the r= query parameter |
| 1332 | to select which check-in to deliver. The uuid= query parameter |
| 1333 | is still accepted for backwards compatibility. |
| 1334 | * Update the built-in SQLite to version 3.18.0. |
| 1335 | * Run "[https://www.sqlite.org/pragma.html#pragma_optimize|PRAGMA optimize]" |
| @@ -1338,12 +1338,12 @@ | |
| 1338 | <h2 id='v2_1'>Changes for Version 2.1 (2017-03-10)</h2> |
| 1339 | |
| 1340 | * Add support for [./hashpolicy.wiki|hash policies] that control which |
| 1341 | of the Hardened-SHA1 or SHA3-256 algorithms is used to name new |
| 1342 | artifacts. |
| 1343 | * Add the "gshow" and "gcat" subcommands to [/help/stash|fossil stash]. |
| 1344 | * Add the [/help/www/juvlist|/juvlist] web page and use it to construct |
| 1345 | the [/uv/download.html|Download Page] of the Fossil self-hosting website |
| 1346 | using Ajax. |
| 1347 | |
| 1348 | <h2 id='v2_0'>Changes for Version 2.0 (2017-03-03)</h2> |
| 1349 | |
| @@ -1351,23 +1351,23 @@ | |
| 1351 | [https://github.com/cr-marcstevens/sha1collisiondetection|hardened SHA1] |
| 1352 | implementation by Marc Stevens and Dan Shumow. |
| 1353 | * Add the ability to read and understand |
| 1354 | [./fileformat.wiki#names|artifact names] that are based on SHA3-256 |
| 1355 | rather than SHA1, but do not actually generate any such names. |
| 1356 | * Added the [/help/sha3sum|sha3sum] command. |
| 1357 | * Update the built-in SQLite to version 3.17.0. |
| 1358 | |
| 1359 | <h2 id='v1_37'>Changes for Version 1.37 (2017-01-16)</h2> |
| 1360 | |
| 1361 | * Add checkbox widgets to various web pages. See [/technote/8d18bf27e9| |
| 1362 | this technote] for more information. To get the checkboxes to look as |
| 1363 | intended, you must update the CSS in your repository and all clones. |
| 1364 | * Add the [/help/all|fossil all ui] command |
| 1365 | * Add the [/help/www/file|/file] webpage |
| 1366 | * Enhance the [/help/www/brlist|/brlist] webpage to make use of branch colors. |
| 1367 | * Add support for the ms=EXACT|LIKE|GLOB|REGEXP query parameter on the |
| 1368 | [/help/www/timeline|/timeline] webpage, with associated form widgets. |
| 1369 | * Enhance the [/help/changes|changes] and [/help/status|status] commands |
| 1370 | with many new filter options so that specific kinds of changes can be |
| 1371 | found without having to pipe through grep or sed. |
| 1372 | * Enhanced the [/help/sqlite3|fossil sql] command so that it opens the |
| 1373 | [./tech_overview.wiki#localdb|checkout database] and the |
| @@ -1380,11 +1380,11 @@ | |
| 1380 | </ul> |
| 1381 | * Rename crnl-glob [/help/settings|setting] to crlf-glob, but keep |
| 1382 | crnl-glob as a compatibility alias. |
| 1383 | * Added the --command option to the [/help/diff|diff] command. |
| 1384 | * Fix a C99-ism that prevents the 1.36 release from building with MSVC. |
| 1385 | * Fix [/help/ticket|ticket set] when using the "+" prefix with fields |
| 1386 | from the "ticketchng" table. |
| 1387 | * Remove the "fusefs" command from builds that do not have the underlying |
| 1388 | support enabled. |
| 1389 | * Fixes for incremental git import/export. |
| 1390 | * Minor security enhancements to |
| @@ -1394,58 +1394,58 @@ | |
| 1394 | |
| 1395 | |
| 1396 | <h2 id='v1_36'>Changes for Version 1.36 (2016-10-24)</h2> |
| 1397 | |
| 1398 | * Add support for [./unvers.wiki|unversioned content], |
| 1399 | the [/help/unversioned|fossil unversioned] command and the |
| 1400 | [/help/www/uv|/uv] and [/uvlist] web pages. |
| 1401 | * The [/uv/download.html|download page] is moved into |
| 1402 | [./unvers.wiki|unversioned content] so that the self-hosting Fossil |
| 1403 | websites no longer uses any external content. |
| 1404 | * Added the "Search" button to the graphical diff generated by |
| 1405 | the --tk option on the [/help/diff|diff] command. |
| 1406 | * Added the "--checkin VERSION" option to the |
| 1407 | [/help/diff|diff] command. |
| 1408 | * Various performance enhancements to the [/help/diff|diff] command. |
| 1409 | * Update internal Unicode character tables, used in regular expression |
| 1410 | handling, from version 8.0 to 9.0. |
| 1411 | * Update the built-in SQLite to version 3.15. Fossil now requires |
| 1412 | the SQLITE_DBCONFIG_MAINDBNAME interface of SQLite which is only available |
| 1413 | in SQLite version 3.15 and later and so Fossil will not work with |
| 1414 | earlier SQLite versions. |
| 1415 | * Fix [https://www.mail-archive.com/[email protected]/msg23618.html|multi-line timeline bug] |
| 1416 | * Enhance the [/help/purge|fossil purge] command. |
| 1417 | * New command [/help/shell|fossil shell]. |
| 1418 | * SQL parameters whose names are all lower-case in Ticket Report SQL |
| 1419 | queries are filled in using HTTP query parameter values. |
| 1420 | * Added support for [./childprojects.wiki|child projects] that are |
| 1421 | able to pull from their parent but not push. |
| 1422 | * Added the -nocomplain option to the TH1 "query" command. |
| 1423 | * Added support for the chng=GLOBLIST query parameter on the |
| 1424 | [/help/www/timeline|/timeline] webpage. |
| 1425 | |
| 1426 | <h2 id='v1_35'>Changes for Version 1.35 (2016-06-14)</h2> |
| 1427 | |
| 1428 | * Enable symlinks by default on all non-Windows platforms. |
| 1429 | * Enhance the [/md_rules|Markdown formatting] so that hyperlinks that begin |
| 1430 | with "/" are relative to the root of the Fossil repository. |
| 1431 | * Rework the [/help/www/setup_ulist|/setup_list page] (the User List page) |
| 1432 | to display all users in a click-to-sort table. |
| 1433 | * Fix backslash-octal escape on filenames while importing from git |
| 1434 | * When markdown documents begin with <h1> HTML elements, use that |
| 1435 | header at the document title. |
| 1436 | * Added the [/help/www/bigbloblist|/bigbloblist page]. |
| 1437 | * Enhance the [/help/www/finfo|/finfo page] so that when it is showing |
| 1438 | the ancestors of a particular file version, it only shows direct |
| 1439 | ancestors and omits changes on branches, thus making it show the same set |
| 1440 | of ancestors that are used for [/help/www/blame|/blame]. |
| 1441 | * Added the --page option to the [/help/ui|fossil ui] command |
| 1442 | * Added the [/help/bisect|fossil bisect ui] command |
| 1443 | * Enhanced the [/help/diff|fossil diff] command so that it accepts |
| 1444 | directory names as arguments and computes diffs on all files contained |
| 1445 | within those directories. |
| 1446 | * Fix the [/help/add|fossil add] command so that it shows "SKIP" for |
| 1447 | files added that were already under management. |
| 1448 | * TH1 enhancements: |
| 1449 | <ul><li>Add <nowiki>[array exists]</nowiki> command.</li> |
| 1450 | <li>Add minimal <nowiki>[array names]</nowiki> command.</li> |
| 1451 | <li>Add tcl_platform(engine) and tcl_platform(platform) array |
| @@ -1453,32 +1453,32 @@ | |
| 1453 | </ul> |
| 1454 | * Get autosetup working with MinGW. |
| 1455 | * Fix autosetup detection of zlib in the source tree. |
| 1456 | * Added autosetup detection of OpenSSL when it may be present under the |
| 1457 | "compat" subdirectory of the source tree. |
| 1458 | * Added the [/help/reparent|fossil reparent] command |
| 1459 | * Added --include and --exclude options to [/help/tarball|fossil tarball] |
| 1460 | and [/help/zip|fossil zip] and the in= and ex= query parameters to the |
| 1461 | [/help/www/tarball|/tarball] and [/help/www/zip|/zip] web pages. |
| 1462 | * Add support for [./encryptedrepos.wiki|encrypted Fossil repositories]. |
| 1463 | * If the FOSSIL_PWREADER environment variable is set, then use the program it |
| 1464 | names in place of getpass() to read passwords and passphrases |
| 1465 | * Option --baseurl now works on Windows. |
| 1466 | * Numerous documentation improvements. |
| 1467 | * Update the built-in SQLite to version 3.13.0. |
| 1468 | |
| 1469 | <h2 id='v1_34'>Changes for Version 1.34 (2015-11-02)</h2> |
| 1470 | |
| 1471 | * Make the [/help/clean|fossil clean] command undoable for files less |
| 1472 | than 10MiB. |
| 1473 | * Update internal Unicode character tables, used in regular expression |
| 1474 | handling, from version 7.0 to 8.0. |
| 1475 | * Add the new [/help/amend|amend] command which is used to modify |
| 1476 | tags of a "check-in". |
| 1477 | * Fix bug in [/help/import|import] command, handling version 3 of |
| 1478 | the svndump format for subversion. |
| 1479 | * Add the [/help/all|all cache] command. |
| 1480 | * TH1 enhancements: |
| 1481 | <ul><li>Add minimal <nowiki>[lsearch]</nowiki> command. Only exact |
| 1482 | case-sensitive matching is supported.</li> |
| 1483 | <li>Add the <nowiki>[glob_match]</nowiki>, <nowiki>[markdown]</nowiki>, |
| 1484 | <nowiki>[dir]</nowiki>, and <nowiki>[encode64]</nowiki> commands.</li> |
| @@ -1485,106 +1485,106 @@ | |
| 1485 | <li>Add the <nowiki>[tclIsSafe] and [tclMakeSafe]</nowiki> commands to |
| 1486 | the Tcl integration subsystem.</li> |
| 1487 | <li>Add 'double', 'integer', and 'list' classes to the |
| 1488 | <nowiki>[string is]</nowiki> command.</li> |
| 1489 | </ul> |
| 1490 | * Add the --undo option to the [/help/diff|diff] command. |
| 1491 | * Build-in Antirez's "linenoise" command-line editing library for use with |
| 1492 | the [/help/sqlite3|fossil sql] command on Unix platforms. |
| 1493 | * Add [/help/stash|stash cat] as an alias for the |
| 1494 | [/help/stash|stash show] command. |
| 1495 | * Automatically pull before [/help/merge|fossil merge] when auto-sync |
| 1496 | is enabled. |
| 1497 | * Fix --hard option to [/help/mv|fossil mv] and [/help/rm|fossil rm] |
| 1498 | to enable them to work properly with certain relative paths. |
| 1499 | * Change the mimetype for ".n" and ".man" files to text/plain. |
| 1500 | * Display improvements in the [/help/bisect|fossil bisect chart] command. |
| 1501 | * Updated the built-in SQLite to version 3.9.1 and activated JSON1 and FTS5 |
| 1502 | support (both currently unused within Fossil). |
| 1503 | |
| 1504 | <h2 id='v1_33'>Changes for Version 1.33 (2015-05-23)</h2> |
| 1505 | * Improved fork detection on [/help/update|fossil update], |
| 1506 | [/help/status|fossil status] and related commands. |
| 1507 | * Change the default skin to what used to be called "San Francisco Modern". |
| 1508 | * Add the [/repo-tabsize] web page |
| 1509 | * Add [/help/import|fossil import --svn], for importing a subversion |
| 1510 | repository into fossil which was exported using "svnadmin dump". |
| 1511 | * Add the "--compress-only" option to [/help/rebuild|fossil rebuild]. |
| 1512 | * Use a pie chart on the [/reports?view=byuser] page. |
| 1513 | * Enhanced [/help/clean|fossil clean --verily] so that it ignores |
| 1514 | keep-glob and ignore-glob settings. Added the -x alias for --verily. |
| 1515 | * Add the --soft and --hard options to [/help/rm|fossil rm] and |
| 1516 | [/help/mv|fossil mv]. The default is still --soft, but that is |
| 1517 | now configurable at compile-time or by the mv-rm-files setting. |
| 1518 | * Improved ability to [./customgraph.md|customize the timeline graph]. |
| 1519 | * Improvements to the [/sitemap] page. |
| 1520 | * Automatically adjust the [/help/timeline|CLI timeline] to the terminal |
| 1521 | width on Linux. |
| 1522 | * Added <nowiki>[info commands] and [info vars]</nowiki> commands to TH1. |
| 1523 | These commands perform the same function as their Tcl counterparts, |
| 1524 | except they do not accept a pattern argument. |
| 1525 | * Fix some obscure issues with TH1 expression processing. |
| 1526 | * Fix titles in search results for documents that are not wiki, markdown, |
| 1527 | or HTML. |
| 1528 | * Formally translate TH1 to Tcl return codes and vice-versa, where |
| 1529 | necessary, in the Tcl integration subsystem. |
| 1530 | * Add [/help/leaves|fossil leaves -multiple], for finding multiple |
| 1531 | leaves on the same branch. |
| 1532 | * Added the "Blitz" skin option. |
| 1533 | * Removed the ".fossil-settings/keep-glob" file. It should not have been |
| 1534 | checked into the repository. |
| 1535 | * Update the built-in SQLite to version 3.8.10.2. |
| 1536 | * Make [/help/open|fossil open] honor ".fossil-settings/allow-symlinks". |
| 1537 | * Allow [/help/add|fossil add] to be used on symlinks to nonexistent or |
| 1538 | unreadable files in the same way as [/help/addremove|fossil addremove]. |
| 1539 | * Added fork warning to be issued if sync produced a fork |
| 1540 | * Update the [/help/www/info|info] page to report when a file becomes a |
| 1541 | symlink. Additionally show the UUID for files whose types have changed |
| 1542 | without changing contents or symlink target. |
| 1543 | * Have [/help/changes|fossil changes] and |
| 1544 | [/help/status|fossil status] report when executable or symlink status |
| 1545 | changes on otherwise unmodified files. |
| 1546 | * Permit filtering weekday and file [/help/www/reports|reports] by user. |
| 1547 | Also ensure the user parameter is preserved when changing types. Add a |
| 1548 | field for direct entry of the user name to each applicable report. |
| 1549 | * Create parent directories of [/help/settings|empty-dirs] if they don't |
| 1550 | already exist. |
| 1551 | * Inhibit timeline links to wiki pages that have been deleted. |
| 1552 | |
| 1553 | <h2 id='v1_33'>Changes for Version 1.32 (2015-03-14)</h2> |
| 1554 | * When creating a new repository using [/help/init|fossil init], ensure |
| 1555 | that the new repository is fully compatible with historical versions of |
| 1556 | Fossil by having a valid manifest as RID 1. |
| 1557 | * Anti-aliased rendering of arrowheads on timeline graphs. |
| 1558 | * Added vi/less-style key bindings to the --tk diff GUI. |
| 1559 | * Documentation updates to fix spellings and changes all "checkins" to |
| 1560 | "check-ins". |
| 1561 | * Add the --repolist option to server commands such as |
| 1562 | [/help/server|fossil server] or [/help/http|fossil http]. |
| 1563 | * Added the "Xekri" skin. |
| 1564 | * Enhance the "ln=" query parameter on artifact displays to accept multiple |
| 1565 | ranges, separate by spaces (or "+" when URL-encoded). |
| 1566 | * Added [/help/forget|fossil forget] as an alias for |
| 1567 | [/help/rm|fossil rm]. |
| 1568 | |
| 1569 | <h2 id='v1_31'>Changes For Version 1.31 (2015-02-23)</h2> |
| 1570 | * Change the auxiliary schema by adding columns MLINK.ISAUX and MLINK.PMID |
| 1571 | columns to the schema, to support better drawing of file change graphs. |
| 1572 | A [/help/rebuild|fossil rebuild] is recommended but is not required. |
| 1573 | so that the new graph drawing logic can work effectively. |
| 1574 | * Added [/search|search] over Check-in comments, Documents, Tickets and |
| 1575 | Wiki. Disabled by default. The search can be either a full-scan or it |
| 1576 | can use an index that is kept up-to-date automatically. The new |
| 1577 | /srchsetup web-page and the [/help/fts-config|fts-config] command |
| 1578 | were added to help configure the search capability. Expect further |
| 1579 | enhancements to the search capabilities in subsequent releases. |
| 1580 | * Added form elements to some submenus (in particular the /timeline) |
| 1581 | for easier operation. |
| 1582 | * Added the --ifneeded option to [/help/rebuild|fossil rebuild]. |
| 1583 | * Added "override skins" using the "skin:" line of the CGI script or |
| 1584 | using the --skin LABEL option on the [/help/server|server], |
| 1585 | [/help/ui|ui], or [/help/http|http] commands. |
| 1586 | * Embedded html documents that begin with |
| 1587 | <doc class="fossil-doc"> are displayed with standard |
| 1588 | headers and footers added. |
| 1589 | * Allow <div style='...'> markup in [/wiki_rules|wiki]. |
| 1590 | * Renamed "Events" to "Technical Notes", while updating the technote |
| @@ -1591,24 +1591,24 @@ | |
| 1591 | display and control pages. Add support for technotes as plain text |
| 1592 | or as Markdown. |
| 1593 | * Added the [/md_rules] pages containing summary instructions on the |
| 1594 | Markdown format. |
| 1595 | * Added the --repolist and --nojail options to the various server commands |
| 1596 | (ex: [/help/server|fossil server]). |
| 1597 | * Added the [/help/all|fossil all add] subcommand to "fossil all". |
| 1598 | * Improvements to the /login page. Some hyperlinks to pages that require |
| 1599 | "anonymous" privileges are displayed even if the current user is "nobody" |
| 1600 | but automatically redirect to /login. |
| 1601 | * The [/help/www/doc|/doc] web-page will now try to deliver the file |
| 1602 | "404.md" from the top-level directory (if such a file exists) in |
| 1603 | place of its built-in 404 text. |
| 1604 | * Download of Tarballs and ZIP Archives by user "nobody" is now enabled |
| 1605 | by default in new repositories. |
| 1606 | * Enhancements to the table sorting controls. More display tables |
| 1607 | are now sortable. |
| 1608 | * Add IPv6 support to [/help/sync|fossil sync] and |
| 1609 | [/help/clone|fossil clone] |
| 1610 | * Add more skins such as "San Francisco Modern" and "Eagle". |
| 1611 | * During shutdown, check to see if the check-out database (".fslckout") |
| 1612 | contains a lot of free space, and if it does, VACUUM it. |
| 1613 | * Added the [/mimetype_list] page. |
| 1614 | * Added the [/hash-collisions] page. |
| @@ -1616,14 +1616,14 @@ | |
| 1616 | ticket reports. |
| 1617 | * Break out the components (css, footer, and header) for the |
| 1618 | various built-in skins into separate files in the source tree. |
| 1619 | |
| 1620 | <h2 id='v1_30'>Changes For Version 1.30 (2015-01-19)</h2> |
| 1621 | * Added the [/help/bundle|fossil bundle] command. |
| 1622 | * Added the [/help/purge|fossil purge] command. |
| 1623 | * Added the [/help/publish|fossil publish] command. |
| 1624 | * Added the [/help/unpublished|fossil unpublished] command. |
| 1625 | * Enhance the [/tree] webpage to show the age of each file with the option |
| 1626 | to sort by age. |
| 1627 | * Enhance the [/brlist] webpage to show additional information about each branch |
| 1628 | and to be sortable by clicking on column headers. |
| 1629 | * Add support for Docker. Just install docker and type |
| @@ -1633,17 +1633,17 @@ | |
| 1633 | copies of all historical check-ins. This only works on systems that |
| 1634 | support FuseFS. |
| 1635 | * Add the administrative log that records all configuration. |
| 1636 | * Added the [/sitemap] webpage. |
| 1637 | * Added the [/bloblist] web page. |
| 1638 | * Let [/help/new|fossil new] no longer create an initial empty commit |
| 1639 | by default. The first commit after checking out an empty repository will |
| 1640 | become the initial commit. |
| 1641 | * Added the [/help/all|fossil all dbstat] and |
| 1642 | [/help/all|fossil all info] commands. |
| 1643 | * Update SQLite to version 3.8.8. |
| 1644 | * Added the --verily option to the [/help/clean|fossil clean] command. |
| 1645 | * Add the "autosync-tries" setting to control the number of autosync attempts |
| 1646 | before returning an error. |
| 1647 | * Added a compile-time option (--with-miniz) to build using miniz instead |
| 1648 | of zlib. Disabled by default. |
| 1649 | * Support customization of commands and webpages, including the ability to |
| @@ -1653,12 +1653,12 @@ | |
| 1653 | [trace], [getParameter], [setParameter], [artifact], and |
| 1654 | [globalState]</nowiki> commands to TH1, primarily for use by TH1 hooks. |
| 1655 | * Automatically adjust the width of command-line timeline output according to the |
| 1656 | detected width of the terminal. |
| 1657 | * Prompt the user to optionally fix invalid UTF-8 at check-in. |
| 1658 | * Added a line-number toggle option to the [/help/www/info|/info] |
| 1659 | and [/help/www/artifact|/artifact] pages. |
| 1660 | * Most commands now issue errors rather than silently ignoring unrecognized |
| 1661 | command-line options. |
| 1662 | * Use full 40-character SHA1 hashes (instead of abbreviations) in most |
| 1663 | internal URLs. |
| 1664 | * The "ssh:" sync method on Windows now uses "plink.exe" instead of "ssh" as |
| @@ -1672,11 +1672,11 @@ | |
| 1672 | * Fix a rare and long-standing sync protocol bug |
| 1673 | that would silently prevent the sync from running to completion. Before |
| 1674 | this bug-fix it was sometimes necessary to do "fossil sync --verily" to |
| 1675 | get two repositories in sync. |
| 1676 | * Add the [/finfo?name=src/foci.c|files_of_checkin] virtual table - useful |
| 1677 | for ad hoc queries in the [/help/sqlite3|fossil sql] interface, |
| 1678 | and also used internally. |
| 1679 | * Added the "$secureurl" TH1 variable for use in headers and footers. |
| 1680 | * (Internal:) Add the ability to include resources as separate files in the |
| 1681 | source tree that are converted into constant byte arrays in the compiled |
| 1682 | binary. Use this feature to store the Tk script that implements the --tk |
| @@ -1696,143 +1696,143 @@ | |
| 1696 | * The [/reports] page now requires Read ("o") permissions. The "byweek" |
| 1697 | report now properly propagates the selected year through the event type |
| 1698 | filter links. |
| 1699 | * The [/help/info | info command] now shows leaf status of the checkout. |
| 1700 | * Add support for tunneling https through a http proxy (Ticket [e854101c4f]). |
| 1701 | * Add option --empty to the "[/help/open | fossil open]" command. |
| 1702 | * Enhanced [/help/www/fileage|the fileage page] to support a glob parameter. |
| 1703 | * Add -w|--ignore-all-space and -Z|--ignore-trailing-space options to |
| 1704 | [/help/annotate|fossil annotate], [/help/blame|fossil blame], |
| 1705 | [/help/diff|fossil (g)diff], [/help/stash|fossil stash diff]. |
| 1706 | * Add --strip-trailing-cr option to [/help/diff|fossil (g)diff] and |
| 1707 | [/help/stash|fossil stash diff]. |
| 1708 | * Add button "Ignore Whitespace" to /annotate, /blame, /ci, /fdiff |
| 1709 | and /vdiff UI pages. |
| 1710 | * Enhance [/reports?view=byweekday|/reports] with a "byweekday" view. |
| 1711 | * Enhance the [/help/cat|fossil cat] command so that it works outside |
| 1712 | of a checkout when using the -R command-line option. |
| 1713 | * Use full-length SHA1 hashes, not abbreviations, in most hyperlinks. |
| 1714 | * Correctly render the <title> markup on wiki pages in the |
| 1715 | [/help/www/artifact|/artifact] webpage. |
| 1716 | * Enhance the [/help/whatis|fossil whatis] command to report on attachments |
| 1717 | and cluster artifacts. Added the [/help/test-whatis-all] command for |
| 1718 | testing purposes. |
| 1719 | * Add support for HTTP Basic Authentication on [/help/clone|clone] and |
| 1720 | [/help/sync|sync]. |
| 1721 | * Fix the [/help/stash|stash] so that it remembers added files and re-adds |
| 1722 | them when the stash is applied. |
| 1723 | * Fix the server so that it avoids writing to the database (and thus avoids |
| 1724 | database locking issues) on a |
| 1725 | [/help/pull|pull] or [/help/clone|clone]. |
| 1726 | * Add support for [./server.wiki#loadmgmt|server load management] using both |
| 1727 | a cache of expensive pages (the [/help/cache|fossil cache] command) |
| 1728 | and by rejecting expensive page requests when the server load average is too |
| 1729 | high. |
| 1730 | * Add the [/help/praise|fossil praise] command as an alias for |
| 1731 | [/help/blame|fossil blame] for subversion compatibility. |
| 1732 | * Enhance the [/help/test-diff|fossil test-diff] command with -y or --tk |
| 1733 | options so that it shows both filenames above their respective columns in |
| 1734 | the side-by-side diff output. |
| 1735 | * Issue a warning if a [/help/add|fossil add] command tries to add a file |
| 1736 | that matches the ignore-glob. |
| 1737 | * Add option -W|--width to "[/help/stash|fossil stash ls]" |
| 1738 | and "[/help/leaves|fossil leaves]" commands. |
| 1739 | * Enhance support for running as the root user. Now works on Haiku. |
| 1740 | * Added the <tt>-empty</tt> option to [/help/new|fossil new], which |
| 1741 | causes it to not create an initial empty commit. The first commit after |
| 1742 | checking out a repo created this way will become the initial commit. |
| 1743 | * Enhance sync operations by committing each round-trip to minimize number |
| 1744 | of retransmits when autosync fails. Include option for |
| 1745 | [/help/update| fossil update] and [/help/merge| fossil merge] to |
| 1746 | continue even if missing content. |
| 1747 | * Minor portability fixes for platforms where the char type is unsigned |
| 1748 | by default. |
| 1749 | |
| 1750 | <h2>Changes For Version 1.28 (2014-01-27)</h2> |
| 1751 | * Enhance [/help/www/reports | /reports] to support event type filtering. |
| 1752 | * When cloning a repository, the user name passed via the URL (if any) |
| 1753 | is now used as the default local admin user's name. |
| 1754 | * Enhance the SSH transport mechanism so that it runs a single instance of |
| 1755 | the "fossil" executable on the remote side, obviating the need for a shell |
| 1756 | on the remote side. Some users may need to add the "?fossil=/path/to/fossil" |
| 1757 | query parameter to "ssh:" URIs if their fossil binary is not in a standard |
| 1758 | place. |
| 1759 | * Add the "[/help/blame | fossil blame]" command that works just like |
| 1760 | "fossil annotate" but uses a different output format that includes the |
| 1761 | user who made each change and omits line numbers. |
| 1762 | * Add the "Tarball and ZIP-archive Prefix" configuration parameter under |
| 1763 | Admin/Configuration. |
| 1764 | * Fix CGI processing so that it works on web servers that do not |
| 1765 | supply REQUEST_URI. |
| 1766 | * Add options --dirsonly, --emptydirs, and --allckouts to the |
| 1767 | "[/help/clean | fossil clean]" command. |
| 1768 | * Ten-fold performance improvement in large "fossil blame" or |
| 1769 | "fossil annotate" commands. |
| 1770 | * Add option -W|--width and --offset to "[/help/timeline | fossil timeline]" |
| 1771 | and "[/help/finfo | fossil finfo]" commands. |
| 1772 | * Option -n|--limit of "[/help/timeline | fossil timeline]" now |
| 1773 | specifies the number of entries, just like all other commands which |
| 1774 | have the -n|--limit option. The various timeline-related functions |
| 1775 | now output "--- ?? limit (??) reached ---" at the end whenever |
| 1776 | appropriate. Use "-n 0" if no limit is desired. |
| 1777 | * Fix handling of password embedded in Fossil URL. |
| 1778 | * New <tt>--once</tt> option to [/help/clone | fossil clone] command |
| 1779 | which does not store the URL or password when cloning. |
| 1780 | * Modify [/help/ui | fossil ui] to respect "default user" in an open |
| 1781 | repository. |
| 1782 | * Fossil now hides check-ins that have the "hidden" tag in timeline webpages. |
| 1783 | * Enhance <tt>/ci_edit</tt> page to add the "hidden" tag to check-ins. |
| 1784 | * Advanced possibilities for commit and ticket change notifications over |
| 1785 | http using TH1 scripting. |
| 1786 | * Add --sha1sum and --integrate options |
| 1787 | to the "[/help/commit | fossil commit]" command. |
| 1788 | * Add the "clean" and "extra" subcommands to the |
| 1789 | "[/help/all | fossil all]" command |
| 1790 | * Add the --whatif option to "[/help/clean|fossil clean]" that works the |
| 1791 | same as "--dry-run", |
| 1792 | so that the name does not collide with the --dry-run option of "fossil all". |
| 1793 | * Provide a configuration option to show dates on the web timeline |
| 1794 | as "YYMMMDD HH:MM" |
| 1795 | * Add an option to the "stats" webpage that allows an administrator to see |
| 1796 | the current repository schema. |
| 1797 | * Enhancements to the "[/help/www/vdiff|/vdiff]" webpage for more difference |
| 1798 | display options. |
| 1799 | * Added the "[/tree?ci=trunk&expand | /tree]" webpage as an alternative |
| 1800 | to "/dir" and make it the default way of showing file lists. |
| 1801 | * Send gzipped HTTP responses to clients that support it. |
| 1802 | |
| 1803 | <h2>Changes For Version 1.27 (2013-09-11)</h2> |
| 1804 | * Enhance the [/help/changes | fossil changes], |
| 1805 | [/help/clean | fossil clean], [/help/extras | fossil extras], |
| 1806 | [/help/ls | fossil ls] and [/help/status | fossil status] commands |
| 1807 | to restrict operation to files and directories named on the command-line. |
| 1808 | * New --integrate option to [/help/merge | fossil merge], which |
| 1809 | automatically closes the merged branch when committing. |
| 1810 | * Renamed <tt>/stats_report</tt> page to [/reports]. Graph width is now |
| 1811 | relative, not absolute. |
| 1812 | * Added <tt>yw=YYYY-WW</tt> (year-week) filter to timeline to limit the results |
| 1813 | to a specific year and calendar week number, e.g. [/timeline?yw=2013-01]. |
| 1814 | * Updates to SQLite to prevent opening a repository file using file descriptors |
| 1815 | 1 or 2 on Unix. This fixes a bug under which an assertion failure could |
| 1816 | overwrite part of a repository database file, corrupting it. |
| 1817 | * Added support for unlimited line lengths in side-by-side diffs. |
| 1818 | * New --close option to [/help/commit | fossil commit], which |
| 1819 | immediately closes the branch being committed. |
| 1820 | * Added <tt>chart</tt> option to [/help/bisect | fossil bisect]. |
| 1821 | * Improvements to the "human or bot?" determination. |
| 1822 | * Reports errors about missing CGI-standard environment variables for HTTP |
| 1823 | servers which do not support them. |
| 1824 | * Minor improvements to sync support on Windows. |
| 1825 | * Added <tt>--scgi</tt> option to [/help/server | fossil server]. |
| 1826 | * Internal improvements to the sync process. |
| 1827 | * The internals of the JSON API are now MIT-licensed, so downstream |
| 1828 | users/packagers are no longer affected by the "do no evil" license |
| 1829 | clause. |
| 1830 | |
| 1831 | <h2>Changes For Version 1.26 (2013-06-18)</h2> |
| 1832 | * The argument to the --port option for the [/help/ui | fossil ui] and |
| 1833 | [/help/server | fossil server] commands can take an IP address in addition |
| 1834 | to the port number, causing Fossil to bind to just that one IP address. |
| 1835 | * After prompting for a password, also ask if that password should be |
| 1836 | remembered. |
| 1837 | * Performance improvements to the diff engine. |
| 1838 | * Fix the side-by-side diff engine to work better with multi-byte Unicode text. |
| @@ -1839,11 +1839,11 @@ | |
| 1839 | * Color-coding in the web-based annotation (blame) display. Fix the annotation |
| 1840 | engine so that it is no longer confused by time-warps. |
| 1841 | * The markdown formatter is now available by default and can be used for |
| 1842 | tickets, wiki, and embedded documentation. |
| 1843 | * Add subcommands "fossil bisect log" and "fossil bisect status" to the |
| 1844 | [/help/bisect | fossil bisect] command, as well as other bisect enhancements. |
| 1845 | * Enhanced defenses that prevent spiders from using excessive CPU and bandwidth. |
| 1846 | * Consistent use of the -n or --dry-run command line options. |
| 1847 | * Win32: Fossil now understands Cygwin paths containing one or more of |
| 1848 | the characters <nowiki>"*:<>?|</nowiki>. Those are normally forbidden in |
| 1849 | win32. This means that the win32 fossil.exe is better usable in a Cygwin |
| 1850 |
+8
-8
| --- www/chat.md | ||
| +++ www/chat.md | ||
| @@ -55,11 +55,11 @@ | ||
| 55 | 55 | from the repository database. |
| 56 | 56 | |
| 57 | 57 | ## <a id="usage"></a>Usage |
| 58 | 58 | |
| 59 | 59 | For users with appropriate permissions, simply browse to the |
| 60 | -[/chat](/help?cmd=/chat) to start up a chat session. The default | |
| 60 | +[/chat](/help/www/chat) to start up a chat session. The default | |
| 61 | 61 | skin includes a "Chat" entry on the menu bar on wide screens for |
| 62 | 62 | people with chat privilege. There is also a "Chat" option on |
| 63 | 63 | the [Sitemap page](/sitemap), which means that chat will appear |
| 64 | 64 | as an option under the hamburger menu for many [skins](./customskin.md). |
| 65 | 65 | |
| @@ -122,19 +122,19 @@ | ||
| 122 | 122 | specific user by tapping on that user's name, tapping a second time to |
| 123 | 123 | remove the filter. |
| 124 | 124 | |
| 125 | 125 | ### <a id="cli"></a> The `fossil chat` Command |
| 126 | 126 | |
| 127 | -Type [fossil chat](/help?cmd=chat) from within any open check-out | |
| 127 | +Type [fossil chat](/help/chat) from within any open check-out | |
| 128 | 128 | to bring up a chatroom for the project that is in that checkout. |
| 129 | 129 | The new chat window will attempt to connect to the default sync |
| 130 | 130 | target for that check-out (the server whose URL is shown by the |
| 131 | -[fossil remote](/help?cmd=remote) command). | |
| 131 | +[fossil remote](/help/remote) command). | |
| 132 | 132 | |
| 133 | 133 | ### <a id="robots"></a> Chat Messages From Robots |
| 134 | 134 | |
| 135 | -The [fossil chat send](/help?cmd=chat) can be used by project-specific | |
| 135 | +The [fossil chat send](/help/chat) can be used by project-specific | |
| 136 | 136 | robots to send notifications to the chatroom. For example, on the |
| 137 | 137 | [SQLite project](https://sqlite.org/) (for which the Fossil chatroom |
| 138 | 138 | feature, and indeed all of Fossil, was invented) there are long-running |
| 139 | 139 | fuzz servers that sometimes run across obscure problems. Whenever this |
| 140 | 140 | happens, a message is sent to the SQLite developers chatroom alerting |
| @@ -155,11 +155,11 @@ | ||
| 155 | 155 | Substitute the appropriate project URL, robot account |
| 156 | 156 | name and password, message text and file attachment, of course. |
| 157 | 157 | |
| 158 | 158 | ### <a id="chat-robot"></a> Chat Messages For Timeline Events |
| 159 | 159 | |
| 160 | -If the [chat-timeline-user setting](/help?cmd=chat-timeline-user) is not an | |
| 160 | +If the [chat-timeline-user setting](/help/chat-timeline-user) is not an | |
| 161 | 161 | empty string, then any change to the repository that would normally result |
| 162 | 162 | in a new timeline entry is announced in the chatroom. The announcement |
| 163 | 163 | appears to come from a user whose name is given by the chat-timeline-user |
| 164 | 164 | setting. |
| 165 | 165 | |
| @@ -189,11 +189,11 @@ | ||
| 189 | 189 | |
| 190 | 190 | *You do not need to understand how Fossil chat works in order to use it. |
| 191 | 191 | But many developers prefer to know how their tools work. |
| 192 | 192 | This section is provided for the benefit of those curious developers.* |
| 193 | 193 | |
| 194 | -The [/chat](/help?cmd=/chat) webpage downloads a small amount of HTML | |
| 194 | +The [/chat](/help/www/chat) webpage downloads a small amount of HTML | |
| 195 | 195 | and a small amount of javascript to run the chat session. The |
| 196 | 196 | javascript uses XMLHttpRequest (XHR) to download chat content, post |
| 197 | 197 | new content, or delete historical messages. The following web |
| 198 | 198 | interfaces are used by the XHR: |
| 199 | 199 | |
| @@ -246,17 +246,17 @@ | ||
| 246 | 246 | ~~~ |
| 247 | 247 | |
| 248 | 248 | The CHAT table is not cross-linked with any other tables in the repository |
| 249 | 249 | schema. An administrator can "DROP TABLE chat;" at any time, without |
| 250 | 250 | harm (apart from deleting all chat history, of course). The CHAT table |
| 251 | -is dropped when running [fossil scrub --verily](/help?cmd=scrub). | |
| 251 | +is dropped when running [fossil scrub --verily](/help/scrub). | |
| 252 | 252 | |
| 253 | 253 | On the server-side, message text is stored exactly as entered by the |
| 254 | 254 | users. The /chat-poll page queries the CHAT table and constructs a |
| 255 | 255 | JSON reply described in the [/chat-poll |
| 256 | -documentation](/help?cmd=/chat-poll). The message text is translated | |
| 256 | +documentation](/help/www/chat-poll). The message text is translated | |
| 257 | 257 | into HTML before being converted to JSON so that the text can be |
| 258 | 258 | safely added to the display using assignment to `innerHTML`. Though |
| 259 | 259 | `innerHTML` assignment is generally considered unsafe, it is only so |
| 260 | 260 | with untrusted content from untrusted sources. The chat content goes |
| 261 | 261 | through sanitization steps which eliminate any potential security |
| 262 | 262 | vulnerabilities of assigning that content to `innerHTML`. |
| 263 | 263 |
| --- www/chat.md | |
| +++ www/chat.md | |
| @@ -55,11 +55,11 @@ | |
| 55 | from the repository database. |
| 56 | |
| 57 | ## <a id="usage"></a>Usage |
| 58 | |
| 59 | For users with appropriate permissions, simply browse to the |
| 60 | [/chat](/help?cmd=/chat) to start up a chat session. The default |
| 61 | skin includes a "Chat" entry on the menu bar on wide screens for |
| 62 | people with chat privilege. There is also a "Chat" option on |
| 63 | the [Sitemap page](/sitemap), which means that chat will appear |
| 64 | as an option under the hamburger menu for many [skins](./customskin.md). |
| 65 | |
| @@ -122,19 +122,19 @@ | |
| 122 | specific user by tapping on that user's name, tapping a second time to |
| 123 | remove the filter. |
| 124 | |
| 125 | ### <a id="cli"></a> The `fossil chat` Command |
| 126 | |
| 127 | Type [fossil chat](/help?cmd=chat) from within any open check-out |
| 128 | to bring up a chatroom for the project that is in that checkout. |
| 129 | The new chat window will attempt to connect to the default sync |
| 130 | target for that check-out (the server whose URL is shown by the |
| 131 | [fossil remote](/help?cmd=remote) command). |
| 132 | |
| 133 | ### <a id="robots"></a> Chat Messages From Robots |
| 134 | |
| 135 | The [fossil chat send](/help?cmd=chat) can be used by project-specific |
| 136 | robots to send notifications to the chatroom. For example, on the |
| 137 | [SQLite project](https://sqlite.org/) (for which the Fossil chatroom |
| 138 | feature, and indeed all of Fossil, was invented) there are long-running |
| 139 | fuzz servers that sometimes run across obscure problems. Whenever this |
| 140 | happens, a message is sent to the SQLite developers chatroom alerting |
| @@ -155,11 +155,11 @@ | |
| 155 | Substitute the appropriate project URL, robot account |
| 156 | name and password, message text and file attachment, of course. |
| 157 | |
| 158 | ### <a id="chat-robot"></a> Chat Messages For Timeline Events |
| 159 | |
| 160 | If the [chat-timeline-user setting](/help?cmd=chat-timeline-user) is not an |
| 161 | empty string, then any change to the repository that would normally result |
| 162 | in a new timeline entry is announced in the chatroom. The announcement |
| 163 | appears to come from a user whose name is given by the chat-timeline-user |
| 164 | setting. |
| 165 | |
| @@ -189,11 +189,11 @@ | |
| 189 | |
| 190 | *You do not need to understand how Fossil chat works in order to use it. |
| 191 | But many developers prefer to know how their tools work. |
| 192 | This section is provided for the benefit of those curious developers.* |
| 193 | |
| 194 | The [/chat](/help?cmd=/chat) webpage downloads a small amount of HTML |
| 195 | and a small amount of javascript to run the chat session. The |
| 196 | javascript uses XMLHttpRequest (XHR) to download chat content, post |
| 197 | new content, or delete historical messages. The following web |
| 198 | interfaces are used by the XHR: |
| 199 | |
| @@ -246,17 +246,17 @@ | |
| 246 | ~~~ |
| 247 | |
| 248 | The CHAT table is not cross-linked with any other tables in the repository |
| 249 | schema. An administrator can "DROP TABLE chat;" at any time, without |
| 250 | harm (apart from deleting all chat history, of course). The CHAT table |
| 251 | is dropped when running [fossil scrub --verily](/help?cmd=scrub). |
| 252 | |
| 253 | On the server-side, message text is stored exactly as entered by the |
| 254 | users. The /chat-poll page queries the CHAT table and constructs a |
| 255 | JSON reply described in the [/chat-poll |
| 256 | documentation](/help?cmd=/chat-poll). The message text is translated |
| 257 | into HTML before being converted to JSON so that the text can be |
| 258 | safely added to the display using assignment to `innerHTML`. Though |
| 259 | `innerHTML` assignment is generally considered unsafe, it is only so |
| 260 | with untrusted content from untrusted sources. The chat content goes |
| 261 | through sanitization steps which eliminate any potential security |
| 262 | vulnerabilities of assigning that content to `innerHTML`. |
| 263 |
| --- www/chat.md | |
| +++ www/chat.md | |
| @@ -55,11 +55,11 @@ | |
| 55 | from the repository database. |
| 56 | |
| 57 | ## <a id="usage"></a>Usage |
| 58 | |
| 59 | For users with appropriate permissions, simply browse to the |
| 60 | [/chat](/help/www/chat) to start up a chat session. The default |
| 61 | skin includes a "Chat" entry on the menu bar on wide screens for |
| 62 | people with chat privilege. There is also a "Chat" option on |
| 63 | the [Sitemap page](/sitemap), which means that chat will appear |
| 64 | as an option under the hamburger menu for many [skins](./customskin.md). |
| 65 | |
| @@ -122,19 +122,19 @@ | |
| 122 | specific user by tapping on that user's name, tapping a second time to |
| 123 | remove the filter. |
| 124 | |
| 125 | ### <a id="cli"></a> The `fossil chat` Command |
| 126 | |
| 127 | Type [fossil chat](/help/chat) from within any open check-out |
| 128 | to bring up a chatroom for the project that is in that checkout. |
| 129 | The new chat window will attempt to connect to the default sync |
| 130 | target for that check-out (the server whose URL is shown by the |
| 131 | [fossil remote](/help/remote) command). |
| 132 | |
| 133 | ### <a id="robots"></a> Chat Messages From Robots |
| 134 | |
| 135 | The [fossil chat send](/help/chat) can be used by project-specific |
| 136 | robots to send notifications to the chatroom. For example, on the |
| 137 | [SQLite project](https://sqlite.org/) (for which the Fossil chatroom |
| 138 | feature, and indeed all of Fossil, was invented) there are long-running |
| 139 | fuzz servers that sometimes run across obscure problems. Whenever this |
| 140 | happens, a message is sent to the SQLite developers chatroom alerting |
| @@ -155,11 +155,11 @@ | |
| 155 | Substitute the appropriate project URL, robot account |
| 156 | name and password, message text and file attachment, of course. |
| 157 | |
| 158 | ### <a id="chat-robot"></a> Chat Messages For Timeline Events |
| 159 | |
| 160 | If the [chat-timeline-user setting](/help/chat-timeline-user) is not an |
| 161 | empty string, then any change to the repository that would normally result |
| 162 | in a new timeline entry is announced in the chatroom. The announcement |
| 163 | appears to come from a user whose name is given by the chat-timeline-user |
| 164 | setting. |
| 165 | |
| @@ -189,11 +189,11 @@ | |
| 189 | |
| 190 | *You do not need to understand how Fossil chat works in order to use it. |
| 191 | But many developers prefer to know how their tools work. |
| 192 | This section is provided for the benefit of those curious developers.* |
| 193 | |
| 194 | The [/chat](/help/www/chat) webpage downloads a small amount of HTML |
| 195 | and a small amount of javascript to run the chat session. The |
| 196 | javascript uses XMLHttpRequest (XHR) to download chat content, post |
| 197 | new content, or delete historical messages. The following web |
| 198 | interfaces are used by the XHR: |
| 199 | |
| @@ -246,17 +246,17 @@ | |
| 246 | ~~~ |
| 247 | |
| 248 | The CHAT table is not cross-linked with any other tables in the repository |
| 249 | schema. An administrator can "DROP TABLE chat;" at any time, without |
| 250 | harm (apart from deleting all chat history, of course). The CHAT table |
| 251 | is dropped when running [fossil scrub --verily](/help/scrub). |
| 252 | |
| 253 | On the server-side, message text is stored exactly as entered by the |
| 254 | users. The /chat-poll page queries the CHAT table and constructs a |
| 255 | JSON reply described in the [/chat-poll |
| 256 | documentation](/help/www/chat-poll). The message text is translated |
| 257 | into HTML before being converted to JSON so that the text can be |
| 258 | safely added to the display using assignment to `innerHTML`. Though |
| 259 | `innerHTML` assignment is generally considered unsafe, it is only so |
| 260 | with untrusted content from untrusted sources. The chat content goes |
| 261 | through sanitization steps which eliminate any potential security |
| 262 | vulnerabilities of assigning that content to `innerHTML`. |
| 263 |
+1
-1
| --- www/childprojects.wiki | ||
| +++ www/childprojects.wiki | ||
| @@ -47,11 +47,11 @@ | ||
| 47 | 47 | |
| 48 | 48 | The child project and the parent project will not normally be able to sync |
| 49 | 49 | with one another, since they are now separate projects with distinct |
| 50 | 50 | project codes. However, if the |
| 51 | 51 | "--from-parent-project" command-line option is provided to the |
| 52 | -"[/help?cmd=pull|fossil pull]" command in the child, and the URL of | |
| 52 | +"[/help/pull|fossil pull]" command in the child, and the URL of | |
| 53 | 53 | parent repository is also provided on the command-line, then updates to |
| 54 | 54 | the parent project that occurred after the child was created will be added |
| 55 | 55 | to the child repository. Thus, by periodically doing a |
| 56 | 56 | pull --from-parent-project, the child project is able to stay up to date |
| 57 | 57 | with all the latest changes in the parent. |
| 58 | 58 |
| --- www/childprojects.wiki | |
| +++ www/childprojects.wiki | |
| @@ -47,11 +47,11 @@ | |
| 47 | |
| 48 | The child project and the parent project will not normally be able to sync |
| 49 | with one another, since they are now separate projects with distinct |
| 50 | project codes. However, if the |
| 51 | "--from-parent-project" command-line option is provided to the |
| 52 | "[/help?cmd=pull|fossil pull]" command in the child, and the URL of |
| 53 | parent repository is also provided on the command-line, then updates to |
| 54 | the parent project that occurred after the child was created will be added |
| 55 | to the child repository. Thus, by periodically doing a |
| 56 | pull --from-parent-project, the child project is able to stay up to date |
| 57 | with all the latest changes in the parent. |
| 58 |
| --- www/childprojects.wiki | |
| +++ www/childprojects.wiki | |
| @@ -47,11 +47,11 @@ | |
| 47 | |
| 48 | The child project and the parent project will not normally be able to sync |
| 49 | with one another, since they are now separate projects with distinct |
| 50 | project codes. However, if the |
| 51 | "--from-parent-project" command-line option is provided to the |
| 52 | "[/help/pull|fossil pull]" command in the child, and the URL of |
| 53 | parent repository is also provided on the command-line, then updates to |
| 54 | the parent project that occurred after the child was created will be added |
| 55 | to the child repository. Thus, by periodically doing a |
| 56 | pull --from-parent-project, the child project is able to stay up to date |
| 57 | with all the latest changes in the parent. |
| 58 |
+1
-1
| --- www/chroot.md | ||
| +++ www/chroot.md | ||
| @@ -30,11 +30,11 @@ | ||
| 30 | 30 | [configured Fossil with `--static`][bld] to avoid it |
| 31 | 31 | |
| 32 | 32 | Fossil does all of this as one of many layers of defense against |
| 33 | 33 | hacks and exploits. You can prevent Fossil from entering the chroot |
| 34 | 34 | jail using the <tt>--nojail</tt> option to the |
| 35 | -[fossil server command](/help?cmd=server) | |
| 35 | +[fossil server command](/help/server) | |
| 36 | 36 | but you cannot make Fossil hold onto root privileges. Fossil always drops |
| 37 | 37 | root privilege before accepting inputs, for security. |
| 38 | 38 | |
| 39 | 39 | |
| 40 | 40 | [bld]: https://fossil-scm.org/home/doc/trunk/www/build.wiki |
| 41 | 41 |
| --- www/chroot.md | |
| +++ www/chroot.md | |
| @@ -30,11 +30,11 @@ | |
| 30 | [configured Fossil with `--static`][bld] to avoid it |
| 31 | |
| 32 | Fossil does all of this as one of many layers of defense against |
| 33 | hacks and exploits. You can prevent Fossil from entering the chroot |
| 34 | jail using the <tt>--nojail</tt> option to the |
| 35 | [fossil server command](/help?cmd=server) |
| 36 | but you cannot make Fossil hold onto root privileges. Fossil always drops |
| 37 | root privilege before accepting inputs, for security. |
| 38 | |
| 39 | |
| 40 | [bld]: https://fossil-scm.org/home/doc/trunk/www/build.wiki |
| 41 |
| --- www/chroot.md | |
| +++ www/chroot.md | |
| @@ -30,11 +30,11 @@ | |
| 30 | [configured Fossil with `--static`][bld] to avoid it |
| 31 | |
| 32 | Fossil does all of this as one of many layers of defense against |
| 33 | hacks and exploits. You can prevent Fossil from entering the chroot |
| 34 | jail using the <tt>--nojail</tt> option to the |
| 35 | [fossil server command](/help/server) |
| 36 | but you cannot make Fossil hold onto root privileges. Fossil always drops |
| 37 | root privilege before accepting inputs, for security. |
| 38 | |
| 39 | |
| 40 | [bld]: https://fossil-scm.org/home/doc/trunk/www/build.wiki |
| 41 |
+1
-1
| --- www/ckout-workflows.md | ||
| +++ www/ckout-workflows.md | ||
| @@ -135,8 +135,8 @@ | ||
| 135 | 135 | |
| 136 | 136 | The `/repo` addition is the key: whatever comes after is used as the |
| 137 | 137 | repository name. [See the docs][clone] for more details. |
| 138 | 138 | |
| 139 | 139 | [caod]: https://fossil-scm.org/forum/forumpost/3f143cec74 |
| 140 | -[clone]: /help?cmd=clone | |
| 140 | +[clone]: /help/clone | |
| 141 | 141 | |
| 142 | 142 | <div style="height:50em" id="this-space-intentionally-left-blank"></div> |
| 143 | 143 |
| --- www/ckout-workflows.md | |
| +++ www/ckout-workflows.md | |
| @@ -135,8 +135,8 @@ | |
| 135 | |
| 136 | The `/repo` addition is the key: whatever comes after is used as the |
| 137 | repository name. [See the docs][clone] for more details. |
| 138 | |
| 139 | [caod]: https://fossil-scm.org/forum/forumpost/3f143cec74 |
| 140 | [clone]: /help?cmd=clone |
| 141 | |
| 142 | <div style="height:50em" id="this-space-intentionally-left-blank"></div> |
| 143 |
| --- www/ckout-workflows.md | |
| +++ www/ckout-workflows.md | |
| @@ -135,8 +135,8 @@ | |
| 135 | |
| 136 | The `/repo` addition is the key: whatever comes after is used as the |
| 137 | repository name. [See the docs][clone] for more details. |
| 138 | |
| 139 | [caod]: https://fossil-scm.org/forum/forumpost/3f143cec74 |
| 140 | [clone]: /help/clone |
| 141 | |
| 142 | <div style="height:50em" id="this-space-intentionally-left-blank"></div> |
| 143 |
+2
-2
| --- www/co-vs-up.md | ||
| +++ www/co-vs-up.md | ||
| @@ -24,8 +24,8 @@ | ||
| 24 | 24 | |
| 25 | 25 | In summary, these are two separate commands; neither is an alias for the |
| 26 | 26 | other. They overlap enough that they can be used interchangeably for |
| 27 | 27 | some use cases, but `update` is more powerful and more broadly useful. |
| 28 | 28 | |
| 29 | -[co]: /help?cmd=checkout | |
| 29 | +[co]: /help/checkout | |
| 30 | 30 | [cvsmu]: http://web.mit.edu/gnu/doc/html/cvs_7.html#SEC37 |
| 31 | -[up]: /help?cmd=update | |
| 31 | +[up]: /help/update | |
| 32 | 32 |
| --- www/co-vs-up.md | |
| +++ www/co-vs-up.md | |
| @@ -24,8 +24,8 @@ | |
| 24 | |
| 25 | In summary, these are two separate commands; neither is an alias for the |
| 26 | other. They overlap enough that they can be used interchangeably for |
| 27 | some use cases, but `update` is more powerful and more broadly useful. |
| 28 | |
| 29 | [co]: /help?cmd=checkout |
| 30 | [cvsmu]: http://web.mit.edu/gnu/doc/html/cvs_7.html#SEC37 |
| 31 | [up]: /help?cmd=update |
| 32 |
| --- www/co-vs-up.md | |
| +++ www/co-vs-up.md | |
| @@ -24,8 +24,8 @@ | |
| 24 | |
| 25 | In summary, these are two separate commands; neither is an alias for the |
| 26 | other. They overlap enough that they can be used interchangeably for |
| 27 | some use cases, but `update` is more powerful and more broadly useful. |
| 28 | |
| 29 | [co]: /help/checkout |
| 30 | [cvsmu]: http://web.mit.edu/gnu/doc/html/cvs_7.html#SEC37 |
| 31 | [up]: /help/update |
| 32 |
+4
-4
| --- www/concepts.wiki | ||
| +++ www/concepts.wiki | ||
| @@ -435,24 +435,24 @@ | ||
| 435 | 435 | a lot of work and normally takes time, patience, and a lot of system |
| 436 | 436 | knowledge. Fossil is designed to avoid this frustration. Setting up |
| 437 | 437 | a server with Fossil is ridiculously easy. You have four options: |
| 438 | 438 | |
| 439 | 439 | # <b>Stand-alone server.</b> |
| 440 | - Simply run the [/help?cmd=server|fossil server] or | |
| 441 | - [/help?cmd=ui|fossil ui] command from the command-line. | |
| 440 | + Simply run the [/help/server|fossil server] or | |
| 441 | + [/help/ui|fossil ui] command from the command-line. | |
| 442 | 442 | <br><br> |
| 443 | 443 | # <b>CGI.</b> |
| 444 | 444 | Install a 2-line CGI script on a CGI-enabled web-server like Apache. |
| 445 | 445 | <br><br> |
| 446 | 446 | # <b>SCGI.</b> |
| 447 | 447 | Start an SCGI server using the |
| 448 | - [/help?cmd=server| fossil server --scgi] command for handling | |
| 448 | + [/help/server| fossil server --scgi] command for handling | |
| 449 | 449 | SCGI requests from web-servers like Nginx. |
| 450 | 450 | <br><br> |
| 451 | 451 | # <b>Inetd or Stunnel.</b> |
| 452 | 452 | Configure programs like inetd, xinetd, or stunnel to hand off HTTP requests |
| 453 | - directly to the [/help?cmd=http|fossil http] command. | |
| 453 | + directly to the [/help/http|fossil http] command. | |
| 454 | 454 | |
| 455 | 455 | See the [./server/ | How To Configure A Fossil Server] document |
| 456 | 456 | for details. |
| 457 | 457 | |
| 458 | 458 | <h2>6.0 Review Of Key Concepts</h2> |
| 459 | 459 |
| --- www/concepts.wiki | |
| +++ www/concepts.wiki | |
| @@ -435,24 +435,24 @@ | |
| 435 | a lot of work and normally takes time, patience, and a lot of system |
| 436 | knowledge. Fossil is designed to avoid this frustration. Setting up |
| 437 | a server with Fossil is ridiculously easy. You have four options: |
| 438 | |
| 439 | # <b>Stand-alone server.</b> |
| 440 | Simply run the [/help?cmd=server|fossil server] or |
| 441 | [/help?cmd=ui|fossil ui] command from the command-line. |
| 442 | <br><br> |
| 443 | # <b>CGI.</b> |
| 444 | Install a 2-line CGI script on a CGI-enabled web-server like Apache. |
| 445 | <br><br> |
| 446 | # <b>SCGI.</b> |
| 447 | Start an SCGI server using the |
| 448 | [/help?cmd=server| fossil server --scgi] command for handling |
| 449 | SCGI requests from web-servers like Nginx. |
| 450 | <br><br> |
| 451 | # <b>Inetd or Stunnel.</b> |
| 452 | Configure programs like inetd, xinetd, or stunnel to hand off HTTP requests |
| 453 | directly to the [/help?cmd=http|fossil http] command. |
| 454 | |
| 455 | See the [./server/ | How To Configure A Fossil Server] document |
| 456 | for details. |
| 457 | |
| 458 | <h2>6.0 Review Of Key Concepts</h2> |
| 459 |
| --- www/concepts.wiki | |
| +++ www/concepts.wiki | |
| @@ -435,24 +435,24 @@ | |
| 435 | a lot of work and normally takes time, patience, and a lot of system |
| 436 | knowledge. Fossil is designed to avoid this frustration. Setting up |
| 437 | a server with Fossil is ridiculously easy. You have four options: |
| 438 | |
| 439 | # <b>Stand-alone server.</b> |
| 440 | Simply run the [/help/server|fossil server] or |
| 441 | [/help/ui|fossil ui] command from the command-line. |
| 442 | <br><br> |
| 443 | # <b>CGI.</b> |
| 444 | Install a 2-line CGI script on a CGI-enabled web-server like Apache. |
| 445 | <br><br> |
| 446 | # <b>SCGI.</b> |
| 447 | Start an SCGI server using the |
| 448 | [/help/server| fossil server --scgi] command for handling |
| 449 | SCGI requests from web-servers like Nginx. |
| 450 | <br><br> |
| 451 | # <b>Inetd or Stunnel.</b> |
| 452 | Configure programs like inetd, xinetd, or stunnel to hand off HTTP requests |
| 453 | directly to the [/help/http|fossil http] command. |
| 454 | |
| 455 | See the [./server/ | How To Configure A Fossil Server] document |
| 456 | for details. |
| 457 | |
| 458 | <h2>6.0 Review Of Key Concepts</h2> |
| 459 |
+1
-1
| --- www/contribute.wiki | ||
| +++ www/contribute.wiki | ||
| @@ -40,11 +40,11 @@ | ||
| 40 | 40 | describe in detail what the patch does and which version of Fossil |
| 41 | 41 | it is written against. It's best to make patches against tip-of-trunk |
| 42 | 42 | rather than against past releases. |
| 43 | 43 | |
| 44 | 44 | If your change is more complicated than a patch can properly encode, you |
| 45 | -may submit [/help?cmd=bundle | a Fossil bundle] instead. Unlike patches, | |
| 45 | +may submit [/help/bundle | a Fossil bundle] instead. Unlike patches, | |
| 46 | 46 | bundles can contain multiple commits, check-in comments, file renames, |
| 47 | 47 | file deletions, branching decisions, and more which <tt>patch(1)</tt> |
| 48 | 48 | files cannot. It's best to make a bundle of a new branch so the change |
| 49 | 49 | can be integrated, tested, enhanced, and merged down to trunk in a |
| 50 | 50 | controlled fashion. |
| 51 | 51 |
| --- www/contribute.wiki | |
| +++ www/contribute.wiki | |
| @@ -40,11 +40,11 @@ | |
| 40 | describe in detail what the patch does and which version of Fossil |
| 41 | it is written against. It's best to make patches against tip-of-trunk |
| 42 | rather than against past releases. |
| 43 | |
| 44 | If your change is more complicated than a patch can properly encode, you |
| 45 | may submit [/help?cmd=bundle | a Fossil bundle] instead. Unlike patches, |
| 46 | bundles can contain multiple commits, check-in comments, file renames, |
| 47 | file deletions, branching decisions, and more which <tt>patch(1)</tt> |
| 48 | files cannot. It's best to make a bundle of a new branch so the change |
| 49 | can be integrated, tested, enhanced, and merged down to trunk in a |
| 50 | controlled fashion. |
| 51 |
| --- www/contribute.wiki | |
| +++ www/contribute.wiki | |
| @@ -40,11 +40,11 @@ | |
| 40 | describe in detail what the patch does and which version of Fossil |
| 41 | it is written against. It's best to make patches against tip-of-trunk |
| 42 | rather than against past releases. |
| 43 | |
| 44 | If your change is more complicated than a patch can properly encode, you |
| 45 | may submit [/help/bundle | a Fossil bundle] instead. Unlike patches, |
| 46 | bundles can contain multiple commits, check-in comments, file renames, |
| 47 | file deletions, branching decisions, and more which <tt>patch(1)</tt> |
| 48 | files cannot. It's best to make a bundle of a new branch so the change |
| 49 | can be integrated, tested, enhanced, and merged down to trunk in a |
| 50 | controlled fashion. |
| 51 |
+4
-4
| --- www/customskin.md | ||
| +++ www/customskin.md | ||
| @@ -23,18 +23,18 @@ | ||
| 23 | 23 | * footer.txt |
| 24 | 24 | * header.txt |
| 25 | 25 | * js.txt |
| 26 | 26 | |
| 27 | 27 | Try out the built-in skins by using the --skin option on the |
| 28 | -[fossil ui](/help?cmd=ui) or [fossil server](/help?cmd=server) commands. | |
| 28 | +[fossil ui](/help/ui) or [fossil server](/help/server) commands. | |
| 29 | 29 | |
| 30 | 30 | ## <a id="sharing"></a>Sharing Skins |
| 31 | 31 | |
| 32 | 32 | The skin of a repository is not part of the versioned state and does not |
| 33 | 33 | "push" or "pull" like checked-in files. The skin is local to the |
| 34 | 34 | repository. However, skins can be shared between repositories using |
| 35 | -the [fossil config](/help?cmd=configuration) command. | |
| 35 | +the [fossil config](/help/configuration) command. | |
| 36 | 36 | The "fossil config push skin" command will send the local skin to a remote |
| 37 | 37 | repository and the "fossil config pull skin" command will import a skin |
| 38 | 38 | from a remote repository. The "fossil config export skin FILENAME" |
| 39 | 39 | will export the skin for a repository into a file FILENAME. This file |
| 40 | 40 | can then be imported into a different repository using the |
| @@ -304,11 +304,11 @@ | ||
| 304 | 304 | |
| 305 | 305 | ### Skin Development Using A Local Text Editor |
| 306 | 306 | |
| 307 | 307 | An alternative approach is to copy the five control files for your |
| 308 | 308 | baseline skin into a temporary working directory (here called |
| 309 | -"./newskin") and then launch the [fossil ui](/help?cmd=ui) command | |
| 309 | +"./newskin") and then launch the [fossil ui](/help/ui) command | |
| 310 | 310 | with the "--skin ./newskin" option. If the argument to the --skin |
| 311 | 311 | option contains a "/" character, then the five control files are |
| 312 | 312 | read out of the directory named. You can then edit the control |
| 313 | 313 | files in the ./newskin folder using you favorite text editor, and |
| 314 | 314 | press "Reload" on your browser to see the effects. |
| @@ -515,11 +515,11 @@ | ||
| 515 | 515 | CSS, footer, and header editing screens under the Admin menu will |
| 516 | 516 | work just as well. The important point is that the three files |
| 517 | 517 | be named exactly "css.txt", "footer.txt", and "header.txt" and that |
| 518 | 518 | they all be in the same directory. |
| 519 | 519 | |
| 520 | - 2. Run the [fossil ui](/help?cmd=ui) command with an extra | |
| 520 | + 2. Run the [fossil ui](/help/ui) command with an extra | |
| 521 | 521 | option "--skin SKINDIR" where SKINDIR is the name of the directory |
| 522 | 522 | in which the three txt files were stored in step 1. This will bring |
| 523 | 523 | up the Fossil website using the tree files in SKINDIR. |
| 524 | 524 | |
| 525 | 525 | 3. Edit the *.txt files in SKINDIR. After making each small change, |
| 526 | 526 |
| --- www/customskin.md | |
| +++ www/customskin.md | |
| @@ -23,18 +23,18 @@ | |
| 23 | * footer.txt |
| 24 | * header.txt |
| 25 | * js.txt |
| 26 | |
| 27 | Try out the built-in skins by using the --skin option on the |
| 28 | [fossil ui](/help?cmd=ui) or [fossil server](/help?cmd=server) commands. |
| 29 | |
| 30 | ## <a id="sharing"></a>Sharing Skins |
| 31 | |
| 32 | The skin of a repository is not part of the versioned state and does not |
| 33 | "push" or "pull" like checked-in files. The skin is local to the |
| 34 | repository. However, skins can be shared between repositories using |
| 35 | the [fossil config](/help?cmd=configuration) command. |
| 36 | The "fossil config push skin" command will send the local skin to a remote |
| 37 | repository and the "fossil config pull skin" command will import a skin |
| 38 | from a remote repository. The "fossil config export skin FILENAME" |
| 39 | will export the skin for a repository into a file FILENAME. This file |
| 40 | can then be imported into a different repository using the |
| @@ -304,11 +304,11 @@ | |
| 304 | |
| 305 | ### Skin Development Using A Local Text Editor |
| 306 | |
| 307 | An alternative approach is to copy the five control files for your |
| 308 | baseline skin into a temporary working directory (here called |
| 309 | "./newskin") and then launch the [fossil ui](/help?cmd=ui) command |
| 310 | with the "--skin ./newskin" option. If the argument to the --skin |
| 311 | option contains a "/" character, then the five control files are |
| 312 | read out of the directory named. You can then edit the control |
| 313 | files in the ./newskin folder using you favorite text editor, and |
| 314 | press "Reload" on your browser to see the effects. |
| @@ -515,11 +515,11 @@ | |
| 515 | CSS, footer, and header editing screens under the Admin menu will |
| 516 | work just as well. The important point is that the three files |
| 517 | be named exactly "css.txt", "footer.txt", and "header.txt" and that |
| 518 | they all be in the same directory. |
| 519 | |
| 520 | 2. Run the [fossil ui](/help?cmd=ui) command with an extra |
| 521 | option "--skin SKINDIR" where SKINDIR is the name of the directory |
| 522 | in which the three txt files were stored in step 1. This will bring |
| 523 | up the Fossil website using the tree files in SKINDIR. |
| 524 | |
| 525 | 3. Edit the *.txt files in SKINDIR. After making each small change, |
| 526 |
| --- www/customskin.md | |
| +++ www/customskin.md | |
| @@ -23,18 +23,18 @@ | |
| 23 | * footer.txt |
| 24 | * header.txt |
| 25 | * js.txt |
| 26 | |
| 27 | Try out the built-in skins by using the --skin option on the |
| 28 | [fossil ui](/help/ui) or [fossil server](/help/server) commands. |
| 29 | |
| 30 | ## <a id="sharing"></a>Sharing Skins |
| 31 | |
| 32 | The skin of a repository is not part of the versioned state and does not |
| 33 | "push" or "pull" like checked-in files. The skin is local to the |
| 34 | repository. However, skins can be shared between repositories using |
| 35 | the [fossil config](/help/configuration) command. |
| 36 | The "fossil config push skin" command will send the local skin to a remote |
| 37 | repository and the "fossil config pull skin" command will import a skin |
| 38 | from a remote repository. The "fossil config export skin FILENAME" |
| 39 | will export the skin for a repository into a file FILENAME. This file |
| 40 | can then be imported into a different repository using the |
| @@ -304,11 +304,11 @@ | |
| 304 | |
| 305 | ### Skin Development Using A Local Text Editor |
| 306 | |
| 307 | An alternative approach is to copy the five control files for your |
| 308 | baseline skin into a temporary working directory (here called |
| 309 | "./newskin") and then launch the [fossil ui](/help/ui) command |
| 310 | with the "--skin ./newskin" option. If the argument to the --skin |
| 311 | option contains a "/" character, then the five control files are |
| 312 | read out of the directory named. You can then edit the control |
| 313 | files in the ./newskin folder using you favorite text editor, and |
| 314 | press "Reload" on your browser to see the effects. |
| @@ -515,11 +515,11 @@ | |
| 515 | CSS, footer, and header editing screens under the Admin menu will |
| 516 | work just as well. The important point is that the three files |
| 517 | be named exactly "css.txt", "footer.txt", and "header.txt" and that |
| 518 | they all be in the same directory. |
| 519 | |
| 520 | 2. Run the [fossil ui](/help/ui) command with an extra |
| 521 | option "--skin SKINDIR" where SKINDIR is the name of the directory |
| 522 | in which the three txt files were stored in step 1. This will bring |
| 523 | up the Fossil website using the tree files in SKINDIR. |
| 524 | |
| 525 | 3. Edit the *.txt files in SKINDIR. After making each small change, |
| 526 |
+6
-6
| --- www/defcsp.md | ||
| +++ www/defcsp.md | ||
| @@ -31,11 +31,11 @@ | ||
| 31 | 31 | img-src * data:; |
| 32 | 32 | </pre> |
| 33 | 33 | |
| 34 | 34 | The default is recommended for most installations. However, |
| 35 | 35 | the site administrators can overwrite this default CSP using the |
| 36 | -[default-csp setting](/help?cmd=default-csp). For example, | |
| 36 | +[default-csp setting](/help/default-csp). For example, | |
| 37 | 37 | CSP restrictions can be completely disabled by setting the default-csp to: |
| 38 | 38 | |
| 39 | 39 | default-src *; |
| 40 | 40 | |
| 41 | 41 | The following sections detail the maining of the default CSP setting. |
| @@ -286,25 +286,25 @@ | ||
| 286 | 286 | |
| 287 | 287 | Unversioned content is in the middle of the first list above — between |
| 288 | 288 | fully-external content and fully in-repo content — because it isn’t |
| 289 | 289 | included in a clone unless you give the `--unversioned` flag. If you |
| 290 | 290 | then want updates to the unversioned content to be included in syncs, |
| 291 | -you have to give the same flag to [a `sync` command](/help?cmd=sync). | |
| 291 | +you have to give the same flag to [a `sync` command](/help/sync). | |
| 292 | 292 | There is no equivalent with other commands such as `up` and `pull`, so |
| 293 | 293 | you must then remember to give `fossil uv` commands when necessary to |
| 294 | 294 | pull new unversioned content down. |
| 295 | 295 | |
| 296 | 296 | Thus our recommendation that you refer to in-repo resources exclusively. |
| 297 | 297 | |
| 298 | -[du]: /help?cmd=/doc | |
| 298 | +[du]: /help/www/doc | |
| 299 | 299 | [fp]: ./forum.wiki |
| 300 | -[ru]: /help?cmd=/raw | |
| 300 | +[ru]: /help/www/raw | |
| 301 | 301 | [spof]: https://en.wikipedia.org/wiki/Single_point_of_failure |
| 302 | 302 | [tkt]: ./tickets.wiki |
| 303 | 303 | [tn]: ./event.wiki |
| 304 | 304 | [tls]: ./server/debian/nginx.md |
| 305 | -[uu]: /help?cmd=/uv | |
| 305 | +[uu]: /help/www/uv | |
| 306 | 306 | [uv]: ./unvers.wiki |
| 307 | 307 | [wiki]: ./wikitheory.wiki |
| 308 | 308 | |
| 309 | 309 | |
| 310 | 310 | ## <a id="override"></a>Overriding the Default CSP |
| @@ -318,11 +318,11 @@ | ||
| 318 | 318 | a higher-level method. |
| 319 | 319 | |
| 320 | 320 | |
| 321 | 321 | ### <a id="cspsetting"></a>The `default-csp` Setting |
| 322 | 322 | |
| 323 | -If the [`default-csp` setting](/help?cmd=default-csp) is defined and is | |
| 323 | +If the [`default-csp` setting](/help/default-csp) is defined and is | |
| 324 | 324 | not an empty string, its value is injected into the page using |
| 325 | 325 | [TH1](./th1.md) via one or more of the methods below, depending on the |
| 326 | 326 | skin you’re using and local configuration. |
| 327 | 327 | |
| 328 | 328 | Changing this setting is the easiest way to set a nonstandard CSP on |
| 329 | 329 |
| --- www/defcsp.md | |
| +++ www/defcsp.md | |
| @@ -31,11 +31,11 @@ | |
| 31 | img-src * data:; |
| 32 | </pre> |
| 33 | |
| 34 | The default is recommended for most installations. However, |
| 35 | the site administrators can overwrite this default CSP using the |
| 36 | [default-csp setting](/help?cmd=default-csp). For example, |
| 37 | CSP restrictions can be completely disabled by setting the default-csp to: |
| 38 | |
| 39 | default-src *; |
| 40 | |
| 41 | The following sections detail the maining of the default CSP setting. |
| @@ -286,25 +286,25 @@ | |
| 286 | |
| 287 | Unversioned content is in the middle of the first list above — between |
| 288 | fully-external content and fully in-repo content — because it isn’t |
| 289 | included in a clone unless you give the `--unversioned` flag. If you |
| 290 | then want updates to the unversioned content to be included in syncs, |
| 291 | you have to give the same flag to [a `sync` command](/help?cmd=sync). |
| 292 | There is no equivalent with other commands such as `up` and `pull`, so |
| 293 | you must then remember to give `fossil uv` commands when necessary to |
| 294 | pull new unversioned content down. |
| 295 | |
| 296 | Thus our recommendation that you refer to in-repo resources exclusively. |
| 297 | |
| 298 | [du]: /help?cmd=/doc |
| 299 | [fp]: ./forum.wiki |
| 300 | [ru]: /help?cmd=/raw |
| 301 | [spof]: https://en.wikipedia.org/wiki/Single_point_of_failure |
| 302 | [tkt]: ./tickets.wiki |
| 303 | [tn]: ./event.wiki |
| 304 | [tls]: ./server/debian/nginx.md |
| 305 | [uu]: /help?cmd=/uv |
| 306 | [uv]: ./unvers.wiki |
| 307 | [wiki]: ./wikitheory.wiki |
| 308 | |
| 309 | |
| 310 | ## <a id="override"></a>Overriding the Default CSP |
| @@ -318,11 +318,11 @@ | |
| 318 | a higher-level method. |
| 319 | |
| 320 | |
| 321 | ### <a id="cspsetting"></a>The `default-csp` Setting |
| 322 | |
| 323 | If the [`default-csp` setting](/help?cmd=default-csp) is defined and is |
| 324 | not an empty string, its value is injected into the page using |
| 325 | [TH1](./th1.md) via one or more of the methods below, depending on the |
| 326 | skin you’re using and local configuration. |
| 327 | |
| 328 | Changing this setting is the easiest way to set a nonstandard CSP on |
| 329 |
| --- www/defcsp.md | |
| +++ www/defcsp.md | |
| @@ -31,11 +31,11 @@ | |
| 31 | img-src * data:; |
| 32 | </pre> |
| 33 | |
| 34 | The default is recommended for most installations. However, |
| 35 | the site administrators can overwrite this default CSP using the |
| 36 | [default-csp setting](/help/default-csp). For example, |
| 37 | CSP restrictions can be completely disabled by setting the default-csp to: |
| 38 | |
| 39 | default-src *; |
| 40 | |
| 41 | The following sections detail the maining of the default CSP setting. |
| @@ -286,25 +286,25 @@ | |
| 286 | |
| 287 | Unversioned content is in the middle of the first list above — between |
| 288 | fully-external content and fully in-repo content — because it isn’t |
| 289 | included in a clone unless you give the `--unversioned` flag. If you |
| 290 | then want updates to the unversioned content to be included in syncs, |
| 291 | you have to give the same flag to [a `sync` command](/help/sync). |
| 292 | There is no equivalent with other commands such as `up` and `pull`, so |
| 293 | you must then remember to give `fossil uv` commands when necessary to |
| 294 | pull new unversioned content down. |
| 295 | |
| 296 | Thus our recommendation that you refer to in-repo resources exclusively. |
| 297 | |
| 298 | [du]: /help/www/doc |
| 299 | [fp]: ./forum.wiki |
| 300 | [ru]: /help/www/raw |
| 301 | [spof]: https://en.wikipedia.org/wiki/Single_point_of_failure |
| 302 | [tkt]: ./tickets.wiki |
| 303 | [tn]: ./event.wiki |
| 304 | [tls]: ./server/debian/nginx.md |
| 305 | [uu]: /help/www/uv |
| 306 | [uv]: ./unvers.wiki |
| 307 | [wiki]: ./wikitheory.wiki |
| 308 | |
| 309 | |
| 310 | ## <a id="override"></a>Overriding the Default CSP |
| @@ -318,11 +318,11 @@ | |
| 318 | a higher-level method. |
| 319 | |
| 320 | |
| 321 | ### <a id="cspsetting"></a>The `default-csp` Setting |
| 322 | |
| 323 | If the [`default-csp` setting](/help/default-csp) is defined and is |
| 324 | not an empty string, its value is injected into the page using |
| 325 | [TH1](./th1.md) via one or more of the methods below, depending on the |
| 326 | skin you’re using and local configuration. |
| 327 | |
| 328 | Changing this setting is the easiest way to set a nonstandard CSP on |
| 329 |
+5
-5
| --- www/delta_format.wiki | ||
| +++ www/delta_format.wiki | ||
| @@ -26,24 +26,24 @@ | ||
| 26 | 26 | [../src/deltafunc.c|deltafunc.c] source file. |
| 27 | 27 | |
| 28 | 28 | The following command-line tools are available to create and apply |
| 29 | 29 | deltas and to test the delta logic: |
| 30 | 30 | |
| 31 | - * [/help?cmd=test-delta|fossil test-delta] → Run self-tests of | |
| 31 | + * [/help/test-delta|fossil test-delta] → Run self-tests of | |
| 32 | 32 | the delta logic |
| 33 | 33 | |
| 34 | - * [/help?cmd=test-delta-create|fossil test-delta-create X Y] → compute | |
| 34 | + * [/help/test-delta-create|fossil test-delta-create X Y] → compute | |
| 35 | 35 | a delta that converts file X into file Y. Output that delta. |
| 36 | 36 | |
| 37 | - * [/help?cmd=test-delta-apply|fossil test-delta-apply X D] → apply | |
| 37 | + * [/help/test-delta-apply|fossil test-delta-apply X D] → apply | |
| 38 | 38 | delta D to input file X and output the result. |
| 39 | 39 | |
| 40 | - * [/help?cmd=test-delta-analyze|fossil test-delta-analyze X Y] → compute | |
| 40 | + * [/help/test-delta-analyze|fossil test-delta-analyze X Y] → compute | |
| 41 | 41 | and delta that converts file X into file Y but instead of writing the |
| 42 | 42 | delta to output, write performance information about the delta. |
| 43 | 43 | |
| 44 | -When running the [/help?cmd=sqlite3|fossil sql] command to get an | |
| 44 | +When running the [/help/sqlite3|fossil sql] command to get an | |
| 45 | 45 | interactive SQL session connected to the repository, the following |
| 46 | 46 | additional SQL functions are provided: |
| 47 | 47 | |
| 48 | 48 | * <b>delta_create(</b><i>X</i><b>,</b><i>Y</i><b>)</b> → |
| 49 | 49 | Compute a data that carries blob X into blob Y and return that delta |
| 50 | 50 |
| --- www/delta_format.wiki | |
| +++ www/delta_format.wiki | |
| @@ -26,24 +26,24 @@ | |
| 26 | [../src/deltafunc.c|deltafunc.c] source file. |
| 27 | |
| 28 | The following command-line tools are available to create and apply |
| 29 | deltas and to test the delta logic: |
| 30 | |
| 31 | * [/help?cmd=test-delta|fossil test-delta] → Run self-tests of |
| 32 | the delta logic |
| 33 | |
| 34 | * [/help?cmd=test-delta-create|fossil test-delta-create X Y] → compute |
| 35 | a delta that converts file X into file Y. Output that delta. |
| 36 | |
| 37 | * [/help?cmd=test-delta-apply|fossil test-delta-apply X D] → apply |
| 38 | delta D to input file X and output the result. |
| 39 | |
| 40 | * [/help?cmd=test-delta-analyze|fossil test-delta-analyze X Y] → compute |
| 41 | and delta that converts file X into file Y but instead of writing the |
| 42 | delta to output, write performance information about the delta. |
| 43 | |
| 44 | When running the [/help?cmd=sqlite3|fossil sql] command to get an |
| 45 | interactive SQL session connected to the repository, the following |
| 46 | additional SQL functions are provided: |
| 47 | |
| 48 | * <b>delta_create(</b><i>X</i><b>,</b><i>Y</i><b>)</b> → |
| 49 | Compute a data that carries blob X into blob Y and return that delta |
| 50 |
| --- www/delta_format.wiki | |
| +++ www/delta_format.wiki | |
| @@ -26,24 +26,24 @@ | |
| 26 | [../src/deltafunc.c|deltafunc.c] source file. |
| 27 | |
| 28 | The following command-line tools are available to create and apply |
| 29 | deltas and to test the delta logic: |
| 30 | |
| 31 | * [/help/test-delta|fossil test-delta] → Run self-tests of |
| 32 | the delta logic |
| 33 | |
| 34 | * [/help/test-delta-create|fossil test-delta-create X Y] → compute |
| 35 | a delta that converts file X into file Y. Output that delta. |
| 36 | |
| 37 | * [/help/test-delta-apply|fossil test-delta-apply X D] → apply |
| 38 | delta D to input file X and output the result. |
| 39 | |
| 40 | * [/help/test-delta-analyze|fossil test-delta-analyze X Y] → compute |
| 41 | and delta that converts file X into file Y but instead of writing the |
| 42 | delta to output, write performance information about the delta. |
| 43 | |
| 44 | When running the [/help/sqlite3|fossil sql] command to get an |
| 45 | interactive SQL session connected to the repository, the following |
| 46 | additional SQL functions are provided: |
| 47 | |
| 48 | * <b>delta_create(</b><i>X</i><b>,</b><i>Y</i><b>)</b> → |
| 49 | Compute a data that carries blob X into blob Y and return that delta |
| 50 |
+2
-2
| --- www/embeddeddoc.wiki | ||
| +++ www/embeddeddoc.wiki | ||
| @@ -36,11 +36,11 @@ | ||
| 36 | 36 | </pre> |
| 37 | 37 | |
| 38 | 38 | The <i><baseurl></i> is the main URL used to access the fossil web server. |
| 39 | 39 | For example, the <i><baseurl></i> for the fossil project itself is |
| 40 | 40 | [https://fossil-scm.org/home]. |
| 41 | -If you launch the web server using the "[/help?cmd=ui|fossil ui]" command line, | |
| 41 | +If you launch the web server using the "[/help/ui|fossil ui]" command line, | |
| 42 | 42 | then the <i><baseurl></i> is usually |
| 43 | 43 | <b>http://localhost:8080/</b>. |
| 44 | 44 | |
| 45 | 45 | The <i><version></i> is the |
| 46 | 46 | [./checkin_names.wiki|name of a check-in] |
| @@ -53,11 +53,11 @@ | ||
| 53 | 53 | also be the special identifier "<b>ckout</b>". |
| 54 | 54 | The "<b>ckout</b>" keywords means to |
| 55 | 55 | pull the documentation file from the local source tree on disk, not |
| 56 | 56 | from the any check-in. The "<b>ckout</b>" keyword |
| 57 | 57 | only works when you start your server using the |
| 58 | -"[/help?cmd=server|fossil server]" or "[/help?cmd=ui|fossil ui]" | |
| 58 | +"[/help/server|fossil server]" or "[/help?cmd=ui|fossil ui]" | |
| 59 | 59 | commands. The "/doc/ckout" URL is intended to show a preview of |
| 60 | 60 | the documentation you are currently editing but have not yet checked in. |
| 61 | 61 | |
| 62 | 62 | The original designed purpose of the "ckout" feature is to allow the |
| 63 | 63 | user to preview local changes to documentation before committing the |
| 64 | 64 |
| --- www/embeddeddoc.wiki | |
| +++ www/embeddeddoc.wiki | |
| @@ -36,11 +36,11 @@ | |
| 36 | </pre> |
| 37 | |
| 38 | The <i><baseurl></i> is the main URL used to access the fossil web server. |
| 39 | For example, the <i><baseurl></i> for the fossil project itself is |
| 40 | [https://fossil-scm.org/home]. |
| 41 | If you launch the web server using the "[/help?cmd=ui|fossil ui]" command line, |
| 42 | then the <i><baseurl></i> is usually |
| 43 | <b>http://localhost:8080/</b>. |
| 44 | |
| 45 | The <i><version></i> is the |
| 46 | [./checkin_names.wiki|name of a check-in] |
| @@ -53,11 +53,11 @@ | |
| 53 | also be the special identifier "<b>ckout</b>". |
| 54 | The "<b>ckout</b>" keywords means to |
| 55 | pull the documentation file from the local source tree on disk, not |
| 56 | from the any check-in. The "<b>ckout</b>" keyword |
| 57 | only works when you start your server using the |
| 58 | "[/help?cmd=server|fossil server]" or "[/help?cmd=ui|fossil ui]" |
| 59 | commands. The "/doc/ckout" URL is intended to show a preview of |
| 60 | the documentation you are currently editing but have not yet checked in. |
| 61 | |
| 62 | The original designed purpose of the "ckout" feature is to allow the |
| 63 | user to preview local changes to documentation before committing the |
| 64 |
| --- www/embeddeddoc.wiki | |
| +++ www/embeddeddoc.wiki | |
| @@ -36,11 +36,11 @@ | |
| 36 | </pre> |
| 37 | |
| 38 | The <i><baseurl></i> is the main URL used to access the fossil web server. |
| 39 | For example, the <i><baseurl></i> for the fossil project itself is |
| 40 | [https://fossil-scm.org/home]. |
| 41 | If you launch the web server using the "[/help/ui|fossil ui]" command line, |
| 42 | then the <i><baseurl></i> is usually |
| 43 | <b>http://localhost:8080/</b>. |
| 44 | |
| 45 | The <i><version></i> is the |
| 46 | [./checkin_names.wiki|name of a check-in] |
| @@ -53,11 +53,11 @@ | |
| 53 | also be the special identifier "<b>ckout</b>". |
| 54 | The "<b>ckout</b>" keywords means to |
| 55 | pull the documentation file from the local source tree on disk, not |
| 56 | from the any check-in. The "<b>ckout</b>" keyword |
| 57 | only works when you start your server using the |
| 58 | "[/help/server|fossil server]" or "[/help?cmd=ui|fossil ui]" |
| 59 | commands. The "/doc/ckout" URL is intended to show a preview of |
| 60 | the documentation you are currently editing but have not yet checked in. |
| 61 | |
| 62 | The original designed purpose of the "ckout" feature is to allow the |
| 63 | user to preview local changes to documentation before committing the |
| 64 |
+1
-1
| --- www/env-opts.md | ||
| +++ www/env-opts.md | ||
| @@ -253,11 +253,11 @@ | ||
| 253 | 253 | `SCRIPT_NAME`: If defined, included in error log messages. |
| 254 | 254 | |
| 255 | 255 | `SSH_CONNECTION`: Informs CGI processing if the remote client is SSH. |
| 256 | 256 | |
| 257 | 257 | `SSL_CERT_FILE`, `SSL_CERT_DIR`: Override the [`ssl-ca-location`] |
| 258 | -(/help?cmd=ssl-ca-location) setting. | |
| 258 | +(/help/ssl-ca-location) setting. | |
| 259 | 259 | |
| 260 | 260 | `SQLITE_FORCE_PROXY_LOCKING`: From `sqlite3.c`, 1 means force always |
| 261 | 261 | use proxy, 0 means never use proxy, and undefined means use proxy for |
| 262 | 262 | non-local files only. |
| 263 | 263 | |
| 264 | 264 |
| --- www/env-opts.md | |
| +++ www/env-opts.md | |
| @@ -253,11 +253,11 @@ | |
| 253 | `SCRIPT_NAME`: If defined, included in error log messages. |
| 254 | |
| 255 | `SSH_CONNECTION`: Informs CGI processing if the remote client is SSH. |
| 256 | |
| 257 | `SSL_CERT_FILE`, `SSL_CERT_DIR`: Override the [`ssl-ca-location`] |
| 258 | (/help?cmd=ssl-ca-location) setting. |
| 259 | |
| 260 | `SQLITE_FORCE_PROXY_LOCKING`: From `sqlite3.c`, 1 means force always |
| 261 | use proxy, 0 means never use proxy, and undefined means use proxy for |
| 262 | non-local files only. |
| 263 | |
| 264 |
| --- www/env-opts.md | |
| +++ www/env-opts.md | |
| @@ -253,11 +253,11 @@ | |
| 253 | `SCRIPT_NAME`: If defined, included in error log messages. |
| 254 | |
| 255 | `SSH_CONNECTION`: Informs CGI processing if the remote client is SSH. |
| 256 | |
| 257 | `SSL_CERT_FILE`, `SSL_CERT_DIR`: Override the [`ssl-ca-location`] |
| 258 | (/help/ssl-ca-location) setting. |
| 259 | |
| 260 | `SQLITE_FORCE_PROXY_LOCKING`: From `sqlite3.c`, 1 means force always |
| 261 | use proxy, 0 means never use proxy, and undefined means use proxy for |
| 262 | non-local files only. |
| 263 | |
| 264 |
+1
-1
| --- www/event.wiki | ||
| +++ www/event.wiki | ||
| @@ -107,11 +107,11 @@ | ||
| 107 | 107 | This note describes changes in the Fossil snapshot for ... |
| 108 | 108 | </verbatim> |
| 109 | 109 | |
| 110 | 110 | The <b>-t|--technote</b> option to the <b>export</b> subcommand takes one of |
| 111 | 111 | three identifiers: <b>DATETIME</b>; <b>TECHNOTE-ID</b>; and <b>TAG</b>. |
| 112 | -See the [/help?cmd=wiki | wiki help] for specifics. | |
| 112 | +See the [/help/wiki | wiki help] for specifics. | |
| 113 | 113 | |
| 114 | 114 | Users must have check-in privileges (permission "i") in order to |
| 115 | 115 | create or edit technotes. In addition, users must have create-wiki |
| 116 | 116 | privilege (permission "f") to create new technotes and edit-wiki |
| 117 | 117 | privilege (permission "k") in order to edit existing technotes. |
| 118 | 118 |
| --- www/event.wiki | |
| +++ www/event.wiki | |
| @@ -107,11 +107,11 @@ | |
| 107 | This note describes changes in the Fossil snapshot for ... |
| 108 | </verbatim> |
| 109 | |
| 110 | The <b>-t|--technote</b> option to the <b>export</b> subcommand takes one of |
| 111 | three identifiers: <b>DATETIME</b>; <b>TECHNOTE-ID</b>; and <b>TAG</b>. |
| 112 | See the [/help?cmd=wiki | wiki help] for specifics. |
| 113 | |
| 114 | Users must have check-in privileges (permission "i") in order to |
| 115 | create or edit technotes. In addition, users must have create-wiki |
| 116 | privilege (permission "f") to create new technotes and edit-wiki |
| 117 | privilege (permission "k") in order to edit existing technotes. |
| 118 |
| --- www/event.wiki | |
| +++ www/event.wiki | |
| @@ -107,11 +107,11 @@ | |
| 107 | This note describes changes in the Fossil snapshot for ... |
| 108 | </verbatim> |
| 109 | |
| 110 | The <b>-t|--technote</b> option to the <b>export</b> subcommand takes one of |
| 111 | three identifiers: <b>DATETIME</b>; <b>TECHNOTE-ID</b>; and <b>TAG</b>. |
| 112 | See the [/help/wiki | wiki help] for specifics. |
| 113 | |
| 114 | Users must have check-in privileges (permission "i") in order to |
| 115 | create or edit technotes. In addition, users must have create-wiki |
| 116 | privilege (permission "f") to create new technotes and edit-wiki |
| 117 | privilege (permission "k") in order to edit existing technotes. |
| 118 |
+1
-1
| --- www/fileedit-page.md | ||
| +++ www/fileedit-page.md | ||
| @@ -13,11 +13,11 @@ | ||
| 13 | 13 | |
| 14 | 14 | ## <a id="cap"></a> `/fileedit` Does *Nothing* by Default. |
| 15 | 15 | |
| 16 | 16 | In order to "activate" it, a user with [the "setup" |
| 17 | 17 | permission](./caps/index.md) must set the |
| 18 | -[fileedit-glob](/help?cmd=fileedit-glob) repository setting to a | |
| 18 | +[fileedit-glob](/help/fileedit-glob) repository setting to a | |
| 19 | 19 | comma- or newline-delimited list of globs representing a whitelist of |
| 20 | 20 | files which may be edited online. Any user with commit access may then |
| 21 | 21 | edit files matching one of those globs. Certain pages within the UI |
| 22 | 22 | get an "edit" link added to them when the current user's permissions |
| 23 | 23 | and the whitelist both permit editing of that file. |
| 24 | 24 |
| --- www/fileedit-page.md | |
| +++ www/fileedit-page.md | |
| @@ -13,11 +13,11 @@ | |
| 13 | |
| 14 | ## <a id="cap"></a> `/fileedit` Does *Nothing* by Default. |
| 15 | |
| 16 | In order to "activate" it, a user with [the "setup" |
| 17 | permission](./caps/index.md) must set the |
| 18 | [fileedit-glob](/help?cmd=fileedit-glob) repository setting to a |
| 19 | comma- or newline-delimited list of globs representing a whitelist of |
| 20 | files which may be edited online. Any user with commit access may then |
| 21 | edit files matching one of those globs. Certain pages within the UI |
| 22 | get an "edit" link added to them when the current user's permissions |
| 23 | and the whitelist both permit editing of that file. |
| 24 |
| --- www/fileedit-page.md | |
| +++ www/fileedit-page.md | |
| @@ -13,11 +13,11 @@ | |
| 13 | |
| 14 | ## <a id="cap"></a> `/fileedit` Does *Nothing* by Default. |
| 15 | |
| 16 | In order to "activate" it, a user with [the "setup" |
| 17 | permission](./caps/index.md) must set the |
| 18 | [fileedit-glob](/help/fileedit-glob) repository setting to a |
| 19 | comma- or newline-delimited list of globs representing a whitelist of |
| 20 | files which may be edited online. Any user with commit access may then |
| 21 | edit files matching one of those globs. Certain pages within the UI |
| 22 | get an "edit" link added to them when the current user's permissions |
| 23 | and the whitelist both permit editing of that file. |
| 24 |
+1
-1
| --- www/forum.wiki | ||
| +++ www/forum.wiki | ||
| @@ -372,11 +372,11 @@ | ||
| 372 | 372 | <h2 id="close-post">Closing Forum Posts</h2> |
| 373 | 373 | |
| 374 | 374 | As of version 2.23, the forum interface supports the notion of |
| 375 | 375 | "closing" posts. By default, only users with the [./caps/index.md|'s' |
| 376 | 376 | and 'a' capabilities] may close or re-open posts, or reply to closed |
| 377 | -posts. If the [/help?cmd=forum-close-policy|forum-close-policy | |
| 377 | +posts. If the [/help/forum-close-policy|forum-close-policy | |
| 378 | 378 | configuration option] is enabled then users with |
| 379 | 379 | [./caps/index.md|forum-moderator permissions] may also perform those |
| 380 | 380 | actions. |
| 381 | 381 | |
| 382 | 382 | Closing a post has the following implications: |
| 383 | 383 |
| --- www/forum.wiki | |
| +++ www/forum.wiki | |
| @@ -372,11 +372,11 @@ | |
| 372 | <h2 id="close-post">Closing Forum Posts</h2> |
| 373 | |
| 374 | As of version 2.23, the forum interface supports the notion of |
| 375 | "closing" posts. By default, only users with the [./caps/index.md|'s' |
| 376 | and 'a' capabilities] may close or re-open posts, or reply to closed |
| 377 | posts. If the [/help?cmd=forum-close-policy|forum-close-policy |
| 378 | configuration option] is enabled then users with |
| 379 | [./caps/index.md|forum-moderator permissions] may also perform those |
| 380 | actions. |
| 381 | |
| 382 | Closing a post has the following implications: |
| 383 |
| --- www/forum.wiki | |
| +++ www/forum.wiki | |
| @@ -372,11 +372,11 @@ | |
| 372 | <h2 id="close-post">Closing Forum Posts</h2> |
| 373 | |
| 374 | As of version 2.23, the forum interface supports the notion of |
| 375 | "closing" posts. By default, only users with the [./caps/index.md|'s' |
| 376 | and 'a' capabilities] may close or re-open posts, or reply to closed |
| 377 | posts. If the [/help/forum-close-policy|forum-close-policy |
| 378 | configuration option] is enabled then users with |
| 379 | [./caps/index.md|forum-moderator permissions] may also perform those |
| 380 | actions. |
| 381 | |
| 382 | Closing a post has the following implications: |
| 383 |
+9
-9
| --- www/fossil-v-git.wiki | ||
| +++ www/fossil-v-git.wiki | ||
| @@ -105,11 +105,11 @@ | ||
| 105 | 105 | [./bugtheory.wiki | ticketing & bug tracking], |
| 106 | 106 | [./embeddeddoc.wiki | embedded documentation], |
| 107 | 107 | [./event.wiki | technical notes], a [./forum.wiki | web forum], |
| 108 | 108 | and a [./chat.md | chat service], |
| 109 | 109 | all within a single nicely-designed [./customskin.md|skinnable] web |
| 110 | -[/help?cmd=ui|UI], | |
| 110 | +[/help/ui|UI], | |
| 111 | 111 | protected by [./caps/ | a fine-grained role-based |
| 112 | 112 | access control system]. |
| 113 | 113 | These additional capabilities are available for Git as 3rd-party |
| 114 | 114 | add-ons, but with Fossil they are integrated into |
| 115 | 115 | the design, to the point that it approximates |
| @@ -130,12 +130,12 @@ | ||
| 130 | 130 | sub-commands as well, such as "<tt>fossil all changes</tt>" to get a list of files |
| 131 | 131 | that you forgot to commit prior to the end of your working day, across |
| 132 | 132 | all repos. |
| 133 | 133 | |
| 134 | 134 | Whenever Fossil is told to modify the local checkout in some destructive |
| 135 | -way ([/help?cmd=rm|fossil rm], [/help?cmd=update|fossil update], | |
| 136 | -[/help?cmd=revert|fossil revert], etc.) Fossil remembers the prior state | |
| 135 | +way ([/help/rm|fossil rm], [/help/update|fossil update], | |
| 136 | +[/help/revert|fossil revert], etc.) Fossil remembers the prior state | |
| 137 | 137 | and is able to return the check-out directory to that state with a |
| 138 | 138 | <tt>fossil undo</tt> command. While you cannot undo a commit in Fossil |
| 139 | 139 | — [#history | on purpose!] — as long as the change remains confined to |
| 140 | 140 | the local check-out directory only, Fossil makes undo |
| 141 | 141 | [https://git-scm.com/book/en/v2/Git-Basics-Undoing-Things|easier than in |
| @@ -443,11 +443,11 @@ | ||
| 443 | 443 | * <b>No easy drive-by contributions:</b> Git |
| 444 | 444 | [https://www.git-scm.com/docs/git-request-pull|pull requests] offer |
| 445 | 445 | a low-friction path to accepting |
| 446 | 446 | [https://www.jonobacon.com/2012/07/25/building-strong-community-structural-integrity/|drive-by |
| 447 | 447 | contributions]. Fossil's closest equivalents are its unique |
| 448 | - [/help?cmd=bundle|bundle] and [/help?cmd=patch|patch] features, which require higher engagement | |
| 448 | + [/help/bundle|bundle] and [/help/patch|patch] features, which require higher engagement | |
| 449 | 449 | than firing off a PR.⁷ This difference comes directly from the |
| 450 | 450 | initial designed purpose for each tool: the SQLite project doesn't |
| 451 | 451 | accept outside contributions from previously-unknown developers, but |
| 452 | 452 | the Linux kernel does. |
| 453 | 453 | |
| @@ -456,11 +456,11 @@ | ||
| 456 | 456 | committed locally. [#history|There is no rebasing mechanism in |
| 457 | 457 | Fossil, on purpose.] |
| 458 | 458 | |
| 459 | 459 | * <b>Sync over push:</b> Explicit pushes are uncommon in |
| 460 | 460 | Fossil-based projects: the default is to rely on |
| 461 | - [/help?cmd=autosync|autosync mode] instead, in which each commit | |
| 461 | + [/help/autosync|autosync mode] instead, in which each commit | |
| 462 | 462 | syncs immediately to its parent repository. This is a mode so you |
| 463 | 463 | can turn it off temporarily when needed, such as when working |
| 464 | 464 | offline. Fossil is still a truly distributed version control system; |
| 465 | 465 | it's just that its starting default is to assume you're rarely out |
| 466 | 466 | of communication with the parent repo. |
| @@ -598,11 +598,11 @@ | ||
| 598 | 598 | that repository, the default mode of operation in Git is to stick to that |
| 599 | 599 | single work/repo tree, even when that's a shortsighted way of working. |
| 600 | 600 | |
| 601 | 601 | Fossil doesn't work that way. A Fossil repository is an SQLite database |
| 602 | 602 | file which is normally stored outside the working checkout directory. You can |
| 603 | -[/help?cmd=open | open] a Fossil repository any number of times into | |
| 603 | +[/help/open | open] a Fossil repository any number of times into | |
| 604 | 604 | any number of working directories. A common usage pattern is to have one |
| 605 | 605 | working directory per active working branch, so that switching branches |
| 606 | 606 | is done with a <tt>cd</tt> command rather than by checking out the |
| 607 | 607 | branches successively in a single working directory. |
| 608 | 608 | |
| @@ -682,11 +682,11 @@ | ||
| 682 | 682 | makes the history of a Fossil project "messy," but another point of view |
| 683 | 683 | is that this makes the history "accurate." In actual practice, the |
| 684 | 684 | superior reporting tools available in Fossil mean that this incidental mess |
| 685 | 685 | is not a factor. |
| 686 | 686 | |
| 687 | -Like Git, Fossil has an [/help?cmd=amend|amend command] for modifying | |
| 687 | +Like Git, Fossil has an [/help/amend|amend command] for modifying | |
| 688 | 688 | prior commits, but unlike in Git, this works not by replacing data in |
| 689 | 689 | the repository, but by adding a correction record to the repository that |
| 690 | 690 | affects how later Fossil operations present the corrected data. The old |
| 691 | 691 | information is still there in the repository, it is just overridden from |
| 692 | 692 | the amendment point forward. |
| @@ -712,11 +712,11 @@ | ||
| 712 | 712 | the receiving repo as well. Fossil's shun feature isn't for fixing up |
| 713 | 713 | everyday bad commits, it's for dealing with extreme situations: public |
| 714 | 714 | commits of secret material, ticket/wiki/forum spam, law enforcement |
| 715 | 715 | takedown demands, etc. |
| 716 | 716 | |
| 717 | -There is also the experimental [/help?cmd=purge | <tt>purge</tt> | |
| 717 | +There is also the experimental [/help/purge | <tt>purge</tt> | |
| 718 | 718 | command], which differs from shunning in ways that aren't especially |
| 719 | 719 | important in the context of this document. At a 30000 foot level, you |
| 720 | 720 | can think of purging as useful only when you've turned off Fossil's |
| 721 | 721 | autosync feature and want to pluck artifacts out of its hash tree before |
| 722 | 722 | they get pushed. In that sense, it's approximately the same as |
| @@ -821,11 +821,11 @@ | ||
| 821 | 821 | that Fossil's command interface is simpler than Git's: there are fewer |
| 822 | 822 | concepts to keep track of in your mental model of Fossil's internal |
| 823 | 823 | operation. |
| 824 | 824 | |
| 825 | 825 | Fossil's implementation of the feature is also simpler to describe. The |
| 826 | -brief online help for <tt>[/help?cmd=merge | fossil merge]</tt> is | |
| 826 | +brief online help for <tt>[/help/merge | fossil merge]</tt> is | |
| 827 | 827 | currently 41 lines long, to which you want to add the 600 lines of |
| 828 | 828 | [./branching.wiki | the branching document]. The equivalent |
| 829 | 829 | documentation in Git is the aggregation of the man pages for the above |
| 830 | 830 | three commands, which is over 1000 lines, much of it mutually redundant. |
| 831 | 831 | (e.g. Git's <tt>--edit</tt> and <tt>--no-commit</tt> options get |
| 832 | 832 |
| --- www/fossil-v-git.wiki | |
| +++ www/fossil-v-git.wiki | |
| @@ -105,11 +105,11 @@ | |
| 105 | [./bugtheory.wiki | ticketing & bug tracking], |
| 106 | [./embeddeddoc.wiki | embedded documentation], |
| 107 | [./event.wiki | technical notes], a [./forum.wiki | web forum], |
| 108 | and a [./chat.md | chat service], |
| 109 | all within a single nicely-designed [./customskin.md|skinnable] web |
| 110 | [/help?cmd=ui|UI], |
| 111 | protected by [./caps/ | a fine-grained role-based |
| 112 | access control system]. |
| 113 | These additional capabilities are available for Git as 3rd-party |
| 114 | add-ons, but with Fossil they are integrated into |
| 115 | the design, to the point that it approximates |
| @@ -130,12 +130,12 @@ | |
| 130 | sub-commands as well, such as "<tt>fossil all changes</tt>" to get a list of files |
| 131 | that you forgot to commit prior to the end of your working day, across |
| 132 | all repos. |
| 133 | |
| 134 | Whenever Fossil is told to modify the local checkout in some destructive |
| 135 | way ([/help?cmd=rm|fossil rm], [/help?cmd=update|fossil update], |
| 136 | [/help?cmd=revert|fossil revert], etc.) Fossil remembers the prior state |
| 137 | and is able to return the check-out directory to that state with a |
| 138 | <tt>fossil undo</tt> command. While you cannot undo a commit in Fossil |
| 139 | — [#history | on purpose!] — as long as the change remains confined to |
| 140 | the local check-out directory only, Fossil makes undo |
| 141 | [https://git-scm.com/book/en/v2/Git-Basics-Undoing-Things|easier than in |
| @@ -443,11 +443,11 @@ | |
| 443 | * <b>No easy drive-by contributions:</b> Git |
| 444 | [https://www.git-scm.com/docs/git-request-pull|pull requests] offer |
| 445 | a low-friction path to accepting |
| 446 | [https://www.jonobacon.com/2012/07/25/building-strong-community-structural-integrity/|drive-by |
| 447 | contributions]. Fossil's closest equivalents are its unique |
| 448 | [/help?cmd=bundle|bundle] and [/help?cmd=patch|patch] features, which require higher engagement |
| 449 | than firing off a PR.⁷ This difference comes directly from the |
| 450 | initial designed purpose for each tool: the SQLite project doesn't |
| 451 | accept outside contributions from previously-unknown developers, but |
| 452 | the Linux kernel does. |
| 453 | |
| @@ -456,11 +456,11 @@ | |
| 456 | committed locally. [#history|There is no rebasing mechanism in |
| 457 | Fossil, on purpose.] |
| 458 | |
| 459 | * <b>Sync over push:</b> Explicit pushes are uncommon in |
| 460 | Fossil-based projects: the default is to rely on |
| 461 | [/help?cmd=autosync|autosync mode] instead, in which each commit |
| 462 | syncs immediately to its parent repository. This is a mode so you |
| 463 | can turn it off temporarily when needed, such as when working |
| 464 | offline. Fossil is still a truly distributed version control system; |
| 465 | it's just that its starting default is to assume you're rarely out |
| 466 | of communication with the parent repo. |
| @@ -598,11 +598,11 @@ | |
| 598 | that repository, the default mode of operation in Git is to stick to that |
| 599 | single work/repo tree, even when that's a shortsighted way of working. |
| 600 | |
| 601 | Fossil doesn't work that way. A Fossil repository is an SQLite database |
| 602 | file which is normally stored outside the working checkout directory. You can |
| 603 | [/help?cmd=open | open] a Fossil repository any number of times into |
| 604 | any number of working directories. A common usage pattern is to have one |
| 605 | working directory per active working branch, so that switching branches |
| 606 | is done with a <tt>cd</tt> command rather than by checking out the |
| 607 | branches successively in a single working directory. |
| 608 | |
| @@ -682,11 +682,11 @@ | |
| 682 | makes the history of a Fossil project "messy," but another point of view |
| 683 | is that this makes the history "accurate." In actual practice, the |
| 684 | superior reporting tools available in Fossil mean that this incidental mess |
| 685 | is not a factor. |
| 686 | |
| 687 | Like Git, Fossil has an [/help?cmd=amend|amend command] for modifying |
| 688 | prior commits, but unlike in Git, this works not by replacing data in |
| 689 | the repository, but by adding a correction record to the repository that |
| 690 | affects how later Fossil operations present the corrected data. The old |
| 691 | information is still there in the repository, it is just overridden from |
| 692 | the amendment point forward. |
| @@ -712,11 +712,11 @@ | |
| 712 | the receiving repo as well. Fossil's shun feature isn't for fixing up |
| 713 | everyday bad commits, it's for dealing with extreme situations: public |
| 714 | commits of secret material, ticket/wiki/forum spam, law enforcement |
| 715 | takedown demands, etc. |
| 716 | |
| 717 | There is also the experimental [/help?cmd=purge | <tt>purge</tt> |
| 718 | command], which differs from shunning in ways that aren't especially |
| 719 | important in the context of this document. At a 30000 foot level, you |
| 720 | can think of purging as useful only when you've turned off Fossil's |
| 721 | autosync feature and want to pluck artifacts out of its hash tree before |
| 722 | they get pushed. In that sense, it's approximately the same as |
| @@ -821,11 +821,11 @@ | |
| 821 | that Fossil's command interface is simpler than Git's: there are fewer |
| 822 | concepts to keep track of in your mental model of Fossil's internal |
| 823 | operation. |
| 824 | |
| 825 | Fossil's implementation of the feature is also simpler to describe. The |
| 826 | brief online help for <tt>[/help?cmd=merge | fossil merge]</tt> is |
| 827 | currently 41 lines long, to which you want to add the 600 lines of |
| 828 | [./branching.wiki | the branching document]. The equivalent |
| 829 | documentation in Git is the aggregation of the man pages for the above |
| 830 | three commands, which is over 1000 lines, much of it mutually redundant. |
| 831 | (e.g. Git's <tt>--edit</tt> and <tt>--no-commit</tt> options get |
| 832 |
| --- www/fossil-v-git.wiki | |
| +++ www/fossil-v-git.wiki | |
| @@ -105,11 +105,11 @@ | |
| 105 | [./bugtheory.wiki | ticketing & bug tracking], |
| 106 | [./embeddeddoc.wiki | embedded documentation], |
| 107 | [./event.wiki | technical notes], a [./forum.wiki | web forum], |
| 108 | and a [./chat.md | chat service], |
| 109 | all within a single nicely-designed [./customskin.md|skinnable] web |
| 110 | [/help/ui|UI], |
| 111 | protected by [./caps/ | a fine-grained role-based |
| 112 | access control system]. |
| 113 | These additional capabilities are available for Git as 3rd-party |
| 114 | add-ons, but with Fossil they are integrated into |
| 115 | the design, to the point that it approximates |
| @@ -130,12 +130,12 @@ | |
| 130 | sub-commands as well, such as "<tt>fossil all changes</tt>" to get a list of files |
| 131 | that you forgot to commit prior to the end of your working day, across |
| 132 | all repos. |
| 133 | |
| 134 | Whenever Fossil is told to modify the local checkout in some destructive |
| 135 | way ([/help/rm|fossil rm], [/help/update|fossil update], |
| 136 | [/help/revert|fossil revert], etc.) Fossil remembers the prior state |
| 137 | and is able to return the check-out directory to that state with a |
| 138 | <tt>fossil undo</tt> command. While you cannot undo a commit in Fossil |
| 139 | — [#history | on purpose!] — as long as the change remains confined to |
| 140 | the local check-out directory only, Fossil makes undo |
| 141 | [https://git-scm.com/book/en/v2/Git-Basics-Undoing-Things|easier than in |
| @@ -443,11 +443,11 @@ | |
| 443 | * <b>No easy drive-by contributions:</b> Git |
| 444 | [https://www.git-scm.com/docs/git-request-pull|pull requests] offer |
| 445 | a low-friction path to accepting |
| 446 | [https://www.jonobacon.com/2012/07/25/building-strong-community-structural-integrity/|drive-by |
| 447 | contributions]. Fossil's closest equivalents are its unique |
| 448 | [/help/bundle|bundle] and [/help/patch|patch] features, which require higher engagement |
| 449 | than firing off a PR.⁷ This difference comes directly from the |
| 450 | initial designed purpose for each tool: the SQLite project doesn't |
| 451 | accept outside contributions from previously-unknown developers, but |
| 452 | the Linux kernel does. |
| 453 | |
| @@ -456,11 +456,11 @@ | |
| 456 | committed locally. [#history|There is no rebasing mechanism in |
| 457 | Fossil, on purpose.] |
| 458 | |
| 459 | * <b>Sync over push:</b> Explicit pushes are uncommon in |
| 460 | Fossil-based projects: the default is to rely on |
| 461 | [/help/autosync|autosync mode] instead, in which each commit |
| 462 | syncs immediately to its parent repository. This is a mode so you |
| 463 | can turn it off temporarily when needed, such as when working |
| 464 | offline. Fossil is still a truly distributed version control system; |
| 465 | it's just that its starting default is to assume you're rarely out |
| 466 | of communication with the parent repo. |
| @@ -598,11 +598,11 @@ | |
| 598 | that repository, the default mode of operation in Git is to stick to that |
| 599 | single work/repo tree, even when that's a shortsighted way of working. |
| 600 | |
| 601 | Fossil doesn't work that way. A Fossil repository is an SQLite database |
| 602 | file which is normally stored outside the working checkout directory. You can |
| 603 | [/help/open | open] a Fossil repository any number of times into |
| 604 | any number of working directories. A common usage pattern is to have one |
| 605 | working directory per active working branch, so that switching branches |
| 606 | is done with a <tt>cd</tt> command rather than by checking out the |
| 607 | branches successively in a single working directory. |
| 608 | |
| @@ -682,11 +682,11 @@ | |
| 682 | makes the history of a Fossil project "messy," but another point of view |
| 683 | is that this makes the history "accurate." In actual practice, the |
| 684 | superior reporting tools available in Fossil mean that this incidental mess |
| 685 | is not a factor. |
| 686 | |
| 687 | Like Git, Fossil has an [/help/amend|amend command] for modifying |
| 688 | prior commits, but unlike in Git, this works not by replacing data in |
| 689 | the repository, but by adding a correction record to the repository that |
| 690 | affects how later Fossil operations present the corrected data. The old |
| 691 | information is still there in the repository, it is just overridden from |
| 692 | the amendment point forward. |
| @@ -712,11 +712,11 @@ | |
| 712 | the receiving repo as well. Fossil's shun feature isn't for fixing up |
| 713 | everyday bad commits, it's for dealing with extreme situations: public |
| 714 | commits of secret material, ticket/wiki/forum spam, law enforcement |
| 715 | takedown demands, etc. |
| 716 | |
| 717 | There is also the experimental [/help/purge | <tt>purge</tt> |
| 718 | command], which differs from shunning in ways that aren't especially |
| 719 | important in the context of this document. At a 30000 foot level, you |
| 720 | can think of purging as useful only when you've turned off Fossil's |
| 721 | autosync feature and want to pluck artifacts out of its hash tree before |
| 722 | they get pushed. In that sense, it's approximately the same as |
| @@ -821,11 +821,11 @@ | |
| 821 | that Fossil's command interface is simpler than Git's: there are fewer |
| 822 | concepts to keep track of in your mental model of Fossil's internal |
| 823 | operation. |
| 824 | |
| 825 | Fossil's implementation of the feature is also simpler to describe. The |
| 826 | brief online help for <tt>[/help/merge | fossil merge]</tt> is |
| 827 | currently 41 lines long, to which you want to add the 600 lines of |
| 828 | [./branching.wiki | the branching document]. The equivalent |
| 829 | documentation in Git is the aggregation of the man pages for the above |
| 830 | three commands, which is over 1000 lines, much of it mutually redundant. |
| 831 | (e.g. Git's <tt>--edit</tt> and <tt>--no-commit</tt> options get |
| 832 |
+22
-22
| --- www/gitusers.md | ||
| +++ www/gitusers.md | ||
| @@ -37,11 +37,11 @@ | ||
| 37 | 37 | While we do try to explain Fossil-specific terminology inline here |
| 38 | 38 | as-needed, you may find it helpful to skim [the Fossil glossary][gloss]. |
| 39 | 39 | It will give you another take on our definitions here, and it may help |
| 40 | 40 | you to understand some of the other Fossil docs better. |
| 41 | 41 | |
| 42 | -[fbis]: /help?cmd=bisect | |
| 42 | +[fbis]: /help/bisect | |
| 43 | 43 | [gbis]: https://git-scm.com/docs/git-bisect |
| 44 | 44 | [ffor]: https://fossil-scm.org/forum |
| 45 | 45 | [fvg]: ./fossil-v-git.wiki |
| 46 | 46 | |
| 47 | 47 | |
| @@ -90,11 +90,11 @@ | ||
| 90 | 90 | from the remote repository into the local clone as `fossil update` does. |
| 91 | 91 | We think this is less broadly useful, but that’s the subject of the next |
| 92 | 92 | section. |
| 93 | 93 | |
| 94 | 94 | [ckwf]: ./ckout-workflows.md |
| 95 | -[co]: /help?cmd=checkout | |
| 95 | +[co]: /help/checkout | |
| 96 | 96 | |
| 97 | 97 | |
| 98 | 98 | #### <a id="pullup"></a> Update vs Pull |
| 99 | 99 | |
| 100 | 100 | The closest equivalent to [`git pull`][gpull] is not |
| @@ -131,11 +131,11 @@ | ||
| 131 | 131 | tip of the current branch. |
| 132 | 132 | |
| 133 | 133 | We think this is a more sensible command design than `git pull` vs |
| 134 | 134 | `git checkout`. ([…vs `git checkout` vs `git checkout`!][gcokoan]) |
| 135 | 135 | |
| 136 | -[fpull]: /help?cmd=pull | |
| 136 | +[fpull]: /help/pull | |
| 137 | 137 | [gpull]: https://git-scm.com/docs/git-pull |
| 138 | 138 | [gcokoan]: https://stevelosh.com/blog/2013/04/git-koans/#s2-one-thing-well |
| 139 | 139 | |
| 140 | 140 | |
| 141 | 141 | #### <a id="close" name="dotfile"></a> Closing a Check-Out |
| @@ -169,11 +169,11 @@ | ||
| 169 | 169 | is that you’re about to delete the directory, so you want Fossil to forget about it |
| 170 | 170 | for the purposes of commands like [`fossil all`][all]. Even that isn’t |
| 171 | 171 | necessary, because Fossil will detect that this has happened and forget |
| 172 | 172 | the working directory for you. |
| 173 | 173 | |
| 174 | -[all]: /help?cmd=all | |
| 174 | +[all]: /help/all | |
| 175 | 175 | |
| 176 | 176 | |
| 177 | 177 | #### <a id="worktree"></a> Git Worktrees |
| 178 | 178 | |
| 179 | 179 | There are at least three different ways to get [Fossil-style multiple |
| @@ -271,18 +271,18 @@ | ||
| 271 | 271 | you’re following [the directory scheme exemplified in the glossary](./glossary.md#repository). That said, it |
| 272 | 272 | does emphasize an earlier point: Fossil doesn’t care where you put the |
| 273 | 273 | repo DB file or what you name it. |
| 274 | 274 | |
| 275 | 275 | |
| 276 | -[clone]: /help?cmd=clone | |
| 277 | -[close]: /help?cmd=close | |
| 276 | +[clone]: /help/clone | |
| 277 | +[close]: /help/close | |
| 278 | 278 | [gloss]: ./glossary.md |
| 279 | -[open]: /help?cmd=open | |
| 280 | -[set]: /help?cmd=setting | |
| 281 | -[server]: /help?cmd=server | |
| 282 | -[stash]: /help?cmd=stash | |
| 283 | -[undo]: /help?cmd=undo | |
| 279 | +[open]: /help/open | |
| 280 | +[set]: /help/setting | |
| 281 | +[server]: /help/server | |
| 282 | +[stash]: /help/stash | |
| 283 | +[undo]: /help/undo | |
| 284 | 284 | |
| 285 | 285 | |
| 286 | 286 | ## <a id="log"></a> Fossil’s Timeline Is the “Log” |
| 287 | 287 | |
| 288 | 288 | Git users often need to use the `git log` command to dig linearly through |
| @@ -416,16 +416,16 @@ | ||
| 416 | 416 | intermediate like “`f time desc curr`”, which is reasonably clear. |
| 417 | 417 | |
| 418 | 418 | [35pct]: https://www.sqlite.org/fasterthanfs.html |
| 419 | 419 | [btree]: https://sqlite.org/btreemodule.html |
| 420 | 420 | [gcn]: https://git-scm.com/docs/gitrevisions |
| 421 | -[infoc]: /help?cmd=info | |
| 422 | -[infow]: /help?cmd=/info | |
| 421 | +[infoc]: /help/info | |
| 422 | +[infow]: /help/www/info | |
| 423 | 423 | [ocomp]: https://www.bigocheatsheet.com/ |
| 424 | -[tlc]: /help?cmd=timeline | |
| 425 | -[tlw]: /help?cmd=/timeline | |
| 426 | -[up]: /help?cmd=update | |
| 424 | +[tlc]: /help/timeline | |
| 425 | +[tlw]: /help/www/timeline | |
| 426 | +[up]: /help/update | |
| 427 | 427 | [wdm]: ./fossil-v-git.wiki#durable |
| 428 | 428 | |
| 429 | 429 | |
| 430 | 430 | ## <a id="dhead"></a> Detached HEAD State |
| 431 | 431 | |
| @@ -631,11 +631,11 @@ | ||
| 631 | 631 | keeps using the same remote server URL you gave it last |
| 632 | 632 | until you [tell it to do something different][rem]. It pushes all |
| 633 | 633 | branches, not just one named local branch. |
| 634 | 634 | |
| 635 | 635 | [capt]: ./cap-theorem.md |
| 636 | -[rem]: /help?cmd=remote | |
| 636 | +[rem]: /help/remote | |
| 637 | 637 | |
| 638 | 638 | |
| 639 | 639 | <a id="autosync"></a> |
| 640 | 640 | ## Autosync |
| 641 | 641 | |
| @@ -941,11 +941,11 @@ | ||
| 941 | 941 | command set. |
| 942 | 942 | |
| 943 | 943 | If you leave off the `-v` flag in the second example, the `diffstat` |
| 944 | 944 | output won’t include info about any newly-added files. |
| 945 | 945 | |
| 946 | -[dcset]: https://fossil-scm.org/home/help?cmd=diff-command | |
| 946 | +[dcset]: https://fossil-scm.org/home/help/diff-command | |
| 947 | 947 | [dst]: https://invisible-island.net/diffstat/diffstat.html |
| 948 | 948 | |
| 949 | 949 | |
| 950 | 950 | <a id="btnames"></a> |
| 951 | 951 | ## Branch and Tag Names |
| @@ -964,11 +964,11 @@ | ||
| 964 | 964 | [The `fossil git export` command][fge] squashes repeated tags down to a |
| 965 | 965 | single instance to avoid confusing Git, exporting only the newest tag, |
| 966 | 966 | emulating Fossil’s own ambiguity resolution rule as best it can within |
| 967 | 967 | Git’s limitations. |
| 968 | 968 | |
| 969 | -[fge]: /help?cmd=git | |
| 969 | +[fge]: /help/git | |
| 970 | 970 | [gcrf]: https://git-scm.com/docs/git-check-ref-format |
| 971 | 971 | |
| 972 | 972 | |
| 973 | 973 | |
| 974 | 974 | |
| @@ -981,11 +981,11 @@ | ||
| 981 | 981 | both merge operations, and the two actions differ only in direction. |
| 982 | 982 | |
| 983 | 983 | Unlike in Git, the Fossil file format remembers cherrypicks and backouts |
| 984 | 984 | and can later show them as dashed lines on the graphical timeline. |
| 985 | 985 | |
| 986 | -[merge]: /help?cmd=merge | |
| 986 | +[merge]: /help/merge | |
| 987 | 987 | |
| 988 | 988 | |
| 989 | 989 | |
| 990 | 990 | <a id="mvrm"></a> |
| 991 | 991 | ## File Moves and Renames Are Soft by Default |
| @@ -1005,12 +1005,12 @@ | ||
| 1005 | 1005 | If you want to keep Fossil’s soft `mv/rm` behavior most of the time, you |
| 1006 | 1006 | can cast it away on a per-command basis: |
| 1007 | 1007 | |
| 1008 | 1008 | fossil mv --hard old-name new-name |
| 1009 | 1009 | |
| 1010 | -[mv]: /help?cmd=mv | |
| 1011 | -[rm]: /help?cmd=rm | |
| 1010 | +[mv]: /help/mv | |
| 1011 | +[rm]: /help/rm | |
| 1012 | 1012 | |
| 1013 | 1013 | |
| 1014 | 1014 | ---- |
| 1015 | 1015 | |
| 1016 | 1016 | |
| 1017 | 1017 |
| --- www/gitusers.md | |
| +++ www/gitusers.md | |
| @@ -37,11 +37,11 @@ | |
| 37 | While we do try to explain Fossil-specific terminology inline here |
| 38 | as-needed, you may find it helpful to skim [the Fossil glossary][gloss]. |
| 39 | It will give you another take on our definitions here, and it may help |
| 40 | you to understand some of the other Fossil docs better. |
| 41 | |
| 42 | [fbis]: /help?cmd=bisect |
| 43 | [gbis]: https://git-scm.com/docs/git-bisect |
| 44 | [ffor]: https://fossil-scm.org/forum |
| 45 | [fvg]: ./fossil-v-git.wiki |
| 46 | |
| 47 | |
| @@ -90,11 +90,11 @@ | |
| 90 | from the remote repository into the local clone as `fossil update` does. |
| 91 | We think this is less broadly useful, but that’s the subject of the next |
| 92 | section. |
| 93 | |
| 94 | [ckwf]: ./ckout-workflows.md |
| 95 | [co]: /help?cmd=checkout |
| 96 | |
| 97 | |
| 98 | #### <a id="pullup"></a> Update vs Pull |
| 99 | |
| 100 | The closest equivalent to [`git pull`][gpull] is not |
| @@ -131,11 +131,11 @@ | |
| 131 | tip of the current branch. |
| 132 | |
| 133 | We think this is a more sensible command design than `git pull` vs |
| 134 | `git checkout`. ([…vs `git checkout` vs `git checkout`!][gcokoan]) |
| 135 | |
| 136 | [fpull]: /help?cmd=pull |
| 137 | [gpull]: https://git-scm.com/docs/git-pull |
| 138 | [gcokoan]: https://stevelosh.com/blog/2013/04/git-koans/#s2-one-thing-well |
| 139 | |
| 140 | |
| 141 | #### <a id="close" name="dotfile"></a> Closing a Check-Out |
| @@ -169,11 +169,11 @@ | |
| 169 | is that you’re about to delete the directory, so you want Fossil to forget about it |
| 170 | for the purposes of commands like [`fossil all`][all]. Even that isn’t |
| 171 | necessary, because Fossil will detect that this has happened and forget |
| 172 | the working directory for you. |
| 173 | |
| 174 | [all]: /help?cmd=all |
| 175 | |
| 176 | |
| 177 | #### <a id="worktree"></a> Git Worktrees |
| 178 | |
| 179 | There are at least three different ways to get [Fossil-style multiple |
| @@ -271,18 +271,18 @@ | |
| 271 | you’re following [the directory scheme exemplified in the glossary](./glossary.md#repository). That said, it |
| 272 | does emphasize an earlier point: Fossil doesn’t care where you put the |
| 273 | repo DB file or what you name it. |
| 274 | |
| 275 | |
| 276 | [clone]: /help?cmd=clone |
| 277 | [close]: /help?cmd=close |
| 278 | [gloss]: ./glossary.md |
| 279 | [open]: /help?cmd=open |
| 280 | [set]: /help?cmd=setting |
| 281 | [server]: /help?cmd=server |
| 282 | [stash]: /help?cmd=stash |
| 283 | [undo]: /help?cmd=undo |
| 284 | |
| 285 | |
| 286 | ## <a id="log"></a> Fossil’s Timeline Is the “Log” |
| 287 | |
| 288 | Git users often need to use the `git log` command to dig linearly through |
| @@ -416,16 +416,16 @@ | |
| 416 | intermediate like “`f time desc curr`”, which is reasonably clear. |
| 417 | |
| 418 | [35pct]: https://www.sqlite.org/fasterthanfs.html |
| 419 | [btree]: https://sqlite.org/btreemodule.html |
| 420 | [gcn]: https://git-scm.com/docs/gitrevisions |
| 421 | [infoc]: /help?cmd=info |
| 422 | [infow]: /help?cmd=/info |
| 423 | [ocomp]: https://www.bigocheatsheet.com/ |
| 424 | [tlc]: /help?cmd=timeline |
| 425 | [tlw]: /help?cmd=/timeline |
| 426 | [up]: /help?cmd=update |
| 427 | [wdm]: ./fossil-v-git.wiki#durable |
| 428 | |
| 429 | |
| 430 | ## <a id="dhead"></a> Detached HEAD State |
| 431 | |
| @@ -631,11 +631,11 @@ | |
| 631 | keeps using the same remote server URL you gave it last |
| 632 | until you [tell it to do something different][rem]. It pushes all |
| 633 | branches, not just one named local branch. |
| 634 | |
| 635 | [capt]: ./cap-theorem.md |
| 636 | [rem]: /help?cmd=remote |
| 637 | |
| 638 | |
| 639 | <a id="autosync"></a> |
| 640 | ## Autosync |
| 641 | |
| @@ -941,11 +941,11 @@ | |
| 941 | command set. |
| 942 | |
| 943 | If you leave off the `-v` flag in the second example, the `diffstat` |
| 944 | output won’t include info about any newly-added files. |
| 945 | |
| 946 | [dcset]: https://fossil-scm.org/home/help?cmd=diff-command |
| 947 | [dst]: https://invisible-island.net/diffstat/diffstat.html |
| 948 | |
| 949 | |
| 950 | <a id="btnames"></a> |
| 951 | ## Branch and Tag Names |
| @@ -964,11 +964,11 @@ | |
| 964 | [The `fossil git export` command][fge] squashes repeated tags down to a |
| 965 | single instance to avoid confusing Git, exporting only the newest tag, |
| 966 | emulating Fossil’s own ambiguity resolution rule as best it can within |
| 967 | Git’s limitations. |
| 968 | |
| 969 | [fge]: /help?cmd=git |
| 970 | [gcrf]: https://git-scm.com/docs/git-check-ref-format |
| 971 | |
| 972 | |
| 973 | |
| 974 | |
| @@ -981,11 +981,11 @@ | |
| 981 | both merge operations, and the two actions differ only in direction. |
| 982 | |
| 983 | Unlike in Git, the Fossil file format remembers cherrypicks and backouts |
| 984 | and can later show them as dashed lines on the graphical timeline. |
| 985 | |
| 986 | [merge]: /help?cmd=merge |
| 987 | |
| 988 | |
| 989 | |
| 990 | <a id="mvrm"></a> |
| 991 | ## File Moves and Renames Are Soft by Default |
| @@ -1005,12 +1005,12 @@ | |
| 1005 | If you want to keep Fossil’s soft `mv/rm` behavior most of the time, you |
| 1006 | can cast it away on a per-command basis: |
| 1007 | |
| 1008 | fossil mv --hard old-name new-name |
| 1009 | |
| 1010 | [mv]: /help?cmd=mv |
| 1011 | [rm]: /help?cmd=rm |
| 1012 | |
| 1013 | |
| 1014 | ---- |
| 1015 | |
| 1016 | |
| 1017 |
| --- www/gitusers.md | |
| +++ www/gitusers.md | |
| @@ -37,11 +37,11 @@ | |
| 37 | While we do try to explain Fossil-specific terminology inline here |
| 38 | as-needed, you may find it helpful to skim [the Fossil glossary][gloss]. |
| 39 | It will give you another take on our definitions here, and it may help |
| 40 | you to understand some of the other Fossil docs better. |
| 41 | |
| 42 | [fbis]: /help/bisect |
| 43 | [gbis]: https://git-scm.com/docs/git-bisect |
| 44 | [ffor]: https://fossil-scm.org/forum |
| 45 | [fvg]: ./fossil-v-git.wiki |
| 46 | |
| 47 | |
| @@ -90,11 +90,11 @@ | |
| 90 | from the remote repository into the local clone as `fossil update` does. |
| 91 | We think this is less broadly useful, but that’s the subject of the next |
| 92 | section. |
| 93 | |
| 94 | [ckwf]: ./ckout-workflows.md |
| 95 | [co]: /help/checkout |
| 96 | |
| 97 | |
| 98 | #### <a id="pullup"></a> Update vs Pull |
| 99 | |
| 100 | The closest equivalent to [`git pull`][gpull] is not |
| @@ -131,11 +131,11 @@ | |
| 131 | tip of the current branch. |
| 132 | |
| 133 | We think this is a more sensible command design than `git pull` vs |
| 134 | `git checkout`. ([…vs `git checkout` vs `git checkout`!][gcokoan]) |
| 135 | |
| 136 | [fpull]: /help/pull |
| 137 | [gpull]: https://git-scm.com/docs/git-pull |
| 138 | [gcokoan]: https://stevelosh.com/blog/2013/04/git-koans/#s2-one-thing-well |
| 139 | |
| 140 | |
| 141 | #### <a id="close" name="dotfile"></a> Closing a Check-Out |
| @@ -169,11 +169,11 @@ | |
| 169 | is that you’re about to delete the directory, so you want Fossil to forget about it |
| 170 | for the purposes of commands like [`fossil all`][all]. Even that isn’t |
| 171 | necessary, because Fossil will detect that this has happened and forget |
| 172 | the working directory for you. |
| 173 | |
| 174 | [all]: /help/all |
| 175 | |
| 176 | |
| 177 | #### <a id="worktree"></a> Git Worktrees |
| 178 | |
| 179 | There are at least three different ways to get [Fossil-style multiple |
| @@ -271,18 +271,18 @@ | |
| 271 | you’re following [the directory scheme exemplified in the glossary](./glossary.md#repository). That said, it |
| 272 | does emphasize an earlier point: Fossil doesn’t care where you put the |
| 273 | repo DB file or what you name it. |
| 274 | |
| 275 | |
| 276 | [clone]: /help/clone |
| 277 | [close]: /help/close |
| 278 | [gloss]: ./glossary.md |
| 279 | [open]: /help/open |
| 280 | [set]: /help/setting |
| 281 | [server]: /help/server |
| 282 | [stash]: /help/stash |
| 283 | [undo]: /help/undo |
| 284 | |
| 285 | |
| 286 | ## <a id="log"></a> Fossil’s Timeline Is the “Log” |
| 287 | |
| 288 | Git users often need to use the `git log` command to dig linearly through |
| @@ -416,16 +416,16 @@ | |
| 416 | intermediate like “`f time desc curr`”, which is reasonably clear. |
| 417 | |
| 418 | [35pct]: https://www.sqlite.org/fasterthanfs.html |
| 419 | [btree]: https://sqlite.org/btreemodule.html |
| 420 | [gcn]: https://git-scm.com/docs/gitrevisions |
| 421 | [infoc]: /help/info |
| 422 | [infow]: /help/www/info |
| 423 | [ocomp]: https://www.bigocheatsheet.com/ |
| 424 | [tlc]: /help/timeline |
| 425 | [tlw]: /help/www/timeline |
| 426 | [up]: /help/update |
| 427 | [wdm]: ./fossil-v-git.wiki#durable |
| 428 | |
| 429 | |
| 430 | ## <a id="dhead"></a> Detached HEAD State |
| 431 | |
| @@ -631,11 +631,11 @@ | |
| 631 | keeps using the same remote server URL you gave it last |
| 632 | until you [tell it to do something different][rem]. It pushes all |
| 633 | branches, not just one named local branch. |
| 634 | |
| 635 | [capt]: ./cap-theorem.md |
| 636 | [rem]: /help/remote |
| 637 | |
| 638 | |
| 639 | <a id="autosync"></a> |
| 640 | ## Autosync |
| 641 | |
| @@ -941,11 +941,11 @@ | |
| 941 | command set. |
| 942 | |
| 943 | If you leave off the `-v` flag in the second example, the `diffstat` |
| 944 | output won’t include info about any newly-added files. |
| 945 | |
| 946 | [dcset]: https://fossil-scm.org/home/help/diff-command |
| 947 | [dst]: https://invisible-island.net/diffstat/diffstat.html |
| 948 | |
| 949 | |
| 950 | <a id="btnames"></a> |
| 951 | ## Branch and Tag Names |
| @@ -964,11 +964,11 @@ | |
| 964 | [The `fossil git export` command][fge] squashes repeated tags down to a |
| 965 | single instance to avoid confusing Git, exporting only the newest tag, |
| 966 | emulating Fossil’s own ambiguity resolution rule as best it can within |
| 967 | Git’s limitations. |
| 968 | |
| 969 | [fge]: /help/git |
| 970 | [gcrf]: https://git-scm.com/docs/git-check-ref-format |
| 971 | |
| 972 | |
| 973 | |
| 974 | |
| @@ -981,11 +981,11 @@ | |
| 981 | both merge operations, and the two actions differ only in direction. |
| 982 | |
| 983 | Unlike in Git, the Fossil file format remembers cherrypicks and backouts |
| 984 | and can later show them as dashed lines on the graphical timeline. |
| 985 | |
| 986 | [merge]: /help/merge |
| 987 | |
| 988 | |
| 989 | |
| 990 | <a id="mvrm"></a> |
| 991 | ## File Moves and Renames Are Soft by Default |
| @@ -1005,12 +1005,12 @@ | |
| 1005 | If you want to keep Fossil’s soft `mv/rm` behavior most of the time, you |
| 1006 | can cast it away on a per-command basis: |
| 1007 | |
| 1008 | fossil mv --hard old-name new-name |
| 1009 | |
| 1010 | [mv]: /help/mv |
| 1011 | [rm]: /help/rm |
| 1012 | |
| 1013 | |
| 1014 | ---- |
| 1015 | |
| 1016 | |
| 1017 |
+24
-24
| --- www/globs.md | ||
| +++ www/globs.md | ||
| @@ -242,29 +242,29 @@ | ||
| 242 | 242 | The commands [`http`][], [`cgi`][], [`server`][], and [`ui`][] that |
| 243 | 243 | implement or support with web servers provide a mechanism to name some |
| 244 | 244 | files to serve with static content where a list of glob patterns |
| 245 | 245 | specifies what content may be served. |
| 246 | 246 | |
| 247 | -[`add`]: /help?cmd=add | |
| 248 | -[`addremove`]: /help?cmd=addremove | |
| 249 | -[`changes`]: /help?cmd=changes | |
| 250 | -[`clean`]: /help?cmd=clean | |
| 251 | -[`commit`]: /help?cmd=commit | |
| 252 | -[`extras`]: /help?cmd=extras | |
| 253 | -[`merge`]: /help?cmd=merge | |
| 254 | -[`settings`]: /help?cmd=settings | |
| 255 | -[`status`]: /help?cmd=status | |
| 256 | -[`touch`]: /help?cmd=touch | |
| 257 | -[`unset`]: /help?cmd=unset | |
| 258 | - | |
| 259 | -[`tarball`]: /help?cmd=tarball | |
| 260 | -[`zip`]: /help?cmd=zip | |
| 261 | - | |
| 262 | -[`http`]: /help?cmd=http | |
| 263 | -[`cgi`]: /help?cmd=cgi | |
| 264 | -[`server`]: /help?cmd=server | |
| 265 | -[`ui`]: /help?cmd=ui | |
| 247 | +[`add`]: /help/add | |
| 248 | +[`addremove`]: /help/addremove | |
| 249 | +[`changes`]: /help/changes | |
| 250 | +[`clean`]: /help/clean | |
| 251 | +[`commit`]: /help/commit | |
| 252 | +[`extras`]: /help/extras | |
| 253 | +[`merge`]: /help/merge | |
| 254 | +[`settings`]: /help/settings | |
| 255 | +[`status`]: /help/status | |
| 256 | +[`touch`]: /help/touch | |
| 257 | +[`unset`]: /help/unset | |
| 258 | + | |
| 259 | +[`tarball`]: /help/tarball | |
| 260 | +[`zip`]: /help/zip | |
| 261 | + | |
| 262 | +[`http`]: /help/http | |
| 263 | +[`cgi`]: /help/cgi | |
| 264 | +[`server`]: /help/server | |
| 265 | +[`ui`]: /help/ui | |
| 266 | 266 | |
| 267 | 267 | |
| 268 | 268 | ### Web Pages that Refer to Globs |
| 269 | 269 | |
| 270 | 270 | The [`/timeline`][] page supports the query parameter `chng=GLOBLIST` that |
| @@ -277,13 +277,13 @@ | ||
| 277 | 277 | The pages [`/tarball`][] and [`/zip`][] generate compressed archives |
| 278 | 278 | of a specific checkin. They may be further restricted by query |
| 279 | 279 | parameters that specify glob patterns that name files to include or |
| 280 | 280 | exclude rather than taking the entire checkin. |
| 281 | 281 | |
| 282 | -[`/timeline`]: /help?cmd=/timeline | |
| 283 | -[`/tarball`]: /help?cmd=/tarball | |
| 284 | -[`/zip`]: /help?cmd=/zip | |
| 282 | +[`/timeline`]: /help/www/timeline | |
| 283 | +[`/tarball`]: /help/www/tarball | |
| 284 | +[`/zip`]: /help/www/zip | |
| 285 | 285 | |
| 286 | 286 | |
| 287 | 287 | ## Platform Quirks |
| 288 | 288 | |
| 289 | 289 | Fossil glob patterns are based on the glob pattern feature of POSIX |
| @@ -512,12 +512,12 @@ | ||
| 512 | 512 | C:\> echo * | fossil test-echo setting crlf-glob --args - |
| 513 | 513 | |
| 514 | 514 | The [`test-glob`][] command is also handy to test if a string |
| 515 | 515 | matches a glob pattern. |
| 516 | 516 | |
| 517 | -[`test-echo`]: /help?cmd=test-echo | |
| 518 | -[`test-glob`]: /help?cmd=test-glob | |
| 517 | +[`test-echo`]: /help/test-echo | |
| 518 | +[`test-glob`]: /help/test-glob | |
| 519 | 519 | |
| 520 | 520 | |
| 521 | 521 | ## Converting `.gitignore` to `ignore-glob` |
| 522 | 522 | |
| 523 | 523 | Many other version control systems handle the specific case of |
| 524 | 524 |
| --- www/globs.md | |
| +++ www/globs.md | |
| @@ -242,29 +242,29 @@ | |
| 242 | The commands [`http`][], [`cgi`][], [`server`][], and [`ui`][] that |
| 243 | implement or support with web servers provide a mechanism to name some |
| 244 | files to serve with static content where a list of glob patterns |
| 245 | specifies what content may be served. |
| 246 | |
| 247 | [`add`]: /help?cmd=add |
| 248 | [`addremove`]: /help?cmd=addremove |
| 249 | [`changes`]: /help?cmd=changes |
| 250 | [`clean`]: /help?cmd=clean |
| 251 | [`commit`]: /help?cmd=commit |
| 252 | [`extras`]: /help?cmd=extras |
| 253 | [`merge`]: /help?cmd=merge |
| 254 | [`settings`]: /help?cmd=settings |
| 255 | [`status`]: /help?cmd=status |
| 256 | [`touch`]: /help?cmd=touch |
| 257 | [`unset`]: /help?cmd=unset |
| 258 | |
| 259 | [`tarball`]: /help?cmd=tarball |
| 260 | [`zip`]: /help?cmd=zip |
| 261 | |
| 262 | [`http`]: /help?cmd=http |
| 263 | [`cgi`]: /help?cmd=cgi |
| 264 | [`server`]: /help?cmd=server |
| 265 | [`ui`]: /help?cmd=ui |
| 266 | |
| 267 | |
| 268 | ### Web Pages that Refer to Globs |
| 269 | |
| 270 | The [`/timeline`][] page supports the query parameter `chng=GLOBLIST` that |
| @@ -277,13 +277,13 @@ | |
| 277 | The pages [`/tarball`][] and [`/zip`][] generate compressed archives |
| 278 | of a specific checkin. They may be further restricted by query |
| 279 | parameters that specify glob patterns that name files to include or |
| 280 | exclude rather than taking the entire checkin. |
| 281 | |
| 282 | [`/timeline`]: /help?cmd=/timeline |
| 283 | [`/tarball`]: /help?cmd=/tarball |
| 284 | [`/zip`]: /help?cmd=/zip |
| 285 | |
| 286 | |
| 287 | ## Platform Quirks |
| 288 | |
| 289 | Fossil glob patterns are based on the glob pattern feature of POSIX |
| @@ -512,12 +512,12 @@ | |
| 512 | C:\> echo * | fossil test-echo setting crlf-glob --args - |
| 513 | |
| 514 | The [`test-glob`][] command is also handy to test if a string |
| 515 | matches a glob pattern. |
| 516 | |
| 517 | [`test-echo`]: /help?cmd=test-echo |
| 518 | [`test-glob`]: /help?cmd=test-glob |
| 519 | |
| 520 | |
| 521 | ## Converting `.gitignore` to `ignore-glob` |
| 522 | |
| 523 | Many other version control systems handle the specific case of |
| 524 |
| --- www/globs.md | |
| +++ www/globs.md | |
| @@ -242,29 +242,29 @@ | |
| 242 | The commands [`http`][], [`cgi`][], [`server`][], and [`ui`][] that |
| 243 | implement or support with web servers provide a mechanism to name some |
| 244 | files to serve with static content where a list of glob patterns |
| 245 | specifies what content may be served. |
| 246 | |
| 247 | [`add`]: /help/add |
| 248 | [`addremove`]: /help/addremove |
| 249 | [`changes`]: /help/changes |
| 250 | [`clean`]: /help/clean |
| 251 | [`commit`]: /help/commit |
| 252 | [`extras`]: /help/extras |
| 253 | [`merge`]: /help/merge |
| 254 | [`settings`]: /help/settings |
| 255 | [`status`]: /help/status |
| 256 | [`touch`]: /help/touch |
| 257 | [`unset`]: /help/unset |
| 258 | |
| 259 | [`tarball`]: /help/tarball |
| 260 | [`zip`]: /help/zip |
| 261 | |
| 262 | [`http`]: /help/http |
| 263 | [`cgi`]: /help/cgi |
| 264 | [`server`]: /help/server |
| 265 | [`ui`]: /help/ui |
| 266 | |
| 267 | |
| 268 | ### Web Pages that Refer to Globs |
| 269 | |
| 270 | The [`/timeline`][] page supports the query parameter `chng=GLOBLIST` that |
| @@ -277,13 +277,13 @@ | |
| 277 | The pages [`/tarball`][] and [`/zip`][] generate compressed archives |
| 278 | of a specific checkin. They may be further restricted by query |
| 279 | parameters that specify glob patterns that name files to include or |
| 280 | exclude rather than taking the entire checkin. |
| 281 | |
| 282 | [`/timeline`]: /help/www/timeline |
| 283 | [`/tarball`]: /help/www/tarball |
| 284 | [`/zip`]: /help/www/zip |
| 285 | |
| 286 | |
| 287 | ## Platform Quirks |
| 288 | |
| 289 | Fossil glob patterns are based on the glob pattern feature of POSIX |
| @@ -512,12 +512,12 @@ | |
| 512 | C:\> echo * | fossil test-echo setting crlf-glob --args - |
| 513 | |
| 514 | The [`test-glob`][] command is also handy to test if a string |
| 515 | matches a glob pattern. |
| 516 | |
| 517 | [`test-echo`]: /help/test-echo |
| 518 | [`test-glob`]: /help/test-glob |
| 519 | |
| 520 | |
| 521 | ## Converting `.gitignore` to `ignore-glob` |
| 522 | |
| 523 | Many other version control systems handle the specific case of |
| 524 |
+18
-18
| --- www/glossary.md | ||
| +++ www/glossary.md | ||
| @@ -90,17 +90,17 @@ | ||
| 90 | 90 | As a counterexample, a project tracking your [Vim] configuration |
| 91 | 91 | history is a much better use of Fossil, because it’s all held within |
| 92 | 92 | `~/.vim`, and your user has full rights to that subdirectory. |
| 93 | 93 | |
| 94 | 94 | [AIF]: https://docs.asciidoctor.org/asciidoc/latest/directives/include/ |
| 95 | -[IGS]: /help?cmd=ignore-glob | |
| 95 | +[IGS]: /help/ignore-glob | |
| 96 | 96 | [IFRS]: ./image-format-vs-repo-size.md |
| 97 | -[tarball]: /help?cmd=tarball | |
| 98 | -[tw]: /help?cmd=/tarball | |
| 97 | +[tarball]: /help/tarball | |
| 98 | +[tw]: /help/www/tarball | |
| 99 | 99 | [Vim]: https://www.vim.org/ |
| 100 | -[zip]: /help?cmd=zip | |
| 101 | -[zw]: /help?cmd=/zip | |
| 100 | +[zip]: /help/zip | |
| 101 | +[zw]: /help/www/zip | |
| 102 | 102 | |
| 103 | 103 | |
| 104 | 104 | ## Repository <a id="repository" name="repo"></a> |
| 105 | 105 | |
| 106 | 106 | A single file that contains all historical versions of all files in a |
| @@ -195,18 +195,18 @@ | ||
| 195 | 195 | line dotted right until even with previous line.end |
| 196 | 196 | move right 0.05 |
| 197 | 197 | box invis "clones of Fossil itself, SQLite, etc." ljust |
| 198 | 198 | ``` |
| 199 | 199 | |
| 200 | -[asdis]: /help?cmd=autosync | |
| 200 | +[asdis]: /help/autosync | |
| 201 | 201 | [backup]: ./backup.md |
| 202 | 202 | [CAP]: ./cap-theorem.md |
| 203 | -[cloned]: /help?cmd=clone | |
| 204 | -[pull]: /help?cmd=pull | |
| 205 | -[push]: /help?cmd=push | |
| 206 | -[svrcmd]: /help?cmd=server | |
| 207 | -[sync]: /help?cmd=sync | |
| 203 | +[cloned]: /help/clone | |
| 204 | +[pull]: /help/pull | |
| 205 | +[push]: /help/push | |
| 206 | +[svrcmd]: /help/server | |
| 207 | +[sync]: /help/sync | |
| 208 | 208 | |
| 209 | 209 | [repository]: #repo |
| 210 | 210 | [repositories]: #repo |
| 211 | 211 | |
| 212 | 212 | |
| @@ -310,15 +310,15 @@ | ||
| 310 | 310 | at the time of the snapshot. (Thus [the `extras` command][extras].) |
| 311 | 311 | Contrast a snapshot taken by a virtual machine system or a |
| 312 | 312 | [snapshotting file system][snfs], which captures changes to everything |
| 313 | 313 | on the managed storage volume. |
| 314 | 314 | |
| 315 | -[add]: /help?cmd=add | |
| 315 | +[add]: /help/add | |
| 316 | 316 | [ciname]: ./checkin_names.wiki |
| 317 | -[extras]: /help?cmd=extras | |
| 318 | -[stash]: /help?cmd=stash | |
| 319 | -[undo]: /help?cmd=undo | |
| 317 | +[extras]: /help/extras | |
| 318 | +[stash]: /help/stash | |
| 319 | +[undo]: /help/undo | |
| 320 | 320 | |
| 321 | 321 | |
| 322 | 322 | |
| 323 | 323 | ## Check-out <a id="check-out" name="co"></a> |
| 324 | 324 | |
| @@ -365,17 +365,17 @@ | ||
| 365 | 365 | this is because VSCode’s version control features assume it’s being |
| 366 | 366 | used with Git, where the repository is the `.git` subdirectory |
| 367 | 367 | contents. With Fossil, [different check-out workflows][cwork] are |
| 368 | 368 | preferred. |
| 369 | 369 | |
| 370 | -[commit]: /help?cmd=commit | |
| 370 | +[commit]: /help/commit | |
| 371 | 371 | [cwork]: ./ckout-workflows.md |
| 372 | 372 | [h2cflp]: https://www.sqlite.org/howtocorrupt.html#_file_locking_problems |
| 373 | 373 | [fpvsc]: https://marketplace.visualstudio.com/items?itemName=koog1000.fossil |
| 374 | -[open]: /help?cmd=open | |
| 374 | +[open]: /help/open | |
| 375 | 375 | [mwd]: ./ckout-workflows.md#mcw |
| 376 | -[update]: /help?cmd=update | |
| 376 | +[update]: /help/update | |
| 377 | 377 | |
| 378 | 378 | |
| 379 | 379 | ## <a id="docs"></a>Embedded Documentation |
| 380 | 380 | |
| 381 | 381 | Serving as an alternative to Fossil’s built-in [wiki], the [embedded |
| 382 | 382 |
| --- www/glossary.md | |
| +++ www/glossary.md | |
| @@ -90,17 +90,17 @@ | |
| 90 | As a counterexample, a project tracking your [Vim] configuration |
| 91 | history is a much better use of Fossil, because it’s all held within |
| 92 | `~/.vim`, and your user has full rights to that subdirectory. |
| 93 | |
| 94 | [AIF]: https://docs.asciidoctor.org/asciidoc/latest/directives/include/ |
| 95 | [IGS]: /help?cmd=ignore-glob |
| 96 | [IFRS]: ./image-format-vs-repo-size.md |
| 97 | [tarball]: /help?cmd=tarball |
| 98 | [tw]: /help?cmd=/tarball |
| 99 | [Vim]: https://www.vim.org/ |
| 100 | [zip]: /help?cmd=zip |
| 101 | [zw]: /help?cmd=/zip |
| 102 | |
| 103 | |
| 104 | ## Repository <a id="repository" name="repo"></a> |
| 105 | |
| 106 | A single file that contains all historical versions of all files in a |
| @@ -195,18 +195,18 @@ | |
| 195 | line dotted right until even with previous line.end |
| 196 | move right 0.05 |
| 197 | box invis "clones of Fossil itself, SQLite, etc." ljust |
| 198 | ``` |
| 199 | |
| 200 | [asdis]: /help?cmd=autosync |
| 201 | [backup]: ./backup.md |
| 202 | [CAP]: ./cap-theorem.md |
| 203 | [cloned]: /help?cmd=clone |
| 204 | [pull]: /help?cmd=pull |
| 205 | [push]: /help?cmd=push |
| 206 | [svrcmd]: /help?cmd=server |
| 207 | [sync]: /help?cmd=sync |
| 208 | |
| 209 | [repository]: #repo |
| 210 | [repositories]: #repo |
| 211 | |
| 212 | |
| @@ -310,15 +310,15 @@ | |
| 310 | at the time of the snapshot. (Thus [the `extras` command][extras].) |
| 311 | Contrast a snapshot taken by a virtual machine system or a |
| 312 | [snapshotting file system][snfs], which captures changes to everything |
| 313 | on the managed storage volume. |
| 314 | |
| 315 | [add]: /help?cmd=add |
| 316 | [ciname]: ./checkin_names.wiki |
| 317 | [extras]: /help?cmd=extras |
| 318 | [stash]: /help?cmd=stash |
| 319 | [undo]: /help?cmd=undo |
| 320 | |
| 321 | |
| 322 | |
| 323 | ## Check-out <a id="check-out" name="co"></a> |
| 324 | |
| @@ -365,17 +365,17 @@ | |
| 365 | this is because VSCode’s version control features assume it’s being |
| 366 | used with Git, where the repository is the `.git` subdirectory |
| 367 | contents. With Fossil, [different check-out workflows][cwork] are |
| 368 | preferred. |
| 369 | |
| 370 | [commit]: /help?cmd=commit |
| 371 | [cwork]: ./ckout-workflows.md |
| 372 | [h2cflp]: https://www.sqlite.org/howtocorrupt.html#_file_locking_problems |
| 373 | [fpvsc]: https://marketplace.visualstudio.com/items?itemName=koog1000.fossil |
| 374 | [open]: /help?cmd=open |
| 375 | [mwd]: ./ckout-workflows.md#mcw |
| 376 | [update]: /help?cmd=update |
| 377 | |
| 378 | |
| 379 | ## <a id="docs"></a>Embedded Documentation |
| 380 | |
| 381 | Serving as an alternative to Fossil’s built-in [wiki], the [embedded |
| 382 |
| --- www/glossary.md | |
| +++ www/glossary.md | |
| @@ -90,17 +90,17 @@ | |
| 90 | As a counterexample, a project tracking your [Vim] configuration |
| 91 | history is a much better use of Fossil, because it’s all held within |
| 92 | `~/.vim`, and your user has full rights to that subdirectory. |
| 93 | |
| 94 | [AIF]: https://docs.asciidoctor.org/asciidoc/latest/directives/include/ |
| 95 | [IGS]: /help/ignore-glob |
| 96 | [IFRS]: ./image-format-vs-repo-size.md |
| 97 | [tarball]: /help/tarball |
| 98 | [tw]: /help/www/tarball |
| 99 | [Vim]: https://www.vim.org/ |
| 100 | [zip]: /help/zip |
| 101 | [zw]: /help/www/zip |
| 102 | |
| 103 | |
| 104 | ## Repository <a id="repository" name="repo"></a> |
| 105 | |
| 106 | A single file that contains all historical versions of all files in a |
| @@ -195,18 +195,18 @@ | |
| 195 | line dotted right until even with previous line.end |
| 196 | move right 0.05 |
| 197 | box invis "clones of Fossil itself, SQLite, etc." ljust |
| 198 | ``` |
| 199 | |
| 200 | [asdis]: /help/autosync |
| 201 | [backup]: ./backup.md |
| 202 | [CAP]: ./cap-theorem.md |
| 203 | [cloned]: /help/clone |
| 204 | [pull]: /help/pull |
| 205 | [push]: /help/push |
| 206 | [svrcmd]: /help/server |
| 207 | [sync]: /help/sync |
| 208 | |
| 209 | [repository]: #repo |
| 210 | [repositories]: #repo |
| 211 | |
| 212 | |
| @@ -310,15 +310,15 @@ | |
| 310 | at the time of the snapshot. (Thus [the `extras` command][extras].) |
| 311 | Contrast a snapshot taken by a virtual machine system or a |
| 312 | [snapshotting file system][snfs], which captures changes to everything |
| 313 | on the managed storage volume. |
| 314 | |
| 315 | [add]: /help/add |
| 316 | [ciname]: ./checkin_names.wiki |
| 317 | [extras]: /help/extras |
| 318 | [stash]: /help/stash |
| 319 | [undo]: /help/undo |
| 320 | |
| 321 | |
| 322 | |
| 323 | ## Check-out <a id="check-out" name="co"></a> |
| 324 | |
| @@ -365,17 +365,17 @@ | |
| 365 | this is because VSCode’s version control features assume it’s being |
| 366 | used with Git, where the repository is the `.git` subdirectory |
| 367 | contents. With Fossil, [different check-out workflows][cwork] are |
| 368 | preferred. |
| 369 | |
| 370 | [commit]: /help/commit |
| 371 | [cwork]: ./ckout-workflows.md |
| 372 | [h2cflp]: https://www.sqlite.org/howtocorrupt.html#_file_locking_problems |
| 373 | [fpvsc]: https://marketplace.visualstudio.com/items?itemName=koog1000.fossil |
| 374 | [open]: /help/open |
| 375 | [mwd]: ./ckout-workflows.md#mcw |
| 376 | [update]: /help/update |
| 377 | |
| 378 | |
| 379 | ## <a id="docs"></a>Embedded Documentation |
| 380 | |
| 381 | Serving as an alternative to Fossil’s built-in [wiki], the [embedded |
| 382 |
+2
-2
| --- www/hashes.md | ||
| +++ www/hashes.md | ||
| @@ -145,10 +145,10 @@ | ||
| 145 | 145 | [ctkt]: ./custom_ticket.wiki |
| 146 | 146 | [hpol]: ./hashpolicy.wiki |
| 147 | 147 | [japi]: ./json-api/ |
| 148 | 148 | [jart]: ./json-api/api-artifact.md |
| 149 | 149 | [jtim]: ./json-api/api-timeline.md |
| 150 | -[mset]: /help?cmd=manifest | |
| 150 | +[mset]: /help/manifest | |
| 151 | 151 | [th1]: ./th1.md |
| 152 | -[trss]: /help?cmd=/timeline.rss | |
| 152 | +[trss]: /help/www/timeline.rss | |
| 153 | 153 | [tvb]: ./branching.wiki |
| 154 | 154 | [uuid]: https://en.wikipedia.org/wiki/Universally_unique_identifier |
| 155 | 155 |
| --- www/hashes.md | |
| +++ www/hashes.md | |
| @@ -145,10 +145,10 @@ | |
| 145 | [ctkt]: ./custom_ticket.wiki |
| 146 | [hpol]: ./hashpolicy.wiki |
| 147 | [japi]: ./json-api/ |
| 148 | [jart]: ./json-api/api-artifact.md |
| 149 | [jtim]: ./json-api/api-timeline.md |
| 150 | [mset]: /help?cmd=manifest |
| 151 | [th1]: ./th1.md |
| 152 | [trss]: /help?cmd=/timeline.rss |
| 153 | [tvb]: ./branching.wiki |
| 154 | [uuid]: https://en.wikipedia.org/wiki/Universally_unique_identifier |
| 155 |
| --- www/hashes.md | |
| +++ www/hashes.md | |
| @@ -145,10 +145,10 @@ | |
| 145 | [ctkt]: ./custom_ticket.wiki |
| 146 | [hpol]: ./hashpolicy.wiki |
| 147 | [japi]: ./json-api/ |
| 148 | [jart]: ./json-api/api-artifact.md |
| 149 | [jtim]: ./json-api/api-timeline.md |
| 150 | [mset]: /help/manifest |
| 151 | [th1]: ./th1.md |
| 152 | [trss]: /help/www/timeline.rss |
| 153 | [tvb]: ./branching.wiki |
| 154 | [uuid]: https://en.wikipedia.org/wiki/Universally_unique_identifier |
| 155 |
+1
-1
| --- www/hashpolicy.wiki | ||
| +++ www/hashpolicy.wiki | ||
| @@ -158,11 +158,11 @@ | ||
| 158 | 158 | |
| 159 | 159 | When a new repository is created by cloning, the hash policy is copied |
| 160 | 160 | from the parent. |
| 161 | 161 | |
| 162 | 162 | For new repositories created using the |
| 163 | -[/help?cmd=new|fossil new] command the default hash policy is "sha3". | |
| 163 | +[/help/new|fossil new] command the default hash policy is "sha3". | |
| 164 | 164 | That means new repositories |
| 165 | 165 | will normally hold nothing except SHA3 hashes. The hash policy for new |
| 166 | 166 | repositories can be overridden using the "--sha1" option to the |
| 167 | 167 | "fossil new" command. |
| 168 | 168 | |
| 169 | 169 |
| --- www/hashpolicy.wiki | |
| +++ www/hashpolicy.wiki | |
| @@ -158,11 +158,11 @@ | |
| 158 | |
| 159 | When a new repository is created by cloning, the hash policy is copied |
| 160 | from the parent. |
| 161 | |
| 162 | For new repositories created using the |
| 163 | [/help?cmd=new|fossil new] command the default hash policy is "sha3". |
| 164 | That means new repositories |
| 165 | will normally hold nothing except SHA3 hashes. The hash policy for new |
| 166 | repositories can be overridden using the "--sha1" option to the |
| 167 | "fossil new" command. |
| 168 | |
| 169 |
| --- www/hashpolicy.wiki | |
| +++ www/hashpolicy.wiki | |
| @@ -158,11 +158,11 @@ | |
| 158 | |
| 159 | When a new repository is created by cloning, the hash policy is copied |
| 160 | from the parent. |
| 161 | |
| 162 | For new repositories created using the |
| 163 | [/help/new|fossil new] command the default hash policy is "sha3". |
| 164 | That means new repositories |
| 165 | will normally hold nothing except SHA3 hashes. The hash policy for new |
| 166 | repositories can be overridden using the "--sha1" option to the |
| 167 | "fossil new" command. |
| 168 | |
| 169 |
+7
-7
| --- www/hints.wiki | ||
| +++ www/hints.wiki | ||
| @@ -3,11 +3,11 @@ | ||
| 3 | 3 | A collection of useful hints and tricks in no particular order: |
| 4 | 4 | |
| 5 | 5 | 1. Click on two nodes of any timeline graph in succession |
| 6 | 6 | to see a diff between the two versions. |
| 7 | 7 | |
| 8 | - 2. Add the "--tk" option to "[/help?cmd=diff | fossil diff]" commands | |
| 8 | + 2. Add the "--tk" option to "[/help/diff | fossil diff]" commands | |
| 9 | 9 | to get a pop-up |
| 10 | 10 | window containing a complete side-by-side diff. (NB: The pop-up |
| 11 | 11 | window is run as a separate Tcl/Tk process, so you will need to |
| 12 | 12 | have Tcl/Tk installed on your machine for this to work. Visit |
| 13 | 13 | [http://www.activestate.com/activetcl] for a quick download of |
| @@ -17,13 +17,13 @@ | ||
| 17 | 17 | alternative to "make clean". You can use "[/help/clean | fossil clean -f]" |
| 18 | 18 | as a slightly safer alternative if the "ignore-glob" setting is |
| 19 | 19 | not set. WARNING: make sure you did a "fossil add" for all source-files |
| 20 | 20 | you plan to commit, otherwise those files will be deleted without warning. |
| 21 | 21 | |
| 22 | - 4. Use "[/help?cmd=all | fossil all changes]" to look for any uncommitted | |
| 22 | + 4. Use "[/help/all | fossil all changes]" to look for any uncommitted | |
| 23 | 23 | edits in any of your Fossil projects. Use |
| 24 | - "[/help?cmd=all | fossil all pull]" on your laptop | |
| 24 | + "[/help/all | fossil all pull]" on your laptop | |
| 25 | 25 | prior to going off network (for example, on a long plane ride) |
| 26 | 26 | to make sure you have all the latest content locally. Then run |
| 27 | 27 | "[/help/all|fossil all push]" when you get back online to upload |
| 28 | 28 | your changes. |
| 29 | 29 | |
| @@ -37,13 +37,13 @@ | ||
| 37 | 37 | on in the Fossil repository on 2008-01-01, visit |
| 38 | 38 | [/timeline?c=2008-01-01]. |
| 39 | 39 | |
| 40 | 40 | 7. Further to the previous two hints, there are lots of query parameters |
| 41 | 41 | that you can add to timeline pages. The available query parameters |
| 42 | - are tersely documented [/help?cmd=/timeline | here]. | |
| 42 | + are tersely documented [/help/www/timeline | here]. | |
| 43 | 43 | |
| 44 | - 8. You can run "[/help?cmd=xdiff | fossil xdiff --tk $file1 $file2]" | |
| 44 | + 8. You can run "[/help/xdiff | fossil xdiff --tk $file1 $file2]" | |
| 45 | 45 | to get a Tk pop-up window with side-by-side diffs of two files, even if |
| 46 | 46 | neither of the two files is part of any Fossil repository. Note that |
| 47 | 47 | this command is "xdiff", not "diff". Change <nobr>--tk</nobr> to |
| 48 | 48 | <nobr>--by</nobr> to see the diff in your web browser. |
| 49 | 49 | |
| @@ -61,14 +61,14 @@ | ||
| 61 | 61 | 10. When editing documentation to be checked in as managed files, you can |
| 62 | 62 | preview what the documentation will look like by using the special |
| 63 | 63 | "ckout" branch name in the "doc" URL while running "fossil ui". |
| 64 | 64 | See the [./embeddeddoc.wiki | embedded documentation] for details. |
| 65 | 65 | |
| 66 | - 11. Use the "[/help?cmd=ui|fossil ui /]" command to bring up a menu of | |
| 66 | + 11. Use the "[/help/ui|fossil ui /]" command to bring up a menu of | |
| 67 | 67 | all of your local Fossil repositories in your web browser. |
| 68 | 68 | |
| 69 | 69 | 12. If you have a bunch of Fossil repositories living on a remote machine |
| 70 | 70 | that you are able to access using ssh using a command like |
| 71 | 71 | "ssh login@remote", then you can bring up a user interface for all |
| 72 | 72 | those remote repositories using the command: |
| 73 | - "[/help?cmd=ui|fossil ui login@remote:/]". This works by tunneling | |
| 73 | + "[/help/ui|fossil ui login@remote:/]". This works by tunneling | |
| 74 | 74 | all HTTP traffic through SSH to the remote machine. |
| 75 | 75 |
| --- www/hints.wiki | |
| +++ www/hints.wiki | |
| @@ -3,11 +3,11 @@ | |
| 3 | A collection of useful hints and tricks in no particular order: |
| 4 | |
| 5 | 1. Click on two nodes of any timeline graph in succession |
| 6 | to see a diff between the two versions. |
| 7 | |
| 8 | 2. Add the "--tk" option to "[/help?cmd=diff | fossil diff]" commands |
| 9 | to get a pop-up |
| 10 | window containing a complete side-by-side diff. (NB: The pop-up |
| 11 | window is run as a separate Tcl/Tk process, so you will need to |
| 12 | have Tcl/Tk installed on your machine for this to work. Visit |
| 13 | [http://www.activestate.com/activetcl] for a quick download of |
| @@ -17,13 +17,13 @@ | |
| 17 | alternative to "make clean". You can use "[/help/clean | fossil clean -f]" |
| 18 | as a slightly safer alternative if the "ignore-glob" setting is |
| 19 | not set. WARNING: make sure you did a "fossil add" for all source-files |
| 20 | you plan to commit, otherwise those files will be deleted without warning. |
| 21 | |
| 22 | 4. Use "[/help?cmd=all | fossil all changes]" to look for any uncommitted |
| 23 | edits in any of your Fossil projects. Use |
| 24 | "[/help?cmd=all | fossil all pull]" on your laptop |
| 25 | prior to going off network (for example, on a long plane ride) |
| 26 | to make sure you have all the latest content locally. Then run |
| 27 | "[/help/all|fossil all push]" when you get back online to upload |
| 28 | your changes. |
| 29 | |
| @@ -37,13 +37,13 @@ | |
| 37 | on in the Fossil repository on 2008-01-01, visit |
| 38 | [/timeline?c=2008-01-01]. |
| 39 | |
| 40 | 7. Further to the previous two hints, there are lots of query parameters |
| 41 | that you can add to timeline pages. The available query parameters |
| 42 | are tersely documented [/help?cmd=/timeline | here]. |
| 43 | |
| 44 | 8. You can run "[/help?cmd=xdiff | fossil xdiff --tk $file1 $file2]" |
| 45 | to get a Tk pop-up window with side-by-side diffs of two files, even if |
| 46 | neither of the two files is part of any Fossil repository. Note that |
| 47 | this command is "xdiff", not "diff". Change <nobr>--tk</nobr> to |
| 48 | <nobr>--by</nobr> to see the diff in your web browser. |
| 49 | |
| @@ -61,14 +61,14 @@ | |
| 61 | 10. When editing documentation to be checked in as managed files, you can |
| 62 | preview what the documentation will look like by using the special |
| 63 | "ckout" branch name in the "doc" URL while running "fossil ui". |
| 64 | See the [./embeddeddoc.wiki | embedded documentation] for details. |
| 65 | |
| 66 | 11. Use the "[/help?cmd=ui|fossil ui /]" command to bring up a menu of |
| 67 | all of your local Fossil repositories in your web browser. |
| 68 | |
| 69 | 12. If you have a bunch of Fossil repositories living on a remote machine |
| 70 | that you are able to access using ssh using a command like |
| 71 | "ssh login@remote", then you can bring up a user interface for all |
| 72 | those remote repositories using the command: |
| 73 | "[/help?cmd=ui|fossil ui login@remote:/]". This works by tunneling |
| 74 | all HTTP traffic through SSH to the remote machine. |
| 75 |
| --- www/hints.wiki | |
| +++ www/hints.wiki | |
| @@ -3,11 +3,11 @@ | |
| 3 | A collection of useful hints and tricks in no particular order: |
| 4 | |
| 5 | 1. Click on two nodes of any timeline graph in succession |
| 6 | to see a diff between the two versions. |
| 7 | |
| 8 | 2. Add the "--tk" option to "[/help/diff | fossil diff]" commands |
| 9 | to get a pop-up |
| 10 | window containing a complete side-by-side diff. (NB: The pop-up |
| 11 | window is run as a separate Tcl/Tk process, so you will need to |
| 12 | have Tcl/Tk installed on your machine for this to work. Visit |
| 13 | [http://www.activestate.com/activetcl] for a quick download of |
| @@ -17,13 +17,13 @@ | |
| 17 | alternative to "make clean". You can use "[/help/clean | fossil clean -f]" |
| 18 | as a slightly safer alternative if the "ignore-glob" setting is |
| 19 | not set. WARNING: make sure you did a "fossil add" for all source-files |
| 20 | you plan to commit, otherwise those files will be deleted without warning. |
| 21 | |
| 22 | 4. Use "[/help/all | fossil all changes]" to look for any uncommitted |
| 23 | edits in any of your Fossil projects. Use |
| 24 | "[/help/all | fossil all pull]" on your laptop |
| 25 | prior to going off network (for example, on a long plane ride) |
| 26 | to make sure you have all the latest content locally. Then run |
| 27 | "[/help/all|fossil all push]" when you get back online to upload |
| 28 | your changes. |
| 29 | |
| @@ -37,13 +37,13 @@ | |
| 37 | on in the Fossil repository on 2008-01-01, visit |
| 38 | [/timeline?c=2008-01-01]. |
| 39 | |
| 40 | 7. Further to the previous two hints, there are lots of query parameters |
| 41 | that you can add to timeline pages. The available query parameters |
| 42 | are tersely documented [/help/www/timeline | here]. |
| 43 | |
| 44 | 8. You can run "[/help/xdiff | fossil xdiff --tk $file1 $file2]" |
| 45 | to get a Tk pop-up window with side-by-side diffs of two files, even if |
| 46 | neither of the two files is part of any Fossil repository. Note that |
| 47 | this command is "xdiff", not "diff". Change <nobr>--tk</nobr> to |
| 48 | <nobr>--by</nobr> to see the diff in your web browser. |
| 49 | |
| @@ -61,14 +61,14 @@ | |
| 61 | 10. When editing documentation to be checked in as managed files, you can |
| 62 | preview what the documentation will look like by using the special |
| 63 | "ckout" branch name in the "doc" URL while running "fossil ui". |
| 64 | See the [./embeddeddoc.wiki | embedded documentation] for details. |
| 65 | |
| 66 | 11. Use the "[/help/ui|fossil ui /]" command to bring up a menu of |
| 67 | all of your local Fossil repositories in your web browser. |
| 68 | |
| 69 | 12. If you have a bunch of Fossil repositories living on a remote machine |
| 70 | that you are able to access using ssh using a command like |
| 71 | "ssh login@remote", then you can bring up a user interface for all |
| 72 | those remote repositories using the command: |
| 73 | "[/help/ui|fossil ui login@remote:/]". This works by tunneling |
| 74 | all HTTP traffic through SSH to the remote machine. |
| 75 |
+1
-1
| --- www/inout.wiki | ||
| +++ www/inout.wiki | ||
| @@ -27,11 +27,11 @@ | ||
| 27 | 27 | |
| 28 | 28 | <a id="fx_git"></a> |
| 29 | 29 | Note that in new imports, Fossil defaults to using the email component of the |
| 30 | 30 | Git <em>committer</em> (or <em>author</em> if <code>--use-author</code> is |
| 31 | 31 | passed) to attribute check-ins in the imported repository. Alternatively, the |
| 32 | -[/help?cmd=import | <code>--attribute</code>] option can be passed to have all | |
| 32 | +[/help/import | <code>--attribute</code>] option can be passed to have all | |
| 33 | 33 | commits by a given committer attributed to a desired username. This will create |
| 34 | 34 | and populate the new <code>fx_git</code> table in the repository database to |
| 35 | 35 | maintain a record of correspondent usernames and email addresses that can be |
| 36 | 36 | used in subsequent exports or incremental imports. |
| 37 | 37 | |
| 38 | 38 |
| --- www/inout.wiki | |
| +++ www/inout.wiki | |
| @@ -27,11 +27,11 @@ | |
| 27 | |
| 28 | <a id="fx_git"></a> |
| 29 | Note that in new imports, Fossil defaults to using the email component of the |
| 30 | Git <em>committer</em> (or <em>author</em> if <code>--use-author</code> is |
| 31 | passed) to attribute check-ins in the imported repository. Alternatively, the |
| 32 | [/help?cmd=import | <code>--attribute</code>] option can be passed to have all |
| 33 | commits by a given committer attributed to a desired username. This will create |
| 34 | and populate the new <code>fx_git</code> table in the repository database to |
| 35 | maintain a record of correspondent usernames and email addresses that can be |
| 36 | used in subsequent exports or incremental imports. |
| 37 | |
| 38 |
| --- www/inout.wiki | |
| +++ www/inout.wiki | |
| @@ -27,11 +27,11 @@ | |
| 27 | |
| 28 | <a id="fx_git"></a> |
| 29 | Note that in new imports, Fossil defaults to using the email component of the |
| 30 | Git <em>committer</em> (or <em>author</em> if <code>--use-author</code> is |
| 31 | passed) to attribute check-ins in the imported repository. Alternatively, the |
| 32 | [/help/import | <code>--attribute</code>] option can be passed to have all |
| 33 | commits by a given committer attributed to a desired username. This will create |
| 34 | and populate the new <code>fx_git</code> table in the repository database to |
| 35 | maintain a record of correspondent usernames and email addresses that can be |
| 36 | used in subsequent exports or incremental imports. |
| 37 | |
| 38 |
+2
-2
| --- www/interwiki.md | ||
| +++ www/interwiki.md | ||
| @@ -64,11 +64,11 @@ | ||
| 64 | 64 | |
| 65 | 65 | The intermap defines a mapping from interwiki Tags to full URLs. The |
| 66 | 66 | Intermap can be viewed and managed using the [fossil interwiki][iwiki] |
| 67 | 67 | command or the [/intermap][imap] webpage. |
| 68 | 68 | |
| 69 | -[iwiki]: /help?cmd=interwiki | |
| 69 | +[iwiki]: /help/interwiki | |
| 70 | 70 | [imap]: /intermap |
| 71 | 71 | |
| 72 | 72 | The current intermap for a server is seen on the [/intermap][imap] page |
| 73 | 73 | (which is read-only for non-Setup users) and at the bottom of the built-in |
| 74 | 74 | [Fossil Wiki rules](/wiki_rules) and [Markdown rules](/md_rules) |
| @@ -100,11 +100,11 @@ | ||
| 100 | 100 | "_source→target_", but it also tracks "_target→source_". |
| 101 | 101 | But backtracking does not work for interwiki links, since the Fossil |
| 102 | 102 | running on the target has no way of scanning the source text and |
| 103 | 103 | hence has no way of knowing that it is a target of a link from the source. |
| 104 | 104 | |
| 105 | -[fcfg]: /help?cmd=config | |
| 105 | +[fcfg]: /help/config | |
| 106 | 106 | |
| 107 | 107 | ## Intermap Storage Details |
| 108 | 108 | |
| 109 | 109 | The intermap is stored in the CONFIG table of the repository database, |
| 110 | 110 | in entries with names of the form "<tt>interwiki:</tt><i>Tag</i>". The |
| 111 | 111 |
| --- www/interwiki.md | |
| +++ www/interwiki.md | |
| @@ -64,11 +64,11 @@ | |
| 64 | |
| 65 | The intermap defines a mapping from interwiki Tags to full URLs. The |
| 66 | Intermap can be viewed and managed using the [fossil interwiki][iwiki] |
| 67 | command or the [/intermap][imap] webpage. |
| 68 | |
| 69 | [iwiki]: /help?cmd=interwiki |
| 70 | [imap]: /intermap |
| 71 | |
| 72 | The current intermap for a server is seen on the [/intermap][imap] page |
| 73 | (which is read-only for non-Setup users) and at the bottom of the built-in |
| 74 | [Fossil Wiki rules](/wiki_rules) and [Markdown rules](/md_rules) |
| @@ -100,11 +100,11 @@ | |
| 100 | "_source→target_", but it also tracks "_target→source_". |
| 101 | But backtracking does not work for interwiki links, since the Fossil |
| 102 | running on the target has no way of scanning the source text and |
| 103 | hence has no way of knowing that it is a target of a link from the source. |
| 104 | |
| 105 | [fcfg]: /help?cmd=config |
| 106 | |
| 107 | ## Intermap Storage Details |
| 108 | |
| 109 | The intermap is stored in the CONFIG table of the repository database, |
| 110 | in entries with names of the form "<tt>interwiki:</tt><i>Tag</i>". The |
| 111 |
| --- www/interwiki.md | |
| +++ www/interwiki.md | |
| @@ -64,11 +64,11 @@ | |
| 64 | |
| 65 | The intermap defines a mapping from interwiki Tags to full URLs. The |
| 66 | Intermap can be viewed and managed using the [fossil interwiki][iwiki] |
| 67 | command or the [/intermap][imap] webpage. |
| 68 | |
| 69 | [iwiki]: /help/interwiki |
| 70 | [imap]: /intermap |
| 71 | |
| 72 | The current intermap for a server is seen on the [/intermap][imap] page |
| 73 | (which is read-only for non-Setup users) and at the bottom of the built-in |
| 74 | [Fossil Wiki rules](/wiki_rules) and [Markdown rules](/md_rules) |
| @@ -100,11 +100,11 @@ | |
| 100 | "_source→target_", but it also tracks "_target→source_". |
| 101 | But backtracking does not work for interwiki links, since the Fossil |
| 102 | running on the target has no way of scanning the source text and |
| 103 | hence has no way of knowing that it is a target of a link from the source. |
| 104 | |
| 105 | [fcfg]: /help/config |
| 106 | |
| 107 | ## Intermap Storage Details |
| 108 | |
| 109 | The intermap is stored in the CONFIG table of the repository database, |
| 110 | in entries with names of the form "<tt>interwiki:</tt><i>Tag</i>". The |
| 111 |
+4
-4
| --- www/javascript.md | ||
| +++ www/javascript.md | ||
| @@ -263,17 +263,17 @@ | ||
| 263 | 263 | [ciu]: https://caniuse.com/ |
| 264 | 264 | [cskin]: ./customskin.md |
| 265 | 265 | [dcsp]: ./defcsp.md |
| 266 | 266 | [es2015]: https://ecma-international.org/ecma-262/6.0/ |
| 267 | 267 | [es6dep]: https://caniuse.com/#feat=es6 |
| 268 | -[fcgi]: /help?cmd=cgi | |
| 268 | +[fcgi]: /help/cgi | |
| 269 | 269 | [ffor]: https://fossil-scm.org/forum/ |
| 270 | 270 | [flic]: /doc/trunk/COPYRIGHT-BSD2.txt |
| 271 | 271 | [fshome]: /doc/trunk/www/server/ |
| 272 | 272 | [fslpl]: /doc/trunk/www/fossil-v-git.wiki#portable |
| 273 | 273 | [fsrc]: https://fossil-scm.org/home/file/src |
| 274 | -[fsrv]: /help?cmd=server | |
| 274 | +[fsrv]: /help/server | |
| 275 | 275 | [hljs]: https://fossil-scm.org/forum/forumpost/9150bc22ca |
| 276 | 276 | [ie11x]: https://techcommunity.microsoft.com/t5/microsoft-365-blog/microsoft-365-apps-say-farewell-to-internet-explorer-11-and/ba-p/1591666 |
| 277 | 277 | [ns]: https://noscript.net/ |
| 278 | 278 | [pjs]: https://fossil-scm.org/forum/forumpost/1198651c6d |
| 279 | 279 | [s1]: https://blockmetry.com/blog/javascript-disabled |
| @@ -390,11 +390,11 @@ | ||
| 390 | 390 | ``` |
| 391 | 391 | |
| 392 | 392 | Extending this concept to other text editors is an exercise left to the |
| 393 | 393 | reader. |
| 394 | 394 | |
| 395 | -[fwc]: /help?cmd=wiki | |
| 395 | +[fwc]: /help/wiki | |
| 396 | 396 | [fwt]: ./wikitheory.wiki |
| 397 | 397 | |
| 398 | 398 | |
| 399 | 399 | ### <a id="fedit"></a>The File Editor |
| 400 | 400 | |
| @@ -430,11 +430,11 @@ | ||
| 430 | 430 | When viewing source files, Fossil offers to show line numbers in some |
| 431 | 431 | cases. ([Example][mainc].) Toggling them on and off is currently handled |
| 432 | 432 | in JavaScript, rather than forcing a page-reload via a button click. |
| 433 | 433 | |
| 434 | 434 | _Workaround:_ Manually edit the URL to give the “`ln`” query parameter |
| 435 | -per [the `/file` docs](/help?cmd=/file). | |
| 435 | +per [the `/file` docs](/help/www/file). | |
| 436 | 436 | |
| 437 | 437 | _Potential Better Workaround:_ Someone sufficiently interested could |
| 438 | 438 | [provide a patch][cg] to add a `<noscript>` wrapped HTML button that |
| 439 | 439 | would reload the page with this parameter included/excluded to implement |
| 440 | 440 | the toggle via a server round-trip. |
| 441 | 441 |
| --- www/javascript.md | |
| +++ www/javascript.md | |
| @@ -263,17 +263,17 @@ | |
| 263 | [ciu]: https://caniuse.com/ |
| 264 | [cskin]: ./customskin.md |
| 265 | [dcsp]: ./defcsp.md |
| 266 | [es2015]: https://ecma-international.org/ecma-262/6.0/ |
| 267 | [es6dep]: https://caniuse.com/#feat=es6 |
| 268 | [fcgi]: /help?cmd=cgi |
| 269 | [ffor]: https://fossil-scm.org/forum/ |
| 270 | [flic]: /doc/trunk/COPYRIGHT-BSD2.txt |
| 271 | [fshome]: /doc/trunk/www/server/ |
| 272 | [fslpl]: /doc/trunk/www/fossil-v-git.wiki#portable |
| 273 | [fsrc]: https://fossil-scm.org/home/file/src |
| 274 | [fsrv]: /help?cmd=server |
| 275 | [hljs]: https://fossil-scm.org/forum/forumpost/9150bc22ca |
| 276 | [ie11x]: https://techcommunity.microsoft.com/t5/microsoft-365-blog/microsoft-365-apps-say-farewell-to-internet-explorer-11-and/ba-p/1591666 |
| 277 | [ns]: https://noscript.net/ |
| 278 | [pjs]: https://fossil-scm.org/forum/forumpost/1198651c6d |
| 279 | [s1]: https://blockmetry.com/blog/javascript-disabled |
| @@ -390,11 +390,11 @@ | |
| 390 | ``` |
| 391 | |
| 392 | Extending this concept to other text editors is an exercise left to the |
| 393 | reader. |
| 394 | |
| 395 | [fwc]: /help?cmd=wiki |
| 396 | [fwt]: ./wikitheory.wiki |
| 397 | |
| 398 | |
| 399 | ### <a id="fedit"></a>The File Editor |
| 400 | |
| @@ -430,11 +430,11 @@ | |
| 430 | When viewing source files, Fossil offers to show line numbers in some |
| 431 | cases. ([Example][mainc].) Toggling them on and off is currently handled |
| 432 | in JavaScript, rather than forcing a page-reload via a button click. |
| 433 | |
| 434 | _Workaround:_ Manually edit the URL to give the “`ln`” query parameter |
| 435 | per [the `/file` docs](/help?cmd=/file). |
| 436 | |
| 437 | _Potential Better Workaround:_ Someone sufficiently interested could |
| 438 | [provide a patch][cg] to add a `<noscript>` wrapped HTML button that |
| 439 | would reload the page with this parameter included/excluded to implement |
| 440 | the toggle via a server round-trip. |
| 441 |
| --- www/javascript.md | |
| +++ www/javascript.md | |
| @@ -263,17 +263,17 @@ | |
| 263 | [ciu]: https://caniuse.com/ |
| 264 | [cskin]: ./customskin.md |
| 265 | [dcsp]: ./defcsp.md |
| 266 | [es2015]: https://ecma-international.org/ecma-262/6.0/ |
| 267 | [es6dep]: https://caniuse.com/#feat=es6 |
| 268 | [fcgi]: /help/cgi |
| 269 | [ffor]: https://fossil-scm.org/forum/ |
| 270 | [flic]: /doc/trunk/COPYRIGHT-BSD2.txt |
| 271 | [fshome]: /doc/trunk/www/server/ |
| 272 | [fslpl]: /doc/trunk/www/fossil-v-git.wiki#portable |
| 273 | [fsrc]: https://fossil-scm.org/home/file/src |
| 274 | [fsrv]: /help/server |
| 275 | [hljs]: https://fossil-scm.org/forum/forumpost/9150bc22ca |
| 276 | [ie11x]: https://techcommunity.microsoft.com/t5/microsoft-365-blog/microsoft-365-apps-say-farewell-to-internet-explorer-11-and/ba-p/1591666 |
| 277 | [ns]: https://noscript.net/ |
| 278 | [pjs]: https://fossil-scm.org/forum/forumpost/1198651c6d |
| 279 | [s1]: https://blockmetry.com/blog/javascript-disabled |
| @@ -390,11 +390,11 @@ | |
| 390 | ``` |
| 391 | |
| 392 | Extending this concept to other text editors is an exercise left to the |
| 393 | reader. |
| 394 | |
| 395 | [fwc]: /help/wiki |
| 396 | [fwt]: ./wikitheory.wiki |
| 397 | |
| 398 | |
| 399 | ### <a id="fedit"></a>The File Editor |
| 400 | |
| @@ -430,11 +430,11 @@ | |
| 430 | When viewing source files, Fossil offers to show line numbers in some |
| 431 | cases. ([Example][mainc].) Toggling them on and off is currently handled |
| 432 | in JavaScript, rather than forcing a page-reload via a button click. |
| 433 | |
| 434 | _Workaround:_ Manually edit the URL to give the “`ln`” query parameter |
| 435 | per [the `/file` docs](/help/www/file). |
| 436 | |
| 437 | _Potential Better Workaround:_ Someone sufficiently interested could |
| 438 | [provide a patch][cg] to add a `<noscript>` wrapped HTML button that |
| 439 | would reload the page with this parameter included/excluded to implement |
| 440 | the toggle via a server round-trip. |
| 441 |
+1
-1
| --- www/json-api/intro.md | ||
| +++ www/json-api/intro.md | ||
| @@ -146,11 +146,11 @@ | ||
| 146 | 146 | up the “payload” area of each HTTP request, so there is no |
| 147 | 147 | reasonable way to include binary data in the JSON message without |
| 148 | 148 | some sort of codec like Base64, for which there is no provision in |
| 149 | 149 | the current JSON API. You will therefore find no JSON API for |
| 150 | 150 | committing changes to a file in the repository, for example. Other |
| 151 | - Fossil APIs such as [`/raw`](/help?cmd=/raw) or | |
| 151 | + Fossil APIs such as [`/raw`](/help/www/raw) or | |
| 152 | 152 | [`/fileedit`](../fileedit-page.md) may serve you better. |
| 153 | 153 | - **64-bit integers:** The JSON standard does not specify integer precision, |
| 154 | 154 | because it targets many different platforms, and not all of |
| 155 | 155 | them can support more than 32 bits. JavaScript (from which JSON |
| 156 | 156 | derives) supports 53 bits of integer precision, which may affect how |
| 157 | 157 |
| --- www/json-api/intro.md | |
| +++ www/json-api/intro.md | |
| @@ -146,11 +146,11 @@ | |
| 146 | up the “payload” area of each HTTP request, so there is no |
| 147 | reasonable way to include binary data in the JSON message without |
| 148 | some sort of codec like Base64, for which there is no provision in |
| 149 | the current JSON API. You will therefore find no JSON API for |
| 150 | committing changes to a file in the repository, for example. Other |
| 151 | Fossil APIs such as [`/raw`](/help?cmd=/raw) or |
| 152 | [`/fileedit`](../fileedit-page.md) may serve you better. |
| 153 | - **64-bit integers:** The JSON standard does not specify integer precision, |
| 154 | because it targets many different platforms, and not all of |
| 155 | them can support more than 32 bits. JavaScript (from which JSON |
| 156 | derives) supports 53 bits of integer precision, which may affect how |
| 157 |
| --- www/json-api/intro.md | |
| +++ www/json-api/intro.md | |
| @@ -146,11 +146,11 @@ | |
| 146 | up the “payload” area of each HTTP request, so there is no |
| 147 | reasonable way to include binary data in the JSON message without |
| 148 | some sort of codec like Base64, for which there is no provision in |
| 149 | the current JSON API. You will therefore find no JSON API for |
| 150 | committing changes to a file in the repository, for example. Other |
| 151 | Fossil APIs such as [`/raw`](/help/www/raw) or |
| 152 | [`/fileedit`](../fileedit-page.md) may serve you better. |
| 153 | - **64-bit integers:** The JSON standard does not specify integer precision, |
| 154 | because it targets many different platforms, and not all of |
| 155 | them can support more than 32 bits. JavaScript (from which JSON |
| 156 | derives) supports 53 bits of integer precision, which may affect how |
| 157 |
+1
-1
| --- www/loadmgmt.md | ||
| +++ www/loadmgmt.md | ||
| @@ -88,9 +88,9 @@ | ||
| 88 | 88 | system that does not support `getloadavg()` and so the load-average |
| 89 | 89 | limiter will not function. |
| 90 | 90 | |
| 91 | 91 | |
| 92 | 92 | [503]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.4 |
| 93 | -[hte]: /help?cmd=/test-env | |
| 93 | +[hte]: /help/www/test-env | |
| 94 | 94 | [gla]: https://linux.die.net/man/3/getloadavg |
| 95 | 95 | [lin]: http://www.linode.com |
| 96 | 96 | [sh]: ./selfhost.wiki |
| 97 | 97 |
| --- www/loadmgmt.md | |
| +++ www/loadmgmt.md | |
| @@ -88,9 +88,9 @@ | |
| 88 | system that does not support `getloadavg()` and so the load-average |
| 89 | limiter will not function. |
| 90 | |
| 91 | |
| 92 | [503]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.4 |
| 93 | [hte]: /help?cmd=/test-env |
| 94 | [gla]: https://linux.die.net/man/3/getloadavg |
| 95 | [lin]: http://www.linode.com |
| 96 | [sh]: ./selfhost.wiki |
| 97 |
| --- www/loadmgmt.md | |
| +++ www/loadmgmt.md | |
| @@ -88,9 +88,9 @@ | |
| 88 | system that does not support `getloadavg()` and so the load-average |
| 89 | limiter will not function. |
| 90 | |
| 91 | |
| 92 | [503]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.4 |
| 93 | [hte]: /help/www/test-env |
| 94 | [gla]: https://linux.die.net/man/3/getloadavg |
| 95 | [lin]: http://www.linode.com |
| 96 | [sh]: ./selfhost.wiki |
| 97 |
+4
-4
| --- www/makefile.wiki | ||
| +++ www/makefile.wiki | ||
| @@ -41,11 +41,11 @@ | ||
| 41 | 41 | All three SQLite source files are byte-for-byte copies of files by |
| 42 | 42 | the same name in the |
| 43 | 43 | standard [http://www.sqlite.org/amalgamation.html | amalgamation]. |
| 44 | 44 | The sqlite3.c file implements the database engine. The shell.c file |
| 45 | 45 | implements the command-line shell, which is accessed in fossil using |
| 46 | -the [/help?cmd=sqlite3 | fossil sql] command. | |
| 46 | +the [/help/sqlite3 | fossil sql] command. | |
| 47 | 47 | |
| 48 | 48 | The shell.c command-line shell uses the [https://github.com/antirez/linenoise | |
| 49 | 49 | linenoise] library to implement line editing. linenoise comprises two |
| 50 | 50 | source files which were copied from the upstream repository with only |
| 51 | 51 | very minor portability edits: |
| @@ -72,11 +72,11 @@ | ||
| 72 | 72 | resource files using a small program called: |
| 73 | 73 | |
| 74 | 74 | 12 [/file/tools/mkbuiltin.c | mkbuiltin.c] |
| 75 | 75 | |
| 76 | 76 | Examples of built-in resources include the [/file/src/diff.tcl | diff.tcl] |
| 77 | -script used to implement the --tk option to [/help?cmd=diff| fossil diff], | |
| 77 | +script used to implement the --tk option to [/help/diff| fossil diff], | |
| 78 | 78 | the [/file/src/markdown.md | markdown documentation], and the various |
| 79 | 79 | CSS scripts, headers, and footers used to implement built-in skins. New |
| 80 | 80 | resources files are added to the "extra_files" variable in |
| 81 | 81 | [/file/tools/makemake.tcl | makemake.tcl]. |
| 82 | 82 | |
| @@ -265,15 +265,15 @@ | ||
| 265 | 265 | * -DSQLITE_DEFAULT_FILE_FORMAT=4 |
| 266 | 266 | * -DSQLITE_ENABLE_EXPLAIN_COMMENTS=1 |
| 267 | 267 | |
| 268 | 268 | The first three symbol definitions above are required; the others are merely |
| 269 | 269 | recommended. Extension loading is omitted as a security measure. The dbstat |
| 270 | -virtual table is needed for the [/help?cmd=/repo-tabsize|/repo-tabsize] page. | |
| 270 | +virtual table is needed for the [/help/www/repo-tabsize|/repo-tabsize] page. | |
| 271 | 271 | FTS4 is needed for the search feature. Fossil is single-threaded so mutexing |
| 272 | 272 | is disabled in SQLite as a performance enhancement. The |
| 273 | 273 | SQLITE_ENABLE_EXPLAIN_COMMENTS option makes the output of "EXPLAIN" queries |
| 274 | -in the "[/help?cmd=sqlite3|fossil sql]" command much more readable. | |
| 274 | +in the "[/help/sqlite3|fossil sql]" command much more readable. | |
| 275 | 275 | |
| 276 | 276 | When compiling the shell.c source file, these macros are required: |
| 277 | 277 | |
| 278 | 278 | * -Dmain=sqlite3_main |
| 279 | 279 | * -DSQLITE_OMIT_LOAD_EXTENSION=1 |
| 280 | 280 |
| --- www/makefile.wiki | |
| +++ www/makefile.wiki | |
| @@ -41,11 +41,11 @@ | |
| 41 | All three SQLite source files are byte-for-byte copies of files by |
| 42 | the same name in the |
| 43 | standard [http://www.sqlite.org/amalgamation.html | amalgamation]. |
| 44 | The sqlite3.c file implements the database engine. The shell.c file |
| 45 | implements the command-line shell, which is accessed in fossil using |
| 46 | the [/help?cmd=sqlite3 | fossil sql] command. |
| 47 | |
| 48 | The shell.c command-line shell uses the [https://github.com/antirez/linenoise | |
| 49 | linenoise] library to implement line editing. linenoise comprises two |
| 50 | source files which were copied from the upstream repository with only |
| 51 | very minor portability edits: |
| @@ -72,11 +72,11 @@ | |
| 72 | resource files using a small program called: |
| 73 | |
| 74 | 12 [/file/tools/mkbuiltin.c | mkbuiltin.c] |
| 75 | |
| 76 | Examples of built-in resources include the [/file/src/diff.tcl | diff.tcl] |
| 77 | script used to implement the --tk option to [/help?cmd=diff| fossil diff], |
| 78 | the [/file/src/markdown.md | markdown documentation], and the various |
| 79 | CSS scripts, headers, and footers used to implement built-in skins. New |
| 80 | resources files are added to the "extra_files" variable in |
| 81 | [/file/tools/makemake.tcl | makemake.tcl]. |
| 82 | |
| @@ -265,15 +265,15 @@ | |
| 265 | * -DSQLITE_DEFAULT_FILE_FORMAT=4 |
| 266 | * -DSQLITE_ENABLE_EXPLAIN_COMMENTS=1 |
| 267 | |
| 268 | The first three symbol definitions above are required; the others are merely |
| 269 | recommended. Extension loading is omitted as a security measure. The dbstat |
| 270 | virtual table is needed for the [/help?cmd=/repo-tabsize|/repo-tabsize] page. |
| 271 | FTS4 is needed for the search feature. Fossil is single-threaded so mutexing |
| 272 | is disabled in SQLite as a performance enhancement. The |
| 273 | SQLITE_ENABLE_EXPLAIN_COMMENTS option makes the output of "EXPLAIN" queries |
| 274 | in the "[/help?cmd=sqlite3|fossil sql]" command much more readable. |
| 275 | |
| 276 | When compiling the shell.c source file, these macros are required: |
| 277 | |
| 278 | * -Dmain=sqlite3_main |
| 279 | * -DSQLITE_OMIT_LOAD_EXTENSION=1 |
| 280 |
| --- www/makefile.wiki | |
| +++ www/makefile.wiki | |
| @@ -41,11 +41,11 @@ | |
| 41 | All three SQLite source files are byte-for-byte copies of files by |
| 42 | the same name in the |
| 43 | standard [http://www.sqlite.org/amalgamation.html | amalgamation]. |
| 44 | The sqlite3.c file implements the database engine. The shell.c file |
| 45 | implements the command-line shell, which is accessed in fossil using |
| 46 | the [/help/sqlite3 | fossil sql] command. |
| 47 | |
| 48 | The shell.c command-line shell uses the [https://github.com/antirez/linenoise | |
| 49 | linenoise] library to implement line editing. linenoise comprises two |
| 50 | source files which were copied from the upstream repository with only |
| 51 | very minor portability edits: |
| @@ -72,11 +72,11 @@ | |
| 72 | resource files using a small program called: |
| 73 | |
| 74 | 12 [/file/tools/mkbuiltin.c | mkbuiltin.c] |
| 75 | |
| 76 | Examples of built-in resources include the [/file/src/diff.tcl | diff.tcl] |
| 77 | script used to implement the --tk option to [/help/diff| fossil diff], |
| 78 | the [/file/src/markdown.md | markdown documentation], and the various |
| 79 | CSS scripts, headers, and footers used to implement built-in skins. New |
| 80 | resources files are added to the "extra_files" variable in |
| 81 | [/file/tools/makemake.tcl | makemake.tcl]. |
| 82 | |
| @@ -265,15 +265,15 @@ | |
| 265 | * -DSQLITE_DEFAULT_FILE_FORMAT=4 |
| 266 | * -DSQLITE_ENABLE_EXPLAIN_COMMENTS=1 |
| 267 | |
| 268 | The first three symbol definitions above are required; the others are merely |
| 269 | recommended. Extension loading is omitted as a security measure. The dbstat |
| 270 | virtual table is needed for the [/help/www/repo-tabsize|/repo-tabsize] page. |
| 271 | FTS4 is needed for the search feature. Fossil is single-threaded so mutexing |
| 272 | is disabled in SQLite as a performance enhancement. The |
| 273 | SQLITE_ENABLE_EXPLAIN_COMMENTS option makes the output of "EXPLAIN" queries |
| 274 | in the "[/help/sqlite3|fossil sql]" command much more readable. |
| 275 | |
| 276 | When compiling the shell.c source file, these macros are required: |
| 277 | |
| 278 | * -Dmain=sqlite3_main |
| 279 | * -DSQLITE_OMIT_LOAD_EXTENSION=1 |
| 280 |
+1
-1
| --- www/mdtest/test1.md | ||
| +++ www/mdtest/test1.md | ||
| @@ -31,11 +31,11 @@ | ||
| 31 | 31 | works without the $ROOT prefix. (Though: the $ROOT prefix is required |
| 32 | 32 | for HTML documents.) |
| 33 | 33 | |
| 34 | 34 | * Timeline: [](/timeline) |
| 35 | 35 | |
| 36 | - * Help: [](/help?cmd=help) | |
| 36 | + * Help: [](/help/help) | |
| 37 | 37 | |
| 38 | 38 | * Site-map: [](/sitemap) |
| 39 | 39 | |
| 40 | 40 | ## The Magic $CURRENT Document Version Translation |
| 41 | 41 | |
| 42 | 42 |
| --- www/mdtest/test1.md | |
| +++ www/mdtest/test1.md | |
| @@ -31,11 +31,11 @@ | |
| 31 | works without the $ROOT prefix. (Though: the $ROOT prefix is required |
| 32 | for HTML documents.) |
| 33 | |
| 34 | * Timeline: [](/timeline) |
| 35 | |
| 36 | * Help: [](/help?cmd=help) |
| 37 | |
| 38 | * Site-map: [](/sitemap) |
| 39 | |
| 40 | ## The Magic $CURRENT Document Version Translation |
| 41 | |
| 42 |
| --- www/mdtest/test1.md | |
| +++ www/mdtest/test1.md | |
| @@ -31,11 +31,11 @@ | |
| 31 | works without the $ROOT prefix. (Though: the $ROOT prefix is required |
| 32 | for HTML documents.) |
| 33 | |
| 34 | * Timeline: [](/timeline) |
| 35 | |
| 36 | * Help: [](/help/help) |
| 37 | |
| 38 | * Site-map: [](/sitemap) |
| 39 | |
| 40 | ## The Magic $CURRENT Document Version Translation |
| 41 | |
| 42 |
+1
-1
| --- www/mirrorlimitations.md | ||
| +++ www/mirrorlimitations.md | ||
| @@ -1,8 +1,8 @@ | ||
| 1 | 1 | # Limitations On Git Mirrors |
| 2 | 2 | |
| 3 | -The "<tt>[fossil git export](/help?cmd=git)</tt>" command can be used to | |
| 3 | +The "<tt>[fossil git export](/help/git)</tt>" command can be used to | |
| 4 | 4 | mirror a Fossil repository to Git. |
| 5 | 5 | ([Setup instructions](./mirrortogithub.md) and an |
| 6 | 6 | [example](https://github.com/drhsqlite/fossil-mirror).) |
| 7 | 7 | But the export to Git is not perfect. Some information is lost during |
| 8 | 8 | export due to limitations in Git. This page describes what content of |
| 9 | 9 |
| --- www/mirrorlimitations.md | |
| +++ www/mirrorlimitations.md | |
| @@ -1,8 +1,8 @@ | |
| 1 | # Limitations On Git Mirrors |
| 2 | |
| 3 | The "<tt>[fossil git export](/help?cmd=git)</tt>" command can be used to |
| 4 | mirror a Fossil repository to Git. |
| 5 | ([Setup instructions](./mirrortogithub.md) and an |
| 6 | [example](https://github.com/drhsqlite/fossil-mirror).) |
| 7 | But the export to Git is not perfect. Some information is lost during |
| 8 | export due to limitations in Git. This page describes what content of |
| 9 |
| --- www/mirrorlimitations.md | |
| +++ www/mirrorlimitations.md | |
| @@ -1,8 +1,8 @@ | |
| 1 | # Limitations On Git Mirrors |
| 2 | |
| 3 | The "<tt>[fossil git export](/help/git)</tt>" command can be used to |
| 4 | mirror a Fossil repository to Git. |
| 5 | ([Setup instructions](./mirrortogithub.md) and an |
| 6 | [example](https://github.com/drhsqlite/fossil-mirror).) |
| 7 | But the export to Git is not perfect. Some information is lost during |
| 8 | export due to limitations in Git. This page describes what content of |
| 9 |
+3
-3
| --- www/mirrortogithub.md | ||
| +++ www/mirrortogithub.md | ||
| @@ -130,14 +130,14 @@ | ||
| 130 | 130 | previously imported from Git using the [`--attribute`][attr] option, the |
| 131 | 131 | [`fx_git`][fxgit] table will be queried for correspondent email addresses. |
| 132 | 132 | Only if neither of these methods produce a user specified email will the |
| 133 | 133 | abovementioned generic address be used. |
| 134 | 134 | |
| 135 | -[attr]: /help?cmd=import | |
| 135 | +[attr]: /help/import | |
| 136 | 136 | [fxgit]: ./inout.wiki#fx_git |
| 137 | -[ui]: /help?cmd=ui | |
| 138 | -[usercmd]: /help?cmd=user | |
| 137 | +[ui]: /help/ui | |
| 138 | +[usercmd]: /help/user | |
| 139 | 139 | |
| 140 | 140 | |
| 141 | 141 | ## <a id='ex1'></a>Example GitHub Mirrors |
| 142 | 142 | |
| 143 | 143 | As of this writing (2019-03-16) Fossil’s own repository is mirrored |
| 144 | 144 |
| --- www/mirrortogithub.md | |
| +++ www/mirrortogithub.md | |
| @@ -130,14 +130,14 @@ | |
| 130 | previously imported from Git using the [`--attribute`][attr] option, the |
| 131 | [`fx_git`][fxgit] table will be queried for correspondent email addresses. |
| 132 | Only if neither of these methods produce a user specified email will the |
| 133 | abovementioned generic address be used. |
| 134 | |
| 135 | [attr]: /help?cmd=import |
| 136 | [fxgit]: ./inout.wiki#fx_git |
| 137 | [ui]: /help?cmd=ui |
| 138 | [usercmd]: /help?cmd=user |
| 139 | |
| 140 | |
| 141 | ## <a id='ex1'></a>Example GitHub Mirrors |
| 142 | |
| 143 | As of this writing (2019-03-16) Fossil’s own repository is mirrored |
| 144 |
| --- www/mirrortogithub.md | |
| +++ www/mirrortogithub.md | |
| @@ -130,14 +130,14 @@ | |
| 130 | previously imported from Git using the [`--attribute`][attr] option, the |
| 131 | [`fx_git`][fxgit] table will be queried for correspondent email addresses. |
| 132 | Only if neither of these methods produce a user specified email will the |
| 133 | abovementioned generic address be used. |
| 134 | |
| 135 | [attr]: /help/import |
| 136 | [fxgit]: ./inout.wiki#fx_git |
| 137 | [ui]: /help/ui |
| 138 | [usercmd]: /help/user |
| 139 | |
| 140 | |
| 141 | ## <a id='ex1'></a>Example GitHub Mirrors |
| 142 | |
| 143 | As of this writing (2019-03-16) Fossil’s own repository is mirrored |
| 144 |
+1
-1
| --- www/password.wiki | ||
| +++ www/password.wiki | ||
| @@ -64,11 +64,11 @@ | ||
| 64 | 64 | |
| 65 | 65 | <h2>Web Interface Authentication</h2> |
| 66 | 66 | |
| 67 | 67 | When a user logs into Fossil using the web interface, the login name |
| 68 | 68 | and password are sent in the clear to the server. For most modern fossil |
| 69 | -server setups with [/help?cmd=redirect-to-https|redirect-to-https] enabled, | |
| 69 | +server setups with [/help/redirect-to-https|redirect-to-https] enabled, | |
| 70 | 70 | this will be protected by the |
| 71 | 71 | SSL connection over HTTPS so it cannot be easily viewed. The server then |
| 72 | 72 | hashes the password and compares it against the value stored in USER.PW. |
| 73 | 73 | If they match, the server sets a cookie on the client to record the |
| 74 | 74 | login. This cookie contains a large amount of high-quality randomness |
| 75 | 75 |
| --- www/password.wiki | |
| +++ www/password.wiki | |
| @@ -64,11 +64,11 @@ | |
| 64 | |
| 65 | <h2>Web Interface Authentication</h2> |
| 66 | |
| 67 | When a user logs into Fossil using the web interface, the login name |
| 68 | and password are sent in the clear to the server. For most modern fossil |
| 69 | server setups with [/help?cmd=redirect-to-https|redirect-to-https] enabled, |
| 70 | this will be protected by the |
| 71 | SSL connection over HTTPS so it cannot be easily viewed. The server then |
| 72 | hashes the password and compares it against the value stored in USER.PW. |
| 73 | If they match, the server sets a cookie on the client to record the |
| 74 | login. This cookie contains a large amount of high-quality randomness |
| 75 |
| --- www/password.wiki | |
| +++ www/password.wiki | |
| @@ -64,11 +64,11 @@ | |
| 64 | |
| 65 | <h2>Web Interface Authentication</h2> |
| 66 | |
| 67 | When a user logs into Fossil using the web interface, the login name |
| 68 | and password are sent in the clear to the server. For most modern fossil |
| 69 | server setups with [/help/redirect-to-https|redirect-to-https] enabled, |
| 70 | this will be protected by the |
| 71 | SSL connection over HTTPS so it cannot be easily viewed. The server then |
| 72 | hashes the password and compares it against the value stored in USER.PW. |
| 73 | If they match, the server sets a cookie on the client to record the |
| 74 | login. This cookie contains a large amount of high-quality randomness |
| 75 |
+1
-1
| --- www/patchcmd.md | ||
| +++ www/patchcmd.md | ||
| @@ -1,8 +1,8 @@ | ||
| 1 | 1 | # The "fossil patch" command |
| 2 | 2 | |
| 3 | -The "[fossil patch](/help?cmd=patch)" command is designed to transfer | |
| 3 | +The "[fossil patch](/help/patch)" command is designed to transfer | |
| 4 | 4 | uncommitted changes from one check-out to another, including transfering |
| 5 | 5 | those changes to other machines. |
| 6 | 6 | |
| 7 | 7 | For example, if you are working on a Windows desktop and you want to |
| 8 | 8 | test your changes on a Linux server before you commit, you can use the |
| 9 | 9 |
| --- www/patchcmd.md | |
| +++ www/patchcmd.md | |
| @@ -1,8 +1,8 @@ | |
| 1 | # The "fossil patch" command |
| 2 | |
| 3 | The "[fossil patch](/help?cmd=patch)" command is designed to transfer |
| 4 | uncommitted changes from one check-out to another, including transfering |
| 5 | those changes to other machines. |
| 6 | |
| 7 | For example, if you are working on a Windows desktop and you want to |
| 8 | test your changes on a Linux server before you commit, you can use the |
| 9 |
| --- www/patchcmd.md | |
| +++ www/patchcmd.md | |
| @@ -1,8 +1,8 @@ | |
| 1 | # The "fossil patch" command |
| 2 | |
| 3 | The "[fossil patch](/help/patch)" command is designed to transfer |
| 4 | uncommitted changes from one check-out to another, including transfering |
| 5 | those changes to other machines. |
| 6 | |
| 7 | For example, if you are working on a Windows desktop and you want to |
| 8 | test your changes on a Linux server before you commit, you can use the |
| 9 |
+1
-1
| --- www/private.wiki | ||
| +++ www/private.wiki | ||
| @@ -47,11 +47,11 @@ | ||
| 47 | 47 | To avoid generating a missing artifact |
| 48 | 48 | reference on peer repositories without the private branch, the merge parent |
| 49 | 49 | is not recorded when merging the private branch into a public branch. As a |
| 50 | 50 | consequence, the web UI timeline does not draw a merge line from the private |
| 51 | 51 | merge parent to the public merge child. Moreover, repeat private-to-public |
| 52 | -merge operations (without the [/help?cmd=merge | --force option]) with files | |
| 52 | +merge operations (without the [/help/merge | --force option]) with files | |
| 53 | 53 | added on the private branch may only work once, but later abort with |
| 54 | 54 | "WARNING: no common ancestor for FILE", as the parent-child relationship is |
| 55 | 55 | not recorded. (See the [/doc/trunk/www/branching.wiki | Branching, Forking, |
| 56 | 56 | Merging, and Tagging] document for more information.) |
| 57 | 57 | </div> |
| 58 | 58 |
| --- www/private.wiki | |
| +++ www/private.wiki | |
| @@ -47,11 +47,11 @@ | |
| 47 | To avoid generating a missing artifact |
| 48 | reference on peer repositories without the private branch, the merge parent |
| 49 | is not recorded when merging the private branch into a public branch. As a |
| 50 | consequence, the web UI timeline does not draw a merge line from the private |
| 51 | merge parent to the public merge child. Moreover, repeat private-to-public |
| 52 | merge operations (without the [/help?cmd=merge | --force option]) with files |
| 53 | added on the private branch may only work once, but later abort with |
| 54 | "WARNING: no common ancestor for FILE", as the parent-child relationship is |
| 55 | not recorded. (See the [/doc/trunk/www/branching.wiki | Branching, Forking, |
| 56 | Merging, and Tagging] document for more information.) |
| 57 | </div> |
| 58 |
| --- www/private.wiki | |
| +++ www/private.wiki | |
| @@ -47,11 +47,11 @@ | |
| 47 | To avoid generating a missing artifact |
| 48 | reference on peer repositories without the private branch, the merge parent |
| 49 | is not recorded when merging the private branch into a public branch. As a |
| 50 | consequence, the web UI timeline does not draw a merge line from the private |
| 51 | merge parent to the public merge child. Moreover, repeat private-to-public |
| 52 | merge operations (without the [/help/merge | --force option]) with files |
| 53 | added on the private branch may only work once, but later abort with |
| 54 | "WARNING: no common ancestor for FILE", as the parent-child relationship is |
| 55 | not recorded. (See the [/doc/trunk/www/branching.wiki | Branching, Forking, |
| 56 | Merging, and Tagging] document for more information.) |
| 57 | </div> |
| 58 |
+4
-4
| --- www/quickstart.wiki | ||
| +++ www/quickstart.wiki | ||
| @@ -254,12 +254,12 @@ | ||
| 254 | 254 | |
| 255 | 255 | To see the most recent changes made to the repository by other users, use "fossil timeline" to |
| 256 | 256 | find out the most recent commit, and then "fossil diff" between that commit and the |
| 257 | 257 | current tree: |
| 258 | 258 | |
| 259 | -<pre><b>fossil timeline | |
| 260 | -=== 2021-03-28 === | |
| 259 | +<pre><b><verbatim>fossil timeline | |
| 260 | +=== 2021-03-28 === | |
| 261 | 261 | 03:18:54 [ad75dfa4a0] *CURRENT* Added details to frobnicate command (user: user-one tags: trunk) |
| 262 | 262 | === 2021-03-27 === |
| 263 | 263 | 23:58:05 [ab975c6632] Update README.md. (user: user-two tags: trunk) |
| 264 | 264 | ⋮ |
| 265 | 265 | |
| @@ -269,11 +269,11 @@ | ||
| 269 | 269 | --- frobnicate.c |
| 270 | 270 | +++ frobnicate.c |
| 271 | 271 | @@ -1,10 +1,11 @@ |
| 272 | 272 | +/* made a change to the source file */ |
| 273 | 273 | # Original text |
| 274 | -</b></pre> | |
| 274 | +</verbatim></b></pre> | |
| 275 | 275 | |
| 276 | 276 | "current" is an alias for the checkout version, so the command |
| 277 | 277 | "fossil diff --from ad75dfa4a0 --to ab975c6632" gives identical results. |
| 278 | 278 | |
| 279 | 279 | To commit your changes to a local-only repository: |
| @@ -363,11 +363,11 @@ | ||
| 363 | 363 | as an HTTP server, where the repo DB is on the other side of the HTTP |
| 364 | 364 | server wall, inaccessible by all means other than Fossil's own |
| 365 | 365 | mediation. For this reason, the "localhost bypasses access control" |
| 366 | 366 | policy does <i>not</i> apply to these other interfaces. That is a very |
| 367 | 367 | good thing, since without this difference in policy, it would be unsafe |
| 368 | -to bind a [/help?cmd=server | <b>fossil server</b>] instance to | |
| 368 | +to bind a [/help/server | <b>fossil server</b>] instance to | |
| 369 | 369 | localhost on a high-numbered port and then reverse-proxy it out to the |
| 370 | 370 | world via HTTPS, a practice this author does engage in, with confidence.) |
| 371 | 371 | |
| 372 | 372 | Once you are finished configuring Fossil, you may safely Control-C out |
| 373 | 373 | of the <b>fossil ui</b> command to shut down this privileged |
| 374 | 374 |
| --- www/quickstart.wiki | |
| +++ www/quickstart.wiki | |
| @@ -254,12 +254,12 @@ | |
| 254 | |
| 255 | To see the most recent changes made to the repository by other users, use "fossil timeline" to |
| 256 | find out the most recent commit, and then "fossil diff" between that commit and the |
| 257 | current tree: |
| 258 | |
| 259 | <pre><b>fossil timeline |
| 260 | === 2021-03-28 === |
| 261 | 03:18:54 [ad75dfa4a0] *CURRENT* Added details to frobnicate command (user: user-one tags: trunk) |
| 262 | === 2021-03-27 === |
| 263 | 23:58:05 [ab975c6632] Update README.md. (user: user-two tags: trunk) |
| 264 | ⋮ |
| 265 | |
| @@ -269,11 +269,11 @@ | |
| 269 | --- frobnicate.c |
| 270 | +++ frobnicate.c |
| 271 | @@ -1,10 +1,11 @@ |
| 272 | +/* made a change to the source file */ |
| 273 | # Original text |
| 274 | </b></pre> |
| 275 | |
| 276 | "current" is an alias for the checkout version, so the command |
| 277 | "fossil diff --from ad75dfa4a0 --to ab975c6632" gives identical results. |
| 278 | |
| 279 | To commit your changes to a local-only repository: |
| @@ -363,11 +363,11 @@ | |
| 363 | as an HTTP server, where the repo DB is on the other side of the HTTP |
| 364 | server wall, inaccessible by all means other than Fossil's own |
| 365 | mediation. For this reason, the "localhost bypasses access control" |
| 366 | policy does <i>not</i> apply to these other interfaces. That is a very |
| 367 | good thing, since without this difference in policy, it would be unsafe |
| 368 | to bind a [/help?cmd=server | <b>fossil server</b>] instance to |
| 369 | localhost on a high-numbered port and then reverse-proxy it out to the |
| 370 | world via HTTPS, a practice this author does engage in, with confidence.) |
| 371 | |
| 372 | Once you are finished configuring Fossil, you may safely Control-C out |
| 373 | of the <b>fossil ui</b> command to shut down this privileged |
| 374 |
| --- www/quickstart.wiki | |
| +++ www/quickstart.wiki | |
| @@ -254,12 +254,12 @@ | |
| 254 | |
| 255 | To see the most recent changes made to the repository by other users, use "fossil timeline" to |
| 256 | find out the most recent commit, and then "fossil diff" between that commit and the |
| 257 | current tree: |
| 258 | |
| 259 | <pre><b><verbatim>fossil timeline |
| 260 | === 2021-03-28 === |
| 261 | 03:18:54 [ad75dfa4a0] *CURRENT* Added details to frobnicate command (user: user-one tags: trunk) |
| 262 | === 2021-03-27 === |
| 263 | 23:58:05 [ab975c6632] Update README.md. (user: user-two tags: trunk) |
| 264 | ⋮ |
| 265 | |
| @@ -269,11 +269,11 @@ | |
| 269 | --- frobnicate.c |
| 270 | +++ frobnicate.c |
| 271 | @@ -1,10 +1,11 @@ |
| 272 | +/* made a change to the source file */ |
| 273 | # Original text |
| 274 | </verbatim></b></pre> |
| 275 | |
| 276 | "current" is an alias for the checkout version, so the command |
| 277 | "fossil diff --from ad75dfa4a0 --to ab975c6632" gives identical results. |
| 278 | |
| 279 | To commit your changes to a local-only repository: |
| @@ -363,11 +363,11 @@ | |
| 363 | as an HTTP server, where the repo DB is on the other side of the HTTP |
| 364 | server wall, inaccessible by all means other than Fossil's own |
| 365 | mediation. For this reason, the "localhost bypasses access control" |
| 366 | policy does <i>not</i> apply to these other interfaces. That is a very |
| 367 | good thing, since without this difference in policy, it would be unsafe |
| 368 | to bind a [/help/server | <b>fossil server</b>] instance to |
| 369 | localhost on a high-numbered port and then reverse-proxy it out to the |
| 370 | world via HTTPS, a practice this author does engage in, with confidence.) |
| 371 | |
| 372 | Once you are finished configuring Fossil, you may safely Control-C out |
| 373 | of the <b>fossil ui</b> command to shut down this privileged |
| 374 |
+1
-1
| --- www/rebaseharm.md | ||
| +++ www/rebaseharm.md | ||
| @@ -373,11 +373,11 @@ | ||
| 373 | 373 | developers to be smarter than the original developers! That's a |
| 374 | 374 | beautiful wish, but there's a sharp limit to how far you can carry it. |
| 375 | 375 | Eventually you hit the limits of human brilliance. |
| 376 | 376 | |
| 377 | 377 | When the operation of some bit of code is not obvious, both Fossil and |
| 378 | -Git let you run a [`blame`](/help?cmd=blame) on the code file to get | |
| 378 | +Git let you run a [`blame`](/help/blame) on the code file to get | |
| 379 | 379 | information about each line of code, and from that which check-in last |
| 380 | 380 | touched a given line of code. If you squash the check-ins on a branch |
| 381 | 381 | down to a single check-in, you throw away the information leading up to |
| 382 | 382 | that finished form. Fossil not only preserves the check-ins surrounding |
| 383 | 383 | the one that included the line of code you're trying to understand, its |
| 384 | 384 |
| --- www/rebaseharm.md | |
| +++ www/rebaseharm.md | |
| @@ -373,11 +373,11 @@ | |
| 373 | developers to be smarter than the original developers! That's a |
| 374 | beautiful wish, but there's a sharp limit to how far you can carry it. |
| 375 | Eventually you hit the limits of human brilliance. |
| 376 | |
| 377 | When the operation of some bit of code is not obvious, both Fossil and |
| 378 | Git let you run a [`blame`](/help?cmd=blame) on the code file to get |
| 379 | information about each line of code, and from that which check-in last |
| 380 | touched a given line of code. If you squash the check-ins on a branch |
| 381 | down to a single check-in, you throw away the information leading up to |
| 382 | that finished form. Fossil not only preserves the check-ins surrounding |
| 383 | the one that included the line of code you're trying to understand, its |
| 384 |
| --- www/rebaseharm.md | |
| +++ www/rebaseharm.md | |
| @@ -373,11 +373,11 @@ | |
| 373 | developers to be smarter than the original developers! That's a |
| 374 | beautiful wish, but there's a sharp limit to how far you can carry it. |
| 375 | Eventually you hit the limits of human brilliance. |
| 376 | |
| 377 | When the operation of some bit of code is not obvious, both Fossil and |
| 378 | Git let you run a [`blame`](/help/blame) on the code file to get |
| 379 | information about each line of code, and from that which check-in last |
| 380 | touched a given line of code. If you squash the check-ins on a branch |
| 381 | down to a single check-in, you throw away the information leading up to |
| 382 | that finished form. Fossil not only preserves the check-ins surrounding |
| 383 | the one that included the line of code you're trying to understand, its |
| 384 |
+1
-1
| --- www/selfhost.wiki | ||
| +++ www/selfhost.wiki | ||
| @@ -72,7 +72,7 @@ | ||
| 72 | 72 | |
| 73 | 73 | Server (2) is a |
| 74 | 74 | <a href="http://www.linode.com/">Linode</a> located in Newark, NJ |
| 75 | 75 | and set up just like the canonical server (1) with the addition of a |
| 76 | 76 | cron job for synchronization. The same cron job also runs the |
| 77 | -[/help?cmd=git|fossil git export] command after each sync in order to | |
| 77 | +[/help/git|fossil git export] command after each sync in order to | |
| 78 | 78 | [./mirrortogithub.md#ex1|mirror all changes to GitHub]. |
| 79 | 79 |
| --- www/selfhost.wiki | |
| +++ www/selfhost.wiki | |
| @@ -72,7 +72,7 @@ | |
| 72 | |
| 73 | Server (2) is a |
| 74 | <a href="http://www.linode.com/">Linode</a> located in Newark, NJ |
| 75 | and set up just like the canonical server (1) with the addition of a |
| 76 | cron job for synchronization. The same cron job also runs the |
| 77 | [/help?cmd=git|fossil git export] command after each sync in order to |
| 78 | [./mirrortogithub.md#ex1|mirror all changes to GitHub]. |
| 79 |
| --- www/selfhost.wiki | |
| +++ www/selfhost.wiki | |
| @@ -72,7 +72,7 @@ | |
| 72 | |
| 73 | Server (2) is a |
| 74 | <a href="http://www.linode.com/">Linode</a> located in Newark, NJ |
| 75 | and set up just like the canonical server (1) with the addition of a |
| 76 | cron job for synchronization. The same cron job also runs the |
| 77 | [/help/git|fossil git export] command after each sync in order to |
| 78 | [./mirrortogithub.md#ex1|mirror all changes to GitHub]. |
| 79 |
+7
-7
| --- www/server/index.html | ||
| +++ www/server/index.html | ||
| @@ -38,16 +38,16 @@ | ||
| 38 | 38 | |
| 39 | 39 | |
| 40 | 40 | <h2 id="prep">Repository Prep</h2> |
| 41 | 41 | |
| 42 | 42 | <p>Prior to serving a Fossil repository to others, consider running <a |
| 43 | -href="$ROOT/help?cmd=ui"><tt>fossil ui</tt></a> locally and taking these | |
| 43 | +href="$ROOT/help/ui"><tt>fossil ui</tt></a> locally and taking these | |
| 44 | 44 | minimum recommended preparation steps:</p> |
| 45 | 45 | |
| 46 | 46 | <ol> |
| 47 | 47 | <li><p>Fossil creates only one user in a <a |
| 48 | - href="$ROOT/help?cmd=new">new repository</a> and gives it the <a | |
| 48 | + href="$ROOT/help/new">new repository</a> and gives it the <a | |
| 49 | 49 | href="../caps/admin-v-setup.md#apsu">all-powerful Setup capability</a>. |
| 50 | 50 | The 10-digit random password generated for that user is fairly strong |
| 51 | 51 | against remote attack, even without explicit password guess rate |
| 52 | 52 | limiting, but because that user has so much power, you may want to |
| 53 | 53 | give it a much stronger password under Admin → Users.</a></li> |
| @@ -95,11 +95,11 @@ | ||
| 95 | 95 | |
| 96 | 96 | <p>Most ordinary web servers can <a href="any/cgi.md">run Fossil as a |
| 97 | 97 | CGI script</a>. This method is known to work with Apache, |
| 98 | 98 | <tt>lighttpd</tt>, and <a |
| 99 | 99 | href="any/althttpd.md"><tt>althttpd</tt></a>. The Fossil server |
| 100 | -administrator places a <a href="$ROOT/help?cmd=cgi">short CGI script</a> in | |
| 100 | +administrator places a <a href="$ROOT/help/cgi">short CGI script</a> in | |
| 101 | 101 | the web server's document hierarchy and when a client requests the URL |
| 102 | 102 | that corresponds to that script, Fossil runs and generates the |
| 103 | 103 | response.</p> |
| 104 | 104 | |
| 105 | 105 | <p>CGI is a good choice for merging Fossil into an existing web site, |
| @@ -114,11 +114,11 @@ | ||
| 114 | 114 | href="any/xinetd.md"><tt>xinetd</tt></a>, <a id="stunnel" |
| 115 | 115 | href="any/stunnel.md"><tt>stunnel</tt></a>, <a |
| 116 | 116 | href="macos/service.md"><tt>launchd</tt></a>, and <a |
| 117 | 117 | href="debian/service.md"><tt>systemd</tt></a> |
| 118 | 118 | can be configured to invoke the the |
| 119 | -<a href="$ROOT/help?cmd=http"><tt>fossil http</tt></a> command to handle | |
| 119 | +<a href="$ROOT/help/http"><tt>fossil http</tt></a> command to handle | |
| 120 | 120 | each incoming HTTP request. The "<tt>fossil http</tt>" command reads |
| 121 | 121 | the HTTP request off of standard input, computes an appropriate |
| 122 | 122 | reply, and writes the reply on standard output. There is a separate |
| 123 | 123 | invocation of the "<tt>fossil http</tt>" command for each HTTP request. |
| 124 | 124 | The socket listener daemon takes care of relaying content to and from |
| @@ -127,21 +127,21 @@ | ||
| 127 | 127 | |
| 128 | 128 | <h3 id="standalone">Stand-alone HTTP Server</h3> |
| 129 | 129 | |
| 130 | 130 | <p>This is the <a href="any/none.md">easiest method</a>. |
| 131 | 131 | A stand-alone server uses the |
| 132 | -<a href="$ROOT/help?cmd=server"><tt>fossil server</tt></a> command to run a | |
| 132 | +<a href="$ROOT/help/server"><tt>fossil server</tt></a> command to run a | |
| 133 | 133 | process that listens for incoming HTTP requests on a socket and then |
| 134 | 134 | dispatches a copy of itself to deal with each incoming request. You can |
| 135 | 135 | expose Fossil directly to the clients in this way or you can interpose a |
| 136 | 136 | <a href="https://en.wikipedia.org/wiki/Reverse_proxy">reverse proxy</a> |
| 137 | 137 | layer between the clients and Fossil.</p> |
| 138 | 138 | |
| 139 | 139 | <h3 id="scgi">SCGI</h3> |
| 140 | 140 | |
| 141 | 141 | <p>The Fossil standalone server can also handle <a href="any/scgi.md">SCGI</a>. |
| 142 | -When the <a href="$ROOT/help?cmd=server"><tt>fossil server</tt></a> command is | |
| 142 | +When the <a href="$ROOT/help/server"><tt>fossil server</tt></a> command is | |
| 143 | 143 | run with the extra <tt>--scgi</tt> option, it listens for incoming |
| 144 | 144 | SCGI requests rather than HTTP requests. This allows Fossil to |
| 145 | 145 | respond to requests from web servers <a href="debian/nginx.md">such as |
| 146 | 146 | nginx</a> that don't support CGI. SCGI is a simpler protocol to proxy |
| 147 | 147 | than HTTP, since the HTTP doesn't have to be re-interpreted in terms of |
| @@ -287,11 +287,11 @@ | ||
| 287 | 287 | activating the search feature (Admin → Search) so that visitors can do |
| 288 | 288 | full-text search on your documentation.</p></li> |
| 289 | 289 | |
| 290 | 290 | <li><p>Now that others can be making changes to the repository, |
| 291 | 291 | consider monitoring them via <a href="../alerts.md">email alerts</a> |
| 292 | - or the <a href="$ROOT/help?cmd=/timeline.rss">timeline RSS | |
| 292 | + or the <a href="$ROOT/help/www/timeline.rss">timeline RSS | |
| 293 | 293 | feed</a>.</p></li> |
| 294 | 294 | |
| 295 | 295 | <li><p>Turn on the various logging features.</p></li> |
| 296 | 296 | </ol> |
| 297 | 297 | |
| 298 | 298 |
| --- www/server/index.html | |
| +++ www/server/index.html | |
| @@ -38,16 +38,16 @@ | |
| 38 | |
| 39 | |
| 40 | <h2 id="prep">Repository Prep</h2> |
| 41 | |
| 42 | <p>Prior to serving a Fossil repository to others, consider running <a |
| 43 | href="$ROOT/help?cmd=ui"><tt>fossil ui</tt></a> locally and taking these |
| 44 | minimum recommended preparation steps:</p> |
| 45 | |
| 46 | <ol> |
| 47 | <li><p>Fossil creates only one user in a <a |
| 48 | href="$ROOT/help?cmd=new">new repository</a> and gives it the <a |
| 49 | href="../caps/admin-v-setup.md#apsu">all-powerful Setup capability</a>. |
| 50 | The 10-digit random password generated for that user is fairly strong |
| 51 | against remote attack, even without explicit password guess rate |
| 52 | limiting, but because that user has so much power, you may want to |
| 53 | give it a much stronger password under Admin → Users.</a></li> |
| @@ -95,11 +95,11 @@ | |
| 95 | |
| 96 | <p>Most ordinary web servers can <a href="any/cgi.md">run Fossil as a |
| 97 | CGI script</a>. This method is known to work with Apache, |
| 98 | <tt>lighttpd</tt>, and <a |
| 99 | href="any/althttpd.md"><tt>althttpd</tt></a>. The Fossil server |
| 100 | administrator places a <a href="$ROOT/help?cmd=cgi">short CGI script</a> in |
| 101 | the web server's document hierarchy and when a client requests the URL |
| 102 | that corresponds to that script, Fossil runs and generates the |
| 103 | response.</p> |
| 104 | |
| 105 | <p>CGI is a good choice for merging Fossil into an existing web site, |
| @@ -114,11 +114,11 @@ | |
| 114 | href="any/xinetd.md"><tt>xinetd</tt></a>, <a id="stunnel" |
| 115 | href="any/stunnel.md"><tt>stunnel</tt></a>, <a |
| 116 | href="macos/service.md"><tt>launchd</tt></a>, and <a |
| 117 | href="debian/service.md"><tt>systemd</tt></a> |
| 118 | can be configured to invoke the the |
| 119 | <a href="$ROOT/help?cmd=http"><tt>fossil http</tt></a> command to handle |
| 120 | each incoming HTTP request. The "<tt>fossil http</tt>" command reads |
| 121 | the HTTP request off of standard input, computes an appropriate |
| 122 | reply, and writes the reply on standard output. There is a separate |
| 123 | invocation of the "<tt>fossil http</tt>" command for each HTTP request. |
| 124 | The socket listener daemon takes care of relaying content to and from |
| @@ -127,21 +127,21 @@ | |
| 127 | |
| 128 | <h3 id="standalone">Stand-alone HTTP Server</h3> |
| 129 | |
| 130 | <p>This is the <a href="any/none.md">easiest method</a>. |
| 131 | A stand-alone server uses the |
| 132 | <a href="$ROOT/help?cmd=server"><tt>fossil server</tt></a> command to run a |
| 133 | process that listens for incoming HTTP requests on a socket and then |
| 134 | dispatches a copy of itself to deal with each incoming request. You can |
| 135 | expose Fossil directly to the clients in this way or you can interpose a |
| 136 | <a href="https://en.wikipedia.org/wiki/Reverse_proxy">reverse proxy</a> |
| 137 | layer between the clients and Fossil.</p> |
| 138 | |
| 139 | <h3 id="scgi">SCGI</h3> |
| 140 | |
| 141 | <p>The Fossil standalone server can also handle <a href="any/scgi.md">SCGI</a>. |
| 142 | When the <a href="$ROOT/help?cmd=server"><tt>fossil server</tt></a> command is |
| 143 | run with the extra <tt>--scgi</tt> option, it listens for incoming |
| 144 | SCGI requests rather than HTTP requests. This allows Fossil to |
| 145 | respond to requests from web servers <a href="debian/nginx.md">such as |
| 146 | nginx</a> that don't support CGI. SCGI is a simpler protocol to proxy |
| 147 | than HTTP, since the HTTP doesn't have to be re-interpreted in terms of |
| @@ -287,11 +287,11 @@ | |
| 287 | activating the search feature (Admin → Search) so that visitors can do |
| 288 | full-text search on your documentation.</p></li> |
| 289 | |
| 290 | <li><p>Now that others can be making changes to the repository, |
| 291 | consider monitoring them via <a href="../alerts.md">email alerts</a> |
| 292 | or the <a href="$ROOT/help?cmd=/timeline.rss">timeline RSS |
| 293 | feed</a>.</p></li> |
| 294 | |
| 295 | <li><p>Turn on the various logging features.</p></li> |
| 296 | </ol> |
| 297 | |
| 298 |
| --- www/server/index.html | |
| +++ www/server/index.html | |
| @@ -38,16 +38,16 @@ | |
| 38 | |
| 39 | |
| 40 | <h2 id="prep">Repository Prep</h2> |
| 41 | |
| 42 | <p>Prior to serving a Fossil repository to others, consider running <a |
| 43 | href="$ROOT/help/ui"><tt>fossil ui</tt></a> locally and taking these |
| 44 | minimum recommended preparation steps:</p> |
| 45 | |
| 46 | <ol> |
| 47 | <li><p>Fossil creates only one user in a <a |
| 48 | href="$ROOT/help/new">new repository</a> and gives it the <a |
| 49 | href="../caps/admin-v-setup.md#apsu">all-powerful Setup capability</a>. |
| 50 | The 10-digit random password generated for that user is fairly strong |
| 51 | against remote attack, even without explicit password guess rate |
| 52 | limiting, but because that user has so much power, you may want to |
| 53 | give it a much stronger password under Admin → Users.</a></li> |
| @@ -95,11 +95,11 @@ | |
| 95 | |
| 96 | <p>Most ordinary web servers can <a href="any/cgi.md">run Fossil as a |
| 97 | CGI script</a>. This method is known to work with Apache, |
| 98 | <tt>lighttpd</tt>, and <a |
| 99 | href="any/althttpd.md"><tt>althttpd</tt></a>. The Fossil server |
| 100 | administrator places a <a href="$ROOT/help/cgi">short CGI script</a> in |
| 101 | the web server's document hierarchy and when a client requests the URL |
| 102 | that corresponds to that script, Fossil runs and generates the |
| 103 | response.</p> |
| 104 | |
| 105 | <p>CGI is a good choice for merging Fossil into an existing web site, |
| @@ -114,11 +114,11 @@ | |
| 114 | href="any/xinetd.md"><tt>xinetd</tt></a>, <a id="stunnel" |
| 115 | href="any/stunnel.md"><tt>stunnel</tt></a>, <a |
| 116 | href="macos/service.md"><tt>launchd</tt></a>, and <a |
| 117 | href="debian/service.md"><tt>systemd</tt></a> |
| 118 | can be configured to invoke the the |
| 119 | <a href="$ROOT/help/http"><tt>fossil http</tt></a> command to handle |
| 120 | each incoming HTTP request. The "<tt>fossil http</tt>" command reads |
| 121 | the HTTP request off of standard input, computes an appropriate |
| 122 | reply, and writes the reply on standard output. There is a separate |
| 123 | invocation of the "<tt>fossil http</tt>" command for each HTTP request. |
| 124 | The socket listener daemon takes care of relaying content to and from |
| @@ -127,21 +127,21 @@ | |
| 127 | |
| 128 | <h3 id="standalone">Stand-alone HTTP Server</h3> |
| 129 | |
| 130 | <p>This is the <a href="any/none.md">easiest method</a>. |
| 131 | A stand-alone server uses the |
| 132 | <a href="$ROOT/help/server"><tt>fossil server</tt></a> command to run a |
| 133 | process that listens for incoming HTTP requests on a socket and then |
| 134 | dispatches a copy of itself to deal with each incoming request. You can |
| 135 | expose Fossil directly to the clients in this way or you can interpose a |
| 136 | <a href="https://en.wikipedia.org/wiki/Reverse_proxy">reverse proxy</a> |
| 137 | layer between the clients and Fossil.</p> |
| 138 | |
| 139 | <h3 id="scgi">SCGI</h3> |
| 140 | |
| 141 | <p>The Fossil standalone server can also handle <a href="any/scgi.md">SCGI</a>. |
| 142 | When the <a href="$ROOT/help/server"><tt>fossil server</tt></a> command is |
| 143 | run with the extra <tt>--scgi</tt> option, it listens for incoming |
| 144 | SCGI requests rather than HTTP requests. This allows Fossil to |
| 145 | respond to requests from web servers <a href="debian/nginx.md">such as |
| 146 | nginx</a> that don't support CGI. SCGI is a simpler protocol to proxy |
| 147 | than HTTP, since the HTTP doesn't have to be re-interpreted in terms of |
| @@ -287,11 +287,11 @@ | |
| 287 | activating the search feature (Admin → Search) so that visitors can do |
| 288 | full-text search on your documentation.</p></li> |
| 289 | |
| 290 | <li><p>Now that others can be making changes to the repository, |
| 291 | consider monitoring them via <a href="../alerts.md">email alerts</a> |
| 292 | or the <a href="$ROOT/help/www/timeline.rss">timeline RSS |
| 293 | feed</a>.</p></li> |
| 294 | |
| 295 | <li><p>Turn on the various logging features.</p></li> |
| 296 | </ol> |
| 297 | |
| 298 |
+2
-2
| --- www/server/windows/service.md | ||
| +++ www/server/windows/service.md | ||
| @@ -62,11 +62,11 @@ | ||
| 62 | 62 | fossil.exe process is unable to use the directory normally during a scan. |
| 63 | 63 | |
| 64 | 64 | ### <a id='PowerShell'></a>Advanced service installation using PowerShell |
| 65 | 65 | |
| 66 | 66 | As great as `fossil winsrv` is, it does not have one to one reflection of all of |
| 67 | -the `fossil server` [options](/help?cmd=server). When you need to use some of | |
| 67 | +the `fossil server` [options](/help/server). When you need to use some of | |
| 68 | 68 | the more advanced options, such as `--https`, `--skin`, or `--extroot`, you will |
| 69 | 69 | need to use PowerShell to configure and install the Windows service. |
| 70 | 70 | |
| 71 | 71 | PowerShell provides the [New-Service](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.management/new-service?view=powershell-5.1) |
| 72 | 72 | command, which we can use to install and configure Fossil as a service. The |
| @@ -81,11 +81,11 @@ | ||
| 81 | 81 | Windows will accept either back slashes or forward slashes in path names, but |
| 82 | 82 | Fossil has a preference for forward slashes. The use of `--repolist` will make |
| 83 | 83 | this a multiple repository server. If you want to serve only a single |
| 84 | 84 | repository, then leave off the `--repolist` parameter and provide the full path |
| 85 | 85 | to the proper repository file. Other options are listed in the |
| 86 | -[fossil server](/help?cmd=server) documentation. | |
| 86 | +[fossil server](/help/server) documentation. | |
| 87 | 87 | |
| 88 | 88 | The service will be installed by default to use the Local Service account. |
| 89 | 89 | Since Fossil only needs access to local files, this is fine and causes no |
| 90 | 90 | issues. The service will not be running once installed. You will need to start |
| 91 | 91 | it to proceed (the `-StartupType Automatic` parameter to `New-Service` will |
| 92 | 92 |
| --- www/server/windows/service.md | |
| +++ www/server/windows/service.md | |
| @@ -62,11 +62,11 @@ | |
| 62 | fossil.exe process is unable to use the directory normally during a scan. |
| 63 | |
| 64 | ### <a id='PowerShell'></a>Advanced service installation using PowerShell |
| 65 | |
| 66 | As great as `fossil winsrv` is, it does not have one to one reflection of all of |
| 67 | the `fossil server` [options](/help?cmd=server). When you need to use some of |
| 68 | the more advanced options, such as `--https`, `--skin`, or `--extroot`, you will |
| 69 | need to use PowerShell to configure and install the Windows service. |
| 70 | |
| 71 | PowerShell provides the [New-Service](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.management/new-service?view=powershell-5.1) |
| 72 | command, which we can use to install and configure Fossil as a service. The |
| @@ -81,11 +81,11 @@ | |
| 81 | Windows will accept either back slashes or forward slashes in path names, but |
| 82 | Fossil has a preference for forward slashes. The use of `--repolist` will make |
| 83 | this a multiple repository server. If you want to serve only a single |
| 84 | repository, then leave off the `--repolist` parameter and provide the full path |
| 85 | to the proper repository file. Other options are listed in the |
| 86 | [fossil server](/help?cmd=server) documentation. |
| 87 | |
| 88 | The service will be installed by default to use the Local Service account. |
| 89 | Since Fossil only needs access to local files, this is fine and causes no |
| 90 | issues. The service will not be running once installed. You will need to start |
| 91 | it to proceed (the `-StartupType Automatic` parameter to `New-Service` will |
| 92 |
| --- www/server/windows/service.md | |
| +++ www/server/windows/service.md | |
| @@ -62,11 +62,11 @@ | |
| 62 | fossil.exe process is unable to use the directory normally during a scan. |
| 63 | |
| 64 | ### <a id='PowerShell'></a>Advanced service installation using PowerShell |
| 65 | |
| 66 | As great as `fossil winsrv` is, it does not have one to one reflection of all of |
| 67 | the `fossil server` [options](/help/server). When you need to use some of |
| 68 | the more advanced options, such as `--https`, `--skin`, or `--extroot`, you will |
| 69 | need to use PowerShell to configure and install the Windows service. |
| 70 | |
| 71 | PowerShell provides the [New-Service](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.management/new-service?view=powershell-5.1) |
| 72 | command, which we can use to install and configure Fossil as a service. The |
| @@ -81,11 +81,11 @@ | |
| 81 | Windows will accept either back slashes or forward slashes in path names, but |
| 82 | Fossil has a preference for forward slashes. The use of `--repolist` will make |
| 83 | this a multiple repository server. If you want to serve only a single |
| 84 | repository, then leave off the `--repolist` parameter and provide the full path |
| 85 | to the proper repository file. Other options are listed in the |
| 86 | [fossil server](/help/server) documentation. |
| 87 | |
| 88 | The service will be installed by default to use the Local Service account. |
| 89 | Since Fossil only needs access to local files, this is fine and causes no |
| 90 | issues. The service will not be running once installed. You will need to start |
| 91 | it to proceed (the `-StartupType Automatic` parameter to `New-Service` will |
| 92 |
+2
-2
| --- www/serverext.wiki | ||
| +++ www/serverext.wiki | ||
| @@ -49,11 +49,11 @@ | ||
| 49 | 49 | <pre> |
| 50 | 50 | https://example-project.org/ext/<i>FILENAME</i> |
| 51 | 51 | </pre> |
| 52 | 52 | |
| 53 | 53 | In other words, access files in DOCUMENT_ROOT by appending the filename |
| 54 | -relative to DOCUMENT_ROOT to the [/help?cmd=/ext|/ext] | |
| 54 | +relative to DOCUMENT_ROOT to the [/help/www/ext|/ext] | |
| 55 | 55 | page of the Fossil server. |
| 56 | 56 | |
| 57 | 57 | * Files that are readable but not executable are returned as static |
| 58 | 58 | content. |
| 59 | 59 | |
| @@ -124,11 +124,11 @@ | ||
| 124 | 124 | of its own source-code, so you can see how it works. |
| 125 | 125 | |
| 126 | 126 | <h3>2.3 Example #3</h3> |
| 127 | 127 | |
| 128 | 128 | For Fossil versions dated 2025-03-23 and later, the "--extpage FILENAME" |
| 129 | -option to the [/help?cmd=ui|fossil ui] command is a short cut that treats | |
| 129 | +option to the [/help/ui|fossil ui] command is a short cut that treats | |
| 130 | 130 | FILENAME as a CGI extension. When the ui command starts up a new web browser |
| 131 | 131 | pages, it points that page to the FILENAME extension. So if FILENAME is |
| 132 | 132 | a static content file (such as an HTML file or |
| 133 | 133 | [/md_rules|Markdown] or [/wiki_rules|Wiki] document), then the |
| 134 | 134 | rendered content of the file is displayed. Meanwhile, the user can be |
| 135 | 135 |
| --- www/serverext.wiki | |
| +++ www/serverext.wiki | |
| @@ -49,11 +49,11 @@ | |
| 49 | <pre> |
| 50 | https://example-project.org/ext/<i>FILENAME</i> |
| 51 | </pre> |
| 52 | |
| 53 | In other words, access files in DOCUMENT_ROOT by appending the filename |
| 54 | relative to DOCUMENT_ROOT to the [/help?cmd=/ext|/ext] |
| 55 | page of the Fossil server. |
| 56 | |
| 57 | * Files that are readable but not executable are returned as static |
| 58 | content. |
| 59 | |
| @@ -124,11 +124,11 @@ | |
| 124 | of its own source-code, so you can see how it works. |
| 125 | |
| 126 | <h3>2.3 Example #3</h3> |
| 127 | |
| 128 | For Fossil versions dated 2025-03-23 and later, the "--extpage FILENAME" |
| 129 | option to the [/help?cmd=ui|fossil ui] command is a short cut that treats |
| 130 | FILENAME as a CGI extension. When the ui command starts up a new web browser |
| 131 | pages, it points that page to the FILENAME extension. So if FILENAME is |
| 132 | a static content file (such as an HTML file or |
| 133 | [/md_rules|Markdown] or [/wiki_rules|Wiki] document), then the |
| 134 | rendered content of the file is displayed. Meanwhile, the user can be |
| 135 |
| --- www/serverext.wiki | |
| +++ www/serverext.wiki | |
| @@ -49,11 +49,11 @@ | |
| 49 | <pre> |
| 50 | https://example-project.org/ext/<i>FILENAME</i> |
| 51 | </pre> |
| 52 | |
| 53 | In other words, access files in DOCUMENT_ROOT by appending the filename |
| 54 | relative to DOCUMENT_ROOT to the [/help/www/ext|/ext] |
| 55 | page of the Fossil server. |
| 56 | |
| 57 | * Files that are readable but not executable are returned as static |
| 58 | content. |
| 59 | |
| @@ -124,11 +124,11 @@ | |
| 124 | of its own source-code, so you can see how it works. |
| 125 | |
| 126 | <h3>2.3 Example #3</h3> |
| 127 | |
| 128 | For Fossil versions dated 2025-03-23 and later, the "--extpage FILENAME" |
| 129 | option to the [/help/ui|fossil ui] command is a short cut that treats |
| 130 | FILENAME as a CGI extension. When the ui command starts up a new web browser |
| 131 | pages, it points that page to the FILENAME extension. So if FILENAME is |
| 132 | a static content file (such as an HTML file or |
| 133 | [/md_rules|Markdown] or [/wiki_rules|Wiki] document), then the |
| 134 | rendered content of the file is displayed. Meanwhile, the user can be |
| 135 |
+8
-8
| --- www/ssl-server.md | ||
| +++ www/ssl-server.md | ||
| @@ -1,13 +1,13 @@ | ||
| 1 | 1 | # SSL/TLS Server Mode |
| 2 | 2 | |
| 3 | 3 | ## History |
| 4 | 4 | |
| 5 | 5 | Fossil has supported [client-side SSL/TLS][0] since [2010][1]. This means |
| 6 | -that commands like "[fossil sync](/help?cmd=sync)" could use SSL/TLS when | |
| 6 | +that commands like "[fossil sync](/help/sync)" could use SSL/TLS when | |
| 7 | 7 | contacting a server. But on the server side, commands like |
| 8 | -"[fossil server](/help?cmd=server)" operated in clear-text only. To implement | |
| 8 | +"[fossil server](/help/server)" operated in clear-text only. To implement | |
| 9 | 9 | an encrypted server, you had to put Fossil behind a web server or reverse |
| 10 | 10 | proxy that handled the SSL/TLS decryption/encryption and passed cleartext |
| 11 | 11 | down to Fossil. |
| 12 | 12 | |
| 13 | 13 | [0]: ./ssl.wiki |
| @@ -14,13 +14,13 @@ | ||
| 14 | 14 | [1]: /timeline?c=b05cb4a0e15d0712&y=ci&n=13 |
| 15 | 15 | |
| 16 | 16 | Beginning in [late December 2021](/timeline?c=f6263bb64195b07f&y=a&n=13), |
| 17 | 17 | Fossil servers are now able to converse directly over TLS. Commands like |
| 18 | 18 | |
| 19 | - * "[fossil server](/help?cmd=server)" | |
| 20 | - * "[fossil ui](/help?cmd=ui)", and | |
| 21 | - * "[fossil http](/help?cmd=http)" | |
| 19 | + * "[fossil server](/help/server)" | |
| 20 | + * "[fossil ui](/help/ui)", and | |
| 21 | + * "[fossil http](/help/http)" | |
| 22 | 22 | |
| 23 | 23 | may now handle the encryption natively when suitably configured, without |
| 24 | 24 | requiring a third-party proxy layer. |
| 25 | 25 | |
| 26 | 26 | ## <a id="usage"></a>Usage |
| @@ -135,11 +135,11 @@ | ||
| 135 | 135 | individual components will still be easily accessible. |
| 136 | 136 | |
| 137 | 137 | ### <a id="cat"></a>Separate or Concatenated? |
| 138 | 138 | |
| 139 | 139 | Given a single concatenated file that holds both your private key and your |
| 140 | -cert, you can hand it off to the "[fossil server](/help?cmd=server)" | |
| 140 | +cert, you can hand it off to the "[fossil server](/help/server)" | |
| 141 | 141 | command using the `--cert` option, like this: |
| 142 | 142 | |
| 143 | 143 | fossil server --port 443 --cert mycert.pem /home/www/myproject.fossil |
| 144 | 144 | |
| 145 | 145 | The command above is sufficient to run a fully-encrypted web site for |
| @@ -257,12 +257,12 @@ | ||
| 257 | 257 | domain control. ACME’s design precludes replay attacks. |
| 258 | 258 | |
| 259 | 259 | In order for all of this to happen, certbot needs to be able to create |
| 260 | 260 | a subdirectory named ".well-known", within a directory you specify, |
| 261 | 261 | then populate that subdirectory with a token file of some kind. To support |
| 262 | -this, the "[fossil server](/help?cmd=server)" and | |
| 263 | -"[fossil http](/help?cmd=http)" commands have the --acme option. | |
| 262 | +this, the "[fossil server](/help/server)" and | |
| 263 | +"[fossil http](/help/http)" commands have the --acme option. | |
| 264 | 264 | |
| 265 | 265 | When specified, Fossil sees a URL where the path |
| 266 | 266 | begins with ".well-known", then instead of doing its normal processing, it |
| 267 | 267 | looks for a file with that pathname and returns it to the client. If |
| 268 | 268 | the "server" or "http" command is referencing a single Fossil repository, |
| 269 | 269 |
| --- www/ssl-server.md | |
| +++ www/ssl-server.md | |
| @@ -1,13 +1,13 @@ | |
| 1 | # SSL/TLS Server Mode |
| 2 | |
| 3 | ## History |
| 4 | |
| 5 | Fossil has supported [client-side SSL/TLS][0] since [2010][1]. This means |
| 6 | that commands like "[fossil sync](/help?cmd=sync)" could use SSL/TLS when |
| 7 | contacting a server. But on the server side, commands like |
| 8 | "[fossil server](/help?cmd=server)" operated in clear-text only. To implement |
| 9 | an encrypted server, you had to put Fossil behind a web server or reverse |
| 10 | proxy that handled the SSL/TLS decryption/encryption and passed cleartext |
| 11 | down to Fossil. |
| 12 | |
| 13 | [0]: ./ssl.wiki |
| @@ -14,13 +14,13 @@ | |
| 14 | [1]: /timeline?c=b05cb4a0e15d0712&y=ci&n=13 |
| 15 | |
| 16 | Beginning in [late December 2021](/timeline?c=f6263bb64195b07f&y=a&n=13), |
| 17 | Fossil servers are now able to converse directly over TLS. Commands like |
| 18 | |
| 19 | * "[fossil server](/help?cmd=server)" |
| 20 | * "[fossil ui](/help?cmd=ui)", and |
| 21 | * "[fossil http](/help?cmd=http)" |
| 22 | |
| 23 | may now handle the encryption natively when suitably configured, without |
| 24 | requiring a third-party proxy layer. |
| 25 | |
| 26 | ## <a id="usage"></a>Usage |
| @@ -135,11 +135,11 @@ | |
| 135 | individual components will still be easily accessible. |
| 136 | |
| 137 | ### <a id="cat"></a>Separate or Concatenated? |
| 138 | |
| 139 | Given a single concatenated file that holds both your private key and your |
| 140 | cert, you can hand it off to the "[fossil server](/help?cmd=server)" |
| 141 | command using the `--cert` option, like this: |
| 142 | |
| 143 | fossil server --port 443 --cert mycert.pem /home/www/myproject.fossil |
| 144 | |
| 145 | The command above is sufficient to run a fully-encrypted web site for |
| @@ -257,12 +257,12 @@ | |
| 257 | domain control. ACME’s design precludes replay attacks. |
| 258 | |
| 259 | In order for all of this to happen, certbot needs to be able to create |
| 260 | a subdirectory named ".well-known", within a directory you specify, |
| 261 | then populate that subdirectory with a token file of some kind. To support |
| 262 | this, the "[fossil server](/help?cmd=server)" and |
| 263 | "[fossil http](/help?cmd=http)" commands have the --acme option. |
| 264 | |
| 265 | When specified, Fossil sees a URL where the path |
| 266 | begins with ".well-known", then instead of doing its normal processing, it |
| 267 | looks for a file with that pathname and returns it to the client. If |
| 268 | the "server" or "http" command is referencing a single Fossil repository, |
| 269 |
| --- www/ssl-server.md | |
| +++ www/ssl-server.md | |
| @@ -1,13 +1,13 @@ | |
| 1 | # SSL/TLS Server Mode |
| 2 | |
| 3 | ## History |
| 4 | |
| 5 | Fossil has supported [client-side SSL/TLS][0] since [2010][1]. This means |
| 6 | that commands like "[fossil sync](/help/sync)" could use SSL/TLS when |
| 7 | contacting a server. But on the server side, commands like |
| 8 | "[fossil server](/help/server)" operated in clear-text only. To implement |
| 9 | an encrypted server, you had to put Fossil behind a web server or reverse |
| 10 | proxy that handled the SSL/TLS decryption/encryption and passed cleartext |
| 11 | down to Fossil. |
| 12 | |
| 13 | [0]: ./ssl.wiki |
| @@ -14,13 +14,13 @@ | |
| 14 | [1]: /timeline?c=b05cb4a0e15d0712&y=ci&n=13 |
| 15 | |
| 16 | Beginning in [late December 2021](/timeline?c=f6263bb64195b07f&y=a&n=13), |
| 17 | Fossil servers are now able to converse directly over TLS. Commands like |
| 18 | |
| 19 | * "[fossil server](/help/server)" |
| 20 | * "[fossil ui](/help/ui)", and |
| 21 | * "[fossil http](/help/http)" |
| 22 | |
| 23 | may now handle the encryption natively when suitably configured, without |
| 24 | requiring a third-party proxy layer. |
| 25 | |
| 26 | ## <a id="usage"></a>Usage |
| @@ -135,11 +135,11 @@ | |
| 135 | individual components will still be easily accessible. |
| 136 | |
| 137 | ### <a id="cat"></a>Separate or Concatenated? |
| 138 | |
| 139 | Given a single concatenated file that holds both your private key and your |
| 140 | cert, you can hand it off to the "[fossil server](/help/server)" |
| 141 | command using the `--cert` option, like this: |
| 142 | |
| 143 | fossil server --port 443 --cert mycert.pem /home/www/myproject.fossil |
| 144 | |
| 145 | The command above is sufficient to run a fully-encrypted web site for |
| @@ -257,12 +257,12 @@ | |
| 257 | domain control. ACME’s design precludes replay attacks. |
| 258 | |
| 259 | In order for all of this to happen, certbot needs to be able to create |
| 260 | a subdirectory named ".well-known", within a directory you specify, |
| 261 | then populate that subdirectory with a token file of some kind. To support |
| 262 | this, the "[fossil server](/help/server)" and |
| 263 | "[fossil http](/help/http)" commands have the --acme option. |
| 264 | |
| 265 | When specified, Fossil sees a URL where the path |
| 266 | begins with ".well-known", then instead of doing its normal processing, it |
| 267 | looks for a file with that pathname and returns it to the client. If |
| 268 | the "server" or "http" command is referencing a single Fossil repository, |
| 269 |
+7
-7
| --- www/sync.wiki | ||
| +++ www/sync.wiki | ||
| @@ -24,15 +24,15 @@ | ||
| 24 | 24 | |
| 25 | 25 | Each repository also has local state. The local state determines |
| 26 | 26 | the web-page formatting preferences, authorized users, ticket formats, |
| 27 | 27 | and similar information that varies from one repository to another. |
| 28 | 28 | The local state is not usually transferred during a sync. Except, |
| 29 | -some local state is transferred during a [/help?cmd=clone|clone] | |
| 29 | +some local state is transferred during a [/help/clone|clone] | |
| 30 | 30 | in order to initialize the local state of the new repository. Also, |
| 31 | 31 | an administrator can sync local state using |
| 32 | -the [/help?cmd=configuration|config push] and | |
| 33 | -[/help?cmd=configuration|config pull] | |
| 32 | +the [/help/configuration|config push] and | |
| 33 | +[/help/configuration|config pull] | |
| 34 | 34 | commands. |
| 35 | 35 | |
| 36 | 36 | <h3 id="crdt">1.1 Conflict-Free Replicated Datatypes</h3> |
| 37 | 37 | |
| 38 | 38 | The "bag of artifacts" data model used by Fossil is apparently an |
| @@ -56,23 +56,23 @@ | ||
| 56 | 56 | The server is listening for incoming HTTP requests. The client |
| 57 | 57 | issues one or more HTTP requests and receives replies for each |
| 58 | 58 | request. |
| 59 | 59 | |
| 60 | 60 | The server might be running as an independent server |
| 61 | -using the [/help?cmd=server|"fossil server" command], or it | |
| 61 | +using the [/help/server|"fossil server" command], or it | |
| 62 | 62 | might be launched from inetd or xinetd using the |
| 63 | -[/help?cmd=http|"fossil http" command]. Or the server might | |
| 63 | +[/help/http|"fossil http" command]. Or the server might | |
| 64 | 64 | be [./server/any/cgi.md|launched from CGI] or from |
| 65 | 65 | [./server/any/scgi.md|SCGI]. |
| 66 | 66 | (See "[./server/|How To Configure A Fossil Server]" for details.) |
| 67 | 67 | The specifics of how the server listens |
| 68 | 68 | for incoming HTTP requests is immaterial to this protocol. |
| 69 | 69 | The important point is that the server is listening for requests and |
| 70 | 70 | the client is the issuer of the requests. |
| 71 | 71 | |
| 72 | -A single [/help?cmd=push|push], | |
| 73 | -[/help?cmd=pull|pull], or [/help?cmd=sync|sync] | |
| 72 | +A single [/help/push|push], | |
| 73 | +[/help/pull|pull], or [/help?cmd=sync|sync] | |
| 74 | 74 | might involve multiple HTTP requests. |
| 75 | 75 | The client maintains state between all requests. But on the server |
| 76 | 76 | side, each request is independent. The server does not preserve |
| 77 | 77 | any information about the client from one request to the next. |
| 78 | 78 | |
| 79 | 79 |
| --- www/sync.wiki | |
| +++ www/sync.wiki | |
| @@ -24,15 +24,15 @@ | |
| 24 | |
| 25 | Each repository also has local state. The local state determines |
| 26 | the web-page formatting preferences, authorized users, ticket formats, |
| 27 | and similar information that varies from one repository to another. |
| 28 | The local state is not usually transferred during a sync. Except, |
| 29 | some local state is transferred during a [/help?cmd=clone|clone] |
| 30 | in order to initialize the local state of the new repository. Also, |
| 31 | an administrator can sync local state using |
| 32 | the [/help?cmd=configuration|config push] and |
| 33 | [/help?cmd=configuration|config pull] |
| 34 | commands. |
| 35 | |
| 36 | <h3 id="crdt">1.1 Conflict-Free Replicated Datatypes</h3> |
| 37 | |
| 38 | The "bag of artifacts" data model used by Fossil is apparently an |
| @@ -56,23 +56,23 @@ | |
| 56 | The server is listening for incoming HTTP requests. The client |
| 57 | issues one or more HTTP requests and receives replies for each |
| 58 | request. |
| 59 | |
| 60 | The server might be running as an independent server |
| 61 | using the [/help?cmd=server|"fossil server" command], or it |
| 62 | might be launched from inetd or xinetd using the |
| 63 | [/help?cmd=http|"fossil http" command]. Or the server might |
| 64 | be [./server/any/cgi.md|launched from CGI] or from |
| 65 | [./server/any/scgi.md|SCGI]. |
| 66 | (See "[./server/|How To Configure A Fossil Server]" for details.) |
| 67 | The specifics of how the server listens |
| 68 | for incoming HTTP requests is immaterial to this protocol. |
| 69 | The important point is that the server is listening for requests and |
| 70 | the client is the issuer of the requests. |
| 71 | |
| 72 | A single [/help?cmd=push|push], |
| 73 | [/help?cmd=pull|pull], or [/help?cmd=sync|sync] |
| 74 | might involve multiple HTTP requests. |
| 75 | The client maintains state between all requests. But on the server |
| 76 | side, each request is independent. The server does not preserve |
| 77 | any information about the client from one request to the next. |
| 78 | |
| 79 |
| --- www/sync.wiki | |
| +++ www/sync.wiki | |
| @@ -24,15 +24,15 @@ | |
| 24 | |
| 25 | Each repository also has local state. The local state determines |
| 26 | the web-page formatting preferences, authorized users, ticket formats, |
| 27 | and similar information that varies from one repository to another. |
| 28 | The local state is not usually transferred during a sync. Except, |
| 29 | some local state is transferred during a [/help/clone|clone] |
| 30 | in order to initialize the local state of the new repository. Also, |
| 31 | an administrator can sync local state using |
| 32 | the [/help/configuration|config push] and |
| 33 | [/help/configuration|config pull] |
| 34 | commands. |
| 35 | |
| 36 | <h3 id="crdt">1.1 Conflict-Free Replicated Datatypes</h3> |
| 37 | |
| 38 | The "bag of artifacts" data model used by Fossil is apparently an |
| @@ -56,23 +56,23 @@ | |
| 56 | The server is listening for incoming HTTP requests. The client |
| 57 | issues one or more HTTP requests and receives replies for each |
| 58 | request. |
| 59 | |
| 60 | The server might be running as an independent server |
| 61 | using the [/help/server|"fossil server" command], or it |
| 62 | might be launched from inetd or xinetd using the |
| 63 | [/help/http|"fossil http" command]. Or the server might |
| 64 | be [./server/any/cgi.md|launched from CGI] or from |
| 65 | [./server/any/scgi.md|SCGI]. |
| 66 | (See "[./server/|How To Configure A Fossil Server]" for details.) |
| 67 | The specifics of how the server listens |
| 68 | for incoming HTTP requests is immaterial to this protocol. |
| 69 | The important point is that the server is listening for requests and |
| 70 | the client is the issuer of the requests. |
| 71 | |
| 72 | A single [/help/push|push], |
| 73 | [/help/pull|pull], or [/help?cmd=sync|sync] |
| 74 | might involve multiple HTTP requests. |
| 75 | The client maintains state between all requests. But on the server |
| 76 | side, each request is independent. The server does not preserve |
| 77 | any information about the client from one request to the next. |
| 78 | |
| 79 |
+1
-1
| --- www/tech_overview.wiki | ||
| +++ www/tech_overview.wiki | ||
| @@ -162,11 +162,11 @@ | ||
| 162 | 162 | FOSSIL_HOME environment variable can always be set to determine the |
| 163 | 163 | location of the configuration database. Note also that the configuration |
| 164 | 164 | database file itself is called ".fossil" or "fossil.db" on unix but |
| 165 | 165 | "_fossil" on windows. |
| 166 | 166 | |
| 167 | -The [/help?cmd=info|fossil info] command will show the location of | |
| 167 | +The [/help/info|fossil info] command will show the location of | |
| 168 | 168 | the configuration database on a line that starts with "config-db:". |
| 169 | 169 | |
| 170 | 170 | <h3>2.2 Repository Databases</h3> |
| 171 | 171 | |
| 172 | 172 | The repository database is the file that is commonly referred to as |
| 173 | 173 |
| --- www/tech_overview.wiki | |
| +++ www/tech_overview.wiki | |
| @@ -162,11 +162,11 @@ | |
| 162 | FOSSIL_HOME environment variable can always be set to determine the |
| 163 | location of the configuration database. Note also that the configuration |
| 164 | database file itself is called ".fossil" or "fossil.db" on unix but |
| 165 | "_fossil" on windows. |
| 166 | |
| 167 | The [/help?cmd=info|fossil info] command will show the location of |
| 168 | the configuration database on a line that starts with "config-db:". |
| 169 | |
| 170 | <h3>2.2 Repository Databases</h3> |
| 171 | |
| 172 | The repository database is the file that is commonly referred to as |
| 173 |
| --- www/tech_overview.wiki | |
| +++ www/tech_overview.wiki | |
| @@ -162,11 +162,11 @@ | |
| 162 | FOSSIL_HOME environment variable can always be set to determine the |
| 163 | location of the configuration database. Note also that the configuration |
| 164 | database file itself is called ".fossil" or "fossil.db" on unix but |
| 165 | "_fossil" on windows. |
| 166 | |
| 167 | The [/help/info|fossil info] command will show the location of |
| 168 | the configuration database on a line that starts with "config-db:". |
| 169 | |
| 170 | <h3>2.2 Repository Databases</h3> |
| 171 | |
| 172 | The repository database is the file that is commonly referred to as |
| 173 |
+1
-1
| --- www/th1.md | ||
| +++ www/th1.md | ||
| @@ -131,11 +131,11 @@ | ||
| 131 | 131 | derived from user inputs that might contain text that is designed to subvert |
| 132 | 132 | the script. Untainted strings are known to come from secure sources and |
| 133 | 133 | are assumed to contain no malicious content. |
| 134 | 134 | |
| 135 | 135 | Beginning with Fossil version 2.26, and depending on the value of the |
| 136 | -[vuln-report setting](/help?cmd=vuln-report), TH1 will prevent tainted | |
| 136 | +[vuln-report setting](/help/vuln-report), TH1 will prevent tainted | |
| 137 | 137 | strings from being used in ways that might lead to XSS or SQL-injection |
| 138 | 138 | attacks. This feature helps to ensure that XSS and SQL-injection |
| 139 | 139 | vulnerabilities are not *accidentally* added to Fossil when |
| 140 | 140 | custom TH1 scripts for headers or footers or tickets are added to a |
| 141 | 141 | repository. Note that the tainted/untainted distinction in strings does |
| 142 | 142 |
| --- www/th1.md | |
| +++ www/th1.md | |
| @@ -131,11 +131,11 @@ | |
| 131 | derived from user inputs that might contain text that is designed to subvert |
| 132 | the script. Untainted strings are known to come from secure sources and |
| 133 | are assumed to contain no malicious content. |
| 134 | |
| 135 | Beginning with Fossil version 2.26, and depending on the value of the |
| 136 | [vuln-report setting](/help?cmd=vuln-report), TH1 will prevent tainted |
| 137 | strings from being used in ways that might lead to XSS or SQL-injection |
| 138 | attacks. This feature helps to ensure that XSS and SQL-injection |
| 139 | vulnerabilities are not *accidentally* added to Fossil when |
| 140 | custom TH1 scripts for headers or footers or tickets are added to a |
| 141 | repository. Note that the tainted/untainted distinction in strings does |
| 142 |
| --- www/th1.md | |
| +++ www/th1.md | |
| @@ -131,11 +131,11 @@ | |
| 131 | derived from user inputs that might contain text that is designed to subvert |
| 132 | the script. Untainted strings are known to come from secure sources and |
| 133 | are assumed to contain no malicious content. |
| 134 | |
| 135 | Beginning with Fossil version 2.26, and depending on the value of the |
| 136 | [vuln-report setting](/help/vuln-report), TH1 will prevent tainted |
| 137 | strings from being used in ways that might lead to XSS or SQL-injection |
| 138 | attacks. This feature helps to ensure that XSS and SQL-injection |
| 139 | vulnerabilities are not *accidentally* added to Fossil when |
| 140 | custom TH1 scripts for headers or footers or tickets are added to a |
| 141 | repository. Note that the tainted/untainted distinction in strings does |
| 142 |
+6
-6
| --- www/unvers.wiki | ||
| +++ www/unvers.wiki | ||
| @@ -24,15 +24,15 @@ | ||
| 24 | 24 | In other words, the URI method "<b>uv</b>" (short for "unversioned") |
| 25 | 25 | followed by the name of the unversioned file will retrieve the content |
| 26 | 26 | of the file. The MIME type is inferred from the filename suffix. |
| 27 | 27 | |
| 28 | 28 | The content of unversioned files can also be retrieved using the |
| 29 | -[/help?cmd=unversioned|fossil unvers cat <i>FILENAME...</i>] | |
| 30 | -or [/help?cmd=unversioned|fossil unvers export <i>FILENAME</i>] commands. | |
| 29 | +[/help/unversioned|fossil unvers cat <i>FILENAME...</i>] | |
| 30 | +or [/help/unversioned|fossil unvers export <i>FILENAME</i>] commands. | |
| 31 | 31 | |
| 32 | 32 | A list of all unversioned files on a server can be seen using |
| 33 | -the [/help?cmd=/uvlist|/uvlist] URL. ([/uvlist|example].) | |
| 33 | +the [/help/www/uvlist|/uvlist] URL. ([/uvlist|example].) | |
| 34 | 34 | |
| 35 | 35 | <h2>Syncing Unversioned Files</h2> |
| 36 | 36 | |
| 37 | 37 | Unversioned content does not sync between repositories by default. |
| 38 | 38 | One must request it via commands such as: |
| @@ -41,18 +41,18 @@ | ||
| 41 | 41 | fossil sync <b>-u</b> |
| 42 | 42 | fossil clone <b>-u</b> <i>URL local-repo-name</i> |
| 43 | 43 | fossil unversioned sync |
| 44 | 44 | </pre> |
| 45 | 45 | |
| 46 | -The [/help?cmd=sync|fossil sync] and [/help?cmd=clone|fossil clone] | |
| 46 | +The [/help/sync|fossil sync] and [/help/clone|fossil clone] | |
| 47 | 47 | commands will synchronize unversioned content if and only if they're |
| 48 | 48 | given the "-u" (or "--unversioned") command-line option. The |
| 49 | -[/help?cmd=unversioned|fossil unversioned sync] command synchronizes the | |
| 49 | +[/help/unversioned|fossil unversioned sync] command synchronizes the | |
| 50 | 50 | unversioned content without synchronizing anything else. |
| 51 | 51 | |
| 52 | 52 | Notice that the "-u" option does not work on |
| 53 | -[/help?cmd=push|fossil push] or [/help?cmd=pull|fossil pull]. | |
| 53 | +[/help/push|fossil push] or [/help?cmd=pull|fossil pull]. | |
| 54 | 54 | The "-u" option is only available on "sync" and "clone". |
| 55 | 55 | A rough equivalent of an unversioned pull would be the |
| 56 | 56 | [/help?cmd=unversioned|fossil unversioned revert] command. The |
| 57 | 57 | "unversioned revert" |
| 58 | 58 | command causes the unversioned content on the local repository to be |
| 59 | 59 |
| --- www/unvers.wiki | |
| +++ www/unvers.wiki | |
| @@ -24,15 +24,15 @@ | |
| 24 | In other words, the URI method "<b>uv</b>" (short for "unversioned") |
| 25 | followed by the name of the unversioned file will retrieve the content |
| 26 | of the file. The MIME type is inferred from the filename suffix. |
| 27 | |
| 28 | The content of unversioned files can also be retrieved using the |
| 29 | [/help?cmd=unversioned|fossil unvers cat <i>FILENAME...</i>] |
| 30 | or [/help?cmd=unversioned|fossil unvers export <i>FILENAME</i>] commands. |
| 31 | |
| 32 | A list of all unversioned files on a server can be seen using |
| 33 | the [/help?cmd=/uvlist|/uvlist] URL. ([/uvlist|example].) |
| 34 | |
| 35 | <h2>Syncing Unversioned Files</h2> |
| 36 | |
| 37 | Unversioned content does not sync between repositories by default. |
| 38 | One must request it via commands such as: |
| @@ -41,18 +41,18 @@ | |
| 41 | fossil sync <b>-u</b> |
| 42 | fossil clone <b>-u</b> <i>URL local-repo-name</i> |
| 43 | fossil unversioned sync |
| 44 | </pre> |
| 45 | |
| 46 | The [/help?cmd=sync|fossil sync] and [/help?cmd=clone|fossil clone] |
| 47 | commands will synchronize unversioned content if and only if they're |
| 48 | given the "-u" (or "--unversioned") command-line option. The |
| 49 | [/help?cmd=unversioned|fossil unversioned sync] command synchronizes the |
| 50 | unversioned content without synchronizing anything else. |
| 51 | |
| 52 | Notice that the "-u" option does not work on |
| 53 | [/help?cmd=push|fossil push] or [/help?cmd=pull|fossil pull]. |
| 54 | The "-u" option is only available on "sync" and "clone". |
| 55 | A rough equivalent of an unversioned pull would be the |
| 56 | [/help?cmd=unversioned|fossil unversioned revert] command. The |
| 57 | "unversioned revert" |
| 58 | command causes the unversioned content on the local repository to be |
| 59 |
| --- www/unvers.wiki | |
| +++ www/unvers.wiki | |
| @@ -24,15 +24,15 @@ | |
| 24 | In other words, the URI method "<b>uv</b>" (short for "unversioned") |
| 25 | followed by the name of the unversioned file will retrieve the content |
| 26 | of the file. The MIME type is inferred from the filename suffix. |
| 27 | |
| 28 | The content of unversioned files can also be retrieved using the |
| 29 | [/help/unversioned|fossil unvers cat <i>FILENAME...</i>] |
| 30 | or [/help/unversioned|fossil unvers export <i>FILENAME</i>] commands. |
| 31 | |
| 32 | A list of all unversioned files on a server can be seen using |
| 33 | the [/help/www/uvlist|/uvlist] URL. ([/uvlist|example].) |
| 34 | |
| 35 | <h2>Syncing Unversioned Files</h2> |
| 36 | |
| 37 | Unversioned content does not sync between repositories by default. |
| 38 | One must request it via commands such as: |
| @@ -41,18 +41,18 @@ | |
| 41 | fossil sync <b>-u</b> |
| 42 | fossil clone <b>-u</b> <i>URL local-repo-name</i> |
| 43 | fossil unversioned sync |
| 44 | </pre> |
| 45 | |
| 46 | The [/help/sync|fossil sync] and [/help/clone|fossil clone] |
| 47 | commands will synchronize unversioned content if and only if they're |
| 48 | given the "-u" (or "--unversioned") command-line option. The |
| 49 | [/help/unversioned|fossil unversioned sync] command synchronizes the |
| 50 | unversioned content without synchronizing anything else. |
| 51 | |
| 52 | Notice that the "-u" option does not work on |
| 53 | [/help/push|fossil push] or [/help?cmd=pull|fossil pull]. |
| 54 | The "-u" option is only available on "sync" and "clone". |
| 55 | A rough equivalent of an unversioned pull would be the |
| 56 | [/help?cmd=unversioned|fossil unversioned revert] command. The |
| 57 | "unversioned revert" |
| 58 | command causes the unversioned content on the local repository to be |
| 59 |