DOC: Unclear spec for BevelBorder constructor and BorderFactory factory method (colors switching)

Constructor for BevelBorder class contains the following note

    /**
     * ...
     * Note: The shadow inner and outer colors are switched for a lowered bevel border.
     *
     **/
    public BevelBorder(int bevelType, Color highlightOuterColor,
                       Color highlightInnerColor, Color shadowOuterColor,
                       Color shadowInnerColor) {

1. It's unclear when exactly the colors are switched - when the instance is created or when the border is painted.
2. SoftBevelBorder constructor which calls super constructor shown above doesn't say anything about this switching, however it is supposed to happen
3. Method BorderFactory.createSoftBevelBorder(int type, Color highlightOuter, Color highlightInner, Color shadowOuter, Color shadowInner) contains the same note which is even less clear assuming that factory doesn't do any color switching.