Michael Richter wrote:
> 
> What, exactly, does this actually do?  I can't find any information on
this
> whatsoever.
>

Technically, it is documented in the help for the "settings" command.

I suppose that I should provide more details on the primary TH1 integration
reference page:

        https://www.fossil-scm.org/fossil/doc/trunk/www/th1.md

My conference slides describing how to use this feature (and other "Tcl
integration" features) are here:

        http://eagle.to/tcl2014/fossil-tcl.pdf

Here is the relevant excerpt from the help for the "settings" command:

   tcl              If enabled (and Fossil was compiled with Tcl support),
                    Tcl integration commands will be added to the TH1
                    interpreter, allowing arbitrary Tcl expressions and
                    scripts to be evaluated from TH1.  Additionally, the Tcl
                    interpreter will be able to evaluate arbitrary TH1
                    expressions and scripts. Default: off.

   tcl-setup        This is the setup script to be evaluated after creating
    (versionable)   and initializing the Tcl interpreter.  By default, this
                    is empty and no extra setup is performed.

   th1-docs         WARNING: If enabled (and Fossil was compiled with TH1
                    support for embedded documentation files), this allows
                    embedded documentation files to contain arbitrary TH1
                    scripts that are evaluated on the server.  If native
                    Tcl integration is also enabled, this setting has the
                    potential to allow anybody with check-in privileges to
                    do almost anything that the associated operating system
                    user account could do.  Extreme caution should be used
                    when enabling this setting.  Default: off.

   th1-hooks        If enabled (and Fossil was compiled with support for TH1
                    hooks), special TH1 commands will be called before and
                    after any Fossil command or web page. Default: off.

   th1-setup        This is the setup script to be evaluated after creating
    (versionable)   and initializing the TH1 interpreter.  By default, this
                    is empty and no extra setup is performed.

   th1-uri-regexp   Specify which URI's are allowed in HTTP requests from
    (versionable)   TH1 scripts.  If empty, no HTTP requests are allowed
                    whatsoever.  The default is an empty string.

--
Joe Mistachkin

_______________________________________________
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users

Reply via email to