From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <yonghong.zhu@intel.com>
Received-SPF: Pass (sender SPF authorized) identity=mailfrom;
 client-ip=192.55.52.120; helo=mga04.intel.com;
 envelope-from=yonghong.zhu@intel.com; receiver=edk2-devel@lists.01.org 
Received: from mga04.intel.com (mga04.intel.com [192.55.52.120])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (No client certificate requested)
 by ml01.01.org (Postfix) with ESMTPS id B6EB721FB7D5D
 for <edk2-devel@lists.01.org>; Tue,  3 Apr 2018 00:18:09 -0700 (PDT)
X-Amp-Result: SKIPPED(no attachment in message)
X-Amp-File-Uploaded: False
Received: from fmsmga005.fm.intel.com ([10.253.24.32])
 by fmsmga104.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;
 03 Apr 2018 00:18:09 -0700
X-ExtLoop1: 1
X-IronPort-AV: E=Sophos;i="5.48,398,1517904000"; d="scan'208";a="217168659"
Received: from shwdeopenpsi168.ccr.corp.intel.com ([10.239.158.129])
 by fmsmga005.fm.intel.com with ESMTP; 03 Apr 2018 00:18:08 -0700
From: Yonghong Zhu <yonghong.zhu@intel.com>
To: edk2-devel@lists.01.org
Cc: Liming Gao <liming.gao@intel.com>,
 Michael Kinney <michael.d.kinney@intel.com>,
 Kevin W Shaw <kevin.w.shaw@intel.com>
Date: Tue,  3 Apr 2018 15:17:49 +0800
Message-Id: <1522739869-18508-7-git-send-email-yonghong.zhu@intel.com>
X-Mailer: git-send-email 2.6.1.windows.1
In-Reply-To: <1522739869-18508-1-git-send-email-yonghong.zhu@intel.com>
References: <1522739869-18508-1-git-send-email-yonghong.zhu@intel.com>
Subject: [Patch] INF spec: Update version to 1.27
X-BeenThere: edk2-devel@lists.01.org
X-Mailman-Version: 2.1.26
Precedence: list
List-Id: EDK II Development  <edk2-devel.lists.01.org>
List-Unsubscribe: <https://lists.01.org/mailman/options/edk2-devel>,
 <mailto:edk2-devel-request@lists.01.org?subject=unsubscribe>
List-Archive: <http://lists.01.org/pipermail/edk2-devel/>
List-Post: <mailto:edk2-devel@lists.01.org>
List-Help: <mailto:edk2-devel-request@lists.01.org?subject=help>
List-Subscribe: <https://lists.01.org/mailman/listinfo/edk2-devel>,
 <mailto:edk2-devel-request@lists.01.org?subject=subscribe>
X-List-Received-Date: Tue, 03 Apr 2018 07:18:09 -0000

Cc: Liming Gao <liming.gao@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Cc: Kevin W Shaw <kevin.w.shaw@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
---
 2_inf_overview/24_[defines]_section.md           |  8 ++++----
 3_edk_ii_inf_file_format/34_[defines]_section.md | 22 +++++++++++-----------
 README.md                                        |  4 +++-
 appendix_d_sample_driver_inf_files.md            |  6 +++---
 appendix_e_sample_library_inf_files.md           |  8 ++++----
 appendix_f_sample_binary_inf_files.md            |  4 ++--
 6 files changed, 27 insertions(+), 25 deletions(-)

diff --git a/2_inf_overview/24_[defines]_section.md b/2_inf_overview/24_[defines]_section.md
index 3aab498..37b0135 100644
--- a/2_inf_overview/24_[defines]_section.md
+++ b/2_inf_overview/24_[defines]_section.md
@@ -1,9 +1,9 @@
 <!--- @file
   2.4 [Defines] Section
 
