Changeset 416

Timestamp:

Jul 31, 2006, 7:34:12 PM (19 years ago)

Author:

root

Message:

Update archiver definition help

Location:

trunk/dll/ipf

Files:

• archive.ipf (modified) (1 diff)
• arclist.ipf (modified) (2 diffs)
• comp.ipf (modified) (3 diffs)
• config.ipf (modified) (5 diffs)

trunk/dll/ipf/archive.ipf

@@ -38 +38 @@
 use "*.pkt". If in doubt, use both or use the -C command line switch to
 force UNZIP to ignore case.
+:p.
+I'm told there's a bug in some versions of 4OS2 that can cause
+a call to an archiver to fail if the archiver has an extension (i.e.
+UNZIP works, UNZIP.EXE doesn't).  If things fail for no apparent reason
+and you're using 4OS2 you might keep it in mind.
 
 :h2 res=90300 name=PANEL_ARCHIVE.Build an archive

trunk/dll/ipf/arclist.ipf

@@ -32 +32 @@
 it), drag a directory onto the entry field, or click the folder button
 with :color fc=default bc=cyan.B1:color fc=default bc=default..
+:p.
+How archiver selection works&colon.
+:p.
+The archive selector scans the known archivers in the order in which they
+are defined.  The selector first tries a signature match, unless this is
+suppressed in the settings.  If there is no signature defined or if
+the signature match is suppressed, the selector checks to see if the file
+extension matches.  The matching entry defines the commands used for the
+various archiving operations and supplies parameters that enable the archiver
+outputs to be parsed. Note&colon. this mean that if you have several archivers of a given type
+(i.e. ARC) defined only the first entry is tried since different archiver file names are sometimes
+use (i.e. arc.exe vs arc2.exe) make sure that the archive description that corresponds to
+the actual archive description you wish to use is listed first.See&colon.:link reftype=hd res=94200.
+Editing Archiver Details:elink.
 :p.
 You can drag files onto the Archive Container's listing to add them to
@@ -190 +204 @@
 signature so you can add it to ARCHIVER.BB2 if it's not a listed archive
 type.
+

trunk/dll/ipf/comp.ipf

@@ -45 +45 @@
 operate on both containers. You can also select and deselect files in
 the containers manually with the mouse and/or keyboard.
-:hp2.Hint&colon.:ehp2. mouse selection works slightly differently when
-you hold down the Ctrl key while clicking.
+:hp2.Hint&colon.:ehp2. mouse selection of multiple files works slightly differently when you hold down :color fc=default bc=palegray.Ctrl:color fc=default bc=default. while clicking.
 :p.
 :hp2.Brief description of selection/deselection button options&colon.:ehp2.
 :p.
-:hp6.Same:ehp6. All items which match name and size exactly.
+:hp6.Same size:ehp6. All items which match name and size exactly.
 :p.
-:hp6.Identical:ehp6. All items which match name, size and date exactly.
+:hp6.Size/time:ehp6. All items which match name, size and date exactly.
+:p.
+:hp6.Content:ehp6. All items which match name and content exactly.
 :p.
 :hp6.Both:ehp6. All items which are present in both containers (only
@@ -76 +77 @@
 :hp6.Invert:ehp6. Inverts selection state of all items in both containers.
 :p.
+:hp2.Brief description of the remaining options in the dialog box&colon.:ehp2.
+:p.
+:hp6.Actions:ehp6. Provides directional copy and move along with directory specific delete. Filter opens the filter dialog so you can restrict the files viewed to a certain mask (i.e. *.sys)
+:p.
+:hp6.Okay and Cancel:ehp6. Both close the dialog.
+:p.
+:hp6.Collect:ehp6. Copies highlighted files to the collector.
+:p.
+:hp6.Dirs:ehp6. Opens the select directories dialog.
+:p.
+:hp6.Include subdirectories:ehp6. Includes files from all subdirectories in both directory trees for comparison.(this is a toggle which change the display automatically)
+:p.
+:hp6.Hide not selected:ehp6. Includes selected files only on the display.(this is a toggle which change the display automatically)
+:p.
 See also :link reftype=hd res=99100.Selection:elink..
 :p.
@@ -90 +105 @@
 be selected (to confirm).
 :p.
+:hp2.Note&colon.:ehp2. You can use multiple combination of the select/deselect buttons however
+they will select you all the files as if an "or" operation not as an "and" operation
+(i.e. selecting larger then selecting newer will highlight all the larger files and then highlight
+all the newer files not just the newer files among the already highlighted)
 If you're looking directory matching features not included in FM/2, you
 might find them in the programs available on Hobbes

trunk/dll/ipf/config.ipf

@@ -61 +61 @@
 .br
 A Drive Finder dropdown listbox.
-,br
+.br
 A States dropdown listbox (Fm/2 configurations you have saved with specific name).
 .br
@@ -131 +131 @@
 :p.
 This dialog box, which you can reach from the Config menu, allows you to
-edit the details of an :link reftype=hd res=100015.archiver:elink.. Entry
-boxes are present for all the twenty one fields represented in
-ARCHIVER.BB2 (the text file that contains control information about your
-archivers which FM/2 uses to interface with the archivers). It's
-probably easier for most people to edit ARCHIVER.BB2 directly with a
-text editor.
+the details of your :link reftype=hd res=100015.archiver:elink.. On the right side are a series of buttons to manage your archivers&colon.
+:p.
+:hp1.Up&colon.:ehp1. Moves the highlighted archiver up in the archive list.
+:p.
+:hp1.Down&colon.:ehp1. Moves the highlighted archiver down in the archive list.
+:p.
+:hp1.Add&colon.:ehp1. Add brings up a blank archiver details box so you can define a new archiver type.
+:p.
+:hp1.Delete&colon.:ehp1. Deletes the archiver description of the highlighted archiver.
+:p.
+:hp1.Revert&colon.:ehp1. Revert undoes all changes made during the current session. It will not undo changes once the new ARCHIVER.BB2 has been written.
+:p.
+
+To open the Archiver details box to edit an existing archiver highlight the archiver and select Okay.
+Entry boxes are present for all the twenty one fields represented in ARCHIVER.BB2
+(the text file that contains control information about your archivers,
+which FM/2 uses to interface with the archivers). It's probably as easy for most people to edit
+:link reftype=hd res=100130.ARCHIVER&period.BB2:elink. directly with a text editor.
+The Cancel button will bring up a dialog asking you if you wish to rewrite ARCHIVER.BB2
+select yes if you do. The new file will be written one generation of backup is kept it is
+named Archiver.BAK
 :p.
 :hp1.NOTE&colon.:ehp1. The simplest method to ensure that your archivers
@@ -142 +157 @@
 your PATH= statement, and check the names of the files to make sure they
 match what's on your system (i.e. UNZIP.EXE in both ARCHIVER.BB2 and on
-your hard disk, not UNZIP.EXE in one and UNZIP32.EXE in another).
+your hard disk, not UNZIP.EXE in one and UNZIP32.EXE in another). Alternatively, full path names can be used in ARCHIVER.BB2.
 :p.
 In the event that you attempt to list an archive and FM/2 feels you've
