#3 Standard bridges need more documentation

[Kenneth C. Schalk]

The standard bridges (including the functions they
provide and their arguments, and how they can be used)
are largely undocumented. In fact, the bridges
themselves are about the only documentation we have.
It would be good to have better documentation of them.

The vmodels(5) man page claims to be a "tutorial for
writing Vesta-2 user models to conform to the existing
bridge and standard environment models", but that's
rather a misnomer. It describes how to use some of the
standard bridge functions in technical detail, not in a
tutorial style, and is quite difficult reading even
when used as a reference by someone who is familiar
with Vesta models. (It's also rather out of date: it
doesn't reflect the current naming structure for
libraries, and most of the examples haven't been
changed in years.)

The "Vesta SDL Programmer's Reference"
(http://www.vestasys.org/doc/sdl-ref/) is some help,
but is more of a tutorial on the language itself than
the bridges. (Reading it might be a pre-requisite to
decoding the existing bridges.)