Update shapes.h

Extended documentation.