aareadme in bde2ht3


UPdate 97/6/3: 
---------------------
Currently, file *HG000001.gif  is missing from nodeSamples. 
I tried to recreate it (from PHsiah - 
it has lots of comments about node shape meanings).

I updated nodeSamples.dat with HAfix.awk and remade *HG000001.ps
with fjara's executable.

WARNING: bde2ht3/*/ps2gif.vax failed; a later version is needed.
----
I removed twin  dir'y SchoolDBTest.bak
which had path differences from SchoolDBTest (URLs to 
~lechner/public_html not in the SchoolDBTest subdir'y. - RJL
--------------------

This directory contains three examples of BDB browser. 
Their entry pointshave the standard names *menu.html:

DFDExamples_menu.html  Schools_menu.html      course_menu.html
(The corresponding .gif files are missing the underscore).

Their corresponding subdirectories (names should match precisely but don't) 
are:

nodeSamples		SchoolDBTest		bdeschematest

These have .html, .map and .gif files. .html and .map files have '_' chars
in their names, but the corresponding .gif files are missing the underscore.
The first *HG000001.gif file is missing from nodeSamples.

To run any of these examples, click on the *_menu.html item  below,
or use it as as the direct URL.


	DFDExample_menu.html     (points to ./nodeSamples)                  

	Schools_menu.html

	course_menu.html	

Notes: 

All information files for BDB are derived from a project.dat file
which is ASCII-readable.

DFDExamples_menu.html diagram HG000002 node SYSTEM:

DFDExample_menu.html leads to an (unreadable) diagram HG000001,
a system context diagram HG000002 and a sub-dataflow diagram HG000003.
DIagram HG000002 is also linked directoy to the third diagram HG000003 
(its expansion). Most nodes are leaf nodes, which have the default 
behavior that if  its node or caption is clicked anywhere, 
the hyperlink to a text annotation is followed. That file has the 
same name as its parent, plus the key HN00000n or CG00000n  of the node 
or caption that annotates it.

The SYSTEM node's upper half contains a non-default link to another diagram 
(its expansion child, not its container parent). 
If a click is detected on the upper half of node SYSTEM (HN000020) 
another .gif file (nodeSamples_HG000002_HN000020.html) is inspected and 
the expansion diagram (HG000003) for node SYSTEM is displayed. 
This can be supported in any NODE.


Schools_menu.html diagram HG000001  all nodes:

There is an expansion chlid or parent container diagram for each node
whose title includes *LINK*.
(This represents an attribute list or table declaration for this node).
All nodes also have a link to a text block (e.g., representing attribute
definition meta-info if this table represents an ERD entry, or pseudo-code
acction declarations if the node is on a state madhine).


course_menu.html diagram HG000001:

This is a larger school data model, with a single diagram, 
each node of which is linked to a text block that contains one word 
per attribute of that record type. (A full descriptionline should be
in this position.)