improving documentation

clarifying the problem of variations in the return value, also changing
one small error where I said classed() when I meant style()