Copyright: MultiArc for TotalCommander ©2000-2006 by  Multiarc Team
Citation: Citation from MultiArc for TotalCommander Help © 2000-2006 by  Multiarc Team


  MultiArc Online Help

 Используйте следующие ссылки для получения детальных пояснений и описаний об инсталляции, конфигурировании, истории версий и людях которые были вовлечены в процесс тестирования, использования и улучшения.

 Лицензирование MultiArc

 Как установить MultiArc

   Визуальное конфигурирование

 Описание multiarc.ini

 Описание языкового файла (*.lng)

 История изменений

 Известные проблемы

 Доска Почета

Что такое MultiArc?

   MultiArc это архиваторный плугин для популярного и лучшего файлового менеджера операционной системы MS Windows - Total Commander от Кристиана Гислера. Основной идеей MultiArc является использование внешних консольных утилит для работы с архивами из TOTAL COMMANDER. Другими словами MultiArc преобразует команды от TOTAL COMMANDER в вызовы внешних архиваторов, а затем преобразует результаты работы архиваторов в команды Total Commander. Благодаря гибкости настройки MultiArc не очень трудно добавить поддержку новых архиваторов в Total Commander. Все что вы должны сделать это добавить новую секцию в multiarc.ini с нужными командами и описанием типа архива. После инсталляции и настройки MultiArc вы получаете возможность работать с многими типами архивов, которые не поддерживаются Total Commander. И вы также имеете возможность добавлять новые типы которые вам нужны простым добавлением новой секции в MultiArc.ini.

Если вы имеете любые предложения по функциональности, или хотите сообщить о досадных ошибках, вы можете сделать это на сайте MultiArc: http://sourceforge.net/projects/wcx. Писать желательно на Английском языке, т.к. он является рабочим на этом сайте.Так же вы можете писать на Русском или Украинском языках по адресу mailto: vserd@users.sourceforge.net (Владимир Сердюк).

(c) 2000-2003 by Siarzhuk Zharski

(c) 2005-2007 by Multiarc Team


Установка MultiArc

Как установить MultiArc:

 Сначала вы должны распаковать содержимое дистрибутивного архива в директорию где вы хотите разместить MultiArc. Существуют два метода конфигурирования MultiArc:

"Визуальная" конфигурация

Начиная с версии 1.1.0 появилась возможность использовать диалог Настройка Multiarc для работы с параметрами архиватора. См. следующую ссылку для подробной информации:

 Диалог Настройка MultiArc

Ручная конфигурация:

1. Редактирование  multiarc.ini для настройки типов архиваторов. Дополнительные архиваторные addon-ы вы можете найти в поддиректории "addons" дистрибутивного архива. Требуется только скопировать и вставить секцию из .addon в multiarc.ini. Обратите внимание, что в большинстве случаев вы должны изменять параметр "Archiver" он должен быть реальным путем к внешнему архиватору на вашей системе.

2. Запустите Total Commander и выберите в меню Конфигурация ->Настройки. выберите раздел Архиваторы.

3. В появившемся диалоге введите расширение на которое хотите зарегистрировать архиватор, затем щелкните на кнопке "Обзор" и выберите multiarc.wcx из директории куда вы распаковали плугин. Нажмите ОК.

Инсталляция завершена. Если вы хотите зарегистрировать другие расширения для использования с MultiArc повторите процедуру.


Диалог Настройка MultiArc

 Диалог конфигурации MultiArc позволяет настроить поведение плугина, выбрать язык, управлять Addon-ами, которые будет использовать MultiArc в своей работе.Вы можете вызвать этот диалог во время подготовки к архивированию в формат поддерживаемый MultiArc (через кнопку Настройка.. диалога Упаковка файлов), либо вручную (перейдя в директорию с плугином и набрав в командной строке TOTAL COMMANDER-а команду rundll32 multiarc.wcx,Settings)

Диалог настройки MultiArc содержит следующие страницы:

Страница О плугине

На этой вкладке вы можете узнать информацию о версии плугина, e-mail адрес разработчиков, адрес страницы, на которой следует искать информацию об обновлениях. На ней также размещены благодарности и лицензионная информация.

Страница Addons

Эта вкладка поможет вам работать со всеми дополнениями (addon), которые зарегистрированы для текущего использования, добавить или удалить дополнения в multiarc.ini.

 Страница Addons

Страница Настройки

Здесь расположены некоторые глобальные настройки, влияющие на весь плугин, параметры и настройки консоли.

 Страница Настройки

Страница Язык

Здесь можно выбрать язык интерфейса плугина.

 Страница Язык

Как вызвать диалог Настройка Multiarc извне.

Начиная с версии 1.1.0 вы можете открыть диалог конфигурации плугина вне TOTAL COMMANDER, выполнив из командной строки следующую команду:

rundll32 multiarc.wcx,Settings

маленькая подсказка: Вы можете настроить меню "Start" или кнопку на палени управления для вызова этой команды. Обратите внимание: для корректного вызова диалога текущей директорией должна быть директория с плугином. Еще одна маленькая подсказка внутри multiarc.wcx есть иконка для тулбара, попробуйте ее!

Внимание!!!

Если вы  настраиваете MultiArc через rundll32, пожалуйста установите правильный путь к файлу настроек Total Commander (Меню, Справка, О Total Commander, INI-files). В противном случае функция регистрации/разрегистрации addon-ов будет работать не корректно.

Совет: Если вы хотите только распаковывать файлы, то вам достаточно будет зарегистрировать multiarc.wcx в wincmd.ini только один раз. Регистрация в wincmd.ini нужна для упаковки файлов (каждое расширение должно быть уникальным).


Настройка MultiArc. Addons

 Лучший путь изучить назначение контролов -- использовать кнопку контекстной помощи ("?") в заголовке диалога.

Тип

Тип архива. Это значение связано с ключом TypeName . Поле справа от этого комбобокса отображает содержимое ключа Description . В этом комбобоксе есть специальное значение с именем MultiArc - "The general settings". С помощью него вы можете изменять глобальные параметры. Глобальные параметры используются если Addon не определяет соответствующие локальные значения. См. Обработка  параметра %S ниже.

Путь

Это поле отображает содержимое ключа Archiver  и позволяет редактировать его. Кнопка с права открывает стандартный диалог выбора для помощи вам в выборе нужной программы.

Статус

Это поле отображает информацию о текущей регистрации addon-а в TOTAL COMMANDER.  Требуемая Информация считывается из wincmd.ini и отображает был ли зарегистрирован и на какие расширения. Кнопка справа Изменить... отображает диалог Возможности архиватора , который позволяет изменять некоторые возможности этого addon-а.

Примечание. Если addon позволяет только распаковывать файлы, или вы не хотите упаковывать в этим архиватором, можете не регистрировать этот addon. Но по крайней мере один addon должен быть зарегистрирован в wincmd.ini.

Обработка %S-параметра

Эта группа контролов позволяет настроить %S-параметры . Вы можете активировать или деактивировать эту функциональность, изменить поведение этой функциональности через комбобокс и включить или исключить обработку параметра %S из вызовов команды LIST.

