documenting the constants header
some touch-ups for the private method documentation.