xml version 1.1.3: fix a minor bug in handling namespaces
[extfs.d.git] / xml-ANNOUNCE
1 XML Virtual FileSystem for Midnight Commander
2
3
4 WHAT IS IT
5    View an XML file in Midnight Commander as a filesystem.
6
7
8 WHAT'S NEW
9 Version 1.1.3 (2015-03-14)
10    Fix a minor bug in handling namespaces (lxml).
11
12 Version 1.1.2 (2015-01-10)
13    Changed link to installation instructions.
14
15 Version 1.1.1 (2014-07-17)
16    Fix a bug in removing excessive namespaces (lxml).
17
18 Version 1.1.0 (2013-11-26)
19    Show comment(s) before the root element.
20
21 Version 1.0.0 (2013-11-23)
22    With lxml.etree-based implementation show only child namespaces
23    (calculated as combined namespaces minus parent's namespaces).
24
25 Version 0.3.0 (2013-11-16)
26    Initial release. Implementation based on minidom.
27
28
29 WHERE TO GET
30    Home page: http://phdru.name/Software/mc/xml.html
31    Download:  http://phdru.name/Software/mc/xml
32     git clone http://git.phdru.name/extfs.d.git
33     git clone  git://git.phdru.name/extfs.d.git
34
35    Installation instructions: http://phdru.name/Software/mc/INSTALL.html
36
37
38 The VFS represents tags as directories; the directories are numbered to
39 distinguish tags with the same name; numbering also helps to sort tags by their
40 order in XML instead of sorting them by name. Attributes, text nodes and
41 comments are represented as text files; attributes are shown in a file named
42 "attributes", attributes are listed in the file as name=value lines (I
43 deliberately ignore a small chance of newline characters in values); names and
44 values are reencoded to the console encoding. Text nodes and comments are
45 collected in a file named "text", stripped and reencoded. The filesystem is
46 read-only.
47
48 Implementation based on minidom doesn't understand namespaces, it just shows
49 them among other attributes. ElementTree-based implementation doesn't show
50 namespaces at all. Implementation based on lxml.etree shows namespaces in a
51 separate file "namespaces".
52
53 It is useful to have a top-down view on an XML structure but it's especially
54 convenient to extract text values from tags. One can get, for example, a
55 base64-encoded image - just walk down the VFS to the tag's directory and copy
56 its text file to a real file.
57
58 The VFS was inspired by a FUSE xmlfs: https://github.com/halhen/xmlfs
59
60
61 AUTHOR
62    Oleg Broytman <phd@phdru.name>
63
64 COPYRIGHT
65    Copyright (C) 2013-2015 PhiloSoft Design
66
67 LICENSE
68    GPL