A DESCRIPTION OF THE PROBLEM :
The javadoc states:

NOTE: Currently (in the Java 2 platform v1.2), BorderLayout does not support vertical orientations. The isVertical setting on the container's ComponentOrientation is not respected.

Can you please add label "josm-found" to this bug report?

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
Simply drop the version, as it proves to be unmaintainable:

NOTE: Currently, BorderLayout does not support vertical orientations. The isVertical setting on the container's ComponentOrientation is not respected.
ACTUAL -
It says the current version is 1.2:

NOTE: Currently (in the Java 2 platform v1.2), BorderLayout does not support vertical orientations. The isVertical setting on the container's ComponentOrientation is not respected.

URL OF FAULTY DOCUMENTATION :
https://docs.oracle.com/javase/8/docs/api/java/awt/BorderLayout.html