[lld] r292980 - Add a file comment to SyntheticSections.h.

[Rui Ueyama via llvm-commits]

Author: ruiu
Date: Tue Jan 24 15:35:25 2017
New Revision: 292980

URL: http://llvm.org/viewvc/llvm-project?rev=292980&view=rev
Log:
Add a file comment to SyntheticSections.h.

Modified:
    lld/trunk/ELF/SyntheticSections.h

Modified: lld/trunk/ELF/SyntheticSections.h
URL: http://llvm.org/viewvc/llvm-project/lld/trunk/ELF/SyntheticSections.h?rev=292980&r1=292979&r2=292980&view=diff
==============================================================================
--- lld/trunk/ELF/SyntheticSections.h (original)
+++ lld/trunk/ELF/SyntheticSections.h Tue Jan 24 15:35:25 2017
@@ -6,6 +6,21 @@
 // License. See LICENSE.TXT for details.
 //
 //===----------------------------------------------------------------------===//
+//
+// Synthetic sections represent chunks of linker-created data. If you
+// need to create a chunk of data that to be included in some section
+// in the result, you probably want to create it as a synthetic section.
+//
+// In reality, there are a few linker-synthesized chunks that are not
+// of synthetic sections, such as thunks. But we are rewriting them so
+// that eventually they are represented as synthetic sections.
+//
+// Synthetic sections are designed as input sections as opposed to
+// output sections because we want to allow them to be manipulated
+// using linker scripts just like other input sections from regular
+// files.
+//
+//===----------------------------------------------------------------------===//
 
 #ifndef LLD_ELF_SYNTHETIC_SECTION_H
 #define LLD_ELF_SYNTHETIC_SECTION_H