Updated documentation.

Includes workaround for <https://bugzilla.gnome.org/show_bug.cgi?id=739863>.