- why would someone bother wrapping a tcl extension into a starkit?
- But why a starkit? Why not use the VFS to mount a .tar or .zip file?
- Now that you mention it, what about the docs and the demos?
One approach to solving the doc problem would be to have a command line command which copied .man format files into the appropriate directory. Below, jcw mentions using a wikit as an embedded help system. The difficulty there is discovery - if someone knows they want help with a command, then that works okay. But if they are looking to see what tcl commands provide pop3 support, then they won't necessarily know the name of the .kit to run to find the docs.
- Well, is there an example of how one might create a starkit
- So, how do I get started?
Kroc 07 Oct 2004 - I've already done some starkits with pure tcl packages in (tcllib 1.6.1  and tklib 0.2  for example). Once you've sourced them, you can [package require] every wanted packages they provide. According to me, that's actually (with tclkit) the most convinient way to install and develop with tcl without root/admin rights.But you're right, it misses something to provide documentation with starkits. That's why I'm actually looking for a way to store and display help and/or manuals inside a starkit. I think this could be done by adding a global [man] proc in starkit's main.tcl. This proc must be able to return documentation to stdout in Tk wasn't loaded, or in a text widget. It must be pure tcl of course, and last (but not least) the documentation format have to be easy to produce from actual tcl and packages formats (i.e. manpages, html, etc..). I've not find yet how I'll do that but as I'm still looking for, any advice will be welcome.Kroc 11 Oct 2004 - I've done a little starkit to demonstrate this idea.This starkit provides cksum 1.0.1, crc16 1.1, crc32 1.1.1 and sum 1.1.0 from tcllib 1.6.1. I add builtin documentation, which can be displayed with a custom version of a little hypertext system. Actually, built-in documentation is a .dok file saved in package directory using part of wikit syntax. You can call it with man ?command? or from tclsh, wish console, or tkcon command line, ex:
% man crc32Of course, this has to be improved (a lot) to fit requirements given above.jcw There's a page on adding wikit as embedded help system, see , for example. I think there are other pages too.Kroc 12 Oct 2004 - I've already read them Jean-Claude, but noone fits all my requirements. I updated crc.kit today: now man returns documentation to stdout if Tk is not loaded or use the text widget if Tk was loaded before crc.kit was sourced.If I go further, I'll wikify a dedicated page for this.
LES Hmmm... interesting idea: all extensions in a single starkit. You get the core, the extensions.kit and this is it.