diff options
Diffstat (limited to 'python/pykde/doc/install.html')
-rw-r--r-- | python/pykde/doc/install.html | 181 |
1 files changed, 0 insertions, 181 deletions
diff --git a/python/pykde/doc/install.html b/python/pykde/doc/install.html deleted file mode 100644 index d75bbbe7..00000000 --- a/python/pykde/doc/install.html +++ /dev/null @@ -1,181 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN - "http://www.w3.org/TR/html4/loose.dtd""> -<html> -<head> - <title>Installation</title> - <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <meta name="GENERATOR" content="Quanta Plus"> -</head> -<body> -<DIV -CLASS="NAVHEADER" -><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0"> -<TR><TH COLSPAN="3" ALIGN="center">Python Bindings for KDE (PyKDE-3.16.0)</TH></TR> -<TR><TD WIDTH="10%" ALIGN="left" VALIGN="bottom"><A HREF="index1.html" ACCESSKEY="P">Prev</A></TD> -<TD WIDTH="80%" ALIGN="center" VALIGN="bottom"></TD> -<TD WIDTH="10%" ALIGN="right" VALIGN="bottom"><A HREF="trouble.html" ACCESSKEY="N">Next</A></TD> -</TR> -</TABLE><HR ALIGN="LEFT" WIDTH="100%"></DIV> -<h1>Installation</h1> -These docs only cover installing PyKDE from source (ie building and compiling PyKDE). You -should read the "Testing" section at the end of this page even if installing from RPMs. RPM -installs also have the same System Requirements as noted in the next section. -<p> -Before reporting bugs, please read the <a href="trouble.html">Troubleshooting</a> and -<a href="switches.html">build.py Options</a> pages. -</p> -<h2>System Requirements</h2> -<p>PyKDE only runs on Linux or other Unix-based systems. The usual tools (compiler, -linker, make, etc) are required. In addition you need: -</p> -<dl> -<dt>sip</dt> -<dd> -sip must be installed. sip is the bindings code generator and run-time lib for PyKDE. You can get it -<a href="http://www.riverbankcomputing.co.uk/sip/download.php">here</a> -</dd> -<dt>PyQt</dt> -<dd> -PyQt must be installed Just as KDE depends on Qt, PyKDE depends on PyQt. If you don't already have -PyQt installed, you can get it <a href="http://www.riverbankcomputing.co.uk/pyqt/download.php">here</a></dd> -</dl> -<p> -<b>NOTE: sip, PyQt, and PyKDE must be compatible versions (the PyKDE build script will test -for this). That means if you are installing PyKDE-3.16.0, you must have installed:</b> -</p> -<ul> -<li><b>sip-x11-gpl-4.2.0 or later (earlier sip 4 versions may work, but are untested)</b></li> -<li><b>PyQt-x11-gpl-@PyQt Version@ or later</b></li> -</ul> -<p> -Of course you must also have Python (version 2.2 or later), KDE (any KDE 3.0 - 3.5.3 version) -and Qt (any version from 3.0 through 3.3.x) installed. PyKDE no longer supports KDE1 or KDE2. -These files only work with KDE and Qt 3.x.x - they don't work with Qt4 or the upcoming KDE 4. -</p> -<h4>If PyQt was installed from an RPM ---</h4> -<p> -If you have installed sip and PyQt from binaries, to build PyKDE you <b>must</b> have -the sipconfig.py and pyqtconfig.py files (suitable for your environment) installed. These -are in the same location as the PyQt files (usually python/site-packages). These config -files are generated automatically if you build/compile sip and PyQt from source. -</p> -<p> -PyKDE also requires the PyQt sip files to build and compile. If you installed PyQt from an -RPM, you also need to have installed the corresponding "PyQt-devel" RPM, which contains the -PyQt sip files. -</p> -<h2>Installing from source code</h2> -<p> -Unpack the PyKDE tarball to a directory you have write access to. /usr/local is a good choice -if you have write access or can obtain it. Some place in your home directory is also a good -choice. I'll assume /usr/local for these instructions. -</p> -<p> -Change to the PyKDE directory (eg "cd /usr/local/PyKDE-3.16.0" or whatever the complete -version of the downloaded PyKDE package was). -</p> -<p> -At a command line prompt (as a user, not as root), enter: -</p> -<table border="0" bgcolor="#E0E0E0" width="100%"> -<tr> -<td> -<pre CLASS="PROGRAMLISTING"> - python configure.py -</pre> -</td> -</tr> -</table> -<p> -<i>configure.py</i> will check your system to locate Python and releated files, Qt, KDE, sip and PyQt. It -will also run several tests, and then begin generating the C++ code and make files for PyKDE. The entire -process should take about 2 to 10 minutes depending on your computer's speed and available memory. -<i>configure.py</i> will report its progress throughout its run. If errors occur, see the sections on -troubleshooting below. -</p> -<p> -After <i>configure.py</i> has run to completion successfully, you next need to compile PyKDE. Simply -type: -</p> -<table border="0" bgcolor="#E0E0E0" width="100%"> -<tr> -<td> -<pre CLASS="PROGRAMLISTING"> - make -</pre> -</td> -</tr> -</table> -<p> -PyKDE takes anywhere from 15 minutes to over an hour to compile, depending on the speed of your -computer, available memory, and other tasks running. Once PyKDE has compiled, do: -</p> -<table border="0" bgcolor="#E0E0E0" width="100%"> -<tr> -<td> -<pre CLASS="PROGRAMLISTING"> - su -c"make install" -</pre> -</td> -</tr> -</table> -<p> -Your system will ask for your root password, and if entered correctly will proceed to install -PyKDE. -</p> -<h2>File concatention</h2> -<p> -If your computer has 256MB or more of memory, you will probably benefit from "file concatenation". -When generating C++ files, sip can generate either a single file for each class in a module, or a -single huge file that contains all classes in the module. The latter is the "concatenated" version. -</p> -<p> -As long as swapping doesn't occur and memory isn't exhausted, the concatenated files will compile -up to 80% faster than individual files. However, some hardware and some gcc versions are not -compatible with the large concatenated files. You can control whether sip concatenates files -by passing either the -i switch (concatenation off) or -c switch (concatenation on) to configure.py. -</p> -<p> -configure.py is currently programmed to detect the gcc version being used, and will turn on -concatenation for gcc earlier than 4.0 and turn off concatentation for gcc 4.0 or later. You -can override this automatic choice with -i or -c as needed. -</p> -<h2>Testing the installation</h2> -<p> -There are a number of things you can do to test your installation. The simplest test that also -covers the most common errors is (still in the top level PyKDE directory): -</p> -<table border="0" bgcolor="#E0E0E0" width="100%"> -<tr> -<td> -<pre CLASS="PROGRAMLISTING"> - python importTest.py -</pre> -</td> -</tr> -</table> -<p> -If you get errors running this test, see the troubleshooting section below. -</p> -<p> -There are also sample programs you can run (which also test some of PyKDE's features) in the -examples/ and templates/ subdirectories. -</p> - -<DIV CLASS="NAVFOOTER"> -<HR ALIGN="LEFT" WIDTH="100%"> -<TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" > -<TR> -<TD WIDTH="33%" ALIGN="left" VALIGN="top"><A HREF="index1.html" ACCESSKEY="P">Prev</A></TD> -<TD WIDTH="34%" ALIGN="center" VALIGN="top"><A HREF="index.html" ACCESSKEY="H">Home</A></TD> -<TD WIDTH="33%" ALIGN="right" VALIGN="top"><A HREF="trouble.html" ACCESSKEY="N">Next</A></TD> -</TR> -<TR> -<TD WIDTH="33%" ALIGN="left" VALIGN="top">Introduction</TD> -<TD WIDTH="34%" ALIGN="center" VALIGN="top"> </TD> -<TD WIDTH="33%" ALIGN="right" VALIGN="top">Troubleshooting</TD> -</TR> -</TABLE> -</DIV> -</body> -</html> |