MdeModulePkg: INF/DEC file updates to EDK II packages

1. Usage information in INF file comment blocks are either incomplete or incorrect.  
This includes usage information for Protocols/PPIs/GUIDs/PCDs/HOBs/Events/BootModes.  
The syntax for usage information in comment blocks is defined in the EDK II Module Information (INF) Specification

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Zeng, Star <star.zeng@intel.com>
Reviewed-by: Gao, Liming <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@15962 6f19259b-4bc3-4df7-8a09-765794883524

4 files changed, 43 insertions, 26 deletions

diff --git a/MdeModulePkg/Universal/Disk/CdExpressPei/CdExpressPei.inf b/MdeModulePkg/Universal/Disk/CdExpressPei/CdExpressPei.inf
index 287f1ff4a9..4a44a5a9e3 100644
--- a/MdeModulePkg/Universal/Disk/CdExpressPei/CdExpressPei.inf
+++ b/MdeModulePkg/Universal/Disk/CdExpressPei/CdExpressPei.inf
@@ -1,11 +1,11 @@
 ## @file

-# Component description file for PeiCdExpress module.

+# PeiCdExpress recovery module.

 #

 # This module reads data from CDROM device by all installed block IO ppi and 

 # finds whether there is Recovery data in the device. If it finds recovery

 # data, it will install Device Recovery Module PPI.

 #

-# Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>

+# Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>

 #

 # This program and the accompanying materials

 # are licensed and made available under the terms and conditions

@@ -21,6 +21,7 @@
 [Defines]

   INF_VERSION                    = 0x00010005

   BASE_NAME                      = CdExpressPei

+  MODULE_UNI_FILE                = CdExpressPei.uni

   FILE_GUID                      = 31e147a6-d39a-4147-9da3-befd4d523243

   MODULE_TYPE                    = PEIM

   VERSION_STRING                 = 1.0

@@ -52,18 +53,20 @@
   PcdLib

 

 [Guids]

-  gRecoveryOnDataCdGuid                         # ALWAYS_CONSUMED

+  gRecoveryOnDataCdGuid                         ## CONSUMES   ## UNDEFINED # Indicate the recovery device type

 

 

 [Ppis]

-  gEfiPeiVirtualBlockIoPpiGuid                  # PPI_NOTIFY SOMETIMES_CONSUMED

-  gEfiPeiDeviceRecoveryModulePpiGuid            # PPI ALWAYS_PRODUCED

+  ## NOTIFY

+  ## CONSUMES

+  gEfiPeiVirtualBlockIoPpiGuid

+  gEfiPeiDeviceRecoveryModulePpiGuid            ## PRODUCES

 

 [FeaturePcd]

-  gEfiMdeModulePkgTokenSpaceGuid.PcdFrameworkCompatibilitySupport	         ## CONSUMES

+  gEfiMdeModulePkgTokenSpaceGuid.PcdFrameworkCompatibilitySupport   ## CONSUMES

 

 [Depex]

   gEfiPeiMemoryDiscoveredPpiGuid AND gEfiPeiBootInRecoveryModePpiGuid

 

-

-

+[UserExtensions.TianoCore."ExtraFiles"]

+  CdExpressPeiExtra.uni

diff --git a/MdeModulePkg/Universal/Disk/DiskIoDxe/DiskIoDxe.inf b/MdeModulePkg/Universal/Disk/DiskIoDxe/DiskIoDxe.inf
index ec1f75f954..cee27d5b11 100644
--- a/MdeModulePkg/Universal/Disk/DiskIoDxe/DiskIoDxe.inf
+++ b/MdeModulePkg/Universal/Disk/DiskIoDxe/DiskIoDxe.inf
@@ -8,7 +8,7 @@
 #  already have a Disk I/O protocol. File systems and other disk access

 #  code utilize the Disk I/O protocol.

 #  

-#  Copyright (c) 2006 - 2013, Intel Corporation. All rights reserved.<BR>

+#  Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>

 #  This program and the accompanying materials

 #  are licensed and made available under the terms and conditions of the BSD License

 #  which accompanies this distribution.  The full text of the license may be found at

@@ -22,6 +22,7 @@
 [Defines]

   INF_VERSION                    = 0x00010005

   BASE_NAME                      = DiskIoDxe

+  MODULE_UNI_FILE                = DiskIoDxe.uni

   FILE_GUID                      = 6B38F7B4-AD98-40e9-9093-ACA2B5A253C4

   MODULE_TYPE                    = UEFI_DRIVER

   VERSION_STRING                 = 1.0

@@ -64,4 +65,7 @@
   gEfiBlockIo2ProtocolGuid                      ## TO_START

 

 [Pcd]

-  gEfiMdeModulePkgTokenSpaceGuid.PcdDiskIoDataBufferBlockNum

+  gEfiMdeModulePkgTokenSpaceGuid.PcdDiskIoDataBufferBlockNum    ## SOMETIMES_CONSUMES

+

+[UserExtensions.TianoCore."ExtraFiles"]

+  DiskIoDxeExtra.uni

diff --git a/MdeModulePkg/Universal/Disk/PartitionDxe/PartitionDxe.inf b/MdeModulePkg/Universal/Disk/PartitionDxe/PartitionDxe.inf
index 089918f5a9..680626378f 100644
--- a/MdeModulePkg/Universal/Disk/PartitionDxe/PartitionDxe.inf
+++ b/MdeModulePkg/Universal/Disk/PartitionDxe/PartitionDxe.inf
@@ -1,6 +1,5 @@
 ## @file

