From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received-SPF: Pass (sender SPF authorized) identity=mailfrom; client-ip=134.134.136.20; helo=mga02.intel.com; envelope-from=yonghong.zhu@intel.com; receiver=edk2-devel@lists.01.org Received: from mga02.intel.com (mga02.intel.com [134.134.136.20]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ml01.01.org (Postfix) with ESMTPS id 20C2321B02822 for ; Thu, 11 Oct 2018 00:51:05 -0700 (PDT) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga005.jf.intel.com ([10.7.209.41]) by orsmga101.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 11 Oct 2018 00:51:04 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.54,367,1534834800"; d="scan'208";a="264758532" Received: from shwdeopenpsi168.ccr.corp.intel.com ([10.239.158.127]) by orsmga005.jf.intel.com with ESMTP; 11 Oct 2018 00:51:02 -0700 From: Yonghong Zhu To: edk2-devel@lists.01.org Cc: Liming Gao , Michael Kinney , Kevin W Shaw Date: Thu, 11 Oct 2018 15:50:58 +0800 Message-Id: <1539244258-10740-1-git-send-email-yonghong.zhu@intel.com> X-Mailer: git-send-email 2.6.1.windows.1 Subject: [Patch] Build Spec: Add description for Structure Pcd display in the module X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 11 Oct 2018 07:51:05 -0000 The detail rules are totally same with Global Pcd section. Cc: Liming Gao Cc: Michael Kinney Cc: Kevin W Shaw Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Yonghong Zhu --- 13_build_reports/136_global_pcd_section.md | 12 ++++++------ 13_build_reports/138_module_section.md | 7 ++----- 2 files changed, 8 insertions(+), 11 deletions(-) diff --git a/13_build_reports/136_global_pcd_section.md b/13_build_reports/136_global_pcd_section.md index 0e3afa7..9a3b98e 100644 --- a/13_build_reports/136_global_pcd_section.md +++ b/13_build_reports/136_global_pcd_section.md @@ -160,23 +160,23 @@ option. #### 13.6.2.4 Rules for Structure PCD If the Pcd is a Structure Pcd, it display in the report file would have two parts. One is the final Pcd value and its field value, the field value is from FDF file, DSC file PCD Section or build option, not from the final structure byte array, and the field order is sorted by the field name. When the field value from DSC file -PCD Section, it will not have additional *P Flag, when the field value from FDF file, -it will have additional *F Flag before the field name, when the field value from -build option, it will have additional *B Flag before the field name. The other part +PCD Section, it will not have additional `*P` Flag, when the field value from FDF file, +it will have additional `*F` Flag before the field name, when the field value from +build option, it will have additional `*B` Flag before the field name. The other part is the DEC default value and its field value, this part is optional. The field value in this part is from DEC file, and the field order is sorted by the field name. ********** **Note:** When the structure Pcd have some value from build option, no matter whether -the value is same with FDF or DSC file or DEC file, there will display a *B Flag before +the value is same with FDF or DSC file or DEC file, there will display a `*B` Flag before the PCD name. When the structure Pcd have some value from FDF file, no matter whether -the value is same with DSC file or DEC file, there will display a *F Flag before the +the value is same with DSC file or DEC file, there will display a `*F` Flag before the PCD name. When the structure Pcd value have some value from DSC file PCD section, no -matter whether the value is same with DEC file, there will display a *P Flag before +matter whether the value is same with DEC file, there will display a `*P` Flag before the PCD name. ********** #### Example diff --git a/13_build_reports/138_module_section.md b/13_build_reports/138_module_section.md index 843ad34..d457c24 100644 --- a/13_build_reports/138_module_section.md +++ b/13_build_reports/138_module_section.md @@ -260,15 +260,12 @@ Each PCD may contain up to following lines: *P PcdPlatformBootTimeOut : DYNHII (UINT16) = 0xA (10) gEfiGlobalVariableGuid: L"Timeout": 0x0 DEC DEFAULT = 0xffff (65535) ``` -4. Additional lines may exist if the PCD is Structure PCD. Every field value -that user specified in DSC/DEC file and build command will print out. The field -value is from DSC/DEC file or build command, not from the final structure byte -array, and the field order is same as it in DSC/DEC file. when the field value is -from build command, tool will additional print a *B Flag. +4. Additional lines may exist if the PCD is Structure PCD. Please refer to +13.6.2.4 Rules for Structure PCD for details. ********** **Note:** This sub-section is present when **PCD** is specified in **-Y** option. ********** -- 2.6.1.windows.1