Примечание: Меленькая проблема с режимом "Для следующей команды". Этот режим работает только для следующего вызова и будет установлен в "Никогда" после выполнения вызова. Так что не будет сюрпризом если этот режим никогда не будет сохраняться!!!

Импорт Addon-а

Эта кнопка помогает вам добавить описание архива из внешнего *.addon файла.

Удалить Тип

Эта кнопка помогает вам удалить не нужное описание типа архиватора из multiarc.ini.

Изменить MultiArc.ini...

Эта кнопка запускает текущий редактор с файлом multiarc.ini. Вы можете сделать любые изменения в multiarc.ini в ручную. Но если вы закроете сессию редактирования перед продолжением настройки МultiArc вы можете увидеть диалог с кнопкой "Прекратить редактирование".


Настройка MultiArc. Настройки

 Отображать консоль - Выберите режим поведения консоли

никогда - Консоль никогда не будет показываться

если определено (%C) - консоль будет отображаться только если для команды определен параметр %C

всегда - консоль будет отображаться всегда

exclude LIST calls Если установлен консоль не будет отображаться при выполнении команд LIST

Минимизировать в трей - консоль находится в системном трее в минимизированном состоянии.

Автоматически закрывать/минимизировать - Автоматически закрывать консоль после завершения выполнения команды.

Задержка перед открытием - задержка в секундах перед открытием окна консоли.

Высота консоли - Окно консоли будет содержать не более этого числа строк. Если установлено в 0 (ноль) или пустое  проверка на число строк не производиться, все строки остаются не тронутыми.


Настройка MultiArc. Язык

На этой странице можно установить язык интерфейса плугина. Если в папке, где установлен плугин, отсутствует подпапка Lang, то языком по умолчанию является Английский.

Язык -  В этом выпадающем списке перечислены все языки которые есть в папке Lang. Через пробел выводится файл в котором находится перевод. Языковой файл представляет собой обыкновенный текстовый файл, так что если вы знаете более лучший перевод, вы можете легко его подправить.

Пожелание: Отправьте ваш вариант перевода автору соответствующего файла, и, возможно, он включит его в следующую версию.

Информация о языковом файле - Все параметры которые представлены в этом блоке являются не обязательными, и заполняются авторами переводов в сугубо добровольном порядке.

Версия -  отображается версия языкового файла. (Желательно заполнять, для облегчения поиска более поздней версии пользователями перевода).

Дата изменения -  Дата последней модификации.

Copyright - авторские права на перевод.

Автор(-а) - автор или автора перевода.

Доп. информация - все что автор(-а) перевода посчитали нужным добавить.

Контактная информация - адрес электронной почты, или другой по которому можно будет написать автору перевода.

Лицензия - под какой лицензией автор опубликовал свой труд.

Более поднобную инфу см [image] Описание Языкового файла


Диалог Возможности

 Этот диалог позволяет зарегистрировать addon в TOTAL COMMANDER-е. Регистрация означает добавление/замену значения в секции [PackerPlugins] текущего файла wincmd.ini. Здесь также возможно изменить некоторые параметры используемые TOTAL COMMANDER во время работы с этим типом архивов.  Обратите внимание что бездумное редактирование его не очень хорошая идея. Только "Поддерживает тестовый поиск" и "Скрывать "архивную" иконку" полезны. Другие зависят от TOTAL COMMANDER-а и не рекомендуются что-либо делать с ними. Используйте контекстную помощь для более детального описания этих контролов.

 Note: Регистрация расширения нужна в случае если вы хотите создавать архивы некоторого типа. Если вы хотите только распаковывать файлы, вам нужна только одна запись в wincmd.ini [PackerPlugins]. Зарегистрировать можно на любое расширение. Смотрите также: Как происходит поиск архиваторных плугинов в Total Commander .


Как происходит поиск архиваторных плугинов в Total Commander

Note: Информация о том как происходит поиск плугинов была получена из анализа работы Total Commander. Автор Total Commander-а никогда не публиковал данную информацию.

Поиск архиваторного плугина осуществляется следующим образом.

1. Total Commander проверяет может ли он обработать файл с данным расширением.

2. Если может, осуществляется обработка. Дальнейший поиск не производится.

3. Если не может, тогда ищется расширение в wincmd.ini секция [PackerPlugins]

4. Если нашли, тогда передаем файл на обработку ему, поиск прекращаем. Даже если плугин предназначен для совершенно другого типа файлов, и возвращает ошибку, Total Commander не производит дальнейший поиск.

Как пример можно привести расширение EXE. Под этим расширением может быть как "обычная" программа, так и самораспаковывающийся архив. Самораспаковывающийся архив может быть различного типа (RAR, ZIP, MS CAB, InstallShield инсталяция, InnoSetup и так далее).

5. Если расширения не найдено, Total Commander производит перебор всех плугинов из wincmd.ini секция [PackerPlugins] начиная с первого. Если плугин может обработать файл, он говорит об этом Total Commander-у и Total Commander прекращает поиск и вызывает плугин. Когда перебраны все записи о плугинах, Total Commander ничего не делает.

Отсюда следует вывод. Для успешной работы нескольких плугинов, которые могут обрабатывать одинаковые расширения, нужна только запись о плугине в wincmd.ini [PackerPlugins].

Под каким расширением будет зарегистрирован плугин, совершенно не важно.

Если несколько плугинов могут обработать один и тот-же тип архивов (например ms cab), будет вызван первый плугин в порядке очереди в [PackerPlugins].

Total Commander использует записи в wincmd.ini [PackerPlugins] для упаковки файлов. Вы можете выбрать тип архива из комбобокса и создать файл данного типа.

Применительно к MultiArc это означает что вы должны регистрировать только те типы Addon-ов которые будете использовать для создания архивов. Для распаковки архивов вам достаточно одной любой записи в wincmd.ini [PackerPlugins] в которой упоминается MultiArc.


Описание Multiarc.ini

Зачем нужен multiarc.ini?

 Все настройки MultiAr хранятся в файле multiarc.ini. Этот файл это стандартный INI-файл Windows. Он содержит несколько разделов (секций). Эти секции содержат параметры - пары строк разделенные знаком равно (=). Эти файлы являются текстовыми и могут быть отредактированы любым текстовым редактором. Каждый архиватор поддерживаемый MultiArc должен быть описан в отдельной секции в multiarc.ini. Смотрите ниже детальную информацию об их структуре. Также есть специальная секция с именем "MultiArc". Эта секция содержит настройки которые применяются ко всем архиваторам, т.е. общие настройки.

Структура типичной секции описания архиватора:

[Имя_типа]

Параметр=Значение параметра

Шаблон= Строка представляющая шаблон

Команда= строка команды

Флаг = 0 или 1 в зависимости от состояния флага.

Имя_типа краткое имя типа архиватора. Обязательно, и должно быть уникальным. Должно быть набрано символами английского алфавита.

Пример:

[ARJ]

Параметры

Archiver Путь к архиватору. Путь может содержать переменные окружения, например %WINDIR% или %COMMANDER_PATH%.

