head	1.1;
access;
symbols
	tcllib-1-13:1.1
	tcllib-1-12:1.1
	tklib-0-5:1.1
	tcllib-1-11-1:1.1
	tcllib-1-11:1.1
	tcllib-1-10:1.1
	tcllib-1-9:1.1
	tcllib-1-8:1.1
	tcllib-1-7:1.1
	tcllib-1-6-1:1.1
	tcllib-1-6-branch:1.1.0.6
	tcllib-1-6:1.1
	tcllib-1-4-0:1.1
	tcllib-1-3-0:1.1
	tcllib-1-2-0:1.1.0.4
	RELEASES:1.1.0.2
	tcllib-1-1-0:1.1
	tcllib-1-0-0:1.1;
locks; strict;
comment	@# @;


1.1
date	2001.05.01.19.01.23;	author andreas_kupries;	state Exp;
branches;
next	;


desc
@@


1.1
log
@2001-05-01  Andreas Kupries <andreas_kupries@@users.sourceforge.net>

	* Makefile.in (MODULES):  Added module 'report'.

	* all.tcl: Added code to propagate "::tcltest::testDirectory" into
	  the slave actually doing the tests. This tripped some of the
	  tests for the new CSV module as they use some external files and
	  were thus unable to find them correctly without this setting.

	* Makefile.in (MODULES): Added module 'csv'.

	* Added directory 'examples' for future sample applications of
	  tcllib and some example applications too.

	* Added "matrix" data structure to module "struct".
@
text
@Example application using tcllib modules.
=========================================

This application (oscon) extracts session, track and talk information
from the O'Reilly OSCON webpages, collates them and writes some global
reports. It uses the tcllib modules "htmlparse", "struct" ("matrix",
"tree"), "csv", "report" and "log".

It is called as

	oscon <prefix> <htmlfile>...

reads the provided HTML files containing the webpages to process and
then produces the six files

	<prefix>.main.csv	All talks with time, location, track
				information, as CSV file.
	<prefix>.main.txt	As above, ASCII report
	<prefix>.main.html	As above, as HTML table

	<prefix>.sched.csv	Track information, sorted by day and
				start time, as CSV file
	<prefix>.sched.txt	As above, ASCII report
	<prefix>.sched.html	As above, as HTML table

Adding other reports (like room usage, east/west usage, ...) should be
rather easy.

If "a2ps" is available the script will additionally generate .ps files
out of the .txt files.

----------------------------------------------------------------

*Note*: The webpages used to develop this application are provided
here too to allow a successful operation of the example even if the
actual webpages at O'Reilly changed their format or are not available
anymore.
@
