Matthieu Moy <Matthieu.Moy@xxxxxxx> writes: > I have no ideal solution for that. git(7) is already really long. > Perhaps some "topic man pages" would be good. By "topic man page", I > mean "man git-something" where "something" isn't a git command, but a > crosscutting concept. For example, here, "man git-refspec" to document > reference specifiers like HEAD@{42}, master~55, d71c6c8e24a and > friends. "man git-i18n" would be another candidate. Yeah, gitattributes(5), gitignore(5) and gitmodules(5) can take advantage of the fact that they define file formats and describe the underlying concepts in their own corner while describing the file format. But there are many other things (e.g. syntax for refspec, ref naming) that would benefit from having their own topic-centric documents, without defining their own file format, so git-refspec(5) trick is not an option for them. - To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html