Re: Fwd: [PATCH] Man page section reference should be in uppercase

Nazri Ramliy <ayiehere@gmail.com> writes:

"TEMPLATE DIRECTORY" and "SPECIFYING REVISIONS" are shown quite often, but there are some others that deviate from your "all caps" norm. For example, 'see the "Configuration Mechanism" section' appears in git.txt and it matches how the section header that is referred to is spelled.

Also the section headers referred to in caps in the current documentation set are indeed spelled in caps (grep for "TEMPLATE DIRECTORY" in Documentation/git-init.txt for example).

Having said that, I wouldn't mind if the theme of your improvement were to spell manual section *headers* in caps, instead of leaving the actual section names still spelled as "Note about fast-forwards" and upcasing only the reference(s) to it, which can make things inconsistent depending on how the documentation is typeset (e.g. I read the documentation source as text files). Obviously the resulting patchset may also have to upcase e.g. "combined diff format" section header to bring consistency into the whole documentation set, not just the "Note about fast-forwards" section.