ID (необязательный) -- сигнатура (ID) архиватора, используется для определения является ли данный файл архивом этого типа. Записывается группами по 2 шестнадцатеричных символа, разделенные пробелами. Если архиватор может обрабатывать несколько версий архивов с разными сигнатурами, они разделяются запятыми.

IDPos (необязательный) -- позиция ID в архиве. Если позиция не указана, ID будет искаться начиная с начала архива. Вы можете определить позицию с конца файла, с помощью знака "-" (минус). Если для архивов с этим ID может быть несколько мест расположения сигнатуры, они разделяются запятыми (обычно это разные версии архивов, поддерживаемые архиватором). Также обратите внимание на описание флага SkipSfxHeader. Специальное значение <SeekID> определяет нужно ли искать ID, если они не найдены по другим позициям указанным в параметре. Если IDPos отсутствует, тогда ID будет искаться в диаппазоне: меньшее из значений - размер файла, IDSeekRange. Значения можно вводить в десятичном  или шестнадцатеричном виде. Например позицию находящуюся в 12345 байт от начала файла можно описать как

IDPos = 12345

(в десятичном исчислении) или (в шестнадцатеричном исчислении)

IDPos = 0х3039

Отрицательные значения в шестнадцатеричном виде описываются как 0xFFFFFFFF (-1 в десятичном)

IDSeekRange (необязательный) число байт, в котором MultiArc будет пытаться найти ID.Если параметр отсутствует, будет использовано меньшее из значений Размер_файла или 1Мбайт. Поиск всегда происходит от начала файла, SkipSfxHeader игнорируется. Это может замедлить открытие архивов или поиск в архиве. Если отсутствует IDPOS, тогда используется поиск ID в диаппазонеот начала файла до меньшего из значений -- (размер файла, IDSeekRange).

ExcludeIDs (необязательный)  Сигнатура при нахождении которой файл определяется как "Обработать не возможно".

Данная возможность введена для корректной обработки файлов генерируемых программами InnoSetup, NSIS (NullSoft Instalation System) и возможно другими.

Алгоритм работы данного параметра:

Если находим ID из параметра ID, тогда проверяем ExcludeIDs.

Если нашли совпадение по любому исключаемому ID, тогда считаем что файл не поддерживается утилитой Archiver.

Формат параметра: (Signature, [offset], [Absolute]),(Signature, [offset], [Absolute]), .... (Signature, [offset], [Absolute]).

Где:

Signature -- это последовательность байтов которые должны быть найдены.

Absolute -- (необязательный) абсолютное (1) или относительное (0) смещение. если не указан, по умолчанию = 0.

Если 1, тогда смещение берется от начала файла (если Offset >= 0), или от конца файла (если Offset <0).

Если 0, тогда смещение берется относительно найденого ID. Смотри также описание параметра offset

Offset -- (необязательный) Смещение относительно текущего ID (если = 0, тогда смотрим начиная с начала ID, если >0 тогда на offset байт в перёд (к концу файла) от начала сигнатуры (ID), если <0 тогда на offset байт назад (к началу файла) от начала сигнатуры. Если опущен, тогда по умолчанию = 0. Смотри также описание параметра Absolute.

Пример для параметра ExcludeIDs.

ID= 01 02 03 04, 01 03 02

IDPOS = 5

ExcludeIDs= (00, -1), (01 02 03 04 05,0), (06,5), (07,11, 1), (08,-1, 1)

MultiArc будет определять что файл может быть обработан если совпала хоть одна сигнатура из ID, и не совпали сигнатуры из ExcludeIDs.

В этом примере будет приняты файлы которые содержат в себе последовательность байт (xx в данном примере любые байты):

0  1  2  3  4  5  6  7  8

xx xx xx xx xx 01 02 03 04 xx (кроме правила (01 02 03 04 05,0))

xx xx xx xx xx 01 03 02 xx

но отвергнуты файлы которые содержат

0  1  2  3  4  5  6  7  8  9

xx xx xx xx 00 01 02 03 04 xx                  правило (00, -1)

xx xx xx xx 00 01 03 02 xx

0  1  2  3  4  5  6  7  8  9  10

xx xx xx xx xx 01 02 03 04 05 xx               правило (01 02 03 04 05,0)

0  1  2  3  4  5  6  7  8  9  10 11 12 13

xx xx xx xx xx 01 02 03 04 xx xx xx xx 06      правило (06,5)

xx xx xx xx xx 01 03 02 xx xx xx xx 06 xx

0  1  2  3  4  5  6  7  8  9  10 11 12

xx xx xx xx xx 01 02 03 04 xx xx 07 xx         правило  (07,11, 1)

xx xx xx xx xx 01 03 02 xx xx xx 07 xx

0  1  2  3  4  5  6  7  8                 EOF

xx xx xx xx xx 01 02 03 04 .............. 08   правило (08,-1, 1)

xx xx xx xx xx 01 03 02 xx .............. 08

Extension расширения, которые используются архивами (без точки).

Description Описание архиватора. Строка содержащая версию, автора и т.п.

Пример:

ID = 00 FF, CC DD, 55 EF 32 12,

IDPos = 0, 0xd, -6, <SeekID>

IDSeekRange=100000

Extension = hhh, hpj, tzu

Description="PivkARC v7.1365 (c) by Kon' Petrovich"

Архивы в этом примере будут проверяться в следующем порядке.

Установка позиции в 0 и проверка каждого ID определенного в параметре. Затем переход в позицию 13 и проверка всех ID, переход на позицию 6 считая с конца файла, и в конце, искать ID в диаппазоне от 0 до 100000 если файл больше 100000 или 0-размер файла. Если в какой-либо из этих проверок файл будет содержать один из ID файл считается поддерживаемым этим архиватором.

Шаблоны

Start(необязательный) любая часть строки в выводе выдаваемом архиватором в процессе обработки.

End (необязательный) любая часть строки в выводе выдаваемом архиватором в процессе обработки.

Примечание для Start и End шаблонов: Если текст начинается с '^', он будет сравниваться начиная с начала строки, символ ^ в сравнении не участвует. В остальных случаях текст будет искаться в любом месте строки.

Format0 ... Format<n> - формат вывода файлов. Если описание файла в выводе архиватора расположено на нескольких строках, используйте соответствующее число параметров Format. Вы можете определить до 50 строк Format.

Описание строк Format

Пример:

Start="^-------"

End="^Total files listed: "

Format1="zzzzzzzzzz aaaaa                        yyyy tt dd hh mm ss"

Format2=" "

Команды

List - получение списка содержимого архива.

Extract - Извлечение файла из архива.

ExtractWithPath - Извлечение файла(-ов) из архива с полным путем.

Примечание к командам извлечения: Если флаг BatchUnpack установлен в 1 будет использован ExtractWithPath.

Test - проверка архива.

Delete - удалить файл из архива.

Add - добавить файл в архив.

Move - переместить файл в архив.

InputString - вставка некоторой строки во входной поток архиватора. Это используется для эмулирования нажатий некоторых клавиш при старте архиватора. Используется для некоторых шароварных утилит требующих нажатия Y перед работой. =-)

