gEDA-user: Attributes - docs with more complete/recent info?

[Frank Miles]

I'm trying to understand symbol attributes.  The most current version of the "master
attribute document" that I've found (2004) seems to be missing some things - such
definitions for "pins" (seems to be the pin count) and "class" (what are the allowed
values?).  Is a more up-to-date doc available somewhere?

I haven't found any docs which describe the field elements in the x-y positioning
lines which apparently have to precede each attribute, nor the other
non-attribute elements.  Would appreciate any pointers.

Any pointers on getting gsymcheck to emit messages more revealing than
         "Found a pin which did not have the whichone field set."
would be appreciated.

Purpose - updating sarlacc_sym so that it emits more usable symbols.  Of course,
if someone else knows of a more current/functional script, I'd be delighted to
learn of it.  (Oh yes...running Debian/etch geda packages...)

         TIA!
         -f