;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 ; () - 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 - 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 . ;15.11.2004 07:15 .. ;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\d+).(?P\d+).(?P\d+)\s+ (?P\d+):(?P\d+)\s+(?P[\d\xff]+)\s(?P.*?)\s*$/ ; ; ;these settings: ; ;Start=/^..reading directory/ ;End=/^..listing completed/ ;Format0=/^[^\|]*\|(?P[^\|]+)\|(?P[^\|]+)\|\s+(?P.*?)\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 ;<<<