I would respectfully disagree. BlackBox documentation
is "pretty good" as a reference, but not excellent. There
are too many things that I've had to "figure out" on my
own or ask the mailing list because they weren't anywhere
to be found in the documentation. Things like "if you
want to retrieve the path from a locator you need to change
your Files.Locator to a HostFiles.Locator using a type
guard." Or "if you want to edit the comment section on
a StdStamp you need to hold down the Ctrl key and click
on it."
> I wrote the
> "BlackBox Tutorial" because my students need a book
> from which to learn. This distinction between documentation
> for reference and a book for learning is why I stated
> in an earlier post that we need a new book on component
> programming with BlackBox. We should not expect the
> documentation to fill that role.
>
> Stan
> =============================
> J. Stanley Warford
> Professor of Computer Science
> Pepperdine University
> Malibu, CA 90263
> warford@pepperdine.edu
> =============================
I agree that a book is needed and that the online documentation
will never fully fill the role of a book. But then I wouldn't
expect a book aimed at students learning the language to fully
fill the holes that currently exist in the "reference" part of the
current BlackBox documentation. I think a "user maintainted HOWTO"
reference site for BlackBox is needed.