Version 1.1.4: minor documentation update
authorOleg Broytman <phd@phdru.name>
Sat, 21 Mar 2015 18:41:18 +0000 (21:41 +0300)
committerOleg Broytman <phd@phdru.name>
Sat, 21 Mar 2015 18:41:18 +0000 (21:41 +0300)
Explain that numbering of tags' "directories" prevents name clash when
with the names of special files used by XML VFS.

xml
xml-ANNOUNCE
xml-ANNOUNCE-ru
xml-ChangeLog

diff --git a/xml b/xml
index 4822ab8..9d852eb 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"
index 375a465..3d415d1 100644 (file)
@@ -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
index 5ee4f3b..3e9d32b 100644 (file)
@@ -17,12 +17,13 @@ 
 
 XML VFS показывает теги как директории; директории пронумерованы, чтобы
 отличать теги с одинаковыми именами; кроме того, нумерация позволяет сохранять
-порядок тегов вместо сортировки их по имени. Атрибуты, текстовое содержание и
-комментарии показываются как файлы; атрибуты показываются в файле "attributes"
-в виде пар имя=значение; имена и значения перекодируются в кодировку локали.
-Текстовое содержание и комментарии показываются в файле "text"; начальные и
-концевые пробелы убираются, текст перекодируется. Файловая система только для
-чтения.
+порядок тегов вместо сортировки их по имени, и предотвращает конфликт имён в
+случае, когда имена тегов совпадают со специальными именами файлов,
+используемыми в XML VFS. Атрибуты, текстовое содержание и комментарии
+показываются как файлы; атрибуты показываются в файле "attributes" в виде пар
+имя=значение; имена и значения перекодируются в кодировку локали. Текстовое
+содержание и комментарии показываются в файле "text"; начальные и концевые
+пробелы убираются, текст перекодируется. Файловая система только для чтения.
 
 Реализация на основе minidom не понимает пространств имён; пространства имён
 показываются среди прочих атрибутов. Реализация на основе ElementTree не
index a45f890..3f5b208 100644 (file)
@@ -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).