-  Copyright (c) 2007-2017, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2007-2018, Intel Corporation. All rights reserved.<BR>
 
   Redistribution and use in source (original document form) and 'compiled'
   forms (converted to PDF, epub, HTML and other formats) with or without
   modification, are permitted provided that the following conditions are met:
 
@@ -56,11 +56,11 @@ The format for entries in this section is:
 
 The following is an example of a driver's `[Defines]` section.
 
 ```ini
 [Defines]
-  INF_VERSION     = 0x00010019
+  INF_VERSION     = 0x0001001B
   BASE_NAME       = DxeIpl
   FILE_GUID       = 86D70125-BAA3-4296-A62F-602BEBBB9081
   VERSION_STRING  = 1.0
   MODULE_TYPE     = PEIM
   ENTRY_POINT     = PeimInitializeDxeIpl
@@ -69,11 +69,11 @@ The following is an example of a driver's `[Defines]` section.
 
 The following is an example of a library's `[Defines]` section.
 
 ```ini
 [Defines]
-  INF_VERSION    = 1.25
+  INF_VERSION    = 1.27
   BASE_NAME      = BaseMemoryLib
   FILE_GUID      = fd44e603-002a-4b29-9f5f-529e815b6165
   MODULE_TYPE    = BASE
   VERSION_STRING = 1.0
   LIBRARY_CLASS  = BaseMemoryLib
@@ -108,11 +108,11 @@ dispatch instance.
 
 ###### Table 1 EDK II [Defines] Section Elements
 
 | Tag                          | Required                                                                 | Value                                         | Notes                                                                                                                                                                                                                                                                                                                                                                                                                                               |
 | ---------------------------- | ------------------------------------------------------------------------ | --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `INF_VERSION`                | REQUIRED                                                                 | 1.25 or 0x00010019                            | This identifies the INF spec. version. Tools use this value to handle parsing of previous releases of the specification if there are incompatible changes.                                                                                                                                                                                                                                                                                          |
+| `INF_VERSION`                | REQUIRED                                                                 | 1.27 or 0x0001001B                            | This identifies the INF spec. version. It is decimal value with fraction or two-nibble hexadecimal representation of the same, for example: 1.27. Tools use this value to handle parsing of previous releases of the specification if there are incompatible changes.                                                                                                                                                                                                                                                                                          |
 | `BASE_NAME`                  | REQUIRED                                                                 | A single word                                 | This is a single word identifier that will be used for the component name.                                                                                                                                                                                                                                                                                                                                                                          |
 | `EDK_RELEASE_VERSION`        | Not required                                                             | Hex Double Word                               | The minimum revision value across the module and all its dependent libraries. If a revision value is not declared in the module or any of the dependent libraries, then the tool may use the value of 0, which disables checking.                                                                                                                                                                                                                   |
 | `PI_SPECIFICATION_VERSION`   | Not required                                                             | Decimal or special format of hex              | The minimum revision value across the module and all its dependent libraries. If a revision value is not declared in the module or any of the dependent libraries, then tools may use the value of 0, which disables checking.                                                                                                                                                                                                                      |
 |                              |                                                                          |                                               | The `PI_SPECIFICATION_VERSION` must only be set in the INF file if the module depends on services or system table fields or PI core behaviors that are not present in the PI 1.0 version. For example, if a module depends on definitions in PI 1.1 that are not in PI 1.0, then `PI_SPECIFICATION_VERSION` must be 0x0001000A                                                                                                                      |
 | `UEFI_SPECIFICATION_VERSION` | Not required                                                             | Decimal or special format of hex              | The minimum revision value across the module and all its dependent libraries. If a revision value is not declared in the module or any of the dependent libraries, then tools may use the value of 0, which disables checking.                                                                                                                                                                                                                      |
diff --git a/3_edk_ii_inf_file_format/34_[defines]_section.md b/3_edk_ii_inf_file_format/34_[defines]_section.md
index c121331..494b77d 100644
--- a/3_edk_ii_inf_file_format/34_[defines]_section.md
+++ b/3_edk_ii_inf_file_format/34_[defines]_section.md
@@ -1,9 +1,9 @@
 <!--- @file
   3.4 [Defines] Section
 
