NameConventions allows you to specify almost any kind of required or prohibited condition in an identifier name. For example, you can create a rule that requires all class names to be capitalized, or that flags the use of certain prohibited characters.

Rule Format


Each line contains the following space-delimited fields:

Title not available (Rule Format )

Rule ID
Name of the rule. The same Rule ID cannot appear on multiple lines.

Help Volume
Name of the help volume that contains online help for the rule. Within that help volume, the rule ID is used as the help node name. To specify a different node (for example, to have several rules share the same help node), use the format helpvolume_nodename.

Kinds to Check
The "kind" of object that the rule applies to. (See “Object Kind ” for a list of all "kinds" understood by SoftBench CodeAdvisor.) Within the NameConventions rule file, the "kind" must be one or more of: CLASS, CLASSTEMPLATE, DATAMEMBER, ENUM, ENUMMEMBER, FUNCTION, FUNCTIONMEMBER, FUNCTIONTEMPLATE, IDENTIFIER, LABEL, MACRO, PARAMETER, SCALAR, SOURCEFILE, STRUCT, TAG, TEMPLATEARGUMENT, TYPEDEF, UNION, VARIABLE.

Multiple "kinds" are separated by a vertical bar (|).

Regular Expressions
An Extended Regular Expressions, as documented in regexp(5). ERE's can contain multiple Regular Expressions separated by a vertical bar (|).

Match
Specifies whether the rule fires on identifiers that match or do not match the Regular Expression. MATCH indicates that the rule signals a violation on identifiers that match the Regular Expression; NOMATCH indicates that the rule signals a violation on identifiers that do not match the Regular Expression.

Required Attributes
Specifies all attributes that must be set on the identifier. (See “Language Types ” for a list of all attributes understood by SoftBench CodeAdvisor.) This field can contain the keyword "ANY", meaning that there are no required attributes, or one or more of the following attributes separated by ampersands (&): ABSTRACT, ANONMEM, COMPILE_ERRORS, CONST, DECLARED_STRUCT, DECLARED_UNION, GLOBAL, INLINED, INSTANTIATED, MERGE_MEMBERS, PRIVATE, PROTECTED, PROTECTED, PUBLIC, PURE, SPECIALIZATION, STATIC, SYNTHETIC, VOLATILE.

Prohibited Attributes
Specifies all attributes that must not be set on the identifier. This field can contain the keyword "ANY", meaning that there are no prohibited attributes, or one or more of the attributes specified above separated by vertical bars.

Error Message
A message describing the condition that has been violated. The printf(3) format specifier %s should be included in the message. It will be replaced by the erroneous identifier name.

For example, the following line can be found in the NameConventions rule file:


NoUnderscoreOnExtern CommonCxx VARIABLE|FUNCTION ^_
http://docs.hp.com/en/B6454-90005/ch02s02.html

--------------------------------------------------
Note added at 4 hrs (2009-05-17 19:08:44 GMT)
--------------------------------------------------

:))

--------------------------------------------------
Note added at 2 days4 hrs (2009-05-19 19:01:07 GMT) Post-grading
--------------------------------------------------

Thanks to Ledja and to jccantrell for your consideration: Saludos !! :))