Tcl

Description/Background

The main goal with this project is to develop the fnest software using the Tcl language.
fnest is a set of scripts, originally written in bash, with the purpose to organize and group (but not directly modify) Fossil repositories.
Anyhow, after some development, the decision was taken to re-write fnest in Tcl, for a number of reasons:

• Tcl is a more powerful programming language than bash when it comes to string processing,
  data structures (arrays/dicts and lists), extending functionalities via packages, etc.
  
• Tcl source code is easy to organize in a tcl package.
• Tcl comes with the tcltest framework included/integrated.
• Tcl is useful for embedded environments and bootstrapping, thanks to tiny Tcl interpreters such as jimsh0 (single C-code file, source code: ~614 kB, executable: ~341 kB).

Other reasons to use Tcl together with Fossil-related software:

• The Fossil test scripts are written in Tcl.
  
• A Tcl-like syntax is used by the Fossil th1 pages.
  
• drh likes Tcl. :-)

Sections

This repository is divided into several sections/subdirectories.
They are listed in the order that, more or less, starts with the Tcl basics and ends with the finished fnest software, following the development steps:

• examples/ : A Tcl programming tutorial and examples.
• package/ : A Tcl package tutorial. Includes creating a "skeleton" for the fnest package.
• ambiguous-command/ : Implement "ambiguous-command" detection for subcommands, in the same way as Fossil does.
• ensemble/ : Tutorial how to handle subcommands with namespace ensemble.
• tcltest/ : A tcltest tutorial. Includes tests for each proc in the fnest package.
• nagelfar/ : A Tcl code coverage tutorial, using nagelfar.
• jimsh/ : Issues related to the jimsh0 Tcl interpreter, with focus on bootstrapping.
• bootstrap/ : How to bootstrap any installation from scratch from internet, with focus on using jimsh0 to install fnest.
• bin/ : The "final result"; the directory with the Tcl scripts which will replace the existing bash scripts (and add some new) in the main fnest repository: fnest, fsetup, fgroup, the fnest package etc.
• auto-complete/ : Optionally, add auto-completion for fnest subcommands, using the bash built-in command complete.
• gui/ : Optionally, add a client-server based GUI to the fnest command.