Updated instrument API entries.

MILESTONE: all public properties of all instruments are now documented and
fully illustrated (following the illustration protocol).

Dunder methods are given text descriptions only and will remain that way for
the 2.14 build.