Copyright (c) 2001+ by Roberto Artigas Jr.
All rights reserved world wide.

Waranty: NONE. Use at your own risk. Not suitable for anything.
I am not responsible for your choices, actions, or consequences.

ClassLib
Comparison of Suneido class tree implementation
to other vendors class tree implementations.

I wanted to do a comparison of the class tree implementation of
suneido to other class tree implementations or class collections.

This gives me at least an idea of how well evolved or how much
thought a class tree has had when it was implemented. While this
is a highly subjective method, it has served me well in the past.

I am sure that there are more rigorous metrics and methods, but
since this is a rather new language, it is evolving in a month by
month basis, and this is for evaluation purposes, for now, just
looking around and comparing to other vendors is enough for me.
If you want more rigorous methods, feel free to create them
and donate them to the suneido community at large.

You got to have something to compare to, so I entered several
class trees and collections by hand from vendor documentation.

If you have any experience at all with any documentation you
know that most of the time it is a bit behind the reality of a
product and it is never completely accurate. So the accuracy of
what I typed is to be questioned. And to be prefectly honest I
ran into some discrepancies while typing in the documentation.

A better way to have documentation generated, is to have some
mechanized method of doing it. This brings me to the way that
I generated the Suneido class tree.

I used 'Csct00' to do the generation of the Suneido class tree.
This program examines the 'stdlib' to produce the class tree as
a library named 'SuneidoClassLib'.

After it is created, you can "Use SuneidoClassLib", and you can
examine the suneido class tree at your leasure and do the
comparison to other vendors class trees.

'Csct00' uses a brute force algorithm. It is not very pretty or
very efficient. It just works. Obviously it can be improved.

'Csct01' is much more elegant and faster. It also detects the
hidden classes that are defined in suneido that have children
defined in 'stdlib'.

'Csdt02' creates a DLL tree giving the DLL name, the DLL
function name, and the name used in the stdlib library.

'Csft03' creates a stdlib function tree. The functions are
created like a dictionary. The dicitionary index is the letters
of the american english alphabet.

Hope this is helpfull to the community at large.

Enjoy!
Roberto Artigas Jr
rartiga1@midsouth.rr.com


Installing and running the Suneido class tree generator
-------------------------------------------------------

1. Once the files have been unzipped, execute the following
from the command line in the directory where suneido.db resides:

	suneido -load ClassLib

Note: ClassLib.su should be in the current directory.

2. From the File menu in LibView, choose 'Use Library'.  Enter
'ClassLib' and choose Ok.

3. From the WorkSpace, run:

	Csct01()

If you wish to view the Suneido stdlib class tree without running
the utility, a file called SuneidoClassLib.su is included.  Load
this into the database the same as ClassLib is loaded in step 1.

4. To view the new class tree, choose 'Use Library' from the LibView
file menu.  Type in 'SuneidoClassLib' and choose Ok.  Now you should be
able to browse the tree structure for SuneidoClassLib, which represents 
the stdlib class hierarchy for Suneido.

5. In addition, Suneido and wxWindows class trees can be generated using
the *.cls files included in the classlib.zip file.
From the Workspace, run:

	Csct01Cls()

You will be provided with a dialog to choose a .cls file.  Browse to the 
location where the files were extracted to and choose "Open".  This will
create the class tree as a library named 'SuneidoClassLib'.  See step four 
for instructions on viewing the new library.

6. To create a tree containing dlls currently being used by Suneido, run:

	Csdt02()

See step four for instructions on viewing the new library.

7. To create a tree containing Suneido functions listed under each letter 
alphabetically as folders, run:

	Csft03()

See step four for instructions on viewing the new library.

IMPORTANT: IF YOU DOWNLOADED SUNEIDO PRIOR TO APR 22, 2002, YOU WILL 
NEED TO DOWNLOAD THE LATEST VERSION IN ORDER FOR THIS TO RUN 
PROPERLY