diff options
Diffstat (limited to '')
| -rw-r--r-- | src/libs/xpcom18a4/python/readme.html | 121 |
1 files changed, 121 insertions, 0 deletions
diff --git a/src/libs/xpcom18a4/python/readme.html b/src/libs/xpcom18a4/python/readme.html new file mode 100644 index 00000000..112f43e0 --- /dev/null +++ b/src/libs/xpcom18a4/python/readme.html @@ -0,0 +1,121 @@ +<html> +<!-- ***** 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 ***** --> + +<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>Python XPCOM module</title> +</head> + +<body> + +<h1>Python XPCOM Package</h1> + +<p>Mozilla CVS Version - Last updated May 2002</p> +<p>This is the readme for the Python interface to <b>XPCOM</b>.</p> +<p><b>XPCOM </b>is an acronym for "Cross Platform COM". It has +come out of the <a href="http://www.mozilla.org">Mozilla</a> project, which +maintains the <a href="http://www.mozilla.org/projects/xpcom/">main XPCOM +project pages.</a> The Python XPCOM package is a set of Python bindings to +XPCOM, allowing a Python programmer to both use and implement XPCOM +interfaces. If you don't know what <a href="http://www.python.org">Python</a> +is, then none of this probably interests you at all!</p> +<p>This readme has links to the following information:</p> +<ul> + <li><a href="doc/configure.html">Building, Configuring and + Testing the Python + XPCOM Package</a></li> + <li><a href="doc/tutorial.html">A tutorial for the Python XPCOM package</a></li> + <li>Some <a href="doc/advanced.html">advanced + topics and other miscellaneous information</a></li> + <li><a href="doc/architecture.html">Information on the architecture</a></li> + <li>A list of the <a href="#KnownBugs">known issues and bugs</a>, the <a href="#ReleaseHistory">release + history</a> and the <a href="doc/credits.html">PyXPCOM acknowledgements</a></li> +</ul> +<p>Note: <b>This package requires Python 1.6 or later</b>; we recommend using +the latest +official Python version. This package works +very well with the latest <a href="http://www.ActiveState.com/Products/ActivePython">ActivePython</a>, +and does not require any external modules or packages beyond what is provided in +the core Python release for each platform.</p> +<h2>About the Python XPCOM Package</h2> +<p>The Python XPCOM Package was developed by <a href="http://www.ActiveState.com">ActiveState +Tool Corporation</a>, and came out of their <a href="http://www.ActiveState.com/Products/Komodo">Komodo +project</a>. The Python XPCOM package is released under the <a href="http://www.mozilla.org/MPL/">Mozilla +Public License (MPL)</a></p> +<p>Please see the <a href="doc/credits.html">credits file</a> for a list of +contributors. </p> +<h2><a name="KnownBugs">Known Bugs</a>/Issues</h2> +<ul> + <li>No attempt is made to recurse sub-directories of the main +"components" directory. This is because we may decide on some +smart scheme for recursion (similar to Python packages), and don't want people +to rely on simple recursive searches.</li> + <li>No unregistration support at all. The main Python Component Loader supports + unregistration, but the actual Python objects themselves do not support unregistration. It is unclear if the Component Loader + unregistration process needs to manually remove each component it is responsible +for.</li> + <li>All Python-implemented components unconditionally support +weak-references. There is no way to disable this feature for any or all +components. It is unclear if there is a need to prevent this, but it is +documented here just in case!</li> +</ul> +<h2><a name="ReleaseHistory">Release History</a></h2> +<h3>Version 0.90 - January 2001</h3> +<ul> + <li>First public release.</li> +</ul> +<h3>Version 0.91 - January 2001</h3> +<ul> + <li>Fix a seg fault on Linux when PYTHONPATH is not set.</li> + <li>Changes to allow building with stand-alone XPCOM.</li> +</ul> + +<h3>Version 0.92 - May 2001</h3> +<p>Implement interface flattening. You should (almost) never need to use <i>QueryInterface()</i>! +We are still 100% backwards compatible, so usage of QI still works - just is +generally not necessary.</p> + +<h3>Version 0.93 - May 2002</h3> + +<p>Implement <i>nsIVariant</i> and all new string types. Complete move to +autoconf build system.</p> + +</body> + +</html> |