bug-standards
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Make explicit that 6.1 rules apply to any written text


From: Tim Rühsen
Subject: Make explicit that 6.1 rules apply to any written text
Date: Wed, 27 Nov 2019 16:58:31 +0100
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.2.2

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

Attachment: signature.asc
Description: OpenPGP digital signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]