From nobody Sat Apr 27 11:09:14 2024
Delivered-To: importer@patchew.org
Authentication-Results: mx.zohomail.com;
	spf=none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain
 of lists.01.org)  smtp.mailfrom=edk2-devel-bounces@lists.01.org
Return-Path: <edk2-devel-bounces@lists.01.org>
Received: from ml01.01.org (ml01.01.org [198.145.21.10]) by mx.zohomail.com
	with SMTPS id 1522739878978934.2939011518561;
 Tue, 3 Apr 2018 00:17:58 -0700 (PDT)
Received: from [127.0.0.1] (localhost [IPv6:::1])
	by ml01.01.org (Postfix) with ESMTP id 0AE0321FB7D53;
	Tue,  3 Apr 2018 00:17:57 -0700 (PDT)
Received: from mga05.intel.com (mga05.intel.com [192.55.52.43])
 (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 7E8B721FB7D49
 for <edk2-devel@lists.01.org>; Tue,  3 Apr 2018 00:17:55 -0700 (PDT)
Received: from fmsmga005.fm.intel.com ([10.253.24.32])
 by fmsmga105.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;
 03 Apr 2018 00:17:55 -0700
Received: from shwdeopenpsi168.ccr.corp.intel.com ([10.239.158.129])
 by fmsmga005.fm.intel.com with ESMTP; 03 Apr 2018 00:17:54 -0700
X-Original-To: edk2-devel@lists.01.org
Received-SPF: none (zoho.com: 198.145.21.10 is neither permitted nor denied by
 domain of lists.01.org) client-ip=198.145.21.10;
 envelope-from=edk2-devel-bounces@lists.01.org; helo=ml01.01.org;
Received-SPF: Pass (sender SPF authorized) identity=mailfrom;
 client-ip=192.55.52.43; helo=mga05.intel.com;
 envelope-from=yonghong.zhu@intel.com; receiver=edk2-devel@lists.01.org
X-Amp-Result: SKIPPED(no attachment in message)
X-Amp-File-Uploaded: False
X-ExtLoop1: 1
X-IronPort-AV: E=Sophos;i="5.48,398,1517904000"; d="scan'208";a="217168569"
From: Yonghong Zhu <yonghong.zhu@intel.com>
To: edk2-devel@lists.01.org
Date: Tue,  3 Apr 2018 15:17:45 +0800
Message-Id: <1522739869-18508-3-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: [edk2] [Patch] DSC spec: Update version to 1.28
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>
Cc: Michael Kinney <michael.d.kinney@intel.com>,
 Kevin W Shaw <kevin.w.shaw@intel.com>, Liming Gao <liming.gao@intel.com>
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable
Errors-To: edk2-devel-bounces@lists.01.org
Sender: "edk2-devel" <edk2-devel-bounces@lists.01.org>
X-ZohoMail: RSF_4  Z_629925259 SPT_0
Content-Type: text/plain; charset="utf-8"

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>
Reviewed-by: Liming Gao <liming.gao@intel.com>
---
 2_dsc_overview/23_[defines]_section_processing.md |  6 +++---
 2_dsc_overview/README.md                          |  4 ++--
 3_edk_ii_dsc_file_format/35_[defines]_section.md  | 10 +++++-----
 README.md                                         |  8 +++++++-
 SUMMARY.md                                        |  1 +
 appendix_b_sample_edk_ii_dsc_file.md              |  4 ++--
 6 files changed, 20 insertions(+), 13 deletions(-)

diff --git a/2_dsc_overview/23_[defines]_section_processing.md b/2_dsc_over=
view/23_[defines]_section_processing.md
index a7e8680..428196b 100644
--- a/2_dsc_overview/23_[defines]_section_processing.md
+++ b/2_dsc_overview/23_[defines]_section_processing.md
@@ -1,9 +1,9 @@
 <!--- @file
   2.3 [Defines] Section Processing
=20
-  Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2006-2018, Intel Corporation. All rights reserved.<BR>
=20
   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 m=
et:
=20
@@ -97,12 +97,12 @@ item is required.
 ###### Table 6 EDK II [Defines] Section Elements
=20
=20
 | Typical Tag Names             | Required / Optional | Value             =
       | Notes                                                             =
                                                                           =
                                                                           =
                                                                           =
                                                                           =
                                                  |
 | ----------------------------- | ----------- | --------------------------=
------ | ------------------------------------------------------------------=
---------------------------------------------------------------------------=
---------------------------------------------------------------------------=
---------------------------------------------------------------------------=
---------------------------------------------------------------------------=
------------------------------------------------- |
-| `DSC_SPECIFICATION`           | Required    | 0x0001001B or 1.27        =
       | This entry is required for all EDK II DSC files. The value, 0x0001=
001B matches the 1.27 version of this specification. Build tools must conti=
nue to support DSC files that correspond to earlier versions of the documen=
t until such time as earlier versions are no longer in use. In order to mai=
ntain backward compatibility, this value must only be updated in existing D=
SC files if other content in the file is updated. |
-|                               |             |                           =
       | This value may also be specified as decimal value, i.e., 1.27.    =
                                                                           =
                                                                           =
                                                                           =
                                                                           =
                                                  |
+| `DSC_SPECIFICATION`           | Required    | 0x0001001C or 1.28        =
       | This entry is required for all EDK II DSC files. The value, 0x0001=
001C matches the 1.28 version of this specification. Build tools must conti=
nue to support DSC files that correspond to earlier versions of the documen=
t until such time as earlier versions are no longer in use. In order to mai=
ntain backward compatibility, this value must only be updated in existing D=
SC files if other content in the file is updated. |
+|                               |             |                           =
       | This value may also be specified as decimal value, i.e., 1.28.    =
                                                                           =
                                                                           =
                                                                           =
                                                                           =
                                                  |
 | `PLATFORM_GUID`               | Required    | Registry Format GUID(8-4-4=
-4-12) | The GUID value, along the PLATFORM_VERSION, is used to uniquely id=
entify a platform file. It is recommended that minor changes to the file in=
crement the PLATFORM_VERSION value, and that the GUID value change for comp=
letely new platforms.                                                      =
                                                                           =
                                                  |
 | `PLATFORM_VERSION`            | Required    | Integer or Decimal Number =
       | The Version value, along the PLATFORM_GUID, is used to uniquely id=
entify a platform file. It is recommended that minor changes to the file in=
crement the PLATFORM_VERSION value, and that the GUID value change for comp=
letely new platforms.                                                      =
                                                                           =
                                                  |
 | `PLATFORM_NAME`               | Required    | Single Word               =
       | Only alphanumeric, dash and underscore character are permitted    =
                                                                           =
                                                                           =
                                                                           =
                                                                           =
                                                  |
 | `SKUID_IDENTIFIER`            | Required    | Formatted text            =
       | This value may be passed on the command line and must match one of=
 the defined names in the [SkuIds] section. If it is passed on the command =
line, the command line value takes precedence.                             =
                                                                           =
                                                                           =
                                                  |
 | `SUPPORTED_ARCHITECTURES`     | Required    | List                      =
       | Pipe ("<code>&#124;</code>") separated list of architectures that =
the platform supports                                                      =
                                                                           =
                                                                           =
                                                                           =
                                                                    |
diff --git a/2_dsc_overview/README.md b/2_dsc_overview/README.md
index a8cfa48..0d1b255 100644
--- a/2_dsc_overview/README.md
+++ b/2_dsc_overview/README.md
@@ -1,9 +1,9 @@
 <!--- @file
   2 DSC Overview
=20
-  Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2006-2018, Intel Corporation. All rights reserved.<BR>
=20
   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 m=
et:
=20
@@ -48,11 +48,11 @@ methods). EDK II DSC files are a list of:
 * EDK II PCD Entries
