[J.Kelly@xxxxxxxxxx: Understanding VisAD]

----- Forwarded message from James Kelly <J.Kelly@xxxxxxxxxx> -----

Hello VisADevelopers,

I have some thoughts on how to better understand VisAD, and was interested
to hear other opinions.

Looking through the VisAD examples I find the examples easier to understand 
if I adopt a consistent convention for the variable names.

The aim here is to have variable names which suggest what the
underlying structure is, and which I can understand just
by looking at them. This relieves me of the burden of looking
back through the code continuously to see what a given variable
represents.

Combined with using Hungarian notatation (eg preceeding FunctionType 
variable names with ft), and listing all the variables in say 30 lines or so,
I can understand the flow of the program (after some study
and cross reference to the program of course).

--- clip ---

Hungarian notation is very undesirable

   2. Don't use Encodings:

     Encoded names require decyphering. This is true for hungarian
     and other 'type-encoded' or otherwise encoded variable names.
     Besides, encoded names are seldom pronouncable (#1).

     When you worked in name-length-challenged programs, you
     probably violated this rule with impunity and regret. Fortran
     forced it by basing type on the first letter, making the
     first letter a 'code' for the type. Hungarian has taken this
     to a whole new level.

     Of course, you can get used to anything, but why create an
     artificial learning curve for new hires? Avoid this if you
     can avoid it.