Update C++ style guide to 3.245:
- Relax the rule for sizeof(varname) vs. sizeof(type).
- Allow an exception for nonconst reference parameters where
convention dictates their use, such as for swap.
- C++11: allow static_assert.
- Require non-trivial fall-through between cases in switch
statements to be annotated. Trivial fall-through includes
consecutive case labels with no intervening code, and no comment
is required in these cases.
- C++11: allow constexpr.
- Revise the "Integer Types" section to note type-width problems.
- Clarify that the "arguments on subsequent lines" function call
style is acceptable even when the 80-column limit doesn't require
it.
- Boost: allow part of Polygon.
- C++11: allow <tuple>.
Update Objective-C style guide to 2.52:
- Fix ARC example to not imply the use of @private in .m files.
- Add an example to the "Category Names" section.
- Require that ARC-using files insert preprocessor directives that
generate an error when compiling without ARC.
- Fix spacing around the *s in the ARC example per the C++ style
guide.
Update Python style guide to 2.48:
- Allow comments with URLs to exceed 80 characters per line.
- Update outdated implicit-line-joining URLs.
Update HTML/CSS style guide to 2.21:
- Consistent use of title case.
- Add new "Declaration Block Separation" section.
- Add a CSS example to the "Capitalization" section.
- Minor fixes to whitespace.
Update JavaScript style to guide to 2.72:
- Make it clear that the injunction against aliasing namespaces only
applies to local aliases, not goog.scope.
- Clarify the style guide's recommendation on array/object literals.
- Add documentation on @private {type}, @protected {type}, and
@const {type}.
- Make JSDoc descriptions required only if not obvious.
- Clarify that only private properties and methods need a trailing
underscore.
- Fix spelling of arv's name.
Update Common Lisp style guide to 1.18:
- Macro-defining macros are harder to understand for everyone, not
just for the "uninitiated." There's no need to condescend.
In all of the above style guides:
- The guide source is now encoded as UTF-8. The numeric character
references have been replaced with raw UTF-8-encoded characters.
diff --git a/pyguide.html b/pyguide.html
index 3c6a3e0..7213d7a 100644
--- a/pyguide.html
+++ b/pyguide.html
@@ -136,7 +136,7 @@
<H1>Google Python Style Guide</H1>
<p align="right">
- Revision 2.45
+ Revision 2.48
</p>
<address>
@@ -1246,9 +1246,11 @@
</DIV>
<DIV class=""><DIV class="stylepoint_body" name="Line_length__body" id="Line_length__body" style="display: none">
<p>
- Exception: lines importing modules may end up longer than 80
- characters only if using Python 2.4 or
- earlier.
+ Exceptions:
+ <ul>
+ <li>Long import statements.</li>
+ <li>URLs in comments.</li>
+ </ul>
</p>
<p>
@@ -1258,7 +1260,7 @@
<p>
Make use of Python's
- <a HREF="http://www.python.org/doc/ref/implicit-joining.html">implicit
+ <a HREF="http://docs.python.org/reference/lexical_analysis.html#implicit-line-joining">implicit
line joining inside parentheses, brackets and braces</a>.
If necessary, you can add an extra pair of parentheses around an
expression.
@@ -1282,6 +1284,17 @@
<span class="external"></span> 'long long long long long long string')</PRE></DIV>
<p>
+ Within comments, put long URLs on their own line if necessary.
+ </p>
+
+ <DIV class=""><PRE>Yes: <span class="external"></span># See details at
+ <span class="external"></span># http://www.example.com/us/developer/documentation/api/content/v2.0/csv_file_name_extension_full_specification.html</PRE></DIV>
+
+ <DIV class=""><PRE class="badcode">No: <span class="external"></span># See details at
+ <span class="external"></span># http://www.example.com/us/developer/documentation/api/content/\
+ <span class="external"></span># v2.0/csv_file_name_extension_full_specification.html</PRE></DIV>
+
+ <p>
Make note of the indentation of the elements in the line
continuation examples above; see the
<a HREF="#Indentation">indentation</a>
@@ -2223,7 +2236,7 @@
<p align="right">
-Revision 2.45
+Revision 2.48
</p>