Обратите внимание: Все команды за исключением InputString используют формат определения команд

Флаги

IgnoreErrors если активен, код завершения архиватора игнорируется. Используйте с осторожностью.

SkipEmpty Файлы с пустыми именами не будут добавляться в список

SkipDirsInFileList не добавлять директории в список файлов.

SearchForUglyDirs попробуйте этот параметр когда ваш архиватор генерирует листинг без завершающего '\'. Эта опция указывает MultiArc искать такие "уродливые" директории и исправлять список для того чтобы Total Commander мог работать с ними. Используйте этот флаг, только если вы действительно нуждаетесь в нем -- эта опция может замедлять скорость обработки ...

BatchUnpack если установлен MultiArc не будет распаковывать по одному все файлы, как ожидает Total Commander. В место этого он будет распаковывать такие файлы на "фазе закрытия архива" одним вызовом архивной утилиты. Эта опция очень полезна для "сплошных" архивов... Но ... есть некоторые визуальные неожиданности при использовании этого режима - индикатор распаковки не будет отображать реальный процент... Более подробную информацию по проблеме BatchUnpack смотрите также в Известные ошибки .

UnixPath Если пути в выводе архиватора в формате Unix установите этот флаг.

Debug если этот флаг активен -- весь вывод утилиты архивирования будет записан в лог-файл, расположенный в той-же директории что и multiarc.wcx с именем "multiarc.%TYPENAME%.log" где %TYPENAME% это TypeName соответствующего описания архиватора. Если некоторый список файлов используется в командах, эти файлы также не будут удалены после выполнения команды. Ищите их в папке %TEMP%/$mltwcx. Устанавливайте этот флаг, только если вы выполняете запись всей активности. Это нужно во время написания нового addon-а. Не используйте его если вы не нуждаетесь в нем. Этот лог файл может "съесть" ваше свободное дисковое пространство очень быстро. =-) Вы предупреждены!.

SkipSfxHeader по умолчанию false. Определяет нужно ли пропускать SFX-часть архива для поиска ID архива. Пример:

7z SFX-архив, сам архив находится после SFX части, и поиск ID нужно начинать после пропуска этой части, SkipSfxHeader должно быть TRUE. 7z отличается от других архиваторов, тем что от версии к версии меняется размер SFX распаковщика, кроме того есть другие SFX части, не от авторов 7z. Размер этих частей различен, хотя ID архива находится на фиксированном месте. До этого флага, нужно было указывать список IDPos, но если требуемой позиции не удавалось найти, MultiArc не мог обработать такой архив.

Инсталяция InnoSetup. ID находится в SFX части архива, пропуск делать не нужно. Искать нужно с начала файла, SkipSfxHeader должен быть False.

; признак комментария, эта строка будет проигнорирована.

Файл addon-а является секцией MultiArc.ini и предназначен для передачи другим пользователям MultiArc.


Описание строк Format

 Для разбора файла вывода MultiArc использует шаблон FormatN. Если список файлов использует одни и те же строки для вывода информации о каждом файле в архиве используйте соответствующее число шаблонов Format. Шаблон Format это строковая маска для извлечения информации из одной строки списка файлов.  Используйте следующие символы для определения шаблона:

;  n - имя файла

;  . - удаление концевых пробелов из имен файлов и добавление имени с точкой

;  z - размер не сжатого файла

;  c - описание файла

;  p - размер сжатого файла

;  d - день

;  t - месяц

;  TTT - трехбуквенное имя месяца (Jan, Feb, Mar, ...)

;  y - год

;  h - часы

;  H - буква - модификатор часов (a - время до полудня (a.m. time),

                                  p - время после полудня (p.m. time))

;  m - минуты

;  s - секунды

;  a - атрибуты

;  e - расширение файла

;  * - пропускать до первого пробела или конца строки

Пример:

Часть вывода лога JAR :

346) install\f_0286

      3656 A.... Win-32  Solid    1-1   2002-07-11 13:36:26 2002-12-09 20:41:20

                           26                               2002-12-09 00:00:00

347) install\f_0287

     11323 A.... Win-32  Solid    1-1   2002-07-11 13:36:26 2002-12-09 20:41:20

                           26                               2002-12-09 00:00:00

и соответствующие форматы шаблонов:

Format0="* nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn"

Format1="zzzzzzzzzz aaaaa                        yyyy tt dd hh mm ss"

Format2=" "


Формат определения команд

 Команда это строка которая содержит переменные. Эти переменные имеют знак "%" перед ними и могут быть заменены во время вызова команды.

Список переменных команд:

  %P - Длинное имя архиватора (как оно в параметре "Archiver")

  %p - короткое имя архиватора (как оно в параметре "Archiver")

  %A - длинное имя архивного файла

  %a - короткое имя архивного файла

  %L - имя Filelist (списка файлов). Filelist -это файл содержащий имена файлов

       которые должны быть обработаны внешним архиватором. Имена файлов длинные.

  %l - Filelist с короткими именами файлов.

  %F - имя одного файла для обработки. Архиватор будет вызван несколько раз, до тех

       пор пока все файлы не будут обработаны.

       Эта переменная должна быть использована только если архиватор не поддерживает

       список файлов в строке вызова.

  %E<errorlevel> - максимальный допустимый код завершения (errorlevel).

       Например, %E2 означает что принимаются коды завершения 0, 1 и 2.

       Эта переменная может быть указана в любом месте команды. Если она

       отсутствует, только код завершения 0 распознается как успешный.

  %O - По умолчанию, MultiArc преобразует вывод архиватора из OEM кодировки

       (DOS) в ANSI (Windows). Применяйте его для пропуска преобразования.

  %R - целевая поддиректория В архиве

  {} - если некоторые переменные заключены в фигурные скобки она будет

       добавлена только если  эта переменная содержит что-либо не пустое. Смотрите

       MsCAB addon для примера использования. ВНИМАНИЕ - сейчас работает только с

       переменной %R.

  %S - Зависит от режима, устанавливается в диалоге Настройка MultiArc, MultiArc будет

       запрашивать пользователя дополнительные параметры командной строки, которые

       должны быть размещены на месте %S.

  %C - Не скрывать окно консоли во время выполнения внешнего архиватора. Настройка консоли

       имеет больше настраиваемых параметров, см диалог Настройка MultiArc.

  модификаторы переменных Q, q, W, P, A могут быть использованы для изменения формата имен

  файлов:

  Q - Заключать в кавычки имена с пробелами;

  q - Заключать в кавычки все имена;

  W - Использовать только имена, без пути;

  P - Использовать только путь, без имени;

  A - Использовать ANSI кодировку.

  Эти модификаторы могут быть указаны сразу после переменной, без пробелов.

Реальные примеры команд смотрите в addon-ах.

Примечание:

 Если у вас архиватор находится в пути с русскими буквами (по логике с любым путем, содержащим символы не английского алфавита и цифры) и вы получаете сообщение наподобии такого:

