1
<!-- Copyright (c) 2000-2001 ActiveState Tool Corporation. -->
2
<!-- See the file LICENSE.txt for licensing information. -->
7
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
8
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
9
<meta name="ProgId" content="FrontPage.Editor.Document">
10
<title>Building the Python XPCOM package</title>
15
<h1>Building the Python XPCOM package.</h1>
17
<p>This file describes how to build the Python XPCOM C++ sources.</p>
18
<p>There are the following steps</p>
20
<li><a href="#ConfiguringTheEnvironment">Configure environment variables</a></li>
21
<li><a href="#BuildingTheSources">Building the sources</a></li>
23
<p>Testing etc is described in the <a href="../readme.html">main readme</a>.</p>
24
<h2><a name="ConfiguringTheEnvironment">Configuring environment variables</a></h2>
25
<h3> MOZ_SRC </h3>
26
<p><b>Windows: </b>Run the standard MOZENV.BAT used to build Mozilla. This
28
<p><b>Unix:</b> Set MOZ_SRC to point to the base source directory - assumes
29
"mozilla" sub-directory with mozilla directory tree under that. eg: assuming
30
<i>/home/user/src/mozilla/dist/...</i>"</p>
31
<pre>export MOZ_SRC=/home/user/src</pre>
33
<p><b>Windows:</b> Set <i> PYTHON_SRC</i> to point to the base Python source directory.
34
eg: assuming <i>c:\src\python\PCBuild\...</i><pre>set PYTHON_SRC=c:\src\python</pre>
35
<p>Unix: Set PYTHON_SRC to point to the base of an "installed" Python
36
tree. eg:<pre>export PYTHON_SRC=/usr/local/ActivePython-1.6</pre>
37
<h2><a name="BuildingTheSources">Building the sources</a></h2>
38
<p>You must ensure some environment variables are setup. The section on <a href="#ConfiguringTheEnvironment">configuring
39
environment variables explains how.</a></p>
40
<p>There are 2 build processes to run All C++ sources are in the <i>xpcom\src</i>
44
<li> Execute "compile.py" in this directory. This will take <i>Setup.in</i>, create an MSDev project, and build
45
<i>..\_xpcom.pyd</i> and <i>..\_xpcom_d.pyd</i>"</li>
46
<li> Change to the <i>loader</i> directory.</li>
47
<li> Run <i>nmake -f makefile.win</i>. This will create <i>pyloader.dll</i>, and
48
automatically copy it to the Mozilla build directory.</li>
49
<a href="#ConfiguringTheEnvironment">
51
<p>Finally, </a><a href="../readme.html#RunningTheTests">run the tests</a>,
52
where we also test everything imports correctly.</p>
54
<p><b> NOTE:</b> Do not attempt to use "Setup.in" to create a Makefile </p>
56
<li>Run "make" in this directory. This will create <i>../_xpcommodule.so</i></li>
57
<li> Run "make" in the loader directory. This will create <i>libpyloader.so</i>,
58
and copy it to the Mozilla directory.</li>
59
<a href="#ConfiguringTheEnvironment">
61
<p>Finally, </a><a href="../readme.html#RunningTheTests">running the tests</a>,
62
where we also test everything imports correctly.</p>