Specify in the doc comments that ProgramElementDoc modifiers()
normalizes the order of modifiers, and that MethodDoc flatSignature()
normalizes the spacing of the parameters. This is useful information when
writing doclets, and changing the order seems to be an exception.

Also specify the purpose of modifierSpecifier(). Note that the standard
doclet uses it to get the modifiers in modifierString (which is called
from printModifiers()):

    protected String modifierString(MemberDoc member) {
        int ms = member.modifierSpecifier();
        int no = Modifier.NATIVE | Modifier.SYNCHRONIZED;
    return Modifier.toString(ms & ~no);
    }