"Executing command 'C:\Documents and Settings\Ђ¤¬Ё­Ёбва в(r)а\ђ Ў(r)зЁ(c) бв(r)"\7za.exe -r0 l D:\Это тест русских имен TC\7zSfx.7z' returned errorlevel -1. Possibly an error occurred. Archive listing wasn't retrieved."

либо такого:

"Executed command 'C:\Documents and Settings\Ђ¤¬Ё­Ёбва в(r)а\ђ Ў(r)зЁ(c) бв(r)"\7za.exe -r0 l D:\Это тест русских имен TC\7zSfx.7z' returned errorlevel -1, which is higher than configured as normal for this command. Probably error occurred. Check your configuration, please..."

Замените в Multiarc.ini в секции соответствующего архиватора параметры Extract, ExtractWithPath, Test, Delete, Add с %Р на %PA или %PQA.


Описание языкового файла

 Языковой файл предназначен для перевода плугина на соответствующий язык.

Файл представляет собой обычный файл настроек Windows (INI) с расширением .lng

Файлы с переводами должны находиться в подпапке Lang папке с плугином.

Языком по умолчанию для плугина является английский. Если нет ни одного языкового файла, будет использован именно он. Исходным для перевода является файл English.lng.

Текущий пользовательский выбор храниться в multiArc.ini в параметре LanguageFile.

 Описание файла .lng

Все значения параметров должны быть написаны в одну строку (это ограничение WIN API).

Секция Authoring - секция содержит информацию об авторе/авторах локализации.

Все параметры в этой секции являются не обязательными, но некоторые все таки желательно заполнять.

Author - автор локализации.

CopyRight - сведенья об авторских правах.

Version - версия файла перевода. Желательно заполнять. Облегчает процесс поиска более новой версии.

DateEdit - Дата последнего изменения файла перевода. Желательно заполнять. Облегчает процесс поиска более новой версии.

License - Лицензия

OtherInfo - Дополнительная информация, на ваш выбор.

ContactInfo - контактная информация. Желательно заполнять. Если у пользователей возникнет вопрос или они придумают лучший перевод, то смогут связаться с вами.

Секция Lang - секция содержит переводы соответсвтующих строк, наименование языка и имя файла справки.

Name - имя языка перевода. Формат имя_на_языке_перевода (оно_же_по_английски).Пример: Русский (Russian)

HelpFile - имя файла справки. Файл должен находиться в той-же папке что и сам плугин. Если параметр отсутствует или пустое, используется MultiArc.hlp (английский язык).Все номерные параметры являются переводами. Пример:

1=Сохранить

2=Отмена


MultiArc revisions history

описание:

! - важная информация

+ - добавлено свойство

- - удалено свойство

? - осталась проблема

* - исправлена ошибка

======================================================

26/07/2007 ver 1.4

+ Добавлена возможность вводить в IDPOS значения в шестнадцатеричной форме (например 0x12345), десятичные значения также продолжают использоваться.

! Добавлена поддержка переменой окружения %COMMANDER_INI%

* Исправлена ошибка, когда при импорте Аddion-a не отображались имена секций, находящиеся в Аddion-е.

* Увеличен лимит с 4096 до 65536 байт при чтении строки из Аddion-a.

======================================================

16/05/2006 ver 1.3.0.4 beta

* Исправлена ошибка при входе в архив с нулевой длиной.

* исправлена ошибка когда при импорте аддона содержащем больше одной секции импорт был невозможен

* При сохранении не всегда правильно сохранялись IDPos

* Если один и тотже аддон дважды импортировался в течении сесии, строки FormatsX удваивались.

! Изменены ресурсы с ID 1002,1003, 1004. Трансляторы .lang, пожалуйста обновитие свои переводы

* Исправлена ошибка Acces Violation при открытии DOS EXE файлов.

+ Добавлена возможность искать ID в диаппазоне значений. (см описание IDPOS, IDSeekRange)

======================================================

22/03/2006 ver 1.2

+ Добавлено вычисление размера SFX-части самораспаковывающегося архива.     Если установлен флаг SkipSfxHeader, MultiArc будет искать ID после SFX-     части самораспаковывающегося архива. Данная возможность позволяет      использовать различные SFX-заголовки, без внесения их в список IDPos

+ Добавлена поддержка различных языков интерфейса при визуальном конфигурировании,      и работе плугина. Отладочная консоль не переведена принципиально. Обычному      пользователю она не нужна, а разработчики понимают английский.

+ Добавлена поддержка тем Windows XP (Visual Styles).

* Если в Wincmd.ini параметр Editor был задан с переменной окружения, то не      происходил вызов редактора. Ручное редактирование multiarc.ini было не возможно.

======================================================

15/06/2005 ver 1.1.3.3

* Изменен алгоритм поиска wincmd.ini с которым был загружен Total Commander.

======================================================

xx/xx/2003 ver 1.1.3

+ Изменено число ключей "Format<x>". Сейчас вы можете настроить в вашем addon-е до 50 строк.

+ Добавлена поддержка переменных окружения для параметра "Archiver". Вы можете использовать как системные переменные окружения подобные %WINDIR%, так и определяемые Total Commander (например %Commander_Path%) при определении путей к архиватору в параметре  Archiver.

+ Добавлена возможность удалять не нужные типы архивов из multiarc.ini через графический интерфейс.

+ Добавлена кнопка Справка в диалог конфигурации.

======================================================

15/01/2003 ver 1.1.2

* Исправлена ошибка с обработкой параметра %S. Сейчас должен правильно работать с режимом "Только для следующей команды".

* для редактирования multiarc.ini в диалоге Настройка MultiArc используется редактор указанный в wincmd.ini.

* исправлена проблема с ошибкой Access Violation при упаковке CAB файлов.

* В дистрибутив вернул addon MsCAB .6.

* 7-zip addon. Восстановлен список авторов.

* Исправлен InstallShield CAB addon. Добавлен addon для IS 5.5 CABs. Спасибо Guntz Philippe

* Исправлен параметр Format0 в 7-zip addon.

! Благодарю Black Dog за оперативный отчет об ошибках.

======================================================

11/01/2003 ver 1.1.1

* Исправлена ошибка с "потерянной" функцией GetLongPathNameA... Плагин должен теперь работать на NT4 и Win95 системах ... Thanks to someone who knows. =-)

* Исправлено неверное имя контекстной помощи. Спасибо Kirill Voloshin

+ Добавлен новый 7-zip addon от BlackDog.

======================================================

22/12/2002 ver 1.1.0

! Добавлено несколько новых возможностей. Для того чтобы они начали работать, вы должны перерегистрировать MultiArc в Total Commander. Простейший путь сделать это использовать диалог Настройки MultiArc .

+ В этой версии добавлено несколько новых ошибок!. Удачной охоты!!! =-))))

+ Добавлены addon-ы для ICL, образов ISO/BIN/VCD, M$ compund storages, декомпилятор WinHelp , просмотрщик библиотек AR, просмотрщик файлов M$ CHM.