-  Copyright (c) 2007-2017, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2007-2018, Intel Corporation. All rights reserved.<BR>
 
   Redistribution and use in source (original document form) and 'compiled'
   forms (converted to PDF, epub, HTML and other formats) with or without
   modification, are permitted provided that the following conditions are met:
 
@@ -38,15 +38,15 @@ This is a required section.
 This describes the required `[Defines]` section used in EDK II INF files. This
 file is created during installation of a UEFI distribution package or by the
 developer and is an input to the new build tool parsing utilities. Elements may
 appear in any order within this section.
 
-The version for this specification is "0x00010019" and new versions of this
-specification must increment the minor (0019) portion of the specification code
+The version for this specification is "0x0001001B" and new versions of this
+specification must increment the minor (001B) portion of the specification code
 for backward compatible changes, and increment the major number for
 non-backward compatible specification changes. This value may also be specified
-as a decimal value, 1.25.
+as a decimal value, 1.27.
 
 The `[Defines]` section assigns values to the symbols that describe the
 component. Some items are emitted to the output makefile, others are used to
 create filenames during the build. Some symbols are emitted to the generated C
 files.
@@ -54,13 +54,13 @@ files.
 The `FILE_GUID` is required for all EDK II modules. This GUID is used to build
 the FW volume file list used by build tools to generate the final firmware
 volume, as well as processed in some SMM, PEI or DXE `DEPEX` statements.
 
 All new EDK II INF files must include one of the following statements:
-`INF_VERSION = 0x00010019` or `INF_VERSION = 1.25` in this section, where the
+`INF_VERSION = 0x0001001B` or `INF_VERSION = 1.27` in this section, where the
 number varies according to the release of this specification. It is a
-HexVersion type, where the 0x0001 is the major number, and the 0019 is the
+HexVersion type, where the 0x0001 is the major number, and the 001B is the
 minor number. This version of the specification provides full backward
 compatibility to all previous versions. This means that tools that process
 this version of the specification can also process earlier versions of
 EDK II INF files.
 
@@ -198,15 +198,15 @@ can be used to specify other binary files types, such as logo images or
 legacy16 option ROMs. The `USER_DEFINED` module type must be used in all cases
 where the module type is not a member of `<Edk2ModuleType>`.
 
 **_INF_VERSION_**
 
-For new INF files, the version value must be set to `0x00010019`. Tools that
+For new INF files, the version value must be set to `0x0001001B`. Tools that
 process this version of the INF file can successfully process earlier versions
 of the INF file (this is a backward compatible update). There is no requirement
 to change the value in existing INF files if no other content changes. This may
-also be specified as decimal value, 1.25.
+also be specified as decimal value, 1.27.
 
 **_EDK_RELEASE_VERSION_**
 
 This optional value may be set to the major/minor number of the EDK II release
 required for modules to function correctly.
@@ -300,11 +300,11 @@ Writer's Guide for more information.
 
 #### Example (EDK II Driver)
 
 ```ini
 [Defines]
-  INF_VERSION                = 1.25
+  INF_VERSION                = 1.27
   BASE_NAME                  = PlatformAcpiTable
   FILE_GUID                  = 7E374E25-8E01-4FEE-87F2-390C23C606CD
   MODULE_TYPE                = DXE_DRIVER
   VERSION_STRING             = 1.0
   EDK_RELEASE_VERSION        = 0x00020000
@@ -313,11 +313,11 @@ Writer's Guide for more information.
 
 #### Example (UEFI Driver)
 
 ```ini
 [Defines]
-  INF_VERSION    = 0x00010019
+  INF_VERSION    = 0x0001001B
   BASE_NAME      = Abc
   FILE_GUID      = DA87D340-15C0-4824-9BF3-D52286674BEF
   MODULE_TYPE    = UEFI_DRIVER
   VERSION_STRING = 1.0
   ENTRY_POINT    = AbcDriverEntryPoint
