StarMirror/styleguide
1
0
Fork 0
mirror of https://github.com/google/styleguide.git synced 2024-03-22 13:11:43 +08:00
Code Issues Projects Releases Wiki Activity

Update C++ style guide to 3.178:

Browse Source 
- Fix grammatical and spelling errors, and revise awkward phrasing.
This commit is contained in:
mmentovai 2010-10-14 15:54:08 +00:00
parent 7d78fd4e6a
commit ce4da30bb9
1 changed files with 6 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
cppguide.xml
View File

@ -4,7 +4,7 @@
<p align="right"> <p align="right">
Revision 3.175 Revision 3.178
</p> </p>
@ -1756,7 +1756,7 @@ Tashana Landray
<li>More generally, exceptions make the control flow of <li>More generally, exceptions make the control flow of
programs difficult to evaluate by looking at code: functions programs difficult to evaluate by looking at code: functions
may return in places you don't expect. This results may return in places you don't expect. This causes
maintainability and debugging difficulties. You can minimize maintainability and debugging difficulties. You can minimize
this cost via some rules on how and where exceptions can be this cost via some rules on how and where exceptions can be
used, but at the cost of more that a developer needs to know used, but at the cost of more that a developer needs to know
@ -1801,7 +1801,7 @@ Tashana Landray
<p> <p>
Given that Google's existing code is not exception-tolerant, the Given that Google's existing code is not exception-tolerant, the
costs of using exceptions are somewhat greater than the costs in costs of using exceptions are somewhat greater than the costs in
in a new project. The conversion process would be slow and a new project. The conversion process would be slow and
error-prone. We don't believe that the available alternatives to error-prone. We don't believe that the available alternatives to
exceptions, such as error codes and assertions, introduce a exceptions, such as error codes and assertions, introduce a
significant burden. significant burden.
@ -3602,9 +3602,7 @@ Tashana Landray
You shouldn't hard-code user-facing text in source, even English, You shouldn't hard-code user-facing text in source, even English,
so use of non-ASCII characters should be rare. However, in certain so use of non-ASCII characters should be rare. However, in certain
cases it is appropriate to include such words in your code. For cases it is appropriate to include such words in your code. For
example, if your code parses data files from foreign example, if your code parses data files from foreign sources,
it may be appropriate to hard-code the non-ASCII string(s) used in it may be appropriate to hard-code the non-ASCII string(s) used in
those data files as delimiters. More commonly, unittest code those data files as delimiters. More commonly, unittest code
(which does not (which does not
@ -3867,7 +3865,7 @@ Tashana Landray
if (x == kBar) return new Bar(); if (x == kBar) return new Bar();
</CODE_SNIPPET> </CODE_SNIPPET>
<p> <p>
This is not allowed if the if statement has an This is not allowed when the if statement has an
<code>else</code>: <code>else</code>:
</p> </p>
<BAD_CODE_SNIPPET> <BAD_CODE_SNIPPET>
@ -4529,7 +4527,7 @@ Tashana Landray
<HR/> <HR/>
<p align="right"> <p align="right">
Revision 3.175 Revision 3.178
</p> </p>