Table of Contents
The Skara CLI tools are fully backwards compatible with the traditional OpenJDK tools for Mercurial (defpath, jcheck and webrev). That means that if you have the Skara CLI tools installed, then you can also use them for interacting with OpenJDK Mercurial repositories.
Mercurial for macOS is distributed via Homebrew. Start by installing Homebrew, then install Mercurial:
Install Mercurial from https://www.mercurial-scm.org/downloads. You can use either the Inno Setup installer or the MSI installer.
Skara CLI Tools
To install the Skara CLI tools for Mercurial, simply clone the Skara repository and enable the Skara Mercurial extension:
The Skara tooling will build itself the first time you use any of the Skara commands. To check that everything works run
hg skara help.
To update the Skara CLI tools, just run:
Note: as can be seen above,
webrev is now a Mercurial extension, it is no longer invoked as
Importing patches from a Git repository
Mercurial has built-in support for the Git patch format (more recent Mercurial versions have improved support). This means that you can import a patch directly from a Git repository:
The OpenJDK Mercurial and Git repositories use different formats for commit message (see JEP 357 for details). To import a patch from an OpenJDK Git repository to an OpenJDK Mercurial repository and translate the commit message from the format used by OpenJDK Git repositories to the one used by OpenJDK Mercurial repositories, use the git-hg-export tool from the Skara CLI tools: