docs from another pass thru the 2.6.5 value files

This one is pretty important so I wanted to make another pass through and capture any docs that I could glean from the original `value.cpp` and `value.h` files (and reorder things similarly to how they have them to make bug fixing easier).