Document opaque / transparent

[joelburget]

The keywords opaque, transparent, and transparent_all aren't documented anywhere.

[mortberg]

Indeed. We should document them and say that they are experimental.