You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
pytde/doc/switches.html

254 lines
10 KiB

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN
"http://www.w3.org/TR/html4/loose.dtd"">
<html>
<head>
<title>Switches</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="trouble.html" ACCESSKEY="P">Prev</A></TD>
<TD WIDTH="80%" ALIGN="center" VALIGN="bottom"></TD>
<TD WIDTH="10%" ALIGN="right" VALIGN="bottom"><A HREF="examples.html" ACCESSKEY="N">Next</A></TD>
</TR>
</TABLE><HR ALIGN="LEFT" WIDTH="100%"></DIV>
<h1>configure.py Options</h1>
<p>
PyKDE builds and installs in a lot of different environments and it isn't always possible to
foresee where users or distributions will locate components that PyKDE depends on. There are
a number of command line switches used to force configure.py to look in the correct locations for
directories or files.
</p>
<table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
<td>
<pre CLASS="PROGRAMLISTING">
python configure.py -h
Usage:
python configure.py [-h] [-c] [-d dir] [-g] [-j #] [-k] [-n dir] [-o dir] [-r] [-u] [-v dir] [-z file]
where:
-h displays this help message
-c concatenates each module's C/C++ source files [default]
-d dir where the PyKDE modules will be installed [default /usr/lib/python2.3/site-packages]
-g always release the GIL (SIP v3.x behaviour)
-i no concatenation of each module's C/C++ source files
-j # splits the concatenated C++ source files into # pieces [default 1]
-k dir the KDE base directory
-n dir the directory containing the KDE lib files
-o dir the directory containing the KDE header files
-r generates code with tracing enabled [default disabled]
-u build with debugging symbols
-v dir where the PyKDE .sip files will be installed [default /usr/share/sip]
-w turn on KDE deprecated object warnings when compiling [default off]
-z file the name of a file containing command line flags
If reporting errors, paste all of the output above into your
message and post to the PyKDE mailing list at:
mailto: PyKDE@mats.imk.fraunhofer.de
subscribe: http://mats.imk.fraunhofer.de/mailman/listinfo/pykde
You can redirect the output into a file (> output.txt) if needed
</pre>
</td>
</tr>
</table>
<p>
NOTE: In the descriptions below "Default" is a "typical" value for common distributions <b>and
may not be the complete path needed</b>. You should always specify the complete path.
configure.py searches a number of locations in looking for the appropriate directories,
which may depend on the distribution used, where the version of Python used to run
configure.py is located, and other factors. For example, a default value of "python/site-packages"
could be "/usr/lib/python/site-packages", "/usr/local/python2.3/site-packages" or other values
depending on how and where Python is installed or which of several installed versions of Python
is used to run configure.py. configure.py will not try to complete the path for switch specified paths -
you <b>must</b> specifiy the complete path (eg /usr/lib/python/site-packages or ../tdecore)
</p>
<p>
For "normal" installations, configure.py will automatically discover all of the information covered by
the options below -- it is only necessary to use the options switches when configure.py can't discover
a location by itself.
</p>
<hr>
<dl>
<dt><b>-c Concatenation</b></dt>
<dd>
Building PyKDE involves loading a large number of cpp and h files. The compile process can be speeded up
considerably (by as much as 80%) by concatenating all of the cpp files into a one (or several - see -j) large
cpp file. The price for this speed up is a large increase in memory usage. By default, the feature is
'on' in configure.py. To turn this feature off, use '-i'. You may wish to turn this off if the system doing
the compile has 128MB or less RAM.
</dd>
<hr>
<dt><b>-d Installation directory</b></dt>
<dd>
<table width = "100%"><tr>
<td width = "20%"><u>Value:</u> directory path</td>
<td width = "20%"> </td>
<td width = "40%"><u>configure.py Default:</u> python/site-packages/</td>
<td width = "20%"> </td>
</tr></table>
Normally, the PyKDE modules are installed in python/site-packages. Writing to this directory requires
root access. RPM builders sometimes need to build the modules to a different directory, or you may want
to install the modules in a different location (for example, in a subdirectory of site-packages/). For this
option to be useful, you need to ensure that Python can still locate and import the PyKDE modules from
the specified destination.
</dd>
<hr>
<dt><b>-g Always release GIL (sip 3.0 behaviour)</b></dt>
<dd>
This is a code generation option that only affects sip 4.0. It causes sip to generate C++
whose threading behavior is more like sip 3.0.
</dd>
<hr>
<dt><b>-i NO Concatenation</b></dt>
<dd>
This option causes configure.py to generate C++ code and makefiles that compile many small file
one at a time (rather than one huge file for each module). This increase compile time by about
80%, but reduces memory consumption. See -c above.
</dd>
<hr>
<dt><b>-j # of splits of concatenated files</b></dt>
<dd>
<table width = "100%"><tr>
<td width = "20%"><u>Value:</u> number of splits </td>
<td width = "20%"> </td>
<td width = "40%"><u>configure.py Default:</u> 1</td>
<td width = "20%"> </td>
</tr></table>
Intended for use on multi-CPU systems. Splits the concatenated cpp file into the specified number
of segments, each of which can be compiled concurrently in separate threads. On single processor
systems, each "split" will compile in sequence. The tdeui module is (with concatenation active)
is split into two pieces by default to reduce memory consumption. Values for 'j' greater than
2 will be honored correctly.
</dd>
<hr>
<dt><b>-k KDE base directory</b></dt>
<dd>
<table width = "100%"><tr>
<td width = "20%"><u>Value:</u> directory path</td>
<td width = "20%"> </td>
<td width = "40%"><u>configure.py Default:</u> trinity/</td>
<td width = "20%"> </td>
</tr></table>
The top level directory under which trinity/libs and trinity/include are located (these paths can also
be specified independently see -n and -o) On SuSE distributions, this is typically /opt/trinity. On
Red Hat and Mandrake, this is typically /usr. configure.py will find the typical locations automatically.
configure .py will use the KDEDIR environment variable value if it is defined and the -k switch is NOT used.
</dd>
<hr>
<dt><b>-n KDE library files</b></dt>
<dd>
<table width = "100%"><tr>
<td width = "20%"><u>Value:</u> directory path</td>
<td width = "20%"> </td>
<td width = "40%"><u>configure.py Default:</u> trinity/libs</td>
<td width = "20%"> </td>
</tr></table>
The path to KDE's library files (libtdecore.so, etc).
</dd>
<hr>
<dt><b>-o KDE h files</b></dt>
<dd>
<table width = "100%"><tr>
<td width = "20%"><u>Value:</u> directory path</td>
<td width = "20%"> </td>
<td width = "40%"><u>configure.py Default:</u> trinity/include</td>
<td width = "20%"> </td>
</tr></table>
The path to KDE's h files. (May require installation of tdelibs3-devel rpm package)
configure.py. PyKDE will locate h files in subdirectories of this path automatically (eg trinity/include/kio/*.h)
</dd>
<hr>
<dt><b>-r generate code with tracing enabled</b></dt>
<dd>
For debugging
</dd>
<hr>
<dt><b>-u debugging symbols</b></dt>
<dd>
For debugging
</dd>
<hr>
<dt><b>-v PyKDE sip files</b></dt>
<dd>
<table width = "100%"><tr>
<td width = "20%"><u>Value:</u> directory path</td>
<td width = "20%"> </td>
<td width = "40%"><u>configure.py Default:</u> /usr/share/sip/</td>
<td width = "20%"> </td>
</tr></table>
The path where the PyKDE sip files will be copied (for use by programs that use sip binding
dependent on PyKDE)
</dd>
<hr>
<dt><b>-w KDE deprecation warnings</b></dt>
<dd>
KDE marks a number of methods as 'deprecated'. The methods marked will generate warnings
at compile time. By default, PyKDE's configure.py turns these warnings off. -w will turn
them on.
</dd>
<hr>
<dt><b>-z Path to configure.py options file</b></dt>
<dd>
<table width = "100%"><tr>
<td width = "20%"><u>Value:</u> filename or path</td>
<td width = "20%"> </td>
<td width = "40%"><u>configure.py Default:</u> none</td>
<td width = "20%"> </td>
</tr></table>
If your site requires the use of more than one or two option switches, you can place all of the options
in a text file and then reference only the text file's path and name on the command line. The options
are placed in the text file just as they would be on the command line, with one option per line.
For example, the options file for the command "python configure.py -c- -v /usr/local/PyQt/sip" would look
like:
<h4><u>options.txt</u></h4>
<table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
<td>
<pre CLASS="PROGRAMLISTING">
-c
-v /usr/local/PyQt/sip
</pre>
</td>
</tr>
</table>
<p></p>
and would be run as "python configure.py -z options.txt" (assuming options.txt is in the current directory).
</dd>
<hr>
<dt><b>-l (lower case L) code gen control -- not displayed with -h</b></dt>
<dd>
If for some reason you need to rebuild a PyKDE module but not all of PyKDE, you can use -l.
-l &lt;modulename&gt; (eg -l tdecore) will rebuild only the module specified; -l &lt;modulename&gt;:
(eg -l tdecore:) will rebuild the module specified and all successive modules. If changes are
made that affect linking (especially deleting methods or other symbols), you must use the
":" form, since later modules depend on earlier modules.
</dd>
</dl>
<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="trouble.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="examples.html" ACCESSKEY="N">Next</A></TD>
</TR>
<TR>
<TD WIDTH="33%" ALIGN="left" VALIGN="top">Troubleshooting</TD>
<TD WIDTH="34%" ALIGN="center" VALIGN="top">&nbsp;</TD>
<TD WIDTH="33%" ALIGN="right" VALIGN="top">Class Reference Documentation</TD>
</TR>
</TABLE>
</DIV>
</body>
</html>