+ Добавлена Консоль MultiArc . Это окно которое ведет себя и похоже на обычное DOS окно. Вы можете настроить его для отображения вывода, который внешний архиватор отправляет на экран (стандартный вывод). Это поможет вам контролировать процессы архивирования, разархивирования и тестирования. Подробности смотрите Диалог настройка MultiArc .

+ Изменен процесс определения изменения MultiArc.ini внешними утилитами. Multiarc.ini  повторно загружается каждый раз когда происходят изменения. Сейчас вы не нуждаетесь в перезагрузке Total Commander после ручного редактирования файла multiarc.ini.

+ Добавлен "локальный" параметр %S. Сейчас вы можете определить этот параметр для каждого используемого addon отдельно.  Глобальный параметр %S также поддерживается. Так что если вы не определили локального параметра, будет использован глобальный (если, конечно, установлен).

+ Коренным образом переработан диалог Конфигурации. Теперь Вы можете изменять некоторые параметры addon-ов прямо из него. Также добавлен автоматический импорт addon-ов и настройка возможностей архиватора.

+ Добавлен новый параметр "Description" в определение типа архиваторов. Этот параметр содержит  описание используемого архиватора. См. в addon-ы для примеров использования этого ключа.

+ Добавлена возможность выбора типа архива во время создания нового архива если некоторые архиваторы зарегистрированы на одно расширение. Например M$ CABs и InstallShield CAB имеют одно и то же расширение. Сейчас пользователя должен выбрать какой тип архивов он хочет создать. Это нужно только для создания нового архива. Добавление работает так как раньше и определение типов архива работает автоматически.

+ Добавлена возможность определять несколько позиций (IDPos) для поиска сигнатур архива (ID). Используется следующий синтаксис:  IDPos = 1, 7 , -6, 4   ID = 00 11 22, 33 44, 55 66 77 88После определения ID MultiArc будет проверять первую позицию (смещение 1) и сравнивать все ID. Другими словами открывает файл, перемещается по смещению 1, считывает несколько байтов, и сравнивает считанные данные с 0x001122, затем 0x3344, затем с 0x55667788, после перемещается на смещение 7 и повторяет проверку, затем перемещается по смещению 6 с конца файла и проверяет эти байты, затем перемещается по смещению 4 и т.д. Если он найдет правильное ID в правильной позиции он прервет поиск и будет думать что нашел правильный архив. Старые ID и определения позиций также работают, так что ваши старые addon-ы продолжают работать.

+ Добавлена поддержка  текстового поиска внутри поддерживаемых архивов. Спасибо Кристиану Гислеру за добавление этой возможности в WinCom 5.0. Обратите внимание: эта возможность доступна для архиваторов которые определены с определением по расширению, и не работает для архиваторов с указанием ID.Обратите внимание: архиваторы использующие BATCH UNPACKMODE не могут быть полностью проверены во время такого поиска. Этот режим использует распаковку с директориями, но WinCom ожидает увидеть файлы.

+ Added support for opening supported archives by checking its contents (by ID checking).   Also thank's to Christian Ghisler for adding that possibility into WinCom 5.0.   NOTE: Use Ctrl-PgDn to open such files.

+ Added possibility to open plugin configuration dialog from command-line.   See MANUAL CALLING OF CONFIGURATION DIALOG .

* versions numeration changed. Now used 3-digits numbers instead of dumb   MS-like 4-digits ones.

======================================================

27/07/2002 ver 1.0.0.9

* IMPORTANT!!! : Updated MsCAB addon. Thanks to Matheusz Brsostek.   Update your multiarc.ini and download new MsCAB !!!   Read addons.txt for MsCAB installation instructions, please.  Addons for old MsCAB versions was removed from distribution.   Use MsCAB 6.0, please.

+ Added support for custom command-line parameters (see %S descriptin   in multiarc.ini syntax reference). There are three options available  from configuration dialog:  1)"None" - never ask user about %S command-line parameters.  2)"For next command" - user will be asked for %S parameter     only once. After that mode switched to "None".  3)"Always" - user will be asked for %S parameters always.  *)And optional check "... exclude from LIST calls" - User will     be not asked for %S parameters on LIST command calls.    The idea of custom command-line parameters kindly presented by  Mateusz Brsostek. Thanks, Mateusz.

+ Addon for UHARC 0.4 added. Thanks to Kirill Voloshin.

+ Addon for 7-Zip files added. Thanks to Yuri Bomstein, Alexey Klimin,   Milykh Alexander and Dozzie.

* Fixed some non-latin filenames handling in 777, BIX, JAR,UFA-archives  addons. Thanks to Yuri Bomshtein.

* Tooltips in configuration dialog fixed. I wonder, why nobodys  reports this bug for me earlier ??? =-)

* Some fixes from Mateusz Brsostek. Thanks again.

* URL for i6comp02.zip changed to correct one.

* Some changes to InstallShieldt Z addon. Thank's to Eguen Labun. If   you use that addon - update your multiarc.ini !!!

* New version of RK-addon from HF. don't know what a difference with old one.  Anyway, thank you, HF. =-)

======================================================

09/02/2001 ver 1.0.0.8

+ MultiArc  opensourced. See LICENSE for details.

+ Added support for DMS Amigas compress files. (DMS extension they have)  Thank's to Vladimir Pilny.

* Fixed Access Violation crash during working with UNIX Z compressed files  Thank's to Igor Glucksmann.

* Some cosmetic fixes to Configuration dialog.   Thank's to Andrew Bondar.

* Fixed stack overflow in operating big archives. Thank's to Mateusz Brzostek.

* Fixed dangerous bug with deleting directories. Thank's to Mateusz Brzostek.

* Added support for adding files to archive subdirectories.   Required WC ver 4.52 and corresponding command-line keys in external archiver.  Coded by Mateusz Brzostek. Great thank's again! 8-)

+ Added new variable (%R) and new functionality (use braces to avoid adding  empty variable) into multiarc.ini

+ New addon for new version of MsCAB utility. Thank's to Mateusz Brzostek.

+ Added support for InstallShield 6.0 HDR-s. WARNING! Not tested.  Thank's to Wolfgang Hagner, Andrew Bondar and Guntz Philippe for   assistance.

+ Changed addon for InstallShield 5.0 CAB's. Adding/deleting  ability added. Warning - not tested. Thank's to Andrew Bondar.

======================================================

17/12/2000 ver 1.0.0.7

+ Added "BatchUnpack" mode. Really great thank's to Mateusz Brsostek for  idea and help in coding this feature ... This mode dramatically increases  speed of extracting groups of files from archives. Especially from archives  packed in "solid" mode. Previous version of MultiArc HAVE TO extract one file  per one call of archiving utility, because WCX API didn't allow other way. This   version uses improved algorithm of extraction. To use it - please activate key   "BatchUnpack" in corresponding section of multiarc.ini and add new key -   "ExtractWithPath" - where you MUST put command line for call your archiver in   "extract with pathes" mode. Currently this changes did for JAR, IMP and CAB addons   in current multiarc distribution. If you want do this for others - you are welcome   - edit corresponding addon as described above and send me - I include it in next   distribution. To deactivate - just set BatchUnpack to 0.

