All the SBProfile objects still are definitely surface brightness profiles.  `XValue(x,y)` still returns the surface brightness in flux / unit^2.  And when we are building up a galaxy, we are still working in the reference frame where the "unit" is arcsec.  i.e. We normally work in world coordinates when building objects.

The only change is that SBProfiles only know how to draw themselves in their native units.  If you want to draw an SBProfile onto an image with a different pixel scale than whatever "unit" is, you need to convert to image coordinates before calling the C++ draw function.

Of course, all of this is handled automatically by the python draw function, so I don't think any python layer documentation has been made incorrect by these changes.  But you are probably right that some of the C++ layer documentation may need be wrong now.  I'll take a look.