;If ~/.config/far2l/plugins/multiarc/custom.ini exists, it will extend and override settings in this file
;
;[Section name]
;  use format name here
;TypeName
;  optional parameter, is retained for compatibility purposes.
;  Allows to override format name, defined in the section name.
;ID (optional)
;  archive ID (2-digit hex numbers delimited with spaces)
;IDPos (optional)
;  ID position in archive. If not present, ID will be searched in
;  starting part of archive (see TechInfo #63) that may slowdown things.
;ID# (optional, # - index from 1 to any)
;  if format has more that single ID to check for - you can specify
;  other IDs with sequenctial indexes from 1 to extra IDs count.
;ID#Pos (optional, # - index from 1 to any)
;  ID position in archive for corresponding ID# field with matching index.
;IDOnly (optional)
;  if 1, extension is ignored and only any of IDs is used to detect archive type.
;  Otherwise both extension and any of IDs (if present) are used.
;Extension
;  archive format extension (without dot).
;List
;  command to produce listing. It will be appended with an archive name
;  It may also contain variables %%A with optional modifiers Q, q, W, P, S
;  In this case archive name will not be appended.
;Errorlevel (optional)
;  listing accepted only if errorlevel less than specified.
;IgnoreErrors  (optional)
;  if nonzero, archiver commands exit code will be ignored.
;  Use with caution.
;Start (optional)
;  any part of line in listing after which processing is started.
;  If text started from '^', it will be compared from second symbol
;  with lines beginning. Otherwise text looked anywhere in lines.
;End (optional)
;  any part of line in listing to stop processing.
;  If text starts from '^', it will be compared from second symbol
;  with lines beginning. Otherwise text looked anywhere in lines.
;Format0 ... FormatN
;  Listing format:
;  n - file name
;  . - remove trailing spaces from file name and append name with dot
;  z - unpacked size
;  c - file description
;  p - packed size
;  d - day
;  t - month
;  TTT - three letters month name (Jan, Feb, Mar, ...)
;  y - year
;  h - hours
;  H - hours modifier letter (a - a.m. time, p - p.m. time)
;  m - minutes
;  s - seconds
;  a - attributes
;  * - skip until first space or end of line
;  b - day of last access
;  v - month of last access
;  e - year of last access
;  x - hours of last access
;  l - minutes of last access
;  k - seconds of last access
;  j - day of creation
;  g - month of creation
;  f - year of creation
;  o - hours of creation
;  i - minutes of creation
;  u - seconds of creation
;  r - CRC (hex)
;  C - chapters info
;  (<digital parameters>) - optional digits, some or all digits may be missing
;IgnoreString0 ... IgnoreStringN (optional)
;  do not process these strings
;  If text starts from '^', it will be compared from second symbol
;  with lines beginning. Otherwise text looked anywhere in lines.
;
;Other items describe archive commands
;
;    The following variables may be used:
;
; %%A - Archive name.
;
; %%a - Short archive name.
;
; %%W - Temporary folder including the terminating slash.
;
; %%P - Password.
;
; %%R - Current archive folder.
;
; %%L - Filelist name. Filelist is the file containing names of files
;       to be processed by the external archiver.
;
; %%l - Filelist with short file names.
;
; %%F - Names of one or more files to be processed. If all names
;       cannot be placed in a single string, the archiver will be
;       executed several times until all file names are exhausted.
;       By default maximum total command length is 127, but you can
;       specify it directly after %%F, for example %%F512.
;       Variable %%F should be used only if the destination archiver
;       does not support filelists.
;
; %%f - The name of a single file to process. The archiver will be
;       executed several times until all file names are exhausted.
;       This variable should be used only if the destination archiver
;       does not support filelists or multiple file names on
;       the command line.
;
; %%E<errorlevel> - maximum acceptable command errorlevel.
;       For example, %%E2 indicates that errorlevels 0, 1 and 2
;       are acceptable. This variable may be specified in any place
;       of command. If it is absent, only errorlevel 0 is considered
;       as successful.
;
; %%S - Place in the command line to insert additional switches,
;       specified in the second string of "Add" dialog. If this
;       variable is absent, switches are added to end of command
;       line.
;
;    Variable modifiers Q, q, S, M, N, *, W, P can be used to change
;file names format details:
;
;    'Q' - quote names with spaces;
;    'q' - quote all names;
;    'S' - use '/' instead of '\' in pathnames;
;    'M' - transfer folder names to archiver as 'foldername\*.*';
;    'N' - transfer folder names to archiver as 'foldername';
;    '*' - use '*' mask to select all files. This modifier
;          overrides "All files mask" parameter for single
;          archiver command;
;    'W' - use name only, without path;
;    'P' - use path only, without name;
;    'A' - use ANSI encoding.
;
;    These modifiers may be specified immediately after %%F, %%f, %%L
;or %%l variables without spaces. 'P' and 'A' also may be used with
;%%A and %%a. Several modifiers are allowed, for example %%LMN or
;%%F*QSN128 are valid. If neither 'M' nor 'N' modifier is specified,
;'N' is assumed. If both 'M' and 'N' are specified, both 'foldername'
;and 'foldername\*.*' will be transferred to archiver.
;
;    If a part of the external archiver command string is enclosed
;in {  } braces, it will be added to the resulting string only
;if this part contains at least one non-empty variable
;from those described above.
;
;    If an external archiver does not support a particular command,
;leave the corresponding string blank.
;
; Regular expressions notice.
;
;Now regular expressions can be used in parameters 'FormatX', 'IgnoreStringX',
;'Start', 'End'. Regular expression are parsed by PCRE library
;(ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/) which recognizes
;Perl5-compatible syntax. To specify that pattern should be matched as regular
;expression, enclose it in slashes ('/'). The following regexp flags can be
;used (if corresponding characters are placed after closing slash):
;    i - ignore case
;    x - extended (use explaining spaces)
;    m - multiline
;    s - "." matches new line characters also ('\n', '\r')
;
;When using regexps in 'FormatX' parameter, named strings are used to
;extract information from listing lines. The following field names are
;available:
;    name - file name with relative path (leading and trailing spaces
;        are trimmed)
;    description - file description
;    size - unpacked file size in bytes (non-digit characters are ignored
;        in this and all other numeric fields)
;    packedSize - packed file size in bytes
;    attr - file attributes (A - archive, R - readonly, S - system, C -
;        compressed, H - hidden, D - directory)
;    cYear, cDay, cMonth, cHour, cMin, cSec - creation time
;    mYear, mDay, mMonth, mHour, mMin, mSec - modification time
;    mAMPM, mMonthA - extended time fields for modification time
;    aYear, aDay, aMonth, aHour, aMin, aSec - access time
;    CRC - 32 bit file Cyclic Redundancy Checksum
;
;------------------------------------------------------------------------
;Several examples of new syntax:
;
;to parse the following listing:
;>>>
; Volume in drive D is work
; Volume Serial Number is xxxx-xxxx
;
; Directory of D:\works\MultiArc\final\Formats
;
;15.11.2004  07:15    <DIR>          .
;15.11.2004  07:15    <DIR>          ..
;14.11.2004  00:46             5
;14.11.2004  00:46             4
;14.11.2004  00:46             6
;14.11.2004  00:46             6
;15.11.2004  06:07            56
;15.11.2004  07:14             1
;15.11.2004  07:11            54
;14.11.2004  00:46             4
;14.11.2004  00:46             6
;15.11.2004  07:15                 0 out
;14.11.2004  00:46             6
;14.11.2004  00:46             9
;14.11.2004  00:46             6
;              13 File(s)        168
;               2 Dir(s)  37
;<<<
;the following settings can be used:
;
;Start=/^ Directory of/
;End=/File\(s\)/
;Format0=/^(?P<cDay>\d+).(?P<cMonth>\d+).(?P<cYear>\d+)\s+ (?P<cHour>\d+):(?P<cMin>\d+)\s+(?P<packedSize>[\d\xff]+)\s(?P<name>.*?)\s*$/
;
;
;these settings:
;
;Start=/^..reading directory/
;End=/^..listing completed/
;Format0=/^[^\|]*\|(?P<size>[^\|]+)\|(?P<attr>[^\|]+)\|\s+(?P<name>.*?)\s*$/
;IgnoreString0=/^---- ---- ---- ----/
;
;can be used to parse the following kind of listing:
;>>>
;jkRes utility version 002
;  pack/unpack tool to work with jkRes resource bundles
;
;..listing files from resource bundle
;..reading directory...12 items found
;---- ---- ---- ----
;    zlib |     5632 | A.... | Ace.fmt
;    zlib |     4608 | A.... | Arc.fmt
;    zlib |     6656 | A.... | Arj.fmt
;    zlib |     6144 | A.... | Cab.fmt
;    zlib |    56832 | A.... | Custom.fmt
;    zlib |     4608 | A.... | Ha.fmt
;    zlib |     6144 | A.... | Lzh.fmt
;    zlib |     6144 | A.... | Rar.fmt
;    zlib |     9216 | A.... | TarGz.fmt
;    zlib |     6656 | A.... | Zip.fmt
;    zlib |    13012 | A.... | Custom.ini
;    zlib |     1072 | A.... | custom.ini-re
;---- ---- ---- ----
;..listing completed
;..done
;<<<
