Skip to content

Commit 0e42f0a

Browse files
committed
Say what the third number is for
It is not a build counter but the number of fixes that leave the output alone: a crash, a regression, an internal bug, a dependency update. The line between it and the second number is the output, not the kind of change: a fix that changes the output raises the second, a fix that does not raises the third.
1 parent 8eb2dc0 commit 0e42f0a

1 file changed

Lines changed: 7 additions & 4 deletions

File tree

‎README.md‎

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -116,10 +116,13 @@ A version is three numbers, `<java>.<minor>.<build>`, and each one answers a que
116116

117117
- **The first is the Java version the formatter is built for**, 21 today. It moves when the minimum
118118
Java version moves.
119-
- **The second counts changes to the output**: a fix in wrapping or alignment, a new rule, a new
120-
feature. A newer minor version can reformat code that the previous one left alone.
121-
- **The third counts builds that leave the output alone**: regressions, internal bugs, dependency
122-
and build updates. A newer build formats every file exactly as the previous one did.
119+
- **The second moves with every change to the output**: a fix in wrapping or alignment, a new rule,
120+
a new feature. A newer minor version can reformat code that the previous one left alone.
121+
- **The third moves with fixes that leave the output alone**: a crash, a regression, an internal
122+
bug, a dependency update. A newer build formats every file exactly as the previous one did.
123+
124+
The line between the last two numbers is the output, not the kind of change: a fix that changes
125+
the output raises the second number, a fix that does not raises the third.
123126

124127
Up to 2.98.0.6 the version was palantir-java-format's with a build number appended. Once the bug
125128
fixes made the output differ from upstream, that numbering lost its meaning.

0 commit comments

Comments
 (0)