Fossil SCM

Update documentation to "fossil patch" and "fossil ui" to talk about the algorithm used for locating the fossil executable on the remote host.

drh 2023-06-18 23:20 trunk
Commit d22e2b3817b78104f80fa5d42c0884d9e5b0416419a57fd38d88b1a4167fa563
2 files changed +7 -3 +6
+7 -3
--- src/main.c
+++ src/main.c
@@ -3061,11 +3061,15 @@
30613061
** command.
30623062
**
30633063
** If REPOSITORY begins with a "HOST:" or "USER@HOST:" prefix, then
30643064
** the command is run on the remote host specified and the results are
30653065
** tunneled back to the local machine via SSH. This feature only works for
3066
-** the "fossil ui" command, not the "fossil server" command.
3066
+** the "fossil ui" command, not the "fossil server" command. The name of the
3067
+** fossil executable on the remote host is specified by the --fossilcmd option,
3068
+** or if there is no --fossilcmd, it first tries "$HOME/bin/fossil" and if
3069
+** not found there it searches for any executable named "fossil" on the
3070
+** default $PATH set by SSH on the remote.
30673071
**
30683072
** REPOSITORY may also be a directory (aka folder) that contains one or
30693073
** more repositories with names ending in ".fossil". In this case, a
30703074
** prefix of the URL pathname is used to search the directory for an
30713075
** appropriate repository. To thwart mischief, the pathname in the URL must
@@ -3102,12 +3106,12 @@
31023106
** /doc/ckout/...
31033107
** --create Create a new REPOSITORY if it does not already exist
31043108
** --errorlog FILE Append HTTP error messages to FILE
31053109
** --extroot DIR Document root for the /ext extension mechanism
31063110
** --files GLOBLIST Comma-separated list of glob patterns for static files
3107
-** --fossilcmd PATH Full pathname of the "fossil" executable on the remote
3108
-** system when REPOSITORY is remote. Default: "fossil"
3111
+** --fossilcmd PATH The pathname of the "fossil" executable on the remote
3112
+** system when REPOSITORY is remote.
31093113
** --localauth Enable automatic login for requests from localhost
31103114
** --localhost Listen on 127.0.0.1 only (always true for "ui")
31113115
** --https Indicates that the input is coming through a reverse
31123116
** proxy that has already translated HTTPS into HTTP.
31133117
** --jsmode MODE Determine how JavaScript is delivered with pages.
31143118
--- src/main.c
+++ src/main.c
@@ -3061,11 +3061,15 @@
3061 ** command.
3062 **
3063 ** If REPOSITORY begins with a "HOST:" or "USER@HOST:" prefix, then
3064 ** the command is run on the remote host specified and the results are
3065 ** tunneled back to the local machine via SSH. This feature only works for
3066 ** the "fossil ui" command, not the "fossil server" command.
 
 
 
 
3067 **
3068 ** REPOSITORY may also be a directory (aka folder) that contains one or
3069 ** more repositories with names ending in ".fossil". In this case, a
3070 ** prefix of the URL pathname is used to search the directory for an
3071 ** appropriate repository. To thwart mischief, the pathname in the URL must
@@ -3102,12 +3106,12 @@
3102 ** /doc/ckout/...
3103 ** --create Create a new REPOSITORY if it does not already exist
3104 ** --errorlog FILE Append HTTP error messages to FILE
3105 ** --extroot DIR Document root for the /ext extension mechanism
3106 ** --files GLOBLIST Comma-separated list of glob patterns for static files
3107 ** --fossilcmd PATH Full pathname of the "fossil" executable on the remote
3108 ** system when REPOSITORY is remote. Default: "fossil"
3109 ** --localauth Enable automatic login for requests from localhost
3110 ** --localhost Listen on 127.0.0.1 only (always true for "ui")
3111 ** --https Indicates that the input is coming through a reverse
3112 ** proxy that has already translated HTTPS into HTTP.
3113 ** --jsmode MODE Determine how JavaScript is delivered with pages.
3114
--- src/main.c
+++ src/main.c
@@ -3061,11 +3061,15 @@
3061 ** command.
3062 **
3063 ** If REPOSITORY begins with a "HOST:" or "USER@HOST:" prefix, then
3064 ** the command is run on the remote host specified and the results are
3065 ** tunneled back to the local machine via SSH. This feature only works for
3066 ** the "fossil ui" command, not the "fossil server" command. The name of the
3067 ** fossil executable on the remote host is specified by the --fossilcmd option,
3068 ** or if there is no --fossilcmd, it first tries "$HOME/bin/fossil" and if
3069 ** not found there it searches for any executable named "fossil" on the
3070 ** default $PATH set by SSH on the remote.
3071 **
3072 ** REPOSITORY may also be a directory (aka folder) that contains one or
3073 ** more repositories with names ending in ".fossil". In this case, a
3074 ** prefix of the URL pathname is used to search the directory for an
3075 ** appropriate repository. To thwart mischief, the pathname in the URL must
@@ -3102,12 +3106,12 @@
3106 ** /doc/ckout/...
3107 ** --create Create a new REPOSITORY if it does not already exist
3108 ** --errorlog FILE Append HTTP error messages to FILE
3109 ** --extroot DIR Document root for the /ext extension mechanism
3110 ** --files GLOBLIST Comma-separated list of glob patterns for static files
3111 ** --fossilcmd PATH The pathname of the "fossil" executable on the remote
3112 ** system when REPOSITORY is remote.
3113 ** --localauth Enable automatic login for requests from localhost
3114 ** --localhost Listen on 127.0.0.1 only (always true for "ui")
3115 ** --https Indicates that the input is coming through a reverse
3116 ** proxy that has already translated HTTPS into HTTP.
3117 ** --jsmode MODE Determine how JavaScript is delivered with pages.
3118
--- src/patch.c
+++ src/patch.c
@@ -881,10 +881,16 @@
881881
** REMOTE-CHECKOUT is in one of the following formats:
882882
**
883883
** * DIRECTORY
884884
** * HOST:DIRECTORY
885885
** * USER@HOST:DIRECTORY
886
+**
887
+** The name of the fossil executable on the remote host is specified
888
+** by the --fossilcmd option, or if there is no --fossilcmd, it first
889
+** tries "$HOME/bin/fossil" and if not found there it searches for any
890
+** executable named "fossil" on the default $PATH set by SSH on the
891
+** remote.
886892
**
887893
** Command-line options:
888894
**
889895
** -f|--force Apply the patch even though there are unsaved
890896
** changes in the current check-out. Unsaved
891897
--- src/patch.c
+++ src/patch.c
@@ -881,10 +881,16 @@
881 ** REMOTE-CHECKOUT is in one of the following formats:
882 **
883 ** * DIRECTORY
884 ** * HOST:DIRECTORY
885 ** * USER@HOST:DIRECTORY
 
 
 
 
 
 
886 **
887 ** Command-line options:
888 **
889 ** -f|--force Apply the patch even though there are unsaved
890 ** changes in the current check-out. Unsaved
891
--- src/patch.c
+++ src/patch.c
@@ -881,10 +881,16 @@
881 ** REMOTE-CHECKOUT is in one of the following formats:
882 **
883 ** * DIRECTORY
884 ** * HOST:DIRECTORY
885 ** * USER@HOST:DIRECTORY
886 **
887 ** The name of the fossil executable on the remote host is specified
888 ** by the --fossilcmd option, or if there is no --fossilcmd, it first
889 ** tries "$HOME/bin/fossil" and if not found there it searches for any
890 ** executable named "fossil" on the default $PATH set by SSH on the
891 ** remote.
892 **
893 ** Command-line options:
894 **
895 ** -f|--force Apply the patch even though there are unsaved
896 ** changes in the current check-out. Unsaved
897

Keyboard Shortcuts

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