+ Added support for alternative MSCAB archiver from Mateusz Brsostek -   http:  delete files in well known MS CAB files. It also support BatchUnpack mode.   Let's forget about ugly cabarc.exe from Bill Gates!!! Thank's Mateusz !!!

- Support for old CabArc.exe was moved directly to HELL - see remark above.

* Fixed "directories" bug in DDI extractor. Thank's for Igor Gerasimovich   for report.

* Fixed very dangerous bug with deleting directories. Thank's for  Mateusz Brsostek for report.

+ Added support for LZX Amigas compress files. (LZX extension they have)  Thank's to Vladislav Kropachev ( AKA Dima Boitsov ) for prompt about this format.

+ Added support for UNIX-like compress files. (Z extension they have).

+ "Fake-Move.bat" - if you want move files to archive during packing  but you archiver can't - it's for you. Thank's for Edward Goldobin   for idea.

* Fixed some spell errors in messages. Thank's for Edward Goldobin.

+ Added addon module for RK 1.03. Thank's to Kirill Voloshin.  But RK is still alpha and buggy. 8-( You WARNED.

======================================================

28/07/2000 ver 1.0.0.6. Another Distribution update.

+ Added addon module for SQZ 1.08. Thank's to Vladimir Pilny.

======================================================

26/07/2000 ver 1.0.0.6. Another Distribution update.

+ Added addon module for Mo'PaQ 2000 1.00.

======================================================

5/06/2000 ver 1.0.0.6. Distribution update.

+ Added addon module for Archangel, ERI, RKIVE archives. Great thank's   to J.Polygiannakis. But be careful - I haven't time to test its. 8-)

======================================================

2/06/2000 ver 1.0.0.6.

* Fixed bugs with time representation format. Thank's to Mateusz   Brzostek for reporting this bug.

* changes to multiarc.ini and JAR addon. Thank's to Mateusz Brzostek.

======================================================

1/06/2000 ver 1.0.0.5.

* Some bugs with ANSI<->OEM conversions in file names. Relative   changes to IMP addon. Thank's to Mateusz Brzostek for reporting   this bug.

* changes to multiarc.ini. Thank's to Kirill Voloshin.

+ Added addon module for BOA archives. Thank's to Kirill Voloshin.

======================================================

31/05/2000 ver 1.0.0.4.

* Some fixes about file times - seconds was displayed uncorrect before.   Thank's to Mateusz Brzostek for reporting this bug.

* Some *.addon files was corrected. Thank's to Kirill Voloshin.

======================================================

30/05/2000 ver 1.0.0.3.

* Fixed wrong behaviour with OEM<->ANSI filenames encoding. Thank's to   Mateusz Brzostek for reporting this bug.

* Cosmetic changes to configuration dialog.

======================================================

29/05/2000 ver 1.0.0.2.

+ Archive testing possibility comes back. Thank's to Andrew Korolev   for reminder 8-)

* File names with spaces wasn't enclosed to quotes in listfiles. Fixed.  Thank's to Mateusz Brzostek for reporting this bug.

* Some *.addon files was corrected. URLs added (thank's to Kirill   Voloshin).

+ Added addon module for ZOO archives. Thank's to Oleg Voloshin.

======================================================

13/05/2000 ver 1.0.0.1.

+ multi-extension support. Now you not need to add duplicate section into   multiarc.ini for one command-line utility with different filename extensions.  Just enum possible extensions through comma (,).For example: instead of having   two almost same addons for "DDI images" and "WinImage 5.0 Images" just edit   Extension key in first one from "Extension=ddi" to "Extension=ddi,ima".  Do not forget accordingly configure Win Commander! See *.addons for DDI images and   for InstallShield *.z archives for using this technique.

- accurately read previous paragraph and try to understand, why "WinImage 5.0.addon"  was removed from distribution. 8-)