@@ -319 +334 @@
 .br
 :xmp.
- 1. 02-08-96  23&colon.55&colon.32
- 2. 8 Feb 96  23&colon.55&colon.32
- 3. 8 Feb 96  11&colon.55p
- 4. 96-02-08  23&colon.55&colon.32
- 5. 31-02-98  23&colon.55
+ 0 = No date in data
+ 1 = 02-08-96  23&colon.55&colon.32 mm-dd-yy hh&colon.mm&colon.ss
+ 2 = 8 Feb 96  23&colon.55&colon.32 dd-Mmm-yy hh&colon.mm&colon.ss
+ 3 = 8 Feb 96  11&colon.55p   dd Mmm yy hh&colon.mmA
+ 4 = 96-02-08  23&colon.55&colon.32 yy-mm-dd mm&colon.mm&colon.ss
+ 5 = 31-02-98  23&colon.55    dd-mm-yy hh&colon.mm
 :exmp.
+:p.
+Dash (-) and slash (/) separators are both supported.
+:p.
+Both 2 digit and 4 digit years are supported.
+:p.
+2 digit years slide about 1980.
 :p.
 :hp2.NumDateF(ie)lds:ehp2. This field tells FM/2 how many fields comprise
@@ -359 +381 @@
 what all those fields mean.
 
+:h4 res=100130 name=PANEL_ARCBB2.ARCHIVER.BB2 Structure
+:i1 id=aboutArcBB2.ArchiverBB2 Structure
+:p.
+The first line in the file is the number of lines/definition in the archiver.bb2 file. It is very important; do not change.  It allows modifications to the
+file format to be transparent to older programs.
+
+Format for this archiver.bb2 file (each entry has 21 lines)&colon.
+:p.
+1st line&colon. archiver id (i.e. ARC, LHARC, PKZIP, etc.) for human consumption
+:p.
+2nd line&colon.  normal extension for archives without period  (i.e ZIP, ARC, LZH)
+:p.
+3rd line&colon.  offset into file to signature (leave blank if no signature)
+:p.
+4th line&colon.  list command
+:p.
+5th line&colon.  extract command
+:p.
+6th line&colon.  extract with directories command
+:p.
+7th line&colon.  test archive command
+:p.
+8th line&colon.  add/create command
+:p.
+9th line&colon.  add/create with paths command
+:p.
+10th line&colon.  add/create and recurse command
+:p.
+11th line&colon.  move command
+:p.
+12th line&colon.  move with paths command
+:p.
+13th line&colon.  delete command
+:p.
+14th line&colon.  signature (case sensitive, leading spaces count!)
+:p.
+15th line&colon.  startlist string
+:p.
+16th line&colon.  endlist string
+:p.
+17th line&colon.  old size position (0-based, -1 = not available)
+:p.
+18th line&colon.  new size position  (0-based, -1 = not available)
+:p.
+19th line&colon.  file date position (0-based, -1 = not available) [,type of date (0 for none)]
+:p.
+20th line&colon.  number of elements in dates (for "03 June 92" would be 3)
+:p.
+21st line&colon.  file name position (absolutely required, of course; -1 = last pos)[,name is last (1 = TRUE, n/a w/ -1 pos)[name is next line (1 = TRUE)[,name is first line, then rest of data (1 = TRUE)]]]
+:p.
+see ZOO entry for example of -1 in file name position
+:p.
+see LH entry for example of name is last
+:p.
+see RAR 2.00 entry for example of name is first
+:p.
+check listings generated by these programs for clarification
+:p.
+A semicolon marks a comment.  They may appear at any point *except*
+within the 21 lines of an archiver definition entry.  Comments are ignored.
+Archiver definition entries that contain numeric values may have trailing comments. Archiver definition lines that contain strings do not support trailing comments.
+:p.
+Blank lines are ignored except within a 21 line archiver definition entry. A blank line with a definition entry will be treats as either an empty string or the number 0, depending on what content is expected for the definition line.
+:p.
+Note that all archiver command strings should include the archiver's parameter to
+prevent it from prompting for input!  Also note that archive types are checked
+in order of their listing in this file.  Finally, this file is set up for
+the archivers I had lying around. If yours are different versions, you may
+have to modify this file.  All archivers are OS/2 (or FAPI) versions.
+DOS archivers may work with FM/2, but it'll be up to you to set them up.
+