XML VFS: fix flake8 errors

[extfs.d.git] / xml-ANNOUNCE

diff --git a/xml-ANNOUNCE b/xml-ANNOUNCE
index d6d59c2e8361ecb4e3ee34e9274004de429c40eb..53d15dc88238754356451be3114e2a4d83bd6b00 100644 (file)
--- a/xml-ANNOUNCE
+++ b/xml-ANNOUNCE
@@ -5,25 +5,66 @@ WHAT IS IT
    View an XML file in Midnight Commander as a filesystem.
 
 
-WHAT'S NEW in version 0.3.0 (2013-11-16)
-   Initial release.
+WHAT'S NEW
+Version 1.1.5 (2015-07-08)
+   Set directories/files date/time to the last modification time of the XML
+file.
+
+   Fix flake8 errors.
+
+Version 1.1.4 (2015-03-21)
+   Minor documentation update.
+
+Version 1.1.3 (2015-03-14)
+   Fix a minor bug in handling namespaces (lxml).
+
+Version 1.1.2 (2015-01-10)
+   Changed link to installation instructions.
+
+Version 1.1.1 (2014-07-17)
+   Fix a bug in removing excessive namespaces (lxml).
+
+Version 1.1.0 (2013-11-26)
+   Show comment(s) before the root element.
+
+Version 1.0.0 (2013-11-23)
+   With lxml.etree-based implementation show only child namespaces
+   (calculated as combined namespaces minus parent's namespaces).
+
+Version 0.3.0 (2013-11-16)
+   Initial release. Implementation based on minidom.
 
 
 WHERE TO GET
-   Master site:  http://phdru.name/Software/mc/
-   A mirror:    http://phdru.cu.cc/Software/mc/
+   Home page: http://phdru.name/Software/mc/xml.html
+   Download:  http://phdru.name/Software/mc/xml
+    git clone http://git.phdru.name/extfs.d.git
+    git clone  git://git.phdru.name/extfs.d.git
+
+   Installation instructions: http://phdru.name/Software/mc/INSTALL.html
 
 
 The VFS represents tags as directories; the directories are numbered to
-distinguish tags with the same name; also numbering helps to sort tags by their
-order in XML instead of sorting them by name. Attributes, text nodes and
-comments are represented as text files; attributes are shown in a file named
-"attributes", attributes are listed in the file as name=value lines (I
-deliberately ignore a small chance of newline characters in values); names and
-values are reencoded to the console encoding. Text nodes and comments are
-collected in a file named "text", stripped and reencoded. The filesystem is
+distinguish tags with the same name; numbering also helps to sort tags by their
+order in XML instead of sorting them by name and prevents name clash when tag
+names coincide with the names of special files used by XML VFS. Attributes,
+text nodes and comments are represented as text files; attributes are shown in
+a file named "attributes", attributes are listed in the file as name=value
+lines (I deliberately ignore a small chance of newline characters in values);
+names and values are reencoded to the console encoding. Text nodes and comments
+are collected in a file named "text", stripped and reencoded. The filesystem is
 read-only.
 
+Implementation based on minidom doesn't understand namespaces, it just shows
+them among other attributes. ElementTree-based implementation doesn't show
+namespaces at all. Implementation based on lxml.etree shows namespaces in a
+separate file "namespaces".
+
+It is useful to have a top-down view on an XML structure but it's especially
+convenient to extract text values from tags. One can get, for example, a
+base64-encoded image - just walk down the VFS to the tag's directory and copy
+its text file to a real file.
+
 The VFS was inspired by a FUSE xmlfs: https://github.com/halhen/xmlfs
 
 
@@ -31,7 +72,7 @@ AUTHOR
    Oleg Broytman <phd@phdru.name>
 
 COPYRIGHT
-   Copyright (C) 2013 PhiloSoft Design
+   Copyright (C) 2013-2015 PhiloSoft Design
 
 LICENSE
    GPL