Document how the details about dashes + dash scaling + linewidth is now implemented.

There is now private 'unscaled' dash patterns (prefixed with_us in a few classes.

Also consider renaming the private variables.

Assigned to my self (as I wrote the offending code), but if someone else wants to do this I would be happy.