Update to version 1.3.0

ChangeLog

@@ -1,3 +1,12 @@
+1.3
+	A new edition of odfpy to support Python3.
+
+	This version has been reworked by Georges Khaznadar <[email protected]>,
+	to add Python3 support.
+
+1.2
+	Support ODF 1.2
+
 past 0.9
 	Made sure userfield.py works with OpenOffice.org 3.x files.
 0.9

README.md

@@ -1,17 +1,20 @@
-odfpy
-=====
+# ODFPY
 
-a new branch of odfpy to support Python3
+This is a collection of utility programs written in Python to manipulate
+OpenDocument 1.2 files.
 
-This version has been reworked by Georges Khaznadar <[email protected]>,
-to add Python3 support.
+How to proceed: Each application has its own directory. In there, look
+at the manual pages. The Python-based tools need the odf library. Just
+make a symbolic link like this: ln -s ../odf odf
+... or type: make
 
-INSTALLATION
-============
+For your own use of the odf library, see api-for-odfpy.odt
+
+## INSTALLATION
 
 First you get the package.
 
-$ git clone https://github.com/georgesk/odfpy.git
+    $ git clone https://github.com/eea/odfpy.git
 
 Then you can build and install the library for Python2 and Python3:
 
@@ -22,22 +25,52 @@ $ su
 # python setup.py install
 # python3 setup.py install
 ```
-
 The library is incompatible with PyXML.
 
-                            -o- TODO / IDEAS -o-
-
-* tests:
-  Some part of the files tests/test*.py are still unsuccessful. This
-  announces that there is still something to fix (2014-10-21).
-  .
-  The file tests/testxhtml.py is particularly strange: when the test
-  is run twice, it does not yeld the same result, part of the procedures
-  have unpredictable results. The same ODF source document can be
-  translated to different XHTML targets: this is visible when one watches
-  CSS output like margin-left and margin-right attributes, which have
-  different values for successive calls to the same test.
-  .
-  This unpredictable behavior occurs both with Python2 and Python3.
-
-... see the file README (without extension) for more information.
+## ISSUES
+
+If you run the tests with python3, you will probably see one error.
+It is probably a flaw in the command assertRaises of Python3: the
+right exception is raised, but it is not correctly identified by
+Python3's assertRaises.
+
+## TODO / IDEAS
+
+* html2odf
+  Alex Hudson has been contracted to produce a command-line html2odf 
+  converter. It should include support for images, tables, CSS, etc.
+  He will provide a C# version first, and later a C version.
+
+* odf2pdf
+  A valuable tool, but one that is hard to do. PDF is an immensely
+  popular format, but it's tricky to make PDFs. With an odf2pdf tool
+  available, many developers would use ODF purely for the purpose of
+  generating a PDF later. The latest idea is to hire KOffice 
+  developers and get them to trim down KOffice into a converter.
+
+* pdf2odf
+  This conversion is less likely to produce good results, but it 
+  might be worth a shot. Poppler is a pdf library that can convert 
+  PDF into XML. Maybe we can convert that XML to ODF.
+  http://webcvs.freedesktop.org/poppler/poppler/
+
+* odfclean
+  A command-line program that removes unused automatic styles, 
+  metadata and track-changes. Some companies might like to send all
+  out-going files through odfclean to remove any information they
+  don't want others to see.
+
+* odf2xliff
+  Create XLIFF extraction and merge application. XLIFF is a OASIS file
+  for translations. You extract the text strings, send them to the translator
+  and then import them. It allows you to work on the document in the
+  meantime and only retranslate the changed parts.
+
+* odfdiff
+  A program that can generate a diff between two ODF files. Useful for 
+  SVN commit messages. This is very difficult to do. But see:
+  http://www.manageability.org/blog/stuff/open-source-xml-diff-in-java/view
+  http://freshmeat.net/projects/xmldiff/
+
+* odfsign
+  Sign and verify the signature(s) of an ODF document.

odf/namespaces.py

@@ -17,7 +17,7 @@
 #
 # Contributor(s):
 #
-TOOLSVERSION = u"ODFPY/1.2.0dev"
+TOOLSVERSION = u"ODFPY/1.3.0dev"
 
 ANIMNS         = u"urn:oasis:names:tc:opendocument:xmlns:animation:1.0"
 CHARTNS        = u"urn:oasis:names:tc:opendocument:xmlns:chart:1.0"

setup.py

@@ -21,7 +21,7 @@
 import platform
 from distutils.core import setup
 
-version = '1.2.0dev'
+version = '1.3.0dev'
 
 if platform.system() in ('Linux','Unix'):
     man1pages = [('share/man/man1', [