Fix several typos for the instructions to build shell binaries with ECP & EDK II...

[mirror_edk2.git] / EdkShellBinPkg / ReadMe.txt

diff --git a/EdkShellBinPkg/ReadMe.txt b/EdkShellBinPkg/ReadMe.txt
index 5b8c967d56794bab8dc2f89d879a2f02641cc90b..056126fcb888441647f8910f8f4915de8cb5cc77 100644 (file)
--- a/EdkShellBinPkg/ReadMe.txt
+++ b/EdkShellBinPkg/ReadMe.txt
@@ -1,20 +1,35 @@
-The binaries of EdkShellBinPkg are directly retrieved from EDK 1.03 release with the following steps:\r
-1.Download Edk1.03.zip from EDK official release site: ://edk.tianocore.org/servlets/ProjectDocumentList?folderID=6&expandFolder=6&folderID=0\r
-2.Unzip it to a local folder, e.g. c:\Edk.\r
-3.The EDK II prime binaries are mapped as follows:\r
-EDKII prime                                        Edk\\r
-EdkShellBinPkg\FullShell\ia32\Shell_Full.efi       Other\Maintained\Application\UefiShell\bin\ia32\Shell_Full.efi      \r
-EdkShellBinPkg\FullShell\x64\Shell_Full.efi        Other\Maintained\Application\UefiShell\bin\x64\Shell_Full.efi       \r
-EdkShellBinPkg\FullShell\ipf\Shell_Full.efi        Other\Maintained\Application\UefiShell\bin\ipf\Shell_Full.efi       \r
-EdkShellBinPkg\MinimumShell\ia32\Shell.efi         Other\Maintained\Application\UefiShell\bin\ipf\Shell.efi    \r
-EdkShellBinPkg\MinimumShell\x64\Shell.efi          Other\Maintained\Application\UefiShell\bin\x64\Shell.efi\r
-EdkShellBinPkg\MinimumShell\ipf\Shell.efi          Other\Maintained\Application\UefiShell\bin\ipf\Shell.efi\r
-EdkShellBinPkg\bin\ia32\Shell_Full.efi             Other\Maintained\Application\UefiShell\bin\ia32\Shell_Full.efi      \r
-EdkShellBinPkg\bin\x64\Shell_Full.efi              Other\Maintained\Application\UefiShell\bin\x64\Shell_Full.efi       \r
-EdkShellBinPkg\bin\ipf\Shell_Full.efi              Other\Maintained\Application\UefiShell\bin\ipf\Shell_Full.efi       \r
-EdkShellBinPkg\bin\ia32\Shell.efi                  Other\Maintained\Application\UefiShell\bin\ipf\Shell.efi    \r
-EdkShellBinPkg\bin\x64\Shell.efi                   Other\Maintained\Application\UefiShell\bin\x64\Shell.efi\r
-EdkShellBinPkg\bin\ipf\Shell.efi                   Other\Maintained\Application\UefiShell\bin\ipf\Shell.efi\r
-EdkShellBinPkg\bin\ia32\Apps\*                     Other\Maintained\Application\UefiShell\bin\ia32\Apps\*\r
-EdkShellBinPkg\bin\x64\Apps\*                      Other\Maintained\Application\UefiShell\bin\x64\Apps\*\r
-EdkShellBinPkg\bin\ipf\Apps\*                      Other\Maintained\Application\UefiShell\bin\ipf\Apps\*\r
+The binaries of EdkShellBinPkg are generated with EDK-Shell 1.04 release and build with Edk Compatibility & BaseTools Package\r
+(r4631)\r
+\r
+The following steps can help to re-generate these binaries for customization:\r
+1. Check out EdkCompatibilityPkg (r4631) to a directory EdkCompatibilityPkg in workspace (svn https://edk2.tianocore.org/svn/edk2/trunk/edk2/EdkCompatibilityPkg). \r
+2. Update to the newest BaseTools package.\r
+2. Download EfiShell 1.04.zip from EDK Shell official release https://efi-shell.tianocore.org/servlets/ProjectDocumentList?folderID=52&expandFolder=52&folderID=45\r
+3. Unzip it to be a sub-directory in EdkCompatibilityPkg , i.e. c:\EdkII\EdkCompatibilityPkg\Shell\r
+4. Work around an issue in EdkCompatibilityPkg\Shell\ver\Ver.inf to split:\r
+  [sources.ia32|x64]\r
+    ia32\ver32.c\r
+\r
+  to be:\r
+  [sources.ia32]\r
+    ia32\ver32.c\r
+\r
+  [sources.x64]\r
+    ia32\ver32.c\r
+\r
+   since current build tools (r4631) do not support this syntax in EDK INF format.\r
+\r
+5. Under workspace directory (i.e. c:\EdkII), execute:\r
+   build -a IA32 -a X64 -a IPF -p EdkShellBinPkg\GenBin\EdkShellPkg.dsc -t WINDDK3790x1830\r
+   The use of WINDDK instead of MYTOOLS is due to the fact that EDK shell source 1.04 is not\r
+   VS2005 clean.\r
+\r
+6. Copy the binaries from Build directory to this package. Typically the EFI binary\r
+   of EdkCompatibility\Shell\$(INF_BASENAME).inf is generated at:\r
+   Build\EdkShellPkg\DEBUG_WINDDK3790x1830\$(ARCH)\EdkCompatibility\Shell\$(INF_BASENAME)\OUTPUT\$(BASENAME).efi\r
+   For example:\r
+   The x64 EFI image of EdkCompatibility\Shell\ver\ver.inf is generated at:\r
+   Build\EdkShellPkg\DEBUG_WINDDK3790x1830\X64\EdkCompatibilityPkg\Shell\ver\Ver\OUTPUT\ver.efi\r
+\r
+Note: Other\Maintained\Application\Shell\Shell.inf corresponds to Minimum shell binaries.\r
+      Other\Maintained\Application\Shell\ShellFull.inf corresponds to Full Shell binaries.
\ No newline at end of file