clang-format documentation has "git" in every title

[mydeveloperday]

Not sure why it says '15.0.0git'

[llvmbot]

@llvm/issue-subscribers-bug

[llvmbot]

@llvm/issue-subscribers-clang-format

[mydeveloperday]

related ? e80c529

[mkurdej]

It's not clang-format specific. IMO it marks that it's not a release documentation.

[tstellar]

This is just the version string that the project uses for the main branch. clang --version will report the same thing.

[mydeveloperday]

You are right I didn't see it before... it looks very odd! would it be better to say

15.0.0 (prerelease) or 15.0.0 (trunk)

or something other than git what has git got to do with it?

This just looks bizarre to me.

I seriously assumed someone had messed up the conf.py file.

[mydeveloperday]

@tstellar don't get me wrong I like the idea of the documentation having the correct version and no one having to go around and change it every release (that bit is great).

I'm not seeing the "git" that for 'clang-format --version' and if we did I think we might even break some people scripts that check the version because I doubt they'd be expecting to see 0.0git at the end

$ clang-format --version
clang-format version 15.0.0 (https://github.com/llvm/llvm-project.git c88deef
218dd5c30500e7d3f58fc23283d3e5)

Is anyone wedded to this idea of having the word "git" or could we transform it into

" (underdevelopment)", 
" (in-progress)", 
" (trunk)", 
" (main branch)"

at least in the documentation

[tstellar]

I have no preference what the version string is, but if we want to change it I think it would require a community wide RFC.

[mydeveloperday]

was there an RFC for the addition of the "git" I could tack onto the back of?

[tstellar]

was there an RFC for the addition of the "git" I could tack onto the back of?

I don't think so. I suspect that most people don't care about the git suffix, but any time you change the version string, you risk breaking people's scripts, CI, etc. so that's why I think it needs some kind of higher-visibility than just a patch.

[mydeveloperday]

I wasn’t thinking about changing the versioning just have |releasenogit| in the rst