* [Patch] DEC spec: Update version to 1.27
2018-04-03 7:17 [Patch] Build Spec: Update Version to 1.28 Yonghong Zhu
@ 2018-04-03 7:17 ` Yonghong Zhu
2018-04-03 8:34 ` Gao, Liming
2018-04-03 7:17 ` [Patch] DSC spec: Update version to 1.28 Yonghong Zhu
` (5 subsequent siblings)
6 siblings, 1 reply; 16+ messages in thread
From: Yonghong Zhu @ 2018-04-03 7:17 UTC (permalink / raw)
To: edk2-devel; +Cc: Liming Gao, Michael Kinney, Kevin W Shaw
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 = 0x0001001A
+ DEC_SPECIFICATION = 0x0001001B
PACKAGE_NAME = MdePkg
PACKAGE_GUID = 1E73767F-8F52-4603-AEB4-F29B510B6766
PACKAGE_VERSION = 1.02
PACKAGE_UNI_FILE = 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 files.
This file is created during installation of a UEFI distribution package or 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 specification
-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 specification
+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 versions
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. This 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 directory
the DEC file is in. Use of "..", "." and "../" in the directory path is not
@@ -99,21 +99,21 @@ or .Uni.
#### Example 1
```ini
[DEFINES]
- DEC_SPECIFICATION = 0x0001001A
+ DEC_SPECIFICATION = 0x0001001B
PACKAGE_NAME = MdePkg
PACKAGE_GUID = 1E73767F-8F52-4603-AEB4-F29B510B6766
PACKAGE_VERSION = 1.06
PACKAGE_UNI_FILE = MdePkg.uni
```
#### Example 2
```ini
[DEFINES]
- DEC_SPECIFICATION = 1.26
+ DEC_SPECIFICATION = 1.27
PACKAGE_NAME = IntelFspPkg
PACKAGE_GUID = 444C6CDF-55BD-4744-8F74-AE98B003B955
PACKAGE_VERSION = 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 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:
@@ -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=465) DEC spec: document private definitions | |
| | [#482](https://bugzilla.tianocore.org/show_bug.cgi?id=482) DEC Spec: add clarification for [Ppis], [Guids], [Protocols], [Includes] Private 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
^ permalink raw reply related [flat|nested] 16+ messages in thread* Re: [Patch] DEC spec: Update version to 1.27
2018-04-03 7:17 ` [Patch] DEC spec: Update version to 1.27 Yonghong Zhu
@ 2018-04-03 8:34 ` Gao, Liming
0 siblings, 0 replies; 16+ messages in thread
From: Gao, Liming @ 2018-04-03 8:34 UTC (permalink / raw)
To: Zhu, Yonghong, edk2-devel@lists.01.org; +Cc: Kinney, Michael D, Shaw, Kevin W
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 = 0x0001001A
>+ DEC_SPECIFICATION = 0x0001001B
> PACKAGE_NAME = MdePkg
> PACKAGE_GUID = 1E73767F-8F52-4603-AEB4-F29B510B6766
> PACKAGE_VERSION = 1.02
> PACKAGE_UNI_FILE = 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 files.
> This file is created during installation of a UEFI distribution package or 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 specification
>-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 specification
>+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 versions
> 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. This 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 directory
> the DEC file is in. Use of "..", "." and "../" in the directory path is not
>@@ -99,21 +99,21 @@ or .Uni.
>
> #### Example 1
>
> ```ini
> [DEFINES]
>- DEC_SPECIFICATION = 0x0001001A
>+ DEC_SPECIFICATION = 0x0001001B
> PACKAGE_NAME = MdePkg
> PACKAGE_GUID = 1E73767F-8F52-4603-AEB4-F29B510B6766
> PACKAGE_VERSION = 1.06
> PACKAGE_UNI_FILE = MdePkg.uni
> ```
>
> #### Example 2
>
> ```ini
> [DEFINES]
>- DEC_SPECIFICATION = 1.26
>+ DEC_SPECIFICATION = 1.27
> PACKAGE_NAME = IntelFspPkg
> PACKAGE_GUID = 444C6CDF-55BD-4744-8F74-AE98B003B955
> PACKAGE_VERSION = 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 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:
>
>@@ -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=465) DEC
>spec: document private definitions | |
> | | [#482](https://bugzilla.tianocore.org/show_bug.cgi?id=482) DEC
>Spec: add clarification for [Ppis], [Guids], [Protocols], [Includes] Private
>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
^ permalink raw reply [flat|nested] 16+ messages in thread
* [Patch] DSC spec: Update version to 1.28
2018-04-03 7:17 [Patch] Build Spec: Update Version to 1.28 Yonghong Zhu
2018-04-03 7:17 ` [Patch] DEC spec: Update version to 1.27 Yonghong Zhu
@ 2018-04-03 7:17 ` Yonghong Zhu
2018-04-03 8:34 ` Gao, Liming
2018-04-03 7:17 ` [Patch] edk2-VfrSpecification: update version to 1.92 Yonghong Zhu
` (4 subsequent siblings)
6 siblings, 1 reply; 16+ messages in thread
From: Yonghong Zhu @ 2018-04-03 7:17 UTC (permalink / raw)
To: edk2-devel; +Cc: Liming Gao, Michael Kinney, Kevin W Shaw
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_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_overview/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
- Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
+ Copyright (c) 2006-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:
@@ -97,12 +97,12 @@ item is required.
###### Table 6 EDK II [Defines] Section Elements
| 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, 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. |
+| `DSC_SPECIFICATION` | Required | 0x0001001C or 1.28 | This entry is required for all EDK II DSC files. The value, 0x0001001C matches the 1.28 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.28. |
| `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 |
| `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>|</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
- Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
+ Copyright (c) 2006-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:
@@ -48,11 +48,11 @@ methods). EDK II DSC files are a list of:
* EDK II PCD Entries
There are no new features or format introduced in this specification.
DSC files that use any new features must use the new
-`DSC_SPECIFICATION = 0x0001001B` in the `[Defines]` section. Older DSC files
+`DSC_SPECIFICATION = 0x0001001C` in the `[Defines]` section. Older DSC files
that do not use any of these features do not need to update the
`DSC_SPECIFICATION` value.
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_dsc_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
- Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
+ Copyright (c) 2006-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:
@@ -70,11 +70,11 @@ other meta-data files.
**Note:** Assignments of variables in other sections take precedence over
global assignments.
**********
This revision of specification does not add new features. New EDK II DSC files
-must include the statement: `DSC_SPECIFICATION = 0x0001001B` in this section.
+must include the statement: `DSC_SPECIFICATION = 0x0001001C` 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.
Of special note is the `FLASH_DEFINITION` file name. Unlike other file names in
@@ -155,14 +155,14 @@ Code> ::= ISO 639-2 Format Language code
#### Parameters
**_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 0x0001001B value is used.
+defined in this specification must ensure that the 0x0001001C 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.27.
+This value may also be specified as a decimal value of 1.28.
**_SkuUiName_**
If specified, the image created from the DSC/FDF file pair will only be valid
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 = NT32
PLATFORM_GUID = EB216561-961F-47EE-9EF9-CA426EF547C2
PLATFORM_VERSION = 0.3
- DSC_SPECIFICATION = 0x0001001B
+ DSC_SPECIFICATION = 0x0001001C
OUTPUT_DIRECTORY = Build/Nt32
SUPPORTED_ARCHITECTURES = IA32
BUILD_TARGETS = DEBUG|RELEASE
RFC_LANGUAGES = "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
- Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
+ Copyright (c) 2006-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:
@@ -184,5 +184,11 @@ Copyright (c) 2006-2017, Intel Corporation. All rights reserved.
| | [#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 | |
| | [#645](https://bugzilla.tianocore.org/show_bug.cgi?id=645) DSC Spec: Remove Restriction on Using NULL in [LibraryClasses] Section | |
| | [#669](https://bugzilla.tianocore.org/show_bug.cgi?id=669) DSC Spec: Add multi-arg support to PREBUILD/POSTBUILD | |
| | [#597](https://bugzilla.tianocore.org/show_bug.cgi?id=597) 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]_sections.md#38-libraries-sections)
* [3.9 [LibraryClasses] Sections](3_edk_ii_dsc_file_format/39_[libraryclasses]_sections.md#39-libraryclasses-sections)
* [3.10 PCD Sections](3_edk_ii_dsc_file_format/310_pcd_sections.md#310-pcd-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_[userextensions]_sections.md#312-userextensions-sections)
+ * [3.13 [DefaultStores] Sections](3_edk_ii_dsc_file_format/313_[defaultstores]_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-types)
* [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_ii_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
- Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
+ Copyright (c) 2006-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:
@@ -70,11 +70,11 @@ DSC file is not permitted.
########################################################################
[Defines]
PLATFORM_NAME = NT32
PLATFORM_GUID = EB216561-961F-47EE-9EF9-CA426EF547C2
PLATFORM_VERSION = 0.5
- DSC_SPECIFICATION = 0x0001001B
+ DSC_SPECIFICATION = 0x0001001C
OUTPUT_DIRECTORY = Build/NT32
SUPPORTED_ARCHITECTURES = IA32
BUILD_TARGETS = DEBUG|RELEASE
SKUID_IDENTIFIER = DEFAULT
FLASH_DEFINITION = Nt32Pkg/Nt32Pkg.fdf
--
2.6.1.windows.1
^ permalink raw reply related [flat|nested] 16+ messages in thread* Re: [Patch] DSC spec: Update version to 1.28
2018-04-03 7:17 ` [Patch] DSC spec: Update version to 1.28 Yonghong Zhu
@ 2018-04-03 8:34 ` Gao, Liming
0 siblings, 0 replies; 16+ messages in thread
From: Gao, Liming @ 2018-04-03 8:34 UTC (permalink / raw)
To: Zhu, Yonghong, edk2-devel@lists.01.org; +Cc: Kinney, Michael D, Shaw, Kevin W
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] DSC spec: Update version to 1.28
>
>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_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_overview/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
>
>- Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
>+ Copyright (c) 2006-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:
>
>@@ -97,12 +97,12 @@ item is required.
> ###### Table 6 EDK II [Defines] Section Elements
>
>
> | 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, 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.
>|
>+| `DSC_SPECIFICATION` | Required | 0x0001001C or 1.28 | This
>entry is required for all EDK II DSC files. The value, 0x0001001C matches the
>1.28 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.28.
>|
> | `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
>|
> | `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>|</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
>
>- Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
>+ Copyright (c) 2006-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:
>
>@@ -48,11 +48,11 @@ methods). EDK II DSC files are a list of:
> * EDK II PCD Entries
>
> There are no new features or format introduced in this specification.
>
> DSC files that use any new features must use the new
>-`DSC_SPECIFICATION = 0x0001001B` in the `[Defines]` section. Older DSC files
>+`DSC_SPECIFICATION = 0x0001001C` in the `[Defines]` section. Older DSC files
> that do not use any of these features do not need to update the
> `DSC_SPECIFICATION` value.
>
> 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_dsc_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
>
>- Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
>+ Copyright (c) 2006-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:
>
>@@ -70,11 +70,11 @@ other meta-data files.
> **Note:** Assignments of variables in other sections take precedence over
> global assignments.
> **********
>
> This revision of specification does not add new features. New EDK II DSC files
>-must include the statement: `DSC_SPECIFICATION = 0x0001001B` in this
>section.
>+must include the statement: `DSC_SPECIFICATION = 0x0001001C` 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.
>
> Of special note is the `FLASH_DEFINITION` file name. Unlike other file names
>in
>@@ -155,14 +155,14 @@ Code> ::= ISO 639-2 Format Language code
> #### Parameters
>
> **_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 0x0001001B value is used.
>+defined in this specification must ensure that the 0x0001001C 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.27.
>+This value may also be specified as a decimal value of 1.28.
>
> **_SkuUiName_**
>
> If specified, the image created from the DSC/FDF file pair will only be valid
> 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 = NT32
> PLATFORM_GUID = EB216561-961F-47EE-9EF9-CA426EF547C2
> PLATFORM_VERSION = 0.3
>- DSC_SPECIFICATION = 0x0001001B
>+ DSC_SPECIFICATION = 0x0001001C
> OUTPUT_DIRECTORY = Build/Nt32
> SUPPORTED_ARCHITECTURES = IA32
> BUILD_TARGETS = DEBUG|RELEASE
> RFC_LANGUAGES = "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
>
>- Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
>+ Copyright (c) 2006-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:
>
>@@ -184,5 +184,11 @@ Copyright (c) 2006-2017, Intel Corporation. All rights
>reserved.
> | | [#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
>| |
> | | [#645](https://bugzilla.tianocore.org/show_bug.cgi?id=645) DSC
>Spec: Remove Restriction on Using NULL in [LibraryClasses] Section
>| |
> | | [#669](https://bugzilla.tianocore.org/show_bug.cgi?id=669) DSC
>Spec: Add multi-arg support to PREBUILD/POSTBUILD
>| |
> | | [#597](https://bugzilla.tianocore.org/show_bug.cgi?id=597) 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]_sections.md#38-libraries-
>sections)
> * [3.9 [LibraryClasses]
>Sections](3_edk_ii_dsc_file_format/39_[libraryclasses]_sections.md#39-
>libraryclasses-sections)
> * [3.10 PCD Sections](3_edk_ii_dsc_file_format/310_pcd_sections.md#310-
>pcd-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_[userextensions]_sections.md#312-
>userextensions-sections)
>+ * [3.13 [DefaultStores]
>Sections](3_edk_ii_dsc_file_format/313_[defaultstores]_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-types)
> * [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_f
>ormat.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_ii_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
>
>- Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
>+ Copyright (c) 2006-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:
>
>@@ -70,11 +70,11 @@ DSC file is not permitted.
>
>###########################################################
>#############
> [Defines]
> PLATFORM_NAME = NT32
> PLATFORM_GUID = EB216561-961F-47EE-9EF9-CA426EF547C2
> PLATFORM_VERSION = 0.5
>- DSC_SPECIFICATION = 0x0001001B
>+ DSC_SPECIFICATION = 0x0001001C
> OUTPUT_DIRECTORY = Build/NT32
> SUPPORTED_ARCHITECTURES = IA32
> BUILD_TARGETS = DEBUG|RELEASE
> SKUID_IDENTIFIER = DEFAULT
> FLASH_DEFINITION = Nt32Pkg/Nt32Pkg.fdf
>--
>2.6.1.windows.1
^ permalink raw reply [flat|nested] 16+ messages in thread
* [Patch] edk2-VfrSpecification: update version to 1.92
2018-04-03 7:17 [Patch] Build Spec: Update Version to 1.28 Yonghong Zhu
2018-04-03 7:17 ` [Patch] DEC spec: Update version to 1.27 Yonghong Zhu
2018-04-03 7:17 ` [Patch] DSC spec: Update version to 1.28 Yonghong Zhu
@ 2018-04-03 7:17 ` Yonghong Zhu
2018-04-03 8:27 ` Gao, Liming
2018-04-03 7:17 ` [Patch] Expression spec: update version to 1.3 Yonghong Zhu
` (3 subsequent siblings)
6 siblings, 1 reply; 16+ messages in thread
From: Yonghong Zhu @ 2018-04-03 7:17 UTC (permalink / raw)
To: edk2-devel; +Cc: Liming Gao, Michael Kinney, Kevin W Shaw
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>
---
README.md | 7 ++++---
1 file changed, 4 insertions(+), 3 deletions(-)
diff --git a/README.md b/README.md
index 0a596eb..3c40cab 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,9 @@
<!--- @file
README.md for EDK II VFR Programming Language 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:
@@ -70,11 +70,11 @@ PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-Copyright (c) 2007-2017, Intel Corporation. All rights reserved.
+Copyright (c) 2007-2018, Intel Corporation. All rights reserved.
### Revision History
| Revision | Revision History | Date |
@@ -89,6 +89,7 @@ Copyright (c) 2007-2017, Intel Corporation. All rights reserved.
| 1.60 | Update syntax for goto, image, questionref and constant value opcodes, correct CALLBACK flag to INTEREACTIVE, correct help string for old syntax date/time example, and add examples for expression opcodes. | December 1, 2011 |
| 1.70 | Clarify restriction that enum type and struct data filed with more than one dimensions array are not supported. | May 18, 2012 |
| 1.80 | Add syntax for warningif opcode, update definition for name/value varstore and subtitle opcode, update referenced UEFI spec version info. | Jan 14, 2014 |
| 1.90 | Correct sample code for catenate/match/cond opcode. Add syntax for match2 opcode. Add sample code to show the buffer type constant value for orderedlist opcode and default opcode. | July 2, 2015 |
| 1.91 | Convert to Gitbook | April 2017 |
-| | [#683](https://bugzilla.tianocore.org/show_bug.cgi?id=683) VFR Spec: Add union data type and bit fields in VFR Data Struct Definition | |
+| 1.92 | [#683](https://bugzilla.tianocore.org/show_bug.cgi?id=683) VFR Spec: Add union data type and bit fields in VFR Data Struct Definition | March 2018 |
+
--
2.6.1.windows.1
^ permalink raw reply related [flat|nested] 16+ messages in thread* Re: [Patch] edk2-VfrSpecification: update version to 1.92
2018-04-03 7:17 ` [Patch] edk2-VfrSpecification: update version to 1.92 Yonghong Zhu
@ 2018-04-03 8:27 ` Gao, Liming
2018-04-03 8:29 ` Zhu, Yonghong
0 siblings, 1 reply; 16+ messages in thread
From: Gao, Liming @ 2018-04-03 8:27 UTC (permalink / raw)
To: Zhu, Yonghong, edk2-devel@lists.01.org; +Cc: Kinney, Michael D, Shaw, Kevin W
What change is here?
>-----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] edk2-VfrSpecification: update version to 1.92
>
>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>
>---
> README.md | 7 ++++---
> 1 file changed, 4 insertions(+), 3 deletions(-)
>
>diff --git a/README.md b/README.md
>index 0a596eb..3c40cab 100644
>--- a/README.md
>+++ b/README.md
>@@ -1,9 +1,9 @@
> <!--- @file
> README.md for EDK II VFR Programming Language 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:
>
>@@ -70,11 +70,11 @@ PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
>LOSS OF USE, DATA, OR PROFITS;
> OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
>LIABILITY,
> WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
>NEGLIGENCE OR
> OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
>DOCUMENTATION, EVEN IF
> ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
>
>-Copyright (c) 2007-2017, Intel Corporation. All rights reserved.
>+Copyright (c) 2007-2018, Intel Corporation. All rights reserved.
>
>
> ### Revision History
>
> | Revision | Revision History
>| Date |
>@@ -89,6 +89,7 @@ Copyright (c) 2007-2017, Intel Corporation. All rights
>reserved.
> | 1.60 | Update syntax for goto, image, questionref and constant value
>opcodes, correct CALLBACK flag to INTEREACTIVE, correct help string for old
>syntax date/time example, and add examples for expression opcodes. |
>December 1, 2011 |
> | 1.70 | Clarify restriction that enum type and struct data filed with more
>than one dimensions array are not supported.
>| May 18, 2012 |
> | 1.80 | Add syntax for warningif opcode, update definition for name/value
>varstore and subtitle opcode, update referenced UEFI spec version info.
>| Jan 14, 2014 |
> | 1.90 | Correct sample code for catenate/match/cond opcode. Add syntax
>for match2 opcode. Add sample code to show the buffer type constant value
>for orderedlist opcode and default opcode. | July 2, 2015 |
> | 1.91 | Convert to Gitbook
>| April 2017 |
>-| | [#683](https://bugzilla.tianocore.org/show_bug.cgi?id=683) VFR Spec:
>Add union data type and bit fields in VFR Data Struct Definition
>| |
>+| 1.92 | [#683](https://bugzilla.tianocore.org/show_bug.cgi?id=683) VFR
>Spec: Add union data type and bit fields in VFR Data Struct Definition
>| March 2018 |
>+
>--
>2.6.1.windows.1
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: [Patch] edk2-VfrSpecification: update version to 1.92
2018-04-03 8:27 ` Gao, Liming
@ 2018-04-03 8:29 ` Zhu, Yonghong
2018-04-03 8:34 ` Gao, Liming
0 siblings, 1 reply; 16+ messages in thread
From: Zhu, Yonghong @ 2018-04-03 8:29 UTC (permalink / raw)
To: Gao, Liming, edk2-devel@lists.01.org
Cc: Kinney, Michael D, Shaw, Kevin W, Zhu, Yonghong
Add the 1.92 version info in Revision History.
Best Regards,
Zhu Yonghong
-----Original Message-----
From: Gao, Liming
Sent: Tuesday, April 3, 2018 4:28 PM
To: Zhu, Yonghong <yonghong.zhu@intel.com>; edk2-devel@lists.01.org
Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Shaw, Kevin W <kevin.w.shaw@intel.com>
Subject: RE: [Patch] edk2-VfrSpecification: update version to 1.92
What change is here?
>-----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] edk2-VfrSpecification: update version to 1.92
>
>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>
>---
> README.md | 7 ++++---
> 1 file changed, 4 insertions(+), 3 deletions(-)
>
>diff --git a/README.md b/README.md
>index 0a596eb..3c40cab 100644
>--- a/README.md
>+++ b/README.md
>@@ -1,9 +1,9 @@
> <!--- @file
> README.md for EDK II VFR Programming Language 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:
>
>@@ -70,11 +70,11 @@ PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
>OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
>ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
>TORT (INCLUDING NEGLIGENCE OR
> OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS DOCUMENTATION,
>EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
>
>-Copyright (c) 2007-2017, Intel Corporation. All rights reserved.
>+Copyright (c) 2007-2018, Intel Corporation. All rights reserved.
>
>
> ### Revision History
>
> | Revision | Revision History
>| Date |
>@@ -89,6 +89,7 @@ Copyright (c) 2007-2017, Intel Corporation. All
>rights reserved.
> | 1.60 | Update syntax for goto, image, questionref and constant value
>opcodes, correct CALLBACK flag to INTEREACTIVE, correct help string for old
>syntax date/time example, and add examples for expression opcodes. |
>December 1, 2011 |
> | 1.70 | Clarify restriction that enum type and struct data filed with more
>than one dimensions array are not supported.
>| May 18, 2012 |
> | 1.80 | Add syntax for warningif opcode, update definition for name/value
>varstore and subtitle opcode, update referenced UEFI spec version info.
>| Jan 14, 2014 |
> | 1.90 | Correct sample code for catenate/match/cond opcode. Add syntax
>for match2 opcode. Add sample code to show the buffer type constant value
>for orderedlist opcode and default opcode. | July 2, 2015 |
> | 1.91 | Convert to Gitbook
>| April 2017 |
>-| | [#683](https://bugzilla.tianocore.org/show_bug.cgi?id=683) VFR Spec:
>Add union data type and bit fields in VFR Data Struct Definition
>| |
>+| 1.92 | [#683](https://bugzilla.tianocore.org/show_bug.cgi?id=683) VFR
>Spec: Add union data type and bit fields in VFR Data Struct Definition
>| March 2018 |
>+
>--
>2.6.1.windows.1
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: [Patch] edk2-VfrSpecification: update version to 1.92
2018-04-03 8:29 ` Zhu, Yonghong
@ 2018-04-03 8:34 ` Gao, Liming
0 siblings, 0 replies; 16+ messages in thread
From: Gao, Liming @ 2018-04-03 8:34 UTC (permalink / raw)
To: Zhu, Yonghong, edk2-devel@lists.01.org; +Cc: Kinney, Michael D, Shaw, Kevin W
Got it. Reviewed-by: Liming Gao <liming.gao@intel.com>
>-----Original Message-----
>From: Zhu, Yonghong
>Sent: Tuesday, April 03, 2018 4:29 PM
>To: Gao, Liming <liming.gao@intel.com>; edk2-devel@lists.01.org
>Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Shaw, Kevin W
><kevin.w.shaw@intel.com>; Zhu, Yonghong <yonghong.zhu@intel.com>
>Subject: RE: [Patch] edk2-VfrSpecification: update version to 1.92
>
>Add the 1.92 version info in Revision History.
>
>Best Regards,
>Zhu Yonghong
>
>-----Original Message-----
>From: Gao, Liming
>Sent: Tuesday, April 3, 2018 4:28 PM
>To: Zhu, Yonghong <yonghong.zhu@intel.com>; edk2-devel@lists.01.org
>Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Shaw, Kevin W
><kevin.w.shaw@intel.com>
>Subject: RE: [Patch] edk2-VfrSpecification: update version to 1.92
>
>What change is here?
>
>>-----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] edk2-VfrSpecification: update version to 1.92
>>
>>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>
>>---
>> README.md | 7 ++++---
>> 1 file changed, 4 insertions(+), 3 deletions(-)
>>
>>diff --git a/README.md b/README.md
>>index 0a596eb..3c40cab 100644
>>--- a/README.md
>>+++ b/README.md
>>@@ -1,9 +1,9 @@
>> <!--- @file
>> README.md for EDK II VFR Programming Language 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:
>>
>>@@ -70,11 +70,11 @@ PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
>LOSS
>>OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
>CAUSED AND
>>ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
>>TORT (INCLUDING NEGLIGENCE OR
>> OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
>DOCUMENTATION,
>>EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
>>
>>-Copyright (c) 2007-2017, Intel Corporation. All rights reserved.
>>+Copyright (c) 2007-2018, Intel Corporation. All rights reserved.
>>
>>
>> ### Revision History
>>
>> | Revision | Revision History
>>| Date |
>>@@ -89,6 +89,7 @@ Copyright (c) 2007-2017, Intel Corporation. All
>>rights reserved.
>> | 1.60 | Update syntax for goto, image, questionref and constant value
>>opcodes, correct CALLBACK flag to INTEREACTIVE, correct help string for old
>>syntax date/time example, and add examples for expression opcodes. |
>>December 1, 2011 |
>> | 1.70 | Clarify restriction that enum type and struct data filed with more
>>than one dimensions array are not supported.
>>| May 18, 2012 |
>> | 1.80 | Add syntax for warningif opcode, update definition for
>name/value
>>varstore and subtitle opcode, update referenced UEFI spec version info.
>>| Jan 14, 2014 |
>> | 1.90 | Correct sample code for catenate/match/cond opcode. Add
>syntax
>>for match2 opcode. Add sample code to show the buffer type constant value
>>for orderedlist opcode and default opcode. | July 2, 2015 |
>> | 1.91 | Convert to Gitbook
>>| April 2017 |
>>-| | [#683](https://bugzilla.tianocore.org/show_bug.cgi?id=683) VFR
>Spec:
>>Add union data type and bit fields in VFR Data Struct Definition
>>| |
>>+| 1.92 | [#683](https://bugzilla.tianocore.org/show_bug.cgi?id=683) VFR
>>Spec: Add union data type and bit fields in VFR Data Struct Definition
>>| March 2018 |
>>+
>>--
>>2.6.1.windows.1
^ permalink raw reply [flat|nested] 16+ messages in thread
* [Patch] Expression spec: update version to 1.3
2018-04-03 7:17 [Patch] Build Spec: Update Version to 1.28 Yonghong Zhu
` (2 preceding siblings ...)
2018-04-03 7:17 ` [Patch] edk2-VfrSpecification: update version to 1.92 Yonghong Zhu
@ 2018-04-03 7:17 ` Yonghong Zhu
2018-04-03 8:34 ` Gao, Liming
2018-04-03 7:17 ` [Patch] FDF spec: Update version to 1.28 Yonghong Zhu
` (2 subsequent siblings)
6 siblings, 1 reply; 16+ messages in thread
From: Yonghong Zhu @ 2018-04-03 7:17 UTC (permalink / raw)
To: edk2-devel; +Cc: Liming Gao, Michael Kinney, Kevin W Shaw
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>
---
README.md | 5 +++--
1 file changed, 3 insertions(+), 2 deletions(-)
diff --git a/README.md b/README.md
index 60086a9..ae725ca 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,9 @@
<!--- @file
README.md for EDK II Meta-Data Expression Syntax Specification
- Copyright (c) 2014-2017, Intel Corporation. All rights reserved.<BR>
+ Copyright (c) 2014-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:
@@ -70,15 +70,16 @@ PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-Copyright (c) 2014-2017, Intel Corporation. All rights reserved.
+Copyright (c) 2014-2018, Intel Corporation. All rights reserved.
### Revision History
| Revision | Revision History | Date |
| ---------- | ------------------ | -------------- |
| 1.0 | Initial Release | September 2014 |
| 1.1 | | September 2014 |
| 1.2 | Convert to Gitbook | April 2017 |
+| 1.3 | Flexible Pcd format| March 2018 |
--
2.6.1.windows.1
^ permalink raw reply related [flat|nested] 16+ messages in thread* Re: [Patch] Expression spec: update version to 1.3
2018-04-03 7:17 ` [Patch] Expression spec: update version to 1.3 Yonghong Zhu
@ 2018-04-03 8:34 ` Gao, Liming
0 siblings, 0 replies; 16+ messages in thread
From: Gao, Liming @ 2018-04-03 8:34 UTC (permalink / raw)
To: Zhu, Yonghong, edk2-devel@lists.01.org; +Cc: Kinney, Michael D, Shaw, Kevin W
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] Expression spec: update version to 1.3
>
>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>
>---
> README.md | 5 +++--
> 1 file changed, 3 insertions(+), 2 deletions(-)
>
>diff --git a/README.md b/README.md
>index 60086a9..ae725ca 100644
>--- a/README.md
>+++ b/README.md
>@@ -1,9 +1,9 @@
> <!--- @file
> README.md for EDK II Meta-Data Expression Syntax Specification
>
>- Copyright (c) 2014-2017, Intel Corporation. All rights reserved.<BR>
>+ Copyright (c) 2014-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:
>
>@@ -70,15 +70,16 @@ PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
>LOSS OF USE, DATA, OR PROFITS;
> OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
>LIABILITY,
> WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
>NEGLIGENCE OR
> OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
>DOCUMENTATION, EVEN IF
> ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
>
>-Copyright (c) 2014-2017, Intel Corporation. All rights reserved.
>+Copyright (c) 2014-2018, Intel Corporation. All rights reserved.
>
>
> ### Revision History
>
> | Revision | Revision History | Date |
> | ---------- | ------------------ | -------------- |
> | 1.0 | Initial Release | September 2014 |
> | 1.1 | | September 2014 |
> | 1.2 | Convert to Gitbook | April 2017 |
>+| 1.3 | Flexible Pcd format| March 2018 |
>--
>2.6.1.windows.1
^ permalink raw reply [flat|nested] 16+ messages in thread
* [Patch] FDF spec: Update version to 1.28
2018-04-03 7:17 [Patch] Build Spec: Update Version to 1.28 Yonghong Zhu
` (3 preceding siblings ...)
2018-04-03 7:17 ` [Patch] Expression spec: update version to 1.3 Yonghong Zhu
@ 2018-04-03 7:17 ` Yonghong Zhu
2018-04-03 8:35 ` Gao, Liming
2018-04-03 7:17 ` [Patch] INF spec: Update version to 1.27 Yonghong Zhu
2018-04-03 8:34 ` [Patch] Build Spec: Update Version to 1.28 Gao, Liming
6 siblings, 1 reply; 16+ messages in thread
From: Yonghong Zhu @ 2018-04-03 7:17 UTC (permalink / raw)
To: edk2-devel; +Cc: Liming Gao, Michael Kinney, Kevin W Shaw
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_fdf_design_discussion/README.md | 4 ++--
3_edk_ii_fdf_file_format/34_[defines]_section.md | 16 ++++++++--------
README.md | 5 +++--
3 files changed, 13 insertions(+), 12 deletions(-)
diff --git a/2_fdf_design_discussion/README.md b/2_fdf_design_discussion/README.md
index 3202f56..7d87e43 100644
--- a/2_fdf_design_discussion/README.md
+++ b/2_fdf_design_discussion/README.md
@@ -1,9 +1,9 @@
<!--- @file
2 FDF Design Discussion
- Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
+ Copyright (c) 2006-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:
@@ -50,11 +50,11 @@ The EDK II Build generates UEFI and PI specification compliant binary images.
The tools provided in the EDK and the EdkCompatibilityPkg module support
earlier versions of the specifications.
This revision of the specification adds support for multiple binary files in
an FV FILE RAW statement. FDF files that use this feature must use the new
-`FDF_SPECIFICATION = 0x0001001B` in the `[Defines]` section. Older FDF files
+`FDF_SPECIFICATION = 0x0001001C` in the `[Defines]` section. Older FDF files
do not need to update the `FDF_SPECIFICATION` value.
The EDK II build system has been updated to allow the setting of multiple paths
that will be searched when attempting to resolve the location of EDK II
packages. This new feature allows for more flexibility when designing a tree
diff --git a/3_edk_ii_fdf_file_format/34_[defines]_section.md b/3_edk_ii_fdf_file_format/34_[defines]_section.md
index 5bbb890..83b0bbf 100644
--- a/3_edk_ii_fdf_file_format/34_[defines]_section.md
+++ b/3_edk_ii_fdf_file_format/34_[defines]_section.md
@@ -1,9 +1,9 @@
<!--- @file
3.4 [Defines] Section
- Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
+ Copyright (c) 2006-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,17 +38,17 @@ section following comment blocks at the beginning of the file.
This section describes the defines section content in the FDF files. This file
can be created by a 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 version of the FDF specification is "0x0001001B". New
-versions of this specification must increment the minor (001B) portion of the
+The code for this version of the FDF specification is "0x0001001C". New
+versions of this specification must increment the minor (001C) portion of the
specification code for backward-compatible changes, and increment the major
specification number for non-backward-compatible changes.
This revision of the specification adds new features. Any FDF file that uses
-these new features must use the value `0x0001001B` in the `FDF_SPECIFICATION`
+these new features must use the value `0x0001001C` in the `FDF_SPECIFICATION`
statement. Older FDF files that do not use these new feature do not need to
update the value.
Conditional statements may be used anywhere within this section.
@@ -78,17 +78,17 @@ The version number for this flash definition; the value is not used by build
tools, but the version element is provided for user tracking capabilities that
may be used by other user interface tools.
**_FDF_SPECIFICATION_**
-For this specification, the version value is 0x0001001B. Tools that process
+For this specification, the version value is 0x0001001C. Tools that process
this version of the FDF file can successfully process earlier versions of the
FDF files (this is a backward compatible update). If an FDF file with an
earlier version of the `FDF_SPECIFICATION` is modified to use a feature added
-in the 1.27 version of this specification must be updated to 0x0001001B. There
+in the 1.28 version of this specification must be updated to 0x0001001C. There
is no requirement to change existing entries if no other content changes. This
-value may also be specified as decimal value, such as 1.27.
+value may also be specified as decimal value, such as 1.28.
**_PcdNames_**
PCDs defined in this section take precedence over PCD values specified in other
meta-data files. Note that PCDs defined via the SET statements in sub-sections
@@ -97,9 +97,9 @@ meta-data files.
#### Example
```ini
[Defines]
- FDF_SPECIFICATION = 0x0001001B
+ FDF_SPECIFICATION = 0x0001001C
DEFINE BIG_STUFF = False
SET gEfiMyPlatformTokenSpaceGuid.MyUsbFlag = True
```
diff --git a/README.md b/README.md
index 4e15a73..b4a04eb 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,9 @@
<!--- @file
README.md for EDK II Flash Description (FDF) File Specification
- Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
+ Copyright (c) 2006-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:
@@ -192,11 +192,11 @@ Copyright (c) 2006-2017, Intel Corporation. All rights reserved.
| | WORKSPACE directory tree (refer to the TianoCore.org/ EDKII website for additional instructions on setting up a development environment). | |
| | Added new system environment variables, | |
| | PACKAGES_PATH and EDK_TOOLS_BIN, used by the build system. | |
| | Allow INF statements in FD regions. | |
| | Clarified [UserExtensions] content in chapter 2 (to match implementation) | |
-| 1.28 | Convert to GitBooks | June 2017 |
+| 1.27 | Convert to GitBooks | June 2017 |
| | [#426](https://bugzilla.tianocore.org/show_bug.cgi?id=426) IMAGE_TYPE_ID must be provided with value, FDF should mark it as required section | |
| | [#373](https://bugzilla.tianocore.org/show_bug.cgi?id=373) Conditional statement examples incorrect | |
| | [#461](https://bugzilla.tianocore.org/show_bug.cgi?id=461) FDF Spec: add a super script number for the <FmpFileData> | |
| | [#249](https://bugzilla.tianocore.org/show_bug.cgi?id=249) FDF spec miss '<UiFmpName>' definition | |
| | [#350](https://bugzilla.tianocore.org/show_bug.cgi?id=350) [FDF Spec] Extend the macro usage in the !include statement | |
@@ -206,7 +206,8 @@ Copyright (c) 2006-2017, Intel Corporation. All rights reserved.
| | [#142](https://bugzilla.tianocore.org/show_bug.cgi?id=142) Update EDK II FDF Specification to allow sections in any order | |
| | [#478](https://bugzilla.tianocore.org/show_bug.cgi?id=478) FDF spec: extend the <FmpFileData> to support <FvStatements> and <FdStatenents> | |
| | [#353](https://bugzilla.tianocore.org/show_bug.cgi?id=353) Build spec: Allow nested includes in DSC and FDF files | |
| | [#520](https://bugzilla.tianocore.org/show_bug.cgi?id=520) FDF spec: Update Precedence of PCD Values | |
| | [#585](https://bugzilla.tianocore.org/show_bug.cgi?id=585) FDF Spec: Update the FDF_SPECIFICATION version to 0x0001001B or 1.27 | |
+| 1.28 | Update version to 1.28 | March 2018 |
| | Per PI 1.6 to extend FFS alignment to 16M | |
| | Per PI 1.6 to support FV extended header entry contain the used size of FV | |
--
2.6.1.windows.1
^ permalink raw reply related [flat|nested] 16+ messages in thread* Re: [Patch] FDF spec: Update version to 1.28
2018-04-03 7:17 ` [Patch] FDF spec: Update version to 1.28 Yonghong Zhu
@ 2018-04-03 8:35 ` Gao, Liming
0 siblings, 0 replies; 16+ messages in thread
From: Gao, Liming @ 2018-04-03 8:35 UTC (permalink / raw)
To: Zhu, Yonghong, edk2-devel@lists.01.org; +Cc: Kinney, Michael D, Shaw, Kevin W
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] FDF spec: Update version to 1.28
>
>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_fdf_design_discussion/README.md | 4 ++--
> 3_edk_ii_fdf_file_format/34_[defines]_section.md | 16 ++++++++--------
> README.md | 5 +++--
> 3 files changed, 13 insertions(+), 12 deletions(-)
>
>diff --git a/2_fdf_design_discussion/README.md
>b/2_fdf_design_discussion/README.md
>index 3202f56..7d87e43 100644
>--- a/2_fdf_design_discussion/README.md
>+++ b/2_fdf_design_discussion/README.md
>@@ -1,9 +1,9 @@
> <!--- @file
> 2 FDF Design Discussion
>
>- Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
>+ Copyright (c) 2006-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:
>
>@@ -50,11 +50,11 @@ The EDK II Build generates UEFI and PI specification
>compliant binary images.
> The tools provided in the EDK and the EdkCompatibilityPkg module support
> earlier versions of the specifications.
>
> This revision of the specification adds support for multiple binary files in
> an FV FILE RAW statement. FDF files that use this feature must use the new
>-`FDF_SPECIFICATION = 0x0001001B` in the `[Defines]` section. Older FDF files
>+`FDF_SPECIFICATION = 0x0001001C` in the `[Defines]` section. Older FDF files
> do not need to update the `FDF_SPECIFICATION` value.
>
> The EDK II build system has been updated to allow the setting of multiple
>paths
> that will be searched when attempting to resolve the location of EDK II
> packages. This new feature allows for more flexibility when designing a tree
>diff --git a/3_edk_ii_fdf_file_format/34_[defines]_section.md
>b/3_edk_ii_fdf_file_format/34_[defines]_section.md
>index 5bbb890..83b0bbf 100644
>--- a/3_edk_ii_fdf_file_format/34_[defines]_section.md
>+++ b/3_edk_ii_fdf_file_format/34_[defines]_section.md
>@@ -1,9 +1,9 @@
> <!--- @file
> 3.4 [Defines] Section
>
>- Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
>+ Copyright (c) 2006-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,17 +38,17 @@ section following comment blocks at the beginning of
>the file.
>
> This section describes the defines section content in the FDF files. This file
> can be created by a 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 version of the FDF specification is "0x0001001B". New
>-versions of this specification must increment the minor (001B) portion of the
>+The code for this version of the FDF specification is "0x0001001C". New
>+versions of this specification must increment the minor (001C) portion of the
> specification code for backward-compatible changes, and increment the
>major
> specification number for non-backward-compatible changes.
>
> This revision of the specification adds new features. Any FDF file that uses
>-these new features must use the value `0x0001001B` in the
>`FDF_SPECIFICATION`
>+these new features must use the value `0x0001001C` in the
>`FDF_SPECIFICATION`
> statement. Older FDF files that do not use these new feature do not need to
> update the value.
>
> Conditional statements may be used anywhere within this section.
>
>@@ -78,17 +78,17 @@ The version number for this flash definition; the value
>is not used by build
> tools, but the version element is provided for user tracking capabilities that
> may be used by other user interface tools.
>
> **_FDF_SPECIFICATION_**
>
>-For this specification, the version value is 0x0001001B. Tools that process
>+For this specification, the version value is 0x0001001C. Tools that process
> this version of the FDF file can successfully process earlier versions of the
> FDF files (this is a backward compatible update). If an FDF file with an
> earlier version of the `FDF_SPECIFICATION` is modified to use a feature
>added
>-in the 1.27 version of this specification must be updated to 0x0001001B.
>There
>+in the 1.28 version of this specification must be updated to 0x0001001C.
>There
> is no requirement to change existing entries if no other content changes. This
>-value may also be specified as decimal value, such as 1.27.
>+value may also be specified as decimal value, such as 1.28.
>
> **_PcdNames_**
>
> PCDs defined in this section take precedence over PCD values specified in
>other
> meta-data files. Note that PCDs defined via the SET statements in sub-
>sections
>@@ -97,9 +97,9 @@ meta-data files.
>
> #### Example
>
> ```ini
> [Defines]
>- FDF_SPECIFICATION = 0x0001001B
>+ FDF_SPECIFICATION = 0x0001001C
> DEFINE BIG_STUFF = False
> SET gEfiMyPlatformTokenSpaceGuid.MyUsbFlag = True
> ```
>diff --git a/README.md b/README.md
>index 4e15a73..b4a04eb 100644
>--- a/README.md
>+++ b/README.md
>@@ -1,9 +1,9 @@
> <!--- @file
> README.md for EDK II Flash Description (FDF) File Specification
>
>- Copyright (c) 2006-2017, Intel Corporation. All rights reserved.<BR>
>+ Copyright (c) 2006-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:
>
>@@ -192,11 +192,11 @@ Copyright (c) 2006-2017, Intel Corporation. All rights
>reserved.
> | | WORKSPACE directory tree (refer to the TianoCore.org/ EDKII
>website for additional instructions on setting up a development environment).
>| |
> | | Added new system environment variables,
>| |
> | | PACKAGES_PATH and EDK_TOOLS_BIN, used by the build system.
>| |
> | | Allow INF statements in FD regions.
>| |
> | | Clarified [UserExtensions] content in chapter 2 (to match
>implementation) | |
>-| 1.28 | Convert to GitBooks
>| June 2017 |
>+| 1.27 | Convert to GitBooks
>| June 2017 |
> | | [#426](https://bugzilla.tianocore.org/show_bug.cgi?id=426)
>IMAGE_TYPE_ID must be provided with value, FDF should mark it as required
>section | |
> | | [#373](https://bugzilla.tianocore.org/show_bug.cgi?id=373)
>Conditional statement examples incorrect
>| |
> | | [#461](https://bugzilla.tianocore.org/show_bug.cgi?id=461) FDF
>Spec: add a super script number for the <FmpFileData>
>| |
> | | [#249](https://bugzilla.tianocore.org/show_bug.cgi?id=249) FDF
>spec miss '<UiFmpName>' definition |
>|
> | | [#350](https://bugzilla.tianocore.org/show_bug.cgi?id=350) [FDF
>Spec] Extend the macro usage in the !include statement
>| |
>@@ -206,7 +206,8 @@ Copyright (c) 2006-2017, Intel Corporation. All rights
>reserved.
> | | [#142](https://bugzilla.tianocore.org/show_bug.cgi?id=142) Update
>EDK II FDF Specification to allow sections in any order
>| |
> | | [#478](https://bugzilla.tianocore.org/show_bug.cgi?id=478) FDF
>spec: extend the <FmpFileData> to support <FvStatements> and
><FdStatenents> | |
> | | [#353](https://bugzilla.tianocore.org/show_bug.cgi?id=353) Build
>spec: Allow nested includes in DSC and FDF files |
>|
> | | [#520](https://bugzilla.tianocore.org/show_bug.cgi?id=520) FDF
>spec: Update Precedence of PCD Values |
>|
> | | [#585](https://bugzilla.tianocore.org/show_bug.cgi?id=585) FDF
>Spec: Update the FDF_SPECIFICATION version to 0x0001001B or 1.27
>| |
>+| 1.28 | Update version to 1.28
>| March 2018 |
> | | Per PI 1.6 to extend FFS alignment to 16M
>| |
> | | Per PI 1.6 to support FV extended header entry contain the used size
>of FV | |
>--
>2.6.1.windows.1
^ permalink raw reply [flat|nested] 16+ messages in thread
* [Patch] INF spec: Update version to 1.27
2018-04-03 7:17 [Patch] Build Spec: Update Version to 1.28 Yonghong Zhu
` (4 preceding siblings ...)
2018-04-03 7:17 ` [Patch] FDF spec: Update version to 1.28 Yonghong Zhu
@ 2018-04-03 7:17 ` Yonghong Zhu
2018-04-03 8:35 ` Gao, Liming
2018-04-03 8:34 ` [Patch] Build Spec: Update Version to 1.28 Gao, Liming
6 siblings, 1 reply; 16+ messages in thread
From: Yonghong Zhu @ 2018-04-03 7:17 UTC (permalink / raw)
To: edk2-devel; +Cc: Liming Gao, Michael Kinney, Kevin W Shaw
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
^ permalink raw reply related [flat|nested] 16+ messages in thread* Re: [Patch] INF spec: Update version to 1.27
2018-04-03 7:17 ` [Patch] INF spec: Update version to 1.27 Yonghong Zhu
@ 2018-04-03 8:35 ` Gao, Liming
0 siblings, 0 replies; 16+ messages in thread
From: Gao, Liming @ 2018-04-03 8:35 UTC (permalink / raw)
To: Zhu, Yonghong, edk2-devel@lists.01.org; +Cc: Kinney, Michael D, Shaw, Kevin W
Reviewed-by: Liming Gao <liming.gao@intel.com>
>-----Original Message-----
>From: edk2-devel [mailto:edk2-devel-bounces@lists.01.org] On Behalf Of
>Yonghong Zhu
>Sent: Tuesday, April 03, 2018 3:18 PM
>To: edk2-devel@lists.01.org
>Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Shaw, Kevin W
><kevin.w.shaw@intel.com>; Gao, Liming <liming.gao@intel.com>
>Subject: [edk2] [Patch] INF 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_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
>
>_______________________________________________
>edk2-devel mailing list
>edk2-devel@lists.01.org
>https://lists.01.org/mailman/listinfo/edk2-devel
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: [Patch] Build Spec: Update Version to 1.28
2018-04-03 7:17 [Patch] Build Spec: Update Version to 1.28 Yonghong Zhu
` (5 preceding siblings ...)
2018-04-03 7:17 ` [Patch] INF spec: Update version to 1.27 Yonghong Zhu
@ 2018-04-03 8:34 ` Gao, Liming
6 siblings, 0 replies; 16+ messages in thread
From: Gao, Liming @ 2018-04-03 8:34 UTC (permalink / raw)
To: Zhu, Yonghong, edk2-devel@lists.01.org; +Cc: Kinney, Michael D, Shaw, Kevin W
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] Build Spec: Update Version to 1.28
>
>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>
>---
> README.md | 8 +++++++-
> 1 file changed, 7 insertions(+), 1 deletion(-)
>
>diff --git a/README.md b/README.md
>index d9d2146..9fb7e93 100644
>--- a/README.md
>+++ b/README.md
>@@ -1,9 +1,9 @@
> <!--- @file
> README.md for EDK II Build Specification
>
>- Copyright (c) 2008-2017, Intel Corporation. All rights reserved.<BR>
>+ Copyright (c) 2008-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:
>
>@@ -217,5 +217,11 @@ Copyright (c) 2008-2017, Intel Corporation. All rights
>reserved.
> | | [#481](https://bugzilla.tianocore.org/show_bug.cgi?id=481) Build
>Spec: add clarification for not used Pcd that build tool will not do additional
>checks on its value
>| |
> | | [#518](https://bugzilla.tianocore.org/show_bug.cgi?id=518) Build
>Spec: Update Precedence of PCD Values
>| |
> | | [#669](https://bugzilla.tianocore.org/show_bug.cgi?id=669) Build
>Spec: Add multi-arg support to PREBUILD/POSTBUILD
>| |
> | | [#717](https://bugzilla.tianocore.org/show_bug.cgi?id=717) Build
>Spec: Build report to display every module's build time
>| |
> | | [#689](https://bugzilla.tianocore.org/show_bug.cgi?id=689) Build
>spec: add description for build with binary cache
>| |
>+| 1.28 | Add clarification for the binary cache files
>| March 2018 |
>+| | [#775](https://bugzilla.tianocore.org/show_bug.cgi?id=775) Build
>spec: Add description about auto detect thread number
>| |
>+| | Add Flexible PCD value format into spec
>| |
>+| | Update PCD value and SKU, DefaultStore info in build report
>| |
>+| | Clarify structure PCD field value assignment precedence
>| |
>+| | Update description for build handles PCDs for SKU support
>| |
>--
>2.6.1.windows.1
^ permalink raw reply [flat|nested] 16+ messages in thread