=20
 There are no new features or format introduced in this specification.
=20
 DSC files that use any new features must use the new
-`DSC_SPECIFICATION =3D 0x0001001B` in the `[Defines]` section. Older DSC f=
iles
+`DSC_SPECIFICATION =3D 0x0001001C` in the `[Defines]` section. Older DSC f=
iles
 that do not use any of these features do not need to update the
 `DSC_SPECIFICATION` value.
=20
 This version of the specification reflects changes to the EDK II reference
 build system that has been updated to support builds using EDK II Packages=
 that
diff --git a/3_edk_ii_dsc_file_format/35_[defines]_section.md b/3_edk_ii_ds=
c_file_format/35_[defines]_section.md
index 8950b80..3961e4c 100644
--- a/3_edk_ii_dsc_file_format/35_[defines]_section.md
+++ b/3_edk_ii_dsc_file_format/35_[defines]_section.md
@@ -1,9 +1,9 @@
 <!--- @file
   3.5 [Defines] Section
=20
-  Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2006-2018, Intel Corporation. All rights reserved.<BR>
=20
   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 m=
et:
=20
@@ -70,11 +70,11 @@ other meta-data files.
 **Note:** Assignments of variables in other sections take precedence over
 global assignments.
 **********
=20
 This revision of specification does not add new features. New EDK II DSC f=
