From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: 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 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.39,287,1493708400"; d="scan'208";a="110327490" 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 From: Michael Kinney To: edk2-devel@lists.01.org Cc: Liming Gao , Yonghong Zhu , Kevin W Shaw 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-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: , X-List-Received-Date: Fri, 02 Jun 2017 23:18:05 -0000 https://bugzilla.tianocore.org/show_bug.cgi?id=584 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_overview/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. | 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, 0x0001001A matches the 1.26 version of this specification. Build tools must continue to support DSC files that correspond to earlier versions of the document until such time as earlier versions are no longer in use. In order to maintain backward compatibility, this value must only be updated in existing DSC 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, 0x0001001B matches the 1.27 version of this specification. Build tools must continue to support DSC files that correspond to earlier versions of the document until such time as earlier versions are no longer in use. In order to maintain backward compatibility, this value must only be updated in existing DSC 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 identify a platform file. It is recommended that minor changes to the file increment the PLATFORM_VERSION value, and that the GUID value change for completely new platforms. | | `PLATFORM_VERSION` | Required | Integer or Decimal Number | The Version value, along the PLATFORM_GUID, is used to uniquely identify a platform file. It is recommended that minor changes to the file increment the PLATFORM_VERSION value, and that the GUID value change for completely 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. DSC files that use any new features must use the new -`DSC_SPECIFICATION = 0x0001001A` in the `[Defines]` section. Older DSC files +`DSC_SPECIFICATION = 0x0001001B` in the `[Defines]` section. Older DSC files that do not use any of these features do not need to update the `DSC_SPECIFICATION` value. diff --git a/3_edk_ii_dsc_file_format/35_[defines]_section.md b/3_edk_ii_dsc_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. ********** This revision of specification does not add new features. New EDK II DSC files -must include the statement: `DSC_SPECIFICATION = 0x0001001A` in this section. +must include the statement: `DSC_SPECIFICATION = 0x0001001B` in this section. Existing DSC files do not need to update the value. Individual items must appear on a single line, they may not span multiple lines. @@ -155,10 +155,10 @@ Code> ::= ISO 639-2 Format Language code **_SpecVal_** 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 used. +defined in this specification must ensure that the 0x0001001B value is used. The EDK II build system must maintain backward compatibility, therefore, there 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. **_SkuUiName_** @@ -213,7 +213,7 @@ DSC file, or it can be absolute, as well as relative to the WORKSPACE . PLATFORM_NAME = NT32 PLATFORM_GUID = EB216561-961F-47EE-9EF9-CA426EF547C2 PLATFORM_VERSION = 0.3 - DSC_SPECIFICATION = 0x0001001A + DSC_SPECIFICATION = 0x0001001B OUTPUT_DIRECTORY = Build/Nt32 SUPPORTED_ARCHITECTURES = IA32 BUILD_TARGETS = 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 system. | | -| 1.27 | Convert to GitBooks | May 2017 | +| 1.27 | Convert to GitBooks | June 2017 | | | [#351](https://bugzilla.tianocore.org/show_bug.cgi?id=351) [DSC Spec] Extend macro usage in the !include statement | | | | [#484](https://bugzilla.tianocore.org/show_bug.cgi?id=484) DSC spec: support Prebuild and Postbuild in the [Defines] section | | | | [#353](https://bugzilla.tianocore.org/show_bug.cgi?id=353) Build spec: Allow nested includes in DSC and FDF files | | | | [#521](https://bugzilla.tianocore.org/show_bug.cgi?id=521) DSC spec: add clarification for mixed PCD usage in the DSC spec | | | | [#519](https://bugzilla.tianocore.org/show_bug.cgi?id=519) DSC Spec: update Precedence of PCD Values | | +| | [#584](https://bugzilla.tianocore.org/show_bug.cgi?id=584) 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_ii_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 = NT32 PLATFORM_GUID = EB216561-961F-47EE-9EF9-CA426EF547C2 PLATFORM_VERSION = 0.5 - DSC_SPECIFICATION = 0x0001001A + DSC_SPECIFICATION = 0x0001001B OUTPUT_DIRECTORY = Build/NT32 SUPPORTED_ARCHITECTURES = IA32 BUILD_TARGETS = DEBUG|RELEASE -- 2.6.3.windows.1