[jira] [Created] (COR-41) Use of /* ... */ preferable to //... in STDC Code

["Dennis E. Hamilton (JIRA)" <ji...@apache.org>]

Dennis E. Hamilton created COR-41:
-------------------------------------

             Summary: Use of /* ... */ preferable to //... in STDC Code
                 Key: COR-41
                 URL: https://issues.apache.org/jira/browse/COR-41
             Project: Corinthia
          Issue Type: Bug
    Affects Versions: 0.5
         Environment: All .c and .h files in the repository
            Reporter: Dennis E. Hamilton
            Priority: Trivial


The ASF Notices on .c and .h files use // ... single-line comment triggers instead of something like 

   /* ...
   *
   ...
   */

the only form that some compilers recognize as STDC comments.  The use of -WAll and STDC compile options will produce warnings in some products, such as most versions of Visual Studio, clogging the error log with warning messages.

PROPOSAL:

 1. Agree that it is OK to change these to /* ... */ when the particular files are touched for some purpose, such as clearing warnings out of a strict STDC compile.  Enough compilers warn about this, apparently for down-level STDC compatibility.  

(In the VC++ standard libraries, there is a file deep in the Windows SDK headers that has a single //... that annoys me enough to actually fix it in the library.  I'd like to fix this with some sort of platform quirk patch but I haven't dug enough into the include-path rules to get that working.  Someday soon ... .) 

 2. Fix these on an opportunistic basis.  

 3. Pray that rat, the IP checker, recognizes these notices either way.

 2. There will be 



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)