Re: [fossil-users] TH1 and/or Tcl

2016-09-28 Thread Joe Mistachkin

Adam Jensen wrote:
> 
> Is TH1 required to run Tcl scripts?
> 

Yes, which should be fine since it is always included when building
Fossil.

>
> Are there any examples of Tcl use-with/extensions-of Fossil?
>

Examples, yes.  Public examples, I'm not so sure about.

> 
> "To enable the native Tcl integration feature feature, add the
> --with-tcl=1 and --with-tcl-private-stubs=1 options."
> 

These should be fine.  The other options control other features (related
to TH1), which are not strictly necessary for Tcl integration.

>
> Does this mean that '--with-th1-hooks' is needed to access a full Tcl
> implementation? (Is the TH1 interpreter required to invoke the Tcl
> interpreter?)
> 

No.  Also, TH1 itself is always included when building Fossil.

Being able to have a TH1 script "hook" commands and/or web pages requires
the --with-th1-hooks option.

Similarly, being able to have a TH1 script be evaluated in response to an
embedded documentation page requires the --with-th1-docs option.

Neither of these options are required simply to enable Tcl integration.

--
Joe Mistachkin @ https://urn.to/r/mistachkin

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


[fossil-users] TH1 and/or Tcl

2016-09-28 Thread Adam Jensen
Is TH1 required to run Tcl scripts?

Are there any examples of Tcl use-with/extensions-of Fossil?

I am having some trouble sorting out the documentation and determining
the build options that would enable exploration.


The build page[1] might be out of date/sync with the build options.

[1]: https://www.fossil-scm.org/fossil/doc/trunk/www/build.wiki

"To enable the native Tcl integration feature feature, add the
--with-tcl=1 and --with-tcl-private-stubs=1 options."

vs.

'./configure --help'
--
  --with-th1-docs   Enable TH1 for embedded documentation pages
  --with-th1-hooks  Enable TH1 hooks for commands and web pages
  --with-tcl=path   Enable Tcl integration, with Tcl in the
specified path
  --with-tcl-stubs  Enable Tcl integration via stubs library
mechanism
  --with-tcl-private-stubs  Enable Tcl integration via private stubs
mechanism
--

And this page:

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

says: "TH1 tclEval Command

This command requires the Tcl integration feature.

tclEval arg ?arg ...?

Evaluates the Tcl script and returns its result verbatim."


Does this mean that '--with-th1-hooks' is needed to access a full Tcl
implementation? (Is the TH1 interpreter required to invoke the Tcl
interpreter?)

And [being more explicit than the available documentation], I've
discovered that the "path" in '--with-tcl=path' is the location of the
"tclConfig.sh" file. For example, I use, '--with-tcl=$HOME/.local/lib'.

Two or three beginning to end examples for each, TH1 use and Tcl use
would be tremendously valuable.

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