Commits

Kosei Kitahara  committed 228c887

Update TODO

  • Participants
  • Parent commits 1aca13f

Comments (0)

Files changed (1)

 クラス
 ``````
 
-どのクラスからも継承のないクラスは、かならず object を継承します。ネストクラスについても同様です。 ::
+どのクラスも継承しないクラスは、かならず `object` を継承します。
+ネストクラスについても同様です::
 
     # No:
     class SampleClass:
     class ChildClass(ParentClass):
         """Explicitly inherits from another class already."""
 
-object の継承は、プロパティを適切に動作させるために必要であり、
+`object` の継承は、プロパティを適切に動作させるために必要であり、
 Python 3000 の潜在的な非互換性から保護します。
-それは、 `__new__`, `__init__`, `__delattr__`, `__getattribute__`, `__setattr__`, `__hash__`, `__repr__`, や `__str__` を含む object のデフォルトの意味 (semantics) を含む特別なメソッドを定義します。
+それは、 `__new__`, `__init__`, `__delattr__`, `__getattribute__`, `__setattr__`, `__hash__`, `__repr__`, や `__str__` を含む `object` のデフォルトのセマンティクスを含む特別なメソッドを定義します。
 
 .. _文字列:
 
 ``````
 
 パラメータがすべて文字列の場合は、その文字列のフォーマットを指定するために `%` 演算子を利用します。
-しかし、 `+` か `%` のどちらが適切かを判断します::
+`+` か `%` のどちらが適切かを判断します::
 
     # No:
     x = '%s%s' % (a, b)  # use + in this case
 
 ループ内の文字列を連結するために `+` や `+=` 演算子を利用してはいけません。
 文字列は `イミュータブル`_ であるため、これは不要なテンポラリーオブジェクトを作成し、実行時に線形制約クラスではなく 2 次制約クラスとなります。
-その代用として、各文字を配列に入れ、ループ終了後に `''.join` で配列を連結します (`cStringIO.StringIO` バッファーへの追記)。 ::
+その代用として、各文字を配列に入れ、ループ終了後に `''.join` で配列を連結します
+(もしくは `cStringIO.StringIO` バッファーへの追記)::
 
     # No:
     employee_table = '<table>'
 
 複数行の文字列は `'''` ではなく、 `"""` を利用します。
 しかし、複数行の文字列の連結がプログラムのインデントからはみでないのであれば、
-非明示的な行継続の方が美しくなる事に注意しましょう::
+非明示的な行継続の方が美しくなる事に注意しましょう::
 
     # No:
     print """This is pretty ugly.
 TODO コメント
 `````````````
 
-短期的で解決すべきこと、条件を満たしてはいるがベストではない場合などに、
-コードに一時的な `TODO` コメントを利用します。
+一時的、短期的な解決、条件を満たしてはいるがベストではない場合などに、 `TODO` コメントを利用します。
 
 TODO は `TODO` から開始し、続いて括弧内に名前やメールアドレス、もしくはその他の識別情報を記載します。
 オプションでコロンをつけます。
 コメントで今後どうするかを解説します。
 主な目的は、共通の `TODO` フォーマットにより (検討すべきより詳細な情報を持っている) コメントの記載者が検索できるようにすることです。
-`TODO` は解決策を提供するためのものではありません::
+`TODO` は解決策を提供するためのものではありません::
 
     # TODO(kl@gmail.com): Drop the use of "has_key".
     # TODO(Zeke) change this to use relations.