* some *.addon files was corrected. URLs added (thank's to Kirill Voloshin & Wolfgang Hagner).

+ added addon module for ARC 6.02 archives. Thank's to J.Polygiannakis.

======================================================

03/08/2000 Release Candidate ver. 1.0.0.0

! Первая публичная версия.


Доска почета

Персональная благодарность:

Моим родителям - Спасибо вам мои любимые.

Кристинау Гислеру (Christian Ghisler). Он сделал все это возможным!

Матеусу Брзостек (Mateusz Brzostek). Человек, который предложил мене множество идей и помог с реализацией некоторых алгоритмов.

Евгению Рошалю (Eugene Roshal). Основная идея MultiArc была адаптирована из его FAR File Manager.

Предложили код:

Mateusz Brzostek.

Igor Glucksmann.

Предложили идеи:

Mateusz Brzostek.

Kirill Voloshin.

Black Dog (Who need that knows =-)

Edward Goldobin

Писатели Addon-ов:

J.Polygiannakis

Kirill Voloshin

Vladimir Pilny

Mateusz Brzostek.

Oleg Voloshin

Edward Goldobin

Yuri Bomstein

Andrew Bondar

Guntz Philippe

Alexey Klimin

Milykh Alexander

Dozzie

HF

Также были вовлечены:

Andrew Korolev

Eguen Labun

Igor Gerasimovich

Yuri Bomshtein

Vladislav Kropachev AKA Dima Boitsov

Wolfgang Hagner

Mozers(tm)

THANK YOU ALL!!!


OK
Сохранение всех изменений сделанных в этой сессии


отмена
Отмена всех изменений сделанных в течении этой сессии


Помощь
Открытие справочной системы по MultiArc


Выберите что вы хотите настроить
Выберите страницы которые вы хотите использовать:

О плугине - О плугине

Addons  - Addons

Настройки  - Настройки

Язык  - Язык


Написать письмо!
Нажмите эту ссылку для запуска вашего почтового клиента и посылки вашего вопроса Автору


Написать письмо!
Нажмите эту ссылку для запуска вашего почтового клиента и посылки вашего вопроса Автору


Проверить обновления!
Нажмите эту ссылку для запуска вашего обозревателя Internet и прямого перехода на домашнюю страничку MultiArc.


Тип архиватора
Используйте этот комбобокс для выбора типа архива который вы хотите настроить. Специальный тип MultiArc  позволяет настроить некоторые глобальные параметры.


Описание
Краткое описание выбранного типа архиватора. Здесь отображается содержимое параметра "Description" addon-а.


Статус
Информация о состоянии регистрации этого архиватора в Total Commander.


Путь к архиватору
Полный путь к архиватору или командному файлу.


Изменить путь к архиватору
Помогает вам выбрать правильный путь к программе архиватора.


Возможности архиватора
Открытие диалога Возможности архиватора


Обработка параметра %S
Этот чекбокс включает или выключает обработку  параметра %S  для этого типа архивов. Если он установлен будет использована локальная настройка.

Обратите внимание что он всегда включен для типа MultiArc.


Тип параметра %S
Здесь вы можете выбрать режим для обработки параметра %S .

Возможные режимы:

Никогда - параметр %S никогда не будет запрашиваться.

Для следующей команды - параметр %S будет запрошен только один раз.

Всегда - у пользователя всегда будет запрашиваться параметр %S.

Обратите внимание что режим "Никогда" доступен только для типа MultiArc. Для получения такой функциональности в локальной обработке %S вы должны выключить обработку.

Не смущайтесь режимом "Для следующей команды". Он активен только для следующего вызова или окончания сессии MultiArc. Этот режим не сохраняется между сессиями MultiArc. Другими словами вы не должны устанавливать этот параметр сегодня, выключать компьютер и пытаться делать что-либо завтра.


%S-Param LIST calls
Здесь вы можете избежать запроса параметра %S во время "List" команды. Эта команда запрашивается Total Commander много раз и является хорошей идеей сохранять эту опцию включенной.


Импорт внешнего addon
Помогает добавить новое описание архиватора из внешнего файла addon-а в multiarc.ini.Запускает диалог выбора файла и вы можете выбрать дополнение которое вы хотите добавить.


Удалить тип
Удаляет поддержку ненужного архиватора из multiarc.ini.


Изменить multiarc.ini
Открывает multiarc.ini во внешнем редакторе для ручной правки.


Путь к TC INI

Путь к текущему файлу настроек Total Commander-a (wincmd.ini).

Т.к. на данный момент нет возможности коректно получить путь и имя файла из самого Total Commander-a, MultiArc пытается определить его самостоятельно. Если вы увидите что путь не соответствует правильному пути, тогда выберите правильный файл настроек.

Данная настройка влияет на регистрацию расширения в файле wincmd.ini, и на то какой редактор будет вызван для редактирования файла multiarc.ini в ручном режиме. Если вы не будете делать этих изменений, тогда изменять ее не нужно.


Поведение консоли
Выбор режима поведения консоли

никогда - консоль никогда не отображается

Если определено (%C) - Консоль отображается только если для команды установлен параметр %C

всегда - консоль отображается всегда


Консоль: LIST вызова
Если отмечена консоль не отображает выполнение команд LIST


Использование области трея
Консоль минимизирована в системный трей.


Автозакрывание
Автоматически закрывает окно консоли после завершения выполнения команды.


Console delay
Задержка в секундах перед показом окна консоли.


Console lines
Окно консоли будет содержать строго столько строк. Если установлен 0 или пустое -- проверка на кол-во строк не производится.


Extensions
Список расширений файлов, поддерживаемых архиватором.


Is registered
Если отмечен, будет добавлена запись в файл wincmd.ini. Другими словами зарегистрирует это расширение в Total Commander.


Can create
Этот addon может создавать новые архивы.


modify
Этот addon может изменять файл архива.


delete
Этот addon может удалять файлы из архива.


multi-file
Этот addon поддерживает многотомные архивы.


detect type
Этот addon может проверять файлы архивов по ID


Support search
Этот addon поддерживает текстовый поиск в архивах.


Hide icon
Не использовать стандартную иконку архивов в Total Commander для этого типа архивов. Обратите внимание что такие архивы могут быть открыты только по Ctrl-PgDn на этом файле. Ассоциация по расширению не будет работать на нем.


Enter %S-Parameter
Введите информацию для этого %S параметра, которую вы хотите включить в текущую выполняемую команду.


Select type
В конфигурационном файле MultiArc-а есть несколько записей об архиваторах с одинаковыми расширениями.Выберите архиватор который вы хотите использовать для этой операции.


 Лицензия на MultiArc

Copyright (c) 2000, 2003 Siarzhuk Zharski, 2005-2007 Multiarc Team

All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright   notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright   notice, this list of conditions and the following disclaimer in the   documentation and/or other materials provided with the distribution.

3. All advertising materials mentioning features or use of this software   must display the following acknowledgement:

"This software contains parts of MultiArc WCX code by Siarzhuk Zharski"

4. Neither the names of the authors nor the names of its contributors   may be used to endorse or promote products derived from this software   without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' ANDANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THEIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLEFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIALDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODSOR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICTLIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAYOUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OFSUCH DAMAGE.


Известные проблемы

MultiArc не совершенная программа.

Проблема BatchUnpack

Сначала позвольте объяснить почему используется этот в workaround. По моему мнению API архиваторных плугинов выросло из модуля распаковки UnRAR использовавшегося Автором ТС для поддержки RAR-файлов. Основная проблема в нем обработка "файл-за-файлом" -- он может распаковывать только один файл за раз. Это так называемый "сплошной" архив - для этих архивов вы вынуждены распаковывать все файлы которые расположены перед требуемым файлом. Другими словами для распаковки всех архивов из сплошного архива, содержащего 100 файлов мы должны вызвать внешний распаковщик 100 раз! Вот почему был использован некоторый workaround для этой ситуации -- режим BatchUnpack. В этом режиме вся информация о списке нужных файлов может быть собрана во время "одно-файловых" вызовов и только последний вызов вызывает внешний архиватор. Этот режим требует дополнительного ключа - ExtractWithPath и использование внешнего архиватора в режиме "извлечение с полными путями".

Однако существует проблема: в этом режиме не возможен текстовый поиск, при таком поиске Total Commander запрашивает извлечение файлов и переименовывает их во временное имя. Но в этом режиме мы не можем сделать этого, так что Total Commander не видит файлов.

Диалог Возможности архиватора (Capabilities)

WCX плугин может зарегистрировать в wincmd.ini ассоциацию на файловое расширение. В ситуации когда два или более различных типов архивов разделяют одно и тоже расширение все изменения сделанные для одного типа, будут применимы ко всем остальным автоматически. Так задумано.

Расширение,IDs и т.д.

В данный момент проверка типа архива работает следующим образом: Сначала MultiArc ищет распаковщик по расширению и если такой распаковщик найден -- проверяет по ID. Если проверка ID неудачная -- он смотрит следующий распаковщик для этого расширения. Если список распаковщиков проверен полностью, но соответствующий распаковщик не найден он пытается найти распаковщик проверяя все распаковщики по ID.Есть одна особенность с типами архивов для которых ID не определен. Для таких типов будет использоваться первый архиватор, зарегистрированный на это расширение. Обратите внимание что, если некоторый архиватор зарегистрирован в multiarc.ini для этого расширения и ID отсутствует в одном из архиваторов, и он расположен ранее чем другой, в котором ID присутствует, будет вызван первый архиватор. Избегайте использования определений распаковщиков без ID.

Различные проблемы

1) Режим "Also pack path names" включен всегда -- файлы всегда упаковываются вместе с путями.

2) Прогресс бар, который Total Commander отображает во время длительных операций - это не настоящий процентаж. Т.к. при использовании внешних утилит отсутствует реальная информация о продвижении процесса, используется очень простой алгоритм для вычисления процента. Используйте консоль для получения реальной информации.


Консоль MultiArc

 Консоль MultiArc это окно, которое позволяет вам видеть вывод внешнего архиватора. Также возможно прерывание выполнения текущей команды. Нажмите F4 когда клавиатура имеет фокус ввода в консоли. И конечно нет гарантии что это все будет работать как задумано.Консоль MultiArc настраиваемая. См. Диалог конфигурирования  для детального описания настроек консоли.