Version 1.1.4: minor documentation update

Explain that numbering of tags' "directories" prevents name clash when
with the names of special files used by XML VFS.

diff --git a/xml b/xml
index 4822ab8c6005edc39c7995afe1fd856adcc62883..9d852ebce4c1186a6e3f06dce0fb5a8ea990f2f3 100755 (executable)
--- a/xml
+++ b/xml
@@ -18,12 +18,13 @@ http://phdru.name/Software/mc/xml_INSTALL.html.
 
 The VFS represents tags as directories; the directories are numbered to
 distinguish tags with the same name; numbering also 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
+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
@@ -40,7 +41,7 @@ The VFS was inspired by a FUSE xmlfs: https://github.com/halhen/xmlfs
 
 """
 
-__version__ = "1.1.3"
+__version__ = "1.1.4"
 __author__ = "Oleg Broytman <phd@phdru.name>"
 __copyright__ = "Copyright (C) 2013-2015 PhiloSoft Design"
 __license__ = "GPL"

diff --git a/xml-ANNOUNCE b/xml-ANNOUNCE
index 375a4654251351753731d843b199766adc72632a..3d415d16e5cf6bb7d0f78ed5702d10820a0da5ba 100644 (file)
--- a/xml-ANNOUNCE
+++ b/xml-ANNOUNCE
@@ -6,6 +6,9 @@ WHAT IS IT
 
 
 WHAT'S NEW
+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).
 
@@ -37,12 +40,13 @@ WHERE TO GET
 
 The VFS represents tags as directories; the directories are numbered to
 distinguish tags with the same name; numbering also 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
+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

diff --git a/xml-ANNOUNCE-ru b/xml-ANNOUNCE-ru
index 5ee4f3b4be92918f74d14025f1ee7f5f0aa195f3..3e9d32b72023b515d498f6cbcde3d0ceacb91a90 100644 (file)
--- a/xml-ANNOUNCE-ru
+++ b/xml-ANNOUNCE-ru
@@ -17,12 +17,13 @@ XML VFS 
 
 XML VFS показывает теги как директории; директории пронумерованы, чтобы
 отличать теги с одинаковыми именами; кроме того, нумерация позволяет сохранять
-порядок тегов вместо сортировки их по имени. Атрибуты, текстовое содержание и
-комментарии показываются как файлы; атрибуты показываются в файле "attributes"
-в виде пар имя=значение; имена и значения перекодируются в кодировку локали.
-Текстовое содержание и комментарии показываются в файле "text"; начальные и
-концевые пробелы убираются, текст перекодируется. Файловая система только для
-чтения.
+порядок тегов вместо сортировки их по имени, и предотвращает конфликт имён в
+случае, когда имена тегов совпадают со специальными именами файлов,
+используемыми в XML VFS. Атрибуты, текстовое содержание и комментарии
+показываются как файлы; атрибуты показываются в файле "attributes" в виде пар
+имя=значение; имена и значения перекодируются в кодировку локали. Текстовое
+содержание и комментарии показываются в файле "text"; начальные и концевые
+пробелы убираются, текст перекодируется. Файловая система только для чтения.
 
 Реализация на основе minidom не понимает пространств имён; пространства имён
 показываются среди прочих атрибутов. Реализация на основе ElementTree не

diff --git a/xml-ChangeLog b/xml-ChangeLog
index a45f8902a65713cada8e3b109a1c50287931d6ce..3f5b208912f8bc1ec80e97e0e1a7dfaef2591415 100644 (file)
--- a/xml-ChangeLog
+++ b/xml-ChangeLog
@@ -1,3 +1,7 @@
+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).