Finishing initial docs for all transformations in Passes.html.
Also cleaned up some comments in source files.
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@43674 91177308-0d34-0410-b5e6-96231b3b80d8
diff --git a/lib/Transforms/IPO/StripSymbols.cpp b/lib/Transforms/IPO/StripSymbols.cpp
index aaecc2f..ee60ba2 100644
--- a/lib/Transforms/IPO/StripSymbols.cpp
+++ b/lib/Transforms/IPO/StripSymbols.cpp
@@ -7,18 +7,16 @@
//
//===----------------------------------------------------------------------===//
//
-// This file implements stripping symbols out of symbol tables.
+// The StripSymbols transformation implements code stripping. Specifically, it
+// can delete:
+//
+// * names for virtual registers
+// * symbols for internal globals and functions
+// * debug information
//
-// Specifically, this allows you to strip all of the symbols out of:
-// * All functions in a module
-// * All non-essential symbols in a module (all function symbols + all module
-// scope symbols)
-// * Debug information.
-//
-// Notice that:
-// * This pass makes code much less readable, so it should only be used in
-// situations where the 'strip' utility would be used (such as reducing
-// code size, and making it harder to reverse engineer code).
+// Note that this transformation makes code much less readable, so it should
+// only be used in situations where the 'strip' utility would be used, such as
+// reducing code size or making it harder to reverse engineer code.
//
//===----------------------------------------------------------------------===//