From nobody Mon Apr 29 07:07:06 2024 Delivered-To: importer@patchew.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; Authentication-Results: mx.zoho.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: Received: from ml01.01.org (ml01.01.org [198.145.21.10]) by mx.zohomail.com with SMTPS id 1496445553687974.7399329132936; Fri, 2 Jun 2017 16:19:13 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id 3D6D821C8D635; Fri, 2 Jun 2017 16:18:06 -0700 (PDT) Received: from mga06.intel.com (mga06.intel.com [134.134.136.31]) (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 CB2ED21C8D62E for ; Fri, 2 Jun 2017 16:18:04 -0700 (PDT) Received: from fmsmga006.fm.intel.com ([10.253.24.20]) by orsmga104.jf.intel.com with ESMTP; 02 Jun 2017 16:19:07 -0700 Received: from mdkinney-mobl.amr.corp.intel.com ([10.254.95.242]) by fmsmga006.fm.intel.com with ESMTP; 02 Jun 2017 16:19:07 -0700 X-Original-To: edk2-devel@lists.01.org X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.39,287,1493708400"; d="scan'208";a="110327490" From: Michael Kinney To: edk2-devel@lists.01.org Date: Fri, 2 Jun 2017 16:19:04 -0700 Message-Id: <1496445544-48684-2-git-send-email-michael.d.kinney@intel.com> X-Mailer: git-send-email 2.6.3.windows.1 In-Reply-To: <1496445544-48684-1-git-send-email-michael.d.kinney@intel.com> References: <1496445544-48684-1-git-send-email-michael.d.kinney@intel.com> Subject: [edk2] [edk2-DscSpecification PATCH] Update the DSC_SPECIFICATION version to 0x0001001B or 1.27 X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.22 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Kevin W Shaw , Liming Gao MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Errors-To: edk2-devel-bounces@lists.01.org Sender: "edk2-devel" X-ZohoMail: RSF_4 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" https://bugzilla.tianocore.org/show_bug.cgi?id=3D584 Cc: Liming Gao Cc: Yonghong Zhu Cc: Kevin W Shaw Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Michael Kinney --- 2_dsc_overview/23_[defines]_section_processing.md | 4 ++-- 2_dsc_overview/README.md | 2 +- 3_edk_ii_dsc_file_format/35_[defines]_section.md | 8 ++++---- README.md | 3 ++- appendix_b_sample_edk_ii_dsc_file.md | 2 +- 5 files changed, 10 insertions(+), 9 deletions(-) diff --git a/2_dsc_overview/23_[defines]_section_processing.md b/2_dsc_over= view/23_[defines]_section_processing.md index f44ec57..96d02a0 100644 --- a/2_dsc_overview/23_[defines]_section_processing.md +++ b/2_dsc_overview/23_[defines]_section_processing.md @@ -95,8 +95,8 @@ item is required. =20 | Typical Tag Names | Required / Optional | Value = | Notes = = = = = | | ----------------------------- | ----------- | --------------------------= ------ | ------------------------------------------------------------------= ---------------------------------------------------------------------------= ---------------------------------------------------------------------------= ---------------------------------------------------------------------------= ---------------------------------------------------------------------------= ------------------------------------------------- | -| `DSC_SPECIFICATION` | Required | 0x0001001A or 1.26 = | This entry is required for all EDK II DSC files. The value, 0x0001= 001A matches the 1.26 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.26. = = = = = | +| `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. = = = = = | | `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 = = = = = | diff --git a/2_dsc_overview/README.md b/2_dsc_overview/README.md index ddd01a5..a8cfa48 100644 --- a/2_dsc_overview/README.md +++ b/2_dsc_overview/README.md @@ -50,7 +50,7 @@ methods). EDK II DSC files are a list of: 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 0x0001001A` in the `[Defines]` section. Older DSC f= iles +`DSC_SPECIFICATION =3D 0x0001001B` 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 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 3ac6847..fa6ee60 100644 --- a/3_edk_ii_dsc_file_format/35_[defines]_section.md +++ b/3_edk_ii_dsc_file_format/35_[defines]_section.md @@ -72,7 +72,7 @@ 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 0x0001001A` in this sec= tion. +must include the statement: `DSC_SPECIFICATION =3D 0x0001001B` 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. @@ -155,10 +155,10 @@ Code> ::=3D ISO 639-2 Format Language code **_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 0x0001001A value is use= d. +defined in this specification must ensure that the 0x0001001B 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.26. +This value may also be specified as a decimal value of 1.27. =20 **_SkuUiName_** =20 @@ -213,7 +213,7 @@ DSC file, or it can be absolute, as well as relative to= the WORKSPACE . PLATFORM_NAME =3D NT32 PLATFORM_GUID =3D EB216561-961F-47EE-9EF9-CA426EF547C2 PLATFORM_VERSION =3D 0.3 - DSC_SPECIFICATION =3D 0x0001001A + DSC_SPECIFICATION =3D 0x0001001B OUTPUT_DIRECTORY =3D Build/Nt32 SUPPORTED_ARCHITECTURES =3D IA32 BUILD_TARGETS =3D DEBUG|RELEASE diff --git a/README.md b/README.md index 5e2c17a..6d91eda 100644 --- a/README.md +++ b/README.md @@ -176,9 +176,10 @@ Copyright (c) 2006-2017, Intel Corporation. All rights= reserved. | | Update the DSC_SPECIFICATION version to 0x0001001A = = = = | | | | 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). = | | | | Added new system environment variables used by the build sy= stem. = = = | | -| 1.27 | Convert to GitBooks = = = = | May 2017 | +| 1.27 | Convert to GitBooks = = = = | June 2017 | | | [#351](https://bugzilla.tianocore.org/show_bug.cgi?id=3D351= ) [DSC Spec] Extend macro usage in the !include statement = = = | | | | [#484](https://bugzilla.tianocore.org/show_bug.cgi?id=3D484= ) DSC spec: support Prebuild and Postbuild in the [Defines] section = = = | | | | [#353](https://bugzilla.tianocore.org/show_bug.cgi?id=3D353= ) Build spec: Allow nested includes in DSC and FDF files = = = | | | | [#521](https://bugzilla.tianocore.org/show_bug.cgi?id=3D521= ) DSC spec: add clarification for mixed PCD usage in the DSC spec = = = | | | | [#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 = = = | | diff --git a/appendix_b_sample_edk_ii_dsc_file.md b/appendix_b_sample_edk_i= i_dsc_file.md index 6880d1d..fbde4a6 100644 --- a/appendix_b_sample_edk_ii_dsc_file.md +++ b/appendix_b_sample_edk_ii_dsc_file.md @@ -72,7 +72,7 @@ DSC file is not permitted. PLATFORM_NAME =3D NT32 PLATFORM_GUID =3D EB216561-961F-47EE-9EF9-CA426EF547C2 PLATFORM_VERSION =3D 0.5 - DSC_SPECIFICATION =3D 0x0001001A + DSC_SPECIFICATION =3D 0x0001001B OUTPUT_DIRECTORY =3D Build/NT32 SUPPORTED_ARCHITECTURES =3D IA32 BUILD_TARGETS =3D DEBUG|RELEASE --=20 2.6.3.windows.1 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel