Hi, in 6.1 of the GNU standards are lot's of points that should not only apply to manuals, but maybe even to all kinds of other texts written within a GNU project. This might often be obvious, but not always.
For example: Recently, I saw commit messages and ChangeLogs being corrected to use 'funcname' instead 'funcname()'. When jumping straight to 6.8 (Change Logs), there are lot's of advice and examples but nothing mentions that rules from 6.1 apply here as well. Not all those rules apply, but it would make sense for several of them. So after reading 6.8ff I still had to explicitly ask around, where the 'non-bracket' rules is written. Thankfully I got an answer :-) Some confusion could be avoid to explicitly point from 6.8 to 6.1. Also it could be stated in 6.1 which of those rules apply to code comments, commit messages, man pages and other freely written text within GNU projects. With Best Regards, Tim
signature.asc
Description: OpenPGP digital signature
