<!-- ***** BEGIN LICENSE BLOCK *****
- Version: MPL 1.1/GPL 2.0/LGPL 2.1
-
- The contents of this file are subject to the Mozilla Public License Version
- 1.1 (the "License"); you may not use this file except in compliance with
- the License. You may obtain a copy of the License at
- http://www.mozilla.org/MPL/
-
- Software distributed under the License is distributed on an "AS IS" basis,
- WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
- for the specific language governing rights and limitations under the
- License.
-
- The Original Code is PyXPCOM.
-
- The Initial Developer of the Original Code is
- ActiveState Tool Corporation.
- Portions created by the Initial Developer are Copyright (C) 2000-2001
- the Initial Developer. All Rights Reserved.
-
- Contributor(s):
-
- Alternatively, the contents of this file may be used under the terms of
- either the GNU General Public License Version 2 or later (the "GPL"), or
- the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
- in which case the provisions of the GPL or the LGPL are applicable instead
- of those above. If you wish to allow use of your version of this file only
- under the terms of either the GPL or the LGPL, and not to allow others to
- use your version of this file under the terms of the MPL, indicate your
- decision by deleting the provisions above and replace them with the notice
- and other provisions required by the LGPL or the GPL. If you do not delete
- the provisions above, a recipient may use your version of this file under
- the terms of any one of the MPL, the GPL or the LGPL.
-
- ***** END LICENSE BLOCK ***** -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<title>Building the Python XPCOM package</title>
</head>
<body>
<h1>Building the Python XPCOM package.</h1>
<p>This file describes how to build the Python XPCOM C++ sources.</p>
<p>There are the following steps</p>
<ul>
<li><a href="#ConfiguringTheEnvironment">Configure environment variables</a></li>
<li><a href="#BuildingTheSources">Building the sources</a></li>
</ul>
<p>Testing etc is described in the <a href="../readme.html">main readme</a>.</p>
<h2><a name="ConfiguringTheEnvironment">Configuring environment variables</a></h2>
<h3> MOZ_SRC </h3>
<p><b>Windows: </b>Run the standard MOZENV.BAT used to build Mozilla. This
sets MOZ_SRC</p>
<p><b>Unix:</b> Set MOZ_SRC to point to the base source directory - assumes
"mozilla" sub-directory with mozilla directory tree under that. eg: assuming
<i>/home/user/src/mozilla/dist/...</i>"</p>
<pre>export MOZ_SRC=/home/user/src</pre>
<h3>PYTHON_SRC</h3>
<p><b>Windows:</b> Set <i> PYTHON_SRC</i> to point to the base Python source directory.
eg: assuming <i>c:\src\python\PCBuild\...</i><pre>set PYTHON_SRC=c:\src\python</pre>
<p>Unix: Set PYTHON_SRC to point to the base of an "installed" Python
tree. eg:<pre>export PYTHON_SRC=/usr/local/ActivePython-1.6</pre>
<h2><a name="BuildingTheSources">Building the sources</a></h2>
<p>You must ensure some environment variables are setup. The section on <a href="#ConfiguringTheEnvironment">configuring
environment variables explains how.</a></p>
<p>There are 2 build processes to run All C++ sources are in the <i>xpcom\src</i>
directory.:</p>
<h3>Windows</h3>
<ul>
<li> Execute "compile.py" in this directory. This will take <i>Setup.in</i>, create an MSDev project, and build
<i>..\_xpcom.pyd</i> and <i>..\_xpcom_d.pyd</i>"</li>
<li> Change to the <i>loader</i> directory.</li>
<li> Run <i>nmake -f makefile.win</i>. This will create <i>pyloader.dll</i>, and
automatically copy it to the Mozilla build directory.</li>
<a href="#ConfiguringTheEnvironment">
</ul>
<p>Finally, </a><a href="../readme.html#RunningTheTests">run the tests</a>,
where we also test everything imports correctly.</p>
<h3>Linux</h3>
<p><b> NOTE:</b> Do not attempt to use "Setup.in" to create a Makefile </p>
<ul>
<li>Run "make" in this directory. This will create <i>../_xpcommodule.so</i></li>
<li> Run "make" in the loader directory. This will create <i>libpyloader.so</i>,
and copy it to the Mozilla directory.</li>
<a href="#ConfiguringTheEnvironment">
</ul>
<p>Finally, </a><a href="../readme.html#RunningTheTests">running the tests</a>,
where we also test everything imports correctly.</p>
</body>
</html>
bc15957bed