diff --git a/lib/Target/X86/X86.h b/lib/Target/X86/X86.h
index e798c0c68eb..84d6330b115 100644
--- a/lib/Target/X86/X86.h
+++ b/lib/Target/X86/X86.h
@@ -41,9 +41,9 @@ Pass *createX86CodePrinterPass(std::ostream &O);
 ///
 Pass *createEmitX86CodeToMemory();
 
-// Put symbolic names in a namespace to avoid causing these to clash with all
-// kinds of other things...
-//
+/// X86 namespace - This namespace contains all of the register and opcode enums
+/// used by the X86 backend.
+///
 namespace X86 {
   // Defines a large number of symbolic names for X86 registers.  This defines a
   // mapping from register name to register number.
diff --git a/lib/Target/X86/X86CodeEmitter.cpp b/lib/Target/X86/X86CodeEmitter.cpp
index 3b7fb4c148b..f41300daeac 100644
--- a/lib/Target/X86/X86CodeEmitter.cpp
+++ b/lib/Target/X86/X86CodeEmitter.cpp
@@ -264,8 +264,9 @@ void Emitter::emitGlobalAddressForPtr(GlobalValue *GV) {
 
 
 
-
-namespace N86 {  // Native X86 Register numbers...
+/// N86 namespace - Native X86 Register numbers... used by X86 backend.
+///
+namespace N86 {
   enum {
     EAX = 0, ECX = 1, EDX = 2, EBX = 3, ESP = 4, EBP = 5, ESI = 6, EDI = 7
   };