Convert between commit hashes and WebKit identifiers using git-webkit. Use whenever a commit hash appears in a tool result that will be shared with the user in the WebKit repository.
When working in the WebKit repository, ALWAYS reference commits by their WebKit "identifier" rather than by hash.
A commit identifier is a human-readable reference of the form:
<number>@main for commits on the main branch (e.g., 285301@main)<branch-point>.<number>@<branch> for commits on other branches (e.g., 278024.26@safari-7621-branch)These are more stable and readable than raw commit hashes.
Use git-webkit find to convert in either direction:
git-webkit find <hash>
git-webkit find <identifier>
For example:
git-webkit find c8a159ededf1
git-webkit find 285301@main
git-webkit provides wrappers that automatically display identifiers instead of hashes:
git-webkit log instead of git loggit-webkit blame instead of git blamegit-webkit show instead of git showThese commands accept the same arguments as their git counterparts but output identifiers directly, avoiding the need to manually convert hashes.
If git-webkit is not in PATH, use Tools/Scripts/git-webkit instead (relative to the repository root).
git-webkit log, git-webkit blame, and git-webkit show instead of git log, git blame, and git show.git bisect), convert it to an identifier using git-webkit find before presenting it to the user.git-webkit find to get the hash if needed for git operations.285301@main).git-webkit or Tools/Scripts/git-webkit with python3. The script is directly executable.