1) Updated BuildNotes.txt
[people/mcb30/basetools.git] / BuildNotes.txt
1 Intel(R) Platform Innovation Framework for EFI\r
2 BuildTools Project, BaseTools Sub-Project\r
3 Root Package 1.00\r
4 2007-08-31\r
5 \r
6 Intel is a trademark or registered trademark of Intel Corporation or its\r
7 subsidiaries in the United States and other countries.\r
8 * Other names and brands may be claimed as the property of others.\r
9 Copyright (c) 2007, Intel Corporation\r
10 \r
11 -------------------------------------------------------------------------------\r
12 Quick Start\r
13 -----------\r
14   a) Set the PYTHON_FREEZER_PATH to the cx_Freeze installation directory\r
15   b) Go to the <buildtools_project>/BaseTools and run "toolsetup" script\r
16 \r
17 Supported build targets\r
18 -----------------------\r
19 \r
20 build(or none)  - Incremental Build of all C based tools. This is the default target\r
21 rebuild         - Clean all generated files and directories during build, and rebuild all tools\r
22 \r
23 -------------------------------------------------------------------------------\r
24 Tools in Python\r
25 ---------------\r
26 * Convert Python source to exe file\r
27   The tools written in Python can be coverted into executable program which can \r
28   be executed without installing a Python interpreter. \r
29 \r
30   For Windows and Linux, the convertion tool package is called cx_Freeze, its\r
31   home page is:\r
32 \r
33                 http://sourceforge.net/projects/cx-freeze/\r
34 \r
35         If you have installed cx_Freeze at c:\cx_Freeze-3.0.3. Use following command\r
36   lines to convert MyBuild.py to MyBuild.exe (note this is an example, there is\r
37   no MyBuild Python project in the BaseTools\Python tree.\r
38 \r
39     set PYTHONPATH=<BaseToolsDirPath>\Source\Python\r
40         c:\cx_Freeze-3.0.3\FreezePython.exe --include-modules=encodings.cp437,encodings.gbk,encodings.utf_16,encodings.utf_8 --install-dir=.\mybuild MyBuild.py\r
41 \r
42         The generated .exe (and .dll) files are put in "mybuild" subdirectory.\r
43 \r
44   The following is a real example with the BuildTools/trunk/BaseTools project \r
45   installed in: C:\Work\BaseTools\r
46 \r
47   \r
48   C:\Work\BaseTools\Source\Python> set PYTHONPATH=C:\Work\BaseTools\Source\Python\r
49   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
50 \r
51 * Execute tools written in Python without convertion\r
52   The tools written in Python can be executely directly from its source directory\r
53 as long as the Python interpreter (Python 2.5) has been installed. Before the execution,\r
54 please make sure the environment variable PYTHONPATH is set to \r
55 \r
56         <buildtools_project>/BaseTools/Source/Python\r
57 \r
58   There're four tools written in Python. The entrance file of each tool is listed\r
59 below.\r
60 \r
61       build               <buildtools_project>/BaseTools/Source/Python/build/build.py\r
62       GenFds              <buildtools_project>/BaseTools/Source/Python/GenFds/GenFds.py\r
63       Trim                <buildtools_project>/BaseTools/Source/Python/Trim/Trim.py\r
64       MigrationMsa2Inf    <buildtools_project>/BaseTools/Source/Python/MigrationMsa2Inf/MigrationMsa2Inf.py\r
65 \r