Document functionality added in bug 1042850

Fair warning I've not written any documentation before so don't really know the syntax.
Was style not leading anywhere?