/usr/share/doc/python-icalendar-doc/html/index.html is in python-icalendar-doc 3.8-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 | <!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">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Internet Calendaring and Scheduling (iCalendar) for Python — icalendar 3.0dev documentation</title>
<link rel="stylesheet" href="_static/icalendar.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '3.0dev',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="author" title="About these documents" href="about.html" />
<link rel="top" title="icalendar 3.0dev documentation" href="#" />
<link rel="next" title="About" href="about.html" />
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="about.html" title="About"
accesskey="N">next</a> |</li>
<li><a href="#">icalendar 3.0dev documentation</a> »</li>
</ul>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h3><a href="#">Table Of Contents</a></h3>
<ul>
<li class="toctree-l1"><a class="reference internal" href="about.html">About</a></li>
<li class="toctree-l1"><a class="reference internal" href="install.html">Installing iCalendar</a></li>
<li class="toctree-l1"><a class="reference internal" href="usage.html">iCalendar package</a></li>
<li class="toctree-l1"><a class="reference internal" href="usage.html#more-documentation">More documentation</a></li>
<li class="toctree-l1"><a class="reference internal" href="credits.html">icalendar contributors</a></li>
<li class="toctree-l1"><a class="reference internal" href="license.html">License</a></li>
</ul>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="internet-calendaring-and-scheduling-icalendar-for-python">
<h1>Internet Calendaring and Scheduling (iCalendar) for Python<a class="headerlink" href="#internet-calendaring-and-scheduling-icalendar-for-python" title="Permalink to this headline">¶</a></h1>
<p>The <a class="reference external" href="http://pypi.python.org/pypi/icalendar">icalendar</a> package is a parser/generator of iCalendar files for use
with Python.</p>
<hr class="docutils" />
<blockquote>
<div><table class="docutils field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
<tr class="field-odd field"><th class="field-name">Homepage:</th><td class="field-body"><a class="reference external" href="http://icalendar.readthedocs.org">http://icalendar.readthedocs.org</a></td>
</tr>
<tr class="field-even field"><th class="field-name">Code:</th><td class="field-body"><a class="reference external" href="http://github.com/collective/icalendar">http://github.com/collective/icalendar</a></td>
</tr>
<tr class="field-odd field"><th class="field-name">Mailing list:</th><td class="field-body"><a class="reference external" href="http://github.com/collective/icalendar/issues">http://github.com/collective/icalendar/issues</a></td>
</tr>
<tr class="field-even field"><th class="field-name">Dependencies:</th><td class="field-body"><a class="reference external" href="http://pypi.python.org/pypi/setuptools">setuptools</a> and since version 3.0 we depend on <a class="reference external" href="http://pypi.python.org/pypi/pytz">pytz</a>.</td>
</tr>
<tr class="field-odd field"><th class="field-name" colspan="2">Compatible with:</th></tr>
<tr class="field-odd field"><td> </td><td class="field-body">Python 2.6, 2.7 and 3.3+</td>
</tr>
<tr class="field-even field"><th class="field-name">License:</th><td class="field-body"><a class="reference external" href="https://github.com/collective/icalendar/issues/2">BSD</a></td>
</tr>
</tbody>
</table>
</div></blockquote>
<hr class="docutils" />
<a class="reference external image-reference" href="https://travis-ci.org/collective/icalendar"><img alt="https://travis-ci.org/collective/icalendar.svg?branch=master" src="https://travis-ci.org/collective/icalendar.svg?branch=master" /></a>
<div class="section" id="roadmap">
<h2>Roadmap<a class="headerlink" href="#roadmap" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>4.0: API refactoring</li>
</ul>
</div>
<div class="section" id="changes-in-version-3-0">
<h2>Changes in version 3.0<a class="headerlink" href="#changes-in-version-3-0" title="Permalink to this headline">¶</a></h2>
<div class="section" id="api-change">
<h3>API Change<a class="headerlink" href="#api-change" title="Permalink to this headline">¶</a></h3>
<p>Since version we unified to icalendar de/serialization API to use only to_ical
(for writing an ical string from the internal representation) and from_ical
(for parsing an ical string into the internal representation).</p>
<p>to_ical is now used instead of the methods ical, string, as_string and instead
of string casting via __str__ and str.</p>
<p>from_ical is now used instead of from_string.</p>
<p>This change is a requirement for future Python 3 compatibility. Please update
your code to reflect to the new API.</p>
</div>
<div class="section" id="timezone-support">
<h3>Timezone support<a class="headerlink" href="#timezone-support" title="Permalink to this headline">¶</a></h3>
<p>Timezones are now fully supported in icalendar for serialization and
deserialization. We use the pytz library for timezone components of datetime
instances. The timezone identifiers must be valid pytz respectively Olson
database timezone identifiers. This can be a problem for ‘GMT’ identifiers,
which are not defined in the Olson database.</p>
<p>Instead of the own UTC tzinfo implementation we use pytz UTC tzinfo object now.</p>
</div>
</div>
<div class="section" id="about-this-fork-which-is-not-a-fork-anymore">
<h2>About this fork which is not a fork anymore<a class="headerlink" href="#about-this-fork-which-is-not-a-fork-anymore" title="Permalink to this headline">¶</a></h2>
<p>Aim of this fork (not fork anymore, read further) was to bring this package up
to date with latest icalendar <a class="reference external" href="http://www.ietf.org/rfc/rfc5545.txt">RFC</a> specification as part of
<a class="reference external" href="http://github.com/plone/plone.app.event">plone.app.event</a> project which goal is to bring recurrent evens to <a class="reference external" href="http://plone.org">Plone</a>.</p>
<p>After some thoughts we (Plone developers involved with <a class="reference external" href="http://github.com/plone/plone.app.event">plone.app.event</a>) send
a suggestion to <a class="reference external" href="mailto:icalendar-dev%40codespeak.net">icalendar-dev<span>@</span>codespeak<span>.</span>net</a> to take over mainaining of
<a class="reference external" href="http://pypi.python.org/pypi/icalendar">icalendar</a>. Nobody object and since version 2.2 we are back to development.</p>
</div>
<div class="section" id="test-coverage-report">
<h2>Test Coverage Report<a class="headerlink" href="#test-coverage-report" title="Permalink to this headline">¶</a></h2>
<p>Output from coverage test:</p>
<div class="highlight-python"><div class="highlight"><pre>Name Stmts Miss Cover
------------------------------------------------
src/icalendar/__init__ 4 0 100%
src/icalendar/cal 243 7 97%
src/icalendar/caselessdict 66 7 89%
src/icalendar/compat 1 0 100%
src/icalendar/parser 192 6 97%
src/icalendar/parser_tools 20 0 100%
src/icalendar/prop 536 64 88%
src/icalendar/tools 16 0 100%
------------------------------------------------
TOTAL 1078 84 92%
</pre></div>
</div>
</div>
<div class="section" id="contents">
<h2>Contents<a class="headerlink" href="#contents" title="Permalink to this headline">¶</a></h2>
<div class="toctree-wrapper compound">
<ul>
<li class="toctree-l1"><a class="reference internal" href="about.html">About</a></li>
<li class="toctree-l1"><a class="reference internal" href="install.html">Installing iCalendar</a></li>
<li class="toctree-l1"><a class="reference internal" href="usage.html">iCalendar package</a><ul>
<li class="toctree-l2"><a class="reference internal" href="usage.html#file-structure">File structure</a></li>
<li class="toctree-l2"><a class="reference internal" href="usage.html#overview">Overview</a></li>
<li class="toctree-l2"><a class="reference internal" href="usage.html#components">Components</a></li>
<li class="toctree-l2"><a class="reference internal" href="usage.html#subcomponents">Subcomponents</a></li>
<li class="toctree-l2"><a class="reference internal" href="usage.html#value-types">Value types</a></li>
<li class="toctree-l2"><a class="reference internal" href="usage.html#property-parameters">Property parameters</a></li>
<li class="toctree-l2"><a class="reference internal" href="usage.html#example">Example</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="usage.html#more-documentation">More documentation</a></li>
<li class="toctree-l1"><a class="reference internal" href="credits.html">icalendar contributors</a></li>
<li class="toctree-l1"><a class="reference internal" href="license.html">License</a></li>
</ul>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="about.html" title="About"
>next</a> |</li>
<li><a href="#">icalendar 3.0dev documentation</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2011, MaxM.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2.
</div>
</body>
</html>
|