-#  Modules that produces the logic Block I/O protocol for every partition

-#  it discovers via the physical Block I/O.

+#  Modules that produces the logic Block I/O protocol for every partition via the physical Block I/O.

 #

 #  This module produces the logical Block I/O device that represents

 #  the bytes from Start to End of the Parent Block I/O device.

@@ -12,7 +11,7 @@
 #  This external input must be validated carefully to avoid security issue like

 #  buffer overflow, integer overflow.

 #

-#  Copyright (c) 2006 - 2013, Intel Corporation. All rights reserved.<BR>

+#  Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>

 #  This program and the accompanying materials

 #  are licensed and made available under the terms and conditions of the BSD License

 #  which accompanies this distribution.  The full text of the license may be found at

@@ -26,6 +25,7 @@
 [Defines]

   INF_VERSION                    = 0x00010005

   BASE_NAME                      = PartitionDxe

+  MODULE_UNI_FILE                = PartitionDxe.uni

   FILE_GUID                      = 1FA1F39E-FEFF-4aae-BD7B-38A070A3B609

   MODULE_TYPE                    = UEFI_DRIVER

   VERSION_STRING                 = 1.0

@@ -67,16 +67,23 @@
 

 [Guids]

   gEfiPartTypeUnusedGuid                        ## SOMETIMES_CONSUMES ## GUID

-  gEfiPartTypeSystemPartGuid                    ## SOMETIMES_CONSUMES ## Protocol

+  ## SOMETIMES_CONSUMES ## GUID

+  ## SOMETIMES_CONSUMES ## GUID # Install protocol

+  gEfiPartTypeSystemPartGuid

 

 

 [Protocols]

-  gEfiBlockIoProtocolGuid                       ## BY_START

-  gEfiDevicePathProtocolGuid                    ## BY_START

-  gEfiDiskIoProtocolGuid                        ## BY_START

-  gEfiDiskIo2ProtocolGuid                       ## BY_START

-  gEfiBlockIoProtocolGuid                       ## TO_START

-  gEfiBlockIo2ProtocolGuid                      ## TO_START

-  gEfiDevicePathProtocolGuid                    ## TO_START

+  ## BY_START

+  ## TO_START

+  gEfiBlockIoProtocolGuid

+  ## BY_START

+  ## TO_START

+  gEfiBlockIo2ProtocolGuid

+  ## BY_START

+  ## TO_START

+  gEfiDevicePathProtocolGuid

   gEfiDiskIoProtocolGuid                        ## TO_START

   gEfiDiskIo2ProtocolGuid                       ## TO_START

+

+[UserExtensions.TianoCore."ExtraFiles"]

+  PartitionDxeExtra.uni

diff --git a/MdeModulePkg/Universal/Disk/UnicodeCollation/EnglishDxe/EnglishDxe.inf b/MdeModulePkg/Universal/Disk/UnicodeCollation/EnglishDxe/EnglishDxe.inf
index 0b05b24d23..46c834c648 100644
--- a/MdeModulePkg/Universal/Disk/UnicodeCollation/EnglishDxe/EnglishDxe.inf
+++ b/MdeModulePkg/Universal/Disk/UnicodeCollation/EnglishDxe/EnglishDxe.inf
@@ -7,7 +7,7 @@
 #  It allows code running in the boot services environment to perform lexical

 #  comparison functions on Unicode strings for English languages.

 #  

-#  Copyright (c) 2006 - 2011, Intel Corporation. All rights reserved.<BR>

+#  Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>

 #  This program and the accompanying materials

 #  are licensed and made available under the terms and conditions of the BSD License

 #  which accompanies this distribution.  The full text of the license may be found at

@@ -21,6 +21,7 @@
 [Defines]

   INF_VERSION                    = 0x00010005

   BASE_NAME                      = EnglishDxe

+  MODULE_UNI_FILE                = EnglishDxe.uni

   FILE_GUID                      = CD3BAFB6-50FB-4fe8-8E4E-AB74D2C1A600

   MODULE_TYPE                    = UEFI_DRIVER

   VERSION_STRING                 = 1.0

@@ -48,10 +49,12 @@
   PcdLib

 

 [FeaturePcd]

-  gEfiMdeModulePkgTokenSpaceGuid.PcdUnicodeCollationSupport

-  gEfiMdeModulePkgTokenSpaceGuid.PcdUnicodeCollation2Support

+  gEfiMdeModulePkgTokenSpaceGuid.PcdUnicodeCollationSupport     ## CONSUMES

+  gEfiMdeModulePkgTokenSpaceGuid.PcdUnicodeCollation2Support    ## CONSUMES

 

 [Protocols]

-  gEfiUnicodeCollationProtocolGuid  | gEfiMdeModulePkgTokenSpaceGuid.PcdUnicodeCollationSupport  ## PRODUCES

-  gEfiUnicodeCollation2ProtocolGuid | gEfiMdeModulePkgTokenSpaceGuid.PcdUnicodeCollation2Support ## PRODUCES

+  gEfiUnicodeCollationProtocolGuid | gEfiMdeModulePkgTokenSpaceGuid.PcdUnicodeCollationSupport      ## SOMETIMES_PRODUCES

+  gEfiUnicodeCollation2ProtocolGuid | gEfiMdeModulePkgTokenSpaceGuid.PcdUnicodeCollation2Support    ## PRODUCES

 

+[UserExtensions.TianoCore."ExtraFiles"]

+  EnglishDxeExtra.uni