Organization of the Patch Repository
The OpenJDK mlvm/mlvm repository forest is (at present) only a set of patches, not a full set of JDK sources. The patches apply to some version of the full jdk7/jdk7 forest. The structure of the mlvm forest parallels the structure of the full jdk7 sources, but each repository in mvlm is only the .hg/patches
directory (of the Mercurial mq extension). Thus, repositories under mlvm are called "patch repositories" and those under jdk7 are by contrast called "source repositories".
Commits in the mlvm repositories do not update the full source trees, only the patches. To make this clear, when a commit occurs in a patch repository, we will refer to it specifically as a "patch commit".
TO DO: link the text in this page to suitable instructions for configuring and using Mercurial.
Patches
All patch files must end with the suffix .patch
.
...
#-buildable
: the patch does not build, or iterferes interferes with the operation of the JVM#-testable
: the patch fails to have a working test suite
...