Revert changes from r860 for makefiles that are only used
[people/mcb30/basetools.git] / BuildNotes.txt
index 71463bb..ea1ec0d 100644 (file)
@@ -11,25 +11,23 @@ Copyright (c) 2007, Intel Corporation
 -------------------------------------------------------------------------------\r
 Quick Start\r
 -----------\r
 -------------------------------------------------------------------------------\r
 Quick Start\r
 -----------\r
-  Set the EDK_TOOLS_PATH to be the root directory of the tools (the root\r
-  directory contains the Bin\ directory.)\r
+  a) Set the PYTHON_FREEZER_PATH to the cx_Freeze installation directory\r
+  b) Go to the <buildtools_project>/BaseTools and run "toolsetup" script\r
 \r
 Supported build targets\r
 -----------------------\r
 \r
 \r
 Supported build targets\r
 -----------------------\r
 \r
-all                            - Incremental Build of all C based tools. This is the default target\r
-clean     - Clean intermediate files\r
-cleanall  - Clean all generated files and directories during build\r
+build(or none)  - Incremental Build of all C based tools. This is the default target\r
+rebuild         - Clean all generated files and directories during build, and rebuild all tools\r
 \r
 -------------------------------------------------------------------------------\r
 \r
 -------------------------------------------------------------------------------\r
-\r
 Tools in Python\r
 ---------------\r
 * Convert Python source to exe file\r
 Tools in Python\r
 ---------------\r
 * Convert Python source to exe file\r
-  The tools written in Python can be coverted into executable program which can \r
+  The tools written in Python can be converted into executable program which can \r
   be executed without installing a Python interpreter. \r
 \r
   be executed without installing a Python interpreter. \r
 \r
-  For Windows and Linux, the convertion tool package is called cx_Freeze, its\r
+  For Windows and Linux, the conversion tool package is called cx_Freeze, its\r
   home page is:\r
 \r
                http://sourceforge.net/projects/cx-freeze/\r
   home page is:\r
 \r
                http://sourceforge.net/projects/cx-freeze/\r
@@ -49,3 +47,18 @@ Tools in Python
   \r
   C:\Work\BaseTools\Source\Python> set PYTHONPATH=C:\Work\BaseTools\Source\Python\r
   C:\Work\BaseTools\Source\Python> c:\cx_Freeze-3.0.3\FreezePython.exe --include-modules=encodings.cp437,encodings.gbk,encodings.utf_16,encodings.utf_8 --install-dir=C:\Work\BaseTools\Bin\Win32 build\build.py\r
   \r
   C:\Work\BaseTools\Source\Python> set PYTHONPATH=C:\Work\BaseTools\Source\Python\r
   C:\Work\BaseTools\Source\Python> c:\cx_Freeze-3.0.3\FreezePython.exe --include-modules=encodings.cp437,encodings.gbk,encodings.utf_16,encodings.utf_8 --install-dir=C:\Work\BaseTools\Bin\Win32 build\build.py\r
+\r
+* Execute tools written in Python without conversion\r
+  The tools written in Python can be executed directly from its source directory\r
+as long as the Python interpreter (Python 2.5) has been installed. Before the execution,\r
+please make sure the environment variable PYTHONPATH is set to \r
+\r
+        <buildtools_project>/BaseTools/Source/Python\r
+\r
+  There're four tools written in Python. The entrance file of each tool is listed\r
+below.\r
+\r
+      build               <buildtools_project>/BaseTools/Source/Python/build/build.py\r
+      GenFds              <buildtools_project>/BaseTools/Source/Python/GenFds/GenFds.py\r
+      Trim                <buildtools_project>/BaseTools/Source/Python/Trim/Trim.py\r
+      MigrationMsa2Inf    <buildtools_project>/BaseTools/Source/Python/MigrationMsa2Inf/MigrationMsa2Inf.py\r