Commits

cthedot committed 3024a96

release 0.9.4b1

Comments (0)

Files changed (14)

documentation_html/ANN.html

+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" />
+<title></title>
+<link rel="stylesheet" href="documentation/default.css#/documentation/default.css0" type="text/css" />
+</head>
+<body>
+<div class="document">
+
+
+<div class="section" id="what-is-it">
+<h1>what is it</h1>
+<p>A Python package to parse and build CSS Cascading Style Sheets.</p>
+</div>
+<div class="section" id="main-changes-since-0-9-4a4">
+<h1>main changes since 0.9.4a4</h1>
+<p>for full details for 0.9.4b1 see the relevant CHANGELOG:  <a class="reference external" href="http://cssutils.googlecode.com/svn/tags/TAG_0.9.4b1/CHANGELOG.html">http://cssutils.googlecode.com/svn/tags/TAG_0.9.4b1/CHANGELOG.txt</a></p>
+<dl class="docutils">
+<dt>0.9.4b1</dt>
+<dd><ul class="first simple">
+<li><strong>FEATURE</strong>: Added <tt class="docutils literal"><span class="pre">csscombine</span></tt> script which currently resolves @import rules into the input sheet. No nested @imports are resolved yet and @namespace rules do not work yet though!</li>
+</ul>
+<ul class="last">
+<li><p class="first"><strong>BUGFIX</strong>: Serializing escape sequences add a single SPACE after each escape. This was not present until now so a sequence like "\74 a" did come out as "\000074a" which was not as intended. Also as a SPACE is inserted in any case all escapes are not padded to 6 digits anymore but are only as long as needed.</p>
+</li>
+<li><p class="first"><strong>BUGFIX</strong>: Handling of illegal selectors is now same as the W3C CSS validator (and according the selector spec - I hope ;). Illegal selectors result the complete rule being dropped. Fixed are the following (edge) cases:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">a/**/b</span></tt></dt>
+<dd><p class="first last">Meant was probably a space between a and b (plus maybe the comment) but it MUST be inserted. IE and Safari nevertheless seem to parse this rule as <tt class="docutils literal"><span class="pre">a</span> <span class="pre">b</span></tt> so as if a space would be present. cssutils now parses this selector as intented by the spec as <tt class="docutils literal"><span class="pre">ab</span></tt>.</p>
+</dd>
+<dt><tt class="docutils literal"><span class="pre">a*b</span></tt></dt>
+<dd><p class="first last">Again spaces around the UNIVERSAL <tt class="docutils literal"><span class="pre">*</span></tt> were probably meant by the author. IE and Safari seem to parse this <strong>invalid</strong> selector as <tt class="docutils literal"><span class="pre">a</span> <span class="pre">b</span></tt>. cssutils ignores this rule completely!</p>
+</dd>
+</dl>
+</li>
+<li><p class="first">BUGFIX: <tt class="docutils literal"><span class="pre">css.CSSRuleList</span></tt> is still a Python list but setting methods like <tt class="docutils literal"><span class="pre">__init__</span></tt>, <tt class="docutils literal"><span class="pre">append</span></tt>,     <tt class="docutils literal"><span class="pre">extend</span></tt> or <tt class="docutils literal"><span class="pre">__setslice__</span></tt> are added later on instances of this class if so desired. E.g. CSSStyleSheet adds <tt class="docutils literal"><span class="pre">append</span></tt> which is not available in a simple instance of this class! This has been changed as no validation is possible in CSSRuleList itself.</p>
+</li>
+<li><p class="first">IMPROVEMENT: Added better <tt class="docutils literal"><span class="pre">str</span></tt> and <tt class="docutils literal"><span class="pre">repr</span></tt> to cssutils.serializer.Preferences</p>
+</li>
+<li><p class="first">IMPROVEMENT: Added position information to some error reportings (Property, CSSMediaRule</p>
+</li>
+<li><p class="first">some internal changes</p>
+</li>
+</ul>
+</dd>
+</dl>
+</div>
+<div class="section" id="license">
+<h1>license</h1>
+<p>cssutils is published under the LGPL.</p>
+</div>
+<div class="section" id="download">
+<h1>download</h1>
+<p>for download options for see <a class="reference external" href="http://cthedot.de/cssutils/index.html">http://cthedot.de/cssutils/</a></p>
+<p>cssutils needs Python 2.4 or higher (tested with Python 2.5 on Vista only)</p>
+<p>bug reports, comments, etc are very much appreciated!</p>
+<p>thanks, Christof</p>
+</div>
+</div>
+</body>
+</html>

documentation_html/CHANGELOG.html

 <meta name="author" content="cthedot" />
 <meta name="copyright" content="2004-2007 Christof Hoeke" />
 <meta name="date" content="2007-11-06 22:22:15 +0100 (Di, 06 Nov 2007)" />
-<link rel="stylesheet" href="documentation/default.css&#10;&#9;&#9;&#9;&#9;&#9;#/documentation/default.css0" type="text/css" />
+<link rel="stylesheet" href="documentation/default.css#/documentation/default.css0" type="text/css" />
 </head>
 <body>
 <div class="document" id="changelog">
 <p class="topic-title first">Contents</p>
 <ul class="simple">
 <li><a class="reference internal" href="#known-issues" id="id8">known issues</a></li>
-<li><a class="reference internal" href="#x" id="id9">0.9.x</a></li>
-<li><a class="reference internal" href="#id1" id="id10">0.8.x</a></li>
-<li><a class="reference internal" href="#id2" id="id11">0.6.x</a></li>
-<li><a class="reference internal" href="#id3" id="id12">0.5.x</a></li>
-<li><a class="reference internal" href="#id4" id="id13">0.4.x</a></li>
-<li><a class="reference internal" href="#id5" id="id14">0.3.x</a></li>
-<li><a class="reference internal" href="#id6" id="id15">0.2.x</a></li>
-<li><a class="reference internal" href="#id7" id="id16">0.1.x</a></li>
+<li><a class="reference internal" href="#head" id="id9">HEAD</a></li>
+<li><a class="reference internal" href="#x" id="id10">0.9.x</a></li>
+<li><a class="reference internal" href="#id1" id="id11">0.8.x</a></li>
+<li><a class="reference internal" href="#id2" id="id12">0.6.x</a></li>
+<li><a class="reference internal" href="#id3" id="id13">0.5.x</a></li>
+<li><a class="reference internal" href="#id4" id="id14">0.4.x</a></li>
+<li><a class="reference internal" href="#id5" id="id15">0.3.x</a></li>
+<li><a class="reference internal" href="#id6" id="id16">0.2.x</a></li>
+<li><a class="reference internal" href="#id7" id="id17">0.1.x</a></li>
 </ul>
 </div>
 <div class="section" id="known-issues">
 <ul>
 <li><p class="first"><tt class="docutils literal"><span class="pre">cssparse</span></tt> script does not work correctly in version 0.9.4 yet.</p>
 </li>
+<li><p class="first">although cssutils tries to preserve CSS hacks not all are yet (and some probably will never be). The following hacks are known to not be preserved:</p>
+<dl class="docutils">
+<dt>star hack</dt>
+<dd><p class="first last"><tt class="docutils literal"><span class="pre">*html</span></tt> without any whitespace</p>
+</dd>
+<dt>star7 hack</dt>
+<dd><p class="first last"><tt class="docutils literal"><span class="pre">html*#test-span</span></tt> (IMHO invalidated by the missing WS between html and "*")</p>
+</dd>
+</dl>
+<p>The main problem for cssutils users is that some stylesheets in the wild are not parsable without loosing some information, a pretty print for these sheets is simply not possible with cssutils.</p>
+<p>Generally syntactically valid stylesheets should be preserved completely (otherwise a bug in cssutils itself). Invalid stylesheets will probably loose some information like to above <tt class="docutils literal"><span class="pre">*html</span></tt> hack. Most of these hacks may be rewritten while still be usable, e.g. <tt class="docutils literal"><span class="pre">*</span> <span class="pre">html</span></tt> should work same to <tt class="docutils literal"><span class="pre">*html</span></tt>. Currenty the invalid CSS hack using <tt class="docutils literal"><span class="pre">$propertyname</span></tt> is actually preserved but still usage is discouraged. In almost any case it is possible to use at least syntactically valid CSS while still working around different browser implementations.</p>
+</li>
 <li><p class="first"><tt class="docutils literal"><span class="pre">css.UnknownRule</span></tt> is not handled properly in cases, tests are spotty there too. it also seems to have been removed in CSSOM but seems useful so is still present</p>
 </li>
 <li><p class="first">Some methods of <tt class="docutils literal"><span class="pre">css.CSSPrimitiveValue</span></tt> and subclasses <tt class="docutils literal"><span class="pre">Rect</span></tt>, <tt class="docutils literal"><span class="pre">Counter</span></tt> and <tt class="docutils literal"><span class="pre">RGBColor</span></tt> are not yet implemented. As CSSOM defines a completely different DOM for Property values they may never be implemented as defined in DOM Level 2.</p>
 <li><p class="first">Properties are not bound to any CSS Version, so all properties are handled so
 <em>NOT</em> as described in <a class="reference external" href="http://www.w3.org/TR/CSS21/syndata.html#parsing-errors">http://www.w3.org/TR/CSS21/syndata.html#parsing-errors</a> "Illegal values". (A future version might be customizable to a specific CSS version like 2.1 or 3)</p>
 </li>
-<li><p class="first">although cssutils tries to preserve CSS hacks not all are yet (and some probably will never be). The following hacks are known to not (yet) be preserved:</p>
-<dl class="docutils">
-<dt>star hack</dt>
-<dd><p class="first last"><tt class="docutils literal"><span class="pre">*html</span></tt> without any whitespace</p>
-</dd>
-<dt>star7 hack</dt>
-<dd><p class="first last"><tt class="docutils literal"><span class="pre">html*#test-span</span></tt> (IMHO invalidated by the missing WS between html and "*")</p>
-</dd>
-</dl>
-<p>The main problem for cssutils users is that some stylesheets in the wild are not parsable without loosing some information, a pretty print for these sheets is simply not possible with cssutils.</p>
-</li>
 </ul>
 </div>
+<div class="section" id="head">
+<h1><a class="toc-backref" href="#id9">HEAD</a></h1>
+<p>todo</p>
+</div>
 <div class="section" id="x">
-<h1><a class="toc-backref" href="#id9">0.9.x</a></h1>
+<h1><a class="toc-backref" href="#id10">0.9.x</a></h1>
 <dl class="docutils">
-<dt>HEAD</dt>
-<dd><ul class="first last">
-<li><p class="first"><strong>TODO</strong></p>
-<blockquote>
+<dt>0.9.4b1 071229</dt>
+<dd><ul class="first simple">
+<li><strong>FEATURE</strong>: Added <tt class="docutils literal"><span class="pre">csscombine</span></tt> script which currently resolves @import rules into the input sheet. No nested @imports are resolved yet and @namespace rules do not work yet though!</li>
+<li>FEATURE: <tt class="docutils literal"><span class="pre">css.CSSStyleSheet.insertRule(rule,</span> <span class="pre">index)</span></tt> accepts now a <tt class="docutils literal"><span class="pre">css.CSSRuleList</span></tt> in addition to a <tt class="docutils literal"><span class="pre">css.CSSRule</span></tt> object or a CSS string. Useful if you like a combine a complete sheet into an existing one.</li>
+</ul>
 <ul>
-<li><dl class="first docutils">
-<dt>CSSParse</dt>
-<dd><ul class="first last simple">
-<li>use codec</li>
-</ul>
+<li><p class="first"><strong>BUGFIX</strong>: Serializing escape sequences add a single SPACE after each escape. This was not present until now so a sequence like "\74 a" did come out as "\000074a" which was not as intended. Also as a SPACE is inserted in any case all escapes are not padded to 6 digits anymore but are only as long as needed.</p>
+</li>
+<li><p class="first"><strong>BUGFIX</strong>: Handling of illegal selectors is now same as the W3C CSS validator (and according the selector spec - I hope ;). Illegal selectors result the complete rule being dropped. Fixed are the following (edge) cases:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">a/**/b</span></tt></dt>
+<dd><p class="first last">Meant was probably a space between a and b (plus maybe the comment) but it MUST be inserted. IE and Safari nevertheless seem to parse this rule as <tt class="docutils literal"><span class="pre">a</span> <span class="pre">b</span></tt> so as if a space would be present. cssutils now parses this selector as intented by the spec as <tt class="docutils literal"><span class="pre">ab</span></tt>.</p>
+</dd>
+<dt><tt class="docutils literal"><span class="pre">a*b</span></tt></dt>
+<dd><p class="first last">Again spaces around the UNIVERSAL <tt class="docutils literal"><span class="pre">*</span></tt> were probably meant by the author. IE and Safari seem to parse this <strong>invalid</strong> selector as <tt class="docutils literal"><span class="pre">a</span> <span class="pre">b</span></tt>. cssutils ignores this rule completely!</p>
 </dd>
 </dl>
 </li>
-<li><dl class="first docutils">
-<dt>CSSCapture:</dt>
-<dd><ul class="first last simple">
-<li>for all stuff, use order of specific things (HTTP  Header, @charset , ... )</li>
-<li>save inline styles in same folder as all other sheets</li>
-</ul>
-</dd>
-</dl>
+<li><p class="first">BUGFIX: <tt class="docutils literal"><span class="pre">css.CSSRuleList</span></tt> is still a Python list but setting methods like <tt class="docutils literal"><span class="pre">__init__</span></tt>, <tt class="docutils literal"><span class="pre">append</span></tt>,     <tt class="docutils literal"><span class="pre">extend</span></tt> or <tt class="docutils literal"><span class="pre">__setslice__</span></tt> are added later on instances of this class if so desired. E.g. CSSStyleSheet adds <tt class="docutils literal"><span class="pre">append</span></tt> which is not available in a simple instance of this class! This has been changed as no validation is possible in CSSRuleList itself.</p>
 </li>
 </ul>
-</blockquote>
-</li>
+<ul class="simple">
+<li>CHANGE: Unknown media type in a MediaQuery (e.g. <tt class="docutils literal"><span class="pre">@media</span> <span class="pre">tv,</span> <span class="pre">radio</span></tt>) does emit WARNING instead of ERROR now.</li>
+</ul>
+<ul class="last simple">
+<li>IMPROVEMENT: Added better <tt class="docutils literal"><span class="pre">str</span></tt> and <tt class="docutils literal"><span class="pre">repr</span></tt> to cssutils.serializer.Preferences</li>
+<li>IMPROVEMENT: Added position information to some error reportings (Property, CSSMediaRule</li>
 </ul>
 </dd>
 <dt>0.9.4a4 071202</dt>
 </dd>
 <dt>0.9.2b3 070804</dt>
 <dd><ul class="first last simple">
-<li>FEATURE: Script <tt class="docutils literal"><span class="pre">cssparse</span></tt> handles more than one file at a time now (patch from Issue #6 by Walter Dörwald)</li>
+<li>FEATURE: Script <tt class="docutils literal"><span class="pre">cssparse</span></tt> handles more than one file at a time now (patch from Issue #6 by Walter Doerwald)</li>
 <li>BUGFIX: Fixed Issue #7: typo gave AssertionError for selectors like <tt class="docutils literal"><span class="pre">tr:nth-child(odd)</span> <span class="pre">td{}</span></tt></li>
 <li>BUGFIX: Fixed Issue #5: false warning for certain values for <tt class="docutils literal"><span class="pre">background-position</span></tt> removed</li>
 <li>BUGFIX: Report of line/col for any node was not correct if a node contained line breaks itself</li>
-<li>Quite a few internal optimizations (thanks to Walter Drwald)</li>
+<li>Quite a few internal optimizations (thanks to Walter Doerwald)</li>
 <li>Added tests for issues #3 and #4 to tokenizer too</li>
 </ul>
 </dd>
 </dl>
 </div>
 <div class="section" id="id1">
-<h1><a class="toc-backref" href="#id10">0.8.x</a></h1>
+<h1><a class="toc-backref" href="#id11">0.8.x</a></h1>
 <dl class="docutils">
 <dt>0.8a6 - 050827</dt>
 <dd><ul class="first last simple">
 </dl>
 </div>
 <div class="section" id="id2">
-<h1><a class="toc-backref" href="#id11">0.6.x</a></h1>
+<h1><a class="toc-backref" href="#id12">0.6.x</a></h1>
 <dl class="docutils">
 <dt>0.61 - 050604</dt>
 <dd><dl class="first last docutils">
 </dl>
 </div>
 <div class="section" id="id3">
-<h1><a class="toc-backref" href="#id12">0.5.x</a></h1>
+<h1><a class="toc-backref" href="#id13">0.5.x</a></h1>
 <dl class="docutils">
 <dt>0.55_52 - 040517 bugfix bugfix release</dt>
 <dd>should do test first ;)
 </dl>
 </div>
 <div class="section" id="id4">
-<h1><a class="toc-backref" href="#id13">0.4.x</a></h1>
+<h1><a class="toc-backref" href="#id14">0.4.x</a></h1>
 <dl class="docutils">
 <dt>0.41 - 040328</dt>
 <dd><p class="first">!cssnormalizer does not work in this version - on hold for 1.0</p>
 </dl>
 </div>
 <div class="section" id="id5">
-<h1><a class="toc-backref" href="#id14">0.3.x</a></h1>
+<h1><a class="toc-backref" href="#id15">0.3.x</a></h1>
 <dl class="docutils">
 <dt>0.31 - 040320</dt>
 <dd><p class="first">!cssnormalizer does not work in this version</p>
 </dl>
 </div>
 <div class="section" id="id6">
-<h1><a class="toc-backref" href="#id15">0.2.x</a></h1>
+<h1><a class="toc-backref" href="#id16">0.2.x</a></h1>
 <dl class="docutils">
 <dt>0.24_1 - 040214</dt>
 <dd>legal stuff: added licensing information
 </dl>
 </div>
 <div class="section" id="id7">
-<h1><a class="toc-backref" href="#id16">0.1.x</a></h1>
+<h1><a class="toc-backref" href="#id17">0.1.x</a></h1>
 <blockquote>
 <p>0.10 - 031221
 first version to try if i can bring it to work at all</p>

documentation_html/LICENSE.html

 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 <meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" />
 <title>GNU LESSER GENERAL PUBLIC LICENSE</title>
-<link rel="stylesheet" href="documentation/default.css&#10;&#9;&#9;&#9;&#9;&#9;#/documentation/default.css0" type="text/css" />
+<link rel="stylesheet" href="documentation/default.css#/documentation/default.css0" type="text/css" />
 </head>
 <body>
 <div class="document" id="gnu-lesser-general-public-license">

documentation_html/README.html

 <meta name="author" content="cthedot" />
 <meta name="copyright" content="2004-2007 Christof Hoeke" />
 <meta name="date" content="2007-11-08 14:42:49 +0100 (Do, 08 Nov 2007)" />
-<link rel="stylesheet" href="documentation/default.css&#10;&#9;&#9;&#9;&#9;&#9;#/documentation/default.css0" type="text/css" />
+<link rel="stylesheet" href="documentation/default.css#/documentation/default.css0" type="text/css" />
 </head>
 <body>
 <div class="document" id="cssutils">

documentation_html/documentation/backlog.html

 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 <meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" />
 <title></title>
-<link rel="stylesheet" href="../documentation/default.css&#10;&#9;&#9;&#9;&#9;&#9;#/documentation/default.css1" type="text/css" />
+<link rel="stylesheet" href="../documentation/default.css#/documentation/default.css1" type="text/css" />
 </head>
 <body>
 <div class="document">
 
 
-<p><a class="reference external" href="../index.html&#10;&#9;&#9;&#9;&#9;&#9;#/index.html1">Index</a></p>
+<p><a class="reference external" href="../index.html#/index.html1">Index</a></p>
 <div class="section" id="backlog">
 <h1><a class="toc-backref" href="#id2">backlog</a></h1>
 <table class="docutils field-list" frame="void" rules="none">

documentation_html/documentation/css.html

 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 <meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" />
 <title></title>
-<link rel="stylesheet" href="../documentation/default.css&#10;&#9;&#9;&#9;&#9;&#9;#/documentation/default.css1" type="text/css" />
+<link rel="stylesheet" href="../documentation/default.css#/documentation/default.css1" type="text/css" />
 </head>
 <body>
 <div class="document">
 
 
-<p><a class="reference external" href="../index.html&#10;&#9;&#9;&#9;&#9;&#9;#/index.html1">Index</a></p>
+<p><a class="reference external" href="../index.html#/index.html1">Index</a></p>
 <div class="section" id="package-cssutils-css">
 <h1><a class="toc-backref" href="#id1">package <tt class="docutils literal"><span class="pre">cssutils.css</span></tt></a></h1>
 <table class="docutils field-list" frame="void" rules="none">
 <li><a class="reference internal" href="#shared-attributes" id="id3">Shared Attributes</a></li>
 <li><a class="reference internal" href="#cssstylesheet" id="id4">CSSStyleSheet</a><ul>
 <li><a class="reference internal" href="#attributes" id="id5">Attributes</a></li>
+<li><a class="reference internal" href="#methods" id="id6">Methods</a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#csscharsetrule" id="id6">CSSCharsetRule</a></li>
-<li><a class="reference internal" href="#cssnamespacerule" id="id7">CSSNamespaceRule</a></li>
-<li><a class="reference internal" href="#cssimportrule" id="id8">CSSImportRule</a></li>
-<li><a class="reference internal" href="#cssmediarule" id="id9">CSSMediaRule</a></li>
-<li><a class="reference internal" href="#cssfontfacerule" id="id10">CSSFontFaceRule</a></li>
-<li><a class="reference internal" href="#csspagerule" id="id11">CSSPageRule</a></li>
-<li><a class="reference internal" href="#cssstylerule" id="id12">CSSStyleRule</a></li>
+<li><a class="reference internal" href="#csscharsetrule" id="id7">CSSCharsetRule</a></li>
+<li><a class="reference internal" href="#cssnamespacerule" id="id8">CSSNamespaceRule</a></li>
+<li><a class="reference internal" href="#cssimportrule" id="id9">CSSImportRule</a></li>
+<li><a class="reference internal" href="#cssmediarule" id="id10">CSSMediaRule</a></li>
+<li><a class="reference internal" href="#cssfontfacerule" id="id11">CSSFontFaceRule</a></li>
+<li><a class="reference internal" href="#csspagerule" id="id12">CSSPageRule</a></li>
+<li><a class="reference internal" href="#cssstylerule" id="id13">CSSStyleRule</a></li>
 </ul>
 </li>
 </ul>
 <tbody valign="top">
 <tr class="field"><th class="field-name"><a class="reference internal" href="#cssstylesheet">CSSStyleSheet</a>:</th><td class="field-body">Implements <tt class="docutils literal"><span class="pre">stylesheets.StyleSheet</span></tt> and is the <em>root</em> of a stylesheet.</td>
 </tr>
+<tr class="field"><th class="field-name">CSSRuleList:</th><td class="field-body">A list of CSSRule objects used in <a class="reference internal" href="#cssstylesheet">CSSStyleSheet</a> and <a class="reference internal" href="#cssmediarule">CSSMediaRule</a></td>
+</tr>
+<tr class="field"><th class="field-name">CSSRule:</th><td class="field-body">Base class of all CSS rules, hardly useful itself</td>
+</tr>
 <tr class="field"><th class="field-name"><a class="reference internal" href="#csscharsetrule">CSSCharsetRule</a>:</th><td class="field-body">@charset rule</td>
 </tr>
 <tr class="field"><th class="field-name"><a class="reference internal" href="#cssfontfacerule">CSSFontFaceRule</a>:</th><td class="field-body">@font-face rule (from v0.9.5a4)</td>
 </tr>
 <tr class="field"><th class="field-name"><a class="reference external" href="cssstyledeclaration.html">CSSStyleDeclaration</a>:</th><td class="field-body">Containing a list of Properties</td>
 </tr>
-<tr class="field"><th class="field-name">Property:</th><td class="field-body">A single property with name, value and priority information, used for properties in CSSStyleDeclaration and stylesheets.MediaQuery</td>
+<tr class="field"><th class="field-name"><a class="reference external" href="cssstyledeclaration.html#property">Property</a>:</th><td class="field-body">A single property with name, value and priority information, used for properties in CSSStyleDeclaration and stylesheets.MediaQuery</td>
 </tr>
 <tr class="field"><th class="field-name"><a class="reference external" href="values.html">CSSValue</a>:</th><td class="field-body">A CSS value which might also be a CSSPrimitiveValue or CSSValueList.</td>
 </tr>
 <p>Also inherits properties from stylesheet.StyleSheet.</p>
 <dl class="docutils" id="cssrules">
 <dt>cssRules</dt>
-<dd>of type CSSRuleList, (DOM readonly)</dd>
+<dd>A css::CSSRuleList of all CSS rules contained within the
+stylesheet.</dd>
+</dl>
+<dl class="docutils" id="ownerrule">
 <dt>ownerRule</dt>
 <dd>of type CSSRule, readonly (NOT IMPLEMENTED YET)</dd>
 </dl>
 <dl class="docutils" id="encoding">
 <dt>encoding (cssutils and CSSOM only)</dt>
 <dd><p class="first">reflects the encoding of an @charset rule or 'utf-8' (default)
-if set to <tt class="docutils literal"><span class="pre">None</span></tt>.</p>
+if set to <tt class="docutils literal"><span class="pre">None</span></tt>. If an explicit encoding of 'utf-8' is set an @charset rule is serialized, if encoding is <tt class="docutils literal"><span class="pre">None</span></tt> (and therefor also effectively 'utf-8') no @charset rule is serialized.</p>
 <p class="last">Effectively using CSSCharsetRule directly is not needed anymore.</p>
 </dd>
 </dl>
 not declared. If they do they are "invalidated".</dd>
 </dl>
 </div>
+<div class="section" id="methods">
+<h3><a class="toc-backref" href="#id6">Methods</a></h3>
+<dl class="docutils" id="deleterule">
+<dt>deleteRule(self, index)</dt>
+<dd>Used to delete a rule from the style sheet.</dd>
+</dl>
+<dl class="docutils" id="insertrule">
+<dt>insertRule(rule, index=None)</dt>
+<dd><p class="first">Used to insert a new rule into the style sheet. The new rule now
+becomes part of the cascade.</p>
+<p class="last">Rule may be a string or a valid <tt class="docutils literal"><span class="pre">CSSRule</span></tt> or <tt class="docutils literal"><span class="pre">CSSRuleList</span></tt></p>
+</dd>
+</dl>
+<dl class="docutils" id="replaceurls">
+<dt>replaceUrls(replacer)</dt>
+<dd><p class="first">Utility method to replace all <tt class="docutils literal"><span class="pre">url(urlstring)</span></tt> values in <tt class="docutils literal"><span class="pre">CSSImportRules</span></tt> and <tt class="docutils literal"><span class="pre">CSSStyleDeclaration</span></tt> objects (properties).</p>
+<p class="last"><tt class="docutils literal"><span class="pre">replacer</span></tt> must be a function which is called with a single
+argument <tt class="docutils literal"><span class="pre">urlstring</span></tt> which is the current value of url()
+excluding <tt class="docutils literal"><span class="pre">url(</span></tt> and <tt class="docutils literal"><span class="pre">)</span></tt>. It still may have surrounding
+single or double quotes though.</p>
+</dd>
+</dl>
+<dl class="docutils" id="setserializer">
+<dt>setSerializer(self, cssserializer)</dt>
+<dd>Sets the global Serializer used for output of all stylesheet
+output.</dd>
+</dl>
+<dl class="docutils" id="setserializerpref">
+<dt>setSerializerPref(pref, value)</dt>
+<dd>Sets Preference of CSSSerializer used for output of this
+stylesheet. See cssutils.serialize.Preferences for possible
+preferences to be set.</dd>
+</dl>
+</div>
 </div>
 <div class="section" id="csscharsetrule">
-<h2><a class="toc-backref" href="#id6">CSSCharsetRule</a></h2>
+<h2><a class="toc-backref" href="#id7">CSSCharsetRule</a></h2>
 <p>This rule is not really needed anymore as using  <a class="reference internal" href="#encoding">encoding</a> of <a class="reference internal" href="#cssstylesheet">CSSStyleSheet</a> is much easier.</p>
 </div>
 <div class="section" id="cssnamespacerule">
-<h2><a class="toc-backref" href="#id7">CSSNamespaceRule</a></h2>
+<h2><a class="toc-backref" href="#id8">CSSNamespaceRule</a></h2>
 <p>CSSNamespaceRule currently implements <a class="reference external" href="http://www.w3.org/TR/2006/WD-css3-namespace-20060828/index.html">http://www.w3.org/TR/2006/WD-css3-namespace-20060828/</a></p>
 <dl class="docutils">
 <dt>namespaceURI</dt>
 </dl>
 </div>
 <div class="section" id="cssimportrule">
-<h2><a class="toc-backref" href="#id8">CSSImportRule</a></h2>
+<h2><a class="toc-backref" href="#id9">CSSImportRule</a></h2>
 <p>Used to import other CSS style sheets.</p>
 <dl class="docutils" id="href">
 <dt>href</dt>
 </dl>
 </div>
 <div class="section" id="cssmediarule">
-<h2><a class="toc-backref" href="#id9">CSSMediaRule</a></h2>
-<p>tbd</p>
+<h2><a class="toc-backref" href="#id10">CSSMediaRule</a></h2>
+<p>Rules (mainly <tt class="docutils literal"><span class="pre">CSSStyleRule</span></tt> s) which are to be used for the given <tt class="docutils literal"><span class="pre">media</span></tt> only.</p>
+<dl class="docutils">
+<dt>media</dt>
+<dd>A list of media types for this rule of type MediaList.</dd>
+<dt>cssRules</dt>
+<dd>A css::CSSRuleList of all CSS rules contained within the
+media block.</dd>
+</dl>
 </div>
 <div class="section" id="cssfontfacerule">
-<h2><a class="toc-backref" href="#id10">CSSFontFaceRule</a></h2>
-<p>tbd</p>
+<h2><a class="toc-backref" href="#id11">CSSFontFaceRule</a></h2>
+<p>Holds font related definitions. Hardly used in any CSS implementation, I only know PrinceXML which uses it to defined fonts.</p>
+<dl class="docutils">
+<dt>style</dt>
+<dd>The declaration-block of this rule</dd>
+</dl>
 </div>
 <div class="section" id="csspagerule">
-<h2><a class="toc-backref" href="#id11">CSSPageRule</a></h2>
+<h2><a class="toc-backref" href="#id12">CSSPageRule</a></h2>
+<p>Holds page related definitions. Mainly useful for print sheets, used extensively in page defining applications like PrinceXML.</p>
+<dl class="docutils">
+<dt>selectorText</dt>
+<dd>The parsable textual representation of the page selector for the rule.</dd>
+<dt>style</dt>
+<dd>The declaration-block of this rule</dd>
+</dl>
 </div>
 <div class="section" id="cssstylerule">
-<h2><a class="toc-backref" href="#id12">CSSStyleRule</a></h2>
-<p>tbd</p>
+<h2><a class="toc-backref" href="#id13">CSSStyleRule</a></h2>
+<p>The CSSStyleRule object represents a ruleset specified (if any) in a CSS
+style sheet. It provides access to a declaration block as well as to the
+associated group of selectors.</p>
+<dl class="docutils">
+<dt>selectorText</dt>
+<dd>The textual representation of the selector for the rule set.</dd>
+<dt>selectorList: of type SelectorList (cssutils only)</dt>
+<dd>A list of all Selectors for the rule set.</dd>
+<dt>style</dt>
+<dd>The declaration-block of this rule</dd>
+</dl>
 </div>
 </div>
 </div>

documentation_html/documentation/cssstyledeclaration.html

 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 <meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" />
 <title></title>
-<link rel="stylesheet" href="../documentation/default.css&#10;&#9;&#9;&#9;&#9;&#9;#/documentation/default.css1" type="text/css" />
+<link rel="stylesheet" href="../documentation/default.css#/documentation/default.css1" type="text/css" />
 </head>
 <body>
 <div class="document">
 
 
-<p><a class="reference external" href="../index.html&#10;&#9;&#9;&#9;&#9;&#9;#/index.html1">Index</a></p>
+<p><a class="reference external" href="../index.html#/index.html1">Index</a></p>
 <div class="section" id="cssstyledeclaration">
 <h1><a class="toc-backref" href="#id2">CSSStyleDeclaration</a></h1>
 <table class="docutils field-list" frame="void" rules="none">

documentation_html/documentation/cssutils.html

 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 <meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" />
 <title></title>
-<link rel="stylesheet" href="../documentation/default.css&#10;&#9;&#9;&#9;&#9;&#9;#/documentation/default.css1" type="text/css" />
+<link rel="stylesheet" href="../documentation/default.css#/documentation/default.css1" type="text/css" />
 </head>
 <body>
 <div class="document">
 
 
-<p><a class="reference external" href="../index.html&#10;&#9;&#9;&#9;&#9;&#9;#/index.html1">Index</a></p>
+<p><a class="reference external" href="../index.html#/index.html1">Index</a></p>
 <div class="section" id="package-cssutils">
 <h1><a class="toc-backref" href="#id1">package <tt class="docutils literal"><span class="pre">cssutils</span></tt></a></h1>
 <table class="docutils field-list" frame="void" rules="none">

documentation_html/documentation/default.css

+@charset "utf-8";
+/*
+$LastChangedRevision: 707 $
+$LastChangedBy: cthedot $LastChangedBy: doerwalter $
+$LastChangedDate: 2007-12-02 13:56:42 +0100 (So, 02 Dez 2007) $
+*/
+
+* {
+	padding: 0;
+	margin: 0;
+	}
+body {
+	font: normal 100%/1.3 Arial, sans-serif;
+	color: #000;
+	background-color: #f5f3ee;
+	padding: 1em 5%;
+	}
+.document {
+	max-width: 770px;
+	}
+	.section>* {
+		margin-left: 7px
+		}
+	.section>h1, .section>h2, .section>h3 {
+		margin-left: 0
+		}
+h1, h2, h3, h4, dt {
+	color: #a00;
+	font-weight: normal;
+	margin: 1em 0 0.2em;
+	}
+	h1.title, h2.subtitle {
+		text-align: center;
+		font-size: 2em;
+		margin: 0;
+		}
+	h2.subtitle {
+		margin: 0 0 1em;
+		}
+	h1, h2.subtitle {
+		font-size: 1.6em;
+		}
+	h2, h3, h4 {
+		font-size: 1.3em;
+		}
+	h1, h2.subtitle, h2 {
+		padding: 0.1em 7px;
+		background-color: #fff;
+		}
+	h2, h3, h4 {
+		margin-top: 2em;
+		margin-bottom: 1em;
+		}
+	h3 {
+		padding-left: 7px;
+		border-right: 1.4em solid #fff;
+		border-bottom: 2px dotted #fff;
+		}
+	h4 {
+		text-indent: -7px;
+		}
+
+p, ul, ol, dl, pre, table {	
+	margin-bottom: 0.9em;
+	}
+ul {
+	list-style-type: square;
+	}
+	dt {
+		font-weight: bold;
+		margin-top: 1.5em;
+		}
+		dd dt {
+			margin-top: 0;
+			}
+	li, dd {
+		margin-left: 1.8em;
+		margin-bottom: 0.2em;
+		}
+		li p {
+			margin-bottom: 0.5em;
+			}
+	li:hover, dd:hover {
+		background-color: #f9f7f2;		
+		}
+		li li:hover, dd li:hover {
+			background-color: #fbfaf5;		
+			}
+			li li li:hover, dd li li:hover {
+				background-color: #f9f7f2;		
+				}
+table {
+	width: 100%;
+	}
+.docinfo-name {
+	min-width: 30%;
+	}
+	th {
+		text-align: left;
+		}
+	.field-name {
+		width: 20%;
+	}
+code, pre, tt, .pre {
+	font-family: "Lucida Console", monospace;	
+	color: #00a;
+	font-size: 0.95em;
+	}
+pre {
+	background-color: #f6f6f0;
+	overflow: auto;
+	padding: 5px;
+	}
+a {	
+	color: #711;
+	}
+a[href^="http"].external {
+	color: #a00;
+	}
+a[href^="http"].external:before {
+	content: "□ ";
+	}
+a[href] {
+	text-decoration: none;
+	border-bottom: 1px dotted;	
+	}
+	h1 a[href] ,h2 a[href], h3 a[href] {
+		border-bottom: 0;
+		}
+	a:visited {
+		color: #344;
+		}
+	a[href]:hover, a[href]:focus {
+		text-decoration: underline;
+		}
+
+/* reStructuredText */
+.system-message {
+	font-weight: bold;
+	color: #f00;
+	padding: 0 1em;
+	border: 3px double;
+	}

documentation_html/documentation/scripts.html

 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 <meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" />
 <title></title>
-<link rel="stylesheet" href="../documentation/default.css&#10;&#9;&#9;&#9;&#9;&#9;#/documentation/default.css1" type="text/css" />
+<link rel="stylesheet" href="../documentation/default.css#/documentation/default.css1" type="text/css" />
 </head>
 <body>
 <div class="document">
 
 
-<p><a class="reference external" href="../index.html&#10;&#9;&#9;&#9;&#9;&#9;#/index.html1">Index</a></p>
+<p><a class="reference external" href="../index.html#/index.html1">Index</a></p>
 <div class="section" id="cssutils-scripts">
 <h1><a class="toc-backref" href="#id1"><tt class="docutils literal"><span class="pre">cssutils</span></tt> scripts</a></h1>
 <table class="docutils field-list" frame="void" rules="none">
 <ul class="simple">
 <li><a class="reference internal" href="#cssutils-scripts" id="id1"><tt class="docutils literal"><span class="pre">cssutils</span></tt> scripts</a><ul>
 <li><a class="reference internal" href="#csscapture" id="id2">CSSCapture</a></li>
-<li><a class="reference internal" href="#cssparse" id="id3">CSSParse</a></li>
+<li><a class="reference internal" href="#csscombine" id="id3">CSSCombine</a></li>
+<li><a class="reference internal" href="#cssparse" id="id4">CSSParse</a></li>
 </ul>
 </li>
 </ul>
 </dd>
 </dl>
 </div>
+<div class="section" id="csscombine">
+<h2><a class="toc-backref" href="#id3">CSSCombine</a></h2>
+<p>csscombine.py may be used to combine several sheets loaded from a main sheet via @import rules. No nested @imports are resolved yet and @namespace rules do not work yet!</p>
+<p>The resulting combined sheet (optionally minified) is send to stdout, info and error messages are send to stderr.</p>
+<p>CSSCombine may also be used to change the encoding of the stylesheet if the target encoding is given.</p>
+<p>Usage: csscombine.py [options] URL</p>
+<dl class="docutils">
+<dt>Options:</dt>
+<dd><table class="first last docutils option-list" frame="void" rules="none">
+<col class="option" />
+<col class="description" />
+<tbody valign="top">
+<tr><td class="option-group">
+<kbd><span class="option">-h</span>, <span class="option">--help</span></kbd></td>
+<td>show this help message and exit</td></tr>
+<tr><td class="option-group" colspan="2">
+<kbd><span class="option">-s <var>SRCENC</var></span>, <span class="option">--srcenc=<var>SRCENC</var></span></kbd></td>
+</tr>
+<tr><td> </td><td>encoding of input, defaulting to "css". If given
+overwrites other encoding information like @charset
+declarations</td></tr>
+<tr><td class="option-group" colspan="2">
+<kbd><span class="option">-t <var>TARENC</var></span>, <span class="option">--tarenc=<var>TARENC</var></span></kbd></td>
+</tr>
+<tr><td> </td><td>encoding of output, defaulting to "UTF-8"</td></tr>
+<tr><td class="option-group">
+<kbd><span class="option">-m</span>, <span class="option">--minified</span></kbd></td>
+<td>saves minified version of combined files, defaults to
+False</td></tr>
+</tbody>
+</table>
+</dd>
+</dl>
+</div>
 <div class="section" id="cssparse">
-<h2><a class="toc-backref" href="#id3">CSSParse</a></h2>
+<h2><a class="toc-backref" href="#id4">CSSParse</a></h2>
 <p>Script version of <tt class="docutils literal"><span class="pre">cssutils.parse()</span></tt>.</p>
 </div>
 </div>

documentation_html/documentation/stylesheets.html

 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 <meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" />
 <title></title>
-<link rel="stylesheet" href="../documentation/default.css&#10;&#9;&#9;&#9;&#9;&#9;#/documentation/default.css1" type="text/css" />
+<link rel="stylesheet" href="../documentation/default.css#/documentation/default.css1" type="text/css" />
 </head>
 <body>
 <div class="document">
 
 
-<p><a class="reference external" href="../index.html&#10;&#9;&#9;&#9;&#9;&#9;#/index.html1">Index</a></p>
+<p><a class="reference external" href="../index.html#/index.html1">Index</a></p>
 <div class="section" id="package-cssutils-stylesheets">
 <h1><a class="toc-backref" href="#id1">package <tt class="docutils literal"><span class="pre">cssutils.stylesheets</span></tt></a></h1>
 <table class="docutils field-list" frame="void" rules="none">

documentation_html/documentation/values.html

 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 <meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" />
 <title></title>
-<link rel="stylesheet" href="../documentation/default.css&#10;&#9;&#9;&#9;&#9;&#9;#/documentation/default.css1" type="text/css" />
+<link rel="stylesheet" href="../documentation/default.css#/documentation/default.css1" type="text/css" />
 </head>
 <body>
 <div class="document">
 
 
-<p><a class="reference external" href="../index.html&#10;&#9;&#9;&#9;&#9;&#9;#/index.html1">Index</a></p>
+<p><a class="reference external" href="../index.html#/index.html1">Index</a></p>
 <div class="section" id="css-values">
 <h1><a class="toc-backref" href="#id1">CSS Values</a></h1>
 <table class="docutils field-list" frame="void" rules="none">

documentation_html/dummy.html

+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" />
+<title></title>
+<link rel="stylesheet" href="documentation/default.css#/documentation/default.css0" type="text/css" />
+</head>
+<body>
+<div class="document">
+
+
+<p>HERE ARE COPIES OF THE CSSUTILS DOCS FOR GENERATION OF HTML DOCUMENTATION ONLY!</p>
+</div>
+</body>
+</html>

documentation_html/index.html

 <meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" />
 <title>cssutils</title>
 <meta name="author" content="cthedot" />
-<meta name="date" content="2007-12-02 13:57:17 +0100 (So, 02 Dez 2007)" />
-<link rel="stylesheet" href="documentation/default.css&#10;&#9;&#9;&#9;&#9;&#9;#/documentation/default.css0" type="text/css" />
+<meta name="date" content="2007-12-27 16:34:12 +0100 (Do, 27 Dez 2007)" />
+<link rel="stylesheet" href="documentation/default.css#/documentation/default.css0" type="text/css" />
 </head>
 <body>
 <div class="document" id="cssutils">
 <tr><th class="docinfo-name">Author:</th>
 <td>cthedot</td></tr>
 <tr><th class="docinfo-name">Date:</th>
-<td>2007-12-02 13:57:17 +0100 (So, 02 Dez 2007)</td></tr>
+<td>2007-12-27 16:34:12 +0100 (Do, 27 Dez 2007)</td></tr>
 <tr><th class="docinfo-name">Version:</th>
-<td>(rev 709)</td></tr>
+<td>(rev 742)</td></tr>
 </tbody>
 </table>
 <div class="section" id="available-documentation">