Changes between Version 10 and Version 11 of FileListFormat

Timestamp:

Jun 24, 2008 1:00:16 AM (16 years ago)

Author:

Sagrer

Comment:

--

FileListFormat

@@ -8 +8 @@
 ----
 
-Назначение формата - хранение списка файлов с абсолютными или относительными путями + при необходимости их чексум по определенному алгоритму.
+Назначение формата - хранение списка файлов с абсолютными или относительными путями + при необходимости их чексум по определенному алгоритму. Сюда-же записывается информация о принадлежности файла к некоей определенной группе - это может быть использовано для хранения в одном списке информации о файлах с одинаковыми именами и расположением, но физически и по содержанию - разных. Например для языковых пакетов.
 
 Формат представляет из себя гибрид *.ini-файла с нестандартной секцией [files] - содержимое секции читается по строкам и содержит пути к файлам и их чексуммы.
@@ -29 +29 @@
  * AddCRC32 (bool) - добавлять ли crc32 файла.
  * !FilesNum (integer) - количество файлов в списке.
+ * !UseGroups (bool) - используются ли группы файлов. По умолчанию false.
+ * !UsedGroups (string) - имена всех используемых групп файлов, через запятую, по умолчанию значение только none, но вообще это значение используется для оптимизации и исключения необходимости парсеру каждый раз при открытии нового списка просматривать весь список файлов для получения списка всех групп - поэтому реализация обязана поддерживать актуальность информации в данном параметре после любого изменения собственно списка файлов.
 
 ----
@@ -36 +38 @@
 Нестандартная для обычного ini секция. Внутри список файлов - по 1 строке на каждый файл. Строка вида: Parameter1 : Value1; Parameter2 : Value2; ... ; ParameterN : ValueN
 
-Обязательные параметры: File - путь к файлу или папке.
-
-Type - тип - файл или папка - значение либо File либо Dir.
+Обязательные параметры:
+ * File - путь к файлу или папке.
+ * Type - тип - файл или папка - значение либо File либо Dir.
 
 Также возможны параметры:
  * Size с числовым значением в байтах - размер;
  * CRC32 со значением чексуммы.
+ * Group с текстовым значением - именем группы файла. Если [Main]->!UseGroups == true то этот параметр обязателен. Если файл не принадлежит явно какой-либо группе - то устанавливается значение "none" (без кавычек, ессно) - например при чтении списка в формате более старой версии, когда еще не было групп.