home *** CD-ROM | disk | FTP | other *** search
/ PC World 2001 January / PCWorld_2001-01_cd.bin / Software / TemaCD / far / far165.exe / Plugins / MultiArc / ArcEng.hlf next >
Encoding:
FAR help  |  1999-08-19  |  6.0 KB  |  164 lines
  1. .Language=English,English
  2. .PluginContents=Archive support plugin
  3.  
  4. @Contents
  5. $ #Archive support plugin#
  6.     This FAR module performs transparent #archive# processing.
  7. Files in the archive are handled in the same manner as if they
  8. were in a folder: when you operate with the archive, FAR
  9. transforms your commands into the corresponding external
  10. archiver calls.
  11.  
  12.    ~Adding files to archive~@AddToArc@
  13.  
  14.    ~Extracting files from archive~@ExtrFromArc@
  15.  
  16.    ~Archive commands~@ArcCmd@
  17.  
  18.    ~Archive support configuration~@ArcCfg@
  19.  
  20.    ~Archiver command lines~@ArcSettings@
  21.  
  22. @AddToArc
  23. $ #Adding files to archive#
  24.     In this dialog you may choose the archiver, add or change
  25. command line switches (default switches may be defined using
  26. ~Archiver settings~@ArcSettings@ dialog), enter a password
  27. to encrypt files during archiving.
  28.  
  29.     Option #Delete files after archiving# forces the archiver to move
  30. rather than copy files.
  31.  
  32.     The #Save settings# choice saves the current archiver and switches
  33. for future usage.
  34.  
  35. @ExtrFromArc
  36. $ #Extracting files from archive#
  37.     In this dialog you may enter the path to extract files and set the
  38. password to decrypt archived files.
  39.  
  40.     Option #Extract without pathnames# forces extraction of all files
  41. to the same folder.
  42.  
  43.     To immediately extract selected archived files to the current folder
  44. you may also use #Alt-F6#.
  45.  
  46. @ArcCmd
  47. $ #Archive commands#
  48.     From this menu you can test archive, add an archive comment,
  49. convert an archive to SelF-eXtracting (SFX), try to recover a
  50. broken archive, protect an archive from damage or disable
  51. archive modifications.
  52.  
  53.     Notes:
  54.  
  55.     1. To execute an archive management command you need to have
  56. the corresponding archiver tool. Archiver options may be changed
  57. in the ~Archiver settings~@ArcSettings@ dialog.
  58.  
  59.     2. The whole set of archive management commands may only be
  60. used with RAR archives. Other archivers will support only a sub-set
  61. of these commands.
  62.  
  63. @ArcCfg
  64. $ #Archive support configuration#
  65.     In this dialog you may change following parameters:
  66.  
  67.  #The way of archivers#   Do not hide archiver output,
  68.  #output displaying#      hide for view operation or hide always
  69.  
  70.  #Process Shift-F1#       Add files to archives on Shift-F1.
  71.  #command#                You may wish to disable this option
  72.                         if you have another archive support plugin
  73.                         installed, which processes Shift-F1 command.
  74.  
  75.  #Description list#       Names of files with descriptions of archived
  76.  #names delimited#        files.
  77.  #with commas#
  78.  
  79.  #Read archive#           Read descriptions of archived files
  80.  #descriptions#           when entering to an archive. This enables
  81.                         the viewing of descriptions but slows down
  82.                         archive reading.
  83.  
  84.  #Update archive#         Update descriptions of archived files
  85.  #descriptions#           after adding to or deleting from an archive.
  86.  
  87. @ArcSettings
  88. $ #Archiver command lines#
  89.     In this dialog you may change external archiver command lines
  90. for different archive processing operations and mask, which will be
  91. used to select all files.
  92.  
  93.     The following variables may be used:
  94.  
  95.  %%A - Archive name.
  96.  
  97.  %%a - Short archive name.
  98.  
  99.  %%W - Temporary folder including the terminating slash.
  100.  
  101.  %%P - Password.
  102.  
  103.  %%R - Current archive folder.
  104.  
  105.  %%L - Filelist name. Filelist is the file containing names of files
  106.        to be processed by the external archiver.
  107.  
  108.  %%l - Filelist with short file names.
  109.  
  110.  %%F - Names of one or more files to be processed. If all names
  111.        cannot be placed in a single string, the archiver will be
  112.        executed several times until all file names are exhausted.
  113.        By default maximum total command length is 127, but you can
  114.        specify it directly after %%F, for example %%F512.
  115.        Variable %%F should be used only if the destination archiver
  116.        does not support filelists.
  117.  
  118.  %%f - The name of a single file to process. The archiver will be
  119.        executed several times until all file names are exhausted.
  120.        This variable should be used only if the destination archiver
  121.        does not support filelists or multiple file names on
  122.        the command line.
  123.  
  124.  %%E<errorlevel> - maximum acceptable command errorlevel.
  125.        For example, %%E2 indicates that errorlevels 0, 1 and 2
  126.        are acceptable. This variable may be specified in any place
  127.        of command. If it is absent, only errorlevel 0 is considered
  128.        as successful.
  129.  
  130.  %%S - Place in the command line to insert additional switches,
  131.        specified in the second string of "Add" dialog. If this
  132.        variable is absent, switches are added to end of command
  133.        line.
  134.  
  135.     Variable modifiers Q, q, S, M, N, *, W, P can be used to change
  136. file names format details:
  137.  
  138.     'Q' - quote names with spaces;
  139.     'q' - quote all names;
  140.     'S' - use '/' instead of '\' in pathnames;
  141.     'M' - transfer folder names to archiver as 'foldername\*.*';
  142.     'N' - transfer folder names to archiver as 'foldername';
  143.     '*' - use '*' mask to select all files. This modifier
  144.           overrides "All files mask" parameter for single
  145.           archiver command;
  146.     'W' - use name only, without path;
  147.     'P' - use path only, without name;
  148.     'A' - use ANSI encoding.
  149.  
  150.     These modifiers may be specified immediately after %%F, %%f, %%L
  151. or %%l variables without spaces. 'P' and 'A' also may be used with
  152. %%A and %%a. Several modifiers are allowed, for example %%LMN or
  153. %%F*QSN128 are valid. If neither 'M' nor 'N' modifier is specified,
  154. 'N' is assumed. If both 'M' and 'N' are specified, both 'foldername'
  155. and 'foldername\*.*' will be transferred to archiver.
  156.  
  157.     If a part of the external archiver command string is enclosed
  158. in {  } braces, it will be added to the resulting string only
  159. if this part contains at least one, non-empty variable,
  160. from those described above.
  161.  
  162.     If an external archiver does not support a particular command,
  163. leave the corresponding string blank.
  164.