From nobody Fri May 17 10:44:01 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) client-ip=66.175.222.108; envelope-from=bounce+27952+111960+1787277+3901457@groups.io; helo=mail02.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce+27952+111960+1787277+3901457@groups.io; dmarc=fail(p=none dis=none) header.from=intel.com ARC-Seal: i=1; a=rsa-sha256; t=1701395796; cv=none; d=zohomail.com; s=zohoarc; b=ipN9uDK5AHaGI4lAcpPj+4PySfe7Iw+zcWN0BJrHBnw+DRKIdHC9wUJagoWH1PRV+PnGMy7S86MZGF9Ipn0EYRwWbqT0DrKlNiyXEKGAl59e1yCVdT9mPtDy0U5IhSvedfqxKZDpNwFZjWhVeyrW9kPZwHFKFstI5pNprOqR+2c= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1701395796; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:List-Subscribe:List-Id:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:Reply-To:Sender:Subject:Subject:To:To:Message-Id; bh=bvz5vplTi8oyrcFfGk89hsRC8h02dXz1Gh2WveVgo8Y=; b=RoQj4rrkYV63tCT5HOO2BHPLLiEph12JMqZ4sUGosdQ+A0Svqi9IR7espnOXx4WuOoNv02ecQzjO5Qqg2sN9sHc3N6WDmcxVGS+7djHhPCFNUSJedEhD4D1EnblU6+CdjDIxT569WiZuKusjQEISmGqG3Aux10W9T+oAVWnoLQo= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce+27952+111960+1787277+3901457@groups.io; dmarc=fail header.from= (p=none dis=none) Received: from mail02.groups.io (mail02.groups.io [66.175.222.108]) by mx.zohomail.com with SMTPS id 1701395796827768.3322810713875; Thu, 30 Nov 2023 17:56:36 -0800 (PST) Return-Path: DKIM-Signature: a=rsa-sha256; bh=wR+1PUGWfJ8iYSaoW7VssRSpMUnBQoO2O633AQH2bro=; c=relaxed/simple; d=groups.io; h=From:To:Cc:Subject:Date:Message-Id:MIME-Version:Precedence:List-Subscribe:List-Help:Sender:List-Id:Mailing-List:Delivered-To:Reply-To:List-Unsubscribe-Post:List-Unsubscribe:Content-Transfer-Encoding; s=20140610; t=1701395796; v=1; b=N/rxqRuqrcc3+zduH+WZmUAMT78nd6FsZoEiRfr8OzQwqOSIDrB5wVVJuLeU9WwwO7cF31cH CrJ+XpXInEdP4NY6addNdHPhDhz4M5GopbIYqrDZZFO+lhoPpY3u1Jvqo7Lml2WGpozl6DGqs1N kP/FLXviBh/K+Fha5l9QLyRM= X-Received: by 127.0.0.2 with SMTP id 9LnVYY1788612xvnAWxG8Kw0; Thu, 30 Nov 2023 17:56:36 -0800 X-Received: from mgamail.intel.com (mgamail.intel.com [192.55.52.151]) by mx.groups.io with SMTP id smtpd.web11.13222.1701395795770041683 for ; Thu, 30 Nov 2023 17:56:35 -0800 X-IronPort-AV: E=McAfee;i="6600,9927,10910"; a="373604450" X-IronPort-AV: E=Sophos;i="6.04,240,1695711600"; d="scan'208";a="373604450" X-Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by fmsmga107.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 30 Nov 2023 17:56:35 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10910"; a="913416530" X-IronPort-AV: E=Sophos;i="6.04,240,1695711600"; d="scan'208";a="913416530" X-Received: from nldesimo-desk.amr.corp.intel.com ([10.241.240.67]) by fmsmga001-auth.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 30 Nov 2023 17:56:34 -0800 From: "Nate DeSimone" To: devel@edk2.groups.io Cc: Ray Ni , Chasel Chiu , Duggapu Chinni B , Ray Han Lim Ng , Star Zeng , Ted Kuo , Ashraf Ali S , Susovan Mohapatra Subject: [edk2-devel] [PATCH] IntelFsp2Pkg/PatchFv: Fix syntax issue in markdown manual Date: Thu, 30 Nov 2023 17:56:16 -0800 Message-Id: <20231201015618.3920-1-nathaniel.l.desimone@intel.com> MIME-Version: 1.0 Precedence: Bulk List-Subscribe: List-Help: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,nathaniel.l.desimone@intel.com List-Unsubscribe-Post: List-Unsubscribe=One-Click List-Unsubscribe: X-Gm-Message-State: YJKB4VYTOGASPFYgYx3RLul7x1787277AA= Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @groups.io) X-ZM-MESSAGEID: 1701395797314000001 Content-Type: text/plain; charset="utf-8" From: Ray Ni According to the markdown language syntax, headings should be after number signs (#). The number of number signs correspond to the heading level. But current PatchFvUserManual.md doesn't insert a space between the number signs and the heading title, resulting the markdown file is not rendered well in markdown viewers. The patch doesn't change any content but only adds spaces to ensure the headings are correctly recognized. Signed-off-by: Ray Ni Cc: Chasel Chiu Reviewed-by: Nate DeSimone Cc: Duggapu Chinni B Cc: Ray Han Lim Ng Cc: Star Zeng Cc: Ted Kuo Reviewed-by: Ashraf Ali S Cc: Susovan Mohapatra Reviewed-by: S, Ashraf Ali --- .../Tools/UserManuals/PatchFvUserManual.md | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/IntelFsp2Pkg/Tools/UserManuals/PatchFvUserManual.md b/IntelFsp= 2Pkg/Tools/UserManuals/PatchFvUserManual.md index f28eedf625..205ad57773 100644 --- a/IntelFsp2Pkg/Tools/UserManuals/PatchFvUserManual.md +++ b/IntelFsp2Pkg/Tools/UserManuals/PatchFvUserManual.md @@ -1,9 +1,9 @@ -#Name +# Name **_PatchFv.py_** - The python script that patches the firmware volumes (**= FV**) with in the flash device (**FD**) file post FSP build. From version 0.60, script is capable of patching flash device (**FD**) dir= ectly. =20 -#Synopsis +# Synopsis =20 ``` PatchFv FvBuildDir [FvFileBaseNames:]FdFileBaseNameToPatch ["Offset, Value= "]+ @@ -18,32 +18,32 @@ PatchFv FdFileDir FdFileName ["Offset, Value"]+ | ["Offset, Value, $Command, @Comment"]+ ``` =20 -#Description +# Description The **_PatchFv.py_** tool allows the developer to fix up FD images to foll= ow the Intel FSP Architecture specification. It also makes the FD image relocata= ble. The tool is written in Python and uses Python 2.7 or later to run. Consider using the tool in a build script. =20 -#FvBuildDir (Argument 1) +# FvBuildDir (Argument 1) This is the first argument that **_PatchFv.py_** requires. It is the build directory for all firmware volumes created during the FSP build. The path = must be either an absolute path or a relevant path, relevant to the top level o= f the FSP tree. =20 -####Example usage: +#### Example usage: ``` Build\YouPlatformFspPkg\%BD_TARGET%_%VS_VERSION%%VS_X86%\FV ``` =20 The example used contains Windows batch script %VARIABLES%. =20 -#FvFileBaseNames (Argument 2: Optional Part 1) +# FvFileBaseNames (Argument 2: Optional Part 1) The firmware volume file base names (**_FvFileBaseNames_**) are the indepe= ndent -Fv?s that are to be patched within the FD. (0 or more in the form -**FVFILEBASENAME:**) The colon **:** is used for delimiting the single +FVs that are to be patched within the FD. (0 or more in the form +**FvFileBaseNames:**) The colon **:** is used for delimiting the single argument and must be appended to the end of each (**_FvFileBaseNames_**). =20 -####Example usage: +#### Example usage: ``` STAGE1:STAGE2:MANIFEST:YOURPLATFORM ``` @@ -55,14 +55,14 @@ In the example **STAGE1** is **STAGE1.Fv** in **YOURPLA= TFORM.fd**. Firmware device file name to patch (**_FdFileNameToPatch_**) is the base n= ame of the FD file that is to be patched. (1 only, in the form **YOURPLATFORM**) =20 -####Example usage: +#### Example usage: ``` STAGE1:STAGE2:MANIFEST:YOURPLATFORM ``` =20 In the example **YOURPLATFORM** is from **_YOURPLATFORM.fd_** =20 -#"Offset, Value[, Command][, Comment]" (Argument 3) +# "Offset, Value[, Command][, Comment]" (Argument 3) The **_Offset_** can be a positive or negative number and represents where= the **_Value_** to be patched is located within the FD. The **_Value_** is what will be written at the given **_Offset_** in the FD. Constants may be used= for @@ -79,10 +79,10 @@ The entire argument includes the quote marks like in th= e example argument below: 0xFFFFFFC0, SomeCore:__EntryPoint - [0x000000F0],@SomeCore Entry ``` =20 -###Constants: +### Constants: Hexadecimal (use **0x** as prefix) | Decimal =20 -####Examples: +#### Examples: =20 | **Positive Hex** | **Negative Hex** | **Positive Decimal** | **Negative = Decimal** | | ---------------: | ---------------: | -------------------: | -----------= --------: | @@ -93,7 +93,7 @@ ModuleName:FunctionName | ModuleName:GlobalVariableName ModuleGuid:Offset ``` =20 -###Operators: +### Operators: =20 ``` =20 @@ -113,7 +113,7 @@ From version 0.60 tool allows to pass flash device file= path as Argument 1 and flash device name as Argument 2 and rules for passing offset & value are s= ame as explained in the previous sections. =20 -####Example usage: +#### Example usage: Argument 1 ``` YouPlatformFspBinPkg\ @@ -123,21 +123,21 @@ Argument 2 Fsp_Rebased_T ``` =20 -###Special Commands: +### Special Commands: Special commands must use the **$** symbol as a prefix to the command itse= lf. There is only one command available at this time. =20 ``` -$COPY ? Copy a binary block from source to destination. +$COPY Copy a binary block from source to destination. ``` =20 -####Example: +#### Example: =20 ``` 0x94, [PlatformInit:__gPcd_BinPatch_FvRecOffset] + 0x94, [0x98], $COPY, @S= ync up 2nd FSP Header ``` =20 -###Comments: +### Comments: Comments are allowed in the **Offset, Value [, Comment]** argument. Commen= ts must use the **@** symbol as a prefix. The comment will output to the build window upon successful completion of patching along with the offset and va= lue data. --=20 2.39.1.windows.1 GitPatchExtractor 1.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#111960): https://edk2.groups.io/g/devel/message/111960 Mute This Topic: https://groups.io/mt/102907649/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-