summaryrefslogtreecommitdiff
path: root/docs/ACE-guidelines.html
diff options
context:
space:
mode:
Diffstat (limited to 'docs/ACE-guidelines.html')
-rw-r--r--docs/ACE-guidelines.html11
1 files changed, 3 insertions, 8 deletions
diff --git a/docs/ACE-guidelines.html b/docs/ACE-guidelines.html
index 62cf5cc69ba..0de2ca1a752 100644
--- a/docs/ACE-guidelines.html
+++ b/docs/ACE-guidelines.html
@@ -140,21 +140,16 @@ bgcolor="#ffffff">
#endif /* ACE_HAS_THREADS */
</pre><p>
- <li>Be sure to put spaces around comment delimiters, e.g.,
- <strong><code>char * /* foo */</code></strong> instead of
- <strong><code>char */*foo*/</code></strong>. MS VC++
- complains otherwise.<p>
-
<li>Always insert a <strong><code>/**/</code></strong> between an
<strong><code>#include</code></strong> and
<strong><code>filename</code></strong>, as shown in the above
example. This avoids dependency problems with Visual C++.<p>
- <li>Be very careful with names of macros, enum values, and variables
- It's always best to prefix them with something like <code>ACE_</code>
+ <li>Be very careful with names of macros and enum values. It's
+ always best to prefix them with something like <code>ACE_</code>
or <code>TAO_</code>. There are too many system headers out
there that #define <code>OK</code>, <code>SUCCESS</code>,
- <code>ERROR</code>, <code>index</code>, and so on.<p>
+ <code>ERROR</code>, and so on.<p>
<li>Try to centralize <code>#ifdefs</code> with <code>typedefs</code>
and <code>#defines</code>. For example, use this: