Re: [edk2] [Patch] Document: Update DSC spec to remove EDK related contents
1. 2.12 [UserExtensions] Section and ## 2.11 [UserExtensions] Section are
inconsistent. There are the similar issue in this patch. Please check them to
make sure they are same.
2. Update commit message for EDK and IPF both.
> -Original Message-
> From: Feng, Bob C
> Sent: Monday, March 4, 2019 7:49 PM
> To: edk2-devel@lists.01.org
> Cc: Feng, Bob C ; Gao, Liming ;
> Carsey, Jaben
> Subject: [Patch] Document: Update DSC spec to remove EDK related contents
>
> BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=1453
>
> Remove EDK related contents inf Dsc spec.
>
> Contributed-under: TianoCore Contribution Agreement 1.1
> Signed-off-by: Bob Feng
> Cc: Liming Gao
> Cc: Jaben Carsey
> ---
> 1_introduction/11_overview.md | 14 +--
> ...=> 210_[components]_section_processing.md} | 27 +-
> ...ion.md => 211_[userextensions]_section.md} | 4 +-
> ...212_[defaultstores]_section_processing.md} | 4 +-
> .../22_build_description_file_format.md | 50 ++
> .../23_[defines]_section_processing.md| 12 +--
> 2_dsc_overview/24_[buildoptions]_section.md | 72 ++
> .../26_[libraries]_section_processing.md | 69 --
> ...26_[libraryclasses]_section_processing.md} | 4 +-
> ...essing.md => 27_pcd_section_processing.md} | 34 +++
> ...{29_pcd_sections.md => 28_pcd_sections.md} | 26 ++---
> ...210_pcd_database.md => 29_pcd_database.md} | 4 +-
> ...ctions.md => 310_[components]_sections.md} | 62 +---
> ...ns.md => 311_[userextensions]_sections.md} | 4 +-
> ...tion.md => 312_[defaultstores]_section.md} | 4 +-
> 3_edk_ii_dsc_file_format/32_general_rules.md | 13 +--
> .../33_platform_dsc_definition.md | 17 +---
> .../35_[defines]_section.md | 12 +--
> .../36_[buildoptions]_sections.md | 19 ++--
> .../38_[libraries]_sections.md| 94 ---
> ...ons.md => 38_[libraryclasses]_sections.md} | 4 +-
> ...310_pcd_sections.md => 39_pcd_sections.md} | 14 +--
> 22 files changed, 101 insertions(+), 462 deletions(-)
> rename 2_dsc_overview/{211_[components]_section_processing.md =>
> 210_[components]_section_processing.md} (84%)
> rename 2_dsc_overview/{212_[userextensions]_section.md =>
> 211_[userextensions]_section.md} (93%)
> rename 2_dsc_overview/{213_[defaultstores]_section_processing.md =>
> 212_[defaultstores]_section_processing.md} (93%)
> delete mode 100644 2_dsc_overview/26_[libraries]_section_processing.md
> rename 2_dsc_overview/{27_[libraryclasses]_section_processing.md =>
> 26_[libraryclasses]_section_processing.md} (96%)
> rename 2_dsc_overview/{28_pcd_section_processing.md =>
> 27_pcd_section_processing.md} (94%)
> rename 2_dsc_overview/{29_pcd_sections.md => 28_pcd_sections.md} (93%)
> rename 2_dsc_overview/{210_pcd_database.md => 29_pcd_database.md} (96%)
> rename 3_edk_ii_dsc_file_format/{311_[components]_sections.md =>
> 310_[components]_sections.md} (81%)
> rename 3_edk_ii_dsc_file_format/{312_[userextensions]_sections.md =>
> 311_[userextensions]_sections.md} (94%)
> rename 3_edk_ii_dsc_file_format/{313_[defaultstores]_section.md =>
> 312_[defaultstores]_section.md} (93%)
> delete mode 100644 3_edk_ii_dsc_file_format/38_[libraries]_sections.md
> rename 3_edk_ii_dsc_file_format/{39_[libraryclasses]_sections.md =>
> 38_[libraryclasses]_sections.md} (95%)
> rename 3_edk_ii_dsc_file_format/{310_pcd_sections.md => 39_pcd_sections.md}
> (97%)
>
> diff --git a/1_introduction/11_overview.md b/1_introduction/11_overview.md
> index d9006df..ff2b517 100644
> --- a/1_introduction/11_overview.md
> +++ b/1_introduction/11_overview.md
> @@ -1,9 +1,9 @@
> |:-:|::|:-:|::|:-:|::|
> | EDK Build Tools| YES | NO | YES | NO |
> YES | NO |
> -| EDK II Build Tools | NO| YES | NO| YES |
> YES | YES |
> +| EDK II Build Tools | NO| YES | NO| YES |
> NO| YES |
>
> **
> **Note:** This document is intended for persons doing EFI development and
> support for different platforms. It is most likely only of interest in the
> event that there is a problem with a build, or if a developer needs to
> perform
> @@ -90,9 +87,6 @@ contain information on the EFI format for FFS or FV file
> creation. The
> Makefiles will support third party compilation tools - Microsoft, Intel and
> GCC
> tool chains - and at least one EDK II tool, GenFw. The GenFw tool is used to
> manipulate the files emitted from the compilation tools.
>
> The EDK II build provides UEFI and PI (Unified EFI, Inc.)
> -specification-compliant images. Use of the tools in the EDK Compatibility
> -package can be used for creating earlier versions of EFI 1.10 and/or UEFI 2.0
> -compliant components. To be clear, EDK II tools do not have the
Re: [edk2] [Patch] Document: Update DSC spec to remove EDK related contents
Reviewed-by: Jaben Carsey
It's a lot of changes. It looks good to me.
> -Original Message-
> From: Feng, Bob C
> Sent: Monday, March 04, 2019 7:49 PM
> To: edk2-devel@lists.01.org
> Cc: Feng, Bob C ; Gao, Liming
> ; Carsey, Jaben
> Subject: [Patch] Document: Update DSC spec to remove EDK related
> contents
> Importance: High
>
> BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=1453
>
> Remove EDK related contents inf Dsc spec.
>
> Contributed-under: TianoCore Contribution Agreement 1.1
> Signed-off-by: Bob Feng
> Cc: Liming Gao
> Cc: Jaben Carsey
> ---
> 1_introduction/11_overview.md | 14 +--
> ...=> 210_[components]_section_processing.md} | 27 +-
> ...ion.md => 211_[userextensions]_section.md} | 4 +-
> ...212_[defaultstores]_section_processing.md} | 4 +-
> .../22_build_description_file_format.md | 50 ++
> .../23_[defines]_section_processing.md| 12 +--
> 2_dsc_overview/24_[buildoptions]_section.md | 72 ++
> .../26_[libraries]_section_processing.md | 69 --
> ...26_[libraryclasses]_section_processing.md} | 4 +-
> ...essing.md => 27_pcd_section_processing.md} | 34 +++
> ...{29_pcd_sections.md => 28_pcd_sections.md} | 26 ++---
> ...210_pcd_database.md => 29_pcd_database.md} | 4 +-
> ...ctions.md => 310_[components]_sections.md} | 62 +---
> ...ns.md => 311_[userextensions]_sections.md} | 4 +-
> ...tion.md => 312_[defaultstores]_section.md} | 4 +-
> 3_edk_ii_dsc_file_format/32_general_rules.md | 13 +--
> .../33_platform_dsc_definition.md | 17 +---
> .../35_[defines]_section.md | 12 +--
> .../36_[buildoptions]_sections.md | 19 ++--
> .../38_[libraries]_sections.md| 94 ---
> ...ons.md => 38_[libraryclasses]_sections.md} | 4 +-
> ...310_pcd_sections.md => 39_pcd_sections.md} | 14 +--
> 22 files changed, 101 insertions(+), 462 deletions(-)
> rename 2_dsc_overview/{211_[components]_section_processing.md =>
> 210_[components]_section_processing.md} (84%)
> rename 2_dsc_overview/{212_[userextensions]_section.md =>
> 211_[userextensions]_section.md} (93%)
> rename 2_dsc_overview/{213_[defaultstores]_section_processing.md =>
> 212_[defaultstores]_section_processing.md} (93%)
> delete mode 100644 2_dsc_overview/26_[libraries]_section_processing.md
> rename 2_dsc_overview/{27_[libraryclasses]_section_processing.md =>
> 26_[libraryclasses]_section_processing.md} (96%)
> rename 2_dsc_overview/{28_pcd_section_processing.md =>
> 27_pcd_section_processing.md} (94%)
> rename 2_dsc_overview/{29_pcd_sections.md => 28_pcd_sections.md}
> (93%)
> rename 2_dsc_overview/{210_pcd_database.md => 29_pcd_database.md}
> (96%)
> rename 3_edk_ii_dsc_file_format/{311_[components]_sections.md =>
> 310_[components]_sections.md} (81%)
> rename 3_edk_ii_dsc_file_format/{312_[userextensions]_sections.md =>
> 311_[userextensions]_sections.md} (94%)
> rename 3_edk_ii_dsc_file_format/{313_[defaultstores]_section.md =>
> 312_[defaultstores]_section.md} (93%)
> delete mode 100644 3_edk_ii_dsc_file_format/38_[libraries]_sections.md
> rename 3_edk_ii_dsc_file_format/{39_[libraryclasses]_sections.md =>
> 38_[libraryclasses]_sections.md} (95%)
> rename 3_edk_ii_dsc_file_format/{310_pcd_sections.md =>
> 39_pcd_sections.md} (97%)
>
> diff --git a/1_introduction/11_overview.md
> b/1_introduction/11_overview.md
> index d9006df..ff2b517 100644
> --- a/1_introduction/11_overview.md
> +++ b/1_introduction/11_overview.md
> @@ -1,9 +1,9 @@
> |:-:|::|:-:|::|:-:|:
> :|
> | EDK Build Tools| YES | NO | YES | NO |
> YES | NO |
> -| EDK II Build Tools | NO| YES | NO| YES |
> YES | YES
> |
> +| EDK II Build Tools | NO| YES | NO| YES |
> NO| YES
> |
>
> **
> **Note:** This document is intended for persons doing EFI development
> and
> support for different platforms. It is most likely only of interest in the
> event that there is a problem with a build, or if a developer needs to
> perform
> @@ -90,9 +87,6 @@ contain information on the EFI format for FFS or FV file
> creation. The
> Makefiles will support third party compilation tools - Microsoft, Intel and
> GCC
> tool chains - and at least one EDK II tool, GenFw. The GenFw tool is used to
> manipulate the files emitted from the compilation tools.
>
> The EDK II build provides UEFI and PI (Unified EFI, Inc.)
> -specification-compliant images. Use of the tools in the EDK Compatibility
> -package can be used for creating earlier versions of EFI 1.10 and/or UEFI 2.0
> -compliant components. To be clear, EDK II tools do not have the limitation of
> -ECP tools, which can only do EFI 1.10 and UEFI 2.0 images.
> +specification-compliant images.
> diff --git
[edk2] [Patch] Document: Update DSC spec to remove EDK related contents
BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=1453
Remove EDK related contents inf Dsc spec.
Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Bob Feng
Cc: Liming Gao
Cc: Jaben Carsey
---
1_introduction/11_overview.md | 14 +--
...=> 210_[components]_section_processing.md} | 27 +-
...ion.md => 211_[userextensions]_section.md} | 4 +-
...212_[defaultstores]_section_processing.md} | 4 +-
.../22_build_description_file_format.md | 50 ++
.../23_[defines]_section_processing.md| 12 +--
2_dsc_overview/24_[buildoptions]_section.md | 72 ++
.../26_[libraries]_section_processing.md | 69 --
...26_[libraryclasses]_section_processing.md} | 4 +-
...essing.md => 27_pcd_section_processing.md} | 34 +++
...{29_pcd_sections.md => 28_pcd_sections.md} | 26 ++---
...210_pcd_database.md => 29_pcd_database.md} | 4 +-
...ctions.md => 310_[components]_sections.md} | 62 +---
...ns.md => 311_[userextensions]_sections.md} | 4 +-
...tion.md => 312_[defaultstores]_section.md} | 4 +-
3_edk_ii_dsc_file_format/32_general_rules.md | 13 +--
.../33_platform_dsc_definition.md | 17 +---
.../35_[defines]_section.md | 12 +--
.../36_[buildoptions]_sections.md | 19 ++--
.../38_[libraries]_sections.md| 94 ---
...ons.md => 38_[libraryclasses]_sections.md} | 4 +-
...310_pcd_sections.md => 39_pcd_sections.md} | 14 +--
22 files changed, 101 insertions(+), 462 deletions(-)
rename 2_dsc_overview/{211_[components]_section_processing.md =>
210_[components]_section_processing.md} (84%)
rename 2_dsc_overview/{212_[userextensions]_section.md =>
211_[userextensions]_section.md} (93%)
rename 2_dsc_overview/{213_[defaultstores]_section_processing.md =>
212_[defaultstores]_section_processing.md} (93%)
delete mode 100644 2_dsc_overview/26_[libraries]_section_processing.md
rename 2_dsc_overview/{27_[libraryclasses]_section_processing.md =>
26_[libraryclasses]_section_processing.md} (96%)
rename 2_dsc_overview/{28_pcd_section_processing.md =>
27_pcd_section_processing.md} (94%)
rename 2_dsc_overview/{29_pcd_sections.md => 28_pcd_sections.md} (93%)
rename 2_dsc_overview/{210_pcd_database.md => 29_pcd_database.md} (96%)
rename 3_edk_ii_dsc_file_format/{311_[components]_sections.md =>
310_[components]_sections.md} (81%)
rename 3_edk_ii_dsc_file_format/{312_[userextensions]_sections.md =>
311_[userextensions]_sections.md} (94%)
rename 3_edk_ii_dsc_file_format/{313_[defaultstores]_section.md =>
312_[defaultstores]_section.md} (93%)
delete mode 100644 3_edk_ii_dsc_file_format/38_[libraries]_sections.md
rename 3_edk_ii_dsc_file_format/{39_[libraryclasses]_sections.md =>
38_[libraryclasses]_sections.md} (95%)
rename 3_edk_ii_dsc_file_format/{310_pcd_sections.md => 39_pcd_sections.md}
(97%)
diff --git a/1_introduction/11_overview.md b/1_introduction/11_overview.md
index d9006df..ff2b517 100644
--- a/1_introduction/11_overview.md
+++ b/1_introduction/11_overview.md
@@ -1,9 +1,9 @@
-## 2.11 [Components] Section Processing
+## 2.10 [Components] Section Processing
-One or more `[Components]` sections contain lists of EDK components and EDK II
-Modules. The format for specifying the INF file for EDK II modules incorporates
-new scoping capabilities.
+One or more `[Components]` sections contain lists of EDK II Modules. The
format
+for specifying the INF file for EDK II modules incorporates new scoping
capabilities.
This section uses one or more of the following section definitions:
* `[Components]`
* `[Components.IA32]`
* `[Components.X64]`
* `[Components.EBC]`
* `[Components.common]`
-EDK components are specified using a fully qualified path to the EDK INF file.
-
-`$(EDK_SOURCE)/Path/and/Filename.inf`
-
-Because EDK II modules have different requirements than EDK I components,
-specifying the INF filename in the extended DSC file may require more than just
-the INF filename and options. A scoping structure, that binds library class
+A scoping structure, that binds library class
(with an optional override instance,) PCD settings (also overriding the values
specified in the `[PcdsPatchableInModule]` or `[PcdsFixedAtBuild]` sections)
and build options for an EDK II module may be required. This scoping structure,
containing sub-elements, is enclosed within curly braces: "{}". The opening
curly brace, "{", must appear at the end of the inf filename line, before any
@@ -79,20 +72,10 @@ Path/and/Filename.inf {
There are four valid, optional sub-elements for EDK II modules. These
sub-element are enclosed within angle brackets: `, `,
`` and ``.
-For EDK component INF files, an optional sub-element of
-`` has been defined. If this element is specified, files
-listed in the directory are used instead of the "same-named" files in the
-component's directory. If an EDK component directory lists files, A.c, B.c and
-C.h,