@@ -326,11 +326,11 @@ Writer's Guide for more information.
 
 #### Example (EDK II Library)
 
 ```ini
 [Defines]
-  INF_VERSION    = 1.25
+  INF_VERSION    = 1.27
   BASE_NAME      = LzmaCustomDecompressLib
   FILE_GUID      = 22f8406f-43ee-492f-82f5-4e8a1a58e6d2
   MODULE_TYPE    = BASE
   VERSION_STRING = 1.0
   LIBRARY_CLASS  = CustomDecompressLib
diff --git a/README.md b/README.md
index 02a7532..194d3e3 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,9 @@
 <!--- @file
   README.md for EDK II Module Information (INF) File Specification
 
-  Copyright (c) 2007-2017, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2007-2018, Intel Corporation. All rights reserved.<BR>
 
   Redistribution and use in source (original document form) and 'compiled'
   forms (converted to PDF, epub, HTML and other formats) with or without
   modification, are permitted provided that the following conditions are met:
 
@@ -194,5 +194,7 @@ Copyright (c) 2007-2017, Intel Corporation. All rights reserved.
 | 1.25       | Revised WORKSPACE wording for updated build system that can handle packages located outside of the WORKSPACE directory tree (refer to the TianoCore.org/EDKII website for additional instructions on setting up a development environment).                                         | January 2016  |
 | 1.26       | Convert to GitBooks                                                                                                                                                                                                                                                                 | May 2017      |
 |            | [#463](https://bugzilla.tianocore.org/show_bug.cgi?id=463) INF spec: document the LIB file type under the [Binaries] Section                                                                                                                                                        |               |
 |            | [#548](https://bugzilla.tianocore.org/show_bug.cgi?id=548) [INF spec] INF [LibraryClasses] section should not support ModuleType                                                                                                                                                    |               |
 |            | [#522](https://bugzilla.tianocore.org/show_bug.cgi?id=522) INF spec: add the clarification that PCD value may from build command                                                                                                                                                    |               |
+| 1.27       | Update version to 1.27                                                                                                                                                                                                                                                              | March 2018    |
+|            | Add Flexible PCD value format support                                                                                                                                                                                                                                               |               |
diff --git a/appendix_d_sample_driver_inf_files.md b/appendix_d_sample_driver_inf_files.md
index 8fee082..0efcb63 100644
--- a/appendix_d_sample_driver_inf_files.md
+++ b/appendix_d_sample_driver_inf_files.md
@@ -1,9 +1,9 @@
 <!--- @file
   Appendix D Sample Driver INF Files
 
-  Copyright (c) 2007-2017, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2007-2018, Intel Corporation. All rights reserved.<BR>
 
   Redistribution and use in source (original document form) and 'compiled'
   forms (converted to PDF, epub, HTML and other formats) with or without
   modification, are permitted provided that the following conditions are met:
 
@@ -61,11 +61,11 @@ driver modules.
 # IMPLIED.
 #
 ##
 
 [Defines]
-  INF_VERSION     = 0x00010019
+  INF_VERSION     = 0x0001001B
   BASE_NAME       = DiskIoDxe
   MODULE_UNI_FILE = DiskIoDxe.uni
   FILE_GUID       = 6B38F7B4-AD98-40e9-9093-ACA2B5A253C4
   MODULE_TYPE     = UEFI_DRIVER
   VERSION_STRING  = 1.0
@@ -121,11 +121,11 @@ driver modules.
 # IMPLIED.
 #
 ##
 
 [Defines]
-  INF_VERSION     = 0x00010019
+  INF_VERSION     = 0x0001001B
   BASE_NAME       = StatusCodeRuntimeDxe
   MODULE_UNI_FILE = StatusCodeRuntimeDxe.uni
   FILE_GUID       = FEDE0A1B-BCA2-4A9F-BB2B-D9FD7DEC2E9F
   MODULE_TYPE     = DXE_RUNTIME_DRIVER
   VERSION_STRING  = 1.0
diff --git a/appendix_e_sample_library_inf_files.md b/appendix_e_sample_library_inf_files.md
index 59757ed..bf4a6fd 100644
--- a/appendix_e_sample_library_inf_files.md
+++ b/appendix_e_sample_library_inf_files.md
@@ -1,9 +1,9 @@
 <!--- @file
   Appendix E Sample Library INF Files
 
-  Copyright (c) 2007-2017, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2007-2018, Intel Corporation. All rights reserved.<BR>
 
   Redistribution and use in source (original document form) and 'compiled'
   forms (converted to PDF, epub, HTML and other formats) with or without
   modification, are permitted provided that the following conditions are met:
 
@@ -57,11 +57,11 @@ DxeCoreMemoryAllocationLib.inf and SmmCorePerformanceLib.inf.
 # IMPLIED.
 #
 ##
 
 [Defines]
-  INF_VERSION     = 0x00010019
+  INF_VERSION     = 0x0001001B
   BASE_NAME       = PeiServicesTablePointerLib
   MODULE_UNI_FILE = PeiServicesTablePointerLib.uni
   FILE_GUID       = 1c747f6b-0a58-49ae-8ea3-0327a4fa10e3
   MODULE_TYPE     = PEIM
   VERSION_STRING  = 1.0
@@ -107,11 +107,11 @@ DxeCoreMemoryAllocationLib.inf and SmmCorePerformanceLib.inf.
 # IMPLIED.
 #
 ##
 
 [Defines]
-  INF_VERSION    = 0x00010019
+  INF_VERSION    = 0x0001001B
   BASE_NAME      = DxeCoreMemoryAllocationLib
   FILE_GUID      = 632F3FAC-1CA4-4725-BAA2-BDECCF9A111C
   MODULE_TYPE    = DXE_CORE
   VERSION_STRING = 1.0
   LIBRARY_CLASS  = MemoryAllocationLib|DXE_CORE
@@ -163,11 +163,11 @@ DxeCoreMemoryAllocationLib.inf and SmmCorePerformanceLib.inf.
 # IMPLIED.
 #
 ##
 
 [Defines]
-  INF_VERSION              = 0x00010019
+  INF_VERSION              = 0x0001001B
   BASE_NAME                = SmmCorePerformanceLib
   FILE_GUID                = 36290D10-0F47-42c1-BBCE-E191C7928DCF
   MODULE_TYPE              = SMM_CORE
   VERSION_STRING           = 1.0
   PI_SPECIFICATION_VERSION = 0x0001000A
diff --git a/appendix_f_sample_binary_inf_files.md b/appendix_f_sample_binary_inf_files.md
index 5825505..e6d06d7 100644
--- a/appendix_f_sample_binary_inf_files.md
+++ b/appendix_f_sample_binary_inf_files.md
@@ -1,9 +1,9 @@
 <!--- @file
   Appendix F Sample Binary INF Files
 
-  Copyright (c) 2007-2017, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2007-2018, Intel Corporation. All rights reserved.<BR>
 
   Redistribution and use in source (original document form) and 'compiled'
   forms (converted to PDF, epub, HTML and other formats) with or without
   modification, are permitted provided that the following conditions are met:
 
@@ -111,11 +111,11 @@ RuntimeDxe driver in the MdeModulePkg.
 # IMPLIED.
 #
 ##
 
 [Defines]
-  INF_VERSION    = 0x00010019
+  INF_VERSION    = 0x0001001B
   BASE_NAME      = RuntimeDxe
   FILE_GUID      = B601F8C4-43B7-4784-95B1-F4226CB40CEE
   MODULE_TYPE    = DXE_RUNTIME_DRIVER
   VERSION_STRING = 1.0
 
-- 
2.6.1.windows.1