Cc: Liming Gao <[email protected]>
Cc: Michael Kinney <[email protected]>
Cc: Kevin W Shaw <[email protected]>
Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Yonghong Zhu <[email protected]>
---
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
_______________________________________________
edk2-devel mailing list
[email protected]
https://lists.01.org/mailman/listinfo/edk2-devel