Colors: document use of OPAMCOLOR

This patch also updates all the (generated) documentation.

 Issue #864