head	1.9;
access;
symbols
	tcllib-1-13:1.9
	tcllib-1-12:1.9
	tklib-0-5:1.9
	tcllib-1-11-1:1.9
	tcllib-1-11:1.9
	tcllib-1-10:1.9
	tcllib-1-9:1.8
	tcllib-1-8:1.8
	tcllib-1-7:1.8
	tcllib-1-6-1:1.8
	tcllib-1-6-branch:1.8.0.2
	tcllib-1-6:1.8
	tcllib-1-4-0:1.6
	tcllib-1-3-0:1.3
	tcllib-1-2-0:1.3.0.4
	RELEASES:1.3.0.2
	tcllib-1-1-0:1.3
	tcllib-1-0-0:1.3
	tclpro-1-5-0:1.2
	tcllib-0-8-0:1.2
	ajuba-ajuba3-3-0-beta-base:1.2
	tclpro-1-4-1:1.2
	tcllib-0-6-1:1.2
	tclpro-1-4-0:1.2
	ajuba-ajuba2-2-1-base:1.2
	tcllib-0-5:1.2
	ajuba-ajuba2-2-0:1.2
	tcllib-0-4:1.2
	scriptics-sc-2-0-b5:1.2
	scriptics-sc-2-0-fixed:1.2
	scriptics-sc-2-0-b2:1.2
	scriptics-sc-2-0-b1:1.2;
locks; strict;
comment	@# @;


1.9
date	2007.08.30.17.24.13;	author andreas_kupries;	state Exp;
branches;
next	1.8;

1.8
date	2004.01.15.06.36.11;	author andreas_kupries;	state Exp;
branches;
next	1.7;

1.7
date	2003.10.21.19.23.21;	author andreas_kupries;	state Exp;
branches;
next	1.6;

1.6
date	2003.04.17.22.54.04;	author andreas_kupries;	state Exp;
branches;
next	1.5;

1.5
date	2003.03.28.17.07.29;	author andreas_kupries;	state Exp;
branches;
next	1.4;

1.4
date	2003.03.24.23.11.54;	author andreas_kupries;	state Exp;
branches;
next	1.3;

1.3
date	2001.07.06.18.30.52;	author andreas_kupries;	state Exp;
branches;
next	1.2;

1.2
date	2000.03.06.19.28.04;	author ericm;	state Exp;
branches;
next	1.1;

1.1
date	2000.03.03.22.44.13;	author ericm;	state Exp;
branches;
next	;


desc
@@


1.9
log
@
	* README.developer: Fixed [SF Tcllib Bug 1784836], applied Larry
	* README: Virden patches fixing typos, and doing other editorial
	  changes.
