Add comments in DSC files to explain the function and design of components section.

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@7488 6f19259b-4bc3-4df7-8a09-765794883524

diff --git a/EdkCompatibilityPkg/EdkCompatibilityPkg.dsc b/EdkCompatibilityPkg/EdkCompatibilityPkg.dsc
index 12ce4b5be5181e60c871fe970fbfa70df277bcb8..4fcf1b816353af3a265a397bdf53835ef1729fe2 100644 (file)
--- a/EdkCompatibilityPkg/EdkCompatibilityPkg.dsc
+++ b/EdkCompatibilityPkg/EdkCompatibilityPkg.dsc
@@ -131,6 +131,24 @@ define GCC_MACRO                 = -DEFI_SPECIFICATION_VERSION=0x00020000 -DPI_S
   MSFT:*_*_IPF_APP_FLAGS    = /D EFI64 $(MSFT_MACRO)\r
   MSFT:*_*_IPF_PP_FLAGS     = /D EFI64 $(MSFT_MACRO)\r
 \r
   MSFT:*_*_IPF_APP_FLAGS    = /D EFI64 $(MSFT_MACRO)\r
   MSFT:*_*_IPF_PP_FLAGS     = /D EFI64 $(MSFT_MACRO)\r
 \r

+###################################################################################################\r
+#\r
+# Components Section - list of the modules and components that will be processed by compilation\r
+#                      tools and the EDK II tools to generate PE32/PE32+/Coff image files.\r
+#\r
+# Note: The EDK II DSC file is not used to specify how compiled binary images get placed\r
+#       into firmware volume images. This section is just a list of modules to compile from\r
+#       source into UEFI-compliant binaries.\r
+#       It is the FDF file that contains information on combining binary files into firmware\r
+#       volume images, whose concept is beyond UEFI and is described in PI specification.\r
+#       Binary modules do not need to be listed in this section, as they should be\r
+#       specified in the FDF file. For example: Shell binary (Shell_Full.efi), FAT binary (Fat.efi),\r
+#       Logo (Logo.bmp), and etc.\r
+#       There may also be modules listed in this section that are not required in the FDF file,\r
+#       When a module listed here is excluded from FDF file, then UEFI-compliant binary will be\r
+#       generated for it, but the binary will not be put into any firmware volume.\r
+#\r
+###################################################################################################\r

 \r
 [Components.Common]\r
 \r
 \r
 [Components.Common]\r
 \r