add some justification for "using namespace llvm;"

git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@119544 91177308-0d34-0410-b5e6-96231b3b80d8
This commit is contained in:
Chris Lattner 2010-11-17 19:47:20 +00:00
parent 4d08863108
commit eddd96901e

View File

@ -914,11 +914,13 @@ such, we never use '<tt>using namespace std;</tt>' in LLVM.</p>
<p>The exception to the general rule (i.e. it's not an exception for <p>The exception to the general rule (i.e. it's not an exception for
the <tt>std</tt> namespace) is for implementation files. For example, all of the <tt>std</tt> namespace) is for implementation files. For example, all of
the code in the LLVM project implements code that lives in the 'llvm' namespace. the code in the LLVM project implements code that lives in the 'llvm' namespace.
As such, it is ok, and actually clearer, for the <tt>.cpp</tt> files to have a '<tt>using As such, it is ok, and actually clearer, for the <tt>.cpp</tt> files to have a
namespace llvm</tt>' directive at their top, after the <tt>#include</tt>s. The '<tt>using namespace llvm</tt>' directive at their top, after the
general form of this rule is that any <tt>.cpp</tt> file that implements code in any <tt>#include</tt>s. This reduces indentation in the body of the file for source
namespace may use that namespace (and its parents'), but should not use any editors that indent based on braces, and keeps the conceptual context cleaner.
others.</p> The general form of this rule is that any <tt>.cpp</tt> file that implements
code in any namespace may use that namespace (and its parents'), but should not
use any others.</p>
</div> </div>