@
text
@RCS: @@(#) $Id: README,v 1.8 2004/01/15 06:36:11 andreas_kupries Exp $

Welcome to the Tcllib, the Tcl Standard Library.  This package is
intended to be a collection of Tcl packages that provide utility
functions useful to a large collection of Tcl programmers.

The home web site for this code is http://tcllib.sourceforge.net/ .
At this web site, you will find mailing lists, web forums, databases
for bug reports and feature requests, the CVS repository (browsable on
the web, or read-only accessible via CVS ), and more.

The structure of the tcllib source hierarchy is:

tcllib
 +- modules
     +- <module1>
     +- <module2>
     +- ...


The install hierarchy is:

.../lib/tcllib
        +- <module1>
        +- <module2>
        +- ...

There are some base requirements that a module must meet before it
will be added to tcllib:

* the module must be a proper Tcl package
* the module must use a namespace for its commands and variables
* the name of the package must be the same as the name of the
  namespace
* the module must reside in a subdirectory of the modules directory in
  the source hierarchy, and that subdirectory must have the same name
  as the package and namespace
* the module must be released under the BSD License, the terms of
  which can be found in the toplevel tcllib source directory in the file
  license.terms
* the module should have both documentation ([*]) and a test suite
  (in the form of a group of *.test files in the module directory).

  [*] Possible forms: doctools, TMML/XML, nroff (man), or HTML.
      The first format is the most preferred as it can be processed with
      tools provided by tcllib itself (See module doctools). The first
      two are preferred in general as they are semantic markup and thus
      easier to convert into other formats.

* the module must have either documentation or a test suite.  It can
  not have neither.
* the module should adhere to Tcl coding standards

When adding a module to tcllib, be sure to add it to the files listed below.

* installed_modules.tcl

  contains a table listing all modules to be installed, modules
  excluded, and names the actions to be taken during installation
  of each module. Add a line to this table naming your module and
  its actions.

  Three actions have to be specified, for the package itself, its
  documentation, and the examples demonstrating it.

  The _null action can be used everywhere and signals that there is
  nothing to do. Although it is possible to use it for the package
  action it does make no sense there, as that means that no package
  code is installed.

  Other package actions are _tcl, _tci, and _text. The first causes
  the installer to copy all .tcl files from the source directory for
  the module into the appropriate module directory. _tci does all that
  and also expects a tclIndex file to copy. _tex is like _tcl, however
  it also copies all .tex files found in the source directory for the
  module.

  There is currently only one true documentation action. This action
  is _doc. It converts all documentation in doctools format into the
  format chosen by the user for installation and copies the result
  into the appropriate directory.

  There is currently one true action for examples, _exa. It copies all
  files in the source directory for examples into the directory chosen
  by the user as destination for examples.

Each module source directory should have no subdirectories (other than
the CVS directory), and should contain the following files:

* source code		*.tcl
* package index		pkgIndex.tcl
* tests			*.test
* documentation		*.man, *.n, *.xml

If you do not follow this directory structure, the tcllib Makefile
will fail to locate the files from the new module.
@


1.8
log
@
	* matrix.man:  Implemented Ed Suominen's sort methods, with
	* matrix.tcl:  modifications to speed things up, and to have
	* matrix.test: a more standard API (-options).

	* matrix.man: Documented method links.

	* matrix.test: Updated test to cover for method links.
	* matrix.tcl: Changed the code to determine the list of available
	  methods automatically for use in the error message when an
	  unknown method is called.

	* matrix.test:
	* matrix.tcl: Namespaces of objects now standalone, and not inside
	  of struct::matrix anymore. Arbitrary placement of objects is now
	  possible, including nested namespaces. Cleanup of all references
	  to instance variables.

	* matrix.tcl: Made the return of errors more regular.

	* matrix.tcl: Changed a number of eval calls to the more proper
	  'uplevel 1'. This means that an implementation of a method can
	  now assume that it is called on the same stack level as the
	  method itself.

	* matrix.tcl: Typo in comments fixed.
	* matrix.tcl (__set_rect): Fixed typos in var names causing the
	  system to retain bogus cache data.
@
text
@d1 1
a1 1
RCS: @@(#) $Id: s.README 1.7 03/10/21 19:23:21-00:00 andreas_kupries $
d3 1
a3 1
Welcome to the tcllib, the Tcl Standard Library.  This package is
d45 1
a45 1
      The first format is the most prefered as it can be processed with
d47 1
a47 1
      two are prefered in general as they are semantic markup and thus
@


1.7
log
@
	* README: Updated to describe the new way of adding modules to
	  tcllib.

	* INSTALL.txt: Updated references to tcllib 1.4 to 1.5.

	* installed_modules.tcl: Changed doc action for snit from _null to
	  _man (We have doctools manpages for snit for a while now).
@
text
@d1 1
a1 1
RCS: @@(#) $Id: README,v 1.6 2003/04/17 22:54:04 andreas_kupries Exp $
@


1.6
log
@
	* installer.tcl: Added GUI.

	* main.tcl: New file, entrypoint for *kit, *pack, redirects to
	  'installer.tcl'.

	* sak.tcl: Helper tool for tcllib development (Generate
	  distribution, various forms of documentation, check the bundle
	  of packages for problems.
@
text
@d1 1
a1 1
RCS: @@(#) $Id: README,v 1.5 2003/03/28 17:07:29 andreas_kupries Exp $
d54 1
a54 2
When adding a module to tcllib, be sure to add it to the Makefile.in
so it will be installed.  Add a line like:
d56 1
a56 1
MYNEWMODULE=mynewmodule
d58 28
a85 4
to the list of modules at the top of the Makefile.in, and then add
$(MYNEWMODULE) to the definition of the MODULES variable.  This will
allow users to choose which modules to install by commenting or
uncommenting lines in the Makefile.
a96 2


@


1.5
log
@
	* README: Updated information about acceptable documentation
	  formats, i.e. added doctools, made it mst prefered format. This
	  fixes the [Bug #685270], reported by Larry Virden
	  <lvirden@@users.sourceforge.net>.
@
text
@d1 1
a1 1
RCS: @@(#) $Id: README,v 1.4 2003/03/24 23:11:54 andreas_kupries Exp $
d70 1
a70 1
* documentation		*.n, *.xml
d74 1
@


1.4
log
@
	* README: Updated to refer to the SF website for Tcllib. Thanks to
	  Larry Virden <lvirden@@users.sourceforge.net> for the report and
	  fix. [Bug #707607].

	* fileutil.test:
	* fileutil.man:
	* fileutil.tcl: Fixed bug #707009, reported by Helmut Giese
	  <hgiese@@users.sourceforge.net>, also updated the documentation
	  and the testsuite.
@
text
@d1 1
a1 1
RCS: @@(#) $Id: README,v 1.3 2001/07/06 18:30:52 andreas_kupries Exp $
d41 9
a49 3
* the module should have both documentation (in XML, man, or HTML
  form) and a test suite (in the form of a group of *.test files in
  the module directory).
@


1.3
log
@2001-07-06  Andreas Kupries <andreas_kupries@@users.sourceforge.net>

	* Fixed #438748, corrections of various misspellings in manpages
	  accross all modules.
@
text
@d1 1
a1 1
RCS: @@(#) $Id: README,v 1.2 2000/03/06 19:28:04 ericm Exp $
d6 5
@


1.2
log
@* license.terms: Adapted license from Tcl.

* README: Added more information about file layout in module dirs.
@
text
@d1 1
a1 1
RCS: @@(#) $Id$
d7 1
a7 1
The structure of the tcllib source heirarchy is:
d16 1
a16 1
The install heirarchy is:
d31 1
a31 1
  the source heirarchy, and that subdirectory must have the same name
@


1.1
log
@README describing structure of tcllib and requirements for modules added to it.
@
text
@d1 2
d34 2
a35 1
  which can be found in the toplevel tcllib source directory
d52 11
@