iles
-must include the statement: `DSC_SPECIFICATION =3D 0x0001001B` in this sec=
tion.
+must include the statement: `DSC_SPECIFICATION =3D 0x0001001C` in this sec=
tion.
 Existing DSC files do not need to update the value.
=20
 Individual items must appear on a single line, they may not span multiple =
lines.
=20
 Of special note is the `FLASH_DEFINITION` file name. Unlike other file nam=
es in
@@ -155,14 +155,14 @@ Code>          ::=3D ISO 639-2 Format Language code
 #### Parameters
=20
 **_SpecVal_**
=20
 New DSC files or DSC files that get updated to use any of the new features
-defined in this specification must ensure that the 0x0001001B value is use=
d.
+defined in this specification must ensure that the 0x0001001C value is use=
d.
 The EDK II build system must maintain backward compatibility, therefore, t=
here
 is no requirement to change existing DSC files if no other content changes.
-This value may also be specified as a decimal value of 1.27.
+This value may also be specified as a decimal value of 1.28.
=20
 **_SkuUiName_**
=20
 If specified, the image created from the DSC/FDF file pair will only be va=
lid
 for the SkuUiNames listed. If not specified, and the `[SKUIDS]` section is
@@ -219,11 +219,11 @@ compiling them into a machine language program.
 ```ini
 [Defines]
   PLATFORM_NAME           =3D NT32
   PLATFORM_GUID           =3D EB216561-961F-47EE-9EF9-CA426EF547C2
   PLATFORM_VERSION        =3D 0.3
-  DSC_SPECIFICATION       =3D 0x0001001B
+  DSC_SPECIFICATION       =3D 0x0001001C
   OUTPUT_DIRECTORY        =3D Build/Nt32
   SUPPORTED_ARCHITECTURES =3D IA32
   BUILD_TARGETS           =3D DEBUG|RELEASE
   RFC_LANGUAGES           =3D "en-us;
   zh-hans;fr-fr"
diff --git a/README.md b/README.md
index dd3419a..3e14b34 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,9 @@
 <!--- @file
   README.md for EDK II Platform Description (DSC) File Specification
=20
-  Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2006-2018, Intel Corporation. All rights reserved.<BR>
=20
   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 m=
et:
=20
@@ -184,5 +184,11 @@ Copyright (c) 2006-2017, Intel Corporation. All rights=
 reserved.
 |            | [#519](https://bugzilla.tianocore.org/show_bug.cgi?id=3D519=
) DSC Spec: update Precedence of PCD Values                                =
                                                                           =
                                                                           =
   |                |
 |            | [#584](https://bugzilla.tianocore.org/show_bug.cgi?id=3D584=
) DSC Spec: Update the DSC_SPECIFICATION version to 0x0001001B or 1.27     =
                                                                           =
                                                                           =
   |                |
 |            | [#645](https://bugzilla.tianocore.org/show_bug.cgi?id=3D645=
) DSC Spec: Remove Restriction on Using NULL in [LibraryClasses] Section   =
                                                                           =
                                                                           =
   |                |
 |            | [#669](https://bugzilla.tianocore.org/show_bug.cgi?id=3D669=
) DSC Spec: Add multi-arg support to PREBUILD/POSTBUILD                    =
                                                                           =
                                                                           =
   |                |
 |            | [#597](https://bugzilla.tianocore.org/show_bug.cgi?id=3D597=
) DSC Spec: Hii type Pcd VariableName is NOT allowed to be empty string    =
                                                                           =
                                                                           =
   |                |
+| 1.28       | Update Version to 1.28                                     =
                                                                           =
                                                                           =
                                                                           =
 | March 2018     |
+|            | Update Skuid value to support Hex number                   =
                                                                           =
                                                                           =
                                                                           =
 |                |
+|            | Add flexible PCD value format into spec                    =
                                                                           =
                                                                           =
                                                                           =
 |                |
+|            | Add syntax to support SKU ID inherit from another SKU ID   =
                                                                           =
                                                                           =
                                                                           =
 |                |
+|            | Add DefaultStores section to describe the default setting  =
                                                                           =
                                                                           =
                                                                           =
 |                |
+|            | Add structure PCD field value assignment syntax            =
                                                                           =
                                                                           =
                                                                           =
 |                |
diff --git a/SUMMARY.md b/SUMMARY.md
index 873a52b..980589b 100644
--- a/SUMMARY.md
+++ b/SUMMARY.md
@@ -61,10 +61,11 @@
   * [3.8 [Libraries] Sections](3_edk_ii_dsc_file_format/38_[libraries]_sec=
tions.md#38-libraries-sections)
   * [3.9 [LibraryClasses] Sections](3_edk_ii_dsc_file_format/39_[librarycl=
asses]_sections.md#39-libraryclasses-sections)
   * [3.10 PCD Sections](3_edk_ii_dsc_file_format/310_pcd_sections.md#310-p=
cd-sections)
   * [3.11 [Components] Sections](3_edk_ii_dsc_file_format/311_[components]=
_sections.md#311-components-sections)
   * [3.12 [UserExtensions] Sections](3_edk_ii_dsc_file_format/312_[userext=
ensions]_sections.md#312-userextensions-sections)
+  * [3.13 [DefaultStores] Sections](3_edk_ii_dsc_file_format/313_[defaults=
tores]_sections.md#313-defaultstores-sections)
 * [Appendix A Variables](appendix_a_variables.md#appendix-a-variables)
 * [Appendix B Sample EDK II DSC File](appendix_b_sample_edk_ii_dsc_file.md=
#appendix-b-sample-edk-ii-dsc-file)
 * [Appendix C Module Types](appendix_c_module_types.md#appendix-c-module-t=
ypes)
 * [Appendix D Vpd Data Files](appendix_d_vpd_data_files/README.md#appendix=
-d-vpd-data-files)
   * [D.1 EDK II Build System Output File Format](appendix_d_vpd_data_files=
/d1_edk_ii_build_system_output_file_format.md#d1-edk-ii-build-system-output=
-file-format)
diff --git a/appendix_b_sample_edk_ii_dsc_file.md b/appendix_b_sample_edk_i=
i_dsc_file.md
index fbde4a6..dc5e42e 100644
--- a/appendix_b_sample_edk_ii_dsc_file.md
+++ b/appendix_b_sample_edk_ii_dsc_file.md
@@ -1,9 +1,9 @@
 <!--- @file
   Appendix B Sample EDK II DSC File
=20
-  Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2006-2018, Intel Corporation. All rights reserved.<BR>
=20
   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 m=
et:
=20
@@ -70,11 +70,11 @@ DSC file is not permitted.
 ########################################################################
 [Defines]
   PLATFORM_NAME           =3D NT32
   PLATFORM_GUID           =3D EB216561-961F-47EE-9EF9-CA426EF547C2
   PLATFORM_VERSION        =3D 0.5
-  DSC_SPECIFICATION       =3D 0x0001001B
+  DSC_SPECIFICATION       =3D 0x0001001C
   OUTPUT_DIRECTORY        =3D Build/NT32
   SUPPORTED_ARCHITECTURES =3D IA32
   BUILD_TARGETS           =3D DEBUG|RELEASE
   SKUID_IDENTIFIER        =3D DEFAULT
   FLASH_DEFINITION        =3D Nt32Pkg/Nt32Pkg.fdf
--=20
2.6.1.windows.1

_______________________________________________
edk2-devel mailing list
edk2-devel@lists.01.org
https://lists.01.org/mailman/listinfo/edk2-devel