Tcl Library Source Code

Check-in [7a4994784a]
Login
Bounty program for improvements to Tcl and certain Tcl packages.
Tcl 2019 Conference, Houston/TX, US, Nov 4-8
Send your abstracts to tclconference@googlegroups.com
or submit via the online form by Sep 9.

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment: Tweaked the `sak.tcl localdoc` command to match the change from `embedded/index.html` to `embedded/index.md`. Added the first set of global documentation (license, how to get the sources, installation instructions). Extended `README.md` and `embedded/index.md` with references to the new documentation. Regenerated the documentation, embedded and for installation.
Timelines: family | ancestors | descendants | both | doc-overhaul
Files: files | file ages | folders
SHA3-256:7a4994784a3b6f92f63caabcfc2ef0c54e4162088beddb4bb2681518878b39a3
User & Date: aku 2019-03-06 07:32:28
Context
2019-03-06
08:13
Removed `devdoc/installation.txt`. Was a duplicate of `devdoc/dirlayout_install.txt`, thus superfluous. Reworked the installation instructions. Folded unix and windows into a single section based on the older `devdoc/INSTALL.txt`. This thus became superfluous, and was removed. check-in: 2e0a176af7 user: aku tags: doc-overhaul
07:32
Tweaked the `sak.tcl localdoc` command to match the change from `embedded/index.html` to `embedded/index.md`. Added the first set of global documentation (license, how to get the sources, installation instructions). Extended `README.md` and `embedded/index.md` with references to the new documentation. Regenerated the documentation, embedded and for installation. check-in: 7a4994784a user: aku tags: doc-overhaul
07:06
Get updated package docs. check-in: a2ff90fa4e user: aku tags: doc-overhaul
Changes
Hide Diffs Side-by-Side Diffs Ignore Whitespace Patch

Changes to README.md.

    30     30   are (still) hosted.
    31     31   
    32     32   Another location to find these sources at is the
    33     33   [github mirror](https://github.com/tcltk/tcllib).
    34     34   
    35     35   Please note the :warning: at the top.
    36     36   
    37         -# More reading
           37  +# Guides To Tcllib
    38     38   
    39         -Note that depending on your role with regard to Tcllib (developer,
    40         -release manager, installer) we have additional README documents
    41         -available with more information specific to that role.
           39  +   * Guide to Kind Communication
           40  +   * [License](embedded/www/tcllib/files/devdoc/tcllib_license.html)
           41  +   * [How To Get The Sources](embedded/www/tcllib/files/devdoc/tcllib_sources.html)
           42  +   * [How To Build And Install Tcllib](embedded/www/tcllib/files/devdoc/tcllib_installer.html)
           43  +   * The Developer's Guide

Added devdoc/parts/b_critcl.inc.

            1  +[subsection {Critcl & Accelerators}]
            2  +
            3  +[para] A number of packages come with [term accelerators], i.e.
            4  +[syscmd critcl]-based C code whose use will boost the performance of
            5  +the packages using them. As these accelerators are optional they are
            6  +not installed by default.
            7  +
            8  +[para] To build the accelerators the normally optional dependency on
            9  +[syscmd critcl] becomes required.
           10  +
           11  +[para] To install Tcllib with the accelerators run
           12  +
           13  +[example {
           14  +    ./configure
           15  +    make critcl # This builds the shared library holding the accelerators
           16  +    make install
           17  +}]
           18  +
           19  +[para] The underlying tool is [file sak.tcl] in the toplevel directory
           20  +of Tcllib and the command [cmd {make critcl}] is just a wrapper around
           21  +
           22  +[example {
           23  +    ./sak.tcl critcl
           24  +}]

Added devdoc/parts/b_unix.inc.

            1  +[subsection Unix]
            2  +
            3  +This section describes the actions required to install Tcllib on Unix
            4  +systems (Linux, BSD, and related, including OS X).
            5  +
            6  +If you have to install Tcllib on a Windows machine instead then see
            7  +section [sectref Windows].
            8  +
            9  +[para] Tcllib comes with a standard TEA buildsystem using a
           10  +[syscmd configure] script and a [file Makefile] generated by it.
           11  +
           12  +[para] To install Tcllib simply run
           13  +
           14  +[example {
           15  +    ./configure
           16  +    make install
           17  +}]
           18  +
           19  +in the toplevel directory of Tcllib itself. To build in a directory D
           20  +outside of Tcllib's toplevel directory simply make D the current
           21  +working directory and invoke [syscmd configure] with either its
           22  +absolute path or a proper relative path.
           23  +
           24  +[para] The above will non-interactively install all packages,
           25  +applications found in Tcllib, and their manpages, in directories
           26  +derived from what [syscmd configure] found out about the system.
           27  +
           28  +[para] The underlying tool is [file installer.tcl] in the toplevel
           29  +directory of Tcllib.
           30  +
           31  +[para] Invoking this tool via
           32  +
           33  +[example {
           34  +    ./installer.tcl -help
           35  +}]
           36  +
           37  +will provide a short list of the available options. For more examples
           38  +see the various [term install] targets found in [file Makefile.in].

Added devdoc/parts/b_windows.inc.

            1  +[subsection Windows]
            2  +
            3  +This section describes the actions required to install Tcllib on Windows(tm)
            4  +systems.
            5  +
            6  +If you have to install Tcllib on a Unix machine (Linux, BSD, and
            7  +related, including OS X) instead then see section [sectref Unix].
            8  +
            9  +[para] If the build environment is based on [term MSYS],
           10  +[term cygwin], or a similar emulation of a unix environment, then
           11  +[sectref Unix] still applies and should be used.
           12  +
           13  +[para] Alternatively, as mentioned in the previous section, the tool
           14  +underneath of the unix buildsystem is the [term Tcl]-based
           15  +[file installer.tcl] script.
           16  +
           17  +[para] Invoking this tool from a DOS shell via
           18  +
           19  +[example {
           20  +    /path/to/tclsh ./installer.tcl -help
           21  +}]
           22  +
           23  +will provide a short list of the available options. For more examples
           24  +see the various [term install] targets found in [file Makefile.in].
           25  +
           26  +Invoking this tool without any arguments, i.e. like
           27  +
           28  +[example {
           29  +    /path/to/tclsh ./installer.tcl
           30  +}]
           31  +
           32  +will start a non-interactive installation showing its progress in a
           33  +Tk-based graphical interface. The directories to install the packages,
           34  +applications, etc. into are derived from the location of the
           35  +[syscmd tclsh] used to invoke the script, and where it expects
           36  +packages.

Added devdoc/parts/rq_critcl.inc.

            1  +
            2  +[subsection CriTcl]
            3  +
            4  +The [syscmd critcl] tool is an [strong optional] dependency.
            5  +
            6  +[para] It is only required when trying to build the C-based
            7  +[term accelerators] for a number of packages, as explained in
            8  +[sectref {Critcl & Accelerators}]
            9  +
           10  +[para] Tcllib's build system accepts it as an application found in the
           11  +PATH (be it starkit or starpack).
           12  +
           13  +[para] Tcllib requires version 2 or higher.
           14  +
           15  +[para] The github repository providing releases of version 2 and
           16  +higher, and the associated sources, can be found at
           17  +[uri http://andreas-kupries.github.com/critcl].
           18  +
           19  +[para] Any branch of the repository can be used (if not using the
           20  +prebuild starkit or starpack), although the use of the stable branch
           21  +[emph master] is recommended.
           22  +
           23  +[para] At the above url is also an explanation on how to build and
           24  +install CriTcl, including a list of its dependencies.
           25  +
           26  +[para] Its instructions will not be repeated here. If there are
           27  +problems with their directions please file a ticket against the
           28  +[term Critcl] project, and not Tcllib.

Added devdoc/parts/rq_tcl.inc.

            1  +
            2  +[subsection Tcl]
            3  +
            4  +As we are installing a number of Tcl packages and applications it
            5  +should be pretty much obvious that a working installation of Tcl
            6  +itself is needed, and I will not belabor the point.
            7  +
            8  +[para] Out of the many possibilites use whatever you are comfortable
            9  +with, as long as it provides Tcl 8.2, or higher.
           10  +
           11  +This may be a Tcl installation provided by your operating system
           12  +distribution, from a distribution-independent vendor, or built by
           13  +yourself.
           14  +
           15  +[para] [strong Note] that the packages in Tcllib have begun to require
           16  +8.4, 8.5, and even 8.6. Older versions of Tcl will not be able to use
           17  +such packages. Trying to use them will result in
           18  +[strong {package not found}] errors, as their package index files will
           19  +not register them in versions of the core unable to use them.
           20  +
           21  +[para] Myself, I used (and still use)
           22  +[uri http://www.activestate.com ActiveState's]
           23  +ActiveTcl 8.5 distribution during development, as I am most familiar
           24  +with it.
           25  +
           26  +[para] [emph {(Disclosure: I, Andreas Kupries, worked for ActiveState until 2016, maintaining ActiveTcl and TclDevKit for them).}].
           27  +I am currently working for SUSE Software Canada ULC, although not in
           28  +Tcl-related areas.
           29  +
           30  +[para] This distribution can be found at
           31  +[uri http://www.activestate.com/activetcl]. Retrieve the archive of
           32  +ActiveTcl 8.5 (or higher) for your platform and install it as directed
           33  +by ActiveState.
           34  +
           35  +[para] For those wishing to build and install Tcl on their own, the
           36  +relevant sources can be found at
           37  +
           38  +[list_begin definitions]
           39  +[def Tcl] [uri http://core.tcl-lang.org/tcl/]
           40  +[list_end]
           41  +
           42  +together with the necessary instructions on how to build it.
           43  +
           44  +[para] If there are problems with building, installing, or using Tcl
           45  +please file a ticket against [term Tcl], or the vendor of your
           46  +distribution, and [strong not] [term Tcllib].

Added devdoc/parts/welcome.inc.

            1  +
            2  +Welcome to Tcllib, the Tcl Standard Library. Note that Tcllib is not a
            3  +package itself. It is a collection of (semi-independent) [term Tcl]
            4  +packages that provide utility functions useful to a large collection
            5  +of Tcl programmers.
            6  +

Added devdoc/tcllib_installer.man.

            1  +[comment {-*- tcl -*- doctools manpage}]
            2  +[manpage_begin tcllib_install_guide n 1]
            3  +[titledesc {Tcllib - The Installer's Guide}]
            4  +[description]
            5  +[include parts/welcome.inc]
            6  +
            7  +[para]
            8  +
            9  +The audience of this document is anyone wishing to build the packages,
           10  +for either themselves, or others.
           11  +
           12  +[para]
           13  +
           14  +For a developer intending to extend or modify the packages we
           15  +additionally provide
           16  +
           17  +[list_begin enum]
           18  +[enum] [term {Tcllib - The Developer's Guide}].
           19  +[list_end]
           20  +
           21  +[para]
           22  +
           23  +Please read [term {Tcllib - How To Get The Sources}] first, if that
           24  +was not done already. Here we assume that the sources are already
           25  +available in a directory of your choice.
           26  +
           27  +[para]
           28  +
           29  +[comment {===================================================================}]
           30  +[section Requisites]
           31  +
           32  +Before Tcllib can be build and used a number of requisites must be installed.
           33  +
           34  +These are:
           35  +
           36  +[list_begin enumerated]
           37  +[enum] The scripting language Tcl.
           38  +       For details see [sectref Tcl].
           39  +[enum] Optionally, the [package critcl] package (C embedding) for [syscmd Tcl].
           40  +       For details see [sectref CriTcl].
           41  +[list_end]
           42  +
           43  +This list assumes that the machine where Tcllib is to be installed is
           44  +essentially clean. Of course, if parts of the dependencies listed
           45  +below are already installed the associated steps can be skipped. It is
           46  +still recommended to read their sections though, to validate that the
           47  +dependencies they talk about are indeed installed.
           48  +
           49  +[include parts/rq_tcl.inc]
           50  +[include parts/rq_critcl.inc]
           51  +
           52  +[comment {= build instructions ==============================================}]
           53  +[section {Build & Installation Instructions}]
           54  +
           55  +[include parts/b_unix.inc]
           56  +[include parts/b_windows.inc]
           57  +[include parts/b_critcl.inc]
           58  +
           59  +[manpage_end]
           60  +

Added devdoc/tcllib_license.man.

            1  +[comment {-*- tcl -*- doctools manpage}]
            2  +[manpage_begin tcllib_license n 1]
            3  +[titledesc {Tcllib - License}]
            4  +[description]
            5  +[include parts/welcome.inc]
            6  +
            7  +[para] The collection is under the BSD license.
            8  +
            9  +[section License]
           10  +
           11  +[para]
           12  +
           13  +This software is copyrighted by Ajuba Solutions and other parties.
           14  +The following terms apply to all files associated with the software
           15  +unless explicitly disclaimed in individual files.
           16  +
           17  +[para]
           18  +
           19  +The authors hereby grant permission to use, copy, modify, distribute,
           20  +and license this software and its documentation for any purpose,
           21  +provided that existing copyright notices are retained in all copies
           22  +and that this notice is included verbatim in any distributions. No
           23  +written agreement, license, or royalty fee is required for any of the
           24  +authorized uses.  Modifications to this software may be copyrighted by
           25  +their authors and need not follow the licensing terms described here,
           26  +provided that the new terms are clearly indicated on the first page of
           27  +each file where they apply.
           28  +
           29  +[para]
           30  +
           31  +IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY
           32  +FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
           33  +ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY
           34  +DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE
           35  +POSSIBILITY OF SUCH DAMAGE.
           36  +
           37  +[para]
           38  +
           39  +THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
           40  +INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
           41  +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND
           42  +NON-INFRINGEMENT.  THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, AND
           43  +THE AUTHORS AND DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE
           44  +MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
           45  +
           46  +[para]
           47  +
           48  +GOVERNMENT USE: If you are acquiring this software on behalf of the
           49  +U.S. government, the Government shall have only "Restricted Rights" in
           50  +the software and related documentation as defined in the Federal
           51  +Acquisition Regulations (FARs) in Clause 52.227.19 (c) (2).  If you
           52  +are acquiring the software on behalf of the Department of Defense, the
           53  +software shall be classified as "Commercial Computer Software" and the
           54  +Government shall have only "Restricted Rights" as defined in Clause
           55  +252.227-7013 (c) (1) of DFARs.  Notwithstanding the foregoing, the
           56  +authors grant the U.S. Government and others acting in its behalf
           57  +permission to use and distribute the software in accordance with the
           58  +terms specified in this license.
           59  +
           60  +[manpage_end]
           61  +

Added devdoc/tcllib_sources.man.

            1  +[comment {-*- tcl -*- doctools manpage}]
            2  +[manpage_begin tcllib_sources n 1]
            3  +[titledesc {Tcllib - How To Get The Sources}]
            4  +[description]
            5  +[include parts/welcome.inc]
            6  +
            7  +[para]
            8  +
            9  +The audience of this document is anyone wishing to either have just a
           10  +look at Tcllib's source code, or build the packages, or to extend and
           11  +modify them.
           12  +
           13  +[para] For builders and developers we additionally provide
           14  +
           15  +[list_begin enum]
           16  +[enum] [term {Tcllib - The Installer's Guide}].
           17  +[enum] [term {Tcllib - The Developer's Guide}].
           18  +[list_end]
           19  +
           20  +respectively.
           21  +
           22  +[section {Source Location}]
           23  +
           24  +The official repository for Tcllib can be found at
           25  +[uri http://core.tcl-lang.org/tcllib]
           26  +
           27  +[section Retrieval]
           28  +
           29  +Assuming that you simply wish to look at the sources, or build a
           30  +specific revision, the easiest way of retrieving it is to:
           31  +
           32  +[list_begin enum]
           33  +[enum] Log into this site, as "anonymous", using the semi-random password in the captcha.
           34  +[enum] Go to the "Timeline".
           35  +[enum] Choose the revision you wish to have and 
           36  +[enum] follow its link to its detailed information page.
           37  +[enum] On that page, choose either the "ZIP" or "Tarball" link to get
           38  +a copy of this revision in the format of your choice.
           39  +[list_end]
           40  +
           41  +[section {Source Code Management}]
           42  +
           43  +For the curious (or a developer-to-be), the sources are managed by the
           44  +[uri http://www.fossil-scm.org {Fossil SCM}].
           45  +
           46  +Binaries for popular platforms can be found directly at its
           47  +[uri http://www.fossil-scm.org/download.html {download page}].
           48  +
           49  +[para]
           50  +
           51  +With that tool available the full history can be retrieved via:
           52  +
           53  +[example {
           54  +    fossil clone \
           55  +	http://core.tcl-lang.org/tcllib \
           56  +        tcllib.fossil
           57  +}]
           58  +
           59  +followed by
           60  +
           61  +[example {
           62  +    mkdir tcllib
           63  +    cd tcllib
           64  +    fossil open ../tcllib.fossil
           65  +}]
           66  +
           67  +to get a checkout of the head of the trunk.
           68  +
           69  +[manpage_end]

Deleted embedded/index.html.

     1         -<div class='fossil-doc' data-title='Tcl Library Source Code'>
     2         -
     3         -<h1 align="center">Tcl Library Source Code</h1>
     4         -
     5         -<center>
     6         -<form action='../../../docsrch' method='GET'>
     7         -<input type="text" name="s" size="40" autofocus>
     8         -<input type="submit" value="Search Docs">
     9         -</form>
    10         -<p><a href="www/toc.html">
    11         -Table Of Contents</a>
    12         -&nbsp;&nbsp;&nbsp;
    13         -<a href="www/index.html">
    14         -Keyword Index</a>
    15         -</center>
    16         -
    17         -<h2>Discussion &amp; Contact</h2>
    18         -<ul>
    19         -<p>Tcllib has two <a href="https://sourceforge.net/p/tcllib/mailman/">mailing lists</a>,
    20         -one for notifications, the other for general discussion. These are managed at SourceForge,
    21         -at the aforementioned link. A few direct links for various topics:
    22         -<table>
    23         -<tr><td>tcllib-bugs: </td>
    24         -<td><a href="https://lists.sourceforge.net/lists/listinfo/tcllib-bugs">Subscribe</a></td>
    25         -<td><a href="https://sourceforge.net/p/tcllib/mailman/tcllib-bugs">Archive</a></td>
    26         -<td><a href="https://sourceforge.net/p/tcllib/mailman/search/?mail_list=tcllib-bugs">Search</a></td></tr>
    27         -<tr><td>tcllib-devel:</td>
    28         -<td><a href="https://lists.sourceforge.net/lists/listinfo/tcllib-devel">Subscribe</a></td>
    29         -<td><a href="https://sourceforge.net/p/tcllib/mailman/tcllib-devel">Archive</a></td>
    30         -<td><a href="https://sourceforge.net/p/tcllib/mailman/search/?mail_list=tcllib-devel">Search</a></td></tr>
    31         -</table>
    32         -
    33         -</ul></p>
    34         -</ul>
    35         -
    36         -<h2>Feedback</h2>
    37         -<ul>
    38         -<p>Please go to and use our
    39         -<a href="../../../reportlist">
    40         -Local Trackers</a>. They are for
    41         -<ul>
    42         -<li>Bugs,</li>
    43         -<li>Patches, and </li>
    44         -<li>Ideas &amp; Feature Requests.</li>
    45         -</ul></p>
    46         -</ul>
    47         -
    48         -<h2>Releases</h2>
    49         -
    50         -<ul>
    51         -<p>Current:
    52         -<b>1.19 (Feb 16, 2018)</b>
    53         -<a href="../../../technote/0b2528ed32f54c4a8f08951aaa11ff60b3843630">Details</a>
    54         -
    55         -</p>
    56         -<p><a href='../../../wiki?name=Past+Releases'>[Past Releases]</a></p>
    57         -<p><a href='../../../wiki?name=Development+Snapshots'>[Development Snapshots]</a></p>
    58         -<p><a href="https://sourceforge.net/projects/tcllib/files/">@ SourceForge</a></p>
    59         -</ul>
    60         -
    61         -<h2>Related Repositories</h2>
    62         -<ul>
    63         -<li><a href="../../../../tklib">Tklib</a></li>
    64         -<li><a href="../../../../tclapps">Tcl Apps</a></li>
    65         -<li><a href="../../../../tclbench">Tcl Bench</a></li>
    66         -<li><a href="../../../../mclistbox">Multicolumn Listbox</a></li>
    67         -<li><a href="../../../../widget">Widget</a></li>
    68         -<li><a href="../../../../bwidget">BWidget</a></li>
    69         -</ul>
    70         -
    71         -
    72         -<h2>See also</h2>
    73         -<ul>
    74         -<li><a href="http://www.tcl.tk/software/tcllib/">Landing page for this package at the Tcl Developer eXchange</a></li>
    75         -</ul>

Changes to embedded/index.md.

    11     11   <center>
    12     12   	<form action='../../../docsrch' method='GET'>
    13     13   	<input type="text" name="s" size="40" autofocus>
    14     14   	<input type="submit" value="Search Package Documentation">
    15     15   	</form>
    16     16   </center>
    17     17   
           18  +## Guides to Tcllib
           19  +
           20  +   * Guide to Kind Communication
           21  +   * [License](www/tcllib/files/devdoc/tcllib_license.html)
           22  +   * [How To Get The Sources](www/tcllib/files/devdoc/tcllib_sources.html)
           23  +   * [How To Build And Install Tcllib](www/tcllib/files/devdoc/tcllib_installer.html)
           24  +   * The Developer's Guide
           25  +
    18     26   ## Discussion & Contact
    19     27   
    20     28   Tcllib has two
    21     29   [mailing lists](https://sourceforge.net/p/tcllib/mailman/).
    22     30   
    23     31   One for notifications (commits, ticket changes), the other for general
    24     32   discussion. These are managed at SourceForge, at the aforementioned

Added embedded/www/tcllib/files/devdoc/tcllib_installer.html.

            1  +
            2  +<div class='fossil-doc' data-title='tcllib_install_guide - '>
            3  +<style>
            4  +    HTML {
            5  +	background: 	#FFFFFF;
            6  +	color: 		black;
            7  +    }
            8  +    BODY {
            9  +	background: 	#FFFFFF;
           10  +	color:	 	black;
           11  +    }
           12  +    DIV.doctools {
           13  +	margin-left:	10%;
           14  +	margin-right:	10%;
           15  +    }
           16  +    DIV.doctools H1,DIV.doctools H2 {
           17  +	margin-left:	-5%;
           18  +    }
           19  +    H1, H2, H3, H4 {
           20  +	margin-top: 	1em;
           21  +	font-family:	sans-serif;
           22  +	font-size:	large;
           23  +	color:		#005A9C;
           24  +	background: 	transparent;
           25  +	text-align:		left;
           26  +    }
           27  +    H1.doctools_title {
           28  +	text-align: center;
           29  +    }
           30  +    UL,OL {
           31  +	margin-right: 0em;
           32  +	margin-top: 3pt;
           33  +	margin-bottom: 3pt;
           34  +    }
           35  +    UL LI {
           36  +	list-style: disc;
           37  +    }
           38  +    OL LI {
           39  +	list-style: decimal;
           40  +    }
           41  +    DT {
           42  +	padding-top: 	1ex;
           43  +    }
           44  +    UL.doctools_toc,UL.doctools_toc UL, UL.doctools_toc UL UL {
           45  +	font:		normal 12pt/14pt sans-serif;
           46  +	list-style:	none;
           47  +    }
           48  +    LI.doctools_section, LI.doctools_subsection {
           49  +	list-style: 	none;
           50  +	margin-left: 	0em;
           51  +	text-indent:	0em;
           52  +	padding: 	0em;
           53  +    }
           54  +    PRE {
           55  +	display: 	block;
           56  +	font-family:	monospace;
           57  +	white-space:	pre;
           58  +	margin:		0%;
           59  +	padding-top:	0.5ex;
           60  +	padding-bottom:	0.5ex;
           61  +	padding-left:	1ex;
           62  +	padding-right:	1ex;
           63  +	width:		100%;
           64  +    }
           65  +    PRE.doctools_example {
           66  +	color: 		black;
           67  +	background: 	#f5dcb3;
           68  +	border:		1px solid black;
           69  +    }
           70  +    UL.doctools_requirements LI, UL.doctools_syntax LI {
           71  +	list-style: 	none;
           72  +	margin-left: 	0em;
           73  +	text-indent:	0em;
           74  +	padding:	0em;
           75  +    }
           76  +    DIV.doctools_synopsis {
           77  +	color: 		black;
           78  +	background: 	#80ffff;
           79  +	border:		1px solid black;
           80  +	font-family:	serif;
           81  +	margin-top: 	1em;
           82  +	margin-bottom: 	1em;
           83  +    }
           84  +    UL.doctools_syntax {
           85  +	margin-top: 	1em;
           86  +	border-top:	1px solid black;
           87  +    }
           88  +    UL.doctools_requirements {
           89  +	margin-bottom: 	1em;
           90  +	border-bottom:	1px solid black;
           91  +    }
           92  +</style>
           93  + <hr> [
           94  +   <a href="../../../toc.html">Main Table Of Contents</a>
           95  +| <a href="../../toc.html">Table Of Contents</a>
           96  +| <a href="../../../index.html">Keyword Index</a>
           97  +| <a href="../../../toc0.html">Categories</a>
           98  +| <a href="../../../toc1.html">Modules</a>
           99  +| <a href="../../../toc2.html">Applications</a>
          100  + ] <hr>
          101  +<div class="doctools">
          102  +<h1 class="doctools_title">tcllib_install_guide(n) 1 tcllib &quot;&quot;</h1>
          103  +<div id="name" class="doctools_section"><h2><a name="name">Name</a></h2>
          104  +<p>tcllib_install_guide - Tcllib - The Installer's Guide</p>
          105  +</div>
          106  +<div id="toc" class="doctools_section"><h2><a name="toc">Table Of Contents</a></h2>
          107  +<ul class="doctools_toc">
          108  +<li class="doctools_section"><a href="#toc">Table Of Contents</a></li>
          109  +<li class="doctools_section"><a href="#section1">Description</a></li>
          110  +<li class="doctools_section"><a href="#section2">Requisites</a>
          111  +<ul>
          112  +<li class="doctools_subsection"><a href="#subsection1">Tcl</a></li>
          113  +<li class="doctools_subsection"><a href="#subsection2">CriTcl</a></li>
          114  +</ul>
          115  +</li>
          116  +<li class="doctools_section"><a href="#section3">Build &amp; Installation Instructions</a>
          117  +<ul>
          118  +<li class="doctools_subsection"><a href="#subsection3">Unix</a></li>
          119  +<li class="doctools_subsection"><a href="#subsection4">Windows</a></li>
          120  +<li class="doctools_subsection"><a href="#subsection5">Critcl &amp; Accelerators</a></ul>
          121  +</li>
          122  +</ul>
          123  +</div>
          124  +<div id="section1" class="doctools_section"><h2><a name="section1">Description</a></h2>
          125  +<p>Welcome to Tcllib, the Tcl Standard Library. Note that Tcllib is not a
          126  +package itself. It is a collection of (semi-independent) <i class="term"><a href="../../../index.html#tcl">Tcl</a></i>
          127  +packages that provide utility functions useful to a large collection
          128  +of Tcl programmers.</p>
          129  +<p>The audience of this document is anyone wishing to build the packages,
          130  +for either themselves, or others.</p>
          131  +<p>For a developer intending to extend or modify the packages we
          132  +additionally provide</p>
          133  +<ol class="doctools_enumerated">
          134  +<li><p><i class="term">Tcllib - The Developer's Guide</i>.</p></li>
          135  +</ol>
          136  +<p>Please read <i class="term"><a href="tcllib_sources.html">Tcllib - How To Get The Sources</a></i> first, if that
          137  +was not done already. Here we assume that the sources are already
          138  +available in a directory of your choice.</p>
          139  +</div>
          140  +<div id="section2" class="doctools_section"><h2><a name="section2">Requisites</a></h2>
          141  +<p>Before Tcllib can be build and used a number of requisites must be installed.
          142  +These are:</p>
          143  +<ol class="doctools_enumerated">
          144  +<li><p>The scripting language Tcl.
          145  +       For details see <span class="sectref"><a href="#subsection1">Tcl</a></span>.</p></li>
          146  +<li><p>Optionally, the <b class="package">critcl</b> package (C embedding) for <b class="syscmd"><a href="../../../index.html#tcl">Tcl</a></b>.
          147  +       For details see <span class="sectref"><a href="#subsection2">CriTcl</a></span>.</p></li>
          148  +</ol>
          149  +<p>This list assumes that the machine where Tcllib is to be installed is
          150  +essentially clean. Of course, if parts of the dependencies listed
          151  +below are already installed the associated steps can be skipped. It is
          152  +still recommended to read their sections though, to validate that the
          153  +dependencies they talk about are indeed installed.</p>
          154  +<div id="subsection1" class="doctools_subsection"><h3><a name="subsection1">Tcl</a></h3>
          155  +<p>As we are installing a number of Tcl packages and applications it
          156  +should be pretty much obvious that a working installation of Tcl
          157  +itself is needed, and I will not belabor the point.</p>
          158  +<p>Out of the many possibilites use whatever you are comfortable
          159  +with, as long as it provides Tcl 8.2, or higher.
          160  +This may be a Tcl installation provided by your operating system
          161  +distribution, from a distribution-independent vendor, or built by
          162  +yourself.</p>
          163  +<p><em>Note</em> that the packages in Tcllib have begun to require
          164  +8.4, 8.5, and even 8.6. Older versions of Tcl will not be able to use
          165  +such packages. Trying to use them will result in
          166  +<em>package not found</em> errors, as their package index files will
          167  +not register them in versions of the core unable to use them.</p>
          168  +<p>Myself, I used (and still use)
          169  +<a href="http://www.activestate.com">ActiveState's</a>
          170  +ActiveTcl 8.5 distribution during development, as I am most familiar
          171  +with it.</p>
          172  +<p><em>(Disclosure: I, Andreas Kupries, worked for ActiveState until 2016, maintaining ActiveTcl and TclDevKit for them).</em>.
          173  +I am currently working for SUSE Software Canada ULC, although not in
          174  +Tcl-related areas.</p>
          175  +<p>This distribution can be found at
          176  +<a href="http://www.activestate.com/activetcl">http://www.activestate.com/activetcl</a>. Retrieve the archive of
          177  +ActiveTcl 8.5 (or higher) for your platform and install it as directed
          178  +by ActiveState.</p>
          179  +<p>For those wishing to build and install Tcl on their own, the
          180  +relevant sources can be found at</p>
          181  +<dl class="doctools_definitions">
          182  +<dt>Tcl</dt>
          183  +<dd><p><a href="http://core.tcl-lang.org/tcl/">http://core.tcl-lang.org/tcl/</a></p></dd>
          184  +</dl>
          185  +<p>together with the necessary instructions on how to build it.</p>
          186  +<p>If there are problems with building, installing, or using Tcl
          187  +please file a ticket against <i class="term"><a href="../../../index.html#tcl">Tcl</a></i>, or the vendor of your
          188  +distribution, and <em>not</em> <i class="term"><a href="../../../index.html#tcllib">Tcllib</a></i>.</p>
          189  +</div>
          190  +<div id="subsection2" class="doctools_subsection"><h3><a name="subsection2">CriTcl</a></h3>
          191  +<p>The <b class="syscmd">critcl</b> tool is an <em>optional</em> dependency.</p>
          192  +<p>It is only required when trying to build the C-based
          193  +<i class="term">accelerators</i> for a number of packages, as explained in
          194  +<span class="sectref"><a href="#subsection5">Critcl &amp; Accelerators</a></span></p>
          195  +<p>Tcllib's build system accepts it as an application found in the
          196  +PATH (be it starkit or starpack).</p>
          197  +<p>Tcllib requires version 2 or higher.</p>
          198  +<p>The github repository providing releases of version 2 and
          199  +higher, and the associated sources, can be found at
          200  +<a href="http://andreas-kupries.github.com/critcl">http://andreas-kupries.github.com/critcl</a>.</p>
          201  +<p>Any branch of the repository can be used (if not using the
          202  +prebuild starkit or starpack), although the use of the stable branch
          203  +<em>master</em> is recommended.</p>
          204  +<p>At the above url is also an explanation on how to build and
          205  +install CriTcl, including a list of its dependencies.</p>
          206  +<p>Its instructions will not be repeated here. If there are
          207  +problems with their directions please file a ticket against the
          208  +<i class="term">Critcl</i> project, and not Tcllib.</p>
          209  +</div>
          210  +</div>
          211  +<div id="section3" class="doctools_section"><h2><a name="section3">Build &amp; Installation Instructions</a></h2>
          212  +<div id="subsection3" class="doctools_subsection"><h3><a name="subsection3">Unix</a></h3>
          213  +<p>This section describes the actions required to install Tcllib on Unix
          214  +systems (Linux, BSD, and related, including OS X).
          215  +If you have to install Tcllib on a Windows machine instead then see
          216  +section <span class="sectref"><a href="#subsection4">Windows</a></span>.</p>
          217  +<p>Tcllib comes with a standard TEA buildsystem using a
          218  +<b class="syscmd">configure</b> script and a &quot;<b class="file">Makefile</b>&quot; generated by it.</p>
          219  +<p>To install Tcllib simply run</p>
          220  +<pre class="doctools_example">
          221  +    ./configure
          222  +    make install
          223  +</pre>
          224  +<p>in the toplevel directory of Tcllib itself. To build in a directory D
          225  +outside of Tcllib's toplevel directory simply make D the current
          226  +working directory and invoke <b class="syscmd">configure</b> with either its
          227  +absolute path or a proper relative path.</p>
          228  +<p>The above will non-interactively install all packages,
          229  +applications found in Tcllib, and their manpages, in directories
          230  +derived from what <b class="syscmd">configure</b> found out about the system.</p>
          231  +<p>The underlying tool is &quot;<b class="file">installer.tcl</b>&quot; in the toplevel
          232  +directory of Tcllib.</p>
          233  +<p>Invoking this tool via</p>
          234  +<pre class="doctools_example">
          235  +    ./installer.tcl -help
          236  +</pre>
          237  +<p>will provide a short list of the available options. For more examples
          238  +see the various <i class="term">install</i> targets found in &quot;<b class="file">Makefile.in</b>&quot;.</p>
          239  +</div>
          240  +<div id="subsection4" class="doctools_subsection"><h3><a name="subsection4">Windows</a></h3>
          241  +<p>This section describes the actions required to install Tcllib on Windows(tm)
          242  +systems.
          243  +If you have to install Tcllib on a Unix machine (Linux, BSD, and
          244  +related, including OS X) instead then see section <span class="sectref"><a href="#subsection3">Unix</a></span>.</p>
          245  +<p>If the build environment is based on <i class="term">MSYS</i>,
          246  +<i class="term">cygwin</i>, or a similar emulation of a unix environment, then
          247  +<span class="sectref"><a href="#subsection3">Unix</a></span> still applies and should be used.</p>
          248  +<p>Alternatively, as mentioned in the previous section, the tool
          249  +underneath of the unix buildsystem is the <i class="term"><a href="../../../index.html#tcl">Tcl</a></i>-based
          250  +&quot;<b class="file">installer.tcl</b>&quot; script.</p>
          251  +<p>Invoking this tool from a DOS shell via</p>
          252  +<pre class="doctools_example">
          253  +    /path/to/tclsh ./installer.tcl -help
          254  +</pre>
          255  +<p>will provide a short list of the available options. For more examples
          256  +see the various <i class="term">install</i> targets found in &quot;<b class="file">Makefile.in</b>&quot;.
          257  +Invoking this tool without any arguments, i.e. like</p>
          258  +<pre class="doctools_example">
          259  +    /path/to/tclsh ./installer.tcl
          260  +</pre>
          261  +<p>will start a non-interactive installation showing its progress in a
          262  +Tk-based graphical interface. The directories to install the packages,
          263  +applications, etc. into are derived from the location of the
          264  +<b class="syscmd">tclsh</b> used to invoke the script, and where it expects
          265  +packages.</p>
          266  +</div>
          267  +<div id="subsection5" class="doctools_subsection"><h3><a name="subsection5">Critcl &amp; Accelerators</a></h3>
          268  +<p>A number of packages come with <i class="term">accelerators</i>, i.e.
          269  +<b class="syscmd">critcl</b>-based C code whose use will boost the performance of
          270  +the packages using them. As these accelerators are optional they are
          271  +not installed by default.</p>
          272  +<p>To build the accelerators the normally optional dependency on
          273  +<b class="syscmd">critcl</b> becomes required.</p>
          274  +<p>To install Tcllib with the accelerators run</p>
          275  +<pre class="doctools_example">
          276  +    ./configure
          277  +    make critcl # This builds the shared library holding the accelerators
          278  +    make install
          279  +</pre>
          280  +<p>The underlying tool is &quot;<b class="file">sak.tcl</b>&quot; in the toplevel directory
          281  +of Tcllib and the command <b class="cmd">make critcl</b> is just a wrapper around</p>
          282  +<pre class="doctools_example">
          283  +    ./sak.tcl critcl
          284  +</pre>
          285  +</div>
          286  +</div>
          287  +</div>

Added embedded/www/tcllib/files/devdoc/tcllib_license.html.

            1  +
            2  +<div class='fossil-doc' data-title='tcllib_license - '>
            3  +<style>
            4  +    HTML {
            5  +	background: 	#FFFFFF;
            6  +	color: 		black;
            7  +    }
            8  +    BODY {
            9  +	background: 	#FFFFFF;
           10  +	color:	 	black;
           11  +    }
           12  +    DIV.doctools {
           13  +	margin-left:	10%;
           14  +	margin-right:	10%;
           15  +    }
           16  +    DIV.doctools H1,DIV.doctools H2 {
           17  +	margin-left:	-5%;
           18  +    }
           19  +    H1, H2, H3, H4 {
           20  +	margin-top: 	1em;
           21  +	font-family:	sans-serif;
           22  +	font-size:	large;
           23  +	color:		#005A9C;
           24  +	background: 	transparent;
           25  +	text-align:		left;
           26  +    }
           27  +    H1.doctools_title {
           28  +	text-align: center;
           29  +    }
           30  +    UL,OL {
           31  +	margin-right: 0em;
           32  +	margin-top: 3pt;
           33  +	margin-bottom: 3pt;
           34  +    }
           35  +    UL LI {
           36  +	list-style: disc;
           37  +    }
           38  +    OL LI {
           39  +	list-style: decimal;
           40  +    }
           41  +    DT {
           42  +	padding-top: 	1ex;
           43  +    }
           44  +    UL.doctools_toc,UL.doctools_toc UL, UL.doctools_toc UL UL {
           45  +	font:		normal 12pt/14pt sans-serif;
           46  +	list-style:	none;
           47  +    }
           48  +    LI.doctools_section, LI.doctools_subsection {
           49  +	list-style: 	none;
           50  +	margin-left: 	0em;
           51  +	text-indent:	0em;
           52  +	padding: 	0em;
           53  +    }
           54  +    PRE {
           55  +	display: 	block;
           56  +	font-family:	monospace;
           57  +	white-space:	pre;
           58  +	margin:		0%;
           59  +	padding-top:	0.5ex;
           60  +	padding-bottom:	0.5ex;
           61  +	padding-left:	1ex;
           62  +	padding-right:	1ex;
           63  +	width:		100%;
           64  +    }
           65  +    PRE.doctools_example {
           66  +	color: 		black;
           67  +	background: 	#f5dcb3;
           68  +	border:		1px solid black;
           69  +    }
           70  +    UL.doctools_requirements LI, UL.doctools_syntax LI {
           71  +	list-style: 	none;
           72  +	margin-left: 	0em;
           73  +	text-indent:	0em;
           74  +	padding:	0em;
           75  +    }
           76  +    DIV.doctools_synopsis {
           77  +	color: 		black;
           78  +	background: 	#80ffff;
           79  +	border:		1px solid black;
           80  +	font-family:	serif;
           81  +	margin-top: 	1em;
           82  +	margin-bottom: 	1em;
           83  +    }
           84  +    UL.doctools_syntax {
           85  +	margin-top: 	1em;
           86  +	border-top:	1px solid black;
           87  +    }
           88  +    UL.doctools_requirements {
           89  +	margin-bottom: 	1em;
           90  +	border-bottom:	1px solid black;
           91  +    }
           92  +</style>
           93  + <hr> [
           94  +   <a href="../../../toc.html">Main Table Of Contents</a>
           95  +| <a href="../../toc.html">Table Of Contents</a>
           96  +| <a href="../../../index.html">Keyword Index</a>
           97  +| <a href="../../../toc0.html">Categories</a>
           98  +| <a href="../../../toc1.html">Modules</a>
           99  +| <a href="../../../toc2.html">Applications</a>
          100  + ] <hr>
          101  +<div class="doctools">
          102  +<h1 class="doctools_title">tcllib_license(n) 1 tcllib &quot;&quot;</h1>
          103  +<div id="name" class="doctools_section"><h2><a name="name">Name</a></h2>
          104  +<p>tcllib_license - Tcllib - License</p>
          105  +</div>
          106  +<div id="toc" class="doctools_section"><h2><a name="toc">Table Of Contents</a></h2>
          107  +<ul class="doctools_toc">
          108  +<li class="doctools_section"><a href="#toc">Table Of Contents</a></li>
          109  +<li class="doctools_section"><a href="#section1">Description</a></li>
          110  +<li class="doctools_section"><a href="#section2">License</a></li>
          111  +</ul>
          112  +</div>
          113  +<div id="section1" class="doctools_section"><h2><a name="section1">Description</a></h2>
          114  +<p>Welcome to Tcllib, the Tcl Standard Library. Note that Tcllib is not a
          115  +package itself. It is a collection of (semi-independent) <i class="term"><a href="../../../index.html#tcl">Tcl</a></i>
          116  +packages that provide utility functions useful to a large collection
          117  +of Tcl programmers.</p>
          118  +<p>The collection is under the BSD license.</p>
          119  +</div>
          120  +<div id="section2" class="doctools_section"><h2><a name="section2">License</a></h2>
          121  +<p>This software is copyrighted by Ajuba Solutions and other parties.
          122  +The following terms apply to all files associated with the software
          123  +unless explicitly disclaimed in individual files.</p>
          124  +<p>The authors hereby grant permission to use, copy, modify, distribute,
          125  +and license this software and its documentation for any purpose,
          126  +provided that existing copyright notices are retained in all copies
          127  +and that this notice is included verbatim in any distributions. No
          128  +written agreement, license, or royalty fee is required for any of the
          129  +authorized uses.  Modifications to this software may be copyrighted by
          130  +their authors and need not follow the licensing terms described here,
          131  +provided that the new terms are clearly indicated on the first page of
          132  +each file where they apply.</p>
          133  +<p>IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY
          134  +FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
          135  +ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY
          136  +DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE
          137  +POSSIBILITY OF SUCH DAMAGE.</p>
          138  +<p>THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
          139  +INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
          140  +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND
          141  +NON-INFRINGEMENT.  THIS SOFTWARE IS PROVIDED ON AN &quot;AS IS&quot; BASIS, AND
          142  +THE AUTHORS AND DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE
          143  +MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.</p>
          144  +<p>GOVERNMENT USE: If you are acquiring this software on behalf of the
          145  +U.S. government, the Government shall have only &quot;Restricted Rights&quot; in
          146  +the software and related documentation as defined in the Federal
          147  +Acquisition Regulations (FARs) in Clause 52.227.19 (c) (2).  If you
          148  +are acquiring the software on behalf of the Department of Defense, the
          149  +software shall be classified as &quot;Commercial Computer Software&quot; and the
          150  +Government shall have only &quot;Restricted Rights&quot; as defined in Clause
          151  +252.227-7013 (c) (1) of DFARs.  Notwithstanding the foregoing, the
          152  +authors grant the U.S. Government and others acting in its behalf
          153  +permission to use and distribute the software in accordance with the
          154  +terms specified in this license.</p>
          155  +</div>
          156  +</div>

Added embedded/www/tcllib/files/devdoc/tcllib_sources.html.

            1  +
            2  +<div class='fossil-doc' data-title='tcllib_sources - '>
            3  +<style>
            4  +    HTML {
            5  +	background: 	#FFFFFF;
            6  +	color: 		black;
            7  +    }
            8  +    BODY {
            9  +	background: 	#FFFFFF;
           10  +	color:	 	black;
           11  +    }
           12  +    DIV.doctools {
           13  +	margin-left:	10%;
           14  +	margin-right:	10%;
           15  +    }
           16  +    DIV.doctools H1,DIV.doctools H2 {
           17  +	margin-left:	-5%;
           18  +    }
           19  +    H1, H2, H3, H4 {
           20  +	margin-top: 	1em;
           21  +	font-family:	sans-serif;
           22  +	font-size:	large;
           23  +	color:		#005A9C;
           24  +	background: 	transparent;
           25  +	text-align:		left;
           26  +    }
           27  +    H1.doctools_title {
           28  +	text-align: center;
           29  +    }
           30  +    UL,OL {
           31  +	margin-right: 0em;
           32  +	margin-top: 3pt;
           33  +	margin-bottom: 3pt;
           34  +    }
           35  +    UL LI {
           36  +	list-style: disc;
           37  +    }
           38  +    OL LI {
           39  +	list-style: decimal;
           40  +    }
           41  +    DT {
           42  +	padding-top: 	1ex;
           43  +    }
           44  +    UL.doctools_toc,UL.doctools_toc UL, UL.doctools_toc UL UL {
           45  +	font:		normal 12pt/14pt sans-serif;
           46  +	list-style:	none;
           47  +    }
           48  +    LI.doctools_section, LI.doctools_subsection {
           49  +	list-style: 	none;
           50  +	margin-left: 	0em;
           51  +	text-indent:	0em;
           52  +	padding: 	0em;
           53  +    }
           54  +    PRE {
           55  +	display: 	block;
           56  +	font-family:	monospace;
           57  +	white-space:	pre;
           58  +	margin:		0%;
           59  +	padding-top:	0.5ex;
           60  +	padding-bottom:	0.5ex;
           61  +	padding-left:	1ex;
           62  +	padding-right:	1ex;
           63  +	width:		100%;
           64  +    }
           65  +    PRE.doctools_example {
           66  +	color: 		black;
           67  +	background: 	#f5dcb3;
           68  +	border:		1px solid black;
           69  +    }
           70  +    UL.doctools_requirements LI, UL.doctools_syntax LI {
           71  +	list-style: 	none;
           72  +	margin-left: 	0em;
           73  +	text-indent:	0em;
           74  +	padding:	0em;
           75  +    }
           76  +    DIV.doctools_synopsis {
           77  +	color: 		black;
           78  +	background: 	#80ffff;
           79  +	border:		1px solid black;
           80  +	font-family:	serif;
           81  +	margin-top: 	1em;
           82  +	margin-bottom: 	1em;
           83  +    }
           84  +    UL.doctools_syntax {
           85  +	margin-top: 	1em;
           86  +	border-top:	1px solid black;
           87  +    }
           88  +    UL.doctools_requirements {
           89  +	margin-bottom: 	1em;
           90  +	border-bottom:	1px solid black;
           91  +    }
           92  +</style>
           93  + <hr> [
           94  +   <a href="../../../toc.html">Main Table Of Contents</a>
           95  +| <a href="../../toc.html">Table Of Contents</a>
           96  +| <a href="../../../index.html">Keyword Index</a>
           97  +| <a href="../../../toc0.html">Categories</a>
           98  +| <a href="../../../toc1.html">Modules</a>
           99  +| <a href="../../../toc2.html">Applications</a>
          100  + ] <hr>
          101  +<div class="doctools">
          102  +<h1 class="doctools_title">tcllib_sources(n) 1 tcllib &quot;&quot;</h1>
          103  +<div id="name" class="doctools_section"><h2><a name="name">Name</a></h2>
          104  +<p>tcllib_sources - Tcllib - How To Get The Sources</p>
          105  +</div>
          106  +<div id="toc" class="doctools_section"><h2><a name="toc">Table Of Contents</a></h2>
          107  +<ul class="doctools_toc">
          108  +<li class="doctools_section"><a href="#toc">Table Of Contents</a></li>
          109  +<li class="doctools_section"><a href="#section1">Description</a></li>
          110  +<li class="doctools_section"><a href="#section2">Source Location</a></li>
          111  +<li class="doctools_section"><a href="#section3">Retrieval</a></li>
          112  +<li class="doctools_section"><a href="#section4">Source Code Management</a></li>
          113  +</ul>
          114  +</div>
          115  +<div id="section1" class="doctools_section"><h2><a name="section1">Description</a></h2>
          116  +<p>Welcome to Tcllib, the Tcl Standard Library. Note that Tcllib is not a
          117  +package itself. It is a collection of (semi-independent) <i class="term"><a href="../../../index.html#tcl">Tcl</a></i>
          118  +packages that provide utility functions useful to a large collection
          119  +of Tcl programmers.</p>
          120  +<p>The audience of this document is anyone wishing to either have just a
          121  +look at Tcllib's source code, or build the packages, or to extend and
          122  +modify them.</p>
          123  +<p>For builders and developers we additionally provide</p>
          124  +<ol class="doctools_enumerated">
          125  +<li><p><i class="term"><a href="tcllib_installer.html">Tcllib - The Installer's Guide</a></i>.</p></li>
          126  +<li><p><i class="term">Tcllib - The Developer's Guide</i>.</p></li>
          127  +</ol>
          128  +<p>respectively.</p>
          129  +</div>
          130  +<div id="section2" class="doctools_section"><h2><a name="section2">Source Location</a></h2>
          131  +<p>The official repository for Tcllib can be found at
          132  +<a href="http://core.tcl-lang.org/tcllib">http://core.tcl-lang.org/tcllib</a></p>
          133  +</div>
          134  +<div id="section3" class="doctools_section"><h2><a name="section3">Retrieval</a></h2>
          135  +<p>Assuming that you simply wish to look at the sources, or build a
          136  +specific revision, the easiest way of retrieving it is to:</p>
          137  +<ol class="doctools_enumerated">
          138  +<li><p>Log into this site, as &quot;anonymous&quot;, using the semi-random password in the captcha.</p></li>
          139  +<li><p>Go to the &quot;Timeline&quot;.</p></li>
          140  +<li><p>Choose the revision you wish to have and</p></li>
          141  +<li><p>follow its link to its detailed information page.</p></li>
          142  +<li><p>On that page, choose either the &quot;ZIP&quot; or &quot;Tarball&quot; link to get
          143  +a copy of this revision in the format of your choice.</p></li>
          144  +</ol>
          145  +</div>
          146  +<div id="section4" class="doctools_section"><h2><a name="section4">Source Code Management</a></h2>
          147  +<p>For the curious (or a developer-to-be), the sources are managed by the
          148  +<a href="http://www.fossil-scm.org">Fossil SCM</a>.
          149  +Binaries for popular platforms can be found directly at its
          150  +<a href="http://www.fossil-scm.org/download.html">download page</a>.</p>
          151  +<p>With that tool available the full history can be retrieved via:</p>
          152  +<pre class="doctools_example">
          153  +    fossil clone  http://core.tcl-lang.org/tcllib  tcllib.fossil
          154  +</pre>
          155  +<p>followed by</p>
          156  +<pre class="doctools_example">
          157  +    mkdir tcllib
          158  +    cd tcllib
          159  +    fossil open ../tcllib.fossil
          160  +</pre>
          161  +<p>to get a checkout of the head of the trunk.</p>
          162  +</div>
          163  +</div>

Changes to embedded/www/tcllib/toc.html.

  1519   1519   <td class="#doctools_tocright">Implementation of the DES and triple-DES ciphers</td>
  1520   1520   </tr>
  1521   1521   <tr class="#doctools_tocodd"  >
  1522   1522   <td class="#doctools_tocleft" ><a name='tcldocstrip'><a href="files/apps/tcldocstrip.html">tcldocstrip</a></td>
  1523   1523   <td class="#doctools_tocright">Tcl-based Docstrip Processor</td>
  1524   1524   </tr>
  1525   1525   <tr class="#doctools_toceven" >
         1526  +<td class="#doctools_tocleft" ><a name='tcllib_install_guide'><a href="files/devdoc/tcllib_installer.html">tcllib_install_guide</a></td>
         1527  +<td class="#doctools_tocright">Tcllib - The Installer's Guide</td>
         1528  +</tr>
         1529  +<tr class="#doctools_tocodd"  >
  1526   1530   <td class="#doctools_tocleft" ><a name='tcllib_ip'><a href="files/modules/dns/tcllib_ip.html">tcllib_ip</a></td>
  1527   1531   <td class="#doctools_tocright">IPv4 and IPv6 address manipulation</td>
  1528   1532   </tr>
         1533  +<tr class="#doctools_toceven" >
         1534  +<td class="#doctools_tocleft" ><a name='tcllib_license'><a href="files/devdoc/tcllib_license.html">tcllib_license</a></td>
         1535  +<td class="#doctools_tocright">Tcllib - License</td>
         1536  +</tr>
  1529   1537   <tr class="#doctools_tocodd"  >
         1538  +<td class="#doctools_tocleft" ><a name='tcllib_sources'><a href="files/devdoc/tcllib_sources.html">tcllib_sources</a></td>
         1539  +<td class="#doctools_tocright">Tcllib - How To Get The Sources</td>
         1540  +</tr>
         1541  +<tr class="#doctools_toceven" >
  1530   1542   <td class="#doctools_tocleft" ><a name='tclrep_machineparameters'><a href="files/modules/math/machineparameters.html">tclrep/machineparameters</a></td>
  1531   1543   <td class="#doctools_tocright">Compute double precision machine parameters.</td>
  1532   1544   </tr>
  1533         -<tr class="#doctools_toceven" >
         1545  +<tr class="#doctools_tocodd"  >
  1534   1546   <td class="#doctools_tocleft" ><a name='tepam'><a href="files/modules/tepam/tepam_introduction.html">tepam</a></td>
  1535   1547   <td class="#doctools_tocright">An introduction into TEPAM, Tcl's Enhanced Procedure and Argument Manager</td>
  1536   1548   </tr>
  1537         -<tr class="#doctools_tocodd"  >
         1549  +<tr class="#doctools_toceven" >
  1538   1550   <td class="#doctools_tocleft" ><a name='tepam_argument_dialogbox'><a href="files/modules/tepam/tepam_argument_dialogbox.html">tepam::argument_dialogbox</a></td>
  1539   1551   <td class="#doctools_tocright">TEPAM argument_dialogbox, reference manual</td>
  1540   1552   </tr>
  1541         -<tr class="#doctools_toceven" >
         1553  +<tr class="#doctools_tocodd"  >
  1542   1554   <td class="#doctools_tocleft" ><a name='tepam_doc_gen'><a href="files/modules/tepam/tepam_doc_gen.html">tepam::doc_gen</a></td>
  1543   1555   <td class="#doctools_tocright">TEPAM DOC Generation, reference manual</td>
  1544   1556   </tr>
  1545         -<tr class="#doctools_tocodd"  >
         1557  +<tr class="#doctools_toceven" >
  1546   1558   <td class="#doctools_tocleft" ><a name='tepam_procedure'><a href="files/modules/tepam/tepam_procedure.html">tepam::procedure</a></td>
  1547   1559   <td class="#doctools_tocright">TEPAM procedure, reference manual</td>
  1548   1560   </tr>
  1549         -<tr class="#doctools_toceven" >
         1561  +<tr class="#doctools_tocodd"  >
  1550   1562   <td class="#doctools_tocleft" ><a name='term'><a href="files/modules/term/term.html">term</a></td>
  1551   1563   <td class="#doctools_tocright">General terminal control</td>
  1552   1564   </tr>
  1553         -<tr class="#doctools_tocodd"  >
         1565  +<tr class="#doctools_toceven" >
  1554   1566   <td class="#doctools_tocleft" ><a name='term_ansi_code'><a href="files/modules/term/ansi_code.html">term::ansi::code</a></td>
  1555   1567   <td class="#doctools_tocright">Helper for control sequences</td>
  1556   1568   </tr>
  1557         -<tr class="#doctools_toceven" >
         1569  +<tr class="#doctools_tocodd"  >
  1558   1570   <td class="#doctools_tocleft" ><a name='term_ansi_code_attr'><a href="files/modules/term/ansi_cattr.html">term::ansi::code::attr</a></td>
  1559   1571   <td class="#doctools_tocright">ANSI attribute sequences</td>
  1560   1572   </tr>
  1561         -<tr class="#doctools_tocodd"  >
         1573  +<tr class="#doctools_toceven" >
  1562   1574   <td class="#doctools_tocleft" ><a name='term_ansi_code_ctrl'><a href="files/modules/term/ansi_cctrl.html">term::ansi::code::ctrl</a></td>
  1563   1575   <td class="#doctools_tocright">ANSI control sequences</td>
  1564   1576   </tr>
  1565         -<tr class="#doctools_toceven" >
         1577  +<tr class="#doctools_tocodd"  >
  1566   1578   <td class="#doctools_tocleft" ><a name='term_ansi_code_macros'><a href="files/modules/term/ansi_cmacros.html">term::ansi::code::macros</a></td>
  1567   1579   <td class="#doctools_tocright">Macro sequences</td>
  1568   1580   </tr>
  1569         -<tr class="#doctools_tocodd"  >
         1581  +<tr class="#doctools_toceven" >
  1570   1582   <td class="#doctools_tocleft" ><a name='term_ansi_ctrl_unix'><a href="files/modules/term/ansi_ctrlu.html">term::ansi::ctrl::unix</a></td>
  1571   1583   <td class="#doctools_tocright">Control operations and queries</td>
  1572   1584   </tr>
  1573         -<tr class="#doctools_toceven" >
         1585  +<tr class="#doctools_tocodd"  >
  1574   1586   <td class="#doctools_tocleft" ><a name='term_ansi_send'><a href="files/modules/term/ansi_send.html">term::ansi::send</a></td>
  1575   1587   <td class="#doctools_tocright">Output of ANSI control sequences to terminals</td>
  1576   1588   </tr>
  1577         -<tr class="#doctools_tocodd"  >
         1589  +<tr class="#doctools_toceven" >
  1578   1590   <td class="#doctools_tocleft" ><a name='term_interact_menu'><a href="files/modules/term/imenu.html">term::interact::menu</a></td>
  1579   1591   <td class="#doctools_tocright">Terminal widget, menu</td>
  1580   1592   </tr>
  1581         -<tr class="#doctools_toceven" >
         1593  +<tr class="#doctools_tocodd"  >
  1582   1594   <td class="#doctools_tocleft" ><a name='term_interact_pager'><a href="files/modules/term/ipager.html">term::interact::pager</a></td>
  1583   1595   <td class="#doctools_tocright">Terminal widget, paging</td>
  1584   1596   </tr>
  1585         -<tr class="#doctools_tocodd"  >
         1597  +<tr class="#doctools_toceven" >
  1586   1598   <td class="#doctools_tocleft" ><a name='term_receive'><a href="files/modules/term/receive.html">term::receive</a></td>
  1587   1599   <td class="#doctools_tocright">General input from terminals</td>
  1588   1600   </tr>
  1589         -<tr class="#doctools_toceven" >
         1601  +<tr class="#doctools_tocodd"  >
  1590   1602   <td class="#doctools_tocleft" ><a name='term_receive_bind'><a href="files/modules/term/term_bind.html">term::receive::bind</a></td>
  1591   1603   <td class="#doctools_tocright">Keyboard dispatch from terminals</td>
  1592   1604   </tr>
  1593         -<tr class="#doctools_tocodd"  >
         1605  +<tr class="#doctools_toceven" >
  1594   1606   <td class="#doctools_tocleft" ><a name='term_send'><a href="files/modules/term/term_send.html">term::send</a></td>
  1595   1607   <td class="#doctools_tocright">General output to terminals</td>
  1596   1608   </tr>
  1597         -<tr class="#doctools_toceven" >
         1609  +<tr class="#doctools_tocodd"  >
  1598   1610   <td class="#doctools_tocleft" ><a name='textutil'><a href="files/modules/textutil/textutil.html">textutil</a></td>
  1599   1611   <td class="#doctools_tocright">Procedures to manipulate texts and strings.</td>
  1600   1612   </tr>
  1601         -<tr class="#doctools_tocodd"  >
         1613  +<tr class="#doctools_toceven" >
  1602   1614   <td class="#doctools_tocleft" ><a name='textutil_adjust'><a href="files/modules/textutil/adjust.html">textutil::adjust</a></td>
  1603   1615   <td class="#doctools_tocright">Procedures to adjust, indent, and undent paragraphs</td>
  1604   1616   </tr>
  1605         -<tr class="#doctools_toceven" >
         1617  +<tr class="#doctools_tocodd"  >
  1606   1618   <td class="#doctools_tocleft" ><a name='textutil_expander'><a href="files/modules/textutil/expander.html">textutil::expander</a></td>
  1607   1619   <td class="#doctools_tocright">Procedures to process templates and expand text.</td>
  1608   1620   </tr>
  1609         -<tr class="#doctools_tocodd"  >
         1621  +<tr class="#doctools_toceven" >
  1610   1622   <td class="#doctools_tocleft" ><a name='textutil_repeat'><a href="files/modules/textutil/repeat.html">textutil::repeat</a></td>
  1611   1623   <td class="#doctools_tocright">Procedures to repeat strings.</td>
  1612   1624   </tr>
  1613         -<tr class="#doctools_toceven" >
         1625  +<tr class="#doctools_tocodd"  >
  1614   1626   <td class="#doctools_tocleft" ><a name='textutil_split'><a href="files/modules/textutil/textutil_split.html">textutil::split</a></td>
  1615   1627   <td class="#doctools_tocright">Procedures to split texts</td>
  1616   1628   </tr>
  1617         -<tr class="#doctools_tocodd"  >
         1629  +<tr class="#doctools_toceven" >
  1618   1630   <td class="#doctools_tocleft" ><a name='textutil_string'><a href="files/modules/textutil/textutil_string.html">textutil::string</a></td>
  1619   1631   <td class="#doctools_tocright">Procedures to manipulate texts and strings.</td>
  1620   1632   </tr>
  1621         -<tr class="#doctools_toceven" >
         1633  +<tr class="#doctools_tocodd"  >
  1622   1634   <td class="#doctools_tocleft" ><a name='textutil_tabify'><a href="files/modules/textutil/tabify.html">textutil::tabify</a></td>
  1623   1635   <td class="#doctools_tocright">Procedures to (un)tabify strings</td>
  1624   1636   </tr>
  1625         -<tr class="#doctools_tocodd"  >
         1637  +<tr class="#doctools_toceven" >
  1626   1638   <td class="#doctools_tocleft" ><a name='textutil_trim'><a href="files/modules/textutil/trim.html">textutil::trim</a></td>
  1627   1639   <td class="#doctools_tocright">Procedures to trim strings</td>
  1628   1640   </tr>
  1629         -<tr class="#doctools_toceven" >
         1641  +<tr class="#doctools_tocodd"  >
  1630   1642   <td class="#doctools_tocleft" ><a name='throw'><a href="files/modules/try/tcllib_throw.html">throw</a></td>
  1631   1643   <td class="#doctools_tocright">throw - Throw an error exception with a message</td>
  1632   1644   </tr>
  1633         -<tr class="#doctools_tocodd"  >
         1645  +<tr class="#doctools_toceven" >
  1634   1646   <td class="#doctools_tocleft" ><a name='tie'><a href="files/modules/tie/tie_std.html">tie</a></td>
  1635   1647   <td class="#doctools_tocright">Array persistence, standard data sources</td>
  1636   1648   </tr>
  1637         -<tr class="#doctools_toceven" >
         1649  +<tr class="#doctools_tocodd"  >
  1638   1650   <td class="#doctools_tocleft" ><a name='tie'><a href="files/modules/tie/tie.html">tie</a></td>
  1639   1651   <td class="#doctools_tocright">Array persistence</td>
  1640   1652   </tr>
  1641         -<tr class="#doctools_tocodd"  >
         1653  +<tr class="#doctools_toceven" >
  1642   1654   <td class="#doctools_tocleft" ><a name='tiff'><a href="files/modules/tiff/tiff.html">tiff</a></td>
  1643   1655   <td class="#doctools_tocright">TIFF reading, writing, and querying and manipulation of meta data</td>
  1644   1656   </tr>
  1645         -<tr class="#doctools_toceven" >
         1657  +<tr class="#doctools_tocodd"  >
  1646   1658   <td class="#doctools_tocleft" ><a name='tool'><a href="files/modules/httpd/httpd.html">tool</a></td>
  1647   1659   <td class="#doctools_tocright">A TclOO and coroutine based web server</td>
  1648   1660   </tr>
  1649         -<tr class="#doctools_tocodd"  >
         1661  +<tr class="#doctools_toceven" >
  1650   1662   <td class="#doctools_tocleft" ><a name='tool'><a href="files/modules/tool/tool.html">tool</a></td>
  1651   1663   <td class="#doctools_tocright">TclOO Library (TOOL) Framework</td>
  1652   1664   </tr>
  1653         -<tr class="#doctools_toceven" >
         1665  +<tr class="#doctools_tocodd"  >
  1654   1666   <td class="#doctools_tocleft" ><a name='tool_dict_ensemble'><a href="files/modules/tool/tool_dict_ensemble.html">tool::dict_ensemble</a></td>
  1655   1667   <td class="#doctools_tocright">Dictionary Tools</td>
  1656   1668   </tr>
  1657         -<tr class="#doctools_tocodd"  >
         1669  +<tr class="#doctools_toceven" >
  1658   1670   <td class="#doctools_tocleft" ><a name='transfer_connect'><a href="files/modules/transfer/connect.html">transfer::connect</a></td>
  1659   1671   <td class="#doctools_tocright">Connection setup</td>
  1660   1672   </tr>
  1661         -<tr class="#doctools_toceven" >
         1673  +<tr class="#doctools_tocodd"  >
  1662   1674   <td class="#doctools_tocleft" ><a name='transfer_copy'><a href="files/modules/transfer/copyops.html">transfer::copy</a></td>
  1663   1675   <td class="#doctools_tocright">Data transfer foundation</td>
  1664   1676   </tr>
  1665         -<tr class="#doctools_tocodd"  >
         1677  +<tr class="#doctools_toceven" >
  1666   1678   <td class="#doctools_tocleft" ><a name='transfer_copy_queue'><a href="files/modules/transfer/tqueue.html">transfer::copy::queue</a></td>
  1667   1679   <td class="#doctools_tocright">Queued transfers</td>
  1668   1680   </tr>
  1669         -<tr class="#doctools_toceven" >
         1681  +<tr class="#doctools_tocodd"  >
  1670   1682   <td class="#doctools_tocleft" ><a name='transfer_data_destination'><a href="files/modules/transfer/ddest.html">transfer::data::destination</a></td>
  1671   1683   <td class="#doctools_tocright">Data destination</td>
  1672   1684   </tr>
  1673         -<tr class="#doctools_tocodd"  >
         1685  +<tr class="#doctools_toceven" >
  1674   1686   <td class="#doctools_tocleft" ><a name='transfer_data_source'><a href="files/modules/transfer/dsource.html">transfer::data::source</a></td>
  1675   1687   <td class="#doctools_tocright">Data source</td>
  1676   1688   </tr>
  1677         -<tr class="#doctools_toceven" >
         1689  +<tr class="#doctools_tocodd"  >
  1678   1690   <td class="#doctools_tocleft" ><a name='transfer_receiver'><a href="files/modules/transfer/receiver.html">transfer::receiver</a></td>
  1679   1691   <td class="#doctools_tocright">Data source</td>
  1680   1692   </tr>
  1681         -<tr class="#doctools_tocodd"  >
         1693  +<tr class="#doctools_toceven" >
  1682   1694   <td class="#doctools_tocleft" ><a name='transfer_transmitter'><a href="files/modules/transfer/transmitter.html">transfer::transmitter</a></td>
  1683   1695   <td class="#doctools_tocright">Data source</td>
  1684   1696   </tr>
  1685         -<tr class="#doctools_toceven" >
         1697  +<tr class="#doctools_tocodd"  >
  1686   1698   <td class="#doctools_tocleft" ><a name='treeql'><a href="files/modules/treeql/treeql.html">treeql</a></td>
  1687   1699   <td class="#doctools_tocright">Query tree objects</td>
  1688   1700   </tr>
  1689         -<tr class="#doctools_tocodd"  >
         1701  +<tr class="#doctools_toceven" >
  1690   1702   <td class="#doctools_tocleft" ><a name='try'><a href="files/modules/try/tcllib_try.html">try</a></td>
  1691   1703   <td class="#doctools_tocright">try - Trap and process errors and exceptions</td>
  1692   1704   </tr>
  1693         -<tr class="#doctools_toceven" >
         1705  +<tr class="#doctools_tocodd"  >
  1694   1706   <td class="#doctools_tocleft" ><a name='udpcluster'><a href="files/modules/udpcluster/udpcluster.html">udpcluster</a></td>
  1695   1707   <td class="#doctools_tocright">UDP Peer-to-Peer cluster</td>
  1696   1708   </tr>
  1697         -<tr class="#doctools_tocodd"  >
         1709  +<tr class="#doctools_toceven" >
  1698   1710   <td class="#doctools_tocleft" ><a name='uevent'><a href="files/modules/uev/uevent.html">uevent</a></td>
  1699   1711   <td class="#doctools_tocright">User events</td>
  1700   1712   </tr>
  1701         -<tr class="#doctools_toceven" >
         1713  +<tr class="#doctools_tocodd"  >
  1702   1714   <td class="#doctools_tocleft" ><a name='uevent_onidle'><a href="files/modules/uev/uevent_onidle.html">uevent::onidle</a></td>
  1703   1715   <td class="#doctools_tocright">Request merging and deferal to idle time</td>
  1704   1716   </tr>
  1705         -<tr class="#doctools_tocodd"  >
         1717  +<tr class="#doctools_toceven" >
  1706   1718   <td class="#doctools_tocleft" ><a name='unicode'><a href="files/modules/stringprep/unicode.html">unicode</a></td>
  1707   1719   <td class="#doctools_tocright">Implementation of Unicode normalization</td>
  1708   1720   </tr>
  1709         -<tr class="#doctools_toceven" >
         1721  +<tr class="#doctools_tocodd"  >
  1710   1722   <td class="#doctools_tocleft" ><a name='unicode_data'><a href="files/modules/stringprep/unicode_data.html">unicode::data</a></td>
  1711   1723   <td class="#doctools_tocright">unicode data tables, generated, internal</td>
  1712   1724   </tr>
  1713         -<tr class="#doctools_tocodd"  >
         1725  +<tr class="#doctools_toceven" >
  1714   1726   <td class="#doctools_tocleft" ><a name='units'><a href="files/modules/units/units.html">units</a></td>
  1715   1727   <td class="#doctools_tocright">unit conversion</td>
  1716   1728   </tr>
  1717         -<tr class="#doctools_toceven" >
         1729  +<tr class="#doctools_tocodd"  >
  1718   1730   <td class="#doctools_tocleft" ><a name='uri'><a href="files/modules/uri/uri.html">uri</a></td>
  1719   1731   <td class="#doctools_tocright">URI utilities</td>
  1720   1732   </tr>
  1721         -<tr class="#doctools_tocodd"  >
         1733  +<tr class="#doctools_toceven" >
  1722   1734   <td class="#doctools_tocleft" ><a name='uri_urn'><a href="files/modules/uri/urn-scheme.html">uri_urn</a></td>
  1723   1735   <td class="#doctools_tocright">URI utilities, URN scheme</td>
  1724   1736   </tr>
  1725         -<tr class="#doctools_toceven" >
         1737  +<tr class="#doctools_tocodd"  >
  1726   1738   <td class="#doctools_tocleft" ><a name='uuencode'><a href="files/modules/base64/uuencode.html">uuencode</a></td>
  1727   1739   <td class="#doctools_tocright">UU-encode/decode binary data</td>
  1728   1740   </tr>
  1729         -<tr class="#doctools_tocodd"  >
         1741  +<tr class="#doctools_toceven" >
  1730   1742   <td class="#doctools_tocleft" ><a name='uuid'><a href="files/modules/uuid/uuid.html">uuid</a></td>
  1731   1743   <td class="#doctools_tocright">UUID generation and comparison</td>
  1732   1744   </tr>
  1733         -<tr class="#doctools_toceven" >
         1745  +<tr class="#doctools_tocodd"  >
  1734   1746   <td class="#doctools_tocleft" ><a name='valtype_common'><a href="files/modules/valtype/valtype_common.html">valtype::common</a></td>
  1735   1747   <td class="#doctools_tocright">Validation, common code</td>
  1736   1748   </tr>
  1737         -<tr class="#doctools_tocodd"  >
         1749  +<tr class="#doctools_toceven" >
  1738   1750   <td class="#doctools_tocleft" ><a name='valtype_creditcard_amex'><a href="files/modules/valtype/cc_amex.html">valtype::creditcard::amex</a></td>
  1739   1751   <td class="#doctools_tocright">Validation for AMEX creditcard number</td>
  1740   1752   </tr>
  1741         -<tr class="#doctools_toceven" >
         1753  +<tr class="#doctools_tocodd"  >
  1742   1754   <td class="#doctools_tocleft" ><a name='valtype_creditcard_discover'><a href="files/modules/valtype/cc_discover.html">valtype::creditcard::discover</a></td>
  1743   1755   <td class="#doctools_tocright">Validation for Discover creditcard number</td>
  1744   1756   </tr>
  1745         -<tr class="#doctools_tocodd"  >
         1757  +<tr class="#doctools_toceven" >
  1746   1758   <td class="#doctools_tocleft" ><a name='valtype_creditcard_mastercard'><a href="files/modules/valtype/cc_mastercard.html">valtype::creditcard::mastercard</a></td>
  1747   1759   <td class="#doctools_tocright">Validation for Mastercard creditcard number</td>
  1748   1760   </tr>
  1749         -<tr class="#doctools_toceven" >
         1761  +<tr class="#doctools_tocodd"  >
  1750   1762   <td class="#doctools_tocleft" ><a name='valtype_creditcard_visa'><a href="files/modules/valtype/cc_visa.html">valtype::creditcard::visa</a></td>
  1751   1763   <td class="#doctools_tocright">Validation for VISA creditcard number</td>
  1752   1764   </tr>
  1753         -<tr class="#doctools_tocodd"  >
         1765  +<tr class="#doctools_toceven" >
  1754   1766   <td class="#doctools_tocleft" ><a name='valtype_gs1_ean13'><a href="files/modules/valtype/ean13.html">valtype::gs1::ean13</a></td>
  1755   1767   <td class="#doctools_tocright">Validation for EAN13</td>
  1756   1768   </tr>
  1757         -<tr class="#doctools_toceven" >
         1769  +<tr class="#doctools_tocodd"  >
  1758   1770   <td class="#doctools_tocleft" ><a name='valtype_iban'><a href="files/modules/valtype/iban.html">valtype::iban</a></td>
  1759   1771   <td class="#doctools_tocright">Validation for IBAN</td>
  1760   1772   </tr>
  1761         -<tr class="#doctools_tocodd"  >
         1773  +<tr class="#doctools_toceven" >
  1762   1774   <td class="#doctools_tocleft" ><a name='valtype_imei'><a href="files/modules/valtype/imei.html">valtype::imei</a></td>
  1763   1775   <td class="#doctools_tocright">Validation for IMEI</td>
  1764   1776   </tr>
  1765         -<tr class="#doctools_toceven" >
         1777  +<tr class="#doctools_tocodd"  >
  1766   1778   <td class="#doctools_tocleft" ><a name='valtype_isbn'><a href="files/modules/valtype/isbn.html">valtype::isbn</a></td>
  1767   1779   <td class="#doctools_tocright">Validation for ISBN</td>
  1768   1780   </tr>
  1769         -<tr class="#doctools_tocodd"  >
         1781  +<tr class="#doctools_toceven" >
  1770   1782   <td class="#doctools_tocleft" ><a name='valtype_luhn'><a href="files/modules/valtype/luhn.html">valtype::luhn</a></td>
  1771   1783   <td class="#doctools_tocright">Validation for plain number with a LUHN checkdigit</td>
  1772   1784   </tr>
  1773         -<tr class="#doctools_toceven" >
         1785  +<tr class="#doctools_tocodd"  >
  1774   1786   <td class="#doctools_tocleft" ><a name='valtype_luhn5'><a href="files/modules/valtype/luhn5.html">valtype::luhn5</a></td>
  1775   1787   <td class="#doctools_tocright">Validation for plain number with a LUHN5 checkdigit</td>
  1776   1788   </tr>
  1777         -<tr class="#doctools_tocodd"  >
         1789  +<tr class="#doctools_toceven" >
  1778   1790   <td class="#doctools_tocleft" ><a name='valtype_usnpi'><a href="files/modules/valtype/usnpi.html">valtype::usnpi</a></td>
  1779   1791   <td class="#doctools_tocright">Validation for USNPI</td>
  1780   1792   </tr>
  1781         -<tr class="#doctools_toceven" >
         1793  +<tr class="#doctools_tocodd"  >
  1782   1794   <td class="#doctools_tocleft" ><a name='valtype_verhoeff'><a href="files/modules/valtype/verhoeff.html">valtype::verhoeff</a></td>
  1783   1795   <td class="#doctools_tocright">Validation for plain number with a VERHOEFF checkdigit</td>
  1784   1796   </tr>
  1785         -<tr class="#doctools_tocodd"  >
         1797  +<tr class="#doctools_toceven" >
  1786   1798   <td class="#doctools_tocleft" ><a name='websocket'><a href="files/modules/websocket/websocket.html">websocket</a></td>
  1787   1799   <td class="#doctools_tocright">Tcl implementation of the websocket protocol</td>
  1788   1800   </tr>
  1789         -<tr class="#doctools_toceven" >
         1801  +<tr class="#doctools_tocodd"  >
  1790   1802   <td class="#doctools_tocleft" ><a name='wip'><a href="files/modules/wip/wip.html">wip</a></td>
  1791   1803   <td class="#doctools_tocright">Word Interpreter</td>
  1792   1804   </tr>
  1793         -<tr class="#doctools_tocodd"  >
         1805  +<tr class="#doctools_toceven" >
  1794   1806   <td class="#doctools_tocleft" ><a name='xsxp'><a href="files/modules/amazon-s3/xsxp.html">xsxp</a></td>
  1795   1807   <td class="#doctools_tocright">eXtremely Simple Xml Parser</td>
  1796   1808   </tr>
  1797         -<tr class="#doctools_toceven" >
         1809  +<tr class="#doctools_tocodd"  >
  1798   1810   <td class="#doctools_tocleft" ><a name='yaml'><a href="files/modules/yaml/yaml.html">yaml</a></td>
  1799   1811   <td class="#doctools_tocright">YAML Format Encoder/Decoder</td>
  1800   1812   </tr>
  1801         -<tr class="#doctools_tocodd"  >
         1813  +<tr class="#doctools_toceven" >
  1802   1814   <td class="#doctools_tocleft" ><a name='yencode'><a href="files/modules/base64/yencode.html">yencode</a></td>
  1803   1815   <td class="#doctools_tocright">Y-encode/decode binary data</td>
  1804   1816   </tr>
  1805         -<tr class="#doctools_toceven" >
         1817  +<tr class="#doctools_tocodd"  >
  1806   1818   <td class="#doctools_tocleft" ><a name='zipfile_decode'><a href="files/modules/zip/decode.html">zipfile::decode</a></td>
  1807   1819   <td class="#doctools_tocright">Access to zip archives</td>
  1808   1820   </tr>
  1809         -<tr class="#doctools_tocodd"  >
         1821  +<tr class="#doctools_toceven" >
  1810   1822   <td class="#doctools_tocleft" ><a name='zipfile_encode'><a href="files/modules/zip/encode.html">zipfile::encode</a></td>
  1811   1823   <td class="#doctools_tocright">Generation of zip archives</td>
  1812   1824   </tr>
  1813         -<tr class="#doctools_toceven" >
         1825  +<tr class="#doctools_tocodd"  >
  1814   1826   <td class="#doctools_tocleft" ><a name='zipfile_mkzip'><a href="files/modules/zip/mkzip.html">zipfile::mkzip</a></td>
  1815   1827   <td class="#doctools_tocright">Build a zip archive</td>
  1816   1828   </tr>
  1817   1829   </table>
  1818   1830   </dl><hr>

Added idoc/man/files/devdoc/tcllib_installer.n.

            1  +'\"
            2  +'\" Generated from file 'tcllib_installer\&.man' by tcllib/doctools with format 'nroff'
            3  +'\"
            4  +.TH "tcllib_install_guide" n 1 tcllib ""
            5  +.\" The -*- nroff -*- definitions below are for supplemental macros used
            6  +.\" in Tcl/Tk manual entries.
            7  +.\"
            8  +.\" .AP type name in/out ?indent?
            9  +.\"	Start paragraph describing an argument to a library procedure.
           10  +.\"	type is type of argument (int, etc.), in/out is either "in", "out",
           11  +.\"	or "in/out" to describe whether procedure reads or modifies arg,
           12  +.\"	and indent is equivalent to second arg of .IP (shouldn't ever be
           13  +.\"	needed;  use .AS below instead)
           14  +.\"
           15  +.\" .AS ?type? ?name?
           16  +.\"	Give maximum sizes of arguments for setting tab stops.  Type and
           17  +.\"	name are examples of largest possible arguments that will be passed
           18  +.\"	to .AP later.  If args are omitted, default tab stops are used.
           19  +.\"
           20  +.\" .BS
           21  +.\"	Start box enclosure.  From here until next .BE, everything will be
           22  +.\"	enclosed in one large box.
           23  +.\"
           24  +.\" .BE
           25  +.\"	End of box enclosure.
           26  +.\"
           27  +.\" .CS
           28  +.\"	Begin code excerpt.
           29  +.\"
           30  +.\" .CE
           31  +.\"	End code excerpt.
           32  +.\"
           33  +.\" .VS ?version? ?br?
           34  +.\"	Begin vertical sidebar, for use in marking newly-changed parts
           35  +.\"	of man pages.  The first argument is ignored and used for recording
           36  +.\"	the version when the .VS was added, so that the sidebars can be
           37  +.\"	found and removed when they reach a certain age.  If another argument
           38  +.\"	is present, then a line break is forced before starting the sidebar.
           39  +.\"
           40  +.\" .VE
           41  +.\"	End of vertical sidebar.
           42  +.\"
           43  +.\" .DS
           44  +.\"	Begin an indented unfilled display.
           45  +.\"
           46  +.\" .DE
           47  +.\"	End of indented unfilled display.
           48  +.\"
           49  +.\" .SO ?manpage?
           50  +.\"	Start of list of standard options for a Tk widget. The manpage
           51  +.\"	argument defines where to look up the standard options; if
           52  +.\"	omitted, defaults to "options". The options follow on successive
           53  +.\"	lines, in three columns separated by tabs.
           54  +.\"
           55  +.\" .SE
           56  +.\"	End of list of standard options for a Tk widget.
           57  +.\"
           58  +.\" .OP cmdName dbName dbClass
           59  +.\"	Start of description of a specific option.  cmdName gives the
           60  +.\"	option's name as specified in the class command, dbName gives
           61  +.\"	the option's name in the option database, and dbClass gives
           62  +.\"	the option's class in the option database.
           63  +.\"
           64  +.\" .UL arg1 arg2
           65  +.\"	Print arg1 underlined, then print arg2 normally.
           66  +.\"
           67  +.\" .QW arg1 ?arg2?
           68  +.\"	Print arg1 in quotes, then arg2 normally (for trailing punctuation).
           69  +.\"
           70  +.\" .PQ arg1 ?arg2?
           71  +.\"	Print an open parenthesis, arg1 in quotes, then arg2 normally
           72  +.\"	(for trailing punctuation) and then a closing parenthesis.
           73  +.\"
           74  +.\"	# Set up traps and other miscellaneous stuff for Tcl/Tk man pages.
           75  +.if t .wh -1.3i ^B
           76  +.nr ^l \n(.l
           77  +.ad b
           78  +.\"	# Start an argument description
           79  +.de AP
           80  +.ie !"\\$4"" .TP \\$4
           81  +.el \{\
           82  +.   ie !"\\$2"" .TP \\n()Cu
           83  +.   el          .TP 15
           84  +.\}
           85  +.ta \\n()Au \\n()Bu
           86  +.ie !"\\$3"" \{\
           87  +\&\\$1 \\fI\\$2\\fP (\\$3)
           88  +.\".b
           89  +.\}
           90  +.el \{\
           91  +.br
           92  +.ie !"\\$2"" \{\
           93  +\&\\$1	\\fI\\$2\\fP
           94  +.\}
           95  +.el \{\
           96  +\&\\fI\\$1\\fP
           97  +.\}
           98  +.\}
           99  +..
          100  +.\"	# define tabbing values for .AP
          101  +.de AS
          102  +.nr )A 10n
          103  +.if !"\\$1"" .nr )A \\w'\\$1'u+3n
          104  +.nr )B \\n()Au+15n
          105  +.\"
          106  +.if !"\\$2"" .nr )B \\w'\\$2'u+\\n()Au+3n
          107  +.nr )C \\n()Bu+\\w'(in/out)'u+2n
          108  +..
          109  +.AS Tcl_Interp Tcl_CreateInterp in/out
          110  +.\"	# BS - start boxed text
          111  +.\"	# ^y = starting y location
          112  +.\"	# ^b = 1
          113  +.de BS
          114  +.br
          115  +.mk ^y
          116  +.nr ^b 1u
          117  +.if n .nf
          118  +.if n .ti 0
          119  +.if n \l'\\n(.lu\(ul'
          120  +.if n .fi
          121  +..
          122  +.\"	# BE - end boxed text (draw box now)
          123  +.de BE
          124  +.nf
          125  +.ti 0
          126  +.mk ^t
          127  +.ie n \l'\\n(^lu\(ul'
          128  +.el \{\
          129  +.\"	Draw four-sided box normally, but don't draw top of
          130  +.\"	box if the box started on an earlier page.
          131  +.ie !\\n(^b-1 \{\
          132  +\h'-1.5n'\L'|\\n(^yu-1v'\l'\\n(^lu+3n\(ul'\L'\\n(^tu+1v-\\n(^yu'\l'|0u-1.5n\(ul'
          133  +.\}
          134  +.el \}\
          135  +\h'-1.5n'\L'|\\n(^yu-1v'\h'\\n(^lu+3n'\L'\\n(^tu+1v-\\n(^yu'\l'|0u-1.5n\(ul'
          136  +.\}
          137  +.\}
          138  +.fi
          139  +.br
          140  +.nr ^b 0
          141  +..
          142  +.\"	# VS - start vertical sidebar
          143  +.\"	# ^Y = starting y location
          144  +.\"	# ^v = 1 (for troff;  for nroff this doesn't matter)
          145  +.de VS
          146  +.if !"\\$2"" .br
          147  +.mk ^Y
          148  +.ie n 'mc \s12\(br\s0
          149  +.el .nr ^v 1u
          150  +..
          151  +.\"	# VE - end of vertical sidebar
          152  +.de VE
          153  +.ie n 'mc
          154  +.el \{\
          155  +.ev 2
          156  +.nf
          157  +.ti 0
          158  +.mk ^t
          159  +\h'|\\n(^lu+3n'\L'|\\n(^Yu-1v\(bv'\v'\\n(^tu+1v-\\n(^Yu'\h'-|\\n(^lu+3n'
          160  +.sp -1
          161  +.fi
          162  +.ev
          163  +.\}
          164  +.nr ^v 0
          165  +..
          166  +.\"	# Special macro to handle page bottom:  finish off current
          167  +.\"	# box/sidebar if in box/sidebar mode, then invoked standard
          168  +.\"	# page bottom macro.
          169  +.de ^B
          170  +.ev 2
          171  +'ti 0
          172  +'nf
          173  +.mk ^t
          174  +.if \\n(^b \{\
          175  +.\"	Draw three-sided box if this is the box's first page,
          176  +.\"	draw two sides but no top otherwise.
          177  +.ie !\\n(^b-1 \h'-1.5n'\L'|\\n(^yu-1v'\l'\\n(^lu+3n\(ul'\L'\\n(^tu+1v-\\n(^yu'\h'|0u'\c
          178  +.el \h'-1.5n'\L'|\\n(^yu-1v'\h'\\n(^lu+3n'\L'\\n(^tu+1v-\\n(^yu'\h'|0u'\c
          179  +.\}
          180  +.if \\n(^v \{\
          181  +.nr ^x \\n(^tu+1v-\\n(^Yu
          182  +\kx\h'-\\nxu'\h'|\\n(^lu+3n'\ky\L'-\\n(^xu'\v'\\n(^xu'\h'|0u'\c
          183  +.\}
          184  +.bp
          185  +'fi
          186  +.ev
          187  +.if \\n(^b \{\
          188  +.mk ^y
          189  +.nr ^b 2
          190  +.\}
          191  +.if \\n(^v \{\
          192  +.mk ^Y
          193  +.\}
          194  +..
          195  +.\"	# DS - begin display
          196  +.de DS
          197  +.RS
          198  +.nf
          199  +.sp
          200  +..
          201  +.\"	# DE - end display
          202  +.de DE
          203  +.fi
          204  +.RE
          205  +.sp
          206  +..
          207  +.\"	# SO - start of list of standard options
          208  +.de SO
          209  +'ie '\\$1'' .ds So \\fBoptions\\fR
          210  +'el .ds So \\fB\\$1\\fR
          211  +.SH "STANDARD OPTIONS"
          212  +.LP
          213  +.nf
          214  +.ta 5.5c 11c
          215  +.ft B
          216  +..
          217  +.\"	# SE - end of list of standard options
          218  +.de SE
          219  +.fi
          220  +.ft R
          221  +.LP
          222  +See the \\*(So manual entry for details on the standard options.
          223  +..
          224  +.\"	# OP - start of full description for a single option
          225  +.de OP
          226  +.LP
          227  +.nf
          228  +.ta 4c
          229  +Command-Line Name:	\\fB\\$1\\fR
          230  +Database Name:	\\fB\\$2\\fR
          231  +Database Class:	\\fB\\$3\\fR
          232  +.fi
          233  +.IP
          234  +..
          235  +.\"	# CS - begin code excerpt
          236  +.de CS
          237  +.RS
          238  +.nf
          239  +.ta .25i .5i .75i 1i
          240  +..
          241  +.\"	# CE - end code excerpt
          242  +.de CE
          243  +.fi
          244  +.RE
          245  +..
          246  +.\"	# UL - underline word
          247  +.de UL
          248  +\\$1\l'|0\(ul'\\$2
          249  +..
          250  +.\"	# QW - apply quotation marks to word
          251  +.de QW
          252  +.ie '\\*(lq'"' ``\\$1''\\$2
          253  +.\"" fix emacs highlighting
          254  +.el \\*(lq\\$1\\*(rq\\$2
          255  +..
          256  +.\"	# PQ - apply parens and quotation marks to word
          257  +.de PQ
          258  +.ie '\\*(lq'"' (``\\$1''\\$2)\\$3
          259  +.\"" fix emacs highlighting
          260  +.el (\\*(lq\\$1\\*(rq\\$2)\\$3
          261  +..
          262  +.\"	# QR - quoted range
          263  +.de QR
          264  +.ie '\\*(lq'"' ``\\$1''\\-``\\$2''\\$3
          265  +.\"" fix emacs highlighting
          266  +.el \\*(lq\\$1\\*(rq\\-\\*(lq\\$2\\*(rq\\$3
          267  +..
          268  +.\"	# MT - "empty" string
          269  +.de MT
          270  +.QW ""
          271  +..
          272  +.BS
          273  +.SH NAME
          274  +tcllib_install_guide \- Tcllib - The Installer's Guide
          275  +.SH DESCRIPTION
          276  +Welcome to Tcllib, the Tcl Standard Library\&. Note that Tcllib is not a
          277  +package itself\&. It is a collection of (semi-independent) \fITcl\fR
          278  +packages that provide utility functions useful to a large collection
          279  +of Tcl programmers\&.
          280  +.PP
          281  +The audience of this document is anyone wishing to build the packages,
          282  +for either themselves, or others\&.
          283  +.PP
          284  +For a developer intending to extend or modify the packages we
          285  +additionally provide
          286  +.IP [1]
          287  +\fITcllib - The Developer's Guide\fR\&.
          288  +.PP
          289  +.PP
          290  +Please read \fITcllib - How To Get The Sources\fR first, if that
          291  +was not done already\&. Here we assume that the sources are already
          292  +available in a directory of your choice\&.
          293  +.PP
          294  +.SH REQUISITES
          295  +Before Tcllib can be build and used a number of requisites must be installed\&.
          296  +These are:
          297  +.IP [1]
          298  +The scripting language Tcl\&.
          299  +For details see \fBTcl\fR\&.
          300  +.IP [2]
          301  +Optionally, the \fBcritcl\fR package (C embedding) for \fBTcl\fR\&.
          302  +For details see \fBCriTcl\fR\&.
          303  +.PP
          304  +This list assumes that the machine where Tcllib is to be installed is
          305  +essentially clean\&. Of course, if parts of the dependencies listed
          306  +below are already installed the associated steps can be skipped\&. It is
          307  +still recommended to read their sections though, to validate that the
          308  +dependencies they talk about are indeed installed\&.
          309  +.SS TCL
          310  +As we are installing a number of Tcl packages and applications it
          311  +should be pretty much obvious that a working installation of Tcl
          312  +itself is needed, and I will not belabor the point\&.
          313  +.PP
          314  +Out of the many possibilites use whatever you are comfortable
          315  +with, as long as it provides Tcl 8\&.2, or higher\&.
          316  +This may be a Tcl installation provided by your operating system
          317  +distribution, from a distribution-independent vendor, or built by
          318  +yourself\&.
          319  +.PP
          320  +\fINote\fR that the packages in Tcllib have begun to require
          321  +8\&.4, 8\&.5, and even 8\&.6\&. Older versions of Tcl will not be able to use
          322  +such packages\&. Trying to use them will result in
          323  +\fIpackage not found\fR errors, as their package index files will
          324  +not register them in versions of the core unable to use them\&.
          325  +.PP
          326  +Myself, I used (and still use)
          327  +\fIActiveState's\fR [http://www\&.activestate\&.com]
          328  +ActiveTcl 8\&.5 distribution during development, as I am most familiar
          329  +with it\&.
          330  +.PP
          331  +\fI(Disclosure: I, Andreas Kupries, worked for ActiveState until 2016, maintaining ActiveTcl and TclDevKit for them)\&.\fR\&.
          332  +I am currently working for SUSE Software Canada ULC, although not in
          333  +Tcl-related areas\&.
          334  +.PP
          335  +This distribution can be found at
          336  +\fIhttp://www\&.activestate\&.com/activetcl\fR\&. Retrieve the archive of
          337  +ActiveTcl 8\&.5 (or higher) for your platform and install it as directed
          338  +by ActiveState\&.
          339  +.PP
          340  +For those wishing to build and install Tcl on their own, the
          341  +relevant sources can be found at
          342  +.TP
          343  +Tcl
          344  +\fIhttp://core\&.tcl-lang\&.org/tcl/\fR
          345  +.PP
          346  +together with the necessary instructions on how to build it\&.
          347  +.PP
          348  +If there are problems with building, installing, or using Tcl
          349  +please file a ticket against \fITcl\fR, or the vendor of your
          350  +distribution, and \fInot\fR \fITcllib\fR\&.
          351  +.SS CRITCL
          352  +The \fBcritcl\fR tool is an \fIoptional\fR dependency\&.
          353  +.PP
          354  +It is only required when trying to build the C-based
          355  +\fIaccelerators\fR for a number of packages, as explained in
          356  +\fBCritcl & Accelerators\fR
          357  +.PP
          358  +Tcllib's build system accepts it as an application found in the
          359  +PATH (be it starkit or starpack)\&.
          360  +.PP
          361  +Tcllib requires version 2 or higher\&.
          362  +.PP
          363  +The github repository providing releases of version 2 and
          364  +higher, and the associated sources, can be found at
          365  +\fIhttp://andreas-kupries\&.github\&.com/critcl\fR\&.
          366  +.PP
          367  +Any branch of the repository can be used (if not using the
          368  +prebuild starkit or starpack), although the use of the stable branch
          369  +\fImaster\fR is recommended\&.
          370  +.PP
          371  +At the above url is also an explanation on how to build and
          372  +install CriTcl, including a list of its dependencies\&.
          373  +.PP
          374  +Its instructions will not be repeated here\&. If there are
          375  +problems with their directions please file a ticket against the
          376  +\fICritcl\fR project, and not Tcllib\&.
          377  +.SH "BUILD & INSTALLATION INSTRUCTIONS"
          378  +.SS UNIX
          379  +This section describes the actions required to install Tcllib on Unix
          380  +systems (Linux, BSD, and related, including OS X)\&.
          381  +If you have to install Tcllib on a Windows machine instead then see
          382  +section \fBWindows\fR\&.
          383  +.PP
          384  +Tcllib comes with a standard TEA buildsystem using a
          385  +\fBconfigure\fR script and a "\fIMakefile\fR" generated by it\&.
          386  +.PP
          387  +To install Tcllib simply run
          388  +.CS
          389  +
          390  +
          391  +    \&./configure
          392  +    make install
          393  +
          394  +.CE
          395  +in the toplevel directory of Tcllib itself\&. To build in a directory D
          396  +outside of Tcllib's toplevel directory simply make D the current
          397  +working directory and invoke \fBconfigure\fR with either its
          398  +absolute path or a proper relative path\&.
          399  +.PP
          400  +The above will non-interactively install all packages,
          401  +applications found in Tcllib, and their manpages, in directories
          402  +derived from what \fBconfigure\fR found out about the system\&.
          403  +.PP
          404  +The underlying tool is "\fIinstaller\&.tcl\fR" in the toplevel
          405  +directory of Tcllib\&.
          406  +.PP
          407  +Invoking this tool via
          408  +.CS
          409  +
          410  +
          411  +    \&./installer\&.tcl -help
          412  +
          413  +.CE
          414  +will provide a short list of the available options\&. For more examples
          415  +see the various \fIinstall\fR targets found in "\fIMakefile\&.in\fR"\&.
          416  +.SS WINDOWS
          417  +This section describes the actions required to install Tcllib on Windows(tm)
          418  +systems\&.
          419  +If you have to install Tcllib on a Unix machine (Linux, BSD, and
          420  +related, including OS X) instead then see section \fBUnix\fR\&.
          421  +.PP
          422  +If the build environment is based on \fIMSYS\fR,
          423  +\fIcygwin\fR, or a similar emulation of a unix environment, then
          424  +\fBUnix\fR still applies and should be used\&.
          425  +.PP
          426  +Alternatively, as mentioned in the previous section, the tool
          427  +underneath of the unix buildsystem is the \fITcl\fR-based
          428  +"\fIinstaller\&.tcl\fR" script\&.
          429  +.PP
          430  +Invoking this tool from a DOS shell via
          431  +.CS
          432  +
          433  +
          434  +    /path/to/tclsh \&./installer\&.tcl -help
          435  +
          436  +.CE
          437  +will provide a short list of the available options\&. For more examples
          438  +see the various \fIinstall\fR targets found in "\fIMakefile\&.in\fR"\&.
          439  +Invoking this tool without any arguments, i\&.e\&. like
          440  +.CS
          441  +
          442  +
          443  +    /path/to/tclsh \&./installer\&.tcl
          444  +
          445  +.CE
          446  +will start a non-interactive installation showing its progress in a
          447  +Tk-based graphical interface\&. The directories to install the packages,
          448  +applications, etc\&. into are derived from the location of the
          449  +\fBtclsh\fR used to invoke the script, and where it expects
          450  +packages\&.
          451  +.SS "CRITCL & ACCELERATORS"
          452  +.PP
          453  +A number of packages come with \fIaccelerators\fR, i\&.e\&.
          454  +\fBcritcl\fR-based C code whose use will boost the performance of
          455  +the packages using them\&. As these accelerators are optional they are
          456  +not installed by default\&.
          457  +.PP
          458  +To build the accelerators the normally optional dependency on
          459  +\fBcritcl\fR becomes required\&.
          460  +.PP
          461  +To install Tcllib with the accelerators run
          462  +.CS
          463  +
          464  +
          465  +    \&./configure
          466  +    make critcl # This builds the shared library holding the accelerators
          467  +    make install
          468  +
          469  +.CE
          470  +.PP
          471  +The underlying tool is "\fIsak\&.tcl\fR" in the toplevel directory
          472  +of Tcllib and the command \fBmake critcl\fR is just a wrapper around
          473  +.CS
          474  +
          475  +
          476  +    \&./sak\&.tcl critcl
          477  +
          478  +.CE

Added idoc/man/files/devdoc/tcllib_license.n.

            1  +'\"
            2  +'\" Generated from file 'tcllib_license\&.man' by tcllib/doctools with format 'nroff'
            3  +'\"
            4  +.TH "tcllib_license" n 1 tcllib ""
            5  +.\" The -*- nroff -*- definitions below are for supplemental macros used
            6  +.\" in Tcl/Tk manual entries.
            7  +.\"
            8  +.\" .AP type name in/out ?indent?
            9  +.\"	Start paragraph describing an argument to a library procedure.
           10  +.\"	type is type of argument (int, etc.), in/out is either "in", "out",
           11  +.\"	or "in/out" to describe whether procedure reads or modifies arg,
           12  +.\"	and indent is equivalent to second arg of .IP (shouldn't ever be
           13  +.\"	needed;  use .AS below instead)
           14  +.\"
           15  +.\" .AS ?type? ?name?
           16  +.\"	Give maximum sizes of arguments for setting tab stops.  Type and
           17  +.\"	name are examples of largest possible arguments that will be passed
           18  +.\"	to .AP later.  If args are omitted, default tab stops are used.
           19  +.\"
           20  +.\" .BS
           21  +.\"	Start box enclosure.  From here until next .BE, everything will be
           22  +.\"	enclosed in one large box.
           23  +.\"
           24  +.\" .BE
           25  +.\"	End of box enclosure.
           26  +.\"
           27  +.\" .CS
           28  +.\"	Begin code excerpt.
           29  +.\"
           30  +.\" .CE
           31  +.\"	End code excerpt.
           32  +.\"
           33  +.\" .VS ?version? ?br?
           34  +.\"	Begin vertical sidebar, for use in marking newly-changed parts
           35  +.\"	of man pages.  The first argument is ignored and used for recording
           36  +.\"	the version when the .VS was added, so that the sidebars can be
           37  +.\"	found and removed when they reach a certain age.  If another argument
           38  +.\"	is present, then a line break is forced before starting the sidebar.
           39  +.\"
           40  +.\" .VE
           41  +.\"	End of vertical sidebar.
           42  +.\"
           43  +.\" .DS
           44  +.\"	Begin an indented unfilled display.
           45  +.\"
           46  +.\" .DE
           47  +.\"	End of indented unfilled display.
           48  +.\"
           49  +.\" .SO ?manpage?
           50  +.\"	Start of list of standard options for a Tk widget. The manpage
           51  +.\"	argument defines where to look up the standard options; if
           52  +.\"	omitted, defaults to "options". The options follow on successive
           53  +.\"	lines, in three columns separated by tabs.
           54  +.\"
           55  +.\" .SE
           56  +.\"	End of list of standard options for a Tk widget.
           57  +.\"
           58  +.\" .OP cmdName dbName dbClass
           59  +.\"	Start of description of a specific option.  cmdName gives the
           60  +.\"	option's name as specified in the class command, dbName gives
           61  +.\"	the option's name in the option database, and dbClass gives
           62  +.\"	the option's class in the option database.
           63  +.\"
           64  +.\" .UL arg1 arg2
           65  +.\"	Print arg1 underlined, then print arg2 normally.
           66  +.\"
           67  +.\" .QW arg1 ?arg2?
           68  +.\"	Print arg1 in quotes, then arg2 normally (for trailing punctuation).
           69  +.\"
           70  +.\" .PQ arg1 ?arg2?
           71  +.\"	Print an open parenthesis, arg1 in quotes, then arg2 normally
           72  +.\"	(for trailing punctuation) and then a closing parenthesis.
           73  +.\"
           74  +.\"	# Set up traps and other miscellaneous stuff for Tcl/Tk man pages.
           75  +.if t .wh -1.3i ^B
           76  +.nr ^l \n(.l
           77  +.ad b
           78  +.\"	# Start an argument description
           79  +.de AP
           80  +.ie !"\\$4"" .TP \\$4
           81  +.el \{\
           82  +.   ie !"\\$2"" .TP \\n()Cu
           83  +.   el          .TP 15
           84  +.\}
           85  +.ta \\n()Au \\n()Bu
           86  +.ie !"\\$3"" \{\
           87  +\&\\$1 \\fI\\$2\\fP (\\$3)
           88  +.\".b
           89  +.\}
           90  +.el \{\
           91  +.br
           92  +.ie !"\\$2"" \{\
           93  +\&\\$1	\\fI\\$2\\fP
           94  +.\}
           95  +.el \{\
           96  +\&\\fI\\$1\\fP
           97  +.\}
           98  +.\}
           99  +..
          100  +.\"	# define tabbing values for .AP
          101  +.de AS
          102  +.nr )A 10n
          103  +.if !"\\$1"" .nr )A \\w'\\$1'u+3n
          104  +.nr )B \\n()Au+15n
          105  +.\"
          106  +.if !"\\$2"" .nr )B \\w'\\$2'u+\\n()Au+3n
          107  +.nr )C \\n()Bu+\\w'(in/out)'u+2n
          108  +..
          109  +.AS Tcl_Interp Tcl_CreateInterp in/out
          110  +.\"	# BS - start boxed text
          111  +.\"	# ^y = starting y location
          112  +.\"	# ^b = 1
          113  +.de BS
          114  +.br
          115  +.mk ^y
          116  +.nr ^b 1u
          117  +.if n .nf
          118  +.if n .ti 0
          119  +.if n \l'\\n(.lu\(ul'
          120  +.if n .fi
          121  +..
          122  +.\"	# BE - end boxed text (draw box now)
          123  +.de BE
          124  +.nf
          125  +.ti 0
          126  +.mk ^t
          127  +.ie n \l'\\n(^lu\(ul'
          128  +.el \{\
          129  +.\"	Draw four-sided box normally, but don't draw top of
          130  +.\"	box if the box started on an earlier page.
          131  +.ie !\\n(^b-1 \{\
          132  +\h'-1.5n'\L'|\\n(^yu-1v'\l'\\n(^lu+3n\(ul'\L'\\n(^tu+1v-\\n(^yu'\l'|0u-1.5n\(ul'
          133  +.\}
          134  +.el \}\
          135  +\h'-1.5n'\L'|\\n(^yu-1v'\h'\\n(^lu+3n'\L'\\n(^tu+1v-\\n(^yu'\l'|0u-1.5n\(ul'
          136  +.\}
          137  +.\}
          138  +.fi
          139  +.br
          140  +.nr ^b 0
          141  +..
          142  +.\"	# VS - start vertical sidebar
          143  +.\"	# ^Y = starting y location
          144  +.\"	# ^v = 1 (for troff;  for nroff this doesn't matter)
          145  +.de VS
          146  +.if !"\\$2"" .br
          147  +.mk ^Y
          148  +.ie n 'mc \s12\(br\s0
          149  +.el .nr ^v 1u
          150  +..
          151  +.\"	# VE - end of vertical sidebar
          152  +.de VE
          153  +.ie n 'mc
          154  +.el \{\
          155  +.ev 2
          156  +.nf
          157  +.ti 0
          158  +.mk ^t
          159  +\h'|\\n(^lu+3n'\L'|\\n(^Yu-1v\(bv'\v'\\n(^tu+1v-\\n(^Yu'\h'-|\\n(^lu+3n'
          160  +.sp -1
          161  +.fi
          162  +.ev
          163  +.\}
          164  +.nr ^v 0
          165  +..
          166  +.\"	# Special macro to handle page bottom:  finish off current
          167  +.\"	# box/sidebar if in box/sidebar mode, then invoked standard
          168  +.\"	# page bottom macro.
          169  +.de ^B
          170  +.ev 2
          171  +'ti 0
          172  +'nf
          173  +.mk ^t
          174  +.if \\n(^b \{\
          175  +.\"	Draw three-sided box if this is the box's first page,
          176  +.\"	draw two sides but no top otherwise.
          177  +.ie !\\n(^b-1 \h'-1.5n'\L'|\\n(^yu-1v'\l'\\n(^lu+3n\(ul'\L'\\n(^tu+1v-\\n(^yu'\h'|0u'\c
          178  +.el \h'-1.5n'\L'|\\n(^yu-1v'\h'\\n(^lu+3n'\L'\\n(^tu+1v-\\n(^yu'\h'|0u'\c
          179  +.\}
          180  +.if \\n(^v \{\
          181  +.nr ^x \\n(^tu+1v-\\n(^Yu
          182  +\kx\h'-\\nxu'\h'|\\n(^lu+3n'\ky\L'-\\n(^xu'\v'\\n(^xu'\h'|0u'\c
          183  +.\}
          184  +.bp
          185  +'fi
          186  +.ev
          187  +.if \\n(^b \{\
          188  +.mk ^y
          189  +.nr ^b 2
          190  +.\}
          191  +.if \\n(^v \{\
          192  +.mk ^Y
          193  +.\}
          194  +..
          195  +.\"	# DS - begin display
          196  +.de DS
          197  +.RS
          198  +.nf
          199  +.sp
          200  +..
          201  +.\"	# DE - end display
          202  +.de DE
          203  +.fi
          204  +.RE
          205  +.sp
          206  +..
          207  +.\"	# SO - start of list of standard options
          208  +.de SO
          209  +'ie '\\$1'' .ds So \\fBoptions\\fR
          210  +'el .ds So \\fB\\$1\\fR
          211  +.SH "STANDARD OPTIONS"
          212  +.LP
          213  +.nf
          214  +.ta 5.5c 11c
          215  +.ft B
          216  +..
          217  +.\"	# SE - end of list of standard options
          218  +.de SE
          219  +.fi
          220  +.ft R
          221  +.LP
          222  +See the \\*(So manual entry for details on the standard options.
          223  +..
          224  +.\"	# OP - start of full description for a single option
          225  +.de OP
          226  +.LP
          227  +.nf
          228  +.ta 4c
          229  +Command-Line Name:	\\fB\\$1\\fR
          230  +Database Name:	\\fB\\$2\\fR
          231  +Database Class:	\\fB\\$3\\fR
          232  +.fi
          233  +.IP
          234  +..
          235  +.\"	# CS - begin code excerpt
          236  +.de CS
          237  +.RS
          238  +.nf
          239  +.ta .25i .5i .75i 1i
          240  +..
          241  +.\"	# CE - end code excerpt
          242  +.de CE
          243  +.fi
          244  +.RE
          245  +..
          246  +.\"	# UL - underline word
          247  +.de UL
          248  +\\$1\l'|0\(ul'\\$2
          249  +..
          250  +.\"	# QW - apply quotation marks to word
          251  +.de QW
          252  +.ie '\\*(lq'"' ``\\$1''\\$2
          253  +.\"" fix emacs highlighting
          254  +.el \\*(lq\\$1\\*(rq\\$2
          255  +..
          256  +.\"	# PQ - apply parens and quotation marks to word
          257  +.de PQ
          258  +.ie '\\*(lq'"' (``\\$1''\\$2)\\$3
          259  +.\"" fix emacs highlighting
          260  +.el (\\*(lq\\$1\\*(rq\\$2)\\$3
          261  +..
          262  +.\"	# QR - quoted range
          263  +.de QR
          264  +.ie '\\*(lq'"' ``\\$1''\\-``\\$2''\\$3
          265  +.\"" fix emacs highlighting
          266  +.el \\*(lq\\$1\\*(rq\\-\\*(lq\\$2\\*(rq\\$3
          267  +..
          268  +.\"	# MT - "empty" string
          269  +.de MT
          270  +.QW ""
          271  +..
          272  +.BS
          273  +.SH NAME
          274  +tcllib_license \- Tcllib - License
          275  +.SH DESCRIPTION
          276  +Welcome to Tcllib, the Tcl Standard Library\&. Note that Tcllib is not a
          277  +package itself\&. It is a collection of (semi-independent) \fITcl\fR
          278  +packages that provide utility functions useful to a large collection
          279  +of Tcl programmers\&.
          280  +.PP
          281  +The collection is under the BSD license\&.
          282  +.SH LICENSE
          283  +.PP
          284  +This software is copyrighted by Ajuba Solutions and other parties\&.
          285  +The following terms apply to all files associated with the software
          286  +unless explicitly disclaimed in individual files\&.
          287  +.PP
          288  +The authors hereby grant permission to use, copy, modify, distribute,
          289  +and license this software and its documentation for any purpose,
          290  +provided that existing copyright notices are retained in all copies
          291  +and that this notice is included verbatim in any distributions\&. No
          292  +written agreement, license, or royalty fee is required for any of the
          293  +authorized uses\&.  Modifications to this software may be copyrighted by
          294  +their authors and need not follow the licensing terms described here,
          295  +provided that the new terms are clearly indicated on the first page of
          296  +each file where they apply\&.
          297  +.PP
          298  +IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY
          299  +FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
          300  +ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY
          301  +DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE
          302  +POSSIBILITY OF SUCH DAMAGE\&.
          303  +.PP
          304  +THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
          305  +INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
          306  +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND
          307  +NON-INFRINGEMENT\&.  THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, AND
          308  +THE AUTHORS AND DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE
          309  +MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS\&.
          310  +.PP
          311  +GOVERNMENT USE: If you are acquiring this software on behalf of the
          312  +U\&.S\&. government, the Government shall have only "Restricted Rights" in
          313  +the software and related documentation as defined in the Federal
          314  +Acquisition Regulations (FARs) in Clause 52\&.227\&.19 (c) (2)\&.  If you
          315  +are acquiring the software on behalf of the Department of Defense, the
          316  +software shall be classified as "Commercial Computer Software" and the
          317  +Government shall have only "Restricted Rights" as defined in Clause
          318  +252\&.227-7013 (c) (1) of DFARs\&.  Notwithstanding the foregoing, the
          319  +authors grant the U\&.S\&. Government and others acting in its behalf
          320  +permission to use and distribute the software in accordance with the
          321  +terms specified in this license\&.

Added idoc/man/files/devdoc/tcllib_sources.n.

            1  +'\"
            2  +'\" Generated from file 'tcllib_sources\&.man' by tcllib/doctools with format 'nroff'
            3  +'\"
            4  +.TH "tcllib_sources" n 1 tcllib ""
            5  +.\" The -*- nroff -*- definitions below are for supplemental macros used
            6  +.\" in Tcl/Tk manual entries.
            7  +.\"
            8  +.\" .AP type name in/out ?indent?
            9  +.\"	Start paragraph describing an argument to a library procedure.
           10  +.\"	type is type of argument (int, etc.), in/out is either "in", "out",
           11  +.\"	or "in/out" to describe whether procedure reads or modifies arg,
           12  +.\"	and indent is equivalent to second arg of .IP (shouldn't ever be
           13  +.\"	needed;  use .AS below instead)
           14  +.\"
           15  +.\" .AS ?type? ?name?
           16  +.\"	Give maximum sizes of arguments for setting tab stops.  Type and
           17  +.\"	name are examples of largest possible arguments that will be passed
           18  +.\"	to .AP later.  If args are omitted, default tab stops are used.
           19  +.\"
           20  +.\" .BS
           21  +.\"	Start box enclosure.  From here until next .BE, everything will be
           22  +.\"	enclosed in one large box.
           23  +.\"
           24  +.\" .BE
           25  +.\"	End of box enclosure.
           26  +.\"
           27  +.\" .CS
           28  +.\"	Begin code excerpt.
           29  +.\"
           30  +.\" .CE
           31  +.\"	End code excerpt.
           32  +.\"
           33  +.\" .VS ?version? ?br?
           34  +.\"	Begin vertical sidebar, for use in marking newly-changed parts
           35  +.\"	of man pages.  The first argument is ignored and used for recording
           36  +.\"	the version when the .VS was added, so that the sidebars can be
           37  +.\"	found and removed when they reach a certain age.  If another argument
           38  +.\"	is present, then a line break is forced before starting the sidebar.
           39  +.\"
           40  +.\" .VE
           41  +.\"	End of vertical sidebar.
           42  +.\"
           43  +.\" .DS
           44  +.\"	Begin an indented unfilled display.
           45  +.\"
           46  +.\" .DE
           47  +.\"	End of indented unfilled display.
           48  +.\"
           49  +.\" .SO ?manpage?
           50  +.\"	Start of list of standard options for a Tk widget. The manpage
           51  +.\"	argument defines where to look up the standard options; if
           52  +.\"	omitted, defaults to "options". The options follow on successive
           53  +.\"	lines, in three columns separated by tabs.
           54  +.\"
           55  +.\" .SE
           56  +.\"	End of list of standard options for a Tk widget.
           57  +.\"
           58  +.\" .OP cmdName dbName dbClass
           59  +.\"	Start of description of a specific option.  cmdName gives the
           60  +.\"	option's name as specified in the class command, dbName gives
           61  +.\"	the option's name in the option database, and dbClass gives
           62  +.\"	the option's class in the option database.
           63  +.\"
           64  +.\" .UL arg1 arg2
           65  +.\"	Print arg1 underlined, then print arg2 normally.
           66  +.\"
           67  +.\" .QW arg1 ?arg2?
           68  +.\"	Print arg1 in quotes, then arg2 normally (for trailing punctuation).
           69  +.\"
           70  +.\" .PQ arg1 ?arg2?
           71  +.\"	Print an open parenthesis, arg1 in quotes, then arg2 normally
           72  +.\"	(for trailing punctuation) and then a closing parenthesis.
           73  +.\"
           74  +.\"	# Set up traps and other miscellaneous stuff for Tcl/Tk man pages.
           75  +.if t .wh -1.3i ^B
           76  +.nr ^l \n(.l
           77  +.ad b
           78  +.\"	# Start an argument description
           79  +.de AP
           80  +.ie !"\\$4"" .TP \\$4
           81  +.el \{\
           82  +.   ie !"\\$2"" .TP \\n()Cu
           83  +.   el          .TP 15
           84  +.\}
           85  +.ta \\n()Au \\n()Bu
           86  +.ie !"\\$3"" \{\
           87  +\&\\$1 \\fI\\$2\\fP (\\$3)
           88  +.\".b
           89  +.\}
           90  +.el \{\
           91  +.br
           92  +.ie !"\\$2"" \{\
           93  +\&\\$1	\\fI\\$2\\fP
           94  +.\}
           95  +.el \{\
           96  +\&\\fI\\$1\\fP
           97  +.\}
           98  +.\}
           99  +..
          100  +.\"	# define tabbing values for .AP
          101  +.de AS
          102  +.nr )A 10n
          103  +.if !"\\$1"" .nr )A \\w'\\$1'u+3n
          104  +.nr )B \\n()Au+15n
          105  +.\"
          106  +.if !"\\$2"" .nr )B \\w'\\$2'u+\\n()Au+3n
          107  +.nr )C \\n()Bu+\\w'(in/out)'u+2n
          108  +..
          109  +.AS Tcl_Interp Tcl_CreateInterp in/out
          110  +.\"	# BS - start boxed text
          111  +.\"	# ^y = starting y location
          112  +.\"	# ^b = 1
          113  +.de BS
          114  +.br
          115  +.mk ^y
          116  +.nr ^b 1u
          117  +.if n .nf
          118  +.if n .ti 0
          119  +.if n \l'\\n(.lu\(ul'
          120  +.if n .fi
          121  +..
          122  +.\"	# BE - end boxed text (draw box now)
          123  +.de BE
          124  +.nf
          125  +.ti 0
          126  +.mk ^t
          127  +.ie n \l'\\n(^lu\(ul'
          128  +.el \{\
          129  +.\"	Draw four-sided box normally, but don't draw top of
          130  +.\"	box if the box started on an earlier page.
          131  +.ie !\\n(^b-1 \{\
          132  +\h'-1.5n'\L'|\\n(^yu-1v'\l'\\n(^lu+3n\(ul'\L'\\n(^tu+1v-\\n(^yu'\l'|0u-1.5n\(ul'
          133  +.\}
          134  +.el \}\
          135  +\h'-1.5n'\L'|\\n(^yu-1v'\h'\\n(^lu+3n'\L'\\n(^tu+1v-\\n(^yu'\l'|0u-1.5n\(ul'
          136  +.\}
          137  +.\}
          138  +.fi
          139  +.br
          140  +.nr ^b 0
          141  +..
          142  +.\"	# VS - start vertical sidebar
          143  +.\"	# ^Y = starting y location
          144  +.\"	# ^v = 1 (for troff;  for nroff this doesn't matter)
          145  +.de VS
          146  +.if !"\\$2"" .br
          147  +.mk ^Y
          148  +.ie n 'mc \s12\(br\s0
          149  +.el .nr ^v 1u
          150  +..
          151  +.\"	# VE - end of vertical sidebar
          152  +.de VE
          153  +.ie n 'mc
          154  +.el \{\
          155  +.ev 2
          156  +.nf
          157  +.ti 0
          158  +.mk ^t
          159  +\h'|\\n(^lu+3n'\L'|\\n(^Yu-1v\(bv'\v'\\n(^tu+1v-\\n(^Yu'\h'-|\\n(^lu+3n'
          160  +.sp -1
          161  +.fi
          162  +.ev
          163  +.\}
          164  +.nr ^v 0
          165  +..
          166  +.\"	# Special macro to handle page bottom:  finish off current
          167  +.\"	# box/sidebar if in box/sidebar mode, then invoked standard
          168  +.\"	# page bottom macro.
          169  +.de ^B
          170  +.ev 2
          171  +'ti 0
          172  +'nf
          173  +.mk ^t
          174  +.if \\n(^b \{\
          175  +.\"	Draw three-sided box if this is the box's first page,
          176  +.\"	draw two sides but no top otherwise.
          177  +.ie !\\n(^b-1 \h'-1.5n'\L'|\\n(^yu-1v'\l'\\n(^lu+3n\(ul'\L'\\n(^tu+1v-\\n(^yu'\h'|0u'\c
          178  +.el \h'-1.5n'\L'|\\n(^yu-1v'\h'\\n(^lu+3n'\L'\\n(^tu+1v-\\n(^yu'\h'|0u'\c
          179  +.\}
          180  +.if \\n(^v \{\
          181  +.nr ^x \\n(^tu+1v-\\n(^Yu
          182  +\kx\h'-\\nxu'\h'|\\n(^lu+3n'\ky\L'-\\n(^xu'\v'\\n(^xu'\h'|0u'\c
          183  +.\}
          184  +.bp
          185  +'fi
          186  +.ev
          187  +.if \\n(^b \{\
          188  +.mk ^y
          189  +.nr ^b 2
          190  +.\}
          191  +.if \\n(^v \{\
          192  +.mk ^Y
          193  +.\}
          194  +..
          195  +.\"	# DS - begin display
          196  +.de DS
          197  +.RS
          198  +.nf
          199  +.sp
          200  +..
          201  +.\"	# DE - end display
          202  +.de DE
          203  +.fi
          204  +.RE
          205  +.sp
          206  +..
          207  +.\"	# SO - start of list of standard options
          208  +.de SO
          209  +'ie '\\$1'' .ds So \\fBoptions\\fR
          210  +'el .ds So \\fB\\$1\\fR
          211  +.SH "STANDARD OPTIONS"
          212  +.LP
          213  +.nf
          214  +.ta 5.5c 11c
          215  +.ft B
          216  +..
          217  +.\"	# SE - end of list of standard options
          218  +.de SE
          219  +.fi
          220  +.ft R
          221  +.LP
          222  +See the \\*(So manual entry for details on the standard options.
          223  +..
          224  +.\"	# OP - start of full description for a single option
          225  +.de OP
          226  +.LP
          227  +.nf
          228  +.ta 4c
          229  +Command-Line Name:	\\fB\\$1\\fR
          230  +Database Name:	\\fB\\$2\\fR
          231  +Database Class:	\\fB\\$3\\fR
          232  +.fi
          233  +.IP
          234  +..
          235  +.\"	# CS - begin code excerpt
          236  +.de CS
          237  +.RS
          238  +.nf
          239  +.ta .25i .5i .75i 1i
          240  +..
          241  +.\"	# CE - end code excerpt
          242  +.de CE
          243  +.fi
          244  +.RE
          245  +..
          246  +.\"	# UL - underline word
          247  +.de UL
          248  +\\$1\l'|0\(ul'\\$2
          249  +..
          250  +.\"	# QW - apply quotation marks to word
          251  +.de QW
          252  +.ie '\\*(lq'"' ``\\$1''\\$2
          253  +.\"" fix emacs highlighting
          254  +.el \\*(lq\\$1\\*(rq\\$2
          255  +..
          256  +.\"	# PQ - apply parens and quotation marks to word
          257  +.de PQ
          258  +.ie '\\*(lq'"' (``\\$1''\\$2)\\$3
          259  +.\"" fix emacs highlighting
          260  +.el (\\*(lq\\$1\\*(rq\\$2)\\$3
          261  +..
          262  +.\"	# QR - quoted range
          263  +.de QR
          264  +.ie '\\*(lq'"' ``\\$1''\\-``\\$2''\\$3
          265  +.\"" fix emacs highlighting
          266  +.el \\*(lq\\$1\\*(rq\\-\\*(lq\\$2\\*(rq\\$3
          267  +..
          268  +.\"	# MT - "empty" string
          269  +.de MT
          270  +.QW ""
          271  +..
          272  +.BS
          273  +.SH NAME
          274  +tcllib_sources \- Tcllib - How To Get The Sources
          275  +.SH DESCRIPTION
          276  +Welcome to Tcllib, the Tcl Standard Library\&. Note that Tcllib is not a
          277  +package itself\&. It is a collection of (semi-independent) \fITcl\fR
          278  +packages that provide utility functions useful to a large collection
          279  +of Tcl programmers\&.
          280  +.PP
          281  +The audience of this document is anyone wishing to either have just a
          282  +look at Tcllib's source code, or build the packages, or to extend and
          283  +modify them\&.
          284  +.PP
          285  +For builders and developers we additionally provide
          286  +.IP [1]
          287  +\fITcllib - The Installer's Guide\fR\&.
          288  +.IP [2]
          289  +\fITcllib - The Developer's Guide\fR\&.
          290  +.PP
          291  +respectively\&.
          292  +.SH "SOURCE LOCATION"
          293  +The official repository for Tcllib can be found at
          294  +\fIhttp://core\&.tcl-lang\&.org/tcllib\fR
          295  +.SH RETRIEVAL
          296  +Assuming that you simply wish to look at the sources, or build a
          297  +specific revision, the easiest way of retrieving it is to:
          298  +.IP [1]
          299  +Log into this site, as "anonymous", using the semi-random password in the captcha\&.
          300  +.IP [2]
          301  +Go to the "Timeline"\&.
          302  +.IP [3]
          303  +Choose the revision you wish to have and
          304  +.IP [4]
          305  +follow its link to its detailed information page\&.
          306  +.IP [5]
          307  +On that page, choose either the "ZIP" or "Tarball" link to get
          308  +a copy of this revision in the format of your choice\&.
          309  +.PP
          310  +.SH "SOURCE CODE MANAGEMENT"
          311  +For the curious (or a developer-to-be), the sources are managed by the
          312  +\fIFossil SCM\fR [http://www\&.fossil-scm\&.org]\&.
          313  +Binaries for popular platforms can be found directly at its
          314  +\fIdownload page\fR [http://www\&.fossil-scm\&.org/download\&.html]\&.
          315  +.PP
          316  +With that tool available the full history can be retrieved via:
          317  +.CS
          318  +
          319  +
          320  +    fossil clone  http://core\&.tcl-lang\&.org/tcllib  tcllib\&.fossil
          321  +
          322  +.CE
          323  +followed by
          324  +.CS
          325  +
          326  +
          327  +    mkdir tcllib
          328  +    cd tcllib
          329  +    fossil open \&.\&./tcllib\&.fossil
          330  +
          331  +.CE
          332  +to get a checkout of the head of the trunk\&.

Changes to idoc/man/toc.n.

  1337   1337   .TP
  1338   1338   \fBtclDESjr\fR
  1339   1339   \fIfiles/modules/des/tcldesjr\&.n\fR: Implementation of the DES and triple-DES ciphers
  1340   1340   .TP
  1341   1341   \fBtcldocstrip\fR
  1342   1342   \fIfiles/apps/tcldocstrip\&.n\fR: Tcl-based Docstrip Processor
  1343   1343   .TP
         1344  +\fBtcllib_install_guide\fR
         1345  +\fIfiles/devdoc/tcllib_installer\&.n\fR: Tcllib - The Installer's Guide
         1346  +.TP
  1344   1347   \fBtcllib_ip\fR
  1345   1348   \fIfiles/modules/dns/tcllib_ip\&.n\fR: IPv4 and IPv6 address manipulation
  1346   1349   .TP
         1350  +\fBtcllib_license\fR
         1351  +\fIfiles/devdoc/tcllib_license\&.n\fR: Tcllib - License
         1352  +.TP
         1353  +\fBtcllib_sources\fR
         1354  +\fIfiles/devdoc/tcllib_sources\&.n\fR: Tcllib - How To Get The Sources
         1355  +.TP
  1347   1356   \fBtclrep/machineparameters\fR
  1348   1357   \fIfiles/modules/math/machineparameters\&.n\fR: Compute double precision machine parameters\&.
  1349   1358   .TP
  1350   1359   \fBtepam\fR
  1351   1360   \fIfiles/modules/tepam/tepam_introduction\&.n\fR: An introduction into TEPAM, Tcl's Enhanced Procedure and Argument Manager
  1352   1361   .TP
  1353   1362   \fBtepam::argument_dialogbox\fR

Added idoc/www/tcllib/files/devdoc/tcllib_installer.html.

            1  +
            2  +<!DOCTYPE html><html><head>
            3  +<title>tcllib_install_guide - </title>
            4  +<style type="text/css"><!--
            5  +    HTML {
            6  +	background: 	#FFFFFF;
            7  +	color: 		black;
            8  +    }
            9  +    BODY {
           10  +	background: 	#FFFFFF;
           11  +	color:	 	black;
           12  +    }
           13  +    DIV.doctools {
           14  +	margin-left:	10%;
           15  +	margin-right:	10%;
           16  +    }
           17  +    DIV.doctools H1,DIV.doctools H2 {
           18  +	margin-left:	-5%;
           19  +    }
           20  +    H1, H2, H3, H4 {
           21  +	margin-top: 	1em;
           22  +	font-family:	sans-serif;
           23  +	font-size:	large;
           24  +	color:		#005A9C;
           25  +	background: 	transparent;
           26  +	text-align:		left;
           27  +    }
           28  +    H1.doctools_title {
           29  +	text-align: center;
           30  +    }
           31  +    UL,OL {
           32  +	margin-right: 0em;
           33  +	margin-top: 3pt;
           34  +	margin-bottom: 3pt;
           35  +    }
           36  +    UL LI {
           37  +	list-style: disc;
           38  +    }
           39  +    OL LI {
           40  +	list-style: decimal;
           41  +    }
           42  +    DT {
           43  +	padding-top: 	1ex;
           44  +    }
           45  +    UL.doctools_toc,UL.doctools_toc UL, UL.doctools_toc UL UL {
           46  +	font:		normal 12pt/14pt sans-serif;
           47  +	list-style:	none;
           48  +    }
           49  +    LI.doctools_section, LI.doctools_subsection {
           50  +	list-style: 	none;
           51  +	margin-left: 	0em;
           52  +	text-indent:	0em;
           53  +	padding: 	0em;
           54  +    }
           55  +    PRE {
           56  +	display: 	block;
           57  +	font-family:	monospace;
           58  +	white-space:	pre;
           59  +	margin:		0%;
           60  +	padding-top:	0.5ex;
           61  +	padding-bottom:	0.5ex;
           62  +	padding-left:	1ex;
           63  +	padding-right:	1ex;
           64  +	width:		100%;
           65  +    }
           66  +    PRE.doctools_example {
           67  +	color: 		black;
           68  +	background: 	#f5dcb3;
           69  +	border:		1px solid black;
           70  +    }
           71  +    UL.doctools_requirements LI, UL.doctools_syntax LI {
           72  +	list-style: 	none;
           73  +	margin-left: 	0em;
           74  +	text-indent:	0em;
           75  +	padding:	0em;
           76  +    }
           77  +    DIV.doctools_synopsis {
           78  +	color: 		black;
           79  +	background: 	#80ffff;
           80  +	border:		1px solid black;
           81  +	font-family:	serif;
           82  +	margin-top: 	1em;
           83  +	margin-bottom: 	1em;
           84  +    }
           85  +    UL.doctools_syntax {
           86  +	margin-top: 	1em;
           87  +	border-top:	1px solid black;
           88  +    }
           89  +    UL.doctools_requirements {
           90  +	margin-bottom: 	1em;
           91  +	border-bottom:	1px solid black;
           92  +    }
           93  +--></style>
           94  +</head>
           95  +<!-- Generated from file 'tcllib_installer.man' by tcllib/doctools with format 'html'
           96  +   -->
           97  +<!-- tcllib_install_guide.n
           98  +   -->
           99  +<body><hr> [
          100  +   <a href="../../../../../../../home">Tcllib Home</a>
          101  +| <a href="../../../toc.html">Main Table Of Contents</a>
          102  +| <a href="../../toc.html">Table Of Contents</a>
          103  +| <a href="../../../index.html">Keyword Index</a>
          104  +| <a href="../../../toc0.html">Categories</a>
          105  +| <a href="../../../toc1.html">Modules</a>
          106  +| <a href="../../../toc2.html">Applications</a>
          107  + ] <hr>
          108  +<div class="doctools">
          109  +<h1 class="doctools_title">tcllib_install_guide(n) 1 tcllib &quot;&quot;</h1>
          110  +<div id="name" class="doctools_section"><h2><a name="name">Name</a></h2>
          111  +<p>tcllib_install_guide - Tcllib - The Installer's Guide</p>
          112  +</div>
          113  +<div id="toc" class="doctools_section"><h2><a name="toc">Table Of Contents</a></h2>
          114  +<ul class="doctools_toc">
          115  +<li class="doctools_section"><a href="#toc">Table Of Contents</a></li>
          116  +<li class="doctools_section"><a href="#section1">Description</a></li>
          117  +<li class="doctools_section"><a href="#section2">Requisites</a>
          118  +<ul>
          119  +<li class="doctools_subsection"><a href="#subsection1">Tcl</a></li>
          120  +<li class="doctools_subsection"><a href="#subsection2">CriTcl</a></li>
          121  +</ul>
          122  +</li>
          123  +<li class="doctools_section"><a href="#section3">Build &amp; Installation Instructions</a>
          124  +<ul>
          125  +<li class="doctools_subsection"><a href="#subsection3">Unix</a></li>
          126  +<li class="doctools_subsection"><a href="#subsection4">Windows</a></li>
          127  +<li class="doctools_subsection"><a href="#subsection5">Critcl &amp; Accelerators</a></ul>
          128  +</li>
          129  +</ul>
          130  +</div>
          131  +<div id="section1" class="doctools_section"><h2><a name="section1">Description</a></h2>
          132  +<p>Welcome to Tcllib, the Tcl Standard Library. Note that Tcllib is not a
          133  +package itself. It is a collection of (semi-independent) <i class="term"><a href="../../../index.html#tcl">Tcl</a></i>
          134  +packages that provide utility functions useful to a large collection
          135  +of Tcl programmers.</p>
          136  +<p>The audience of this document is anyone wishing to build the packages,
          137  +for either themselves, or others.</p>
          138  +<p>For a developer intending to extend or modify the packages we
          139  +additionally provide</p>
          140  +<ol class="doctools_enumerated">
          141  +<li><p><i class="term">Tcllib - The Developer's Guide</i>.</p></li>
          142  +</ol>
          143  +<p>Please read <i class="term"><a href="tcllib_sources.html">Tcllib - How To Get The Sources</a></i> first, if that
          144  +was not done already. Here we assume that the sources are already
          145  +available in a directory of your choice.</p>
          146  +</div>
          147  +<div id="section2" class="doctools_section"><h2><a name="section2">Requisites</a></h2>
          148  +<p>Before Tcllib can be build and used a number of requisites must be installed.
          149  +These are:</p>
          150  +<ol class="doctools_enumerated">
          151  +<li><p>The scripting language Tcl.
          152  +       For details see <span class="sectref"><a href="#subsection1">Tcl</a></span>.</p></li>
          153  +<li><p>Optionally, the <b class="package">critcl</b> package (C embedding) for <b class="syscmd"><a href="../../../index.html#tcl">Tcl</a></b>.
          154  +       For details see <span class="sectref"><a href="#subsection2">CriTcl</a></span>.</p></li>
          155  +</ol>
          156  +<p>This list assumes that the machine where Tcllib is to be installed is
          157  +essentially clean. Of course, if parts of the dependencies listed
          158  +below are already installed the associated steps can be skipped. It is
          159  +still recommended to read their sections though, to validate that the
          160  +dependencies they talk about are indeed installed.</p>
          161  +<div id="subsection1" class="doctools_subsection"><h3><a name="subsection1">Tcl</a></h3>
          162  +<p>As we are installing a number of Tcl packages and applications it
          163  +should be pretty much obvious that a working installation of Tcl
          164  +itself is needed, and I will not belabor the point.</p>
          165  +<p>Out of the many possibilites use whatever you are comfortable
          166  +with, as long as it provides Tcl 8.2, or higher.
          167  +This may be a Tcl installation provided by your operating system
          168  +distribution, from a distribution-independent vendor, or built by
          169  +yourself.</p>
          170  +<p><em>Note</em> that the packages in Tcllib have begun to require
          171  +8.4, 8.5, and even 8.6. Older versions of Tcl will not be able to use
          172  +such packages. Trying to use them will result in
          173  +<em>package not found</em> errors, as their package index files will
          174  +not register them in versions of the core unable to use them.</p>
          175  +<p>Myself, I used (and still use)
          176  +<a href="http://www.activestate.com">ActiveState's</a>
          177  +ActiveTcl 8.5 distribution during development, as I am most familiar
          178  +with it.</p>
          179  +<p><em>(Disclosure: I, Andreas Kupries, worked for ActiveState until 2016, maintaining ActiveTcl and TclDevKit for them).</em>.
          180  +I am currently working for SUSE Software Canada ULC, although not in
          181  +Tcl-related areas.</p>
          182  +<p>This distribution can be found at
          183  +<a href="http://www.activestate.com/activetcl">http://www.activestate.com/activetcl</a>. Retrieve the archive of
          184  +ActiveTcl 8.5 (or higher) for your platform and install it as directed
          185  +by ActiveState.</p>
          186  +<p>For those wishing to build and install Tcl on their own, the
          187  +relevant sources can be found at</p>
          188  +<dl class="doctools_definitions">
          189  +<dt>Tcl</dt>
          190  +<dd><p><a href="http://core.tcl-lang.org/tcl/">http://core.tcl-lang.org/tcl/</a></p></dd>
          191  +</dl>
          192  +<p>together with the necessary instructions on how to build it.</p>
          193  +<p>If there are problems with building, installing, or using Tcl
          194  +please file a ticket against <i class="term"><a href="../../../index.html#tcl">Tcl</a></i>, or the vendor of your
          195  +distribution, and <em>not</em> <i class="term"><a href="../../../index.html#tcllib">Tcllib</a></i>.</p>
          196  +</div>
          197  +<div id="subsection2" class="doctools_subsection"><h3><a name="subsection2">CriTcl</a></h3>
          198  +<p>The <b class="syscmd">critcl</b> tool is an <em>optional</em> dependency.</p>
          199  +<p>It is only required when trying to build the C-based
          200  +<i class="term">accelerators</i> for a number of packages, as explained in
          201  +<span class="sectref"><a href="#subsection5">Critcl &amp; Accelerators</a></span></p>
          202  +<p>Tcllib's build system accepts it as an application found in the
          203  +PATH (be it starkit or starpack).</p>
          204  +<p>Tcllib requires version 2 or higher.</p>
          205  +<p>The github repository providing releases of version 2 and
          206  +higher, and the associated sources, can be found at
          207  +<a href="http://andreas-kupries.github.com/critcl">http://andreas-kupries.github.com/critcl</a>.</p>
          208  +<p>Any branch of the repository can be used (if not using the
          209  +prebuild starkit or starpack), although the use of the stable branch
          210  +<em>master</em> is recommended.</p>
          211  +<p>At the above url is also an explanation on how to build and
          212  +install CriTcl, including a list of its dependencies.</p>
          213  +<p>Its instructions will not be repeated here. If there are
          214  +problems with their directions please file a ticket against the
          215  +<i class="term">Critcl</i> project, and not Tcllib.</p>
          216  +</div>
          217  +</div>
          218  +<div id="section3" class="doctools_section"><h2><a name="section3">Build &amp; Installation Instructions</a></h2>
          219  +<div id="subsection3" class="doctools_subsection"><h3><a name="subsection3">Unix</a></h3>
          220  +<p>This section describes the actions required to install Tcllib on Unix
          221  +systems (Linux, BSD, and related, including OS X).
          222  +If you have to install Tcllib on a Windows machine instead then see
          223  +section <span class="sectref"><a href="#subsection4">Windows</a></span>.</p>
          224  +<p>Tcllib comes with a standard TEA buildsystem using a
          225  +<b class="syscmd">configure</b> script and a &quot;<b class="file">Makefile</b>&quot; generated by it.</p>
          226  +<p>To install Tcllib simply run</p>
          227  +<pre class="doctools_example">
          228  +    ./configure
          229  +    make install
          230  +</pre>
          231  +<p>in the toplevel directory of Tcllib itself. To build in a directory D
          232  +outside of Tcllib's toplevel directory simply make D the current
          233  +working directory and invoke <b class="syscmd">configure</b> with either its
          234  +absolute path or a proper relative path.</p>
          235  +<p>The above will non-interactively install all packages,
          236  +applications found in Tcllib, and their manpages, in directories
          237  +derived from what <b class="syscmd">configure</b> found out about the system.</p>
          238  +<p>The underlying tool is &quot;<b class="file">installer.tcl</b>&quot; in the toplevel
          239  +directory of Tcllib.</p>
          240  +<p>Invoking this tool via</p>
          241  +<pre class="doctools_example">
          242  +    ./installer.tcl -help
          243  +</pre>
          244  +<p>will provide a short list of the available options. For more examples
          245  +see the various <i class="term">install</i> targets found in &quot;<b class="file">Makefile.in</b>&quot;.</p>
          246  +</div>
          247  +<div id="subsection4" class="doctools_subsection"><h3><a name="subsection4">Windows</a></h3>
          248  +<p>This section describes the actions required to install Tcllib on Windows(tm)
          249  +systems.
          250  +If you have to install Tcllib on a Unix machine (Linux, BSD, and
          251  +related, including OS X) instead then see section <span class="sectref"><a href="#subsection3">Unix</a></span>.</p>
          252  +<p>If the build environment is based on <i class="term">MSYS</i>,
          253  +<i class="term">cygwin</i>, or a similar emulation of a unix environment, then
          254  +<span class="sectref"><a href="#subsection3">Unix</a></span> still applies and should be used.</p>
          255  +<p>Alternatively, as mentioned in the previous section, the tool
          256  +underneath of the unix buildsystem is the <i class="term"><a href="../../../index.html#tcl">Tcl</a></i>-based
          257  +&quot;<b class="file">installer.tcl</b>&quot; script.</p>
          258  +<p>Invoking this tool from a DOS shell via</p>
          259  +<pre class="doctools_example">
          260  +    /path/to/tclsh ./installer.tcl -help
          261  +</pre>
          262  +<p>will provide a short list of the available options. For more examples
          263  +see the various <i class="term">install</i> targets found in &quot;<b class="file">Makefile.in</b>&quot;.
          264  +Invoking this tool without any arguments, i.e. like</p>
          265  +<pre class="doctools_example">
          266  +    /path/to/tclsh ./installer.tcl
          267  +</pre>
          268  +<p>will start a non-interactive installation showing its progress in a
          269  +Tk-based graphical interface. The directories to install the packages,
          270  +applications, etc. into are derived from the location of the
          271  +<b class="syscmd">tclsh</b> used to invoke the script, and where it expects
          272  +packages.</p>
          273  +</div>
          274  +<div id="subsection5" class="doctools_subsection"><h3><a name="subsection5">Critcl &amp; Accelerators</a></h3>
          275  +<p>A number of packages come with <i class="term">accelerators</i>, i.e.
          276  +<b class="syscmd">critcl</b>-based C code whose use will boost the performance of
          277  +the packages using them. As these accelerators are optional they are
          278  +not installed by default.</p>
          279  +<p>To build the accelerators the normally optional dependency on
          280  +<b class="syscmd">critcl</b> becomes required.</p>
          281  +<p>To install Tcllib with the accelerators run</p>
          282  +<pre class="doctools_example">
          283  +    ./configure
          284  +    make critcl # This builds the shared library holding the accelerators
          285  +    make install
          286  +</pre>
          287  +<p>The underlying tool is &quot;<b class="file">sak.tcl</b>&quot; in the toplevel directory
          288  +of Tcllib and the command <b class="cmd">make critcl</b> is just a wrapper around</p>
          289  +<pre class="doctools_example">
          290  +    ./sak.tcl critcl
          291  +</pre>
          292  +</div>
          293  +</div>
          294  +</div></body></html>

Added idoc/www/tcllib/files/devdoc/tcllib_license.html.

            1  +
            2  +<!DOCTYPE html><html><head>
            3  +<title>tcllib_license - </title>
            4  +<style type="text/css"><!--
            5  +    HTML {
            6  +	background: 	#FFFFFF;
            7  +	color: 		black;
            8  +    }
            9  +    BODY {
           10  +	background: 	#FFFFFF;
           11  +	color:	 	black;
           12  +    }
           13  +    DIV.doctools {
           14  +	margin-left:	10%;
           15  +	margin-right:	10%;
           16  +    }
           17  +    DIV.doctools H1,DIV.doctools H2 {
           18  +	margin-left:	-5%;
           19  +    }
           20  +    H1, H2, H3, H4 {
           21  +	margin-top: 	1em;
           22  +	font-family:	sans-serif;
           23  +	font-size:	large;
           24  +	color:		#005A9C;
           25  +	background: 	transparent;
           26  +	text-align:		left;
           27  +    }
           28  +    H1.doctools_title {
           29  +	text-align: center;
           30  +    }
           31  +    UL,OL {
           32  +	margin-right: 0em;
           33  +	margin-top: 3pt;
           34  +	margin-bottom: 3pt;
           35  +    }
           36  +    UL LI {
           37  +	list-style: disc;
           38  +    }
           39  +    OL LI {
           40  +	list-style: decimal;
           41  +    }
           42  +    DT {
           43  +	padding-top: 	1ex;
           44  +    }
           45  +    UL.doctools_toc,UL.doctools_toc UL, UL.doctools_toc UL UL {
           46  +	font:		normal 12pt/14pt sans-serif;
           47  +	list-style:	none;
           48  +    }
           49  +    LI.doctools_section, LI.doctools_subsection {
           50  +	list-style: 	none;
           51  +	margin-left: 	0em;
           52  +	text-indent:	0em;
           53  +	padding: 	0em;
           54  +    }
           55  +    PRE {
           56  +	display: 	block;
           57  +	font-family:	monospace;
           58  +	white-space:	pre;
           59  +	margin:		0%;
           60  +	padding-top:	0.5ex;
           61  +	padding-bottom:	0.5ex;
           62  +	padding-left:	1ex;
           63  +	padding-right:	1ex;
           64  +	width:		100%;
           65  +    }
           66  +    PRE.doctools_example {
           67  +	color: 		black;
           68  +	background: 	#f5dcb3;
           69  +	border:		1px solid black;
           70  +    }
           71  +    UL.doctools_requirements LI, UL.doctools_syntax LI {
           72  +	list-style: 	none;
           73  +	margin-left: 	0em;
           74  +	text-indent:	0em;
           75  +	padding:	0em;
           76  +    }
           77  +    DIV.doctools_synopsis {
           78  +	color: 		black;
           79  +	background: 	#80ffff;
           80  +	border:		1px solid black;
           81  +	font-family:	serif;
           82  +	margin-top: 	1em;
           83  +	margin-bottom: 	1em;
           84  +    }
           85  +    UL.doctools_syntax {
           86  +	margin-top: 	1em;
           87  +	border-top:	1px solid black;
           88  +    }
           89  +    UL.doctools_requirements {
           90  +	margin-bottom: 	1em;
           91  +	border-bottom:	1px solid black;
           92  +    }
           93  +--></style>
           94  +</head>
           95  +<!-- Generated from file 'tcllib_license.man' by tcllib/doctools with format 'html'
           96  +   -->
           97  +<!-- tcllib_license.n
           98  +   -->
           99  +<body><hr> [
          100  +   <a href="../../../../../../../home">Tcllib Home</a>
          101  +| <a href="../../../toc.html">Main Table Of Contents</a>
          102  +| <a href="../../toc.html">Table Of Contents</a>
          103  +| <a href="../../../index.html">Keyword Index</a>
          104  +| <a href="../../../toc0.html">Categories</a>
          105  +| <a href="../../../toc1.html">Modules</a>
          106  +| <a href="../../../toc2.html">Applications</a>
          107  + ] <hr>
          108  +<div class="doctools">
          109  +<h1 class="doctools_title">tcllib_license(n) 1 tcllib &quot;&quot;</h1>
          110  +<div id="name" class="doctools_section"><h2><a name="name">Name</a></h2>
          111  +<p>tcllib_license - Tcllib - License</p>
          112  +</div>
          113  +<div id="toc" class="doctools_section"><h2><a name="toc">Table Of Contents</a></h2>
          114  +<ul class="doctools_toc">
          115  +<li class="doctools_section"><a href="#toc">Table Of Contents</a></li>
          116  +<li class="doctools_section"><a href="#section1">Description</a></li>
          117  +<li class="doctools_section"><a href="#section2">License</a></li>
          118  +</ul>
          119  +</div>
          120  +<div id="section1" class="doctools_section"><h2><a name="section1">Description</a></h2>
          121  +<p>Welcome to Tcllib, the Tcl Standard Library. Note that Tcllib is not a
          122  +package itself. It is a collection of (semi-independent) <i class="term"><a href="../../../index.html#tcl">Tcl</a></i>
          123  +packages that provide utility functions useful to a large collection
          124  +of Tcl programmers.</p>
          125  +<p>The collection is under the BSD license.</p>
          126  +</div>
          127  +<div id="section2" class="doctools_section"><h2><a name="section2">License</a></h2>
          128  +<p>This software is copyrighted by Ajuba Solutions and other parties.
          129  +The following terms apply to all files associated with the software
          130  +unless explicitly disclaimed in individual files.</p>
          131  +<p>The authors hereby grant permission to use, copy, modify, distribute,
          132  +and license this software and its documentation for any purpose,
          133  +provided that existing copyright notices are retained in all copies
          134  +and that this notice is included verbatim in any distributions. No
          135  +written agreement, license, or royalty fee is required for any of the
          136  +authorized uses.  Modifications to this software may be copyrighted by
          137  +their authors and need not follow the licensing terms described here,
          138  +provided that the new terms are clearly indicated on the first page of
          139  +each file where they apply.</p>
          140  +<p>IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY
          141  +FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
          142  +ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY
          143  +DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE
          144  +POSSIBILITY OF SUCH DAMAGE.</p>
          145  +<p>THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
          146  +INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
          147  +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND
          148  +NON-INFRINGEMENT.  THIS SOFTWARE IS PROVIDED ON AN &quot;AS IS&quot; BASIS, AND
          149  +THE AUTHORS AND DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE
          150  +MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.</p>
          151  +<p>GOVERNMENT USE: If you are acquiring this software on behalf of the
          152  +U.S. government, the Government shall have only &quot;Restricted Rights&quot; in
          153  +the software and related documentation as defined in the Federal
          154  +Acquisition Regulations (FARs) in Clause 52.227.19 (c) (2).  If you
          155  +are acquiring the software on behalf of the Department of Defense, the
          156  +software shall be classified as &quot;Commercial Computer Software&quot; and the
          157  +Government shall have only &quot;Restricted Rights&quot; as defined in Clause
          158  +252.227-7013 (c) (1) of DFARs.  Notwithstanding the foregoing, the
          159  +authors grant the U.S. Government and others acting in its behalf
          160  +permission to use and distribute the software in accordance with the
          161  +terms specified in this license.</p>
          162  +</div>
          163  +</div></body></html>

Added idoc/www/tcllib/files/devdoc/tcllib_sources.html.

            1  +
            2  +<!DOCTYPE html><html><head>
            3  +<title>tcllib_sources - </title>
            4  +<style type="text/css"><!--
            5  +    HTML {
            6  +	background: 	#FFFFFF;
            7  +	color: 		black;
            8  +    }
            9  +    BODY {
           10  +	background: 	#FFFFFF;
           11  +	color:	 	black;
           12  +    }
           13  +    DIV.doctools {
           14  +	margin-left:	10%;
           15  +	margin-right:	10%;
           16  +    }
           17  +    DIV.doctools H1,DIV.doctools H2 {
           18  +	margin-left:	-5%;
           19  +    }
           20  +    H1, H2, H3, H4 {
           21  +	margin-top: 	1em;
           22  +	font-family:	sans-serif;
           23  +	font-size:	large;
           24  +	color:		#005A9C;
           25  +	background: 	transparent;
           26  +	text-align:		left;
           27  +    }
           28  +    H1.doctools_title {
           29  +	text-align: center;
           30  +    }
           31  +    UL,OL {
           32  +	margin-right: 0em;
           33  +	margin-top: 3pt;
           34  +	margin-bottom: 3pt;
           35  +    }
           36  +    UL LI {
           37  +	list-style: disc;
           38  +    }
           39  +    OL LI {
           40  +	list-style: decimal;
           41  +    }
           42  +    DT {
           43  +	padding-top: 	1ex;
           44  +    }
           45  +    UL.doctools_toc,UL.doctools_toc UL, UL.doctools_toc UL UL {
           46  +	font:		normal 12pt/14pt sans-serif;
           47  +	list-style:	none;
           48  +    }
           49  +    LI.doctools_section, LI.doctools_subsection {
           50  +	list-style: 	none;
           51  +	margin-left: 	0em;
           52  +	text-indent:	0em;
           53  +	padding: 	0em;
           54  +    }
           55  +    PRE {
           56  +	display: 	block;
           57  +	font-family:	monospace;
           58  +	white-space:	pre;
           59  +	margin:		0%;
           60  +	padding-top:	0.5ex;
           61  +	padding-bottom:	0.5ex;
           62  +	padding-left:	1ex;
           63  +	padding-right:	1ex;
           64  +	width:		100%;
           65  +    }
           66  +    PRE.doctools_example {
           67  +	color: 		black;
           68  +	background: 	#f5dcb3;
           69  +	border:		1px solid black;
           70  +    }
           71  +    UL.doctools_requirements LI, UL.doctools_syntax LI {
           72  +	list-style: 	none;
           73  +	margin-left: 	0em;
           74  +	text-indent:	0em;
           75  +	padding:	0em;
           76  +    }
           77  +    DIV.doctools_synopsis {
           78  +	color: 		black;
           79  +	background: 	#80ffff;
           80  +	border:		1px solid black;
           81  +	font-family:	serif;
           82  +	margin-top: 	1em;
           83  +	margin-bottom: 	1em;
           84  +    }
           85  +    UL.doctools_syntax {
           86  +	margin-top: 	1em;
           87  +	border-top:	1px solid black;
           88  +    }
           89  +    UL.doctools_requirements {
           90  +	margin-bottom: 	1em;
           91  +	border-bottom:	1px solid black;
           92  +    }
           93  +--></style>
           94  +</head>
           95  +<!-- Generated from file 'tcllib_sources.man' by tcllib/doctools with format 'html'
           96  +   -->
           97  +<!-- tcllib_sources.n
           98  +   -->
           99  +<body><hr> [
          100  +   <a href="../../../../../../../home">Tcllib Home</a>
          101  +| <a href="../../../toc.html">Main Table Of Contents</a>
          102  +| <a href="../../toc.html">Table Of Contents</a>
          103  +| <a href="../../../index.html">Keyword Index</a>
          104  +| <a href="../../../toc0.html">Categories</a>
          105  +| <a href="../../../toc1.html">Modules</a>
          106  +| <a href="../../../toc2.html">Applications</a>
          107  + ] <hr>
          108  +<div class="doctools">
          109  +<h1 class="doctools_title">tcllib_sources(n) 1 tcllib &quot;&quot;</h1>
          110  +<div id="name" class="doctools_section"><h2><a name="name">Name</a></h2>
          111  +<p>tcllib_sources - Tcllib - How To Get The Sources</p>
          112  +</div>
          113  +<div id="toc" class="doctools_section"><h2><a name="toc">Table Of Contents</a></h2>
          114  +<ul class="doctools_toc">
          115  +<li class="doctools_section"><a href="#toc">Table Of Contents</a></li>
          116  +<li class="doctools_section"><a href="#section1">Description</a></li>
          117  +<li class="doctools_section"><a href="#section2">Source Location</a></li>
          118  +<li class="doctools_section"><a href="#section3">Retrieval</a></li>
          119  +<li class="doctools_section"><a href="#section4">Source Code Management</a></li>
          120  +</ul>
          121  +</div>
          122  +<div id="section1" class="doctools_section"><h2><a name="section1">Description</a></h2>
          123  +<p>Welcome to Tcllib, the Tcl Standard Library. Note that Tcllib is not a
          124  +package itself. It is a collection of (semi-independent) <i class="term"><a href="../../../index.html#tcl">Tcl</a></i>
          125  +packages that provide utility functions useful to a large collection
          126  +of Tcl programmers.</p>
          127  +<p>The audience of this document is anyone wishing to either have just a
          128  +look at Tcllib's source code, or build the packages, or to extend and
          129  +modify them.</p>
          130  +<p>For builders and developers we additionally provide</p>
          131  +<ol class="doctools_enumerated">
          132  +<li><p><i class="term"><a href="tcllib_installer.html">Tcllib - The Installer's Guide</a></i>.</p></li>
          133  +<li><p><i class="term">Tcllib - The Developer's Guide</i>.</p></li>
          134  +</ol>
          135  +<p>respectively.</p>
          136  +</div>
          137  +<div id="section2" class="doctools_section"><h2><a name="section2">Source Location</a></h2>
          138  +<p>The official repository for Tcllib can be found at
          139  +<a href="http://core.tcl-lang.org/tcllib">http://core.tcl-lang.org/tcllib</a></p>
          140  +</div>
          141  +<div id="section3" class="doctools_section"><h2><a name="section3">Retrieval</a></h2>
          142  +<p>Assuming that you simply wish to look at the sources, or build a
          143  +specific revision, the easiest way of retrieving it is to:</p>
          144  +<ol class="doctools_enumerated">
          145  +<li><p>Log into this site, as &quot;anonymous&quot;, using the semi-random password in the captcha.</p></li>
          146  +<li><p>Go to the &quot;Timeline&quot;.</p></li>
          147  +<li><p>Choose the revision you wish to have and</p></li>
          148  +<li><p>follow its link to its detailed information page.</p></li>
          149  +<li><p>On that page, choose either the &quot;ZIP&quot; or &quot;Tarball&quot; link to get
          150  +a copy of this revision in the format of your choice.</p></li>
          151  +</ol>
          152  +</div>
          153  +<div id="section4" class="doctools_section"><h2><a name="section4">Source Code Management</a></h2>
          154  +<p>For the curious (or a developer-to-be), the sources are managed by the
          155  +<a href="http://www.fossil-scm.org">Fossil SCM</a>.
          156  +Binaries for popular platforms can be found directly at its
          157  +<a href="http://www.fossil-scm.org/download.html">download page</a>.</p>
          158  +<p>With that tool available the full history can be retrieved via:</p>
          159  +<pre class="doctools_example">
          160  +    fossil clone  http://core.tcl-lang.org/tcllib  tcllib.fossil
          161  +</pre>
          162  +<p>followed by</p>
          163  +<pre class="doctools_example">
          164  +    mkdir tcllib
          165  +    cd tcllib
          166  +    fossil open ../tcllib.fossil
          167  +</pre>
          168  +<p>to get a checkout of the head of the trunk.</p>
          169  +</div>
          170  +</div></body></html>

Changes to idoc/www/tcllib/toc.html.

  1437   1437   <td class="#doctools_tocright">Implementation of the DES and triple-DES ciphers</td>
  1438   1438   </tr>
  1439   1439   <tr class="#doctools_tocodd"  >
  1440   1440   <td class="#doctools_tocleft" ><a name='tcldocstrip'><a href="files/apps/tcldocstrip.html">tcldocstrip</a></td>
  1441   1441   <td class="#doctools_tocright">Tcl-based Docstrip Processor</td>
  1442   1442   </tr>
  1443   1443   <tr class="#doctools_toceven" >
         1444  +<td class="#doctools_tocleft" ><a name='tcllib_install_guide'><a href="files/devdoc/tcllib_installer.html">tcllib_install_guide</a></td>
         1445  +<td class="#doctools_tocright">Tcllib - The Installer's Guide</td>
         1446  +</tr>
         1447  +<tr class="#doctools_tocodd"  >
  1444   1448   <td class="#doctools_tocleft" ><a name='tcllib_ip'><a href="files/modules/dns/tcllib_ip.html">tcllib_ip</a></td>
  1445   1449   <td class="#doctools_tocright">IPv4 and IPv6 address manipulation</td>
  1446   1450   </tr>
         1451  +<tr class="#doctools_toceven" >
         1452  +<td class="#doctools_tocleft" ><a name='tcllib_license'><a href="files/devdoc/tcllib_license.html">tcllib_license</a></td>
         1453  +<td class="#doctools_tocright">Tcllib - License</td>
         1454  +</tr>
  1447   1455   <tr class="#doctools_tocodd"  >
         1456  +<td class="#doctools_tocleft" ><a name='tcllib_sources'><a href="files/devdoc/tcllib_sources.html">tcllib_sources</a></td>
         1457  +<td class="#doctools_tocright">Tcllib - How To Get The Sources</td>
         1458  +</tr>
         1459  +<tr class="#doctools_toceven" >
  1448   1460   <td class="#doctools_tocleft" ><a name='tclrep_machineparameters'><a href="files/modules/math/machineparameters.html">tclrep/machineparameters</a></td>
  1449   1461   <td class="#doctools_tocright">Compute double precision machine parameters.</td>
  1450   1462   </tr>
  1451         -<tr class="#doctools_toceven" >
         1463  +<tr class="#doctools_tocodd"  >
  1452   1464   <td class="#doctools_tocleft" ><a name='tepam'><a href="files/modules/tepam/tepam_introduction.html">tepam</a></td>
  1453   1465   <td class="#doctools_tocright">An introduction into TEPAM, Tcl's Enhanced Procedure and Argument Manager</td>
  1454   1466   </tr>
  1455         -<tr class="#doctools_tocodd"  >
         1467  +<tr class="#doctools_toceven" >
  1456   1468   <td class="#doctools_tocleft" ><a name='tepam_argument_dialogbox'><a href="files/modules/tepam/tepam_argument_dialogbox.html">tepam::argument_dialogbox</a></td>
  1457   1469   <td class="#doctools_tocright">TEPAM argument_dialogbox, reference manual</td>
  1458   1470   </tr>
  1459         -<tr class="#doctools_toceven" >
         1471  +<tr class="#doctools_tocodd"  >
  1460   1472   <td class="#doctools_tocleft" ><a name='tepam_doc_gen'><a href="files/modules/tepam/tepam_doc_gen.html">tepam::doc_gen</a></td>
  1461   1473   <td class="#doctools_tocright">TEPAM DOC Generation, reference manual</td>
  1462   1474   </tr>
  1463         -<tr class="#doctools_tocodd"  >
         1475  +<tr class="#doctools_toceven" >
  1464   1476   <td class="#doctools_tocleft" ><a name='tepam_procedure'><a href="files/modules/tepam/tepam_procedure.html">tepam::procedure</a></td>
  1465   1477   <td class="#doctools_tocright">TEPAM procedure, reference manual</td>
  1466   1478   </tr>
  1467         -<tr class="#doctools_toceven" >
         1479  +<tr class="#doctools_tocodd"  >
  1468   1480   <td class="#doctools_tocleft" ><a name='term'><a href="files/modules/term/term.html">term</a></td>
  1469   1481   <td class="#doctools_tocright">General terminal control</td>
  1470   1482   </tr>
  1471         -<tr class="#doctools_tocodd"  >
         1483  +<tr class="#doctools_toceven" >
  1472   1484   <td class="#doctools_tocleft" ><a name='term_ansi_code'><a href="files/modules/term/ansi_code.html">term::ansi::code</a></td>
  1473   1485   <td class="#doctools_tocright">Helper for control sequences</td>
  1474   1486   </tr>
  1475         -<tr class="#doctools_toceven" >
         1487  +<tr class="#doctools_tocodd"  >
  1476   1488   <td class="#doctools_tocleft" ><a name='term_ansi_code_attr'><a href="files/modules/term/ansi_cattr.html">term::ansi::code::attr</a></td>
  1477   1489   <td class="#doctools_tocright">ANSI attribute sequences</td>
  1478   1490   </tr>
  1479         -<tr class="#doctools_tocodd"  >
         1491  +<tr class="#doctools_toceven" >
  1480   1492   <td class="#doctools_tocleft" ><a name='term_ansi_code_ctrl'><a href="files/modules/term/ansi_cctrl.html">term::ansi::code::ctrl</a></td>
  1481   1493   <td class="#doctools_tocright">ANSI control sequences</td>
  1482   1494   </tr>
  1483         -<tr class="#doctools_toceven" >
         1495  +<tr class="#doctools_tocodd"  >
  1484   1496   <td class="#doctools_tocleft" ><a name='term_ansi_code_macros'><a href="files/modules/term/ansi_cmacros.html">term::ansi::code::macros</a></td>
  1485   1497   <td class="#doctools_tocright">Macro sequences</td>
  1486   1498   </tr>
  1487         -<tr class="#doctools_tocodd"  >
         1499  +<tr class="#doctools_toceven" >
  1488   1500   <td class="#doctools_tocleft" ><a name='term_ansi_ctrl_unix'><a href="files/modules/term/ansi_ctrlu.html">term::ansi::ctrl::unix</a></td>
  1489   1501   <td class="#doctools_tocright">Control operations and queries</td>
  1490   1502   </tr>
  1491         -<tr class="#doctools_toceven" >
         1503  +<tr class="#doctools_tocodd"  >
  1492   1504   <td class="#doctools_tocleft" ><a name='term_ansi_send'><a href="files/modules/term/ansi_send.html">term::ansi::send</a></td>
  1493   1505   <td class="#doctools_tocright">Output of ANSI control sequences to terminals</td>
  1494   1506   </tr>
  1495         -<tr class="#doctools_tocodd"  >
         1507  +<tr class="#doctools_toceven" >
  1496   1508   <td class="#doctools_tocleft" ><a name='term_interact_menu'><a href="files/modules/term/imenu.html">term::interact::menu</a></td>
  1497   1509   <td class="#doctools_tocright">Terminal widget, menu</td>
  1498   1510   </tr>
  1499         -<tr class="#doctools_toceven" >
         1511  +<tr class="#doctools_tocodd"  >
  1500   1512   <td class="#doctools_tocleft" ><a name='term_interact_pager'><a href="files/modules/term/ipager.html">term::interact::pager</a></td>
  1501   1513   <td class="#doctools_tocright">Terminal widget, paging</td>
  1502   1514   </tr>
  1503         -<tr class="#doctools_tocodd"  >
         1515  +<tr class="#doctools_toceven" >
  1504   1516   <td class="#doctools_tocleft" ><a name='term_receive'><a href="files/modules/term/receive.html">term::receive</a></td>
  1505   1517   <td class="#doctools_tocright">General input from terminals</td>
  1506   1518   </tr>
  1507         -<tr class="#doctools_toceven" >
         1519  +<tr class="#doctools_tocodd"  >
  1508   1520   <td class="#doctools_tocleft" ><a name='term_receive_bind'><a href="files/modules/term/term_bind.html">term::receive::bind</a></td>
  1509   1521   <td class="#doctools_tocright">Keyboard dispatch from terminals</td>
  1510   1522   </tr>
  1511         -<tr class="#doctools_tocodd"  >
         1523  +<tr class="#doctools_toceven" >
  1512   1524   <td class="#doctools_tocleft" ><a name='term_send'><a href="files/modules/term/term_send.html">term::send</a></td>
  1513   1525   <td class="#doctools_tocright">General output to terminals</td>
  1514   1526   </tr>
  1515         -<tr class="#doctools_toceven" >
         1527  +<tr class="#doctools_tocodd"  >
  1516   1528   <td class="#doctools_tocleft" ><a name='textutil'><a href="files/modules/textutil/textutil.html">textutil</a></td>
  1517   1529   <td class="#doctools_tocright">Procedures to manipulate texts and strings.</td>
  1518   1530   </tr>
  1519         -<tr class="#doctools_tocodd"  >
         1531  +<tr class="#doctools_toceven" >
  1520   1532   <td class="#doctools_tocleft" ><a name='textutil_adjust'><a href="files/modules/textutil/adjust.html">textutil::adjust</a></td>
  1521   1533   <td class="#doctools_tocright">Procedures to adjust, indent, and undent paragraphs</td>
  1522   1534   </tr>
  1523         -<tr class="#doctools_toceven" >
         1535  +<tr class="#doctools_tocodd"  >
  1524   1536   <td class="#doctools_tocleft" ><a name='textutil_expander'><a href="files/modules/textutil/expander.html">textutil::expander</a></td>
  1525   1537   <td class="#doctools_tocright">Procedures to process templates and expand text.</td>
  1526   1538   </tr>
  1527         -<tr class="#doctools_tocodd"  >
         1539  +<tr class="#doctools_toceven" >
  1528   1540   <td class="#doctools_tocleft" ><a name='textutil_repeat'><a href="files/modules/textutil/repeat.html">textutil::repeat</a></td>
  1529   1541   <td class="#doctools_tocright">Procedures to repeat strings.</td>
  1530   1542   </tr>
  1531         -<tr class="#doctools_toceven" >
         1543  +<tr class="#doctools_tocodd"  >
  1532   1544   <td class="#doctools_tocleft" ><a name='textutil_split'><a href="files/modules/textutil/textutil_split.html">textutil::split</a></td>
  1533   1545   <td class="#doctools_tocright">Procedures to split texts</td>
  1534   1546   </tr>
  1535         -<tr class="#doctools_tocodd"  >
         1547  +<tr class="#doctools_toceven" >
  1536   1548   <td class="#doctools_tocleft" ><a name='textutil_string'><a href="files/modules/textutil/textutil_string.html">textutil::string</a></td>
  1537   1549   <td class="#doctools_tocright">Procedures to manipulate texts and strings.</td>
  1538   1550   </tr>
  1539         -<tr class="#doctools_toceven" >
         1551  +<tr class="#doctools_tocodd"  >
  1540   1552   <td class="#doctools_tocleft" ><a name='textutil_tabify'><a href="files/modules/textutil/tabify.html">textutil::tabify</a></td>
  1541   1553   <td class="#doctools_tocright">Procedures to (un)tabify strings</td>
  1542   1554   </tr>
  1543         -<tr class="#doctools_tocodd"  >
         1555  +<tr class="#doctools_toceven" >
  1544   1556   <td class="#doctools_tocleft" ><a name='textutil_trim'><a href="files/modules/textutil/trim.html">textutil::trim</a></td>
  1545   1557   <td class="#doctools_tocright">Procedures to trim strings</td>
  1546   1558   </tr>
  1547         -<tr class="#doctools_toceven" >
         1559  +<tr class="#doctools_tocodd"  >
  1548   1560   <td class="#doctools_tocleft" ><a name='throw'><a href="files/modules/try/tcllib_throw.html">throw</a></td>
  1549   1561   <td class="#doctools_tocright">throw - Throw an error exception with a message</td>
  1550   1562   </tr>
  1551         -<tr class="#doctools_tocodd"  >
         1563  +<tr class="#doctools_toceven" >
  1552   1564   <td class="#doctools_tocleft" ><a name='tie'><a href="files/modules/tie/tie_std.html">tie</a></td>
  1553   1565   <td class="#doctools_tocright">Array persistence, standard data sources</td>
  1554   1566   </tr>
  1555         -<tr class="#doctools_toceven" >
         1567  +<tr class="#doctools_tocodd"  >
  1556   1568   <td class="#doctools_tocleft" ><a name='tie'><a href="files/modules/tie/tie.html">tie</a></td>
  1557   1569   <td class="#doctools_tocright">Array persistence</td>
  1558   1570   </tr>
  1559         -<tr class="#doctools_tocodd"  >
         1571  +<tr class="#doctools_toceven" >
  1560   1572   <td class="#doctools_tocleft" ><a name='tiff'><a href="files/modules/tiff/tiff.html">tiff</a></td>
  1561   1573   <td class="#doctools_tocright">TIFF reading, writing, and querying and manipulation of meta data</td>
  1562   1574   </tr>
  1563         -<tr class="#doctools_toceven" >
         1575  +<tr class="#doctools_tocodd"  >
  1564   1576   <td class="#doctools_tocleft" ><a name='tool'><a href="files/modules/httpd/httpd.html">tool</a></td>
  1565   1577   <td class="#doctools_tocright">A TclOO and coroutine based web server</td>
  1566   1578   </tr>
  1567         -<tr class="#doctools_tocodd"  >
         1579  +<tr class="#doctools_toceven" >
  1568   1580   <td class="#doctools_tocleft" ><a name='tool'><a href="files/modules/tool/tool.html">tool</a></td>
  1569   1581   <td class="#doctools_tocright">TclOO Library (TOOL) Framework</td>
  1570   1582   </tr>
  1571         -<tr class="#doctools_toceven" >
         1583  +<tr class="#doctools_tocodd"  >
  1572   1584   <td class="#doctools_tocleft" ><a name='tool_dict_ensemble'><a href="files/modules/tool/tool_dict_ensemble.html">tool::dict_ensemble</a></td>
  1573   1585   <td class="#doctools_tocright">Dictionary Tools</td>
  1574   1586   </tr>
  1575         -<tr class="#doctools_tocodd"  >
         1587  +<tr class="#doctools_toceven" >
  1576   1588   <td class="#doctools_tocleft" ><a name='transfer_connect'><a href="files/modules/transfer/connect.html">transfer::connect</a></td>
  1577   1589   <td class="#doctools_tocright">Connection setup</td>
  1578   1590   </tr>
  1579         -<tr class="#doctools_toceven" >
         1591  +<tr class="#doctools_tocodd"  >
  1580   1592   <td class="#doctools_tocleft" ><a name='transfer_copy'><a href="files/modules/transfer/copyops.html">transfer::copy</a></td>
  1581   1593   <td class="#doctools_tocright">Data transfer foundation</td>
  1582   1594   </tr>
  1583         -<tr class="#doctools_tocodd"  >
         1595  +<tr class="#doctools_toceven" >
  1584   1596   <td class="#doctools_tocleft" ><a name='transfer_copy_queue'><a href="files/modules/transfer/tqueue.html">transfer::copy::queue</a></td>
  1585   1597   <td class="#doctools_tocright">Queued transfers</td>
  1586   1598   </tr>
  1587         -<tr class="#doctools_toceven" >
         1599  +<tr class="#doctools_tocodd"  >
  1588   1600   <td class="#doctools_tocleft" ><a name='transfer_data_destination'><a href="files/modules/transfer/ddest.html">transfer::data::destination</a></td>
  1589   1601   <td class="#doctools_tocright">Data destination</td>
  1590   1602   </tr>
  1591         -<tr class="#doctools_tocodd"  >
         1603  +<tr class="#doctools_toceven" >
  1592   1604   <td class="#doctools_tocleft" ><a name='transfer_data_source'><a href="files/modules/transfer/dsource.html">transfer::data::source</a></td>
  1593   1605   <td class="#doctools_tocright">Data source</td>
  1594   1606   </tr>
  1595         -<tr class="#doctools_toceven" >
         1607  +<tr class="#doctools_tocodd"  >
  1596   1608   <td class="#doctools_tocleft" ><a name='transfer_receiver'><a href="files/modules/transfer/receiver.html">transfer::receiver</a></td>
  1597   1609   <td class="#doctools_tocright">Data source</td>
  1598   1610   </tr>
  1599         -<tr class="#doctools_tocodd"  >
         1611  +<tr class="#doctools_toceven" >
  1600   1612   <td class="#doctools_tocleft" ><a name='transfer_transmitter'><a href="files/modules/transfer/transmitter.html">transfer::transmitter</a></td>
  1601   1613   <td class="#doctools_tocright">Data source</td>
  1602   1614   </tr>
  1603         -<tr class="#doctools_toceven" >
         1615  +<tr class="#doctools_tocodd"  >
  1604   1616   <td class="#doctools_tocleft" ><a name='treeql'><a href="files/modules/treeql/treeql.html">treeql</a></td>
  1605   1617   <td class="#doctools_tocright">Query tree objects</td>
  1606   1618   </tr>
  1607         -<tr class="#doctools_tocodd"  >
         1619  +<tr class="#doctools_toceven" >
  1608   1620   <td class="#doctools_tocleft" ><a name='try'><a href="files/modules/try/tcllib_try.html">try</a></td>
  1609   1621   <td class="#doctools_tocright">try - Trap and process errors and exceptions</td>
  1610   1622   </tr>
  1611         -<tr class="#doctools_toceven" >
         1623  +<tr class="#doctools_tocodd"  >
  1612   1624   <td class="#doctools_tocleft" ><a name='udpcluster'><a href="files/modules/udpcluster/udpcluster.html">udpcluster</a></td>
  1613   1625   <td class="#doctools_tocright">UDP Peer-to-Peer cluster</td>
  1614   1626   </tr>
  1615         -<tr class="#doctools_tocodd"  >
         1627  +<tr class="#doctools_toceven" >
  1616   1628   <td class="#doctools_tocleft" ><a name='uevent'><a href="files/modules/uev/uevent.html">uevent</a></td>
  1617   1629   <td class="#doctools_tocright">User events</td>
  1618   1630   </tr>
  1619         -<tr class="#doctools_toceven" >
         1631  +<tr class="#doctools_tocodd"  >
  1620   1632   <td class="#doctools_tocleft" ><a name='uevent_onidle'><a href="files/modules/uev/uevent_onidle.html">uevent::onidle</a></td>
  1621   1633   <td class="#doctools_tocright">Request merging and deferal to idle time</td>
  1622   1634   </tr>
  1623         -<tr class="#doctools_tocodd"  >
         1635  +<tr class="#doctools_toceven" >
  1624   1636   <td class="#doctools_tocleft" ><a name='unicode'><a href="files/modules/stringprep/unicode.html">unicode</a></td>
  1625   1637   <td class="#doctools_tocright">Implementation of Unicode normalization</td>
  1626   1638   </tr>
  1627         -<tr class="#doctools_toceven" >
         1639  +<tr class="#doctools_tocodd"  >
  1628   1640   <td class="#doctools_tocleft" ><a name='unicode_data'><a href="files/modules/stringprep/unicode_data.html">unicode::data</a></td>
  1629   1641   <td class="#doctools_tocright">unicode data tables, generated, internal</td>
  1630   1642   </tr>
  1631         -<tr class="#doctools_tocodd"  >
         1643  +<tr class="#doctools_toceven" >
  1632   1644   <td class="#doctools_tocleft" ><a name='units'><a href="files/modules/units/units.html">units</a></td>
  1633   1645   <td class="#doctools_tocright">unit conversion</td>
  1634   1646   </tr>
  1635         -<tr class="#doctools_toceven" >
         1647  +<tr class="#doctools_tocodd"  >
  1636   1648   <td class="#doctools_tocleft" ><a name='uri'><a href="files/modules/uri/uri.html">uri</a></td>
  1637   1649   <td class="#doctools_tocright">URI utilities</td>
  1638   1650   </tr>
  1639         -<tr class="#doctools_tocodd"  >
         1651  +<tr class="#doctools_toceven" >
  1640   1652   <td class="#doctools_tocleft" ><a name='uri_urn'><a href="files/modules/uri/urn-scheme.html">uri_urn</a></td>
  1641   1653   <td class="#doctools_tocright">URI utilities, URN scheme</td>
  1642   1654   </tr>
  1643         -<tr class="#doctools_toceven" >
         1655  +<tr class="#doctools_tocodd"  >
  1644   1656   <td class="#doctools_tocleft" ><a name='uuencode'><a href="files/modules/base64/uuencode.html">uuencode</a></td>
  1645   1657   <td class="#doctools_tocright">UU-encode/decode binary data</td>
  1646   1658   </tr>
  1647         -<tr class="#doctools_tocodd"  >
         1659  +<tr class="#doctools_toceven" >
  1648   1660   <td class="#doctools_tocleft" ><a name='uuid'><a href="files/modules/uuid/uuid.html">uuid</a></td>
  1649   1661   <td class="#doctools_tocright">UUID generation and comparison</td>
  1650   1662   </tr>
  1651         -<tr class="#doctools_toceven" >
         1663  +<tr class="#doctools_tocodd"  >
  1652   1664   <td class="#doctools_tocleft" ><a name='valtype_common'><a href="files/modules/valtype/valtype_common.html">valtype::common</a></td>
  1653   1665   <td class="#doctools_tocright">Validation, common code</td>
  1654   1666   </tr>
  1655         -<tr class="#doctools_tocodd"  >
         1667  +<tr class="#doctools_toceven" >
  1656   1668   <td class="#doctools_tocleft" ><a name='valtype_creditcard_amex'><a href="files/modules/valtype/cc_amex.html">valtype::creditcard::amex</a></td>
  1657   1669   <td class="#doctools_tocright">Validation for AMEX creditcard number</td>
  1658   1670   </tr>
  1659         -<tr class="#doctools_toceven" >
         1671  +<tr class="#doctools_tocodd"  >
  1660   1672   <td class="#doctools_tocleft" ><a name='valtype_creditcard_discover'><a href="files/modules/valtype/cc_discover.html">valtype::creditcard::discover</a></td>
  1661   1673   <td class="#doctools_tocright">Validation for Discover creditcard number</td>
  1662   1674   </tr>
  1663         -<tr class="#doctools_tocodd"  >
         1675  +<tr class="#doctools_toceven" >
  1664   1676   <td class="#doctools_tocleft" ><a name='valtype_creditcard_mastercard'><a href="files/modules/valtype/cc_mastercard.html">valtype::creditcard::mastercard</a></td>
  1665   1677   <td class="#doctools_tocright">Validation for Mastercard creditcard number</td>
  1666   1678   </tr>
  1667         -<tr class="#doctools_toceven" >
         1679  +<tr class="#doctools_tocodd"  >
  1668   1680   <td class="#doctools_tocleft" ><a name='valtype_creditcard_visa'><a href="files/modules/valtype/cc_visa.html">valtype::creditcard::visa</a></td>
  1669   1681   <td class="#doctools_tocright">Validation for VISA creditcard number</td>
  1670   1682   </tr>
  1671         -<tr class="#doctools_tocodd"  >
         1683  +<tr class="#doctools_toceven" >
  1672   1684   <td class="#doctools_tocleft" ><a name='valtype_gs1_ean13'><a href="files/modules/valtype/ean13.html">valtype::gs1::ean13</a></td>
  1673   1685   <td class="#doctools_tocright">Validation for EAN13</td>
  1674   1686   </tr>
  1675         -<tr class="#doctools_toceven" >
         1687  +<tr class="#doctools_tocodd"  >
  1676   1688   <td class="#doctools_tocleft" ><a name='valtype_iban'><a href="files/modules/valtype/iban.html">valtype::iban</a></td>
  1677   1689   <td class="#doctools_tocright">Validation for IBAN</td>
  1678   1690   </tr>
  1679         -<tr class="#doctools_tocodd"  >
         1691  +<tr class="#doctools_toceven" >
  1680   1692   <td class="#doctools_tocleft" ><a name='valtype_imei'><a href="files/modules/valtype/imei.html">valtype::imei</a></td>
  1681   1693   <td class="#doctools_tocright">Validation for IMEI</td>
  1682   1694   </tr>
  1683         -<tr class="#doctools_toceven" >
         1695  +<tr class="#doctools_tocodd"  >
  1684   1696   <td class="#doctools_tocleft" ><a name='valtype_isbn'><a href="files/modules/valtype/isbn.html">valtype::isbn</a></td>
  1685   1697   <td class="#doctools_tocright">Validation for ISBN</td>
  1686   1698   </tr>
  1687         -<tr class="#doctools_tocodd"  >
         1699  +<tr class="#doctools_toceven" >
  1688   1700   <td class="#doctools_tocleft" ><a name='valtype_luhn'><a href="files/modules/valtype/luhn.html">valtype::luhn</a></td>
  1689   1701   <td class="#doctools_tocright">Validation for plain number with a LUHN checkdigit</td>
  1690   1702   </tr>
  1691         -<tr class="#doctools_toceven" >
         1703  +<tr class="#doctools_tocodd"  >
  1692   1704   <td class="#doctools_tocleft" ><a name='valtype_luhn5'><a href="files/modules/valtype/luhn5.html">valtype::luhn5</a></td>
  1693   1705   <td class="#doctools_tocright">Validation for plain number with a LUHN5 checkdigit</td>
  1694   1706   </tr>
  1695         -<tr class="#doctools_tocodd"  >
         1707  +<tr class="#doctools_toceven" >
  1696   1708   <td class="#doctools_tocleft" ><a name='valtype_usnpi'><a href="files/modules/valtype/usnpi.html">valtype::usnpi</a></td>
  1697   1709   <td class="#doctools_tocright">Validation for USNPI</td>
  1698   1710   </tr>
  1699         -<tr class="#doctools_toceven" >
         1711  +<tr class="#doctools_tocodd"  >
  1700   1712   <td class="#doctools_tocleft" ><a name='valtype_verhoeff'><a href="files/modules/valtype/verhoeff.html">valtype::verhoeff</a></td>
  1701   1713   <td class="#doctools_tocright">Validation for plain number with a VERHOEFF checkdigit</td>
  1702   1714   </tr>
  1703         -<tr class="#doctools_tocodd"  >
         1715  +<tr class="#doctools_toceven" >
  1704   1716   <td class="#doctools_tocleft" ><a name='websocket'><a href="files/modules/websocket/websocket.html">websocket</a></td>
  1705   1717   <td class="#doctools_tocright">Tcl implementation of the websocket protocol</td>
  1706   1718   </tr>
  1707         -<tr class="#doctools_toceven" >
         1719  +<tr class="#doctools_tocodd"  >
  1708   1720   <td class="#doctools_tocleft" ><a name='wip'><a href="files/modules/wip/wip.html">wip</a></td>
  1709   1721   <td class="#doctools_tocright">Word Interpreter</td>
  1710   1722   </tr>
  1711         -<tr class="#doctools_tocodd"  >
         1723  +<tr class="#doctools_toceven" >
  1712   1724   <td class="#doctools_tocleft" ><a name='xsxp'><a href="files/modules/amazon-s3/xsxp.html">xsxp</a></td>
  1713   1725   <td class="#doctools_tocright">eXtremely Simple Xml Parser</td>
  1714   1726   </tr>
  1715         -<tr class="#doctools_toceven" >
         1727  +<tr class="#doctools_tocodd"  >
  1716   1728   <td class="#doctools_tocleft" ><a name='yaml'><a href="files/modules/yaml/yaml.html">yaml</a></td>
  1717   1729   <td class="#doctools_tocright">YAML Format Encoder/Decoder</td>
  1718   1730   </tr>
  1719         -<tr class="#doctools_tocodd"  >
         1731  +<tr class="#doctools_toceven" >
  1720   1732   <td class="#doctools_tocleft" ><a name='yencode'><a href="files/modules/base64/yencode.html">yencode</a></td>
  1721   1733   <td class="#doctools_tocright">Y-encode/decode binary data</td>
  1722   1734   </tr>
  1723         -<tr class="#doctools_toceven" >
         1735  +<tr class="#doctools_tocodd"  >
  1724   1736   <td class="#doctools_tocleft" ><a name='zipfile_decode'><a href="files/modules/zip/decode.html">zipfile::decode</a></td>
  1725   1737   <td class="#doctools_tocright">Access to zip archives</td>
  1726   1738   </tr>
  1727         -<tr class="#doctools_tocodd"  >
         1739  +<tr class="#doctools_toceven" >
  1728   1740   <td class="#doctools_tocleft" ><a name='zipfile_encode'><a href="files/modules/zip/encode.html">zipfile::encode</a></td>
  1729   1741   <td class="#doctools_tocright">Generation of zip archives</td>
  1730   1742   </tr>
  1731         -<tr class="#doctools_toceven" >
         1743  +<tr class="#doctools_tocodd"  >
  1732   1744   <td class="#doctools_tocleft" ><a name='zipfile_mkzip'><a href="files/modules/zip/mkzip.html">zipfile::mkzip</a></td>
  1733   1745   <td class="#doctools_tocright">Build a zip archive</td>
  1734   1746   </tr>
  1735   1747   </table>
  1736   1748   </dl><hr></body></html>

Changes to license.terms.

     1      1   This software is copyrighted by Ajuba Solutions and other parties.
     2         -The following terms apply to all files associated with the software unless
     3         -explicitly disclaimed in individual files.
            2  +The following terms apply to all files associated with the software
            3  +unless explicitly disclaimed in individual files.
     4      4   
     5      5   The authors hereby grant permission to use, copy, modify, distribute,
     6         -and license this software and its documentation for any purpose, provided
     7         -that existing copyright notices are retained in all copies and that this
     8         -notice is included verbatim in any distributions. No written agreement,
     9         -license, or royalty fee is required for any of the authorized uses.
    10         -Modifications to this software may be copyrighted by their authors
    11         -and need not follow the licensing terms described here, provided that
    12         -the new terms are clearly indicated on the first page of each file where
    13         -they apply.
            6  +and license this software and its documentation for any purpose,
            7  +provided that existing copyright notices are retained in all copies
            8  +and that this notice is included verbatim in any distributions. No
            9  +written agreement, license, or royalty fee is required for any of the
           10  +authorized uses.  Modifications to this software may be copyrighted by
           11  +their authors and need not follow the licensing terms described here,
           12  +provided that the new terms are clearly indicated on the first page of
           13  +each file where they apply.
    14     14   
    15     15   IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY
    16     16   FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
    17     17   ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY
    18     18   DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE
    19     19   POSSIBILITY OF SUCH DAMAGE.
    20     20   
    21     21   THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
    22         -INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY,
    23         -FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.  THIS SOFTWARE
    24         -IS PROVIDED ON AN "AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE
    25         -NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR
    26         -MODIFICATIONS.
           22  +INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
           23  +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND
           24  +NON-INFRINGEMENT.  THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, AND
           25  +THE AUTHORS AND DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE
           26  +MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
    27     27   
    28     28   GOVERNMENT USE: If you are acquiring this software on behalf of the
    29         -U.S. government, the Government shall have only "Restricted Rights"
    30         -in the software and related documentation as defined in the Federal 
           29  +U.S. government, the Government shall have only "Restricted Rights" in
           30  +the software and related documentation as defined in the Federal
    31     31   Acquisition Regulations (FARs) in Clause 52.227.19 (c) (2).  If you
    32     32   are acquiring the software on behalf of the Department of Defense, the
    33     33   software shall be classified as "Commercial Computer Software" and the
    34     34   Government shall have only "Restricted Rights" as defined in Clause
    35     35   252.227-7013 (c) (1) of DFARs.  Notwithstanding the foregoing, the
    36     36   authors grant the U.S. Government and others acting in its behalf
    37     37   permission to use and distribute the software in accordance with the
    38         -terms specified in this license. 
           38  +terms specified in this license.

Changes to support/devel/sak/localdoc/localdoc.tcl.

    40     40       set nav ../../../../home
    41     41   
    42     42       puts "Reindex the documentation..."
    43     43       sak::doc::imake __dummy__ $excluded
    44     44       sak::doc::index __dummy__ $excluded
    45     45   
    46     46       puts "Removing old documentation..."
    47         -    # but keep the main index around, manually created, edited, not to be touched
           47  +    # Keep the main index around however, manually created, edited,
           48  +    # not to be touched
    48     49       # TODO: catch errors and restore automatically
    49         -    file rename embedded/index.html e_index.html
           50  +    file rename embedded/index.md e_index.md
    50     51       
    51     52       file delete -force embedded
    52         -    file mkdir embedded/www
           53  +    file mkdir embedded/www embedded/dev
    53     54   
    54     55       # Put the saved main page back into place, early.
    55         -    file rename e_index.html embedded/index.html
           56  +    file rename e_index.md embedded/index.md
    56     57   
    57     58       run-idoc-man $baseconfig
    58     59   	
    59     60       # Note: Might be better to run them separately.
    60     61       # Note @: Or we shuffle the results a bit more in the post processing stage.
    61     62   
    62     63       set map  {