Update C++ style guide to 3.180:

- Remove comment about naming macros like enums.
 - Move a bad code snippet from a CODE_SNIPPET to a BAD_CODE_SNIPPET element.

Update Python style guide to 2.18:
 - Clarify the syntax for import statements.

Update styleguide.xsl to 1.31:
 - Substitute underscore for apostrophe in anchor names.

cppguide.xml

@@ -4,7 +4,7 @@
 
 <p align="right">
 
-Revision 3.178
+Revision 3.180
 </p>
 
 
@@ -739,9 +739,11 @@ Tashana Landray
         particular, initialization should be used instead of
         declaration and assignment, e.g.
       </p>
-      <CODE_SNIPPET>
+      <BAD_CODE_SNIPPET>
         int i;
         i = f();      // Bad -- initialization separate from declaration.
+      </BAD_CODE_SNIPPET>
+      <CODE_SNIPPET>
         int j = g();  // Good -- declaration has initialization.
       </CODE_SNIPPET>
       <p>
@@ -3018,7 +3020,7 @@ Tashana Landray
         Please see the <a href="#Preprocessor_Macros">description of
         macros</a>; in general macros should <em>not</em> be used.
         However, if they are absolutely needed, then they should be
-        named like enum value names with all capitals and underscores.
+        named with all capitals and underscores.
       </p>
       <CODE_SNIPPET>
         #define ROUND(x) ...
@@ -4527,7 +4529,7 @@ Tashana Landray
 <HR/>
 
 <p align="right">
-Revision 3.178
+Revision 3.180
 </p>
 
 

pyguide.html

@@ -100,7 +100,7 @@
 <H1>Google Python Style Guide</H1>
   <p align="right">
 
-    Revision 2.15
+    Revision 2.18
   </p>
   
   <address>
@@ -262,35 +262,38 @@
         </P>
         <P class="">
 <SPAN class="stylepoint_section">Pros:  </SPAN>
-          Simplest and most commonly used way of sharing things.
+          The namespace management convention is simple.  The source of each
+          identifier is indicated in a consistent way; <code>x.Obj</code> says
+          that object <code>Obj</code> is defined in module <code>x</code>.
         </P>
         <P class="">
-<SPAN class="stylepoint_section">Cons: </SPAN> <code>from foo import *</code> or 
+<SPAN class="stylepoint_section">Cons: </SPAN> Module names can still collide.  Some module names are
-      <code>from foo import Bar</code> is
+          inconveniently long.
-      very nasty and can lead to serious maintenance issues because
-      it makes it hard to find module dependencies.
         </P>
         <P class="">
 <SPAN class="stylepoint_section">Decision:  </SPAN>
-      Use <code>import x</code> for importing packages and modules.
+          Use <code>import x</code> for importing packages and modules.
-      Use <code>from x import y</code> only when <code>x</code> is a
+          <br>
-      package and <code>y</code> is a module.  This allows the
+          Use <code>from x import y</code> where <code>x</code> is
-      importer to refer to the module without specifying the full
+          the package prefix and <code>y</code> is the module name with no
-      package prefix.  For example the module
+          prefix.
-      <code>sound.effects.echo</code> may be imported as follows:
+          <br>
+          Use <code>from x import y as z</code> if two modules named
+          <code>z</code> are to be imported or if <code>y</code> is an
+          inconveniently long name.
         </P>
+        For example the module
+        <code>sound.effects.echo</code> may be imported as follows:
     <DIV class=""><PRE>
 <span class="external"></span>from sound.effects import echo
 <span class="external"></span>...
-<span class="external"></span>echo.echofilter(input, output, delay=0.7, atten=4)
+<span class="external"></span>echo.EchoFilter(input, output, delay=0.7, atten=4)
 <span class="external"></span>
 </PRE></DIV>
     <p>
-      Even if the module is in the same package, do not directly import
+      Do not use relative names in imports. Even if the module is in the
-      the module without the full package name.  This might cause the
+      same package, use the full package name.  This helps prevent
-      package to be imported twice (with unintended side effects) when the 
+      unintentionally importing a package twice.
-      "main" module that is used to start an application lives inside a 
-      package (and uses modules from that same package).
     </p>
       </DIV></DIV>
     </DIV>
@@ -300,8 +303,7 @@
           link
         </A></SPAN><SPAN class="showhide_button" onclick="javascript:ShowHideByName('Packages__body','Packages__button')" name="Packages__button" id="Packages__button">▶</SPAN>
       <DIV style="display:inline;" class="">
-        Import and refer to each module using the full pathname location of 
+        Import each module using the full pathname location of the module.
-        that module.
       </DIV>
       <DIV class=""><DIV class="stylepoint_body" name="Packages__body" id="Packages__body" style="display: none">
         <P class="">
@@ -315,21 +317,19 @@
         </P>
         <P class="">
 <SPAN class="stylepoint_section">Decision:  </SPAN>
-      All new code should refer to modules based on their package
+          All new code should import each module by its full package name.
-      name. 
+          
         </P>
       <p>
         Imports should be as follows:
       </p>
-
     
     <DIV class=""><PRE># Reference in code with complete name.
 import sound.effects.echo
 
-# Reference in code with just module name.
+# Reference in code with just module name (preferred).
 from sound.effects import echo
 </PRE></DIV>
-    
       </DIV></DIV>
     </DIV>
     <DIV class="">
@@ -1389,12 +1389,9 @@ from sound.effects import echo
       Always use the most specific version you can use, e.g.,
       <code>/usr/bin/python2.4</code>, not
       <code>/usr/bin/python2</code>. This makes it easier to find
-      dependencies when 
+      dependencies when upgrading to a different Python version
-      
-      upgrading to a different Python version
       and also avoids confusion and breakage during use.  E.g., Does
-      <code>/usr/bin/python2</code> mean Python 2.0.1 or Python
+      <code>/usr/bin/python2</code> mean Python 2.0.1 or Python 2.3.0?
-      2.3.0? 
     </p>
     
       </DIV></DIV>
@@ -2028,7 +2025,7 @@ Don'<span class="external"></span>t do this.
 
 
 <p align="right">
-Revision 2.15
+Revision 2.18
 </p>
 
 

styleguide.xsl

@@ -449,7 +449,9 @@ xmlns:fn="http://www.w3.org/2005/xpath-functions">
        Substitutes underscore for characters unsuitable for URLs  -->
   <xsl:template name="anchorname">
     <xsl:param name="sectionname"/>
-    <xsl:value-of select="translate($sectionname,' ()#','____')"/>
+    <!-- strange quoting necessary to strip apostrophes -->
+    <xsl:variable name="bad_characters" select="&quot; ()#'&quot;"/>
+    <xsl:value-of select="translate($sectionname,$bad_characters,'_____')"/>
   </xsl:template>
 
   <!-- Given text, evaluates to the number of leading spaces. -->