From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <liming.gao@intel.com>
Received-SPF: Pass (sender SPF authorized) identity=mailfrom;
 client-ip=134.134.136.20; helo=mga02.intel.com;
 envelope-from=liming.gao@intel.com; receiver=edk2-devel@lists.01.org 
Received: from mga02.intel.com (mga02.intel.com [134.134.136.20])
 (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 CABD421FB7D27
 for <edk2-devel@lists.01.org>; Tue,  3 Apr 2018 01:34:31 -0700 (PDT)
X-Amp-Result: SKIPPED(no attachment in message)
X-Amp-File-Uploaded: False
Received: from fmsmga007.fm.intel.com ([10.253.24.52])
 by orsmga101.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;
 03 Apr 2018 01:34:30 -0700
X-ExtLoop1: 1
X-IronPort-AV: E=Sophos;i="5.48,400,1517904000"; d="scan'208";a="29127183"
Received: from fmsmsx108.amr.corp.intel.com ([10.18.124.206])
 by fmsmga007.fm.intel.com with ESMTP; 03 Apr 2018 01:34:30 -0700
Received: from fmsmsx126.amr.corp.intel.com (10.18.125.43) by
 FMSMSX108.amr.corp.intel.com (10.18.124.206) with Microsoft SMTP Server (TLS)
 id 14.3.319.2; Tue, 3 Apr 2018 01:34:29 -0700
Received: from shsmsx151.ccr.corp.intel.com (10.239.6.50) by
 FMSMSX126.amr.corp.intel.com (10.18.125.43) with Microsoft SMTP Server (TLS)
 id 14.3.319.2; Tue, 3 Apr 2018 01:34:29 -0700
Received: from shsmsx104.ccr.corp.intel.com ([169.254.5.226]) by
 SHSMSX151.ccr.corp.intel.com ([169.254.3.108]) with mapi id 14.03.0319.002;
 Tue, 3 Apr 2018 16:34:26 +0800
From: "Gao, Liming" <liming.gao@intel.com>
To: "Zhu, Yonghong" <yonghong.zhu@intel.com>, "edk2-devel@lists.01.org"
 <edk2-devel@lists.01.org>
CC: "Kinney, Michael D" <michael.d.kinney@intel.com>, "Shaw, Kevin W"
 <kevin.w.shaw@intel.com>
Thread-Topic: [Patch] DEC spec: Update version to 1.27
Thread-Index: AQHTyxvpE3QGXhHOIUu3oMRU2chTVKPutumw
Date: Tue, 3 Apr 2018 08:34:25 +0000
Message-ID: <4A89E2EF3DFEDB4C8BFDE51014F606A14E1F1955@SHSMSX104.ccr.corp.intel.com>
References: <1522739869-18508-1-git-send-email-yonghong.zhu@intel.com>
 <1522739869-18508-2-git-send-email-yonghong.zhu@intel.com>
In-Reply-To: <1522739869-18508-2-git-send-email-yonghong.zhu@intel.com>
Accept-Language: en-US
X-MS-Has-Attach: 
X-MS-TNEF-Correlator: 
x-originating-ip: [10.239.127.40]
MIME-Version: 1.0
Subject: Re: [Patch] DEC 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 08:34:32 -0000
Content-Language: en-US
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable

Reviewed-by: Liming Gao <liming.gao@intel.com>

>-----Original Message-----
>From: Zhu, Yonghong
>Sent: Tuesday, April 03, 2018 3:18 PM
>To: edk2-devel@lists.01.org
>Cc: Gao, Liming <liming.gao@intel.com>; Kinney, Michael D
><michael.d.kinney@intel.com>; Shaw, Kevin W <kevin.w.shaw@intel.com>
>Subject: [Patch] DEC spec: Update version to 1.27
>
>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_dec_file_overview/24_[defines]_usage.md        |  4 ++--
> 3_edk_ii_dec_file_format/34_[defines]_section.md | 16 ++++++++--------
> README.md                                        |  5 ++++-
> 3 files changed, 14 insertions(+), 11 deletions(-)
>
>diff --git a/2_dec_file_overview/24_[defines]_usage.md
>b/2_dec_file_overview/24_[defines]_usage.md
>index fe97c25..c2f50f1 100644
>--- a/2_dec_file_overview/24_[defines]_usage.md
>+++ b/2_dec_file_overview/24_[defines]_usage.md
>@@ -1,9 +1,9 @@
> <!--- @file
>   2.4 [Defines] Usage
>
>-  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:
>
>@@ -64,11 +64,11 @@ The format for entries in this section is:
>
> The following is an example of this section.
>
> ```ini
> [Defines]
>-  DEC_SPECIFICATION =3D 0x0001001A
>+  DEC_SPECIFICATION =3D 0x0001001B
>   PACKAGE_NAME      =3D MdePkg
>   PACKAGE_GUID      =3D 1E73767F-8F52-4603-AEB4-F29B510B6766
>   PACKAGE_VERSION   =3D 1.02
>   PACKAGE_UNI_FILE  =3D MdePkg.uni
> ```
>diff --git a/3_edk_ii_dec_file_format/34_[defines]_section.md
>b/3_edk_ii_dec_file_format/34_[defines]_section.md
>index d249ab7..7a66743 100644
>--- a/3_edk_ii_dec_file_format/34_[defines]_section.md
>+++ b/3_edk_ii_dec_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,13 +38,13 @@ This section is required.
> This describes the `[Defines]` section, which is required in all DEC file=
s.
> This file is created during installation of a UEFI distribution package o=
r by
> the developer and is an input to the EDK II build tool parsing utilities.
> Elements may appear in any order within this section.
>
>-The code for this specification is `"0001001A`" and new versions of this
>-specification must increment the minor (001A) portion of the specificatio=
n
>-code. This value may also be specified as a decimal value, 1.26.
>+The code for this specification is `"0001001B`" and new versions of this
>+specification must increment the minor (001B) portion of the specificatio=
n
>+code. This value may also be specified as a decimal value, 1.27.
>
> Existing DEC files are not required to update the `DEC_SPECIFICATION`
>version
> value. This value may be used by tools to identify any new functionality
> introduced by this specification version.
>
>@@ -81,15 +81,15 @@ The `PACKAGE_NAME` value may be used for creating
>directories.
> This is a decimal number, and if not specified is assumed to be 0 Alpha
> characters are not permitted.
>
> **_SpecVer_**
>
>-For new DEC files, the version value must be set to 0x0001001A Tools that
>+For new DEC files, the version value must be set to 0x0001001B Tools that
> process this version of the DEC file can successfully process earlier ver=
sions
> of the DEC file (this is a backward compatible update). There is no
>requirement
> to change the value in existing DEC files if no other content changes. Th=
is may
>-also be specified as decimal value, 1.26.
>+also be specified as decimal value, 1.27.
>
> **_Filename_**
>
> Filenames listed in the `[Defines]` section must be relative to the direc=
tory
> the DEC file is in. Use of "..", "." and "../" in the directory path is n=
ot
>@@ -99,21 +99,21 @@ or .Uni.
>
> #### Example 1
>
> ```ini
> [DEFINES]
>-  DEC_SPECIFICATION =3D 0x0001001A
>+  DEC_SPECIFICATION =3D 0x0001001B
>   PACKAGE_NAME      =3D MdePkg
>   PACKAGE_GUID      =3D 1E73767F-8F52-4603-AEB4-F29B510B6766
>   PACKAGE_VERSION   =3D 1.06
>   PACKAGE_UNI_FILE  =3D MdePkg.uni
> ```
>
> #### Example 2
>
> ```ini
> [DEFINES]
>-  DEC_SPECIFICATION =3D 1.26
>+  DEC_SPECIFICATION =3D 1.27
>   PACKAGE_NAME      =3D IntelFspPkg
>   PACKAGE_GUID      =3D 444C6CDF-55BD-4744-8F74-AE98B003B955
>   PACKAGE_VERSION   =3D 0.1
> ```
>diff --git a/README.md b/README.md
>index 5eea1ad..bd076c0 100644
>--- a/README.md
>+++ b/README.md
>@@ -1,9 +1,9 @@
> <!--- @file
>   README.md for EDK II Package Declaration (DEC) File Format Specificatio=
n
>
>-  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:
>
>@@ -166,5 +166,8 @@ Copyright (c) 2007-2017, Intel Corporation. All rights
>reserved.
> |            | up a development environment).
>|                 |
> | 1.26       | Reformat for GitBook
>| April 2017      |
> |            | Updated `DEC_SPECIFICATION` to `0x0001001A` or `1.26`
>|                 |
> |            | [#465](https://bugzilla.tianocore.org/show_bug.cgi?id=3D46=
5) DEC
>spec: document private definitions                                        =
           |                 |
> |            | [#482](https://bugzilla.tianocore.org/show_bug.cgi?id=3D48=
2) DEC
>Spec: add clarification for [Ppis], [Guids], [Protocols], [Includes] Priva=
te
>support |                 |
>+| 1.27       | Update Version to 1.27
>| March 2018      |
>+|            | Add flexible PCD value format into spec
>|                 |
>+|            | Add structure PCD definition syntax
>|                 |
>--
>2.6.1.windows.1