Changeset 268


Ignore:
Timestamp:
Dec 8, 2005, 7:15:10 AM (20 years ago)
Author:
root
Message:

Update help text, bitmaps and icons

Location:
trunk/dll/ipf
Files:
42 edited

Legend:

Unmodified
Added
Removed
  • trunk/dll/ipf/archive.ipf

    r10 r268  
    22:i1 id=aboutExtract.Extract from archives
    33:artwork name='..\..\bitmaps\extract.bmp' align=center.
     4:p.
    45To extract from an archive, select the archive(s), then select
    56:hp1.Extract:ehp1. from a context menu.
     
    89extraction, add masks for files to extract, tweak the command line for
    910exotic settings, and select the extraction directory (the directory to
    10 which the files will be extracted.  You can drag file system objects
     11which the files will be extracted. You can drag file system objects
    1112onto the Extract Directory entryfield to set the extraction directory,
    1213or you can type in one you like, or click the Walk button.
    1314:p.
    1415If you check the :hp1.Remember...:ehp1. checkbox, this dialog will
    15 remember some of its settings for the next time you use it.  Uncheck
     16remember some of its settings for the next time you use it. Uncheck
    1617it and it'll forget them and use the defaults.
    1718:p.
     
    3536not, so, for example, trying to extract "*.PKT" when the file inside the
    3637archive is "01234567.pkt" will fail to extract the file -- you'd have to
    37 use "*.pkt".  If in doubt, use both.
     38use "*.pkt". If in doubt, use both or use the -C command line switch to
     39force UNZIP to ignore case.
    3840
    3941:h2 res=90300 name=PANEL_ARCHIVE.Build an archive
    4042:i1 id=aboutArchive.Build an archive
    4143:artwork name='..\..\bitmaps\archive.bmp' align=center.
     44:p.
    4245To build an archive, select some files, then select :hp1.Archive:ehp1.
    43 from a context menu.  You can add files to an existing archive by
     46from a context menu. You can add files to an existing archive by
    4447link-dragging them onto the archive object, or dragging them onto an
    4548:hp1.:link reftype=hd res=90200.Archive Container:elink.:ehp1. window.
     
    4851listbox from which to pick an archiver.
    4952After that, another dialog appears to let you modify how the archive
    50 will be created.  Additional masks may be entered (remember that the ZIP
     53will be created. Additional masks may be entered (remember that the ZIP
    5154and UNZIP programs are case sensitive), the archiver command line
    5255tweaked, and so forth. Click :hp1.Okay:ehp1. to create the archive, or
     
    5457:p.
    5558Note that the archive name may be an existing archive, in which case
    56 it's modified by adding the new files.  If some of the files are
     59it's modified by adding the new files. If some of the files are
    5760already in the archive, they're replaced.
  • trunk/dll/ipf/arclist.ipf

    r108 r268  
    1515:i1 id=aboutArchiveListing.Archive Container
    1616Archive Container windows presents you with a list of an archive's
    17 contents.  The menus available here present you with commands which you
     17contents. The menus available here present you with commands which you
    1818can perform on selected files and the archive as a whole, as well as the
    19 usual configuration of the window's appearance.  You get here by double-
     19usual configuration of the window's appearance. You get here by double-
    2020clicking an archive file in an FM/2 Directory Container window.
    2121:p.
     
    2525Besides the container showing the archive contents and a couple of
    2626informational fields above that, there's an entry field at the bottom of
    27 the window that shows the current :hp1.extract directory:ehp1..  This is
    28 the directory in which any extracted files will be placed.  (Extraction
     27the window that shows the current :hp1.extract directory:ehp1.. This is
     28the directory in which any extracted files will be placed. (Extraction
    2929refers to copying files from the archive onto your disk as normal
    3030files.)  To change the extract directory, enter a new directory into the
     
    3535You can drag files onto the Archive Container's listing to add them to
    3636the archive, and you can drag files from the archive to an FM/2
    37 directory window.  OS/2's drag and drop "rendering" mechanism would make
     37directory window. OS/2's drag and drop "rendering" mechanism would make
    3838this painfully slow for any other application's window, as each file is
    3939processed individually (imagine extracting each file in an archive by
    4040typing a separate command line for each to get an idea how slow it would
    41 be).  The menu extract items allow optimizing extraction so that only
     41be). The menu extract items allows optimizing extraction so that only
    4242one "pass" needs to be done (note that :hp1.Files->Extract:ehp1. must
    4343also deal with the OS/2 command line length restriction of 1024 bytes,
     
    4747around it.
    4848:p.
    49 You can get a popup menu in the container by pressing B2.
     49You can get a context menu in the container by pressing B2.
    5050:p.
    5151Following is a discussion of the pull-down menus:
     
    5454:p.
    5555:hp1.View:ehp1. causes FM/2 to extract the file(s) to a temporary
    56 directory and display it/them.  If, for some reason, the files don't
     56directory and display it/them. If, for some reason, the files don't
    5757appear when you attempt to view them, try :hp1.Test:ehp1.ing the archive.
    5858:p.
    5959:hp1.Edit:ehp1. works as above but the file(s) are loaded into the
    60 configured editor instead of being viewed.  File(s) can then be
    61 :hp1.Refreshed:ehp1. back into the archive.  :hp2.Note&colon.:ehp2.
     60configured editor instead of being viewed. File(s) can then be
     61:hp1.Refreshed:ehp1. back into the archive. :hp2.Note&colon.:ehp2.
    6262Do not attempt to Refresh files that were stored with pathnames.
    6363The pathname will either be lost or an additional file without
     
    7676:p.
    7777:hp1.Exec:ehp1. causes FM/2 to extract all selected files to a temporary
    78 directory and then runs the cursored file.  If you pick this from a
     78directory and then runs the cursored file. If you pick this from a
    7979popup menu, that would be the file under the mouse pointer when you
    80 requested the popup.  This allows you to select DLLs, help files, data
     80requested the popup. This allows you to select DLLs, help files, data
    8181files, etc. required to get the application to run correctly as well as
    8282the executable file.
    8383:p.
    84 :hp1.Print:ehp1. causes FM/2 to extract and print selected files.  This
     84:hp1.Print:ehp1. causes FM/2 to extract and print selected files. This
    8585uses the FM/2 printing method, not the OS/2 printer objects (see
    8686Config->Printer in an FM/2 main window's pulldown menu).
     
    9191:p.
    9292:hp1.Virus Scan:ehp1. causes FM/2 to extract the selected files and then
    93 run the configured virus checker.  See the :hp1.:link reftype=hd
     93run the configured virus checker. See the :hp1.:link reftype=hd
    9494res=92200.internal Settings notebook's Files/Dirs page:elink.:ehp1..
    9595:p.
    9696:hp1.Extract All:ehp1. extracts all files from the archive to the
    97 extract directory.  :hp1.Extract All &amp. Exit:ehp1. does the
     97extract directory. :hp1.Extract All &amp. Exit:ehp1. does the
    9898same thing but closes the archive listing window after starting the
    9999extraction.
     
    104104directory). :hp1.Extract All w/ Dirs &amp. Exit:ehp1. does the same
    105105thing but closes the archive listing window after starting the
    106 extraction.  (:hp2.Note:ehp2. that if all you want to do to an archive
     106extraction. (:hp2.Note:ehp2. that if all you want to do to an archive
    107107is extract from it, you can do so without ever opening a contents box;
    108108just pull up a context menu on the archive in an FM/2 main window and
    109 select :hp1.Extract:ehp1..  This is the fastest and most efficient
     109select :hp1.Extract:ehp1.. This is the fastest and most efficient
    110110method of extracting files from an archive.)
    111111:p.
     
    121121:hp2.Archivers:ehp2. are programs that create files composed of
    122122(usually) compressed data that represents, and allows recreation of,
    123 normal (uncompressed) files.  These archiver programs are widely used to
    124 create archive files for downloading from BBSs, information services and
     123normal (uncompressed) files. These archiver programs are widely used to
     124create archive files for downloading from
    125125the Internet, and to extract from those archive files once downloaded.
    126126They're also used to create archives locally for backup purposes, as the
     
    148148:pt.&period.ARC
    149149:pd.Arc
     150:pt.&period.TAR
     151:pd.Tar
    150152:eparml.
    151153:p.
     
    153155where the * will be a number indicating the version of the program.
    154156These are self-extracting archives (archives that extract themselves
    155 when you run the .EXE) so you don't get a chicken-or-egg scenario.  You
    156 can find them on BBSs, information services and the Internet -- in other
     157when you run the .EXE) so you don't get a chicken-or-egg scenario. You
     158can find them on the Internet (Hobbes) -- in other
    157159words, you can find them the same places where archive files are most
    158 often used.
     160often found.
    159161:p.
    160 FM/2 can work with DOS archivers, but they aren't supported.  If you
     162FM/2 can work with DOS archivers, but they aren't supported. If you
    161163decide you want to use your DOS archivers rather than OS/2 native
    162164archive programs, you'll have to figure it out on your own (see
     
    164166the ARCHIVER.BB2 datafile that came with FM/2).
    165167
    166 :h2 res=94200 name=PANEL_AD_FRAME.Editing Archiver Details
    167 :i1 id=aboutEditArc.Editing Archiver Details
    168 :p.
    169 This dialog box, which you can reach from the Config menu, allows you to
    170 edit the details of an :link reftype=hd res=10015.archiver:elink.. Entry
    171 boxes are present for all the twenty one fields represented in
    172 ARCHIVER.BB2 (the text file that contains control information about your
    173 archivers which FM/2 uses to interface with the archivers).  It's
    174 probably easier for most people to edit ARCHIVER.BB2 directly with a
    175 text editor.
    176 :p.
    177 :hp1.NOTE&colon.:ehp1.  The simplest method to ensure that your archivers
    178 work properly with FM/2 is to make sure they're in a directory named in
    179 your PATH= statement, and check the names of the files to make sure they
    180 match what's on your system (i.e. UNZIP.EXE in both ARCHIVER.BB2 and on
    181 your hard disk, not UNZIP.EXE in one and UNZIP32.EXE in another).
    182 :p.
    183 In the event that you attempt to list an archive and FM/2 feels you've
    184 probably bungled the entry in ARCHIVER.BB2, you'll be given an
    185 opportunity to use this dialog to fix the entry.  In this case, you'll
    186 see the listbox at the right of the dialog filled with the listing of
    187 the archive that your archiver made.  You can highlight a line and click
    188 the << button next to the Start List or End List fields to move the line
    189 to that entry field (these are the most common mistakes, and FM/2 cannot
    190 find any files if the Start List string is wrong).  You can double-click
    191 on a listbox line to have FM/2 "parse" it into the Fld# text boxes for
    192 you, to make it easier to judge field positions for sizes, dates, and
    193 filenames.  The filename field in particular is extremely important.  If
    194 it's too high, FM/2 finds no files.  If it's "in range" but wrong, FM/2 gets
    195 the wrong fields for filenames.
    196 :p.
    197 You may still need to refer to your archiver's documentation, or run it
    198 to get the help on its command syntax.  FM/2 can't do everything for you,
    199 but it holds your hand as best it can.
    200 :p.
    201 Refer to the ARCHIVER.BB2 file that came with FM/2 for additional
    202 information and an example.
    203 :p.
    204 When you've completed editing the archiver's details, click Okay.  FM/2
    205 will ask you if you want to rewrite ARCHIVER.BB2 (be sure you save the
    206 original copy for its complete notes; FM/2 will back it up one version to
    207 ARCHIVER.BAK).  If you don't rewrite ARCHIVER.BB2, changes are good only
    208 for the current session (handy for testing).
    209 :p.
    210 You can also get to this dialog box from Select Files' Config submenu.
    211 :p.
    212 See also&colon.
    213 :p.
    214 :link reftype=hd res=94300.Archiver Details Fields:elink.
    215 
    216 :h3 res=94300 name=PANEL_ARCFLDS.Archiver Details Fields
    217 :i1 id=aboutArcFlds.Archiver Details Fields
    218 :p.
    219 :hp2.ID:ehp2.  This field contains an ID for the archiver; something for
    220 human consumption.  It's a good idea to include the version number of the
    221 archiver for reference.  An example might be "LHArc 2.11".
    222 :p.
    223 :hp2.Add:ehp2.  This field should contain the command that creates
    224 and adds files to an archive.  An example might be "PKZIP.EXE -a" (NOTE:
    225 This example assumes the file is on your PATH (see PATH= in CONFIG.SYS).
    226 If it's not, you'd need to give a full pathname, like
    227 "C&colon.\UTILS\PKZIP.EXE -a".) Note that commands should include the
    228 extension so that FM/2 can check them without guessing.  Above this
    229 field is a button labeled "See." If clicked, the program named in this
    230 field will be run (you'll be given the opportunity to add arguments to
    231 the command line) in another window. This lets you check command syntax
    232 and archiver version, as well as assuring that FM/2 can find your archiver
    233 executables.
    234 :p.
    235 :hp2.Move:ehp2.  This field should contain the command that moves files
    236 to the archive (adds then deletes the file).  An example might be
    237 "ARC.EXE mwn".
    238 :p.
    239 :hp2.Extension:ehp2.  This field contains the extension normally
    240 associated with files created by this archiver.  An example might be
    241 "ZOO" for files created by the Zoo archiver.
    242 :p.
    243 :hp2.Extract:ehp2.  This field contains the command that extracts files
    244 from the archive.  This command should not delete the files from the
    245 archive when it extracts them, and *must* be present for FM/2 to show you
    246 a member of the archive (commands other than Extract and List may be
    247 left blank if necessary).  An example might be "PKUNZIP.EXE -o".  Note
    248 the "-o" option given; this tells PKUNZIP to automatically overwrite any
    249 existing files (FM/2 will check to see if any of the files exist and warn
    250 you if so).  It's important to always include your archiver's "don't
    251 stop for user input" option; some things occur as detached processes and
    252 you can't interact with them; the program would be hung, which is
    253 uncool. Above this field is a button labeled "See." If clicked, the
    254 program named in this field will be run (you'll be given the opportunity
    255 to add arguments to the command line) in another window. This lets you
    256 check command syntax and archiver version.
    257 :p.
    258 :hp2.Extract w/Dirs:ehp2.  This field contains the command that extracts
    259 files from the archive and places them into directories embedded in the
    260 archive.  An example might be "LH.EXE x /o /s".
    261 :p.
    262 :hp2.Signature:ehp2.  This field contains the signature for the archive
    263 type.  There is usually a byte or few in a particular place in any
    264 archive that indicates that it is, indeed, an archive of that type.  FM/2
    265 uses these signatures to "sniff out" which archiver is used to
    266 manipulate the archive.  Since these signatures sometimes contain
    267 characters which are "unprintable," you can use \x<hexnum> to represent
    268 any "strange" characters.  A side effect of this is that two backslashes
    269 are required to represent a single backslash ("\\" == "\").  See
    270 :link reftype=hd res=99500.C-style encoding:elink. for more information.
    271 :p.
    272 To determine what an archiver's signature is, either ask the archiver's
    273 author or check several different archives of the type for one or more
    274 bytes present in each at the same location, usually near the beginning
    275 of the file.
    276 :p.
    277 This field must be entered and valid for FM/2 to detect this type of
    278 archive (see also Sig(nature) Pos(ition)).
    279 :p.
    280 :hp2.List:ehp2.  This field contains the command to list the archive's
    281 contents.  This command *must* be present and correct for FM/2 to work
    282 properly with this type of archive.  An example might be "ZOO.EXE v".
    283 :p.
    284 :hp2.Test:ehp2.  This field contains the command to test the archive's
    285 integrity.  An example might be "PKUNZIP.EXE -t".
    286 :p.
    287 :hp2.Add with paths:ehp2.  This field contains the command to add files
    288 to the archiver with their paths (i.e. \FM3\FM3.EXE instead of just
    289 FM3.EXE).  This can be omitted if the archiver doesn't support the
    290 command.  An example might be "ZIP.EXE" (Zip defaults to adding paths).
    291 :p.
    292 :hp2.Move with paths:ehp2.  As above, but moves the files instead of
    293 just adding them.  An example might be "PKZIP -m -P".
    294 :p.
    295 :hp2.Add and recurse:ehp2.  Adds files to the archive, with paths, and
    296 recurses into subdirectories.  An example might be "LH a /s".
    297 :p.
    298 :hp2.Delete:ehp2.  This field contains the command to delete files from
    299 the archive.  An example might be "LH.EXE /o /d".
    300 :p.
    301 :hp2.Sig(nature) Pos(ition):ehp2.  This field contains a number
    302 indicating how many bytes into the file the signature is located.  If
    303 this number is negative, FM/2 looks from the end of the file instead of
    304 the beginning.
    305 :p.
    306 :hp2.F(ile)Name Pos(ition):ehp2.  This field tells FM/2 which field on
    307 the line of an archive listing is the file name.
    308 Archive listing fields are numbered from 0.
    309 The file name position item consists of 4 subfields separated by commas.
    310 All subfields must be present and correct for FM/2 to get the right
    311 file names from the archive listing.
    312 The first is the field number.
    313 The second is a flag which is set to 1 to indicate that the file
    314 name is the last field on the line.
    315 This allows unquoted archive member names to contain spaces
    316 The third is a flag which is set to 1 to indicate that the file name starts
    317 at the second character of the field.
    318 This allows files that are surrounded by unusual bracketing characters.
    319 The fourth is a flag which is set to 1 to indicate the the file name
    320 stands alone at the first field in the listing line and
    321 the file details are on the next line.
    322 :p.
    323 To understand what "field on the line of an archive listing" means,
    324 think of a text line as being broken up into tokens, or words, separated
    325 by spaces.  These tokens, or words, are fields.  Therefore,
    326 :p.
    327 I like Ike.
    328 :p.
    329 contains three fields.  Field 0 is "I", field 1 is "like", and field 3
    330 is "Ike."  Think of it like this&colon.
    331 .br
    332 :xmp.
    333  +--------------------+
    334  |  0   |  1   |  2   | Field Numbers
    335  +------+------+------+
    336  |  I   | like | Ike  | Field Contents
    337  +------+------+------+
    338 :exmp.
    339 :p.
    340 :hp2.OldS(i)z(e) Pos(ition):ehp2.  This field tells FM/2 which field on
    341 the line of an archive listing is the old (uncompressed) size of the
    342 file.  If this isn't available or you don't care about it, you can enter
    343 a -1 to disable detection of this field entirely.
    344 :p.
    345 :hp2.NewS(i)z(e) Pos(ition):ehp2.  This field tells FM/2 which field on
    346 the line of an archive listing is the new (compressed) size of the file.
    347 If this isn't available or you don't care about it, you can enter a -1
    348 to disable detection of this field entirely.
    349 :p.
    350 :hp2.Date Pos(ition):ehp2.  This field tells FM/2 which field on
    351 the line of an archive listing is where the time/datestring is.  If this
    352 isn't available or you don't care about it, you can enter a -1 to
    353 disable detection of this field entirely.  You can optionally follow this
    354 number with a comma and another number that indicates the type of the
    355 date from any of the formats in the following list&colon.
    356 .br
    357 :xmp.
    358  1.  02-08-96  23&colon.55&colon.32
    359  2.   8 Feb 96 23&colon.55&colon.32
    360  3.   8 Feb 96  11&colon.55p
    361  4.  96-02-08 23&colon.55&colon.32
    362 :exmp.
    363 :p.
    364 :hp2.NumDateF(ie)lds:ehp2.  This field tells FM/2 how many fields comprise
    365 the time/datestring.
    366 :p.
    367 :hp2.Start-of-list:ehp2.  The line that comes just before the list of
    368 files in the archiver listing (see example below).  You can use the
    369 :hp2.<<:ehp2. button to insert a selected line directly from the listbox
    370 into this field.
    371 :p.
    372 :hp2.End-of-list:ehp2.  The line that comes just after the list of
    373 files in the archiver listing (see example below).  You can use the
    374 :hp2.<<:ehp2. button to insert a selected line directly from the listbox
    375 into this field.
    376 :p.
    377 Here's an example of an ARC listing (5.12mpl, command "ARC l"; you may
    378 need to widen the help windows for this to look right...):
    379 :p.
    380 :xmp.
    381 Name          Length    Date
    382 ============  ========  =========    <--this line is start-of-list
    383 MAKEFILE           374  28 Nov 89
    384 QSORT.C          14279  29 Nov 89
    385 QSORT.EXE        24629  29 Nov 89
    386 STUFF.H            371  29 Nov 89
    387         ====  ========               <--this line is end-of-list
    388 Total      4     39653
    389 :exmp.
    390 :p.
    391 Note the filename is in position 0, old length in position 1, and the
    392 date starts in position 2, with 3 parts, and there's no new length
    393 field (so it'd be -1).  Compare that to the archiver entry for
    394 ARC 5.12mpl in the "stock" ARCHIVER.BB2 and you should get a feel for
    395 what all those fields mean.
    396168
    397169:h2 res=98300 name=PANEL_ARCERR.Archive Errors
    398170:i1 id=aboutArchiveErrors.Archive Errors
    399171Sometimes FM/2 can't get information from the archiver about an archive.
    400 There are a couple of reasons this could happen&colon.  The information
     172There are a couple of reasons this could happen&colon. The information
    401173in ARCHIVER.BB2 may be incorrect for the archive type, or the archive may
    402 be damaged.  Possibly the file "smelled" like an archive but wasn't.
     174be damaged. Possibly the file "smelled" like an archive but wasn't.
    403175Perhaps you selected :hp1.View->As archive:ehp1. on a file that wasn't
    404176actually an archive.
    405177:p.
    406 When this happens, this dialog appears.  You'll be given as much
     178When this happens, this dialog appears. You'll be given as much
    407179information as possible, including the text of what the archiver had to
    408180say about the archive when it was asked to list its contents, presented
    409 in an MLE, and allowed four choices&colon.  :link reftype=hd
     181in an MLE, and allowed four choices&colon. :link reftype=hd
    410182res=94200.Edit the archiver details:elink., Test the archive (if you
    411183have told FM/2 how to test archives with this archiver in ARCHIVER.BB2),
    412184View the archive, or Cancel the whole thing.
    413185:p.
    414 Generally speaking, first Test the archive.  If the archive is okay or
     186Generally speaking, first Test the archive. If the archive is okay or
    415187if the test won't run at all, the problem is most likely in your archive
    416 information record in ARCHIVER.BB2.  You can View the archive to assure
     188information record in ARCHIVER.BB2. You can View the archive to assure
    417189yourself that it is, in fact, an archive, and perhaps hunt down the
    418190signature so you can add it to ARCHIVER.BB2 if it's not a listed archive
  • trunk/dll/ipf/assoc.ipf

    r10 r268  
    22:i1 id=aboutAssociations.Associations
    33:artwork name='..\..\bitmaps\assoc.bmp' align=center.
    4 (Note&colon.  if you're wondering why FM/2 has Associations separate
     4:p.
     5(Note&colon. if you're wondering why FM/2 has Associations separate
    56from OS/2's, see the :link reftype=hd res=90401.Why separate
    6 Associations?:elink. topic.  Also note that you can :link reftype=hd
     7Associations?:elink. topic. Also note that you can :link reftype=hd
    78res=90402."fall through" to OS/2's associations:elink. if desired.)
    89:p.
     
    1213:p.
    1314You can use this facility to cause editors specific to different
    14 datafile types to start when the datafile is selected.  For instance, if
     15datafile types to start when the datafile is selected. For instance, if
    1516you associate "*&period.ICO" with "ICONEDIT.EXE %a" the icon editor will
    1617be started with the selected icon file when you double-click an icon. A
    1718special association command line, "<>", causes FM/2 to open the default
    18 WPS view of an object.  :hp8.Warning&colon.:ehp8.  Do not use this on a
    19 file associated with AV/2 as you will cause an endless loop as AV/2
    20 constantly starts itself.
     19WPS view of an object.
    2120:p.
    2221Signatures provide a mechanism to further test a matching file to
    23 determine that it is the proper type.  For example, all OS/2 &period.INF
     22determine that it is the proper type. For example, all OS/2 &period.INF
    2423(information) files have the string "HSP" at position 0 of the file. By
    2524using signature "HSP" at offset 0 for the filemask "*&period.INF" and
     
    3837:p.
    3938To delete an association, select it in the listbox, then click
    40 :hp1.Del:ehp1..  You should be aware that the association deleted is
     39:hp1.Del:ehp1.. You should be aware that the association deleted is
    4140the one matching the entry fields, specifically the mask, signature
    4241and offset fields.
     
    4948:p.
    5049The :hp1.Find:ehp1. button brings up a standard OS/2 open dialog that
    51 you can use to point-and-click at the desired executable file.  It's
     50you can use to point-and-click at the desired executable file. It's
    5251pathname will be entered into the command line entry field.
    5352:p.
    5453The :hp1.Close:ehp1. checkbox will cause FM/2 to close after executing
    55 this association.  Please be sure that's the behavior you really want
     54this association. Please be sure that's the behavior you really want
    5655before checking this button.
    5756:p.
    5857The :hp1.Environment:ehp1. MLE control lets you enter environment strings
    59 for the program to inherit.  Generally speaking, this is only for running
     58for the program to inherit. Generally speaking, this is only for running
    6059DOS programs as any strings entered here are interpreted as DOS settings.
    6160For example, :hp3.IDLE_SECONDS=5:ehp3. would adjust the DOS setting
    62 IDLE_SECONDS to 5.  Names of DOS settings are as shown in the Settings
     61IDLE_SECONDS to 5. Names of DOS settings are as shown in the Settings
    6362notebook for a DOS program.
    6463:p.
     
    7170:i1 id=aboutWhyAssociations.Why separate Associations?
    7271Under OS/2's WPS you can set up associations so that double-clicking a
    73 datafile object invokes a program.  Usually you would use this to start
     72datafile object invokes a program. Usually you would use this to start
    7473the program that edits the file; for example, if you double-clicked a
    7574graphics file you'd want your graphics editing program to be started.
     
    7776However, while using a file manager, you would probably prefer to have
    7877a simple viewer started to look at the file quickly so you can decide
    79 what to do with the file.  Therefore, FM/2 allows you to set up
     78what to do with the file. Therefore, FM/2 allows you to set up
    8079Associations for files that are different than those that OS/2 uses.
    8180This lets you invoke viewers in FM/2 via double-click, but invoke
    8281editors in OS/2 via double-click.
    8382:p.
    84 Moreover, FM/2's Associations can be a bit smarter than OS/2's.  You can
     83Moreover, FM/2's Associations can be a bit smarter than OS/2's. You can
    8584associate a signature with a filemask and only files that match both
    86 will be viewed with the associated executable.  You can even use these
     85will be viewed with the associated executable. You can even use these
    8786signatures to invoke OS/2's own associations, providing added assurance
    88 that the right executable is being invoked.  For example, if you have
     87that the right executable is being invoked. For example, if you have
    8988a plain text file with the extension ".INF," OS/2 would try to view it
    90 with VIEW.EXE, which wouldn't know what to do with it.  If you make an
     89with VIEW.EXE, which wouldn't know what to do with it. If you make an
    9190FM/2 Association and give "HSP" as the signature at offset 0 of the file,
    9291only OS/2 INFs will be passed to VIEW.EXE.
     
    10099You can access OS/2's associations for a file system object at any time
    101100by pressing the F6 key or holding down Ctrl while double-clicking the
    102 object.  This causes a default WPS open to be performed on the object.
     101object. This causes a default WPS open to be performed on the object.
    103102:p.
    104103If you want to access OS/2's associations by an unaugmented double-click,
    105 enter "<>" as the executable in the FM/2 Association definition.  This
    106 causes FM/2 to do a default WPS open on the object.  Note that if you
     104enter "<>" as the executable in the FM/2 Association definition. This
     105causes FM/2 to do a default WPS open on the object. Note that if you
    107106wanted :hp2.all:ehp2. objects to use OS/2's associations, you'd need only
    108 one FM/2 Assocation (filemask "*", executable "<>").
     107one FM/2 Association (filemask "*", executable "<>").
  • trunk/dll/ipf/attribs.ipf

    r10 r268  
    22:i1 id=aboutAttribsList.Attributes
    33:artwork name='..\..\bitmaps\attrlist.bmp' align=center.
    4 This dialog allows you to set the attributes and (optionally) date and
    5 time of all objects in a selected group from one popup dialog.  The
     4:p.
     5This dialog allows you to set the attributes and/or date and
     6time of all objects in a selected group from one popup dialog. The
    67dialog presents you with spinboxes to change the date and time (defaults
    78to current time and date) and checkboxes to set the attributes
    8 (ReadOnly, System, Hidden and Archived).  You can also modify the
     9(ReadOnly, System, Hidden and Archived). You can also modify the
    910selected list of objects by pushing the :hp1.Select:ehp1. button. If you
    1011only want to change the objects' attributes and not their date and time,
     
    1314The initial state of the checkboxes and date/time spinbuttons has no
    1415relationship to the actual state of the objects being manipulated if
    15 more than one object was selected and acted upon by the command.  This
     16more than one object was selected and acted upon by the command. This
    1617command affects all selected objects at once.
    1718:p.
    18 The attribute checkboxes are "3-state" checkboxes.  This type of checkbox
     19The attribute checkboxes are "3-state" checkboxes. This type of checkbox
    1920can have three different meanings:  reset attribute (cleared box), set
    20 attribute (checked box), or ignore attribute (greyed box, "indeterminate
     21attribute (checked box), or ignore attribute (grayed box, "indeterminate
    2122state," meaning leave this attribute unchanged).
    22 
     23:p.
    2324:artwork name='bitmaps\3state.bmp' align=center.
    24 
     25:p.
    2526Note that checking the :hp1.Use Date/Time checkbox:ehp1., setting the
    2627date/time to the current date/time, and leaving the attribute checkboxes
    27 greyed results in a "touch" of the file system objects selected for the
     28grayed results in a "touch" of the file system objects selected for the
    2829command (works like the *nix Touch command -- if you don't know what
    29 that is, don't worry too much).  You can use the :hp1.Leave all
    30 attrs:ehp1. button to grey all the attribute checkboxes at once. If
    31 all attribute checkboxes are already greyed, clicking this button causes
     30that is, don't worry too much). You can use the :hp1.Leave all
     31attrs:ehp1. button to gray all the attribute checkboxes at once. If
     32all attribute checkboxes are already grayed, clicking this button causes
    3233the attributes and date/time of the first item in the listbox to be
    3334assigned to the controls of the dialog.
  • trunk/dll/ipf/chklist.ipf

    r2 r268  
    11:h1 res=95600 name=PANEL_CHECKLIST.Checking Lists
    22:i1 id=aboutCheckList.Checking Lists
    3 On occasion you may be asked to check a list of objects.  You'll be
    4 presented with a list of highlighted objects in a listbox.  To remove an
    5 object from the list, unhighlight it (:hp6.hint:ehp6.&colon.  hold down
    6 the Ctrl key while clicking to unhighlight a single item).  When you've
    7 got the list the way you want it, click Okay.  Click Cancel to abort the
     3On occasion you may be asked to check a list of objects. You'll be
     4presented with a list of highlighted objects in a listbox. To remove an
     5object from the list, unhighlight it (:hp6.hint:ehp6.&colon. hold down
     6the Ctrl key while clicking to unhighlight a single item). When you've
     7got the list the way you want it, click Okay. Click Cancel to abort the
    88action.
    99:p.
     
    1616when you drop files onto an FM/2 Directory Container or object within
    1717one, or onto a directory object in the Drive Tree, or onto an object in
    18 the Collector.  You can then pick the action to be performed from the
    19 buttons below the listbox.  You can remove an object from the listbox if
     18the Collector. You can then pick the action to be performed from the
     19buttons below the listbox. You can remove an object from the listbox if
    2020you've changed your mind about including it in the action (hint: hold
    2121down the Ctrl key while clicking to unhighlight a single item).
     
    2626:p.
    2727The :hp1.Shadow:ehp1. toggle causes :hp1.Object:ehp1. to create Shadow
    28 objects instead of "real" objects.  Directory objects are always created
     28objects instead of "real" objects. Directory objects are always created
    2929as Shadow objects.
    3030:p.
    3131Note that creating Shadows in directories not under the Desktop folder
    32 probably isn't desireable.
     32probably isn't desirable.
    3333:p.
    3434The :hp1.Launch:ehp1. button causes FM/2 to bring up the Execute dialog
  • trunk/dll/ipf/cmdline.ipf

    r2 r268  
    22:i1 id=aboutCmdline.Editing Commandline
    33Enter any optional arguments to the program here as you would on the
    4 command line.  Remember that, when passing commands to a command
     4command line. Remember that, when passing commands to a command
    55processor such as CMD.EXE, like DIR, it's CMD.EXE /C DIR, not just
    66CMD.EXE DIR.
    77:p.
    88:hp1.Full Screen, Maximized, Minimized, Invisible, Default&colon.:ehp1.
    9 control how the program will be run.  Default is usually in a window
    10 with OS/2 controlling the size of the initial window.  Note that PM
     9control how the program will be run. Default is usually in a window
     10with OS/2 controlling the size of the initial window. Note that PM
    1111programs will always run on the desktop in a window and programs marked
    12 full screen only will always run in a full screen session.  This
     12full screen only will always run in a full screen session. This
    1313corresponds to START /FS, /MAX, /MIN, /I or just START.
    1414:p.
    15 :hp1.Keep when done&colon.:ehp1.  determines whether the window will
    16 remain until you close it, or go away when the command completes.  It's
    17 like START /K.  For reasons of safety (too complex to explain briefly)
     15:hp1.Keep when done&colon.:ehp1. determines whether the window will
     16remain until you close it, or go away when the command completes. It's
     17like START /K. For reasons of safety (too complex to explain briefly)
    1818you aren't allowed to Keep a DOS session; this flag is ignored for DOS
    1919executables.
    2020:p.
    2121The :hp1.Environment:ehp1. MLE control lets you enter environment strings
    22 for the program to inherit.  Generally speaking, this is only for running
     22for the program to inherit. Generally speaking, this is only for running
    2323DOS programs as any strings entered here are interpreted as DOS settings.
    2424For example, :hp3.IDLE_SECONDS=5:ehp3. would adjust the DOS setting
    25 IDLE_SECONDS to 5.  Names of DOS settings are as shown in the Settings
     25IDLE_SECONDS to 5. Names of DOS settings are as shown in the Settings
    2626notebook for a DOS program.
    2727:p.
    28 Note&colon.  FM/2 automatically stores command lines you use here for
    29 you if the :hp1.Save command line:ehp1. checkbox is checked.  You can
     28Note&colon. FM/2 automatically stores command lines you use here for
     29you if the :hp1.Save command line:ehp1. checkbox is checked. You can
    3030get to them by clicking the :hp1.V:ehp1. button beside the entry field.
    3131Up to 250 command lines can be stored in this manner, kept in a file
    32 named CMDLINES.DAT between sessions.  Pressing the :hp1.Delete:ehp1. key
     32named CMDLINES.DAT between sessions. Pressing the :hp1.Delete:ehp1. key
    3333(or clicking the :hp1.Del:ehp1. button that appears) while one of the
    3434names in the listbox is highlighted will remove it. Pressing :hp1.Ctrl +
    3535Delete:ehp1. will remove (wipe) all entries.
    3636:p.
    37 Tech note&colon.  FM/2 picks the directory in which to start the process
     37Tech note&colon. FM/2 picks the directory in which to start the process
    3838using the following criteria&colon.
    3939.br
  • trunk/dll/ipf/collect.ipf

    r10 r268  
    22:i1 id=aboutCollector.Collector
    33:artwork name='..\..\bitmaps\collect.bmp' align=center.
     4:p.
    45The :hp1.Collector:ehp1. is a temporary place to hold objects that you
    56want to manipulate later; it allows you to temporarily group objects
    6 regardless of where they're physically stored in the file system.  No
     7regardless of where they're physically stored in the file system. No
    78physical (disk) storage is used; the Collector just holds the objects
    89(something like WPS shadows) until you're ready to do something with
    9 them.  You might think of it as an additional clipboard containing names
    10 of file system objects.  Note that objects in the Collector, unlike
     10them. You might think of it as an additional clipboard containing names
     11of file system objects. Note that objects in the Collector, unlike
    1112objects in main tree and directory containers, show their full
    1213pathnames.
    1314:p.
    14 You can drag file system objects from and to the Collector.  Be careful
     15You can drag file system objects from and to the Collector. Be careful
    1516where you drop the objects; directories and files already in the
    1617Collector are "targets." If you drop on a directory, the files are moved
     
    1819:p.
    1920The Collector allows you to manipulate the files it contains just as you
    20 would in a main tree or directory window.  Popup menus are available
    21 just as they are in a main window.  The popup for the collector
    22 container obtained over container whitespace allows clearing the
     21would in a main tree or directory window. Context menus are available
     22just as they are in a main window. The context menu for the collector
     23container obtained by clicking mouse B2 over container whitespace allows clearing the
    2324container, collecting files from the clipboard (a good way to import a
    2425selection from some other program that might save a list of files, one
     
    2728:p.
    2829Additionally, the pulldown menu gives you access to a :link reftype=hd
    29 res=91600.Seek and scan:elink. function.  This leads to a dialog that
     30res=91600.Seek and scan:elink. function. This leads to a dialog that
    3031lets you search for and Collect files based on filemasks and text
    3132content.
    3233
    33 :h3 res=91600 name=PANEL_GREP.Seek and scan
     34:h2 res=91600 name=PANEL_GREP.Seek and scan
    3435:i1 id=aboutGrep.Seek and scan
    3536:i1 id=aboutGrepDupe.Find duplicate files
    36 This dialog, accessed from a Collector context menu, allows you to
     37This dialog, accessed from the Utilities menu or a Collector context menu, allows you to
    3738search for files (by filemasks and, optionally, text within the files)
    3839and :link reftype=hd res=90100.Collects:elink. the files found.
     
    4243:p.
    4344In the :hp6.Filemasks:ehp6. entry field you can enter one or several
    44 filemasks.  To enter multiple masks, separate them with semi-colons.
    45 Entries can total up to 8095 bytes in length.  You can use exclusion
     45filemasks. To enter multiple masks, separate them with semi-colons.
     46Entries can total up to 8095 bytes in length. You can use exclusion
    4647masks as well by prefacing that portion of the mask with a forward slash
    4748(/), which can be used to speed up the search by excluding paths or
    48 filemasks that you are not interested in finding.  Example&colon.
     49filemasks that you are not interested in finding. Example&colon.
    4950"C&colon.\*;/C&colon.\OS2\*;/C&colon.\DESKTOP;D&colon.\*;/*.DLL".
    5051:p.
    5152The :hp6.Add:ehp6. and :hp6.Delete:ehp6. buttons can be used to add the
    5253current filemask to the listbox for later retrieval or delete a line
    53 from the listbox if you want to get rid of it.  The :hp6.Append:ehp6.
     54from the listbox if you want to get rid of it. The :hp6.Append:ehp6.
    5455checkbox allows you to control whether selected masks replace what is
    5556in the Filemasks entry field, or are appended to the current contents.
     
    5960:p.
    6061The :hp6.Walk:ehp6. button brings up the :link reftype=hd res=91500.Walk
    61 Directories:elink. dialog.  When you select a directory in the dialog
     62Directories:elink. dialog. When you select a directory in the dialog
    6263it's added to the Filemasks entry field.
    6364:p.
     
    6768:p.
    6869In the :hp6.Search text:ehp6. MLE you can enter text that must be found
    69 for the file to match.  All files matching the filemask(s) are searched
    70 for this text.  If no text is entered, a simple file find is performed.
    71 Note that each line of the MLE is a separate search string.  If any of
    72 the strings are found, FM/2 will consider a match to be made.  You can
     70for the file to match. All files matching the filemask(s) are searched
     71for this text. If no text is entered, a simple file find is performed.
     72Note that each line of the MLE is a separate search string. If any of
     73the strings are found, FM/2 will consider a match to be made. You can
    7374enter up to 4096 characters in this MLE, and as many lines as you like
    74 within that limitation.  Note that a "line break," for our purposes
     75within that limitation. Note that a "line break," for our purposes
    7576here, is created when you press [Enter] in the MLE; word wrap is not
    7677a consideration.
    7778:p.
    78 Simple regular expressions are supported.  These can be briefly
     79Simple regular expressions are supported. These can be briefly
    7980summarized&colon.
    8081:parml compact tsize=11 break=none.
     
    9495:p.
    9596The :hp6.Include Subdirs:ehp6. checkbox controls whether the search
    96 extends into subdirectories.  If the box is checked, subdirectories are
     97extends into subdirectories. If the box is checked, subdirectories are
    9798searched.
    9899:p.
     
    100101:hp6.Search text:ehp6. entry field.
    101102:p.
    102 The :hp6.Case Senseitive:ehp6. checkbox, if checked, makes text searches
    103 case sensitive.  Otherwise they are not ('c' matches 'C' and 'c').
     103The :hp6.Case Sensitive:ehp6. checkbox, if checked, makes text searches
     104case sensitive. Otherwise they are not ('c' matches 'C' and 'c').
    104105:p.
    105106The :hp6.Say files as found:ehp6. checkbox tells FM/2 to display the
     
    108109:p.
    109110The :hp6.Search files:ehp6. checkbox, when checked, tells FM/2 to look
    110 inside files for the text in the Search text entry field.  This has no
     111inside files for the text in the Search text entry field. This has no
    111112effect if no search text was entered.
    112113:p.
    113114The :hp6.Search EAs:ehp6. checkbox, when checked, tells FM/2 to look at
    114 the text EAs of files for the text in the Search text entry field.  This
     115the text EAs of files for the text in the Search text entry field. This
    115116has no effect if no search text was entered.
    116117:p.
    117118The :hp6.Find duplicates:ehp6. checkbox, when checked, tells FM/2 to
    118 find :hp2.potential:ehp2. duplicate files.  Files with the same name are
     119find :hp2.potential:ehp2. duplicate files. Files with the same name are
    119120found, as are files with the same size and date/time.
    120121:hp9.Note&colon.:ehp9. Finding duplicates is a time and resource
    121122consuming operation due to the usually large number of files, and
    122 therefore comparisons, involved (FM/2 on a 486/66DX2 with 32 mb RAM
    123 required about 7 minutes to search 11,000 files for dupes). Once
     123therefore comparisons, involved (FM/2 on a P3/500 with 256 mb RAM
     124required about 4 minutes to search 12,000 files for dupes). Once
    124125potential dupe files have been found and Collected you can use the
    125126Collector's sort and information facilities and commands to check the
     
    130131:p.
    131132The :hp6.CRC dupes:ehp6. checkbox, when checked, causes FM/2 to
    132 determine and check the CRCs of potential duplicate files.  Only files
     133determine and check the CRCs of potential duplicate files. Only files
    133134with matching CRCs will then pass the dupe test begun as described
    134 above.  This approximately doubles the time it takes to find potential
     135above. This approximately doubles the time it takes to find potential
    135136duplicate files, depending on how many potential dupes there are, but
    136137not using it means that invariably a few files will be flagged as
    137138possible dupes that aren't (this is possible even with this switch on,
    138 but far less likely).  Note that in order to CRC a file, FM/2 must be
     139but far less likely). Note that in order to CRC a file, FM/2 must be
    139140able to open it -- if it can't, FM/2 will consider the two files being
    140141compared to be duplicates.
     
    142143The :hp6.No size dupes:ehp6. checkbox, when checked, tells FM/2 to not
    143144consider files as potential dupes unless their names match (size/date
    144 matches aren't considered).  Be aware that you will probably miss true
     145matches aren't considered). Be aware that you will probably miss true
    145146duplicate files if you turn this off, as not all dupes have the same
    146147name.
     
    148149The :hp6.Ignore extensions:ehp6. checkbox, when checked, tells FM/2 to
    149150ignore the (last) extension on filenames when checking for dupes by
    150 name.  This is handy when you're comparing files in BBS upload
     151name. This is handy when you're comparing files in BBS upload
    151152directories where the same file may have been archived with different
    152153archivers, resulting in identical rootnames but different extensions.
    153154:p.
    154155The :hp6.Larger:ehp6. entry field can be used to find files larger than
    155 the number of bytes input (zero means all files).  The :hp6.k:ehp6.
     156the number of bytes input (zero means all files). The :hp6.k:ehp6.
    156157button next to the entry field multiplies the value by 1024 for you to
    157 make kilobytes instead of bytes.  The :hp6.Smaller:ehp6. entry field
     158make kilobytes instead of bytes. The :hp6.Smaller:ehp6. entry field
    158159works the same except that it causes files smaller than the number of
    159 bytes input to be found.  When used together (both fields are nonzero),
     160bytes input to be found. When used together (both fields are nonzero),
    160161files found will be greater than the Larger field's value or less than
    161162the Smaller field's value.
     
    163164The :hp6.Newer:ehp6. and :hp6.Older:ehp6. entry fields work similarly.
    164165When non-zero, these fields cause the search to find only files newer
    165 or older than the number of days entered.  The :hp6.m:ehp6. buttons
     166or older than the number of days entered. The :hp6.m:ehp6. buttons
    166167multiply the value by 30 for you to make "months" instead of days.
    167168:p.
    168169The :hp6.AllHDs:ehp6. button prompts you for a single simple filemask
    169170(one without a drive or path) then builds a :hp6.Filemasks:ehp6. string
    170 that will search all hard drives for that mask.  Similarly, the
     171that will search all hard drives for that mask. Similarly, the
    171172:hp6.LocalHDs:ehp6. builds a mask for all local hard drives, and
    172173:hp6.RemoteHDs:ehp6. builds a mask for all remote (LAN) hard drives.
    173174:p.
    174175The listbox on the left top of the dialog contains a list of valid
    175 drives.  You can double-click one of these drives to add a mask for
     176drives. You can double-click one of these drives to add a mask for
    176177that drive to the entry field.
    177178:p.
     
    180181:p.
    181182Click :hp6.Okay:ehp6. when ready to search, or :hp6.Cancel:ehp6. to exit
    182 without searching.  Note that this function is designed to run in the
     183without searching. Note that this function is designed to run in the
    183184background while you're doing other work, rather than running full-tilt
    184185and making you wait for it.
    185186:p.
    186 :hp9.Quicky instructions for file finding:ehp9.&colon.  type a mask into
     187:hp9.Quicky instructions for file finding:ehp9.&colon. type a mask into
    187188the :hp6.Filemasks:ehp6. entry field (for example, "C&colon.\*.BAK") and
    188189press [Enter].
    189190:p.
    190 :hp9.Quicky instructions for dupe finding:ehp9.&colon.  type a mask into
     191:hp9.Quicky instructions for dupe finding:ehp9.&colon. type a mask into
    191192the :hp6.Filemasks:ehp6. entry field, check :hp6.Find Duplicates:ehp6.,
    192193check :hp6.CRC dupes:ehp6. if you want greater accuracy (and more time
     
    195196See also :link reftype=hd res=98500.See all files:elink..
    196197
    197 :h4 res=100050 name=PANEL_ENV.Enter environment variable name
     198:h3 res=100050 name=PANEL_ENV.Enter environment variable name
    198199:i1 id=aboutEnterEnvironment.Enter environment variable name
    199200
    200201This dialog, reached from the :link reftype=hd res=91600.Seek and Scan
    201202files dialog:elink., allows you to enter or select the name of an
    202 enviroment variable (like PATH, LIBPATH, DPATH, etc.) that points to a
    203 list of directories separated by semi-colons.  The Seek and Scan dialog
     203environment variable (like PATH, LIBPATH, DPATH, etc.) that points to a
     204list of directories separated by semi-colons. The Seek and Scan dialog
    204205will then build the filemask for you from that list of directories.
    205206:p.
    206207Some of the most frequently encountered environment variable names are
    207 displayed in the listbox.  If you select one, its name is placed in the
    208 entry field for you.  You can also type in a name. Click :hp1.Okay:ehp1.
     208displayed in the listbox. If you select one, its name is placed in the
     209entry field for you. You can also type in a name. Click :hp1.Okay:ehp1.
    209210when you have entered the desired name, or click :hp1.Cancel:ehp1. if
    210211you changed your mind and don't wish to use an environment variable
    211212name.
    212213
    213 :h3 res=98500 name=PANEL_SEEALL.See all files
     214:h2 res=98500 name=PANEL_SEEALL.See all files
    214215:i1 id=aboutSeeAllFiles.See all files
    215216
    216217FM/2 can present a window listing all the files on one or more drives.
    217218This command is part of the :link reftype=hd res=90100.Collector:elink.,
    218 and can be accessed from the Collector's context menu.  There's also a
    219 shortcut command under the :link reftype=hd res=92100.Utilities:elink.
    220 submenu on the main FM/2 window.  Selecting :hp1.Miscellaneous->Show all
    221 files:ehp1. (Ctrl + S) from a Drive Tree directory's context menu can
    222 also get you here.
    223 :p.
    224 After you select the drives to list from a dialog, FM/2 will scan the
    225 selected drives and then fill a custom list control with the names of
     219and can be accessed from the Utilities menu or the Collector's context menu.   
     220Selecting :hp1.Miscellaneous->Show allfiles:ehp1. (Ctrl + S) from a Drive
     221Tree directory's context menu will also get you here.
     222:p.
     223After you select the drives to scan from a dialog, FM/2 will scan the
     224selected drives and then fill a custom control list with the names of
    226225all the files found.
    227226:p.
    228227Once the filenames are displayed, together with their sizes, attributes
    229228and last written dates and times, you can perform a variety of actions
    230 with selected files from the list.  Commands exist to sort the listing
     229with selected files from the list. Commands exist to sort the list
    231230in several ways and to filter and select files in several ways.
    232231:p.
    233232You can also drag selected files from the list.
    234233:p.
    235 You can use the Filter to pare a listing down to a smaller subset. For
     234You can use the Filter to pare a list down to a smaller subset. For
    236235example, if you are viewing all the files on the C&colon. drive, you can
    237 limit the view to all the files in C&colon.\OS2 and subdirectories with
     236limit the view to all the files in C&colon.\OS2 and its subdirectories with
    238237the filter "C&colon.\OS2\*".
    239238:p.
    240239FM/2 displays Hidden and System files in red, Readonly files in blue,
    241 and all others in black on a light grey background. Selected files are
    242 displayed in reverse video (white text on a black background).  These
    243 colors are configurable.  The current file has a ">" pointing at it in
    244 the left margin.  Single selections and swipe selections are supported,
     240and all others in black on a light gray background. Selected files are
     241displayed in reverse video (white text on a black background). These
     242colors are configurable. The current file has a ">" pointing at it in
     243the left margin. Single selections and swipe selections are supported,
    245244as well as select and deselect all, and select and deselect based on
    246245masks and/or attributes.
     
    250249You can press the first letter of a file (as displayed; if fullnames are
    251250on, you must type the first letter of the full filename, including path)
    252 to "find" a file that begins with that letter.  In fact, in this window,
     251to "find" a file that begins with that letter. In fact, in this window,
    253252you can type more than one letter of a filename (each within one, count
    254253'em, one, second of the previous) to narrow the search further -- something
     
    256255:p.
    257256Double-clicking a file results in a default action as in Directory
    258 Containers (usually a view of the file).  If you need a refresher, check
    259 the :link reftype=hd res=90000.General Help:elink. topic.  The keyboard
     257Containers (usually a view of the file). If you need a refresher, check
     258the :link reftype=hd res=90000.General Help:elink. topic. The keyboard
    260259equivalent is the Enter key.
    261260:p.
    262261A large subset of the commands available in Directory Containers is
    263 available in this window.  See the :link reftype=hd res=93700.Context
    264 menus:elink. topic for more information.  Commands in this window
     262available in this window. See the :link reftype=hd res=93700.Context
     263menus:elink. topic for more information. Commands in this window
    265264always apply to selected files.
    266265:p.
     
    269268and preserve...:ehp6. and :hp6.Move and preserve...:ehp6.. These
    270269commands copy or move the selected files but preserve the directory
    271 relationship of the files.  The effect of this can be non-obvious, so
     270relationship of the files. The effect of this can be non-obvious, so
    272271use with care.
    273272:p.
    274273Let's say you select three files&colon. G&colon.\FOO\BAR\DUDE,
    275 G&colon.\FOO\BAR\WOW\DUDE and G&colon.\FOO\BAR\RUFF\DUDE.  If you select
     274G&colon.\FOO\BAR\WOW\DUDE and G&colon.\FOO\BAR\RUFF\DUDE. If you select
    276275:hp1.Copy and preserve:ehp1. and pick a destination directory of
    277276H&colon.\HERE, the resultant files will be H&colon.\HERE\DUDE,
     
    283282:p.
    284283The :hp6.Duplicates...:ehp6. command can be used to find files that are
    285 potential duplicates in the window.  There are several options that you
     284potential duplicates in the window. There are several options that you
    286285can select in the :link reftype=hd res=100035.dialog:elink. that
    287286appears. Duplicate finding can take a considerable amount of time, but
    288287you can continue to do things in other windows while you wait.
    289288:p.
    290 See also&colon.  :link reftype=hd res=91600.Seek and Scan:elink.
    291 
    292 :h4 res=98600 name=PANEL_DRVSWND.Pick drives
    293 
    294 Highlight the drive(s) to list, then click Okay.  Click Cancel to abort.
     289See also&colon. :link reftype=hd res=91600.Seek and Scan:elink.
     290
     291:h3 res=98600 name=PANEL_DRVSWND.Pick drives
     292
     293Highlight the drive(s) to list, then click Okay. Click Cancel to abort.
    295294:p.
    296295FM/2 will quickly load all the files on the selected drives into an ugly
    297 but fast custom list control for you to further examine and manipulate.
     296but fast custom control list for you to further examine and manipulate.
    298297:p.
    299298The custom control is used rather than a container due to the slowness
    300 of containers when dealing with such large numbers of records.  You can
     299of containers when dealing with such large numbers of records. You can
    301300verify this by using :link reftype=hd res=91600.Seek and scan:elink. to
    302301Collect the same files into the Collector container, if you're a
    303302masochist.
    304303
    305 :h4 res=100035 name=PANEL_DUPES.Duplicate finding options
    306 
    307 Select from the options for finding duplicate files.  Files must meet
     304:h3 res=100035 name=PANEL_DUPES.Duplicate finding options
     305
     306Select from the options for finding duplicate files. Files must meet
    308307:hp1.all:ehp1. selected criteria to be considered duplicates (dupes).
    309308Therefore, the more options you check, the more likely the files you're
     
    311310files.
    312311:p.
    313 Note that CRCing files can take considerable time.  Only files that
     312Note that CRCing files can take considerable time. Only files that
    314313match all other criteria will be CRCed, and files will only be CRCed
    315314once (i.e. the logic's not :hp1.totally:ehp1. stupid), but it will take
    316 longer.  FM/2 will display some info about where it is during the dupe
     315longer. FM/2 will display some info about where it is during the dupe
    317316check, and checking is done in a background thread at a low priority so
    318 that other windows and applications remain useable. FM/2 must be able
     317that other windows and applications remain usable. FM/2 must be able
    319318to open the file for reading to CRC it -- if it cannot do so, it will
    320319consider the file a match based on the other criteria specified.
    321320:p.
    322321After finding duplicate files, you can "restore" the rest of the files
    323 by using the :hp6.Filter:ehp6. command.  It often helps to set the
     322by using the :hp6.Filter:ehp6. command. It often helps to set the
    324323Sort to Name or Size when viewing files found as potential duplicates
    325324to best see their relationships.
  • trunk/dll/ipf/command.ipf

    r10 r268  
    22:i1 id=aboutCommands.Editing Commands
    33:artwork name='..\..\bitmaps\command.bmp' align=center.
     4:p.
    45This dialog allows you to edit the commands that are available in the
    5 Commands submenu.  There is always a :hp1.Do it yourself:ehp1. command
     6Commands submenu. There is always a :hp1.Do it yourself:ehp1. command
    67in the Commands submenu, and it is the default for the conditional
    78cascade. The Do it yourself command supplies the names of selected files
    89as the command line and allows you to enter a command to be performed on
    9 the files in an entry field.  Note that OS/2 command lines are limited
     10the files in an entry field. Note that OS/2 command lines are limited
    1011to 1,000 characters.
    1112:p.
     
    2021:p.
    2122To delete a command, select it in the listbox, then click
    22 :hp1.Del:ehp1..  You should be aware that the command deleted
     23:hp1.Del:ehp1.. You should be aware that the command deleted
    2324is the one matching the entry field, specifically, the title field.
    2425:p.
     
    2728:p.
    2829The :hp1.Find:ehp1. button brings up a standard OS/2 open dialog that
    29 you can use to point-and-click at the desired executable file.  It's
     30you can use to point-and-click at the desired executable file. It's
    3031pathname will be entered into the command line entry field.
    3132:p.
    3233The :hp1.Environment:ehp1. MLE control lets you enter environment
    33 strings for the program to inherit.  Generally speaking, this is only
     34strings for the program to inherit. Generally speaking, this is only
    3435for running DOS programs where any strings entered here are interpreted
    3536as DOS settings. For example, :hp3.IDLE_SECONDS=5:ehp3. would adjust the
    36 DOS setting IDLE_SECONDS to 5.  Names of DOS settings are as shown in
     37DOS setting IDLE_SECONDS to 5. Names of DOS settings are as shown in
    3738the Settings notebook for a DOS program.
    3839:p.
     
    4647:i1 id=aboutReorderingCommands.Reordering Commands
    4748This dialog, accessed from the Edit Commands dialog, allows you to
    48 rearrange the order of Commands.  You take selected items from the left
     49rearrange the order of Commands. You take selected items from the left
    4950listbox and Add them to the end of the right listbox with the
    5051:hp1.Add>>:ehp1. button. When you've moved everything to the right
    51 listbox, click :hp1.Okay:ehp1..  Click :hp1.Cancel:ehp1. if you change
     52listbox, click :hp1.Okay:ehp1.. Click :hp1.Cancel:ehp1. if you change
    5253your mind.
    5354:p.
    54 In reality, you don't need to move everything to the right listbox.  You
     55In reality, you don't need to move everything to the right listbox. You
    5556can move only what you want moved to the top of the list, then click
    56 Okay.  Anything remaining in the left listbox is added to the end of
     57Okay. Anything remaining in the left listbox is added to the end of
    5758what's in the right listbox.
    5859:p.
     
    101102:pd.listfile name (first places full filenames in a list file; user
    102103Command should delete listfile when complete, but FM/2 will clean any
    103 left over up when FM/2 closes).  This is an advanced command -- see
     104left over up when FM/2 closes). This is an advanced command -- see
    104105EXAMPLE.CMD in the FM/2 distribution archive for a skeleton program that
    105 you can use to do work on the filenames listed in the listfile.  You can
     106you can use to do work on the filenames listed in the listfile. You can
    106107use %! more than once in the same command line -- the listfile will only
    107108be built once, but the name of that listfile will be inserted each time.
     
    111112:p.
    112113When you enter a metastring into a command line, the metastring is
    113 replaced with the appropriate text.  For example, "%c /C MYCMD.CMD %a"
     114replaced with the appropriate text. For example, "%c /C MYCMD.CMD %a"
    114115might become "CMD.EXE /C MYCMD.CMD d&colon.\file1 d&colon.\file2
    115116d&colon.\file3".
  • trunk/dll/ipf/comp.ipf

    r10 r268  
    33
    44:artwork name='..\..\bitmaps\linkdrag.bmp' align=center.
     5:p.
    56The :hp1.Compare Directories:ehp1. dialog shows you a comparison
    6 breakdown of two directories.  You can highlight files here and
     7breakdown of two directories. You can highlight files here and
    78:link reftype=hd res=90100.Collect:elink. them for later processing,
    89or drag them elsewhere.
    910:p.
    10 The dialog presents two containers side-by-side.  Vertical scrolling of
    11 the containers is synched so that scrolling one scrolls both. The files
     11The dialog presents two containers side-by-side. Vertical scrolling of
     12the containers is synced so that scrolling one scrolls both. The files
    1213are listed so that they are in alphabetical order, with gaps in the
    13 containers where a file exists in one but not the other.  This provides
     14containers where a file exists in one but not the other. This provides
    1415easy, at-a-glance comparison of the directories' contents.
    1516:p.
    1617It is possible to change the directory of a container by direct editing
    17 of the container title.  You can change both directories simultaneously
    18 by clicking the :hp6.Dirs:ehp6. button.  You can include all the files
     18of the container title. You can change both directories simultaneously
     19by clicking the :hp6.Dirs:ehp6. button. You can include all the files
    1920in all subdirectories by checking the :hp6.Include subdirs:ehp6. button.
    2021:p.
     
    3031Snapshots can be used to see what changed in a directory from one point
    3132in time to another (for instance, to see what installing a program might
    32 have changed in your system directories).  You can also
     33have changed in your system directories). You can also
    3334:hp1.Filter:ehp1. what shows in the containers.
    3435:p.
    35 The line of :hp1.Actions&colon.:ehp1. pushbuttons allow you to
     36The row of :hp1.Actions&colon.:ehp1. pushbuttons allow you to
    3637:hp6.Delete:ehp6. files from either directory and to :hp6.Move:ehp6. or
    37 :hp6.Copy:ehp6. files from one directory to another.  You can
     38:hp6.Copy:ehp6. files from one directory to another. You can
    3839double-click a file to view it, or request a context menu on it to
    3940compare it to its counterpart in the other directory.
     
    4142Several selection/deselection techniques are available via pushbuttons
    4243to enable you to select files based on their comparison. The pushbuttons
    43 operate on both containers.  You can also select and deselect files in
     44operate on both containers. You can also select and deselect files in
    4445the containers manually with the mouse and/or keyboard.
    45 :hp2.Hint&colon.:ehp2.  mouse selection works slightly differently when
     46:hp2.Hint&colon.:ehp2. mouse selection works slightly differently when
    4647you hold down the Ctrl key while clicking.
    4748:p.
    4849:hp2.Brief description of selection/deselection button options&colon.:ehp2.
    4950:p.
    50 :hp6.Same:ehp6.  All items which match name and size exactly.
     51:hp6.Same:ehp6. All items which match name and size exactly.
    5152:p.
    52 :hp6.Identical:ehp6.  All items which match name, size and date exactly.
     53:hp6.Identical:ehp6. All items which match name, size and date exactly.
    5354:p.
    54 :hp6.Both:ehp6.  All items which are present in both containers (only
     55:hp6.Both:ehp6. All items which are present in both containers (only
    5556name used as criteria).
    5657:p.
    57 :hp6.One:ehp6.  All items which are present in only one of the
     58:hp6.One:ehp6. All items which are present in only one of the
    5859containers (only name used as criteria).
    5960:p.
    60 :hp6.Newer:ehp6.  All items which have a counterpart in the other
     61:hp6.Newer:ehp6. All items which have a counterpart in the other
    6162container and are the newer of the pair.
    6263:p.
    63 :hp6.Older:ehp6.  All items which have a counterpart in the other
     64:hp6.Older:ehp6. All items which have a counterpart in the other
    6465container and are the older of the pair.
    6566:p.
    66 :hp6.Smaller:ehp6.  All items which have a counterpart in the other
     67:hp6.Smaller:ehp6. All items which have a counterpart in the other
    6768container and are the smaller of the pair.
    6869:p.
    69 :hp6.Larger:ehp6.  All items which have a counterpart in the other
     70:hp6.Larger:ehp6. All items which have a counterpart in the other
    7071container and are the larger of the pair.
    7172:p.
    72 :hp6.All:ehp6.  All items in both containers.
     73:hp6.All:ehp6. All items in both containers.
    7374:p.
    74 :hp6.Invert:ehp6.  Inverts selection state of all items in both containers.
     75:hp6.Invert:ehp6. Inverts selection state of all items in both containers.
    7576:p.
    7677See also :link reftype=hd res=99100.Selection:elink..
     
    8081that have no matching files in the other directory (click the
    8182:hp1.One:ehp1. button on the left side of the dialog). Copy these files
    82 to the other directory.  Now deselect all files (click the
     83to the other directory. Now deselect all files (click the
    8384:hp1.All:ehp1. button on the right side of the dialog) and select all
    8485newer files (click the :hp1.Newer:ehp1. button on the left side of the
    85 dialog).  Copy these files to the other directory. The directories
     86dialog). Copy these files to the other directory. The directories
    8687should now match exactly -- deselect all files and select identical
    8788files (click the :hp1.Identical:ehp1. button), and all the files should
    8889be selected (to confirm).
    8990:p.
    90 If you're looking for more powerful directory matching software, you
    91 might be interested in Larry Waibel's :hp1.PMDirMatch:ehp1. shareware
    92 program.  Larry can be contacted on Compuserve at user ID 71333,2463,
    93 and he hangs out in the OS2SHARE (library 1 of OS2BVEN) forum. You can
    94 easily set FM/2 up to use PMDirMatch automatically using the :link
    95 reftype=hd res=98400.Compare page:elink. of the internal Settings
    96 notebook.
     91If you're looking directory matching features not included in FM/2, you
     92might find them in the programs available on Hobbes 
     93http&colon.//hobbes.nmsu.edu/cgi-bin/h-search?key=directory+compare&amp.pushbutton=Search
     94You can easily setup FM/2 to use one of these programs automatically using the :link
     95reftype=hd res=98400.Compare page:elink. of the internal Settings notebook.
    9796
    9897:h3 res=91550 name=PANEL_WALKEM2.Select two directories
     
    10099
    101100This dialog lets you pick two directories by "walking" through the
    102 directory structure of your drives.  See also :link reftype=hd
     101directory structure of your drives. See also :link reftype=hd
    103102res=91500.Walk Directories:elink..
    104103:p.
    105104When the desired directories are displayed in the entry fields of
    106 the dialog, click :hp1.Okay:ehp1. to exit.  Click :hp1.Cancel:ehp1. to
     105the dialog, click :hp1.Okay:ehp1. to exit. Click :hp1.Cancel:ehp1. to
    107106exit without selecting directories.
    108107
  • trunk/dll/ipf/config.ipf

    r2 r268  
    55:p.
    66FM/2 can be configured as you like it using the commands under this
    7 submenu.  It is highly recommended that you step through the items in
    8 this submenu when you first begin to use FM/2, both to familiarize
     7menu. It is highly recommended that you experiment with the items in
     8this menu when you first begin to use FM/2, both to familiarize
    99yourself with the available configuration options and to make FM/2
    1010work the way you like it to work.
    1111:p.
    12 To change fonts and colors, FM/2 uses the WPS Font and Color Palettes.
    13 The Config menu contains commands to call up these objects for you.
    14 :p.
    15 This submenu affects general FM/2 behavior.  Each class of container has
     12This menu affects general FM/2 behavior. Each class of container has
    1613its own configuration menu that allows you to set the type of view,
    17 filtering, and so on.  To get the popup menu that controls the
     14filtering, and so on. To get the popup menu that controls the
    1815container's appearance, request a :link reftype=hd res=93700.context
    1916menu:elink. while the pointer is over an empty area of the container, or
    2017select the Views pulldown submenu.
    2118:p.
    22 The :hp6.:link reftype=hd res=99400.Toggle quicklists:elink.:ehp6.
    23 command causes a dropdown listbox to appear below the toolbar (if one is
    24 being used; below the pulldown menu, if one is being used, or titlebar
    25 if not) and above other windows.  The listbox contains the directory
    26 names you've assigned in the :link reftype=hd res=91500.Walk
    27 Directories:elink. dialog.  If you pick one, a Directory Container for
    28 that directory is opened (hold down the Shift key while clicking to
    29 change an existing Directory Container instead). If the dropdown listbox
    30 is already present, this command causes it to disappear.
    31 :p.
    32 A Drive Finder dropdown listbox also appears with the quicklist;
    33 selecting a drive in this list causes the Drive Tree container to scroll
    34 to show the selected drive and make it the current object.
    35 :p.
    36 Finally, a Setup dropdown list also appears that contains names of
    37 setups (Drive Tree location, Directory Container locations and
    38 associated directory names). Pick a setup name, and FM/2 reopens and
    39 repositions the windows as they were when you saved the setup.  A
    40 context menu requested on the setup list entry field is used to save and
    41 delete setup names.  To add a name, enter it in the entry field of the
    42 dropdown, request a context menu, and select :hp1.Save state as
    43 name:ehp1.  To delete a name, put it in the entry field, request a
    44 context menu and select :hp1.Delete state name:ehp1.
    45 :p.
    46 The :hp6.Autoview:ehp6. submenu controls the Autoview window.  The
     19The :link reftype=hd res=94600.Settings notebook:elink. is accessed from
     20this menu.
     21:p. 
     22The :link reftype=hd res=100065.Set Target directory:elink. is the next menu
     23item and can also be accessed using CTRL+T.
     24:p.
     25Five menu items to toggle various FM/2 functions on and off are next.
     26The first two :link reftype=hd res=91800.Toolbar:elink. and :hp6.Autoview:ehp6.
     27have submenus.
     28:p.
     29The:hp6.Toolbar:ehp6. submenu default is to toggle the toolbar on and off
     30The other two items allow you to make the toolbar text only or you can
     31add titles under the toolbar icons. Additional functions to edit the toolbar
     32can be found on the context menu obtained by clicking B2 over a tool icon
     33on the toolbar (see :link reftype=hd res=91800.Toolbar:elink. for more information)
     34You can switch between toolbars using the dialog that appears if you click B2 over
     35an area of "white space" on the toolbar or by selecting load toolbox from the previously
     36discussed context menu.
     37:p.
     38The :hp6.Autoview:ehp6. submenu controls the Autoview window. The
    4739default for this conditional cascade menu is the :hp6.Toggle autoview
    4840window:ehp6. command, which causes an autoview window to appear above
    49 the status line at the bottom of the screen.  As you move the cursor
     41the status line at the bottom of the screen. As you move the cursor
    5042from object to object, FM/2 displays the first few lines of file objects
    51 in this window.  If the autoview window is already displayed, clicking
    52 this command causes it to disappear.  You can also set the what is to
     43in this window. If the autoview window is already displayed, clicking
     44this command causes it to disappear. You can also set the what is to
    5345be autoviewed -- either the file's .COMMENTS EA or the start of the
    54 file's contents (similar to the *nix HEAD program).  When .COMMENTS EAs
     46file's contents (similar to the *nix HEAD program). When .COMMENTS EAs
    5547are being viewed, you can edit them and the changes will be saved when
    56 you switch the focus from the Autoview window.  You can reach this
     48you switch the focus from the Autoview window. You can reach this
    5749editable Autoview window with the Ctrl + Tab hotkey if you are allergic
    5850to your mouse.
     
    6052Clicking the contents Autoview window with B1 causes the file to be
    6153viewed. Clicking with B3 (or chording with B1 and B2 simultaneously)
    62 causes the extended attributes to be viewed.  If viewing .COMMENTS
     54causes the extended attributes to be viewed. If viewing .COMMENTS
    6355rather than contents, you can pick :hp1.View file:ehp1. from the
    6456context menu.
    6557:p.
     58The :hp6.:link reftype=hd res=99400.Toggle quicklists:elink.:ehp6.
     59command causes a set of dropdown listboxes to appear below the toolbar   
     60and above other windows. The listboxes include&colon.
     61.br
     62A Drive Finder dropdown listbox.
     63,br
     64A States dropdown listbox (Fm/2 configurations you have saved with specific name).
     65.br
     66A Commands dropdown listbox (External command that have been added to FM/2).
     67.br
     68A Directory dropdown listbox (Directory names you've assigned in the
     69:link reftype=hd res=91500.Walk Directories:elink. dialog).
     70.br
     71A Toolboxesdropdown listbox also appears if the :hp6.Toolbar:ehp6. is on.
     72:p.
    6673The :hp6.Toggle bottom buttons:ehp6. menu item turns off and on a row of
    67 buttons that appear just above the status line(s).  The buttons display
     74buttons that appear just above the status line(s). The buttons display
    6875the name, date, and attributes of the currently selected object, and the
    69 filter status of the current container.  If clicked with B1, a command
     76filter status of the current container. If clicked with B1, a command
    7077is generated (rename, info, edit date/attributes and filter dialog
    71 respectively).  If clicked with B2, a context menu appears (the same one
    72 you get if you click B2 on the first status line).  If clicked with B3,
     78respectively). If clicked with B2, a context menu appears (the same one
     79you get if you click B2 on the first status line). If clicked with B3,
    7380the sort changes for the current container:  filename, last write date,
    7481file size and reverse sort respectively.
    7582:p.
    7683The :hp6.Toggle drivebar:ehp6. menu item turns off and on a bar showing
    77 all available drives.  You can click these drive buttons to find or
     84all available drives. You can click these drive buttons to find or
    7885switch to a drive (depending on the active window when the button is
    7986clicked), drag objects onto the buttons, request a context menu on a
     
    8289already exists).
    8390:p.
     91The menu also provides access to the dialogs for editing
     92:link reftype=hd res=90400.Associations:elink.,
     93:link reftype=hd res=90700.Commands:elink. and :hp6.Archivers:ehp6.
     94(:link reftype=hd res=94200.Edit Archiver Data:elink.)
     95:p.
     96To change fonts and colors, FM/2 uses the WPS Font and Color Palettes.
     97The Config menu contains commands to call up these objects for you.
     98:p.
     99
     100:p.
    84101See also&colon.
    85102.br
    86103:link reftype=hd res=97600.FM/2 window layout:elink.
    87104.br
    88 :link reftype=hd res=99400.Using quicklists:elink.
    89 .br
    90 :link reftype=hd res=91800.Toolbar:elink.
    91 .br
    92 :link reftype=hd res=90400.Associations:elink.
    93 .br
    94 :link reftype=hd res=90700.Commands:elink.
    95 .br
    96 :link reftype=hd res=94200.Edit Archiver Data:elink.
    97 .br
    98 :link reftype=hd res=94600.Settings notebook:elink.
    99 .br
    100 :link reftype=hd res=100065.Set Target directory:elink.
    101 
    102 :h2 res=91800 name=PANEL_TOOLBAR.Toolbar
    103 :i1 id=aboutToolbar.Toolbar
    104 
    105 :artwork name='bitmaps\toolbar.bmp' align=center.
    106 The :hp1.toolbar:ehp1. is a collection of buttons that invoke some of
    107 the commands in the pulldown or popup menus.  Placing the mouse pointer
    108 on a button and pressing and holding B2 displays brief help for the
    109 button on the titlebar.
    110 :p.
    111 Some of the buttons will allow objects to be dragged onto them; for
    112 example, you can drag objects onto the trashcan to delete them.  Note
    113 that the hotspot of the mouse pointer itself should be over the button
    114 before releasing, not the icon being dragged (icons are slightly offset
    115 from the mouse pointer to give better target visibility).  Target
    116 emphasis is provided in the form of a black outline around the button,
    117 and the arrow pointer turns into a hand when above a toolbox icon.
    118 :p.
    119 This toolbar submenu is a conditional cascade menu, meaning that if you
    120 click other than on the boxed arrow a default command is executed (the
    121 toolbar is toggled off and on), but if you click on the boxed arrow you
    122 get a submenu of items you can select (the other choices are Text
    123 Toolbar, which will cause the toolbar to appear as "normal" buttons with
    124 text on them, or Toolbar Titles, which will cause text to appear below
    125 the toolbar bitmap buttons).
    126 :p.
    127 Toolbar buttons are user-configurable.  To change the toolbar, click
    128 mouse button two (usually the right button) while the mouse pointer is
    129 over a button to pop up a context menu.  You can get the "Load Toolbox"
    130 dialog by clicking B2 on a blank area of the toolbar, and the "Add
    131 Button" dialog by chording on a blank area of the toolbar.
    132 :p.
    133 For advanced/curious users&colon.  Information on what buttons are in the
    134 toolbar is kept in a file named FM3TOOLS.DAT.  This file is an ASCII
    135 (plain text) file that contains information defining the toolbar.  The
    136 file contains comments that explain its format.
    137 :p.
    138 FM/2 allows you to create customized toolboxes that can be loaded as
    139 required to provide toolboxes for specific activities.  Although FM/2
    140 provides ways to edit the toolbar internally, it's probably easier to
    141 load the definition files into a text editor and make the changes
    142 manually en masse.
    143 :p.
    144 If you'd like to see a different toolbar layout (and try out the Load
    145 Toolbox command), right-click on the toolbar, pick Load Toolbox from the
    146 resultant menu, and pick a toolbox from the listbox.  Then you might try
    147 creating your own and saving it with the Save Toolbox command.
    148 :p.
    149 See also&colon.
    150 .br
    151 :link reftype=hd res=96300.Reorder Tools:elink.
    152 .br
    153 :link reftype=hd res=94400.Edit Tool:elink.
    154 .br
    155 :link reftype=hd res=96400.Add Tool:elink.
    156 .br
    157 :link reftype=hd res=94000.Save Tools:elink.
    158 .br
    159 :link reftype=hd res=94500.Load Tools:elink.
    160 
    161 :h3 res=96300 name=PANEL_REORDERTOOLS.Reorder Tools
    162 :i1 id=aboutReorderTools.Reorder Tools
    163 This dialog, accessed from the context menu of a tool button, allows you
    164 to rearrange the order of the toolbar's tool buttons.  You take selected
    165 items from the left listbox and Add them to the end of the right listbox
    166 with the :hp1.Add>>:ehp1. button. When you've moved everything to the
    167 right listbox, click :hp1.Okay:ehp1..  Click :hp1.Cancel:ehp1. if you
    168 change your mind.
    169 :p.
    170 In reality, you don't need to move everything to the right listbox.  You
    171 can move only what you want moved to the top of the list, then click
    172 Okay.  Anything remaining in the left listbox is added to the end of
    173 what's in the right listbox.
    174 :p.
    175 The :hp1.<<Remove:ehp1. button can be used to move selected items from
    176 the right listbox to the bottom of the left listbox.
    177 
    178 :h3 res=94400 name=PANEL_EDITTOOL.Edit Tool
    179 :i1 id=aboutEditTool.Edit Tool
    180 
    181 This dialog allows you to change the help and text strings and flags
    182 associated with a button.  Edit as desired, then click Okay.  Click
    183 Cancel if you change your mind.
    184 :p.
    185 The :hp1.Help:ehp1. field should contain text to remind you what the
    186 button's command does.  For example, a button that deletes files and
    187 directories might have help reading "Delete files and directories".
    188 :p.
    189 The :hp1.Text:ehp1. field should contain very brief text that will be
    190 placed on the button (if the tool id has no bitmap associated with it).
    191 :p.
    192 The :hp1.Droppable:ehp1. checkbox determines if the tool can have objects
    193 dropped on it or not.  See list below.
    194 :p.
    195 The :hp1.Visible:ehp1. checkbox determines if the tool is visible or not.
    196 :p.
    197 If the :hp1.Separator:ehp1. checkbox is checked, FM/2 puts a bit of
    198 whitespace after the button (separates it from the next button).
    199 :p.
    200 If you check the :hp1.User-defined bmp:ehp1. checkbox, FM/2 will allow
    201 you to use your own bitmap.  Bitmaps are named after the :hp1.ID:ehp1.
    202 of the button -- for example, the bitmap file for ID 1005 would be named
    203 "1005.bmp".  Clicking the :hp1.Edit bmp:ehp1. button will cause ICONEDIT
    204 to be loaded with the bitmap, ready to edit.  (Note that bitmaps should
    205 be 28 x 28.)
    206 :p.
    207 The :hp1.ID:ehp1. field identifies the command that is associated with
    208 this button.  See the :link reftype=hd res=96401.Tool IDs:elink. topic.
    209 
    210 :h3 res=96400 name=PANEL_ADDTOOL.Add Tool
    211 :i1 id=aboutAddTool.Add Tool
    212 
    213 This dialog is accessed from the context menu of a tool button, or if you
    214 turn on the toolbar when there are no tools defined.
    215 :p.
    216 To add a tool, fill in the fields as appropriate and click Okay.  Click
    217 Cancel if you change your mind.
    218 :p.
    219 The :hp1.Help:ehp1. field should contain text to remind you what the
    220 button's command does.  For example, a button that deletes files and
    221 directories might have help reading "Delete files and directories".
    222 :p.
    223 The :hp1.Text:ehp1. field should contain very brief text that will be
    224 placed on the button (if the tool id has no bitmap associated with it).
    225 :p.
    226 The :hp1.Droppable:ehp1. checkbox determines if the tool can have objects
    227 dropped on it or not.  See list below.
    228 :p.
    229 The :hp1.Visible:ehp1. checkbox determines if the tool is visible or not.
    230 :p.
    231 If the :hp1.Separator:ehp1. checkbox is checked, FM/2 puts a bit of
    232 whitespace after the button (separates it from the next button).
    233 :p.
    234 If you check the :hp1.User-defined bmp:ehp1. checkbox, FM/2 will allow
    235 you to use your own bitmap.  Bitmaps are named after the :hp1.ID:ehp1.
    236 of the button -- for example, the bitmap file for ID 1005 would be named
    237 "1005.bmp".  Clicking the :hp1.Edit bmp:ehp1. button will cause ICONEDIT
    238 to be loaded with the bitmap, ready to edit.
    239 :p.
    240 The :hp1.ID:ehp1. field should be assigned a number that tells FM/2 what
    241 the command associated with the button is.  See :link reftype=hd
    242 res=96401.Tool IDs:elink. topic.
    243 
    244 :h3 res=96401 name=PANEL_TOOLIDS.Tool IDs
    245 :i1 id=aboutToolIDs.Tool IDs
    246 
    247 :xmp.
    248 ID     Command                                              Droppable?
    249 ====   =================================================    ==========
    250 1023   View Files                                           Y
    251 1024   Edit Files                                           Y
    252 1026   Make Directory                                       N
    253 1010   Object Information                                   Y
    254 1005   Rename Files/Directories                             Y
    255 1004   Delete Files/Directories                             Y
    256 1006   Permanently Delete Files/Directories                 Y
    257 1009   Set Attributes and Date/Time of Files/Directories    Y
    258 10002  Walk Directories                                     N
    259 10008  Select All Files                                     N
    260 10007  Deselect All                                         N
    261 1029   Archive Files/Directories                            Y
    262 1030   Extract From Archives                                Y
    263 1022   Create Objects                                       Y
    264 1021   Create Shadow Objects                                Y
    265 1002   Copy Files/Directories                               Y
    266 1001   Move Files/Directories                               Y
    267 2003   Kill Process                                         N
    268 2004   Undelete Files                                       N
    269 2006   Instant Command File                                 N
    270 2007   OS/2 Command Line                                    N
    271 5001   Filter Container                                     N
    272 3001   Edit Associations                                    N
    273 1048   Edit Commands                                        N
    274 5021   Rescan                                               N
    275 1007   Print Files                                          Y
    276 1008   Extended Attributes                                  Y
    277 2001   View INI Files                                       Y
    278 1027   Save List to Clipboard                               Y
    279 1028   Save List to File                                    Y
    280 1011   Collect Files/Directories                            N
    281 1060   Collect Files/Directories from list file             Y
    282 2010   Bookshelf Viewer                                     N
    283 1017   Open Default                                         Y
    284 1031   Directory sizes                                      N
    285 1132   UUDecode                                             Y
    286 1133   Merge                                                Y
    287 1111   Exit FM/2                                            N
    288 4001   First Command                                        Y
    289 4002   Second Command                                       Y
    290 &period...
    291 4900   First Toolbox                                        N
    292 4901   Second Toolbox                                       N
    293 &period...
    294 :exmp.
    295 Note&colon.  Other Commands can also be used; just add to 4000 as required
    296 to get the number of the command.  For instance, Command 4 would be ID
    297 4004.  Command buttons use the text field; others shown have bitmaps
    298 associated with them in FM/2's resources.  Remember that if you change
    299 your Commands around, you need to resync the tools to the Commands...
    300 :p.
    301 Note&colon.  Toolbox buttons on a toolbar cause the appropriate toolbox
    302 to be loaded from QUICKTLS.DAT (one filename per line, blank lines and
    303 lines beginning with ";" ignored).  The file named on the first line is
    304 the First Toolbox, and so forth.  You can have up to 50 toolbox buttons
    305 defined (total).
    306 :p.
    307 This list isn't complete; ask me if you'd like a command added that
    308 doesn't appear, and I'll tell you if it can be added and what the ID is,
    309 if so.
    310 
    311 :h3 res=94000 name=PANEL_SAVETOOLS.Save Toolbox
    312 :i1 id=aboutSaveTools.Save Toolbox
    313 
    314 FM/2 allows you to save toolboxes (groups of tools) for later recall
    315 with the :link reftype=hd res=94500.Load Toolbox:elink. command.
    316 :p.
    317 Type the name of the file to hold the toolbox definitions into the entry
    318 field below the listbox, or select a file displayed in the listbox (it
    319 will be overwritten).  FM/2 saves the toolbox definitions into the file.
    320 :p.
    321 The files are given an extension of &period.TLS if you don't specify an
    322 extension.  The listbox shows files in the FM/2 directory that have the
    323 extension .TLS (which is my way of suggesting that you follow this
    324 convention).
    325 
    326 :h3 res=94500 name=PANEL_LOADTOOLS.Load Toolbox
    327 :i1 id=aboutLoadTools.Load Toolbox
    328 
    329 FM/2 allows you to load toolboxes (groups of tools) which were saved
    330 with the :link reftype=hd res=94000.Save Toolbox:elink. command.
    331 :p.
    332 Type the name of the file that holds the toolbox definitions into the
    333 entry field below the listbox, or select a file displayed in the
    334 listbox.  FM/2 loads the toolbox definitions from the file and updates
    335 the toolbar.
    336 :p.
    337 This allows you to have groups of specific-purpose buttons which you can
    338 load for different types of activities.  You don't have to use it, but
    339 it's there if you would like to do so.
    340 :p.
    341 Clicking :hp1.Okay:ehp1. without typing in or selecting a filename
    342 results in FM/2 reloading the default toolbox from FM3TOOLS.DAT.
    343 :p.
    344 If I may, here's how I'd recommend using this facility&colon.
    345 :p.
    346 First, save the full toolbar under a new name (perhaps ALL.TLS).  Next,
    347 delete any buttons that you don't want in your customized toolbar.
    348 Finally, add any Command buttons that you do want in the customized
    349 toolbar and save the new toolbox (as <something>.TLS).  By starting with
    350 the full toolbar, you'll spend more of your time deleting buttons you
    351 don't want (a trivial task) and less adding buttons.
    352 
    353 :h2 res=99980 name=PANEL_FLAGS.Drive flags
    354 :i1 id=aboutFlags.Drive flags
    355 
    356 Here you can set flags for various drives.  Command line switches
    357 override these flags.  The flags are stored in FM/2's INI file and
    358 loaded when FM/2 starts, so this is an alternative to all the
    359 esoteric drive command line switches :hp1.except:ehp1. the
    360 :hp2.Ignore:ehp2. switch.
    361 :p.
    362 :hp6.No prescan:ehp6.  Setting this causes FM/2 to :hp1.not:ehp1.
    363 pre-scan removable drives.  You have to double-click the drive
    364 before it's checked to see if it has any subdirectories.  This is
    365 handy for those of you with CD carousels.
    366 :p.
    367 :hp6.Don't load icons:ehp6.  Prevents FM/2 from loading icons for
    368 files and directories on this drive.  If the drive contains only
    369 DOS programs and data files or is a very slow drive, you might
    370 want to check this one.
    371 :p.
    372 :hp6.Don't load subjects:ehp6.  Prevents .SUBJECT EAs from being
    373 automatically loaded on this drive.  Again, if your drive is slow or you
    374 don't use .SUBJECTs with objects on this drive, you might want to check
    375 it.
    376 :p.
    377 :hp6.Don't load longnames:ehp6.  Prevents .LONGNAME EAs from being
    378 automatically loaded on this drive.  You've got the idea by now,
    379 right?
    380 :p.
    381 :hp6.Slow drive:ehp6..  Check this for drives which have extremely slow
    382 seek times (like ZIP and EZ removable hard drives).  The Autoview window
    383 and associated messages are disabled for this drive, and the "Quick Arc
    384 find" method is always used, whether on globally or not, which snaps up
    385 response time. I may take other shortcuts for drives with this attribute
    386 later (loosen error checking).  For such slow drives you may also want
    387 to check the various :hp1.Don't load...:ehp1. flags listed above.
    388 :p.
    389 :hp6.Include files in tree:ehp6.  If you check this, files will be shown
    390 as well as directories in the Drive Tree for this drive.  I have no
    391 idea why you would ever want to check this.
    392 :p.
    393 You get this dialog by selecting Edit->Drive flags from a context menu
    394 requested on a drive (root directory) in the Drive Tree or VTree window.
    395 :p.
    396 Note&colon.  To set the drive flags on a removable drive, like a floppy
    397 or CD-ROM, be sure you put a disk in the drive first.  FM/2 won't let
    398 you set drive flags on a currently invalid disk.
    399 
     105.im notebook.ipf
    400106
    401107:h2 res=100065 name=PANEL_TARGETDIR.Set Target directory
     
    421127.im command.ipf
    422128
    423 .im notebook.ipf
    424 
    425 .im databar.ipf
    426 
     129:h2 res=94200 name=PANEL_AD_FRAME.Editing Archiver Details
     130:i1 id=aboutEditArc.Editing Archiver Details
     131:p.
     132This dialog box, which you can reach from the Config menu, allows you to
     133edit the details of an :link reftype=hd res=10015.archiver:elink.. Entry
     134boxes are present for all the twenty one fields represented in
     135ARCHIVER.BB2 (the text file that contains control information about your
     136archivers which FM/2 uses to interface with the archivers). It's
     137probably easier for most people to edit ARCHIVER.BB2 directly with a
     138text editor.
     139:p.
     140:hp1.NOTE&colon.:ehp1. The simplest method to ensure that your archivers
     141work properly with FM/2 is to make sure they're in a directory named in
     142your PATH= statement, and check the names of the files to make sure they
     143match what's on your system (i.e. UNZIP.EXE in both ARCHIVER.BB2 and on
     144your hard disk, not UNZIP.EXE in one and UNZIP32.EXE in another).
     145:p.
     146In the event that you attempt to list an archive and FM/2 feels you've
     147probably bungled the entry in ARCHIVER.BB2, you'll be given an
     148opportunity to use this dialog to fix the entry. In this case, you'll
     149see the listbox at the right of the dialog filled with the listing of
     150the archive that your archiver made. You can highlight a line and click
     151the << button next to the Start List or End List fields to move the line
     152to that entry field (these are the most common mistakes, and FM/2 cannot
     153find any files if the Start List string is wrong). You can double-click
     154on a listbox line to have FM/2 "parse" it into the Fld# text boxes for
     155you, to make it easier to judge field positions for sizes, dates, and
     156filenames. The filename field in particular is extremely important. If
     157it's too high, FM/2 finds no files. If it's "in range" but wrong, FM/2 gets
     158the wrong fields for filenames.
     159:p.
     160You may still need to refer to your archiver's documentation, or run it
     161to get the help on its command syntax. FM/2 can't do everything for you,
     162but it holds your hand as best it can.
     163:p.
     164Refer to the ARCHIVER.BB2 file that came with FM/2 for additional
     165information and an example.
     166:p.
     167When you've completed editing the archiver's details, click Okay. FM/2
     168will ask you if you want to rewrite ARCHIVER.BB2 (be sure you save the
     169original copy for its complete notes; FM/2 will back it up one version to
     170ARCHIVER.BAK). If you don't rewrite ARCHIVER.BB2, changes are good only
     171for the current session (handy for testing).
     172:p.
     173You can also get to this dialog box from Select Files' Config submenu.
     174:p.
     175See also&colon.
     176:p.
     177:link reftype=hd res=94300.Archiver Details Fields:elink.
     178
     179:h3 res=94300 name=PANEL_ARCFLDS.Archiver Details Fields
     180:i1 id=aboutArcFlds.Archiver Details Fields
     181:p.
     182:hp2.ID:ehp2. This field contains an ID for the archiver; something for
     183human consumption. It's a good idea to include the version number of the
     184archiver for reference. An example might be "LHArc 2.11".
     185:p.
     186:hp2.Add:ehp2. This field should contain the command that creates
     187and adds files to an archive. An example might be "PKZIP.EXE -a" (NOTE:
     188This example assumes the file is on your PATH (see PATH= in CONFIG.SYS).
     189If it's not, you'd need to give a full pathname, like
     190"C&colon.\UTILS\PKZIP.EXE -a".) Note that commands should include the
     191extension so that FM/2 can check them without guessing. Above this
     192field is a button labeled "See." If clicked, the program named in this
     193field will be run (you'll be given the opportunity to add arguments to
     194the command line) in another window. This lets you check command syntax
     195and archiver version, as well as assuring that FM/2 can find your archiver
     196executables.
     197:p.
     198:hp2.Move:ehp2. This field should contain the command that moves files
     199to the archive (adds then deletes the file). An example might be
     200"ARC.EXE mwn".
     201:p.
     202:hp2.Extension:ehp2. This field contains the extension normally
     203associated with files created by this archiver. An example might be
     204"ZOO" for files created by the Zoo archiver.
     205:p.
     206:hp2.Extract:ehp2. This field contains the command that extracts files
     207from the archive. This command should not delete the files from the
     208archive when it extracts them, and *must* be present for FM/2 to show you
     209a member of the archive (commands other than Extract and List may be
     210left blank if necessary). An example might be "PKUNZIP.EXE -o". Note
     211the "-o" option given; this tells PKUNZIP to automatically overwrite any
     212existing files (FM/2 will check to see if any of the files exist and warn
     213you if so). It's important to always include your archiver's "don't
     214stop for user input" option; some things occur as detached processes and
     215you can't interact with them; the program would be hung, which is
     216uncool. Above this field is a button labeled "See." If clicked, the
     217program named in this field will be run (you'll be given the opportunity
     218to add arguments to the command line) in another window. This lets you
     219check command syntax and archiver version.
     220:p.
     221:hp2.Extract w/Dirs:ehp2. This field contains the command that extracts
     222files from the archive and places them into directories embedded in the
     223archive. An example might be "LH.EXE x /o /s".
     224:p.
     225:hp2.Signature:ehp2. This field contains the signature for the archive
     226type. There is usually a byte or few in a particular place in any
     227archive that indicates that it is, indeed, an archive of that type. FM/2
     228uses these signatures to "sniff out" which archiver is used to
     229manipulate the archive. Since these signatures sometimes contain
     230characters which are "unprintable," you can use \x<hexnum> to represent
     231any "strange" characters. A side effect of this is that two backslashes
     232are required to represent a single backslash ("\\" == "\"). See
     233:link reftype=hd res=99500.C-style encoding:elink. for more information.
     234:p.
     235To determine what an archiver's signature is, either ask the archiver's
     236author or check several different archives of the type for one or more
     237bytes present in each at the same location, usually near the beginning
     238of the file.
     239:p.
     240This field must be entered and valid for FM/2 to detect this type of
     241archive (see also Sig(nature) Pos(ition)).
     242:p.
     243:hp2.List:ehp2. This field contains the command to list the archive's
     244contents. This command *must* be present and correct for FM/2 to work
     245properly with this type of archive. An example might be "ZOO.EXE v".
     246:p.
     247:hp2.Test:ehp2. This field contains the command to test the archive's
     248integrity. An example might be "PKUNZIP.EXE -t".
     249:p.
     250:hp2.Add with paths:ehp2. This field contains the command to add files
     251to the archiver with their paths (i.e. \FM3\FM3.EXE instead of just
     252FM3.EXE). This can be omitted if the archiver doesn't support the
     253command. An example might be "ZIP.EXE" (Zip defaults to adding paths).
     254:p.
     255:hp2.Move with paths:ehp2. As above, but moves the files instead of
     256just adding them. An example might be "PKZIP -m -P".
     257:p.
     258:hp2.Add and recurse:ehp2. Adds files to the archive, with paths, and
     259recurses into subdirectories. An example might be "LH a /s".
     260:p.
     261:hp2.Delete:ehp2. This field contains the command to delete files from
     262the archive. An example might be "LH.EXE /o /d".
     263:p.
     264:hp2.Sig(nature) Pos(ition):ehp2. This field contains a number
     265indicating how many bytes into the file the signature is located. If
     266this number is negative, FM/2 looks from the end of the file instead of
     267the beginning.
     268:p.
     269:hp2.F(ile)Name Pos(ition):ehp2. This field tells FM/2 which field on
     270the line of an archive listing is the file name.
     271Archive listing fields are numbered from 0.
     272The file name position item consists of 4 subfields separated by commas.
     273All subfields must be present and correct for FM/2 to get the right
     274file names from the archive listing.
     275The first is the field number.
     276The second is a flag which is set to 1 to indicate that the file
     277name is the last field on the line.
     278This allows unquoted archive member names to contain spaces
     279The third is a flag which is set to 1 to indicate that the file name starts
     280at the second character of the field.
     281This allows files that are surrounded by unusual bracketing characters.
     282The fourth is a flag which is set to 1 to indicate the the file name
     283stands alone at the first field in the listing line and
     284the file details are on the next line.
     285:p.
     286To understand what "field on the line of an archive listing" means,
     287think of a text line as being broken up into tokens, or words, separated
     288by spaces. These tokens, or words, are fields. Therefore,
     289:p.
     290I like Ike.
     291:p.
     292contains three fields. Field 0 is "I", field 1 is "like", and field 3
     293is "Ike."  Think of it like this&colon.
     294.br
     295:xmp.
     296 +--------------------+
     297 |  0   |  1   |  2   | Field Numbers
     298 +------+------+------+
     299 |  I   | like | Ike  | Field Contents
     300 +------+------+------+
     301:exmp.
     302:p.
     303:hp2.OldS(i)z(e) Pos(ition):ehp2. This field tells FM/2 which field on
     304the line of an archive listing is the old (uncompressed) size of the
     305file. If this isn't available or you don't care about it, you can enter
     306a -1 to disable detection of this field entirely.
     307:p.
     308:hp2.NewS(i)z(e) Pos(ition):ehp2. This field tells FM/2 which field on
     309the line of an archive listing is the new (compressed) size of the file.
     310If this isn't available or you don't care about it, you can enter a -1
     311to disable detection of this field entirely.
     312:p.
     313:hp2.Date Pos(ition):ehp2. This field tells FM/2 which field on
     314the line of an archive listing is where the time/datestring is. If this
     315isn't available or you don't care about it, you can enter a -1 to
     316disable detection of this field entirely. You can optionally follow this
     317number with a comma and another number that indicates the type of the
     318date from any of the formats in the following list&colon.
     319.br
     320:xmp.
     321 1. 02-08-96  23&colon.55&colon.32
     322 2. 8 Feb 96  23&colon.55&colon.32
     323 3. 8 Feb 96  11&colon.55p
     324 4. 96-02-08  23&colon.55&colon.32
     325:exmp.
     326:p.
     327:hp2.NumDateF(ie)lds:ehp2. This field tells FM/2 how many fields comprise
     328the time/datestring.
     329:p.
     330:hp2.Start-of-list:ehp2. The line that comes just before the list of
     331files in the archiver listing (see example below). You can use the
     332:hp2.<<:ehp2. button to insert a selected line directly from the listbox
     333into this field.
     334:p.
     335:hp2.End-of-list:ehp2. The line that comes just after the list of
     336files in the archiver listing (see example below). You can use the
     337:hp2.<<:ehp2. button to insert a selected line directly from the listbox
     338into this field.
     339:p.
     340Here's an example of an ARC listing (5.12mpl, command "ARC l"; you may
     341need to widen the help windows for this to look right...):
     342:p.
     343:xmp.
     344Name           Length     Date
     345============  ========  =========    <--this line is start-of-list
     346MAKEFILE           374  28 Nov 89
     347QSORT.C          14279  29 Nov 89
     348QSORT.EXE        24629  29 Nov 89
     349STUFF.H            371  29 Nov 89
     350        ====  ========               <--this line is end-of-list
     351Total      4     39653
     352:exmp.
     353:p.
     354Note the filename is in position 0, old length in position 1, and the
     355date starts in position 2, with 3 parts, and there's no new length
     356field (so it'd be -1). Compare that to the archiver entry for
     357ARC 5.12mpl in the "stock" ARCHIVER.BB2 and you should get a feel for
     358what all those fields mean.
     359
  • trunk/dll/ipf/context.ipf

    r10 r268  
    1 :h1 res=93700 name=PANEL_CONTEXT.Context menus
    2 :i1 id=aboutContext.Context menus
     1:h1 res=93700 name=PANEL_CONTEXT.Context Menus
     2:i1 id=aboutContext.Context Menus
    33:link reftype=hd res=97800.Context menus:elink. (also called popup
    44menus) are used extensively in FM/2, just as they are in the WPS.
     
    99:p.
    1010Commands that affect the container as a whole are found in context menus
    11 requested over whitespace (any empty area of the container).  Commands
     11requested over whitespace (any empty area of the container). Commands
    1212that affect the objects within the container are requested over the
    13 object of interest.  If an object is :link reftype=hd
     13object of interest. If an object is :link reftype=hd
    1414res=98000.highlighted:elink. when a context menu is requested, the
    1515commands will usually affect all highlighted objects; otherwise, any
     
    1919FM/2's :link reftype=hd res=93300.Files menu:elink. shows the same menu
    2020that would be obtained if you requested a context menu over the current
    21 object.  FM/2's :link reftype=hd res=93800.Views menu:elink. shows the
     21object. FM/2's :link reftype=hd res=93800.Views menu:elink. shows the
    2222same menu that would be obtained if you requested a context menu over
    23 the current window's whitespace.  :hp9.Note&colon.:ehp9. FM/2 Lite's
     23the current window's whitespace. :hp9.Note&colon.:ehp9. FM/2 Lite's
    2424pulldown menus are simplified, but the context menus have all the
    2525commands available, so the Files and Views menus aren't exact matches
     
    2727:p.
    2828When a menu command leads to a dialog, the command name is followed by
    29 dots (i.e. "Attributes...").  In cases where commands have :link
     29dots (i.e. "Attributes..."). In cases where commands have :link
    3030reftype=hd res=100005.accelerator key equivalents:elink., the :link
    3131reftype=hd res=97700.accelerator key:elink. is listed after the command
    32 (i.e. "Info...    Ctrl + i").
     32(i.e. "Info...   Ctrl + i").
    3333:p.
    3434:hp2.See also&colon.:ehp2.
     
    4343:i1 id=aboutContextObject.Context menus affecting objects
    4444
     45Commands are listed in the order they appear on the file object context
     46menu. Some commands apply to file, directory and drive objects. Others apply to
     47only one or two types of objects. Items not appearing on the file object menus
     48are inserted at the relative point they appear in the directory and/or drive menu.
     49Small icons appear with each entry to indicate which types of objects file :artwork runin name='\bitmaps\file.bmp'.
     50directory :artwork runin name='\bitmaps\fldr.bmp'. and/or drive :artwork runin name='\bitmaps\drive.bmp'. they are associated with.
    4551(Note that not all commands are available for all objects on all drives;
    4652CD-ROM drives obviously wouldn't allow Delete and Move commands, for
    47 instance, since they're read-only drives.)
     53instance, since they're read-only drives. In this case the command(s) are grayed out)
    4854:p.
    4955These context menus are shadows of the :link reftype=hd
    5056res=93300.Files:elink. pulldown menu.
    51 :artwork name='..\..\bitmaps\view.bmp' align=center.
     57:p.
     58:artwork name='..\..\bitmaps\rename.bmp' align=center.
     59:p.
     60:hp6.:link reftype=hd res=91400.Rename:elink.:ehp6. allows you to rename
     61objects. You are notified of conflicts as they occur. An easier method
     62for renaming one object is to point at its text, hold down the ALT key,
     63and click mouse button one; however, this command allows you to use
     64wildcards when renaming if you desire.
     65:artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\fldr.bmp'.
     66:p.
     67:artwork name='..\..\bitmaps\copier.bmp' align=center. :artwork name='..\..\bitmaps\mover.bmp' align=center.
     68:p.
     69:hp6.Copy and Move:ehp6. copy or move objects. :hp2.:link reftype=hd
     70res=90000.Drag and drop:elink. is recommended over using the menu
     71commands for moving and copying.:ehp2. When using the menu commands, the
     72:link reftype=hd res=91500.Walk Directories:elink. dialog appears to allow
     73you to select a target directory.
     74:artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\fldr.bmp'.
     75:p.
     76:hp6.Copy and rename:ehp6. and :hp6.Move and rename:ehp6. allow you to
     77change the names of the destination files as you copy and move using
     78the standard rename dialog. You can also copy or move with wildcarding,
     79like you can from the command line (COPY thisfile.txt *.bak) by using
     80wildcards in the filename portion of the destination.
     81:artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\fldr.bmp'.
     82:p.
     83:hp6.Copy and preserve:ehp6. and :hp6.Move and preserve:ehp6. are only
     84available in the Collector and See all files windows. These commands
     85copy or move the selected files but preserve the directory relationship
     86of the files. The effect of this can be non-obvious, so use with care.
     87:artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\fldr.bmp'.
     88:p.
     89Let's say you select three files&colon. G&colon.\FOO\BAR\DUDE,
     90G&colon.\FOO\BAR\WOW\DUDE and G&colon.\FOO\BAR\RUFF\DUDE. If you select
     91:hp1.Copy and preserve:ehp1. and pick a destination directory of
     92H&colon.\HERE, the resultant files will be H&colon.\HERE\DUDE,
     93H&colon.\HERE\WOW\DUDE and H&colon.\HERE\RUFF\DUDE.
     94:p.
     95Note that drives are not considered when preserving directory
     96relationships, so if one of our three files above resided on drive
     97F&colon., the results would be the same.
     98:p.
     99:hp6.:link reftype=hd res=99995.Merge:elink.:ehp6. lets you merge
     100several files together into a single file (you get to set the order of
     101the files to be merged and the name of the file to which they're
     102merged). :artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\fldr.bmp'.
     103:p.
     104:hp6.WPS Copy:ehp6. and :hp6.WPS Move:ehp6. work like their standard
     105counterparts, except that WPS techniques are used. There is more
     106overhead using this method, so only use it when you need it -- for
     107example, when moving a directory containing a program suite to
     108maintain the link between program objects and the program executables
     109in the directory. :artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\fldr.bmp'.
     110:p.
     111:artwork name='..\..\bitmaps\view.bmp' align=center.
     112:p.
    52113The :hp6.View:ehp6. conditional cascade submenu allows you to view the
    53 current object.  Since this is a conditional cascade submenu, you can
     114current object. Since this is a conditional cascade submenu, you can
    54115click on the button to get a list of choices or click elsewhere to get
    55116a default viewing action (noted below).
     117:artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\fldr.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
    56118:p.
    57119:hp6.Autoview:ehp6. views objects through the :link reftype=hd
    58 res=92200.configured viewer:elink..  This is the default for the
     120res=92200.configured viewer:elink.. This is the default for the
    59121Files->View conditional cascade submenu when a file is the current
    60 object.  When you select Autoview, FM/2 guesses whether the file is text
     122object. When you select Autoview, FM/2 guesses whether the file is text
    61123or binary data and views it accordingly.
     124:artwork runin name='\bitmaps\file.bmp'.
    62125:p.
    63126:hp6.as text:ehp6. causes FM/2 to view the current file object as text,
    64127using the :link reftype=hd res=97000.configured text viewer:elink. or
    65128the internal if none is configured.
     129:artwork runin name='\bitmaps\file.bmp'.
    66130:p.
    67131:hp6.as binary:ehp6. causes FM/2 to view the current file object as
    68132binary data, using the :link reftype=hd res=97000.configured binary
    69 viewer:elink. or the internal if none is configured.  Binary data is
     133viewer:elink. or the internal if none is configured. Binary data is
    70134usually viewed as a :link reftype=hd res=98800.hex dump:elink..
     135:artwork runin name='\bitmaps\file.bmp'.
     136:hp6.as archive:ehp6. causes FM/2 to open the file in the :link reftype=hd
     137res=90200.Archive Container:elink. :artwork runin name='\bitmaps\file.bmp'.
     138(only works for archive file types where the underlying program (i.e. Infozip for .zip files)
     139is defined in archiver.bb2 and the program is in the system path.)
     140:artwork runin name='\bitmaps\file.bmp'.
     141:p.
    71142:artwork name='..\..\bitmaps\info.bmp' align=center.
     143:p.
    72144:hp6.Information:ehp6. brings up a dialog telling you everything you
    73145ever wanted to know about file system objects but were afraid to ask.
     
    77149Otherwise, you get a :link reftype=hd res=95700.comprehensive
    78150dialog:elink. that, besides showing you all the pertinent information
    79 about the object, shows the object's icon. That icon is important.  You
     151about the object, shows the object's icon. That icon is important. You
    80152can get a context menu on it, and you can drag other objects onto it to
    81 change the object's icon.  If the object is an icon or pointer file
     153change the object's icon. If the object is an icon or pointer file
    82154(*.ICO or *.PTR) you can use it to :link reftype=hd res=95500.change a
    83155system pointer:elink. (for instance, you could change OS/2's usual arrow
    84 pointer to a finger).  You can draw pointers yourself using OS/2's
     156pointer to a finger). You can draw pointers yourself using OS/2's
    85157ICONEDIT program, or find them pre-drawn in several collections of icons
    86 and pointers freely available on BBSes. This is the default command for
     158and pointers freely available on the internet. This is the default command for
    87159the Files->View conditional cascade submenu when the current object is a
    88 directory.
     160directory. (Note: Info is the first item on the drives menu)
     161:artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
     162:p.
     163:hp6.Quick Tree:ehp6. appears in Directory Containers. You can use this
     164to quickly select a subdirectory into which to switch the Directory
     165Container. Obviously, if there are no subdirectories to select from,
     166FM/2 will ignore this command except to tell you.
     167:artwork runin name='\bitmaps\fldr.bmp'.
     168:p.
     169:hp6.Update objects:ehp6. updates objects by refreshing the information
     170FM/2 has on them from disk to make sure it's current (an alternative to
     171rescan for special situations).
     172:artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\fldr.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
     173:p.
     174:hp6.Hide objects:ehp6. hides objects (removes them from view in the
     175container) until you rescan, use the :link reftype=hd res=93400.Filter
     176dialog:elink. or switch directories.
     177:artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\fldr.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
     178:p.
    89179:artwork name='..\..\bitmaps\playmm.bmp' align=center.
     180:p.
    90181:hp6.Multimedia:ehp6. attempts to play the objects via MMPM/2 using
    91182FM2PLAY.EXE (from the FM/2 Utilities collection, distributed separately
    92 in FM2UTILS.ZIP).  Obviously, the objects must be multimedia objects
     183in FM2UTILS.ZIP). Obviously, the objects must be multimedia objects
    93184(sound files, movies, midi files, etc.) for this to have the desired
    94 effect, and MMPM/2 must be installed in your system.  Note:  for this
     185effect, and MMPM/2 must be installed in your system. Note:  for this
    95186command to work properly with large numbers of files (where the length
    96187of the resultant command line would exceed the OS/2 command line length
     
    98189supports the /# command line switch. To test your version of
    99190FM2PLAY.EXE, run FM2PLAY /? and see if /# is listed as a supported
    100 switch.  If not, upgrade to a new version of the FM/2 Utilities.
    101 :p.
    102 :hp6.Update objects:ehp6. updates objects by refreshing the information
    103 FM/2 has on them from disk to make sure it's current (an alternative to
    104 rescan for special situations).
    105 :p.
    106 :hp6.Hide objects:ehp6. hides objects (removes them from view in the
    107 container) until you rescan, use the :link reftype=hd res=93400.Filter
    108 dialog:elink. or switch directories.
     191switch. If not, upgrade to a new version of the FM/2 Utilities.
     192:artwork runin name='\bitmaps\file.bmp'.
    109193:p.
    110194:artwork name='..\..\bitmaps\edit.bmp' align=center.
     195:p.
    111196The :hp6.Edit:ehp6. conditional cascade submenu allows you to edit the
    112 current object.  Since this is a conditional cascade submenu, you can
     197current object. Since this is a conditional cascade submenu, you can
    113198click on the button to get a list of choices or click elsewhere to get a
    114199default editing action (noted below).
     200:artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\fldr.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
    115201:p.
    116202:hp6.Autoedit:ehp6. edits objects through the :link reftype=hd
    117 res=92200.configured editor:elink..  This is the default for the
     203res=92200.configured editor:elink.. This is the default for the
    118204Files->Edit conditional cascade submenu when a file is the current
    119 object.  When you select Autoedit, FM/2 guesses whether the file is text
    120 or binary data and edits it accordingly.
     205object. When you select Autoedit, FM/2 guesses whether the file is text
     206or binary data and edits it accordingly.
     207:artwork runin name='\bitmaps\file.bmp'.
    121208:p.
    122209:hp6.as text:ehp6. causes FM/2 to edit the current file object as text,
    123210using the :link reftype=hd res=97000.configured text editor:elink. or
    124211the internal if none is configured.
     212:artwork runin name='\bitmaps\file.bmp'.
    125213:p.
    126214:hp6.as binary:ehp6. causes FM/2 to edit the current file object as
    127215binary data, using the :link reftype=hd res=97000.configured binary
    128 editor:elink..  Binary data is usually edited as a :link reftype=hd
    129 res=98800.hex dump:elink..  No default binary editor is provided at
     216editor:elink.. Binary data is usually edited as a :link reftype=hd
     217res=98800.hex dump:elink.. No default binary editor is provided at
    130218this time, but that may change.
    131 :artwork name='..\..\bitmaps\ea.bmp' align=center.
    132 :hp6.:link reftype=hd res=95000.Extended Attributes:elink.:ehp6. allows
    133 you to view an object's extended attributes (EAs) and to edit and add
    134 text attributes.
     219:artwork runin name='\bitmaps\file.bmp'.
     220:p.
     221Edit :link reftype=hd res=99980.Drive flags:elink. is found on the drives context
     222menu. :artwork runin name='\bitmaps\drive.bmp'.
     223:p.
    135224:artwork name='..\..\bitmaps\attrlist.bmp' align=center.
     225:p.
    136226:hp6.:link reftype=hd res=95900.Attributes:elink.:ehp6. leads to a
    137227dialog that sets objects' attributes and (optionally) date/time. This is
    138228the default for the Files->Edit conditional cascade submenu when a
    139229directory is the current object.
    140 :p.
    141 :hp6.Subject:ehp6. allows you to give an object a description.  This
     230:artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\fldr.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
     231:p.
     232:artwork name='..\..\bitmaps\ea.bmp' align=center.
     233:p.
     234:hp6.:link reftype=hd res=95000.Extended Attributes:elink.:ehp6. allows
     235you to view an object's extended attributes (EAs) and to edit and add
     236text attributes.
     237:artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\fldr.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
     238:p.
     239:hp6.Subject:ehp6. allows you to give an object a description. This
    142240makes use of the same EA (.SUBJECT) that the WPS uses for object
    143241descriptions -- you can see and edit it on the File page of an object's
    144242Settings notebook.
    145 :artwork name='..\..\bitmaps\rename.bmp' align=center.
    146 :hp6.:link reftype=hd res=91400.Rename:elink.:ehp6. allows you to rename
    147 objects.  You are notified of conflicts as they occur.  An easier method
    148 for renaming one object is to point at its text, hold down the ALT key,
    149 and click mouse button one; however, this command allows you to use
    150 wildcards when renaming if you desire.
     243:artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\fldr.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
     244:p.
     245:artwork name='..\..\bitmaps\print.bmp' align=center.
     246:p.
     247:link reftype=hd res=99985.:hp6.Print:ehp6.:elink. prints text files.
     248It'd be a good idea to have a printer to which to print, and have
     249configured it first, before trying to use this. If using the standard
     250WPS, be sure you have a printer object configured for the device you've
     251told FM/2 to use, or you may wind up with FM/2's printing thread blocked
     252for eternity awaiting access to a nonexistent or inaccessible device.
     253Actually, if using the standard WPS, it's recommended that you simply
     254drag files to the printer object and drop them instead of using this
     255command. :artwork runin name='\bitmaps\file.bmp'.
     256:p.
     257:artwork name='..\..\bitmaps\opend.bmp' align=center.
     258:p.
     259The :hp6.Open:ehp6. conditional cascade submenu allows you to open the
     260current object. Since this is a conditional cascade submenu, you can
     261click on the button to get a list of choices or click elsewhere to get a
     262default open action for files is to either run them (executable files) or open them
     263based on their file association. :artwork runin name='\bitmaps\file.bmp'.
     264:artwork runin name='\bitmaps\fldr.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
     265:p.
     266The :hp6.Settings notebook:ehp6. option opens the object's WPS properties notebooks.
     267:artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\fldr.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
     268:p.
     269Open a directory or drive as a WPS Folder in either :hp6.icon, details or tree:ehp6. view
     270:artwork runin name='\bitmaps\fldr.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
     271:p.
     272Open a new FM/2 window (container; the default for directories and drives).
     273:artwork runin name='\bitmaps\fldr.bmp'. :artwork runin name='\bitmaps\drive.bmp'. 
     274:p.
     275Opening a file's Default view will honor any OS/2 associations that you have
     276setup. Remember that F6 or Ctrl + double-click opens an object's
     277default WPS view, and Ctrl + Shift + double-click opens an object's
     278WPS Settings notebook.
     279:p.
     280:artwork name='..\..\bitmaps\object.bmp' align=center.
     281:artwork name='..\..\bitmaps\shadow.bmp' align=center.
     282:p.
     283Next is a conditional cascade submenu called :hp6.Create Objects:ehp6.,
     284with Shadows as the default command. Create shadows appears as a
     285a top level menu item on the drives object menu.
     286:artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
     287:p.
     288:hp6.:link reftype=hd res=93600.Shadow:elink.:ehp6. builds WPS shadow
     289objects on your desktop or :hp6.Shadows in folders:ehp6. for selected
     290object(s). :artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
     291:p.
     292You can also create :hp6.Real Objects:ehp6. for files
     293:artwork runin name='\bitmaps\file.bmp'.
     294:p.
     295The save lists submenu allows you to save lists to the clipboard or a file
     296:p.
     297:artwork name='..\..\bitmaps\saveclip.bmp' align=center.
     298:p.
     299:hp6.Save/Append to clipboard:ehp6. allows you to save selected objects to the
     300clipboard as a text list, one per line. This is a good way to transfer
     301selections of files to other programs; for instance, you might copy a
     302list of files to the clipboard and feed it to a terminal program to send
     303the files over a modem or network.
     304:artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\fldr.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
     305:p.
     306:artwork name='..\..\bitmaps\savelist.bmp' align=center.
     307:p.
     308:hp6.:link reftype=hd res=96000.Save to list file:elink.:ehp6. lets you
     309save selected objects as a list to a text file. Lists can include file
     310sizes, subjects, etc.
     311:artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\fldr.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
     312:p.
     313:artwork name='..\..\bitmaps\collect.bmp' align=center.
     314:p.
     315:hp6.Collect File(s):ehp6. calls up the :link reftype=hd
     316res=90100.Collector:elink. and places the selected files and directories
     317into it. You can also open the Collector and drag things into it.
     318:artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\fldr.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
     319:p.
     320:hp6.Collect List in file(s):ehp6. collects the files listed inside the
     321selected files (see :hp6.Save to list file:ehp6. above). The filename
     322should be the first item on each line of the list. If spaces are
     323contained in the filenames, enclose the filenames in "quote marks."
     324Filenames must be full pathnames (d&colon.\path\filename). Directories as
     325well as files can be Collected. :artwork runin name='\bitmaps\file.bmp'.
     326:p.
     327:artwork name='..\..\bitmaps\archive.bmp' align=center.
     328:p.
     329:hp6.:link reftype=hd res=90300.Archive:elink.:ehp6. allows you to build
     330an archive containing the selected object(s).
     331:artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\fldr.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
     332:p.
     333:artwork name='..\..\bitmaps\extract.bmp' align=center.
     334:p.
     335:hp6.:link reftype=hd res=91000.Extract:elink.:ehp6. allows you to
     336extract files from selected archives. :artwork runin name='\bitmaps\file.bmp'.
     337:p.
     338:hp6.UUDecode:ehp6. decodes files that were encoded with UUEncode, a
     339common protocol on the Internet. Files created by UUDecoding are
     340appended if they already exist. :artwork runin name='\bitmaps\file.bmp'.
     341:p.
    151342:artwork name='..\..\bitmaps\delete.bmp' align=center.
    152 :hp6.Delete:ehp6. deletes objects.  If the :link reftype=hd
     343:p.
     344:hp6.Delete:ehp6. deletes objects. If the :link reftype=hd
    153345res=92400.Confirm Delete:elink. toggle is on or one or more directories
    154346are among the selected objects, you get a dialog showing the selected
    155347objects and asking you to confirm that you really meant what you said.
    156 In that dialog you have a chance to remove some of the objects.  If you
    157 have Undelete enabled for the drive on which the objects reside, they
    158 may be recoverable.
     348In that dialog you have a chance to remove some of the objects. If you
     349have OS/2's Undelete enabled for the drive on which the objects reside, they
     350may be recoverable. :artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\fldr.bmp'.
     351:p.
    159352:artwork name='..\..\bitmaps\permdel.bmp' align=center.
     353:p.
    160354:hp6.Permanent Delete:ehp6. deletes objects as above, but they will not
    161 be recoverable (which may make the deletion faster).  It should be noted
     355be recoverable (which may make the deletion faster). It should be noted
    162356that when deleting directory objects, the file objects within the
    163357directory can never be recovered, but deleting all the file objects
     
    167361:link reftype=launch object='CMD.EXE' data='/C HELP UNDELETE'.HELP
    168362UNDELETE:elink. at a command line for more information on enabling
    169 Undelete).
    170 :artwork name='..\..\bitmaps\print.bmp' align=center.
    171 :link reftype=hd res=99985.:hp6.Print:ehp6.:elink. prints text files.
    172 It'd be a good idea to have a printer to which to print, and have
    173 configured it first, before trying to use this.  If using the standard
    174 WPS, be sure you have a printer object configured for the device you've
    175 told FM/2 to use, or you may wind up with FM/2's printing thread blocked
    176 for eternity awaiting access to a nonexistent or inaccessible device.
    177 Actually, if using the standard WPS, it's recommended that you simply
    178 drag files to the printer object and drop them instead of using this
    179 command.
    180 :artwork name='..\..\bitmaps\mover.bmp' align=center.
    181 :artwork name='..\..\bitmaps\copier.bmp' align=center.
    182 :hp6.Move and Copy:ehp6. move or copy objects.  :hp2.:link reftype=hd
    183 res=90000.Drag and drop:elink. is recommended over using the menu
    184 commands for moving and copying.:ehp2. When using the menu commands, the
    185 :link reftype=hd res=91500.Walk Directories:elink. dialog appears to allow
    186 you to select a target directory.
    187 :p.
    188 :hp6.Copy and rename:ehp6. and :hp6.Move and rename:ehp6. allow you to
    189 change the names of the destination files as you copy and move using
    190 the standard rename dialog.  You can also copy or move with wildcarding,
    191 like you can from the command line (COPY thisfile.txt *.bak) by using
    192 wildcards in the filename portion of the destination.
    193 :p.
    194 :hp6.Copy and preserve:ehp6. and :hp6.Move and preserve:ehp6. are only
    195 available in the Collector and See all files windows.  These commands
    196 copy or move the selected files but preserve the directory relationship
    197 of the files.  The effect of this can be non-obvious, so use with care.
    198 :p.
    199 Let's say you select three files&colon. G&colon.\FOO\BAR\DUDE,
    200 G&colon.\FOO\BAR\WOW\DUDE and G&colon.\FOO\BAR\RUFF\DUDE.  If you select
    201 :hp1.Copy and preserve:ehp1. and pick a destination directory of
    202 H&colon.\HERE, the resultant files will be H&colon.\HERE\DUDE,
    203 H&colon.\HERE\WOW\DUDE and H&colon.\HERE\RUFF\DUDE.
    204 :p.
    205 Note that drives are not considered when preserving directory
    206 relationships, so if one of our three files above resided on drive
    207 F&colon., the results would be the same.
    208 :p.
    209 :hp6.:link reftype=hd res=99995.Merge:elink.:ehp6. lets you merge
    210 several files together into a single file (you get to set the order of
    211 the files to be merged and the name of the file to which they're
    212 merged).
    213 :p.
    214 :hp6.WPS Copy:ehp6. and :hp6.WPS Move:ehp6. work like their standard
    215 counterparts, except that WPS techniques are used.  There is more
    216 overhead using this method, so only use it when you need it -- for
    217 example, when moving a directory containing a program suite to
    218 maintain the link between program objects and the program executables
    219 in the directory.
    220 
    221 :artwork name='..\..\bitmaps\shadow.bmp' align=center.
    222 :artwork name='..\..\bitmaps\object.bmp' align=center.
    223 :hp6.:link reftype=hd res=93600.Shadow:elink.:ehp6. builds WPS shadow
    224 objects on your desktop (or other selected folder) for selected
    225 object(s).  You can also create :hp6.Real Objects:ehp6. (except for
    226 directories, for which you can only create shadow objects).  Both these
    227 options (where applicable) are in a conditional cascade submenu called
    228 :hp6.Create Objects:ehp6., with Shadows as the default command.
    229 :artwork name='..\..\bitmaps\opend.bmp' align=center.
    230 The :hp6.Open:ehp6. conditional cascade submenu allows you to open an
    231 object's Settings notebook, open directories as WPS Folders, or open a
    232 new FM/2 Directory Container window for directories (the default for
    233 directories).  Note that when WPS Folders are opened, they come up in
    234 the background.  This is an OS/2 bug, and IBM has been notified. Opening
    235 a file's Default view will honor any OS/2 associations that you have
    236 setup.  Remember that F6 or Ctrl + double-click opens an object's
    237 default WPS view, and Ctrl + Shift + double-click opens an object's
    238 WPS Settings notebook.
    239 :artwork name='..\..\bitmaps\archive.bmp' align=center.
    240 :hp6.:link reftype=hd res=90300.Archive:elink.:ehp6. allows you to build
    241 an archive containing the selected object(s).
    242 :artwork name='..\..\bitmaps\extract.bmp' align=center.
    243 :hp6.:link reftype=hd res=91000.Extract:elink.:ehp6. allows you to
    244 extract files from selected archives.
    245 :p.
    246 :hp6.UUDecode:ehp6. decodes files that were encoded with UUEncode, a
    247 common protocol on the Internet.  Files created by UUDecoding are
    248 appended if they already exist.
    249 :artwork name='..\..\bitmaps\saveclip.bmp' align=center.
    250 :hp6.Save to clipboard:ehp6. allows you to save selected objects to the
    251 clipboard as a text list, one per line.  This is a good way to transfer
    252 selections of files to other programs; for instance, you might copy a
    253 list of files to the clipboard and feed it to a terminal program to send
    254 the files over a modem or network.
    255 :artwork name='..\..\bitmaps\savelist.bmp' align=center.
    256 :hp6.:link reftype=hd res=96000.Save to list file:elink.:ehp6. lets you
    257 save selected objects as a list to a text file.  Lists can include file
    258 sizes, subjects, etc.
    259 :p.
    260 :artwork name='..\..\bitmaps\collect.bmp' align=center.
    261 :hp6.Collect File(s):ehp6. calls up the :link reftype=hd
    262 res=90100.Collector:elink. and places the selected files and directories
    263 into it.  You can also open the Collector and drag things into it.
    264 :p.
    265 :hp6.Collect List in file(s):ehp6. collects the files listed inside the
    266 selected files (see :hp6.Save to list file:ehp6. above).  The filename
    267 should be the first item on each line of the list.  If spaces are
    268 contained in the filenames, enclose the filenames in "quote marks."
    269 Filenames must be full pathnames (d&colon.\path\filename).  Directories as
    270 well as files can be Collected.
    271 :p.
    272 :hp6.Quick Tree:ehp6. appears in Directory Containers.  You can use this
    273 to quickly select a subdirectory into which to switch the Directory
    274 Container.  Obviously, if there are no subdirectories to select from,
    275 FM/2 will ignore this command except to tell you.
     363Undelete). :artwork runin name='\bitmaps\file.bmp'. :artwork runin name='\bitmaps\fldr.bmp'.
     364:p.
     365:artwork name='..\..\bitmaps\rescan.bmp' align=center.
     366:p.
     367:hp6.Rescan:ehp6. rescans the selected drive. FM/2 tries
     368very hard to keep all its windows up to date, but things outside FM/2
     369can cause changes that FM/2 cannot know about automatically. This
     370command will ensure that your display is current.
     371:artwork runin name='\bitmaps\drive.bmp'.
     372:p.
     373:hp6.Expand:ehp6. expands the tree from the point where the context menu
     374was requested to the bottom of the branch. This isn't the same as clicking
     375the [+] symbol as it expands :hp1.all:ehp1. branches.   
     376:artwork runin name='\bitmaps\drive.bmp'.
     377:p.
     378:hp6.Collapse:ehp6. collapses the tree from the point where the context
     379menu was requested to the bottom of the branch. This isn't the same as
     380clicking the [-] symbol as it collapses :hp1.all:ehp1. branches.
     381:artwork runin name='\bitmaps\drive.bmp'.
     382:p.
     383The Miscellaneous cascade menu appears on directory and drive context menus
     384The following appear on this cascade.
     385:p.
     386:hp6.:link reftype=hd res=95200.Sizes:elink.:ehp6. brings up a dialog
     387showing how many bytes are in the selected directory and its
     388subdirectories. :artwork runin name='\bitmaps\fldr.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
     389:p.
     390:artwork name='..\..\bitmaps\mkdir.bmp' align=center.
     391:p.
     392:hp6.Make Directory:ehp6. allows you to create new directories. The
     393name of the directory where you requested the context menu is filled in
     394as a starting point for convenience. Directories may be created many
     395levels deep in one pass.
     396:artwork runin name='\bitmaps\fldr.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
     397:p.
     398:hp6.Show all files:ehp6. is a command available on drive and directory objects
     399and in the container menu of Directory Containers. It invokes the
     400:link reftype=hd res=98500.See all files:elink. window and shows all
     401the files in the directory and all its subdirectories.
     402:artwork runin name='\bitmaps\fldr.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
     403:p.
     404:hp6.:link reftype=hd res=92500.Undelete Files:elink.:ehp6.
     405:artwork runin name='\bitmaps\fldr.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
     406:p.
     407:hp6.Check Disk:ehp6. runs PMCHKDSK.EXE on the selected drive. This
     408tests the drive and can correct some deficiencies. This is available
     409only in context menus requested on drives (root directories). Note
     410that OS/2 cannot correct defects on disks that are in use by the
     411system or programs (including FM/2). :artwork runin name='\bitmaps\drive.bmp'.
     412:p.
     413:hp6.Format Disk:ehp6. runs PMFORMAT.EXE on the selected drive.
     414:hp8.Formatting a disk will destroy any information already on the
     415disk.:ehp8. This is available only in context menus requested on drives
     416(root directories). :artwork runin name='\bitmaps\drive.bmp'.
     417:p.
     418:hp6.Optimize:ehp6. runs a .CMD file with the name <Filesystem>OPT.CMD,
     419giving the drive to optimize as a command line argument. Therefore, for
     420a FAT drive C&colon. "FATOPT.CMD C&colon." would be run (through the
     421command interpreter defined in %COMSPEC% or CMD.EXE if none is defined)
     422for an HPFS drive D&colon. "HPFSOPT.CMD D&colon." and for an JFS drive E&colon. "JFSOPT.CMD
     423E&colon.". CMD files are supplied with FM/2 that call utility programs from FM2UTILS.ZIP (a
     424separate collection of free-for-the-using utilities, sometimes named
     425FM2UTL.ZIP) or for JFS defragfs.exe supplied with OS2. You may modify these command files as required for your
     426system, even to call other programs than those supplied. Always be sure
     427to check the disk before trying to optimize it, and (in the case of the
     428FAT optimizer) it's a good idea to back up first. You shouldn't run the
     429FAT optimizer on compressed drives -- use the utilities that came with
     430your compression program instead. :artwork runin name='\bitmaps\drive.bmp'.
     431:p.
     432:hp6.Detach:ehp6. detaches a network drive.
     433:artwork runin name='\bitmaps\drive.bmp'.
     434:p.
     435:hp6.Eject:ehp6. ejects removable media from drives (for instance,
     436opens the door of a CD ROM drive).
     437:artwork runin name='\bitmaps\drive.bmp'.
     438:p.
     439:hp6.Lock:ehp6. locks a removable drive.
     440:artwork runin name='\bitmaps\drive.bmp'.
     441:p.
     442:hp6.Unlock:ehp6. unlocks a removable drive.
     443:artwork runin name='\bitmaps\drive.bmp'.
     444:p.
     445:hp6.:link reftype=hd res=90900.Drive Info:elink.:ehp6. is the first menu item on the drives
     446context menu. :artwork runin name='\bitmaps\drive.bmp'.
    276447
    277448:h2 res=93710 name=PANEL_CONTEXTCNR.Context menus affecting containers
     
    287458appears beside its icon.
    288459:p.
    289 :hp6.Text:ehp6. switches the container to Text view.  Text view is the
     460:hp6.Text:ehp6. switches the container to Text view. Text view is the
    290461fastest view for a container to maintain, but provides the least
    291462information on the objects it contains.
    292463:p.
    293 :hp6.Details:ehp6. switches the container to Details view.  Details view
     464:hp6.Details:ehp6. switches the container to Details view. Details view
    294465shows a great deal of information on the objects it contains, including
    295466file sizes, dates, and times, but it is the slowest view for a container
    296467to maintain.
    297468:p.
     469The :hp6.Details Setup:ehp6. submenu allows you to control what is shown
     470in a Details view. Each possible field in the details view for the drive
     471type is shown. If the field is checked, FM/2 will show it. If not, it
     472won't. Set the current view to Details view and you can see the changes
     473as they occur. Note that for Directory Containers, the context menu
     474items change the current container only. Use the internal :link
     475reftype=hd res=94600.Settings notebook:elink. to change the default for
     476subsequently created containers.
     477:p.
    298478:hp6.Mini Icons:ehp6. is a toggle controlling whether icons are shown
    299479full size or in miniature in views that show icons.
    300480:p.
    301 The :hp6.Details Setup:ehp6. submenu allows you to control what is shown
    302 in a Details view.  Each possible field in the details view for the drive
    303 type is shown.  If the field is checked, FM/2 will show it.  If not, it
    304 won't.  Set the current view to Details view and you can see the changes
    305 as they occur.  Note that for Directory Containers, the context menu
    306 items change the current container only.  Use the internal :link
    307 reftype=hd res=94600.Settings notebook:elink. to change the default for
     481:artwork name='..\..\bitmaps\filter.bmp' align=center.
     482:p.
     483:hp6.:link reftype=hd res=93400.Filter:elink.:ehp6. leads to a dialog
     484that lets you set filemasks and attributes for objects to include in the
     485container's display. Note:  For Directory Containers, this sets the
     486default for _this_ container. Use the internal :link reftype=hd
     487res=94600.Settings notebook:elink. to change the defaults for
    308488subsequently created containers.
    309 
    310 :artwork name='..\..\bitmaps\rescan.bmp' align=center.
    311 :hp6.Rescan:ehp6. rescans the directory associated with a container, or
    312 the drive from the current object down in a tree container.  FM/2 tries
    313 very hard to keep all its windows up to date, but things outside FM/2
    314 can cause changes that FM/2 cannot know about automatically.  This
    315 command will ensure that your display is current.
    316 :p.
    317 The :hp6.Sort submenu:ehp6. allows you to control how objects are sorted
    318 based on several criteria.  You can also tell FM/2 to always display
    319 directories ahead of or behind files.  Note that :hp1.Last access
    320 date:ehp1. and :hp1.Creation date:ehp1. are only meaningful for HPFS
    321 file systems; FAT file systems do not track this information.  The
    322 difference between :hp1.Pathname:ehp1. and :hp1.Filename:ehp1. is only
    323 apparent in the Collector.  With the former, the entire pathname of the
    324 object is used to sort.  With the latter, only the filename portion is
    325 used to sort.  FM/2 maintains separate sort criteria for Drive Tree,
    326 Collector, Directory Container and Archive Container windows.  See
    327 :link reftype=hd res=97200.Directory Container sort page:elink. and
    328 :link reftype=hd res=97400.Collector Container sort page:elink..  Note
    329 that Ctrl + F7 will call up the Sort menu for a given container.  The
    330 internal :link reftype=hd res=94600.Settings notebook:elink. can be
    331 used to set the default for subsequently opened Directory Containers --
    332 the context menu item sets the sort for _this_ container only.
    333 :p.
    334 :hp6.Resort:ehp6. resorts items in a container.  If you have more than
     489:p.
     490:hp6.Resort:ehp6. resorts items in a container. If you have more than
    335491one Directory or Archive Container window open, selecting a new sort
    336492type only causes the container in which you requested the context menu
    337493to resort itself (although the change will affect all future rescans,
    338 resorts and insertions in that type of container).  This command lets
     494resorts and insertions in that type of container). This command lets
    339495you resort a container so that the new sort type is reflected in the
    340496display.
    341 :artwork name='..\..\bitmaps\filter.bmp' align=center.
    342 :hp6.:link reftype=hd res=93400.Filter:elink.:ehp6. leads to a dialog
    343 that lets you set filemasks and attributes for objects to include in the
    344 container's display.  Note:  For Directory Containers, this sets the
    345 default for _this_ container. Use the internal :link reftype=hd
    346 res=94600.Settings notebook:elink. to change the defaults for
    347 subsequently created containers.
     497:p.
     498:artwork name='..\..\bitmaps\rescan.bmp' align=center.
     499:p.
     500:hp6.Rescan:ehp6. rescans the directory associated with a container, or
     501the drive from the current object down in a tree container. FM/2 tries
     502very hard to keep all its windows up to date, but things outside FM/2
     503can cause changes that FM/2 cannot know about automatically. This
     504command will ensure that your display is current.
    348505:p.
    349506:hp6.Parent:ehp6. moves directory containers to the previous (parent)
     
    353510directory. This is sort of like a one-step "undo" when you switch
    354511a container to look at a different directory.
     512:p.
    355513:artwork name='..\..\bitmaps\walk.bmp' align=center.
     514:p.
    356515:hp6.:link reftype=hd res=91500.Walk Directories:elink.:ehp6. leads to a
    357516dialog that lets you walk through your directory structures, or recall
     
    359518:p.
    360519:hp6.Show all files:ehp6. is a command available on directory objects
    361 and in the container menu of Directory Containers.  It invokes the
     520and in the container menu of Directory Containers. It invokes the
    362521:link reftype=hd res=98500.See all files:elink. window and shows all
    363 the files in the directory and all its subdirectories.
     522the files in the directory and all its subdirectories. (on submenu of miscellaneous)
     523:p.
     524:hp6.Find in drive tree:ehp6. hilites the directory the directory container is
     525looking into on the drive tree. (on submenu of miscellaneous)
     526:p.
    364527:artwork name='..\..\bitmaps\select.bmp' align=center.
     528:p.
    365529:artwork name='..\..\bitmaps\deselect.bmp' align=center.
     530:p.
    366531The :hp6.:link reftype=hd res=99100.Select:elink.:ehp6. submenu gives
    367 you many ways to highlight and unhighlight objects in a container.  This
     532you many ways to highlight and unhighlight objects in a container. This
    368533lets you quickly build sophisticated selection sets of objects upon
    369534which you can perform tasks.
     
    375540(highlight what isn't, unhighlight what is).
    376541:p.
     542The :hp6.Sort submenu:ehp6. allows you to control how objects are sorted
     543based on several criteria. You can also tell FM/2 to always display
     544directories ahead of or behind files. Note that :hp1.Last access
     545date:ehp1. and :hp1.Creation date:ehp1. are only meaningful for HPFS
     546file systems; FAT file systems do not track this information. The
     547difference between :hp1.Pathname:ehp1. and :hp1.Filename:ehp1. is only
     548apparent in the Collector. With the former, the entire pathname of the
     549object is used to sort. With the latter, only the filename portion is
     550used to sort. FM/2 maintains separate sort criteria for Drive Tree,
     551Collector, Directory Container and Archive Container windows. See
     552:link reftype=hd res=97200.Directory Container sort page:elink. and
     553:link reftype=hd res=97400.Collector Container sort page:elink.. Note
     554that Ctrl + F7 will call up the Sort menu for a given container. The
     555internal :link reftype=hd res=94600.Settings notebook:elink. can be
     556used to set the default for subsequently opened Directory Containers --
     557the context menu item sets the sort for _this_ container only.
     558:p.
    377559Finally, FM/2 offers a full set of :hp6.Compare Selection:ehp6. tools
    378560that let you select and deselect files based on how they compare to
    379561unfiltered files in all other open Directory Containers (available only
    380 in Directory Containers).  To give you an idea how this might be
     562in Directory Containers). To give you an idea how this might be
    381563helpful, imagine that you just hit the [Enter] key in the middle of
    382564typing a copy command, when you were reaching for the backslash key to
    383565complete a path. Before you realize what's happening and can hit Ctrl-C,
    384566you copied fifty files from a data directory to the root directory of
    385 your boot drive (you shoulda used FM/2! &colon.-).  Now you want to get rid of
    386 them, but you don't want to pick each one.  Open the data directory and
     567your boot drive (you shoulda used FM/2! &colon.-). Now you want to get rid of
     568them, but you don't want to pick each one. Open the data directory and
    387569the root, choose "Select if in all," then delete the selected files in
    388 the root directory.  You're done.
     570the root directory. You're done.
    389571:p.
    390572These powerful selection tools are where a file manager really outshines
    391 command line file management, so be sure to take a look at them.  Note
     573command line file management, so be sure to take a look at them. Note
    392574that Ctrl + F8 will call up the Select menu for a given container.
    393 
     575:p.
     576:hp6.:link reftype=hd res=100065.Set Target directory:elink.:ehp6. and
     577:hp6.:link reftype=hd res=94600.Settings notebook:elink.:ehp6. are also on this menu.
     578:p.
    394579:h2 res=93715 name=PANEL_CONTEXTTREE.Context menus affecting Drive Tree container
    395580:i1 id=aboutContextTree.Context menus affecting Drive Tree container
    396581
    397 :hp6.Expand:ehp6. expands the tree from the point where the context menu
    398 was requested to the bottom of the branch.  This isn't the same as clicking
    399 the [+] symbol as it expands :hp1.all:ehp1. branches.
    400 :p.
    401 :hp6.Collapse:ehp6. collapses the tree from the point where the context
    402 menu was requested to the bottom of the branch.  This isn't the same as
    403 clicking the [-] symbol as it collapses :hp1.all:ehp1. branches.
    404 :p.
    405 :hp6.Optimize:ehp6. runs a .CMD file with the name <Filesystem>OPT.CMD,
    406 giving the drive to optimize as a command line argument.  Therefore, for
    407 a FAT drive C&colon. "FATOPT.CMD C&colon." would be run (through the
    408 command interpreter defined in %COMSPEC% or CMD.EXE if none is defined)
    409 and for an HPFS drive D&colon. "HPFSOPT.CMD D&colon.".  CMD files are
    410 supplied with FM/2 that call utility programs from FM2UTILS.ZIP (a
    411 separate collection of free-for-the-using utilities, sometimes named
    412 FM2UTL.ZIP).  You may modify these command files as required for your
    413 system, even to call other programs than those supplied.  Always be sure
    414 to check the disk before trying to optimize it, and (in the case of the
    415 FAT optimizer) it's a good idea to back up first.  You shouldn't run the
    416 FAT optimizer on compressed drives -- use the utilities that came with
    417 your compression program instead.
    418 :p.
    419 :hp6.Check Disk:ehp6. runs PMCHKDSK.EXE on the selected drive.  This
    420 tests the drive and can correct some deficiencies.  This is available
    421 only in context menus requested on drives (root directories).  Note
    422 that OS/2 cannot correct defects on disks that are in use by the
    423 system or programs (including FM/2).
    424 :p.
    425 :hp6.Format Disk:ehp6. runs PMFORMAT.EXE on the selected drive.
    426 :hp8.Formatting a disk will destroy any information already on the
    427 disk.:ehp8. This is available only in context menus requested on drives
    428 (root directories).
    429 :artwork name='..\..\bitmaps\mkdir.bmp' align=center.
    430 :hp6.Make Directory:ehp6. allows you to create new directories.  The
    431 name of the directory where you requested the context menu is filled in
    432 as a starting point for convenience.  Directories may be created many
    433 levels deep in one pass.
    434 :p.
    435 :hp6.:link reftype=hd res=95200.Sizes:elink.:ehp6. brings up a dialog
    436 showing how many bytes are in the selected directory and its
    437 subdirectories.
    438 :p.
    439 :hp6.Eject:ehp6. ejects removable media from drives (for instance,
    440 opens the door of a CD ROM drive).
    441 :p.
    442 :hp6.Lock:ehp6. locks a removable drive.
    443 :p.
    444 :hp6.Unlock:ehp6. unlocks a removable drive.
     582This menu includes many of the choices found on the
     583:link reftype=hd res=93710.Context menus affecting containers:elink.
     584This menu lacks the :hp6.view:ehp6. options except for :hp6.mini icons:ehp6. and doesn't include
     585:hp6.select:ehp6., :hp6.filter:ehp6. or the :hp6.miscellaneous submenu:ehp6. items.
     586The additional items it contains are described below&colon.
     587:p.
     588:hp6.Toggle icons:ehp6 turns the icons on and off in the Drive Tree container.
     589:p.
     590:hp6.Open Directory Container:ehp6. is used for:link reftype=hd res=98900.Opening a Directory Container:elink.
     591:p.
     592To remap (attach) a remote server to a local drive letter, enter the
     593UNC server name in the entry field at the top center of this dialog,
     594then select the drive letter from the left (attach) listbox to which to
     595attach the server. Finally, click the :hp1.Attach:ehp1. button.
     596:p.
     597To detach a local drive letter from a remote server, select the
     598drive letter from the right (detach) listbox, then click the
     599:hp1.Detach:ehp1. button.
     600:p.
     601When you're through remapping drives, click :hp1.Done:ehp1..
     602:p.
     603According to IBM LAN Server documentation, a UNC name consists of a
     604double backslash, the name of the server, another backslash, and the
     605name of the resource&colon. \\servername\netname
     606:p.
     607Note that FM/2 saves the UNC names you enter in the listbox below the
     608entry field. You can recall these names later by clicking on them.
     609The :hp1.Delete:ehp1. button deletes the currently selected name from
     610the listbox, and the :hp1.Clear:ehp1. button removes all names from
     611the listbox. Names are added automatically. Up to 200 names can be
     612stored in this manner (kept on disk between sessions in a file named
     613RESOURCE.DAT).
    445614:p.
    446615:hp6.Partitions:ehp6. calls up :link reftype=launch object='CMD.EXE'
    447616data='/C HELP FDISKPM'.FDISKPM.EXE:elink. to allow you to modify the
    448 partitions on your hard drives.  :hp8.Extreme caution should be
     617partitions on your hard drives. :hp8.Extreme caution should be
    449618exercised; read the help!:ehp8.
    450619:p.
     
    463632:p.
    464633The :hp1.Save as:ehp1. entry field contains the name of the file to
    465 which the list will be saved.  The :hp1.Find:ehp1. button calls up a
    466 standard OS/2 open dialog to let you point and click at a file.  If the
    467 file exists, it will be appended.  :hp6.Hint&colon.:ehp6. You can enter
     634which the list will be saved. The :hp1.Find:ehp1. button calls up a
     635standard OS/2 open dialog to let you point and click at a file. If the
     636file exists, it will be appended. :hp6.Hint&colon.:ehp6. You can enter
    468637:hp1.PRN:ehp1. as the filename to print the list.
    469638:p.
     
    471640the :hp1.Add:ehp1. button to add the current pattern (the one in the
    472641entry field), and the :hp1.Del:ehp1. button to remove the currently
    473 highlighted pattern from the listbox).  You can select one of the
     642highlighted pattern from the listbox). You can select one of the
    474643patterns in the listbox to avoid retyping it (as you highlight a pattern
    475644in the listbox it'll appear in the entry field). The patterns are saved
     
    477646:p.
    478647The :hp1.Pattern:ehp1. entry field contains a pattern that will be used
    479 to format the list.  Metastrings may be used to cause parts of a file
    480 description to be written where desired (see below).  Also note that the
     648to format the list. Metastrings may be used to cause parts of a file
     649description to be written where desired (see below). Also note that the
    481650pattern is run through a :link reftype=hd res=99500.C-style escape
    482651encoder:elink., so that \x1b would be interpreted as an ESCAPE
     
    485654:p.
    486655When everything's set as you want it, click :hp1.Okay:ehp1. to save the
    487 list.  Click :hp1.Cancel:ehp1. if you change your mind.
     656list. Click :hp1.Cancel:ehp1. if you change your mind.
    488657:p.
    489658Metastrings and their meanings (note&colon. these are different from those
     
    524693:eparml.
    525694:p.
    526 Note that you can manipulate list files from REXX.  An EXAMPLE.CMD is
    527 included in the FM/2 archive to show you how it's done.  REXX scripts
     695Note that you can manipulate list files from REXX. An EXAMPLE.CMD is
     696included in the FM/2 archive to show you how it's done. REXX scripts
    528697written in this manner can be effectively used as Commands.
     698:p.
     699:h2 res=92500 name=PANEL_UNDELETE.Undelete Files
     700:i1 id=aboutUndelete.Undelete Files
     701
     702:artwork name='..\..\bitmaps\undelete.bmp' align=center.
     703:p.
     704This leads to a dialog that interfaces with UNDELETE.COM to allow you to
     705undelete files. The drive that will be operated on is determined by the
     706highlighted object in the directory tree. This dialog filters out files
     707that already exist on the disk. This only works if OS/2's del directories
     708have been designated in config.sys. It doesn't interact with "Trashcans" 
     709:p.
     710The :hp1.Mask:ehp1. entry field lets you set a mask (which can include
     711a directory path). You can switch drives using the dropdown listbox.
     712A :hp1.Subdirs:ehp1. button lets you choose whether to show files that
     713can be undeleted in subdirectories as well.
     714:p.
     715You can always go directly to UNDELETE.COM if you have the need for more
     716control. This is provided only for convenience.
     717:artwork runin name='\bitmaps\fldr.bmp'. :artwork runin name='\bitmaps\drive.bmp'.
    529718.br
    530719
  • trunk/dll/ipf/databar.ipf

    r2 r268  
    77:p.
    88In addition, the databar can optionally show the free drive space on all
    9 local fixed drives (and, optionally, remote drives).  To force a drive's
     9local fixed drives (and, optionally, remote drives). To force a drive's
    1010information bar to be updated immediately, click it once with B1. The
    1111drive information is presented in both text and as a colored bar showing
    12 the amount of free space in relation to the total drive's size.  The
     12the amount of free space in relation to the total drive's size. The
    1313bar is usually green, but will turn blue and then red as space decreases.
    1414When a bar is red, it's probably time to do some archiving to get more
    15 free space on it (less than 10% of the drive remains free).  Double-click
     15free space on it (less than 10% of the drive remains free). Double-click
    1616if running the Databar free-standing to open a VDir for the drive.
    1717:p.
    1818The swapper information includes the size of the swapfile, in kilobytes,
    1919and the amount of free space on the drive holding the swapfile, again,
    20 in kilobytes.  Double-click to open the Undelete program. The memory
     20in kilobytes. Double-click to open the Undelete program. The memory
    2121information includes the amount of free physical memory and total free
    2222memory (including available swapspace), also in kilobytes.
     
    2828other information is updated about once every ten to sixty seconds. For
    2929about six seconds of every minute the time/date field displays the
    30 elapsed system time (how long the system's been up).  You can click the
     30elapsed system time (how long the system's been up). You can click the
    3131time/date field with B1 to cause this info to show up briefly at any
    3232time, or double-click to open the System Clock's Settings window to
     
    3535:p.
    3636You can move the databar by clicking and holding B1 on the databar and
    37 dragging it.  You can request a context menu on the date/time window to
    38 adjust some other items.  Double-clicking the databar anywhere but on
     37dragging it. You can request a context menu on the date/time window to
     38adjust some other items. Double-clicking the databar anywhere but on
    3939the bottom four fields with B1 will close it and restore FM/2 if you're
    40 not running the DATABAR.EXE miniapp.  If you're running the miniapp, or
     40not running the DATABAR.EXE miniapp. If you're running the miniapp, or
    4141just feel like it, request a context menu on the databar and click the
    42 :hp1.Close Window:ehp1. command.  This context menu also lets you
     42:hp1.Close Window:ehp1. command. This context menu also lets you
    4343configure the databar (if drives are displayed, if it floats to the top
    4444of other windows, etc.).
  • trunk/dll/ipf/dirsize.ipf

    r233 r268  
    1616:i1 id=aboutTotals.Total size of directories
    1717This dialog's container contains a breakdown of disk usage for a
    18 directory and its subdirectories.  The container is reached by selecting
     18directory and its subdirectories. The container is reached by selecting
    1919:hp1.Miscellaneous->Sizes:ehp1. from a tree directory's context menu or
    2020by running the :hp1.Dir Sizes:ehp1. program object from the FM/2 Tools
     
    2929numbers, as in&colon.
    3030:lines.
    31   ADIR  4096k + 8192k = 12288k (8.24%)
     31  ROOTDIR  4096KiB + 8192KiB = 12288KiB (8.24% of drive)
     32        ADIR 8192KiB + 0 = 8192KiB  (66.67%)
    3233:elines.
    3334:p.
     
    3637total number of kilobytes occupied by all subdirectories and any files and
    3738subdirectories they contain. The third number is the total of the first and second
    38 (addition performed in kilobytes). The
    39 percentage displayed for the first (parent) directory
    40 is the percentage of the used space the directory tree contains,
    41 in relation to the total used space on the drive. The percentages displayed
    42 for the other directories are
     39(addition performed in kilobytes). The percentage displayed for the root
     40directory or the highest level directory selected is the percentage of space
     41that directory tree contains relative to the total drive space.
     42The percentages displayed for the other directories are
    4343the percentage of the used space the directory tree contains, in relation
    44 to the entire displayed tree. A graph appears below the line displaying a
     44to the space used by the entire displayed tree. A graph appears below the line displaying a
    4545"picture" of this percentage.
    4646:p.
    47 FM/2 also color-codes the text describing the directory.  Black text
    48 indicates that something is below the directory.  Blue text indicates
     47FM/2 also color-codes the text describing the directory. Black text
     48indicates that something is below the directory. Blue text indicates
    4949that nothing is below the directory (note there may be subdirectories,
    50 but they are empty).  Grey text indicates that the directory is totally
    51 empty.
     50but they are empty). Gray text indicates that the directory contains
     51no files but may or may not contain subdirectories.
    5252:p.
    53 The :hp1.Expand:ehp1. and :hp1.Collapse:ehp1. buttons can take a noticable amount
     53The :hp1.Expand:ehp1. and :hp1.Collapse:ehp1. buttons can take a noticeable amount
    5454of time to process
    5555for large directory trees since each subdirectory must be processed.
     
    5858:p.
    5959The first (parent) item in the tree shows the percentage of the drive
    60 used by the entire tree.  This is noted in the parentheses containing
     60used by the entire tree. This is noted in the parentheses containing
    6161the percentage, and the graph for this item is green instead of red.
    6262:p.
    63 The totals reflect the size of files and extended attributes.  Due to
     63The totals reflect the size of files and extended attributes. Due to
    6464minimum allocation units on the disk, more space may be physically
    65 allocated than is accounted for in the totals.  The text field just
     65allocated than is accounted for in the totals. The text field just
    6666above the pushbuttons gives you stats that _do_ take allocation units
    67 into account, for the entire drive.  The actual byte counts
     67into account, for the entire drive. The actual byte counts
    6868are rounded up to the next kilobyte for display.
    69 The 0k figure denotes a directory with a truly 0 byte count.
     69The 0 figure denotes a directory with a truly 0 byte count.
    7070:p.
    7171You can double-click a directory to open it so you can see its files.
     
    7373This is a quick way to see where your disk space has gone.
    7474:p.
    75 :hp6.Hint&colon.:ehp6.  You can get a printout of this information by
    76 entering :hp1.PRN:ehp1. as the name of the :hp1.Save:ehp1. file.  The
     75:hp6.Hint&colon.:ehp6. You can get a printout of this information by
     76entering :hp1.PRN:ehp1. as the name of the :hp1.Save:ehp1. file. The
    7777information printed is the same as that visible in the container, which
    7878is to say that unexpanded branches aren't printed, so you can be
  • trunk/dll/ipf/drvinfo.ipf

    r10 r268  
    33
    44:artwork name='..\..\bitmaps\info.bmp' align=center.
     5:p.
    56FM/2 will show you information about the drive from which you chose the
    6 :hp1.Info:ehp1. command in a context menu.
     7:hp1.Info:ehp1. command in a context menu or files menu.
    78:p.
    8 For writeable drives, you can change the drive's :hp1.label:ehp1. here
     9For writable drives, you can change the drive's :hp1.label:ehp1. here
    910by changing the text in the entry field and clicking :hp1.Okay:ehp1..
    1011:p.
    1112The dialog box shows you the type of file system, volume label, total
    12 and available sizes of the drive (megabytes, kilobytes and units), tells
     13and available space on the drive (megabytes, kilobytes and units), tells
    1314you how the drive's resources are parceled into units, gives the drive's
    1415serial number and some :hp1.flags:ehp1..
     
    1617These flags indicate special properties about the drive, like
    1718:hp1.Removable:ehp1. (the drive allows its media to be removed and
    18 changed) or :hp1.Not Writeable:ehp1. (the drive does not allow changes
     19changed) or :hp1.Not Writable:ehp1. (the drive does not allow changes
    1920to be written to it).
    2021:p.
     
    2728flags:elink. command.
    2829
     30:h3 res=99980 name=PANEL_FLAGS.Drive flags
     31:i1 id=aboutFlags.Drive flags
     32
     33Here you can set flags for various drives. Command line switches
     34override these flags. The flags are stored in FM/2's INI file and
     35loaded when FM/2 starts, so this is an alternative to all the
     36esoteric drive command line switches :hp1.except:ehp1. the
     37:hp2.Ignore:ehp2. switch.
     38:p.
     39:hp6.No prescan:ehp6. Setting this causes FM/2 to :hp1.not:ehp1.
     40pre-scan removable drives. You have to double-click the drive
     41before it's checked to see if it has any subdirectories. This is
     42handy for those of you with CD carousels.
     43:p.
     44:hp6.Don't load icons:ehp6. Prevents FM/2 from loading icons for
     45files and directories on this drive. If the drive contains only
     46DOS programs and data files or is a very slow drive, you might
     47want to check this one.
     48:p.
     49:hp6.Don't load subjects:ehp6. Prevents .SUBJECT EAs from being
     50automatically loaded on this drive. Again, if your drive is slow or you
     51don't use .SUBJECTs with objects on this drive, you might want to check
     52it.
     53:p.
     54:hp6.Don't load longnames:ehp6. Prevents .LONGNAME EAs from being
     55automatically loaded on this drive. You've got the idea by now,
     56right?
     57:p.
     58:hp6.Slow drive:ehp6.. Check this for drives which have extremely slow
     59seek times (like ZIP and EZ removable hard drives). The Autoview window
     60and associated messages are disabled for this drive, and the "Quick Arc
     61find" method is always used, whether on globally or not, which snaps up
     62response time. I may take other shortcuts for drives with this attribute
     63later (loosen error checking). For such slow drives you may also want
     64to check the various :hp1.Don't load...:ehp1. flags listed above.
     65:p.
     66:hp6.Include files in tree:ehp6. If you check this, files will be shown
     67as well as directories in the Drive Tree for this drive. I have no
     68idea why you would ever want to check this.
     69:p.
     70You get this dialog by selecting Edit->Drive flags from a context menu
     71requested on a drive (root directory) in the Drive Tree or VTree window.
     72:p.
     73Note&colon. To set the drive flags on a removable drive, like a floppy
     74or CD-ROM, be sure you put a disk in the drive first. FM/2 won't let
     75you set drive flags on a currently invalid disk
     76
    2977:h2 res=95700 name=PANEL_INFO.Object Information
    3078:i1 id=aboutInfo.Object Information
    3179
    3280:artwork name='..\..\bitmaps\info.bmp' align=center.
     81:p.
    3382This comprehensive dialog tells you just about everything there is to
    34 know about file system objects.  If information is being displayed for
     83know about file system objects. If information is being displayed for
    3584more than one object, the objects may be scrolled through in the listbox
    36 at the top of the dialog.
     85at the top of the dialog. The dialog is accessed from :hp1.View->Info:ehp1.
     86of the objects context menu.
    3787:p.
    38 Note the object's icon is shown.  It's useable -- you can get a context
     88Note the object's icon is shown. It's usable -- you can get a context
    3989menu on it, or you can drag other objects onto it to change the object's
    4090icon.
    4191:p.
    4292You can edit an object's EAs or WPS Settings notebook (Properties) by
    43 clicking the appropriate button.  If you want to see inside a file,
     93clicking the appropriate button. If you want to see inside a file,
    4494double-click it in the listbox.
    4595:p.
    4696Click :hp1.Okay:ehp1. when you're through examining the objects.
     97
     98
  • trunk/dll/ipf/eas.ipf

    r10 r268  
    22:i1 id=aboutEAs.Extended Attributes
    33:artwork name='..\..\bitmaps\ea.bmp' align=center.
     4:p.
    45This dialog allows you to view and edit text Extended Attributes (EAs)
    5 for an object.  Binary EAs may be viewed but not edited. You'd have to
     6for an object. Binary EAs may be viewed but not edited. You'd have to
    67be the sort who enjoys programming on a hex keypad to :hp2.want:ehp2. to
    78edit a binary EA...
     
    1314:p.
    1415:hp1.Multi-value single-type EAs:ehp1. are shown in an MLE control if
    15 the type is text.  Each line represents one 'record' of the EA.
     16the type is text. Each line represents one 'record' of the EA.
    1617:p.
    17 :hp1.Multi-value mult-type EAs:ehp1. are also shown in an MLE control
    18 if all types are text.  Each line represents one 'record' of the EA.
     18:hp1.Multi-value multi-type EAs:ehp1. are also shown in an MLE control
     19if all types are text. Each line represents one 'record' of the EA.
    1920:p.
    2021In general, if you don't know the purpose of an EA you shouldn't change
    21 it.  In particular, EA names beginning with a period (i.e. .TYPE), as
    22 these EAs are used by the WPS.  An exception is the .SUBJECT EA, for
    23 which FM/2 provides a special context menu item.  This EA is used to
    24 store a simple text description of an object.  FM/2's details views can
     22it. In particular, EA names beginning with a period (i.e. .TYPE), since
     23these EAs are used by the WPS. An exception is the .SUBJECT EA, for
     24which FM/2 provides a special context menu item. This EA is used to
     25store a simple text description of an object. FM/2's details views can
    2526show this description and allow you to direct-edit it.
    2627:p.
     
    4041See :link reftype=launch object='CMD.EXE' data='/C HELP
    4142EAUTIL'.EAUTIL:elink. in OS/2's Command Reference for more information
    42 on EAs and how to manipulate them.  Note that this dialog is not meant
     43on EAs and how to manipulate them. Note that this dialog is not meant
    4344to be a full-featured super-powerful EA editor (though it does a decent
    4445job with text EAs and beats the pants off what comes with other file
    45 managers -- if anything at all comes with them, that is).  You can use
     46managers -- if anything at all comes with them, that is). You can use
    4647:hp1.Config->Edit Commands:ehp1. to add such an external EA editor to a
    4748list of commands that you can run on selected files, if desired.
     
    5051:i1 id=aboutADDEA.Adding an Extended Attribute
    5152To add an extended attribute (EA), enter its name in the top entry
    52 field, then select a type for it from the radio buttons.  Click Okay to
     53field, then select a type for it from the radio buttons. Click Okay to
    5354create it, Cancel to abort.
    5455:p.
    55 OS/2 defines several Standard Extended Attributes (SEAs):
     56OS/2 defines several Standard Extended Attributes (EAs):
    5657:p.
    57 :hp1..ASSOCTABLE:ehp1. is a multi-value multi-type (MVMT) EA.  FM/2 will
     58:hp1..ASSOCTABLE:ehp1. is a multi-value multi-type (MVMT) EA. FM/2 will
    5859not create one of these, but you can with the Association page of a
    5960program object in the WPS.
    6061:p.
    61 :hp1..CLASSINFO:ehp1. is a binary attribute.  FM/2 will not create one
    62 of these, but the WPS does automagically as required.
     62:hp1..CLASSINFO:ehp1. is a binary attribute. FM/2 will not create one
     63of these, but the WPS does automatically as required.
    6364:p.
    64 :hp1..ICON:ehp1. is an icon attribute.  FM/2 will not create one of these
     65:hp1..ICON:ehp1. is an icon attribute. FM/2 will not create one of these
    6566via the EA dialog, but you can change the icon of a file system object in
    6667other, more direct, ways with FM/2.
    6768:p.
    68 :hp1..CODEPAGE:ehp1. is an attribute (don't know the type).  FM/2 won't
     69:hp1..CODEPAGE:ehp1. is an attribute (don't know the type). FM/2 won't
    6970make one.
    7071:p.
     
    7374:p.
    7475:hp1..SUBJECT:ehp1. is an ASCII attribute (see a file object's File page).
    75 This describes the object.  FM/2 makes use of these for you.
     76This describes the object. FM/2 makes use of these for you.
    7677:p.
    7778:hp1..COMMENTS:ehp1. is an MVMT attribute (see a file object's third
     
    7980:p.
    8081:hp1..KEYPHRASES:ehp1. is an MVMT attribute (see a file object's third
    81 File page).  OS/2 documentation describes this as an MVST, but the WPS
     82File page). OS/2 documentation describes this as an MVST, but the WPS
    8283objects create MVMTs.
    8384:p.
     
    8788:hp1..LONGNAME:ehp1. is an ASCII attribute that gives the full name of a
    8889file when stored on a file system that doesn't support long filenames
    89 (like FAT).  Sometimes you'll see them even on files stored on HPFS
     90(like FAT). Sometimes you'll see them even on files stored on HPFS
    9091drives, when invalid characters (invalid for the file system, like
    9192a colon not used for a path separator, for example) are used.
     
    9596:p.
    9697When creating attributes of your own, you should :hp2.not:ehp2. begin
    97 them with a period.  Try using a convention like "JOES.ATTRIBUTE"
     98them with a period. Try using a convention like "JOES.ATTRIBUTE"
    9899(yourname.attribtag) to make sure it doesn't conflict with the WPS or
    99 any apps you may run.
     100any applcations you run.
    100101:p.
    101102&period.SUBJECT, .COMMENTS and .KEYPHRASES can be modified, deleted and
    102 added by the user without problem.  The other standard EAs are the
    103 domain of apps and the WPS and should be left alone.  You can, of
     103added by the user without problem. The other standard EAs are the
     104domain of apps and the WPS and should be left alone. You can, of
    104105course, create your own EAs and manipulate them with REXX or other types
    105106of programs.
  • trunk/dll/ipf/editor.ipf

    r10 r268  
    33
    44:artwork name='..\..\bitmaps\view.bmp' align=center.
     5:p.
    56The internal viewer is used to view files unless you have an external
    67viewing program defined in the internal Settings notebook's :link
    78reftype=hd res=92200.Viewers page:elink., or the :hp2.Fast internal
    8 viewer:ehp2. checkbox :hp1.off:ehp1..  This viewer loads and displays a
     9viewer:ehp2. checkbox :hp1.off:ehp1.. This viewer loads and displays a
    910one megabyte text file in less than two seconds on a 486/66. The :link
    1011reftype=hd res=93900."old" viewer:elink. loads large text files
     
    1314:p.
    1415Both :link reftype=hd res=98800.hex:elink. and ASCII (plain text)
    15 display modes are supported, and a variety of text sizes.  These
     16display modes are supported, and a variety of text sizes. These
    1617controls are under the :hp1.View:ehp1. pulldown submenu.
    1718:p.
    1819Selected lines are displayed in reverse video (white text on a black
    19 background).  The current line has a ">" pointing at it in the left
    20 margin.  Single selections and swipe selections are supported, as well
     20background). The current line has a ">" pointing at it in the left
     21margin. Single selections and swipe selections are supported, as well
    2122as select and deselect all (under the :hp1.Select:ehp1. pulldown
    2223submenu) and select/deselect all "found" lines (see :hp1.Search:ehp1.
    23 below).  Keyboard selection is performed with the spacebar, or you can
     24below). Keyboard selection is performed with the spacebar, or you can
    2425hold down the Shift key while moving the cursored selection with the
    25 arrow keys.  Discontiguous lines can be selected.
     26arrow keys. Discontiguous lines can be selected.
    2627:p.
    2728If you double-click a line in the viewer window, a listbox appears above
    28 the text containing that line.  Select (single-click) the line in the
     29the text containing that line. Select (single-click) the line in the
    2930listbox and the viewer window will scroll to that line -- a sort of
    30 instant bookmarking facility.  To remove a line from this bookmark
    31 listbox, double-click it in the listbox.  See the :link reftype=hd
     31instant bookmarking facility. To remove a line from this bookmark
     32listbox, double-click it in the listbox. See the :link reftype=hd
    3233res=97600.FM/2 window layouts:elink. topic for a picture to help you
    3334understand this one -- or just try it.
    3435:p.
    3536The :hp1.Clipboard:ehp1. pulldown submenu allows you to save selected
    36 lines to the clipboard or a file.  :hp7.Warning&colon.:ehp7. Warp
     37lines to the clipboard or a file. :hp7.Warning&colon.:ehp7. Warp
    3738appears to have a 64K limit to the size of text that can be placed in
    38 the clipboard.  You can also save lines that you've double-clicked into
    39 the bookmark listbox.  When you write lines to a file, you append to the
     39the clipboard. You can also save lines that you've double-clicked into
     40the bookmark listbox. When you write lines to a file, you append to the
    4041file (if it already exists).
    4142:p.
    4243When you search for text in the file, you can search for more than one
    43 "phrase" at a time.  Each line you fill into the MLE on the
    44 :hp1.Search->Find text:ehp1. dialog is a separate search string.  You
     44"phrase" at a time. Each line you fill into the MLE on the
     45:hp1.Search->Find text:ehp1. dialog is a separate search string. You
    4546can also search case sensitively (i.e. 'A' doesn't match 'a'), translate
    4647C-like :link reftype=hd res=99500.\-encoded characters:elink. (\r = a
     
    4849and/or select lines as they're found by checking the appropriate
    4950checkboxes on the Find First dialog. All matching lines are displayed in
    50 red.  The :hp1.Search->Next found line:ehp1. command moves to the next
     51red. The :hp1.Search->Next found line:ehp1. command moves to the next
    5152highlighted line in the file (from the current position), and
    5253:hp1.Search->Previous found line:ehp1. moves to the previous highlighted
    53 line.  Colors are configurable.
     54line. Colors are configurable.
    5455:p.
    5556If you're looking for more powerful viewing software, you might be
    5657interested in Michael Schacter's :hp1.Hyperview PM:ehp1. shareware
    57 program.  Michael can be contacted on Compuserve at user ID 76170,1627,
    58 and hangs out in the OS2SHARE (library 1 of OS2BVEN) forum. You can
     58program. Now orphan ware it can still be found online. You can
    5959easily set Hyperview up to be used automatically by FM/2 using the :link
    6060reftype=hd res=92200.Viewers page:elink. of the internal Settings
     
    6666:artwork name='..\..\bitmaps\edit.bmp' align=center.
    6767:artwork name='..\..\bitmaps\view.bmp' align=center.
    68 The internal viewer/editor is an extremely simplistic MLE window.  It is
     68:p.
     69The internal viewer/editor is an extremely simplistic MLE window. It is
    6970:hp2.strongly:ehp2. recommended that you replace it with a better one
    7071via the :link reftype=hd res=94600.Settings Notebook:elink.'s :hp1.:link
    71 reftype=hd res=92200.Viewers page:elink.:ehp1..  The reasons are
     72reftype=hd res=92200.Viewers page:elink.:ehp1.. The reasons are
    7273simple&colon. a product designed specifically and exclusively for
    7374editing will generally do a better job, and MLEs tend to be sluggish
    7475when loading anything larger than about 58K.
    7576:p.
    76 Suggestions&colon. EPM (which comes with OS/2), or QEdit for OS/2 (an
    77 excellent and inexpensive text-mode editor from Semware highly
    78 recommended, and used, by FM/2's author) or Visual Slickedit by
    79 Microedge, PM and more powerful (and, of course, more expensive) than
    80 QEdit, also used by the author.  There are many other editors, freeware,
    81 shareware and shrinkwrap, available, I simply listed those with which I
    82 have some familiarity and feel I can recommend as very good software.
     77Suggestions&colon. EPM (which comes with OS/2), There are other editors
     78available.
    8379:p.
    8480There's :link reftype=hd res=99300.another, faster internal viewer (no
     
    8682:p.
    8783The internal viewer/editor creates a window for each file being viewed/
    88 edited.  The :link reftype=hd res=91100.Windows->Dialog:elink. dialog
     84edited. The :link reftype=hd res=91100.Windows->Dialog:elink. dialog
    8985can be used to quickly close several windows at once or find a
    9086particular window and bring it to the front.
    9187:p.
    9288:hp7.Note:ehp7. that when saving files the editor formats the file so
    93 that it appears as it does in the MLE.  The appearance of a file can be
     89that it appears as it does in the MLE. The appearance of a file can be
    9490different in the MLE or in the created disk file depending on various
    9591settings under the editor's :hp1.Config->Format Control:ehp1., notably
    96 Wrap.  :hp8.Be sure you have these settings right for the way you want
     92Wrap. :hp8.Be sure you have these settings right for the way you want
    9793the resultant file to look.:ehp8.
    9894:p.
     
    110106
    111107FM/2 will allow you to change the codepage (character set) in use in the
    112 internal viewer by selecting a codepage from the listbox.  The codepage
     108internal viewer by selecting a codepage from the listbox. The codepage
    113109must be one of those supported in your CONFIG.SYS (see :link
    114110reftype=launch object='CMD.EXE' data='/C HELP CODEPAGE'.CODEPAGE:elink.
     
    135131In many areas, FM/2 allows you to use C-style backslash encoding (or
    136132more properly "escaping") to give constants you normally couldn't enter
    137 into an entry field or MLE.  There are some differences from standard
     133into an entry field or MLE. There are some differences from standard
    138134C escaping, so pay attention.
    139135:p.
  • trunk/dll/ipf/errors.ipf

    r2 r268  
    205205        or bad EAs in list.
    206206256  ERROR_EA_LIST_TOO_LONG
    207         FEAList > 64K-1 bytes.
     207        EAList > 64K-1 bytes.
    208208259  ERROR_NO_MORE_ITEMS
    209209        DosQFSAttach ordinal query.
     
    222222        Volume changed.
    223223275  ERROR_EAS_DIDNT_FIT
    224         EAS didnt fit.
     224        EAS didn't fit.
    225225:exmp.
     226
     227Additional information for some error codes can be obtained by typing "Help <Error code &numsign.>"
     228on an OS/2 command line.
  • trunk/dll/ipf/expert.ipf

    r2 r268  
    66Lists:elink. and :link reftype=hd res=98900.Opening a Directory
    77Container:elink. -- they'll contain some FM/2-specific info you'll
    8 need or be able to use up front.  You might also want to take a look
     8need or be able to use up front. You might also want to take a look
    99at the internal :link reftype=hd res=94600.Settings Notebook:elink.
    1010and its help to see how you can customize FM/2's behavior to your taste.
     
    1313that link-dragging (holding Ctrl + Shift while dragging) is used to do
    1414comparing within FM/2 (still creates shadows when dropping on WPS
    15 objects).  Direct renaming works as expected. Context menus can be
    16 requested on objects for other functions.  Double-clicking opens objects
    17 in the "best guess" view.  In other words, it works more-or-less like
     15objects). Direct renaming works as expected. Context menus can be
     16requested on objects for other functions. Double-clicking opens objects
     17in the "best guess" view. In other words, it works more-or-less like
    1818the WPS with file maintenance-specific functionality added.
    1919:p.
    2020You now know how to do the basic file system maintenance operations
    21 (copy, move, delete, rename, etc.) -- go for it, and have fun.  The rest
     21(copy, move, delete, rename, etc.) -- go for it, and have fun. The rest
    2222of the help will wait until curiosity gets the better of you -- and it
    23 will.  &colon.-)
     23will. &colon.-)
    2424:p.
    2525:artwork name='bitmaps\expert.bmp' align=center.
  • trunk/dll/ipf/filter.ipf

    r10 r268  
    22:i1 id=aboutFilter.Filter container
    33:artwork name='..\..\bitmaps\filter.bmp' align=center.
    4 This dialog allows you to filter what's shown in a container.  A
     4:p.
     5This dialog allows you to filter what's shown in a container. A
    56filemask or filemasks can be used to filter, and so can file attributes
    6 (except for archive listings where attributes are not applicable).  In
     7(except for archive listings where attributes are not applicable). In
    78addition, you can set attributes that _must_ be present on the objects
    89to be shown (for instance, if you check :hp1.Hidden:ehp1. in the
    910"Must-have Attribs" group, only objects with their hidden attribute set
    10 will show up).  You can specify whether FM/2 should always show
     11will show up). You can specify whether FM/2 should always show
    1112directories whether they match the mask(s) or not by checking the
    1213:hp1.Always show directories:ehp1. checkbox to keep them visible.
     
    1415:hp2.To be sure that everything in a container is displayed, clear any
    1516filemask, check all attributes in the Attribs groupbox and clear
    16 all attributes in the Must-have Attribs groupbox.:ehp2.  You can click
     17all attributes in the Must-have Attribs groupbox.:ehp2. You can click
    1718the :hp1.All:ehp1. button to set the filter to show everything.
    1819:p.
    1920As you enter filemasks they're saved for later redisplay in this
    20 dialog's listbox.  If a filemask desired is in the listbox you can use
    21 it by selecting it (double-clicking it).  You can get rid of a mask in
     21dialog's listbox. If a filemask desired is in the listbox you can use
     22it by selecting it (double-clicking it). You can get rid of a mask in
    2223the listbox by highlighting it and clicking :hp1.Delete:ehp1..
    2324:p.
     
    3435Some characters have the following special meaning:
    3536:p.
    36  :hp1.?:ehp1.  A question mark matches one character, unless what it would
     37 :hp1.?:ehp1. A question mark matches one character, unless what it would
    3738match is a period, slash or backslash, in which case it matches no
    3839characters.
    3940:p.
    40  :hp1.*:ehp1.  An asterisk matches characters from the source to the target
     41 :hp1.*:ehp1. An asterisk matches characters from the source to the target
    4142until it finds a filename character that matches the non-wild character
    4243following it in the filemask, or a period, slash, backslash or
     
    4748Up to 24 masks may be "cascaded" by separation with semicolons.
    4849When specifying multiple filemasks, you can use '/' as the first character
    49 of a mask to mean _don't_ match this filespec.  Exclusions should usually
     50of a mask to mean _don't_ match this filespec. Exclusions should usually
    5051be listed before inclusions to attain the desired effect.
    5152:p.
     
    6566:eparml.
    6667:p.
    67 :hp1.A reminder&colon.:ehp1.  CD-ROM files are marked ReadOnly and will
     68:hp1.A reminder&colon.:ehp1. CD-ROM files are marked ReadOnly and will
    6869not appear in your containers unless you have the ReadOnly attribute on
    69 (checked).  If you copy these files to your hard drive the ReadOnly
     70(checked). If you copy these files to your hard drive the ReadOnly
    7071attribute goes with them; use the menu command
    7172:hp1.Files->Edit->Attribs:ehp1. (Ctrl + a accelerator) to reset it (you
     
    7374:p.
    7475This dialog also appears when you are selecting or deselecting file system
    75 objects using a mask.  In this case, attribute information will be greyed
    76 out and an additional entry field (:hp1.Text&colon.:ehp1.) appears.  You
     76objects using a mask. In this case, attribute information will be grayed
     77out and an additional entry field (:hp1.Text&colon.:ehp1.) appears. You
    7778can enter text into this entry field, and only files containing the text
    78 and matching the mask(s) will be (de)selected.  The title bar will remind
     79and matching the mask(s) will be (de)selected. The title bar will remind
    7980you why you called up the dialog.
  • trunk/dll/ipf/fm3.ipf

    r10 r268  
    1515document, is to look at the :hp2.Contents:ehp2. (which you'll get if you
    1616press Ctrl + F1 at the main window -- it may help you to maximize it
    17 within the help window).  The Contents view of a help file is something
     17within the help window). The Contents view of a help file is something
    1818like the Table of Contents in a book, with each major topic representing
    19 a chapter.  Some topics have a "+" sign beside them to indicate that
     19a chapter. Some topics have a "+" sign beside them to indicate that
    2020there are subtopics available in a hierarchal inverted tree structure;
    2121click the "+" and they'll be revealed.
    2222:p.
    2323The help sometimes has hypertext links shown in a different color, like
    24 the words "Context menu" a few paragraphs below.  You can select these
     24the words "Context menu" a few paragraphs below. You can select these
    2525links to switch to a different topic related to the highlighted word(s).
    2626In this way you can browse through the help, moving from topic to topic
    27 as you feel the need for more specific help.  The :hp1.Previous:ehp1.
    28 button (or the Escape key) will move backwards through the hypertext
    29 links you've followed.
     27as you feel the need for more specific help. The :hp1.Previous:ehp1. button
     28 (IBM's view.exe)or the :hp1.Back:ehp1. button (NewView)
     29(or the Escape key) will move backwards through the hypertext
     30links you've followed. Please note that in "NewView" the :hp1.Previous:ehp1.
     31and  :hp1.Next:ehp1. buttons navigate up and down the table of contents
     32while the :hp1.Back:ehp1. and :hp1.Forward:ehp1. buttons navigate hyperlinks
    3033:p.
    3134To find something on a specific topic, click the :hp2.Search:ehp2.
    32 button at the bottom of the help window and enter some text.  This might
     35button at the bottom of the help window and enter some text (IBM's view.exe) 
     36or use the search tab (NewView). This might
    3337be analogous to the index at the back of a book (although the help
    3438manager also provides an "index" of its own, which is something like the
     
    3943:p.
    4044To find out about changing a volume label, enter "Label" as the "Search
    41 for&colon." text, check the "All sections" checkbox, then press [Enter].
     45for&colon." text, check the "All sections" checkbox, if present, then press [Enter].
    4246:p.
    4347To find out how to open a new FM/2 window, enter "Open" as the "Search
    44 for&colon." text, check the "All sections" checkbox, then press [Enter].
     48for&colon." text, check the "All sections" checkbox, if present, then press [Enter].
    4549:p.
    4650If you'd like a printout of any of the topics in the online help, click
    47 the :hp2.Print:ehp2. button at the bottom of the help window.  The :link
    48 reftype=hd res=93700.Context menu:elink. help topic would probably be a
    49 good one to print out.  Gives you something to read in the john.
     51the :hp2.Print:ehp2. button at the bottom ("IBM's" View.exe) or top (NewView.exe) of the help
     52window. The :link reftype=hd res=93700.Context menu:elink. help topic would probably be a
     53good one to print out. Gives you something to read in the john.
    5054Remember that you can also use the :hp1.FM/2 Online Help:ehp1. icon in
    5155the FM/2 folder to view the help without starting FM/2 itself.
    5256:p.
    53 If you're stuck in a dialog, click that dialog's Help button.  That will
    54 usually take you directly to appropriate help. One note of caution:
     57If you're stuck in a dialog, click that dialog's :hp2.Help button:ehp2. That should
     58take you directly to appropriate help. One note of caution:
    5559if you call up help for a dialog, be sure to dismiss the help before
    56 dismissing the dialog.  Many of the dialogs run in threads other than
     60dismissing the dialog. Many of the dialogs run in threads other than
    5761thread 1 (the main thread), and there's a long-standing OS/2 bug that
    58 causes weird behavior if you do it the other way around to a dialog run
    59 in a thread other than thread 1.  Trust me.
    60 :p.
    61 So, if you're totally new to FM/2, :hp1.how to get started?:ehp1.
    62 First, run the :hp2.OS/2 Tutorial:ehp2. if you need help on the basics
    63 of using a mouse in general or using one with OS/2 in particular.  Next,
    64 read the help section titled :link reftype=hd
     62causes weird behavior if you close a dialog run
     63in a thread other than thread 1 after before closing its help file. Trust me.
     64:p.
     65So, if you're totally new to FM/2, :hp1.here is how to get started.:ehp1.
     66First, read the help section titled :link reftype=hd
    6567res=91300.Terminology:elink. so we'll understand each other a bit
    66 better.  If you're still nervous about OS/2 conventions, try FM/2's
    67 :link reftype=hd res=99800.Tutorial:elink. topic for real hand-holding.
     68better. If you're still nervous about OS/2 conventions, try FM/2's
     69:link reftype=hd res=99800.Tutorial:elink. section for real hand-holding.
    6870Get an overview of some important FM/2 windows in the :link reftype=hd
    69 res=97600.Window layouts:elink. topic. Then plunge into the :link
    70 reftype=hd res=90000.General Help:elink. topic to find out how to look
     71res=97600.Window layouts:elink. section. Then plunge into the :link
     72reftype=hd res=90000.General Help:elink. section to find out how to look
    7173at, Move, Copy, Rename and Compare files and directories (the basics).
    7274That will get you started, and we'll give you hints along the way about
    7375other places you might like to look (like :link reftype=hd
    74 res=93000.Hints:elink. &colon.-) when you're ready.  The previously
     76res=93000.Hints:elink. &colon.-) when you're ready. The previously
    7577mentioned :link reftype=hd res=93700.Context menus:elink. topic will
    7678give you an overview of all the commands available in FM/2 (and there
     
    8183notebook:elink. (accessible under the :link reftype=hd
    8284res=92000.Config:elink. menu), specifically at the :link reftype=hd
    83 res=99200.Quick page:elink..  There you'll see a few "standard"
    84 configurations you can try out to perhaps get an idea of the range of
    85 appearance and performance you can get out of FM/2 via the Settings
     85res=99200.Quick page:elink.. There you'll see a few "standard"
     86configurations you can try out to get an idea of the range of
     87appearance and performance you can obtain from FM/2 via the Settings
    8688notebook and Config menu.
    8789:p.
    8890Command line help is in the :link reftype=launch object='E.EXE'
    89 data='READ.ME'.READ.ME:elink. file that accompanied the archive,
     91data='\FM2\README'.README:elink. file that accompanied the archive,
    9092since you should have read that before trying to start FM/2. You did,
    91 didn't you? 
    92 :p.
    93 There is one thing you should keep in mind about FM/2.  FM/2 is
     93didn't you? Note&colon. This link only works if FM/2 is installed
     94to a directory named FM2 on the boot drive. If not go to your FM/2
     95install directory and double-click B1 on the file "README".
     96:p.
     97There is one thing you should keep in mind about FM/2. FM/2 is
    9498extremely powerful and has a lot of features, but :hp6.you don't have to
    95 use or even know them all:ehp6.. Most people will use only a few of
     99use, understand or even know about them all:ehp6.. Most people will use only a few of
    96100FM/2's features on a regular basis (and not everyone will use the same
    97101combination), and that's fine -- find what works best for you and
    98 :hp2.use:ehp2. it.  If you find yourself needing some other feature,
     102:hp2.use:ehp2. it. If you find yourself needing some other feature,
    99103call up the help, find it, and use it -- it'll be there whenever you
    100 need it.  But don't feel that, somehow, by not using every little nook
    101 and cranny of the program that you're missing out on something.  The
     104need it. But don't feel that, somehow, by not using every little nook
     105and cranny of the program that you're missing out on something. The
    102106idea is to use what you need; pick your tools from the arsenal and get
    103107some work done.
     
    105109On the other hand, always assume that there's a way to do what you want
    106110with FM/2 (chances are good that there is), and ask the help window to
    107 Search for it.  If you can't find it there, drop me a line.
     111Search for it. If you can't find it there, drop me a line at steve53@earthlink.net
     112:h1 res=90000 name=PANEL_GENERAL.General Help
     113:i1 id=aboutGeneral.General Help
     114
     115FM/2's main purpose is to show you what's on your file system and let you
     116sling what's there around.
     117:p.
     118Here we'll cover the basics. Some familiarity with OS/2's WPS
     119(WorkPlace Shell) is assumed. If you need refreshing, review the :link
     120reftype=launch object='View.EXE' data='OS2UG.INF'.OS/2 Desktop Guide:elink.
     121It's also assumed that you've already read the :link
     122reftype=hd res=93200.How to use FM/2's help:elink. and :link reftype=hd
     123res=91300.Terminology:elink. sections. If you feel that you need more
     124in-depth help when we're through with this topic, try FM/2's :link
     125reftype=hd res=99800.Tutorial:elink. section. Also review the FM/2 default
     126:link reftype=hd res=100040.Mouse actions:elink. and a list of FM/2 :link reftype=hd 
     127res=100005.Accelerator (shortcut) Keys:elink.
     128:p.
     129There are several ways to view a directory with FM/2, just as there are
     130with the WPS. Icon, Name, Text and Details views all offer different
     131perspectives into the directory being "looked at" (see :link reftype=hd
     132res=91300.Terminology:elink.). Views showing icons can use full-sized
     133icons or smaller "mini-icons" to save space.
     134:p.
     135Details view can show a great deal of information about file system
     136objects, and you can customize what is shown with the :hp2.Details
     137Setup:ehp2. submenu (:link reftype=hd res=93800.Views
     138menu:elink. or a Directory Container:link reftype=hd
     139res=93700.context menu:elink.).
     140:p.
     141You can also place some limits on the amount of detail that FM/2 provides
     142from the file system on the :link reftype=hd res=92400.Toggles:elink.
     143page of the :link reftype=hd res=94600.Settings notebook:elink.. This
     144can speed up FM/2's scanning of directories but can also make for duller
     145screens with less information being presented to you. My advice to you
     146is enjoy the bells and whistles OS/2 and PM provide.
     147:p.
     148Take a moment to set up the look of your Directory Container windows
     149to match your taste -- everyone likes something different. Then meet
     150me back here and we'll talk about manipulating those objects you see...
     151:p.
     152.br
     153As we talk about manipulating objects, keep firmly in mind the concepts
     154of :link reftype=hd res=98000."current object" and "highlighted
     155objects":elink.. The current object is the one on which commands act (it
     156has the dotted outline around it). If the current object is also
     157highlighted, all highlighted objects will be affected.
     158:p.
     159:artwork name='..\..\bitmaps\rename.bmp' align=center.
     160:p.
     161:hp1.Renaming file system objects&colon.:ehp1.
     162The simplest way to rename a file system object is to point at it with
     163the mouse pointer, hold down the ALT key, and click the text of its name.
     164FM/2 produces a mini MLE text entry field where you can type in a new
     165name (this is :link reftype=hd res=98200.Direct Editing:elink.). When
     166finished, click the object and a rename is performed. Note that you can
     167even move the object to another directory when you do this (Also note
     168that in Details view you can direct-edit the Subject field to change an
     169object's Subject, and the Longname field to change an object's Longname
     170on FAT drives.).
     171:p.
     172Using this method will not allow you to overwrite an existing file. You
     173can use drag and drop (as detailed below for Move), the menu command
     174:link reftype=hd res=91400.Rename:elink. or the :link reftype=hd
     175res=91800.toolbar:elink. to facilitate overwriting.
     176:p.
     177If you'd like more detail, go to the :link reftype=hd
     178res=99810.Rename:elink. tutorial.
     179.br
     180:artwork name='..\..\bitmaps\mover.bmp' align=center.
     181:p.
     182:hp1.Moving file system objects&colon.:ehp1.
     183.br
     184There are several ways to move a file system object. The most
     185intuitive is :hp2.drag and drop:ehp2.. Using this method, you "grab"
     186the file system object by pressing and holding B2 while the mouse
     187pointer is over the object, then begin to move the mouse (still holding
     188B2). The object's icon should begin to move with the mouse pointer.
     189"Drag" this icon to where you want to move it (for instance, if you want
     190to move a file from C&colon.\ to D&colon.\, drag the file to the Drive
     191Tree's D&colon.\ object). When the object is where you want it, release
     192B2 and the move is done.
     193:p.
     194When dragging an object into a Directory Container, remember that to
     195place it into the directory into which the Directory Container "looks"
     196you need to drop it on container "whitespace" (a part of the container
     197not occupied by an object). For convenience, the two large status
     198areas at the top of the container are considered whitespace.
     199:p.
     200If you get confused when dragging object(s), press the F1 key. This
     201will give you some information about what you're doing. Pressing the
     202Escape key will abort the drag.
     203:p.
     204Note that you can't move a file or directory onto another file (except
     205for archive targets), only into a directory (moving into container
     206whitespace in a Directory Container window is the same as moving into
     207the directory the Directory Container "looks" into, and a minimized
     208Directory Container window is "all whitespace"). Also note that the
     209object you grab becomes the current object, and if it's also highlighted
     210you'll drag all highlighted objects (you'll see visual feedback to this
     211effect).
     212:p.
     213You could, of course, also select "Move" from the :hp1.:link reftype=hd
     214res=93300.Files:elink.:ehp1. menu, a context menu, click the Move
     215toolbar button, or type the accelerator key Ctrl + m (hold the control
     216key down and type "m"). In this case, you'll get the :link reftype=hd
     217res=91500.Walk Directories:elink. dialog where you can enter a target
     218directory.
     219:p.
     220If you'd like more detail, go to the :link reftype=hd
     221res=99820.Move:elink. tutorial.
     222.br
     223:artwork name='..\..\bitmaps\copier.bmp' align=center.
     224:p.
     225:hp1.Copying file system objects&colon.:ehp1.
     226.br
     227The procedure for copying file system objects is very similar to that
     228for moving them. When you begin to drag the object, and until you
     229release it, hold down the control (Ctrl) key. You'll notice that the
     230dragged icon is "ghosted" to give visual feedback that a copy, not a
     231move, is being performed. Note that you can copy a file onto an archive
     232file as well as into a directory. You can also "clone" a file by dropping
     233it into the directory where it already resides -- you'll get a rename
     234dialog that will allow you to change the name, creating a file exactly
     235like the other with a different name.
     236:p.
     237As for move above, there is a "Copy" menu item, a toolbar button,
     238and Ctrl + c is the accelerator key.
     239:p.
     240If you'd like more detail, go to the :link reftype=hd
     241res=99830.Copy:elink. tutorial.
     242.br
     243:artwork name='..\..\bitmaps\linkdrag.bmp' align=center.
     244.br
     245:hp1.Comparing file system objects&colon.:ehp1.
     246.br
     247There is one other type of drag and drop operation called a "link drag."
     248To link drag, hold down the Ctrl and Shift keys while dragging.
     249You'll see a "rubber band line" extend from where you grabbed the icon
     250to the mouse pointer as a visual cue. Link dragging is usually used
     251within FM/2 to do compare operations (see also :link reftype=hd
     252res=99950.:hp2.Link Sets Icon:ehp2. toggle:elink.). What you drag will
     253be compared to what you drop it on. Note, however, that if you drag to
     254a WPS object (like the desktop or other folder), OS/2's version of a
     255link drag is performed, which usually results in the creation of an object shadow
     256If you'd like more detail, go to the :link reftype=hd
     257res=99840.Compare:elink. tutorial.
     258:p.
     259Double-clicking an object in a Directory Container window causes its
     260:hp1.default action:ehp1. to occur. What that action is depends on
     261the type of object and how you've configured FM/2. Briefly, the FM/2
     262defaults (which you can override) cause the object to be opened in the
     263most likely manner. You can :link reftype=hd res=100060.read about this
     264in more detail here:elink. in the tutorial section.
     265:p.
     266Other commands are accessed via :link reftype=hd
     267res=97700.pulldown:elink.,  :link reftype=hd res=93700.context
     268menu:elink. commands, toolbar buttons or accelerator keys. You can read about them by
     269selecting the highlighted words "context menu" in this paragraph. FM/2
     270also offers several general :link reftype=hd res=92100.utilities:elink.
     271and many :link reftype=hd res=92000.configuration:elink. options which
     272you may want to explore. But you now know how to perform the file system
     273maintenance basics: Move, Copy, Rename and Compare. You are now, as the
     274Smothers Brothers said, educated.
     275:p.
     276For more specific information on FM/2, click the :hp2.Contents:ehp2.
     277button at the bottom of the help window. If you're still confused on
     278the basics, try the FM/2 :link reftype=hd res=99800.Tutorial:elink.
     279topic. You might also want to look at the :link reftype=hd
     280res=98900.Opening a Directory Container:elink., :link reftype=hd
     281res=99400.Using quicklists:elink. and :link reftype=hd res=97600.Window
     282layout:elink. sections.
     283
     284.im mouse.ipf
     285
     286.im keys.ipf
    108287
    109288:h1 res=97600 name=PANEL_FM2WINDOWLAYOUT.FM/2 Window Layouts
     
    112291:artwork align=left name='bitmaps\oall.bmp'.
    113292:p.
    114 :hp6.Note&colon.:ehp6.  You can turn optional windows and controls on
    115 and off.  Pick the ones you like, get the others out of your way (see
    116 the Config menu).  Surely no one uses all of them at the same time...
     293:hp6.Note&colon.:ehp6. You can turn optional windows and controls on
     294and off. Pick the ones you like, get the others out of your way (see
     295the Config menu). Surely no one uses all of them at the same time...
    117296The autoview window, bottom buttons, quicklists, toolbar, drive buttons,
    118297status line #2, and even the pulldown menu can all be turned on and off
     
    127306activate commands when clicked.
    128307:p.
    129 The :hp1.Toolboxes quicklist:ehp1. only appears when the
    130 :hp1.Toolbar:ehp1. is visible (see :link reftype=hd res=99400.Using
    131 quicklists:elink. topic).
    132 :p.
    133 Status bar #1 can be clicked to shift the focus to FM/2 without
    134 activating any commands.  In addition, if the Drive tree is the
     308The :hp1."Toolboxes" quicklist:ehp1. only appears when the
     309:link reftype=hd res=91800.Toolbar:elink. is visible (see :link reftype=hd res=99400.Using
     310quicklists:elink. section).
     311:p.
     312Status line #1 can be clicked to shift the focus to FM/2 without
     313activating any commands. In addition, if the Drive tree is the
    135314active window within FM/2's monolithic window, the Swapfile and
    136 memory available indicators in Status bar #2 will be immediately
    137 updated (otherwise they update about once every ten seconds).
    138 :p.
    139 You can get information on most parts of the window just by moving the
    140 mouse pointer over the part of interest (unless you've turned off
    141 bubble help in the internal Settings notebook).  For help with the
     315memory available indicators in Status line #2 will be continuously
     316updated (otherwise they update about every ten seconds).
     317:p.
     318You can get information on most areas of the window just by moving the
     319mouse pointer over the area of interest (unless you've turned off
     320bubble help in the internal Settings notebook). For help with the
    142321quicklists, which don't have bubble help, see :link reftype=hd
    143 res=99400.this topic:elink..
    144 :p.
    145 .br
    146 Here's a Directory Container window in more detail&colon.
     322res=99400.Using quicklists:elink..
     323:p.
     324.br
     325Here's a Directory Container window in more detail&colon. See
     326:link reftype=hd res=98900.Opening a Directory Container:elink. and 
     327:link reftype=hd res=91900.Folder Button:elink. for more information
     328:p.
    147329:artwork align=left name='bitmaps\dircnr.bmp'.
    148330:p.
    149331Here's :link reftype=hd res=100000.FM/2 Lite:elink. with an explanation
    150 of the things that are unique to it (except for the Alt-click to change
    151 sort in Details view -- that works in FM/2, too).  The toolbar and
    152 Autoview windows have been turned off to unclutter this illustration.
     332of the things that are unique to it (Note&colon. Alt-click to change
     333sort in Details view also works in FM/2). The
     334Autoview window has been turned off to unclutter this illustration.
     335:p.
    153336:artwork align=left name='bitmaps\fm4oall.bmp'.
    154337:p.
    155 Note that the current window, which would be affected by a pulldown menu
    156 command, is surrounded by a light red border.  In this case, it's the
    157 Drive Tree, so the Directory Container, or pane, that would change if a
    158 directory were double-clicked in the Tree is surrounded by a darker red
    159 border.  This color coding gives you instant feedback as to how the
    160 commands you select will work.
    161 :p.
    162 .br
    163 Here's a look at the text file viewer window -- the default text file
    164 viewer built into FM/2 that you get when you double-click a text file in
     338Note that the active window, the window pulldown menu commands will
     339effect, is surrounded by a light red border. When the Drive Tree is active as 
     340shown above the Directory Container that would change if a
     341directory were double-clicked in the Tree is surrounded by a fine darker red
     342border. This color coding gives you instant feedback as to what the
     343commands you select will effect.
     344:p.
     345.br
     346Here's a look at the default text file
     347viewer built into FM/2. It is opened when you double-click a text file in
    165348a Directory container (you can configure a different one if you
    166349like)&colon.
     350.br
    167351:artwork align=left name='bitmaps\newview.bmp'.
    168352:p.
    169353Here's how the window looks if you double-click some lines of text&colon.
     354.br
    170355:artwork align=left name='bitmaps\newview2.bmp'.
    171 Here we've used the bookmark listbox (which we filled by double-clicking
    172 some lines of text) to make an index for the document being read, to
    173 enable us to move to different sections quickly.  See the :link
    174 reftype=hd res=99300.Internal viewer:elink. topic for more information.
    175 
    176 :h1 res=90000 name=PANEL_GENERAL.General Help
    177 :i1 id=aboutGeneral.General Help
    178 
    179 FM/2's main purpose is to show you what's on your file system and let you
    180 sling what's there around.
    181 :p.
    182 Here we'll cover the basics.  Some familiarity with OS/2's WPS
    183 (WorkPlace Shell) is assumed.  If you need refreshing, run the OS/2
    184 Tutorial.  It's also assumed that you've already read the :link
    185 reftype=hd res=93200.How to use FM/2's help:elink. and :link reftype=hd
    186 res=91300.Terminology:elink. topics.  If you feel that you need more
    187 in-depth help when we're through with this topic, try FM/2's :link
    188 reftype=hd res=99800.Tutorial:elink. topic.
    189 :p.
    190 There are several ways to view a directory with FM/2, just as there are
    191 with the WPS.  Icon, Name, Text and Details views all offer different
    192 perspectives into the directory being "looked at" (see :link reftype=hd
    193 res=91300.Terminology:elink.).  Views showing icons can use full-sized
    194 icons or smaller "mini-icons" to save space.
    195 :p.
    196 Details view can show a great deal of information about file system
    197 objects, and you can customize what is shown with the :hp2.Details
    198 Setup:ehp2. submenu (under the :link reftype=hd res=93800.Views
    199 menu:elink. or a Directory Container window's :link reftype=hd
    200 res=93700.context menu:elink.).
    201 :p.
    202 You can also place some limits on the amount of detail that FM/2 loads
    203 from the file system with the :link reftype=hd res=92400.Toggles:elink.
    204 page of the :link reftype=hd res=94600.Settings notebook:elink..  This
    205 can speed up FM/2's scanning of directories but can also make for duller
    206 screens and less information being presented to you.  My advice to you
    207 is to enjoy the bells and whistles OS/2 and PM provide.
    208 :p.
    209 Take a moment to set up the look of your Directory Container windows
    210 to match your taste -- everyone likes something different.  Then meet
    211 me back here and we'll talk about manipulating those objects you see...
    212 :p.
    213 .br
    214 As we talk about manipulating objects, keep firmly in mind the concepts
    215 of :link reftype=hd res=98000."current object" and "highlighted
    216 objects":elink.. The current object is the one on which commands act (it
    217 has the dotted outline around it).  If the current object is also
    218 highlighted, all highlighted objects will be affected.
    219 :p.
    220 :artwork name='..\..\bitmaps\rename.bmp' align=center.
    221 :hp1.Renaming file system objects&colon.:ehp1.
    222 The simplest way to rename a file system object is to point at it with
    223 the mouse pointer, hold down the ALT key, and click the text of its name.
    224 OS/2 produces a mini MLE text entry field where you can type in a new
    225 name (this is :link reftype=hd res=98200.Direct Editing:elink.).  When
    226 finished, click the object and a rename is performed.  Note that you can
    227 even move the object to another directory when you do this.  (Also note
    228 that in Details view you can direct-edit the Subject field to change an
    229 object's Subject, and the Longname field to change an object's Longname
    230 on FAT drives.)
    231 :p.
    232 Using this method will not allow you to overwrite an existing file.  You
    233 can use drag and drop (as detailed below for Move) or the menu command
    234 :link reftype=hd res=91400.Rename:elink. or the :link reftype=hd
    235 res=91800.toolbar:elink. to allow overwriting.
    236 :p.
    237 If you'd like more detail, go to the :link reftype=hd
    238 res=99810.Rename:elink. tutorial.
    239 .br
    240 :artwork name='..\..\bitmaps\mover.bmp' align=center.
    241 :hp1.Moving file system objects&colon.:ehp1.
    242 .br
    243 There are several ways to move a file system object.  The best and most
    244 intuitive is :hp2.drag and drop:ehp2..  Using this method, you "grab"
    245 the file system object by pressing and holding B2 while the mouse
    246 pointer is over the object, then begin to move the mouse (still holding
    247 B2).  The object's icon should begin to move with the mouse pointer.
    248 "Drag" this icon to where you want to move it (for instance, if you want
    249 to move a file from C&colon.\ to D&colon.\, drag the file to the Drive
    250 Tree's D&colon.\ object).  When the object is where you want it, release
    251 B2 and the move is done.
    252 :p.
    253 When dragging an object into a Directory Container, remember that to
    254 place it into the directory into which the Directory Container "looks"
    255 you need to drop it on container "whitespace" (a part of the container
    256 not occupied by an object).  For convenience, the two large status
    257 areas at the top of the container are considered whitespace.
    258 :p.
    259 If you get confused when dragging object(s), press the F1 key.  This
    260 will give you some information about what you're doing.  Pressing the
    261 Escape key will abort the drag.
    262 :p.
    263 Note that you can't move a file or directory onto another file (except
    264 for archive targets), only into a directory (moving into container
    265 whitespace in a Directory Container window is the same as moving into
    266 the directory the Directory Container "looks" into, and a minimized
    267 Directory Container window is "all whitespace").  Also note that the
    268 object you grab becomes the current object, and if it's also highlighted
    269 you'll drag all highlighted objects (you'll see visual feedback to this
    270 effect).
    271 :p.
    272 You could, of course, also select "Move" from the :hp1.:link reftype=hd
    273 res=93300.Files:elink.:ehp1. menu or a context menu, or click the Move
    274 toolbar button, or type the accelerator key Ctrl + m (hold the control
    275 key down and type "m").  In this case, you'll get the :link reftype=hd
    276 res=91500.Walk Directories:elink. dialog where you can enter a target
    277 directory.
    278 :p.
    279 If you'd like more detail, go to the :link reftype=hd
    280 res=99820.Move:elink. tutorial.
    281 .br
    282 :artwork name='..\..\bitmaps\copier.bmp' align=center.
    283 :hp1.Copying file system objects&colon.:ehp1.
    284 .br
    285 The procedure for copying file system objects is very similar to that
    286 for moving them.  When you begin to drag the object, and until you
    287 release it, hold down the control (Ctrl) key.  You'll notice that the
    288 dragged icon is "ghosted" to give visual feedback that a copy, not a
    289 move, is being performed.  Note that you can copy a file onto an archive
    290 file as well as into a directory.  You can also "clone" a file by dropping
    291 it into the directory where it already resides -- you'll get a rename
    292 dialog that will allow you to change the name, creating a file exactly
    293 like the other with a different name.
    294 :p.
    295 As for move above, there is a "Copy" menu item and a toolbar button,
    296 and Ctrl + c is the accelerator key.
    297 :p.
    298 If you'd like more detail, go to the :link reftype=hd
    299 res=99830.Copy:elink. tutorial.
    300 .br
    301 :artwork name='..\..\bitmaps\linkdrag.bmp' align=center.
    302 :hp1.Comparing file system objects&colon.:ehp1.
    303 There is one other type of drag and drop operation called a "link drag."
    304 To link drag, hold down the Ctrl and Shift keys while dragging.
    305 You'll see a "rubber band line" extend from where you grabbed the icon
    306 to the mouse pointer as a visual cue.  Link dragging is usually used
    307 within FM/2 to do compare operations (see also :link reftype=hd
    308 res=99950.:hp2.Link Sets Icon:ehp2. toggle:elink.). What you drag will
    309 be compared to what you drop it on.  Note, however, that if you drag to
    310 a WPS object (like the desktop or other folder), OS/2's version of a
    311 link drag is performed, which usually results in a shadow object being
    312 created.
    313 If you'd like more detail, go to the :link reftype=hd
    314 res=99840.Compare:elink. tutorial.
    315 :p.
    316 .br
    317 Double-clicking an object in a Directory Container window causes a
    318 :hp1.default action:ehp1. to take place.  What that action is depends on
    319 the type of object and how you've configured FM/2.  Briefly, the FM/2
    320 defaults (which you can override) cause the object to be opened in the
    321 most likely manner.  You can :link reftype=hd res=100060.read about this
    322 in more detail here:elink. in the tutorial section.
    323 :p.
    324 Other commands are accessed via :link reftype=hd
    325 res=97700.pulldown:elink. or :link reftype=hd res=93700.context
    326 menu:elink. commands or toolbar buttons.  You can read about them by
    327 selecting the highlighted words "context menu" in this paragraph.  FM/2
    328 also offers several general :link reftype=hd res=92100.utilities:elink.
    329 and many :link reftype=hd res=92000.configuration:elink. options which
    330 you may want to explore. But you now know how to perform the file system
    331 maintenance basics: Move, Copy, Rename and Compare.  You are now, as the
    332 Smothers Brothers said, educated.
    333 :p.
    334 For more specific information on FM/2, click the :hp2.Contents:ehp2.
    335 button at the bottom of the help window.  If you're still confused on
    336 the basics, try the FM/2 :link reftype=hd res=99800.Tutorial:elink.
    337 topic.  You might also want to look at the :link reftype=hd
    338 res=98900.Opening a Directory Container:elink., :link reftype=hd
    339 res=99400.Using quicklists:elink. and :link reftype=hd res=97600.Window
    340 layout:elink. topics.
    341 
    342 :h1 res=98900 name=PANEL_GENERALOPEN.Opening a Directory Container
     356.br
     357Here we're using the bookmark listbox (which is filled by double-clicking
     358some lines of text) to make an index for the document,
     359enabling us to move from section to section quickly. See the :link
     360reftype=hd res=99300.Internal viewer:elink. section for more information.
     361
     362See also&colon.
     363.br
     364:link reftype=hd res=99000.Databar:elink.
     365
     366:h2 res=98900 name=PANEL_GENERALOPEN.Opening a Directory Container
    343367:i1 id=aboutOpeningDirectory.Opening a Directory Container
    344368
    345369There are several ways to open a Directory Container.
    346370:p.
    347 The most common is to double-click a directory in the Drive Tree.  If no
    348 Directory Container windows are open, one is created.  If one or more
     371The most common is to double-click a directory in the Drive Tree. If no
     372Directory Container windows are open, one is created. If one or more
    349373Directory Container windows are already open, hold down the Shift key
    350374while double-clicking (see picture below) -- otherwise the default
    351375action is to switch the most recently used Directory Container to the
    352376new directory rather than open a new one.
     377:p.
    353378:artwork name='bitmaps\open.bmp' align=center.
    354379:p.
    355380An alternative is to click the :hp1.Open button:ehp1. in the Drive
    356381Tree's titlebar (see location indicated by the mouse pointer in the
    357 snapshot below). This opens a window for the directory highlighted in
     382picture below). This opens a container for the directory highlighted in
    358383the Drive Tree.
     384:p.
    359385:artwork name='bitmaps\openbutt.bmp' align=center.
    360386:p.
    361 Another alternative is to select the :hp1.Open->New FM/2 Window:ehp1.
    362 command from the :hp1.Files menu:ehp1. with the Drive Tree active, or
     387Other alternatives are to select the :hp1.Open->New FM/2 Window:ehp1.
     388command from the :hp1.Files menu:ehp1. with the Drive Tree active,
    363389(preferred) a context menu obtained on the directory you want to open
    364390(remember, you get a context menu by clicking mouse button 2 on an
    365 object).
     391object) or the accelerator key Ctrl + o.
     392:p.
    366393:artwork name='bitmaps\openmenu.bmp' align=center.
    367394:p.
    368395Yet another alternative is to invoke the :hp1.Utilities->Open Directory
    369396Container:ehp1. command (Ctrl + O accelerator -- remember, that "O"
    370 needs to be uppercase, so Shift if necessary).  Using this command
     397needs to be uppercase, so Shift if necessary). Using this command
    371398invokes the :link reftype=hd res=91500. Walk Directories:elink. dialog
    372399and lets you pick the directory to open.
     400:p.
    373401:artwork name='bitmaps\openmnu2.bmp' align=center.
     402:p.
    374403The :hp1.Walk:ehp1. (walking dude) :hp1.button:ehp1. near the bottom
    375 right corner of the FM/2 window also invokes this command.  You can even
     404right corner of the FM/2 window also invokes this command. You can even
    376405drag a file system object onto this button to open a new Directory
    377406Container for that object's directory.
     407:p.
    378408:artwork name='bitmaps\walkbutt.bmp' align=center.
    379409:p.
    380 Finally, if you have the Drivebar toggled on (see the :link reftype=hd
     410Finally, if you have the Drivebar on (see the :link reftype=hd
    381411res=92000.Config menu:elink. topic) and a 3-button mouse, you can click
    382412B3 (or hold down Ctrl while clicking B2) on one of the drive icons to
     
    385415:p.
    386416Now, if that's not enough ways to open a Directory Container, I give up --
    387 go on back to Windoze and the Billy-mandated one way.  &colon.-)
     417go on back to Windoze and the Billy-mandated one way. &colon.-)
    388418:p.
    389419You can also open directories from their objects in a Directory Container
    390 via context menu, Files menu or using the Shift modifier while
     420via context menu, accelerator key, Files menu or using the Shift modifier while
    391421double-clicking.
    392422
    393 :h1 res=99400 name=PANEL_USERLISTS.Using quicklists
     423:h2 res=91800 name=PANEL_TOOLBAR.Toolbar
     424:i1 id=aboutToolbar.Toolbar
     425
     426:artwork name='bitmaps\toolbar.bmp' align=center.
     427:p.
     428The :hp1.toolbar:ehp1. is a collection of buttons that invoke some of
     429the commands in the pulldown or popup menus. Placing the mouse pointer
     430on a button and pressing and holding B2 displays brief help for the
     431button on the titlebar.
     432:p.
     433Some of the buttons will allow objects to be dragged onto them; for
     434example, you can drag objects onto the trashcan to delete them. Note
     435that the hotspot of the mouse pointer itself should be over the button
     436before releasing, not the icon being dragged (icons are slightly offset
     437from the mouse pointer to give better target visibility). Target
     438emphasis is provided in the form of a black outline around the button,
     439and the arrow pointer turns into a hand when above a toolbox icon.
     440:p.
     441This toolbar submenu is a conditional cascade menu, meaning that if you
     442click other than on the boxed arrow a default command is executed (the
     443toolbar is toggled off and on), but if you click on the boxed arrow you
     444get a submenu of items you can select (the other choices are Text
     445Toolbar, which will cause the toolbar to appear as "normal" buttons with
     446text on them, or Toolbar Titles, which will cause text to appear below
     447the toolbar bitmap buttons).
     448:p.
     449Toolbar buttons are user-configurable. To change the toolbar, click
     450mouse button two (usually the right button) while the mouse pointer is
     451over a button to pop up a context menu. You can get the "Load Toolbox"
     452dialog by clicking B2 on a blank area of the toolbar, and the "Add
     453Button" dialog by chording on a blank area of the toolbar.
     454:p.
     455For advanced/curious users&colon. Information on what buttons are in the
     456toolbar is kept in a file named FM3TOOLS.DAT. This file is an ASCII
     457(plain text) file that contains information defining the toolbar. The
     458file contains comments that explain its format.
     459:p.
     460FM/2 allows you to create customized toolboxes that can be loaded as
     461required to provide toolboxes for specific activities. Although FM/2
     462provides ways to edit the toolbar internally, it's probably easier to
     463load the definition files into a text editor and make the changes
     464manually en masse.
     465:p.
     466If you'd like to see a different toolbar layout (and try out the Load
     467Toolbox command), right-click on the toolbar, pick Load Toolbox from the
     468resultant menu, and pick a toolbox from the listbox. Then you might try
     469creating your own and saving it with the Save Toolbox command.
     470:p.
     471See also&colon.
     472.br
     473:link reftype=hd res=96300.Reorder Tools:elink.
     474.br
     475:link reftype=hd res=94400.Edit Tool:elink.
     476.br
     477:link reftype=hd res=96400.Add Tool:elink.
     478.br
     479:link reftype=hd res=94000.Save Tools:elink.
     480.br
     481:link reftype=hd res=94500.Load Tools:elink.
     482
     483:h3 res=96300 name=PANEL_REORDERTOOLS.Reorder Tools
     484:i1 id=aboutReorderTools.Reorder Tools
     485This dialog, accessed from the context menu of a tool button, allows you
     486to rearrange the order of the toolbar's tool buttons. You take selected
     487items from the left listbox and Add them to the end of the right listbox
     488with the :hp1.Add>>:ehp1. button. When you've moved everything to the
     489right listbox, click :hp1.Okay:ehp1.. Click :hp1.Cancel:ehp1. if you
     490change your mind.
     491:p.
     492In reality, you don't need to move everything to the right listbox. You
     493can move only what you want moved to the top of the list, then click
     494Okay. Anything remaining in the left listbox is added to the end of
     495what's in the right listbox.
     496:p.
     497The :hp1.<<Remove:ehp1. button can be used to move selected items from
     498the right listbox to the bottom of the left listbox.
     499
     500:h3 res=94400 name=PANEL_EDITTOOL.Edit Tool
     501:i1 id=aboutEditTool.Edit Tool
     502
     503This dialog allows you to change the help and text strings and flags
     504associated with a button. Edit as desired, then click Okay. Click
     505Cancel if you change your mind.
     506:p.
     507The :hp1.Help:ehp1. field should contain text to remind you what the
     508button's command does. For example, a button that deletes files and
     509directories might have help reading "Delete files and directories".
     510:p.
     511The :hp1.Text:ehp1. field should contain very brief text that will be
     512placed on the button (if the tool id has no bitmap associated with it).
     513:p.
     514The :hp1.Droppable:ehp1. checkbox determines if the tool can have objects
     515dropped on it or not. See list below.
     516:p.
     517The :hp1.Visible:ehp1. checkbox determines if the tool is visible or not.
     518:p.
     519If the :hp1.Separator:ehp1. checkbox is checked, FM/2 puts a bit of
     520whitespace after the button (separates it from the next button).
     521:p.
     522If you check the :hp1.User-defined bmp:ehp1. checkbox, FM/2 will allow
     523you to use your own bitmap. Bitmaps are named after the :hp1.ID:ehp1.
     524of the button -- for example, the bitmap file for ID 1005 would be named
     525"1005.bmp". Clicking the :hp1.Edit bmp:ehp1. button will cause ICONEDIT
     526to be loaded with the bitmap, ready to edit. (Note that bitmaps should
     527be 28 x 28.)
     528:p.
     529The :hp1.ID:ehp1. field identifies the command that is associated with
     530this button. See the :link reftype=hd res=96401.Tool IDs:elink. topic.
     531
     532:h3 res=96400 name=PANEL_ADDTOOL.Add Tool
     533:i1 id=aboutAddTool.Add Tool
     534
     535This dialog is accessed from the context menu of a tool button, or if you
     536turn on the toolbar when there are no tools defined.
     537:p.
     538To add a tool, fill in the fields as appropriate and click Okay. Click
     539Cancel if you change your mind.
     540:p.
     541The :hp1.Help:ehp1. field should contain text to remind you what the
     542button's command does. For example, a button that deletes files and
     543directories might have help reading "Delete files and directories".
     544:p.
     545The :hp1.Text:ehp1. field should contain very brief text that will be
     546placed on the button (if the tool id has no bitmap associated with it).
     547:p.
     548The :hp1.Droppable:ehp1. checkbox determines if the tool can have objects
     549dropped on it or not. See list below.
     550:p.
     551The :hp1.Visible:ehp1. checkbox determines if the tool is visible or not.
     552:p.
     553If the :hp1.Separator:ehp1. checkbox is checked, FM/2 puts a bit of
     554whitespace after the button (separates it from the next button).
     555:p.
     556If you check the :hp1.User-defined bmp:ehp1. checkbox, FM/2 will allow
     557you to use your own bitmap. Bitmaps are named after the :hp1.ID:ehp1.
     558of the button -- for example, the bitmap file for ID 1005 would be named
     559"1005.bmp". Clicking the :hp1.Edit bmp:ehp1. button will cause ICONEDIT
     560to be loaded with the bitmap, ready to edit.
     561:p.
     562The :hp1.ID:ehp1. field should be assigned a number that tells FM/2 what
     563the command associated with the button is. See :link reftype=hd
     564res=96401.Tool IDs:elink. topic.
     565
     566:h3 res=96401 name=PANEL_TOOLIDS.Tool IDs
     567:i1 id=aboutToolIDs.Tool IDs
     568
     569:xmp.
     570ID     Command                                              Droppable?
     571====   =================================================    ==========
     5721023   View Files                                           Y
     5731024   Edit Files                                           Y
     5741026   Make Directory                                       N
     5751010   Object Information                                   Y
     5761005   Rename Files/Directories                             Y
     5771004   Delete Files/Directories                             Y
     5781006   Permanently Delete Files/Directories                 Y
     5791009   Set Attributes and Date/Time of Files/Directories    Y
     58010002  Walk Directories                                     N
     58110008  Select All Files                                     N
     58210007  Deselect All                                         N
     5831029   Archive Files/Directories                            Y
     5841030   Extract From Archives                                Y
     5851022   Create Objects                                       Y
     5861021   Create Shadow Objects                                Y
     5871002   Copy Files/Directories                               Y
     5881001   Move Files/Directories                               Y
     5892003   Kill Process                                         N
     5902004   Undelete Files                                       N
     5912006   Instant Command File                                 N
     5922007   OS/2 Command Line                                    N
     5935001   Filter Container                                     N
     5943001   Edit Associations                                    N
     5951048   Edit Commands                                        N
     5965021   Rescan                                               N
     5971007   Print Files                                          Y
     5981008   Extended Attributes                                  Y
     5992001   View INI Files                                       Y
     6001027   Save List to Clipboard                               Y
     6011028   Save List to File                                    Y
     6021011   Collect Files/Directories                            N
     6031060   Collect Files/Directories from list file             Y
     6042010   Bookshelf Viewer                                     N
     6051017   Open Default                                         Y
     6061031   Directory sizes                                      N
     6071132   UUDecode                                             Y
     6081133   Merge                                                Y
     6091111   Exit FM/2                                            N
     6104001   First Command                                        Y
     6114002   Second Command                                       Y
     612&period...
     6134900   First Toolbox                                        N
     6144901   Second Toolbox                                       N
     615&period...
     616:exmp.
     617Note&colon. Other Commands can also be used; just add to 4000 as required
     618to get the number of the command. For instance, Command 4 would be ID
     6194004. Command buttons use the text field; others shown have bitmaps
     620associated with them in FM/2's resources. Remember that if you change
     621your Commands around, you need to resync the tools to the Commands...
     622:p.
     623Note&colon. Toolbox buttons on a toolbar cause the appropriate toolbox
     624to be loaded from QUICKTLS.DAT (one filename per line, blank lines and
     625lines beginning with ";" ignored). The file named on the first line is
     626the First Toolbox, and so forth. You can have up to 50 toolbox buttons
     627defined (total).
     628:p.
     629This list isn't complete; ask me if you'd like a command added that
     630doesn't appear, and I'll tell you if it can be added and what the ID is,
     631if so.
     632
     633:h3 res=94000 name=PANEL_SAVETOOLS.Save Toolbox
     634:i1 id=aboutSaveTools.Save Toolbox
     635
     636FM/2 allows you to save toolboxes (groups of tools) for later recall
     637with the :link reftype=hd res=94500.Load Toolbox:elink. command.
     638:p.
     639Type the name of the file to hold the toolbox definitions into the entry
     640field below the listbox, or select a file displayed in the listbox (it
     641will be overwritten). FM/2 saves the toolbox definitions into the file.
     642:p.
     643The files are given an extension of &period.TLS if you don't specify an
     644extension. The listbox shows files in the FM/2 directory that have the
     645extension .TLS (which is my way of suggesting that you follow this
     646convention).
     647
     648:h3 res=94500 name=PANEL_LOADTOOLS.Load Toolbox
     649:i1 id=aboutLoadTools.Load Toolbox
     650
     651FM/2 allows you to load toolboxes (groups of tools) which were saved
     652with the :link reftype=hd res=94000.Save Toolbox:elink. command.
     653:p.
     654Type the name of the file that holds the toolbox definitions into the
     655entry field below the listbox, or select a file displayed in the
     656listbox. FM/2 loads the toolbox definitions from the file and updates
     657the toolbar.
     658:p.
     659This allows you to have groups of specific-purpose buttons which you can
     660load for different types of activities. You don't have to use it, but
     661it's there if you would like to do so.
     662:p.
     663Clicking :hp1.Okay:ehp1. without typing in or selecting a filename
     664results in FM/2 reloading the default toolbox from FM3TOOLS.DAT.
     665:p.
     666If I may, here's how I'd recommend using this facility&colon.
     667:p.
     668First, save the full toolbar under a new name (perhaps ALL.TLS). Next,
     669delete any buttons that you don't want in your customized toolbar.
     670Finally, add any Command buttons that you do want in the customized
     671toolbar and save the new toolbox (as <something>.TLS). By starting with
     672the full toolbar, you'll spend more of your time deleting buttons you
     673don't want (a trivial task) and less adding buttons.
     674
     675:h2 res=99400 name=PANEL_USERLISTS.Using quicklists
    394676:i1 id=aboutUserLists.Using quicklists
    395677
    396 FM/2's optional quickists (dropdown combo boxes) provide quick access
     678FM/2's optional quicklists (dropdown combo boxes) provide quick access
    397679to&colon.
    398680:ul compact.
     
    410692quicklists:ehp1. command (F8 accelerator).
    411693:p.
    412 The first list (starting from the left) contains drives.  If you select a
     694The first list (starting from the left) contains drives. If you select a
    413695drive from the list, the Drive Tree scrolls to that drive and makes it the
    414 current object in the Drive Tree.  This can be handy when you have the tree
    415 expanded and don't want to collapse it.  This list is readonly.
     696current object in the Drive Tree. This can be handy when you have the tree
     697expanded and don't want to collapse it. This list is readonly.
     698:p.
    416699:artwork name='bitmaps\userdriv.bmp' align=center.
    417700:p.
     
    419702The second list is the State list, containing the names of saved States of
    420703the FM/2 window (what directories are open, where the windows are located,
    421 etc.).  You can add to this list by typing a name into the entry field,
     704etc.). You can add to this list by typing a name into the entry field,
    422705requesting a context menu on the entry field, then selecting :hp1.Save
    423 State as name:ehp1. from the context menu.  FM/2 will save its current
     706State as name:ehp1. from the context menu. FM/2 will save its current
    424707State under that name for later recall.
     708:p.
    425709:artwork name='bitmaps\useradds.bmp' align=center.
     710:p.
    426711This can be handy if you have different setups that you use frequently,
    427712as you can save and recall them when you need them rather than opening
    428713containers and setting them up to point at the directories you want and
    429 positioning them where you want each time.  For example, let's say
    430 you're connected to a LAN and have a BBS system running.  You might want
     714positioning them where you want each time. For example, let's say
     715you're connected to a LAN and have a BBS system running. You might want
    431716one State set up specifically for dealing with the LAN, one set up
    432 specifically for maintaining the BBS, and another (or few) for general
    433 work.  Once you've set FM/2 up in each of these conditions and saved the
     717specifically for maintaining the BBS, and another (or a few) for general
     718work. Once you've set FM/2 up in each of these conditions and saved the
    434719State under an easy-to-recall name, you can quickly move from State to
    435 State using the State list.  You'll find this :hp2.much:ehp2. faster and
     720State using the State list. You'll find this :hp2.much:ehp2. faster and
    436721more flexible than the way DOS-think file managers do things.
    437722:p.
     
    441726Holding down the Shift key while selecting a state name prevents FM/2
    442727from closing windows that are already open.
     728:p.
    443729:artwork name='bitmaps\userstat.bmp' align=center.
    444730:p.
    445731.br
    446 The third list is the user-defined commands list.  User-defined commands
    447 allow you to extend FM/2 with commands of your own devising.  You can
     732The third list is the user-defined commands list. User-defined commands
     733allow you to extend FM/2 with commands of your own devising. You can
    448734add, change and delete commands with the :hp1.Config->Edit Commands:ehp1.
    449735menu item (or click B2 on the list).
     736:p.
    450737:artwork name='bitmaps\cmdlist.bmp' align=center.
    451738:p.
    452739.br
    453 The fourth list is the commonly used directory list.  You can add a
    454 directory to this list as above; type in the name, select :hp1.Add
     740The fourth list is the commonly used directory list. You can add a
     741directory to this list as above; type in the name and select :hp1.Add
    455742pathname:ehp1. from a context menu.
     743:p.
    456744:artwork name='bitmaps\useraddd.bmp' align=center.
     745:p.
    457746You can also drag the pathname from the entry field (you'll be dragging
    458 the directory itself), or drag an object onto the control to add it to
    459 the list.  For example, if you have a Directory Container open and
     747the directory itself), or drag an object onto the field to add it to
     748the list. For example, if you have a Directory Container open and
    460749decide it'd be nice to have the directory name in this list, start a
    461750drag in the large status box at the top of the Directory Container (just
     
    466755Directory Container for that path (hold down the Shift key while
    467756selecting the path to cause the current Directory Container to switch
    468 instead).  You can reverse this action with the :hp1.Quicklist
     757instead). You can reverse this action with the :hp1.Quicklist
    469758switches:ehp1. toggle in the :link reftype=hd res=98400.Settings
    470 Notebook:elink..  In addition, the :hp1.Recent Dirs:ehp1. toggle can be
     759Notebook:elink.. In addition, the :hp1.Recent Dirs:ehp1. toggle can be
    471760used to cause FM/2 to automatically add temporary entries for
    472 directories that you visit during a session.  You can add them as above
     761directories that you visit during a session. You can add them as above
    473762to make them permanent if you desire.
    474763:p.
     
    479768allows you to quickly place FM/2 into precisely the configuration you
    480769need to get real work done.
     770:p.
    481771:artwork name='bitmaps\userdirs.bmp' align=center.
    482772:p.
    483773.br
    484774The last list (only present if the Toolbar is on) is a list of
    485 Toolboxes. You can select one from the list.  FM/2 automatically
    486 maintains this list for you.  Initially, the saved toolbox names are
    487 read in from disk (the FM/2 directory), and any you subsequently save
    488 are added to it on the fly.  The FM/2 archive includes a few Toolboxes
     775Toolboxes. You can select one from the list. FM/2 automatically
     776maintains this list for you. Initially, the saved toolbox names are
     777read from disk (the FM/2 directory), and any you subsequently save
     778are added to it on the fly. The FM/2 archive includes a few Toolboxes
    489779for you to look at and customize if you'd like.
     780:p.
    490781:artwork name='bitmaps\usertool.bmp' align=center.
    491782:p.
    492783You can use the font and color palettes to set the colors and fonts
    493 used in these windows.  Note that you must set the entry field and
    494 listbox components separately.  To set the listbox component, drop
     784used in these windows. Note that you must set the entry field and
     785listbox components separately. To set the listbox component, drop
    495786onto the button, not the entry field.
    496787:p.
    497788The :hp1.Interface:ehp1. (list-and-arrow) :hp1.button:ehp1. at the
    498789bottom right corner of the FM/2 window toggles the quicklists on and off.
     790:p.
    499791:artwork name='bitmaps\userbutt.bmp' align=center.
     792
     793.im folder.ipf
     794
     795.im databar.ipf
    500796
    501797.im tutor.ipf
     
    521817
    522818:link reftype=hd res=90700.Commands:elink. are programs that can be run
    523 on selected objects by picking the programs by an assigned title from a
    524 dynamically built submenu of FM/2's Files pulldown menu.
     819on selected objects by picking the program's title from a
     820dynamically built submenu of FM/2's Files menu.
    525821:p.
    526822When commands are displayed in the submenu, visual queues are given as
    527 to the behavior of a given command.  Commands that are checked will run
    528 once for each selected file.  Commands that are framed will prompt the
     823to the behavior of a given command. Commands that are checked will run
     824once for each selected file. Commands that are framed will prompt the
    529825user to edit and accept the command line before running.
    530826:p.
    531827FM/2 provides accelerator keys for the first twenty commands in the
    532 submenu.  The accelerators are listed beside the command's title for
    533 reference.  This provides a "macro key" capability.
    534 :p.
    535 Don't overlook the power of Commands.  This is a simple way of extending
     828submenu. The accelerators are listed beside the command's title for
     829reference. This provides a "macro key" capability.
     830:p.
     831Don't overlook the power of Commands. This is a simple way of extending
    536832FM/2 to do things that it can't do on its own, to automate things, and
    537833to merge those old command line utilities with a PM selection shell (FM/2).
     
    559855.im context.ipf
    560856
    561 .im folder.ipf
    562 
    563857.im arclist.ipf
    564858
     
    567861.im walkem.ipf
    568862
     863.im getnames.ipf
     864
    569865.im chklist.ipf
    570866
     
    578874
    579875.im errors.ipf
    580 
    581 .im keys.ipf
    582 
    583 .im mouse.ipf
    584 
    585 .im getnames.ipf
    586876
    587877:index.
  • trunk/dll/ipf/fm4.ipf

    r2 r268  
    33
    44:artwork name='bitmaps\fm4.bmp' align=center.
    5 "FM/2 Lite" is an alternate "personality" for FM/2.  It's invoked from
     5:p.
     6"FM/2 Lite" is an alternate "personality" for FM/2. It's invoked from
    67the FM4.EXE executable rather than FM3.EXE.
    78:p.
    89This personality is a simplified version of the standard FM/2 interface.
    9 You get two Directory Containers and an optional Drive Tree.  You
     10You get two Directory Containers and an optional Drive Tree. You
    1011have a choice in how to split the screen (:hp1.Windows->Tile
    11 backwards:ehp1.) -- vertically or horizontally.  The internal windows do
     12backwards:ehp1.) -- vertically or horizontally. The internal windows do
    1213not have titlebars and cannot be moved or sized (the Drive Tree, if
    1314open, can have its width changed by dragging the right edge of the
     
    1516:p.
    1617The Files, Views and Utilities menus have been simplified by omitting
    17 seldom used "advanced" commands.  The omitted commands are still
     18seldom used "advanced" commands. The omitted commands are still
    1819available via :link reftype=hd res=93700.context menus:elink. and
    19 accelerator keys.  A few other features have been left out to simplify
    20 the interface.  If you consider yourself an advanced user, what are you
     20accelerator keys. A few other features have been left out to simplify
     21the interface. If you consider yourself an advanced user, what are you
    2122doing here?  &colon.-)
    2223:p.
     
    2425If the Drive Tree is active and the current window, the Directory
    2526Container that will be affected by double-clicking a directory in the
    26 Tree is surrounded by a dark red line.  Tab and Shift-Tab can be used
     27Tree is surrounded by a dark red line. Tab and Shift-Tab can be used
    2728to switch between the windows.
    2829:p.
  • trunk/dll/ipf/folder.ipf

    r10 r268  
    1 :h1 res=91900 name=PANEL_FOLDERBUTTON.Folder Button
     1:h2 res=91900 name=PANEL_FOLDERBUTTON.Folder Button
    22:i1 id=aboutFolderButton.Folder Button
    33:artwork name='..\..\bitmaps\pmap.bmp' align=center.
     4:p.
    45Folder buttons appear on directory and archive containers at the top
    5 center of the window (below the title bar).  They provide several
     6center of the window (below the title bar). They provide several
    67shortcuts for their containers.
    78:p.
     
    5051You can also drag a file or directory object onto the folder button. In
    5152directory containers, the directory "switches" to "look at" the
    52 directory of the dropped object.  In archive containers, the extract
    53 directory changes to that of the directory of the dropped object.  This
     53directory of the dropped object. In archive containers, the extract
     54directory changes to that of the directory of the dropped object. This
    5455means that, for instance, you can set the extract directory for an
    5556archive to the same directory that the archive is in by dragging from a
  • trunk/dll/ipf/getnames.ipf

    r2 r268  
    33
    44This works exactly like the standard OS/2 file dialog with the exception
    5 that it contains a :hp6.UserDirs:ehp6. dropdown list.  See the :link
     5that it contains a :hp6.UserDirs:ehp6. dropdown list. See the :link
    66reftype=hd res=91500.Walk Directories:elink. topic for more info on
    77user directories, including how to set them up.
    88:p.
    99The idea here is pretty simple -- you want to give the dialog a
    10 filename.  You can type it directly into the :hp6.Filename:ehp6. entry
     10filename. You can type it directly into the :hp6.Filename:ehp6. entry
    1111field or select it using the list controls.
    1212:p.
     
    1414drive. The :hp6.Directories:ehp6. listbox can be used to switch
    1515directories on the current drive (as can the :hp6.UserDirs:ehp6.
    16 dropdown).  The :hp6.Files:ehp6. listbox can be used to pick an existing
     16dropdown). The :hp6.Files:ehp6. listbox can be used to pick an existing
    1717file.
    1818:p.
  • trunk/dll/ipf/hints.ipf

    r2 r268  
    33
    44:artwork name='bitmaps\secret.bmp' align=center.
     5:p.
    56This section contains hints about obscure functions, FM/2 "secrets" and
    67other rubbish.
     
    1314:p.
    1415Want to copy or move some files to a new directory?  Try dragging them
    15 onto an empty area (whitespace) of the Drive tree.  FM/2 will pop up a
     16onto an empty area (whitespace) of the Drive tree. FM/2 will pop up a
    1617dialog allowing you to specify a name for a new directory into which to
    1718place the files.
     
    1920To set the label of a drive, pick :link reftype=hd
    2021res=90900.Files->Info:elink. (Ctrl + i accelerator) on the root of the
    21 drive in the Drive Tree container.  You'll find :hp1.Format:ehp1. and
     22drive in the Drive Tree container. You'll find :hp1.Format:ehp1. and
    2223:hp1.Chkdsk:ehp1. in that menu, too, under the :hp1.Miscellaneous:ehp1.
    2324submenu.
     
    2526Remember, when using the :link reftype=hd res=93900.internal
    2627editor:elink. (but don't, use your favorite editor instead), FM/2 saves
    27 the file as it appears in the MLE.  If you don't want long lines wrapped
     28the file as it appears in the MLE. If you don't want long lines wrapped
    2829(such as when editing CONFIG.SYS), turn wrap OFF before saving.
    2930:p.
    3031If you want to change the fonts used in the :link reftype=hd
    3132res=91500.Walk Directories:elink. dialog, drop a new font from the Font
    32 Palette onto a blank area of the dialog (not a control).  The new font
     33Palette onto a blank area of the dialog (not a control). The new font
    3334will be used in the directory listboxes and path entry field the next
    34 time you use the dialog.  This is sometimes necessary when the default
     35time you use the dialog. This is sometimes necessary when the default
    3536font for the dialog doesn't match up well to the codepage in use for
    3637non-US users, as non-ASCII characters might show up improperly.
     
    3940association, try Open->Default from a context menu on the file object
    4041(F6 accelerator) or holding down the Ctrl key while double-clicking the
    41 object.  Alternatively, use <> as the command line for an :link
     42object. Alternatively, use <> as the command line for an :link
    4243reftype=hd res=90400.association:elink. and it'll open the object's
    4344default WPS view, which will run the program associated with the object
    44 under the WPS if there is one.  Follow the hypertext link in this
     45under the WPS if there is one. Follow the hypertext link in this
    4546paragraph for detailed explanations.
    4647:p.
     
    4950and :link reftype=hd res=90100.Collecting:elink. them from that list
    5051file so you don't have to reselect them when you want to manipulate them
    51 later.  Note that FM/2 has a Reselect command under the Views->Select
     52later. Note that FM/2 has a Reselect command under the Views->Select
    5253menu, but it only remembers the last selection set -- using the
    5354List/Collect method you can reselect even in another session.
    5455:p.
    55 Using :hp1.AV/2:ehp1. from the WPS&colon.  Drag an archive file onto the
    56 AV/2 object; this opens a view into the archive.  Drag any files you
     56Using :hp1.AV/2:ehp1. from the WPS&colon. Drag an archive file onto the
     57AV/2 object; this opens a view into the archive. Drag any files you
    5758want added to the archive into the container; they're added to the
    5859archive. To create a new archive, drag the objects to be archived onto
    5960the :hp1.Make Archive:ehp1. object.
    6061:p.
    61 For advanced users&colon.  You can add commands to FM/2's action bar
    62 menu. Create a file in FM/2's directory called FM3MENU.DAT.  Here's a
     62For advanced users&colon. You can add commands to FM/2's action bar
     63menu. Create a file in FM/2's directory called FM3MENU.DAT. Here's a
    6364sample&colon.
    6465:xmp.
    6566;
    6667;Items listed in this file are added to FM/2's action bar (pulldown) menu.
    67 ;First word in a line MUST be MENUITEM.  Next comes ID of command (see
    68 ;FM3TOOLS.DAT).  Finally, the text to display on the menu for the command.
     68;First word in a line MUST be MENUITEM. Next comes ID of command (see
     69;FM3TOOLS.DAT). Finally, the text to display on the menu for the command.
    6970;
    7071;Any line beginning with a semi-colon, like this one, is a comment.
     
    8283is in, start a drag from the recessed text field next to the :link
    8384reftype=hd res=91900.Folder button:elink. and drop onto the Folder
    84 button.  If you always want the extract directory to be the same as the
     85button. If you always want the extract directory to be the same as the
    8586directory in which the archive resides, enter * in the Ext. Path field
    8687of the internal Settings Notebook's :link reftype=hd res=99940.Archivers
     
    9697the container to sort on that field (assuming the field is one of those
    9798on which FM/2 will sort -- filename, size, EA size, and dates are all
    98 valid).  Works in Archive Containers, too.
     99valid). Works in Archive Containers, too.
    99100:p.
    100101Can't set the :hp3.default sort or view for new Directory
     
    102103res=97100.internal Settings notebook:elink. instead of the popup menus.
    103104The popups only change the :hp1.current:ehp1. container -- the one on
    104 which you requested the context menu.  The Settings notebook determines
    105 how new containers that you open will appear.  This is a distinction
     105which you requested the context menu. The Settings notebook determines
     106how new containers that you open will appear. This is a distinction
    106107often overlooked by new users.
    107108:p.
    108109Old DOS hands will know this, but you can enter :hp2.PRN:ehp2. when you
    109 want output to go to a printer rather than a disk file.  You can even
     110want output to go to a printer rather than a disk file. You can even
    110111specify different printers using LPT? (i.e. LPT1, LPT2, LPT3, etc.).
    111112:p.
    112113If nothing shows in a Directory Container, Archive Container, the
    113114Collector or Drive Tree although you :hp1.know:ehp1. there's something
    114 in it, check your Filter (Ctrl + f accelerator).  The Filter button for
     115in it, check your Filter (Ctrl + f accelerator). The Filter button for
    115116the appropriate container will show the current filter status for the
    116117current container (F&colon.<All> means everything is visible, <Attr>
    117118means attributes are being used to filter, otherwise you'll see the
    118119current mask set). Remember to look at the attributes as well as the
    119 mask.  The :hp1.All:ehp1. button in the :link reftype=hd
     120mask. The :hp1.All:ehp1. button in the :link reftype=hd
    120121res=93400.Filter dialog:elink. can be used to ensure that everything is
    121122visible.
     
    127128drag the directory the Directory Container is "looking" into, and when
    128129you drop :hp1.on:ehp1. one of them, you drop into the directory the
    129 Directory Container is "looking" into.  They behave, for drag and drop
     130Directory Container is "looking" into. They behave, for drag and drop
    130131and requesting context menus, like empty container space (whitespace).
    131132:p.
    132133To begin a direct edit of the current file's name using the keyboard,
    133 use Ctrl + F10.  To end (complete) the direct edit, use Ctrl + F11. To
     134use Ctrl + F10. To end (complete) the direct edit, use Ctrl + F11. To
    134135cancel an edit underway, use Escape.
    135136:p.
    136137PM uses several ALT + F? accelerators to control frame windows. However,
    137138this applies to the current frame window, which can be within the main
    138 FM/2 window when run monolithically.  Add Ctrl to these accelerators to
    139 affect the main window in that case.  For example, Ctrl + Alt + F9 will
     139FM/2 window when run monolithically. Add Ctrl to these accelerators to
     140affect the main window in that case. For example, Ctrl + Alt + F9 will
    140141minimize the main FM/2 window, while Alt + F9 will minimize whichever
    141142frame window has the focus.
     
    145146the first button) on them will change your sort type.
    146147:p.
    147 Problem with ZIP or EZ drive -- slow scanning&colon.  See :link
    148 reftype=hd res=99980.Edit->Drive flags:elink. command.  The problem
     148Problem with ZIP or EZ drive -- slow scanning&colon. See :link
     149reftype=hd res=99980.Edit->Drive flags:elink. command. The problem
    149150is that these drives respond :hp1.very:ehp1. slowly to some commands
    150 and requests.  You can tweak the drive's flags to alleviate some of
     151and requests. You can tweak the drive's flags to alleviate some of
    151152this.
    152153:p.
    153 Problem with details view refreshing -- top items come up blank.  This
    154 is one of those never-fixed OS/2 bugs.  Try :hp1.unchecking:ehp1. the
    155 Immediate updates toggle in the Settings notebook.  This usually works
     154Problem with details view refreshing -- top items come up blank. This
     155is one of those never-fixed OS/2 bugs. Try :hp1.unchecking:ehp1. the
     156Immediate updates toggle in the Settings notebook. This usually works
    156157around this bug.
    157158:p.
    158159To find any directory in the Drive Tree quickly, type Ctrl + Shift + F
    159160with the Drive Tree active, then type in the pathname of the directory
    160 that you want to find.  To find the directory of a Directory Container
     161that you want to find. To find the directory of a Directory Container
    161162in the Drive Tree, type Ctrl + Shift + F with the Directory Container
    162163active.
     
    164165The :link reftype=hd res=90100.Collector:elink. can search for files
    165166based on a variety of criteria. The search function can also find
    166 potential duplicate files for you.  Potential duplicates can also be
     167potential duplicate files for you. Potential duplicates can also be
    167168tracked down in the :link reftype=hd res=98500.See all files:elink.
    168169control.
    169170:p.
    170 You can selectively turn off FM/2's bubble help.  Use the internal
     171You can selectively turn off FM/2's bubble help. Use the internal
    171172Settings notebook, turn to the :hp1.Bubbles:ehp1. page, and read the
    172173help.
     
    174175"I double-clicked on an INI file and FM/2 showed it in the text viewer."
    175176The INI file may not be a standard OS/2 INI file (Windoze programs, for
    176 example, use *.INI files that are flat text files).  FM/2 will "fail"
     177example, use *.INI files that are flat text files). FM/2 will "fail"
    177178quietly to view such files using the INI viewer when you double-click
    178179them since there's no reason to bother you each time you want to look at
    179 one.  If you're sure the file is a standard OS/2 INI file, use the
     180one. If you're sure the file is a standard OS/2 INI file, use the
    180181Utilities menu to open the INI viewer, then choose Files->Other profile
    181 and enter the name of the file.  FM/2 will then tell you the reason that
     182and enter the name of the file. FM/2 will then tell you the reason that
    182183it is unable to open the file -- you probably want to know about it since
    183184you're already in the INI viewer.
     
    197198else, for that matter -- I mention self-extracting archives because FM/2
    198199will attempt to view them rather than run them when you double-click
    199 them), press Ctrl + F5.  This brings up the :link reftype=hd
     200them), press Ctrl + F5. This brings up the :link reftype=hd
    200201res=90600.Command line:elink. dialog with the cursored file in the entry
    201202field.
     
    206207:p.
    207208Alternatively, if running FM/2 monolithically, press F5 to get a
    208 miniature command line at the bottom of the window.  Enter any commands
     209miniature command line at the bottom of the window. Enter any commands
    209210you'd like here, including :link reftype=hd
    210 res=100075.metastrings:elink..  Type /HELP in the command line entry
     211res=100075.metastrings:elink.. Type /HELP in the command line entry
    211212field for brief information specific to this control.
    212213:p.
    213214Note that if you use the same command line time after time you will
    214215probably want to set up a :link reftype=hd res=90700.Command:elink.
    215 for the command line to save time.  With a Command, you can even
     216for the command line to save time. With a Command, you can even
    216217execute a command line using an accelerator key -- can't beat that
    217218for speed.
  • trunk/dll/ipf/inis.ipf

    r10 r268  
    33
    44:artwork name='..\..\bitmaps\ini.bmp' align=center.
    5 INI files are a form of data file that OS/2 provides to applications and
    6 utilizes itself.  This viewer allows you to take a peek inside them.
    75:p.
    8 Two special INIs are used by the system.  They are the User INI (usually
    9 OS2.INI) and the System INI (usually OS2SYS.INI).  Both are usually
    10 located in the \OS2 directory of your boot drive.  FM/2 will tell you
     6INI files are a type of configuration file that OS/2 provides to applications and
     7utilizes itself. This viewer allows you to take a peek inside them and modify
     8them as needed. :hp2.:hp8.Caution:ehp8.:ehp2.Backup the INI file before modifying
     9it since corruption of an INI file can result in failure of a program including
     10the WPS to run.
     11:p.
     12Two special INIs are used by the system. They are the User INI (usually
     13OS2.INI) and the System INI (usually OS2SYS.INI). Both are usually
     14located in the \OS2 directory of your boot drive. FM/2 will tell you
    1115where they are when you view them.
    1216:p.
     
    1519:p.
    1620A record in an INI is composed of three parts:  An application name,
    17 a keyname, and data.  This three-part format is represented in the
    18 window by three listboxes.  When you choose an application name and
     21a keyname, and data. This three-part format is represented in the
     22window by three listboxes. When you choose an application name and
    1923a keyname, you see the data associated with them.
    2024:p.
     
    2327:hp1.Edit->Delete Application:ehp1., or to delete individual keynames,
    2428deleting the data associated with them with :hp1.Edit->Delete
    25 Keyname:ehp1..  You can also copy or rename entire application names
     29Keyname:ehp1.. You can also copy or rename entire application names
    2630or application+keynames.
    2731:p.
    2832The :hp1.Files->User Profile:ehp1. command loads the user INI (usually
    2933OS2.INI) and the :hp1.Files->System Profile:ehp1. command loads the
    30 system INI (usually OS2SYS.INI).  The :hp1.Files->Other Profile:ehp1.
    31 command allows you to pick an INI file to load.  The
     34system INI (usually OS2SYS.INI). The :hp1.Files->Other Profile:ehp1.
     35command allows you to pick an INI file to load. The
    3236:hp1.Files->Refresh:ehp1. command will refresh the contents of the
    3337listboxes from the INI file on disk; handy if a background process might
     
    3640The :hp1.Entries->Filter appnames:ehp1. command can be used to
    3741selectively remove or include application names from the first listbox
    38 via a dialog that pops up when the command is selected.  One filter
     42via a dialog that pops up when the command is selected. One filter
    3943"mask" should be entered per line in the MLE; preface "masks" with "/"
    4044to cause the following mask to exlude rather than include items.
     
    4246Note that the Filter command removes entries from the listbox;
    4347refiltering with a more inclusive set of masks will not restore filtered
    44 entries.  Use the :hp1.Files->Refresh:ehp1. command for that.
     48entries. Use the :hp1.Files->Refresh:ehp1. command for that.
    4549:p.
    4650The :hp1.Utilities->Backup Profile:ehp1. creates a backup of the current
    47 profile.  You get to specify the filename. The :hp1.Utilities->Change
     51profile. You get to specify the filename. The :hp1.Utilities->Change
    4852System Profiles:ehp1. command lets you change the User and System
    49 profiles that OS/2 uses.  The :hp1.Utilities->Replace System
     53profiles that OS/2 uses. The :hp1.Utilities->Replace System
    5054Profiles:ehp1. command lets you replace the default system profiles with
    5155new profiles; the old files are physically overwritten.
    5256:p.
    53 You can also drag from and to the top two listboxes in this window.  If
     57You can also drag from and to the top two listboxes in this window. If
    5458you drag from the left window, you drag the current application name,
    55 all its keynames, and all the data associated with the keynames.  If you
     59all its keynames, and all the data associated with the keynames. If you
    5660drag from the right window, you drag the current application and
    57 keynames, and all the data associated with the keyname.  You can either
     61keynames, and all the data associated with the keyname. You can either
    5862move or copy the record(s) using the standard key modifiers (you did read
    5963the :link reftype=hd res=90000.General Help:elink. topic, didn't you?).
     
    6165This window is reached via the :hp1.Utilities:ehp1. pulldown menu on
    6266FM/2's main window, or by selecting (double-clicking) an INI file in a
    63 directory window, or by starting it from the FM/2 folder.  The
     67directory window, or by starting it from the FM/2 folder. The
    6468double-click behavior can be changed by specifying an association for
    6569*.INI under FM/2's main :hp1.Config->Edit Associations:ehp1. pulldown.
     
    7882To add an INI record, fill in the three entry fields on the screen. The
    7983appname and keyname pair, together, should form a unique ID, or you'll
    80 end up replacing existing data rather than adding new data.  Then click
    81 Okay.  Click Cancel to abort.
     84end up replacing existing data rather than adding new data. Then click
     85Okay. Click Cancel to abort.
    8286:p.
    8387You can check the :hp1.:link reftype=hd res=99500.Use
    8488\-encoding:elink.:ehp1. checkbox if you want to enter or edit binary
    85 data.  FM/2 attempts to determine the type of data if you're editing
     89data. FM/2 attempts to determine the type of data if you're editing
    8690rather than adding and sets the checkbox for you accordingly.
    8791:p.
     
    9599FM/2 lets you change the INIs that OS/2 uses while OS/2 is still active.
    96100This, together with the Backup Profile command, allow you to create and
    97 use alternate profiles.  Note that this doesn't change the physical INI
     101use alternate profiles. Note that this doesn't change the physical INI
    98102files, it just points OS/2 at the new files; when you reboot, the files
    99103specified in CONFIG.SYS are used.
    100104:p.
    101 There are a couple of potential uses for this function.  You might use
    102 it to maintain different desktops and switch between them.  You might
     105There are a couple of potential uses for this function. You might use
     106it to maintain different desktops and switch between them. You might
    103107use it to allow you to copy backed up profiles to OS2.INI and OS2SYS.INI
    104108(the default OS/2 profiles -- do this by first switching to a different
    105109set of profiles, then copying your backups onto OS2.INI and OS2SYS.INI,
    106 then restoring OS2.INI and OS2SYS.INI as the system profiles.  You can't
     110then restoring OS2.INI and OS2SYS.INI as the system profiles. You can't
    107111do this normally as the system profiles are readonly and can't be
    108112overwritten.).
    109113:p.
    110 Note that when the change occurs, OS/2 will restart the WPS.  It's
     114Note that when the change occurs, OS/2 will restart the WPS. It's
    111115recommended that you back up your system INIs before using this and
    112116shut down all other running processes first.
     
    116120
    117121This dialog physically replaces the OS/2 system INIs with the INI files
    118 you select.  The change is permanent.
     122you select. The change is permanent.
    119123:p.
    120124Note that when the change occurs, OS/2 will restart the WPS (twice).
    121125It's HIGHLY recommended that you back up your system INIs before using
    122 this and shut down all other running processes first.  (Use of this
     126this and shut down all other running processes first. (Use of this
    123127after having used the :link reftype=hd res=96800.Change System
    124128Profiles:elink. command probably won't do what you expect unless you
     
    134138keyname if copying or renaming a specific application+keyname pair).
    135139Once you've filled in the new name(s), click Okay to perform the
    136 operation.  Click Cancel if you change your mind.
     140operation. Click Cancel if you change your mind.
    137141
    138142:h3 res=99700 name=PANEL_FILTERINI.Filter INIs
     
    140144
    141145This dialog can selectively remove or include application names from the
    142 first listbox.  One filter "mask" should be entered per line in the MLE;
     146first listbox. One filter "mask" should be entered per line in the MLE;
    143147preface "masks" with "/" to cause the following mask to exlude rather
    144148than include items.
     
    146150Note that the Filter command removes entries from the listbox;
    147151refiltering with a more inclusive set of masks will not restore filtered
    148 entries.  Use the :hp1.Files->Refresh:ehp1. command for that.
     152entries. Use the :hp1.Files->Refresh:ehp1. command for that.
    149153
  • trunk/dll/ipf/keys.ipf

    r2 r268  
    1 :h1 res=100005 name=PANEL_KEYS.Keys help
     1:h2 res=100005 name=PANEL_KEYS.Keys help
    22:i1 id=aboutKeys.Keys help
    33
    44:hp2.Directory Containers:ehp2.
    55.br
    6 :hp1.Note&colon.:ehp1.  many commands also available in Drive Tree and
     6:hp1.Note&colon.:ehp1. many commands also available in Drive Tree and
    77Collector windows.
    88:parml compact tsize=20 break=none.
     
    454454:p.
    455455Remember, :link reftype=hd res=97700.accelerator keys:elink. are case
    456 sensitive -- Ctrl + r isn't the same thing as Ctrl + R.  The latter is
     456sensitive -- Ctrl + r isn't the same thing as Ctrl + R. The latter is
    457457obtained by holding down both Ctrl and Shift while pressing the "R" key.
  • trunk/dll/ipf/merge.ipf

    r2 r268  
    44This dialog allows you to order the files to be merged (they're shown in
    55the listbox at the top of the dialog) and set the Target (the file that
    6 will contain the merged files).  The :hp1.Merge:ehp1. command is under
     6will contain the merged files). The :hp1.Merge:ehp1. command is under
    77the :hp1.Files->Copy:ehp1. conditional cascade menu.
    88:p.
    99When you click :hp1.Okay:ehp1., each file, in order, is appended to the
    10 Target filename.  The merged files are not deleted. If :hp1.Append:ehp1.
     10Target filename. The merged files are not deleted. If :hp1.Append:ehp1.
    1111is checked, the Target file is appended if it exists; otherwise, it's
    12 overwritten by the first merge file.  If :hp1.Binary:ehp1. is checked,
     12overwritten by the first merge file. If :hp1.Binary:ehp1. is checked,
    1313the files are copied in binary mode; otherwise, they're copied in text
    1414mode.
    1515:p.
    1616To order the files, select a listbox item and click either
    17 :hp1.Top:ehp1. or :hp1.Bottom:ehp1..  You can also :hp1.Remove:ehp1. a
    18 highlighted file from the list.  If you need to, you can :hp1.Undo:ehp1.
     17:hp1.Top:ehp1. or :hp1.Bottom:ehp1.. You can also :hp1.Remove:ehp1. a
     18highlighted file from the list. If you need to, you can :hp1.Undo:ehp1.
    1919the changes you've made and put the listbox back like it was when the
    2020dialog first came up.
     
    2222If you want to edit a file, double-click it in the listbox.
    2323:p.
    24 When you're done, click :hp1.Okay:ehp1..  If you changed your mind, click
     24When you're done, click :hp1.Okay:ehp1.. If you changed your mind, click
    2525:hp1.Cancel:ehp1..
  • trunk/dll/ipf/mouse.ipf

    r2 r268  
    1 :h1 res=100040 name=PANEL_MOUSE.Mouse click help
     1:h2 res=100040 name=PANEL_MOUSE.Mouse click help
    22:i1 id=aboutMouse.Mouse click help
    33
  • trunk/dll/ipf/notebook.ipf

    r10 r268  
    22:i1 id=aboutSettings.Settings Notebook
    33FM/2's internal Settings notebook lets you fiddle with some of the
    4 toggles and variables used to control how FM/2 behaves.  This is called
     4toggles and variables used to control how FM/2 behaves. This is called
    55up via the :hp1.:link reftype=hd res=92000.Config:elink.->Settings
    66notebook...:ehp1. pulldown menu item.
     
    1111:p.
    1212Note that settings changes generally don't take effect until you close
    13 the notebook by clicking the :hp1.Okay:ehp1. button.  The
     13the notebook by clicking the :hp1.Okay:ehp1. button. The
    1414:hp1.Undo:ehp1. button will restore things to the way they were before
    15 you started fiddling about.  The :hp1.Quick:ehp1. page is a notable
     15you started fiddling about. The :hp1.Quick:ehp1. page is a notable
    1616exception.
    1717:p.
     
    5252
    5353:artwork name='bitmaps\dir.bmp' align=left.
     54:p.
    5455This page contains controls that affect Directory Containers.
    5556:p.
     
    5960Normally FM/2 updates the container as things change; for instance, if
    6061you're deleting several files, the container is updated after each file
    61 is deleted.  If you uncheck :hp6.Immediate updates:ehp6., FM/2 updates
     62is deleted. If you uncheck :hp6.Immediate updates:ehp6., FM/2 updates
    6263the container after an atomic action completes (i.e. after all files
    63 moved by one operation have been moved).  This speeds up processing
    64 but allows the container to be temporarily "out of synch" with the real
     64moved by one operation have been moved). This speeds up processing
     65but allows the container to be temporarily "out of sync" with the real
    6566state of affairs.
    6667:p.
     
    6869looks inside an open Directory Container when deciding what default to
    6970place in the Walk Directories dialog for a copy or move command invoked
    70 via keyboard, menu or toolbar button.  If this is checked, FM/2 looks at
     71via keyboard, menu or toolbar button. If this is checked, FM/2 looks at
    7172the current item in the Directory Container and, if it's a directory
    72 object, uses that path.  If not checked, FM/2 uses the directory into
     73object, uses that path. If not checked, FM/2 uses the directory into
    7374which the Directory Container is "looking."
    7475:p.
    7576The :hp6.Min dir on open:ehp6. toggle, if checked, causes FM/2 to
    7677minimize a Directory Container window if you open another Directory
    77 Container window from one of its objects.  When you close the new
     78Container window from one of its objects. When you close the new
    7879Directory Container window the old window is restored.
    7980:p.
     
    8687object starting with the depressed letter and the object is selected.
    8788Note that you can get this standard effect with this toggle left on by
    88 pressing the Shift key along with the letter.  Container searching
     89pressing the Shift key along with the letter. Container searching
    8990allows you to enter multiple characters which are searched for at the
    90 start of filenames.  The record is made the current (cursored) object.
     91start of filenames. The record is made the current (cursored) object.
    9192If the record matches all the letters typed exactly, it is also
    92 selected.  A pause of more than about two seconds in typing resets the
    93 search string.  :hp1.Warning:ehp1.&colon. this doesn't work right on
     93selected. A pause of more than about two seconds in typing resets the
     94search string. :hp1.Warning:ehp1.&colon. this doesn't work right on
    9495some versions of Warp, where the OS/2 CM_SEARCHSTRING container
    95 message's behavior is buggy.  It's not dangerous, it just doesn't
     96message's behavior is buggy. It's not dangerous, it just doesn't
    9697produce the expected results.
    9798:p.
    9899The :hp6.Multiple select cnrs:ehp6. and :hp6.Extended select cnrs:ehp6.
    99100checkboxes control the type of selection in some new containers (existing
    100 containers are not affected).  Collector, Directory Container and Archive
     101containers are not affected). Collector, Directory Container and Archive
    101102Containers created after these settings are changed will have the type of
    102103selection desired (note:  unhighlighting both results in a single select
    103 container -- probably not desirable).  The default is Extended select.
     104container -- probably not desirable). The default is Extended select.
    104105:p.
    105106The :hp6.Stay in Tree View:ehp6. switch, if checked, causes Directory
    106107Containers to remain in Tree View (if already in Tree View, of course)
    107108when you switch the Directory Container to look into a different
    108 directory.  Otherwise, FM/2 switches the Directory Container back to
     109directory. Otherwise, FM/2 switches the Directory Container back to
    109110the last used view before you put it into Tree View.
    110111
     112The :hp6.No folder menu:ehp6. switch, if checked, causes a B2 click on the
     113folder icon to immediately load the previous directory in the Directory Container.
     114Otherwise it results in the folder menu appearing.
    111115
    112116:h3 res=97100 name=PANEL_DCPAGEVIEWS.Directory Container views page
     
    114118
    115119:artwork name='bitmaps\dir.bmp' align=left.
     120:p.
    116121This settings page lets you set the type of view that will be used in
    117 new Directory Container windows.  Directory Containers that are already
     122new Directory Container windows. Directory Containers that are already
    118123open won't be affected.
    119124:p.
    120 :hp6.Icon:ehp6.  In Icon view, the object's name appears below its icon.
    121 :p.
    122 :hp6.Name:ehp6.  In Name view, the object's name appears beside its icon.
    123 :p.
    124 :hp6.Text:ehp6.  Text view is the fastest view for a container to
     125:hp6.Icon:ehp6. In Icon view, the object's name appears below its icon.
     126:p.
     127:hp6.Name:ehp6. In Name view, the object's name appears beside its icon.
     128:p.
     129:hp6.Text:ehp6. Text view is the fastest view for a container to
    125130maintain, but provides the least information on the objects it contains.
    126131:p.
    127 :hp6.Detail:ehp6.  Details view shows a great deal of information on the
     132:hp6.Detail:ehp6. Details view shows a great deal of information on the
    128133objects it contains, including file sizes, dates, and times, but it is
    129134the slowest view for a container control to maintain.
     
    133138:p.
    134139The :hp6.Field Titles:ehp6. group (analogous to the Views->Details Setup
    135 submenu) allows you to control what is shown in a Details view.  Each
    136 possible field in the details view is shown.  If the field is checked,
    137 FM/2 will show it.  If not, it won't.
     140submenu) allows you to control what is shown in a Details view. Each
     141possible field in the details view is shown. If the field is checked,
     142FM/2 will show it. If not, it won't.
    138143:p.
    139144The :hp6.Filter:ehp6. entry field shows the current default filter mask
    140 for Directory Containers.  Moving to this field will bring up a dialog
    141 that lets you set a new filter.  The filter will be used for subsequently
     145for Directory Containers. Moving to this field will bring up a dialog
     146that lets you set a new filter. The filter will be used for subsequently
    142147created Directory Containers.
    143148
     
    146151
    147152:artwork name='bitmaps\dir.bmp' align=left.
     153:p.
    148154This page lets you set the type of sort for Directory Containers.
    149155Directory Containers that are already open won't be affected immediately
     
    152158:p.
    153159You can also tell FM/2 to always display directories ahead of or behind
    154 files.  Note that :hp1.Last access date:ehp1. and :hp1.Creation
     160files. Note that :hp1.Last access date:ehp1. and :hp1.Creation
    155161date:ehp1. are only meaningful for HPFS file systems; FAT file systems
    156 do not track this information.  The difference between
     162do not track this information. The difference between
    157163:hp1.Pathname:ehp1. and :hp1.Filename:ehp1. is only apparent in the
    158 Collector.  With the former, the entire pathname of the object is used
    159 to sort.  With the latter, only the filename portion is used to sort.
     164Collector. With the former, the entire pathname of the object is used
     165to sort. With the latter, only the filename portion is used to sort.
    160166FM/2 maintains separate sort criteria for Drive Tree, Collector,
    161 Directory Container and Archive Container windows.  This page affects
    162 only Directory Container sorting.  The Collector has its own page; use a
     167Directory Container and Archive Container windows. This page affects
     168only Directory Container sorting. The Collector has its own page; use a
    163169context menu or View pulldown menu for other container types (like the
    164170Drive Tree).
    165171:p.
    166 :hp7.Note&colon.:ehp7.  This page controls how new Directory Containers
     172:hp7.Note&colon.:ehp7. This page controls how new Directory Containers
    167173are created (already open containers are not affected), and the context
    168174menu in Directory Containers affects only the Directory Container from
     
    173179
    174180:artwork name='bitmaps\collect.bmp' align=left.
     181:p.
    175182This settings page lets you set the type of view that will be used in
    176 new Collector windows.  If the Collector is already open it won't be
     183new Collector windows. If the Collector is already open it won't be
    177184affected unless you close and reopen it.
    178185:p.
    179 :hp6.Icon:ehp6.  In Icon view, the object's name appears below its icon.
    180 :p.
    181 :hp6.Name:ehp6.  In Name view, the object's name appears beside its icon.
    182 :p.
    183 :hp6.Text:ehp6.  Text view is the fastest view for a container to
     186:hp6.Icon:ehp6. In Icon view, the object's name appears below its icon.
     187:p.
     188:hp6.Name:ehp6. In Name view, the object's name appears beside its icon.
     189:p.
     190:hp6.Text:ehp6. Text view is the fastest view for a container to
    184191maintain, but provides the least information on the objects it contains.
    185192:p.
    186 :hp6.Detail:ehp6.  Details view shows a great deal of information on the
     193:hp6.Detail:ehp6. Details view shows a great deal of information on the
    187194objects it contains, including file sizes, dates, and times, but it is
    188195the slowest view for a container control to maintain.
     
    192199:p.
    193200The :hp6.Field Titles:ehp6. group (analogous to the Views->Details Setup
    194 submenu) allows you to control what is shown in a Details view.  Each
    195 possible field in the details view is shown.  If the field is checked,
    196 FM/2 will show it.  If not, it won't.
     201submenu) allows you to control what is shown in a Details view. Each
     202possible field in the details view is shown. If the field is checked,
     203FM/2 will show it. If not, it won't.
    197204:p.
    198205The :hp6.Filter:ehp6. entry field shows the current filter mask for the
    199 Collector.  Moving to this field will bring up a dialog that lets you set
    200 a new filter.  The filter will be used for subsequent invocations of the
     206Collector. Moving to this field will bring up a dialog that lets you set
     207a new filter. The filter will be used for subsequent invocations of the
    201208Collector.
    202209
     
    205212
    206213:artwork name='bitmaps\collect.bmp' align=left.
    207 This page lets you set the type of sort for the Collector.  If the
     214:p.
     215This page lets you set the type of sort for the Collector. If the
    208216Collector is already open it won't be affected immediately, (see
    209217:hp1.Resort:ehp1. context menu command), but will use the new sort type
     
    211219:p.
    212220You can also tell FM/2 to always display directories ahead of or behind
    213 files.  Note that :hp1.Last access date:ehp1. and :hp1.Creation
     221files. Note that :hp1.Last access date:ehp1. and :hp1.Creation
    214222date:ehp1. are only meaningful for HPFS file systems; FAT file systems
    215 do not track this information.  The difference between
     223do not track this information. The difference between
    216224:hp1.Pathname:ehp1. and :hp1.Filename:ehp1. is only apparent in the
    217 Collector.  With the former, the entire pathname of the object is used
    218 to sort.  With the latter, only the filename portion is used to sort.
     225Collector. With the former, the entire pathname of the object is used
     226to sort. With the latter, only the filename portion is used to sort.
    219227FM/2 maintains separate sort criteria for Drive Tree, Collector,
    220 Directory Container and Archive Container windows.  This page affects
     228Directory Container and Archive Container windows. This page affects
    221229only :link reftype=hd res=90100.Collector:elink. sorting.
    222230
    223 
    224 :h3 res=92400 name=PANEL_TREEPAGE.Drive Tree page
    225 :i1 id=aboutTREEP.Drive Tree page
     231:h3 res=99940 name=PANEL_ARCPAGE.Archive page
     232:i1 id=aboutARCP.Archive page
     233
     234:artwork name='bitmaps\archive.bmp' align=left.
     235:p.
     236This page contains controls relating to archivers and Archive
     237Containers.
     238:p.
     239The :hp6.Quick arc find:ehp6. toggle, if checked, causes FM/2 to check
     240only files with extensions that match those configured in ARCHIVER.BB2
     241as potential archives during a drag and drop operation. If you're
     242dragging over files on a floppy or network directory, this can speed
     243things up a bit.
     244:p.
     245The :hp6.Folder after extract:ehp6. toggle, if on, causes FM/2 to create
     246a folder to hold objects extracted from an archive via an Archive
     247Container. You'll be given an opportunity to abort the folder creation
     248or to decide where the folder will be located and what it'll be named.
     249:p.
     250You can set a :hp6.Default archiver:ehp6. so that, when you're archiving
     251files and directories, this archiver is the default for the :hp1.Select
     252Archiver:ehp1. dialog.
     253:p.
     254If the :hp6.Show archiver activity:ehp6. toggle is checked, FM/2 runs
     255archiver windows in the foreground. Normally it runs them in the
     256background, minimized, so you'd have to use the task list to pull them
     257to the foreground if you want to see them.
     258:p.
     259The :hp6.A/Virus:ehp6. field allow you to enter the command line
     260(PATH/ANTIVIRUS&period.EXE parameters) for your antivirus software
     261This must be done to enable virus checking of archives from FM/2.
     262NVCC&period.EXE &percent.p /C is one possible command line option
     263if you are using Norman Antivirus.
     264:p.
     265The :hp6.Ext. Path:ehp6. field, if anything is in it, gives the default
     266directory in which to place extracted files. Otherwise, FM/2 takes a
     267wild, hairy guess about where you want the extracted files to go
     268(although it'll let you override manually). You can enter "*" as the
     269extract path and FM/2 will use the directory in which the archive
     270resides. The :link reftype=hd res=99970.Find:elink. button can be used
     271to find a directory and fill this field in automatically.
     272
     273
     274:h3 res=92400 name=PANEL_TREEPAGE.Tree page
     275:i1 id=aboutTREEP.Tree page
    226276
    227277:artwork name='bitmaps\tree.bmp' align=left.
     278:p.
    228279This page contains controls that affect the Drive Tree.
    229280:p.
     
    236287The :hp6.Double-click Opens:ehp6. toggle, if on, causes FM/2 to always
    237288open a new Directory Container window when a Drive Tree directory is
    238 double clicked.  It's probably not useful to have both this toggle and
     289double clicked. It's probably not useful to have both this toggle and
    239290the Follow Drive Tree toggle on simultaneously.
    240291:p.
     
    268319
    269320
    270 :h3 res=99990 name=PANEL_TREESORTPAGE.Drive Tree sort/views page
    271 :i1 id=aboutTREESP.Drive Tree sort/views page
     321:h3 res=99990 name=PANEL_TREESORTPAGE.Tree sort/views page
     322:i1 id=aboutTREESP.Tree sort/views page
    272323
    273324:artwork name='bitmaps\tree.bmp' align=left.
     325:p.
    274326This page contains controls that affect Drive Tree sorting and view type.
    275327:p.
     
    278330
    279331
    280 :h3 res=99940 name=PANEL_ARCPAGE.Archive page
    281 :i1 id=aboutARCP.Archive page
    282 
    283 :artwork name='bitmaps\archive.bmp' align=left.
    284 This page contains controls relating to archivers and Archive
    285 Containers.
    286 :p.
    287 If the :hp6.Show archiver activity:ehp6. toggle is checked, FM/2 runs
    288 archiver windows in the foreground.  Normally it runs them in the
    289 background, minimized, so you'd have to use the task list to pull them
    290 to the foreground if you want to see them.
    291 :p.
    292 The :hp6.Quick arc find:ehp6. toggle, if checked, causes FM/2 to check
    293 only files with extensions that match those configured in ARCHIVER.BB2
    294 as potential archives during a drag and drop operation.  If you're
    295 dragging over files on a floppy or network directory, this can speed
    296 things up a bit.
    297 :p.
    298 The :hp6.Folder after extract:ehp6. toggle, if on, causes FM/2 to create
    299 a folder to hold objects extracted from an archive via an Archive
    300 Container.  You'll be given an opportunity to abort the folder creation
    301 or to decide where the folder will be located and what it'll be named.
    302 :p.
    303 You can set a :hp6.Default archiver:ehp6. so that, when you're archiving
    304 files and directories, this archiver is the default for the :hp1.Select
    305 Archiver:ehp1. dialog.
    306 :p.
    307 The :hp6.Ext. Path:ehp6. field, if anything is in it, gives the default
    308 directory in which to place extracted files.  Otherwise, FM/2 takes a
    309 wild, hairy guess about where you want the extracted files to go
    310 (although it'll let you override manually).  You can enter "*" as the
    311 extract path and FM/2 will use the directory in which the archive
    312 resides.  The :link reftype=hd res=99970.Find:elink. button can be used
    313 to find a directory and fill this field in automatically.
    314 
    315 
    316332:h3 res=92200 name=PANEL_VIEWPAGE.Viewers page
    317333:i1 id=aboutVIEWP.Viewers page
    318334
    319335:artwork name='bitmaps\viewer.bmp' align=left.
     336:p.
    320337This page contains controls relating to viewers.
    321338:p.
     
    324341Without this checked, FM/2 will use an internal MLE-based viewer/editor
    325342which can be considerably slower, but does allow the option of editing
    326 files.  It is strongly suggested that you check this option and use an
     343files. It is strongly suggested that you check this option and use an
    327344external editor rather than the internal editor, since editors are
    328345rather complex programs in their own right, and the internal version is
     
    331348The :hp6.Check for multimedia w/ MMPM/2:ehp6. toggle can be unchecked to
    332349cause FM/2 to :hp1.not:ehp1. use the MMPM/2 interface to determine
    333 whether or not a file to be viewed is a multimedia type.  The reason for
     350whether or not a file to be viewed is a multimedia type. The reason for
    334351this toggle is to avoid crashing FM/2 if you've installed a buggy MMPM/2
    335 I/O procedure.  Some desktop "enhancement" programs install such buggy
    336 IOProcs.  If you can't get it fixed, at least you can work around it
    337 (sigh).  You can manually put back some of this functionality using
    338 FM/2's :link reftype=hd res=90400.Associations:elink. feature.
    339 :p.
     352I/O procedure. Some desktop "enhancement" programs install such buggy
     353IOProcs. If you can't get it fixed, at least you can work around it
     354(sigh). You can manually put back some of this functionality using
     355FM/2's :link reftype=hd res=90400.Associations:elink. feature. If you have
     356installed Russel O'Connor's MP3 IOProcs you should uncheck this feature 
     357because it results in many non-multimedia programs being identified as
     358multimedia and some multimedia not being identified as such. Use the
     359:link reftype=hd res=90400.Associations:elink. instead.
     360:p.             
    340361The :hp6.Guess view type:ehp6. toggle, if on, causes FM/2 to guess at the
    341362type of the file being viewed (text or binary) and display it accordingly.
    342363:p.
    343364The :hp6.Run Viewer as child session:ehp6. toggle causes FM/2 to run the
    344 :hp1.Viewer:ehp1. program (see below) as a child session.  The main result
     365:hp1.Viewer:ehp1. program (see below) as a child session. The main result
    345366of this is that the Viewer will close when FM/2 closes.
    346367:p.
    347368You can fill in the names of programs to run to view WWW (web --
    348369http&colon.//) or FTP (ftp&colon.//) internet components when they're
    349 encountered in text in the internal viewers here.  In the faster
     370encountered in text in the internal viewers here. In the faster
    350371(non-MLE) internal viewer, double-clicking the line containing the
    351372component causes it to be viewed (you're given a choice of component if
    352 there's more than one on the line).  For WWW components, the prefacing
    353 "http&colon.//" is included.  For FTP components, the prefacing
    354 "ftp&colon.//" is :hp1.not:ehp1. included.  In the MLE-based internal
     373there's more than one on the line). For WWW components, the prefacing
     374"http&colon.//" is included. For FTP components, the prefacing
     375"ftp&colon.//" is :hp1.not:ehp1. included. In the MLE-based internal
    355376viewer/editor, you highlight the desired text and choose to view the
    356 component from a context menu.  The command line that you enter here is
     377component from a context menu. The command line that you enter here is
    357378automatically appended with a space and then the component descriptor
    358379from the text.
     
    361382you have no text viewer, binary viewer or text editor configured here.
    362383It's recommended that you fill these fields in with whatever editors you
    363 like rather than use the internals.  The :link reftype=hd
     384like rather than use the internals. The :link reftype=hd
    364385res=99970.Find:elink. button can be used to find a program and fill
    365386these fields in automatically (see :link reftype=hd
    366 res=99970.examples:elink. at that topic).  Don't forget that you can
     387res=99970.examples:elink. at that topic). Don't forget that you can
    367388cause FM/2 to automatically use many different types of viewing programs
    368389based on the type of file using the :link reftype=hd
    369 res=90400.Associations:elink. feature.
     390res=90400.Associations:elink. feature.
     391 
     392:h4 res=99970 name=PANEL_FIND.Find button
     393:i1 id=aboutFINDB.Find button
     394
     395:artwork name='bitmaps\find.bmp' align=left.
     396:p.
     397The :hp1.Find:ehp1. button can be clicked to bring up a dialog that will
     398let you point-and-click on a file or directory name that will be
     399imported to the current entry field. For example, if you're in the
     400:hp6.Editor:ehp6. entry field and click Find, you'll get a standard OS/2
     401open dialog which you may use to find your editor executable.
     402:p.
     403Examples:
     404:p.
     405Editor:  "EPM.EXE %a"
     406.br
     407or       "AE.EXE %a"
     408.br
     409or       "VS.EXE %a"
     410.br
     411or       "CMD.EXE /C START /C /FS EMACS.EXE %a"
     412.br
     413Viewer:  "HVPM.EXE /K %a" (Hyperview PM, excellent viewer)
     414.br
     415or       "LSTPM.EXE %a"
     416.br
     417or       "LIST2.EXE %a"
     418.br
     419Compare: "COMP.COM %a"
     420.br
     421or       "CONTRAST.EXE %a"
     422.br
     423or       "GFC.EXE %a"
     424.br
     425or       "CMD.EXE /C MYCOMP.CMD %a"
     426.br
     427DirCmp:  "PMDMATCH.EXE" (PMDirMatch, excellent directory comparitor)
     428.br
     429Virus:   "OS2SCAN.EXE %p /SUB /A"
     430:p.
     431See also :link reftype=hd res=100075.Metastrings:elink..
    370432
    371433
     
    381443:p.
    382444If the :hp6.Dir Cmp:ehp6. field is filled in, FM/2 runs that when
    383 directories are to be compared.  FM/2 fills in the name of the two
     445directories are to be compared. FM/2 fills in the name of the two
    384446directories after the text entered in this field -- no "%a" or other
    385447metastring is required.
     
    394456
    395457:artwork name='bitmaps\monolith.bmp' align=left.
     458:p.
    396459This page contains controls that affect FM/2 when run as a monolithic
    397460program (a Drive Tree and none or more Directory Containers contained
     
    410473Container is opened.
    411474:p.
    412 The :hp6.Recent Dirs:ehp6. toggle is a 3-position toggle.  If checked,
     475The :hp6.Recent Dirs:ehp6. toggle is a 3-position toggle. If checked,
    413476FM/2 places temporary entries for directories "visited" during a session
    414 to the user directory quicklist and Walk Directories dialog.  If greyed,
     477to the user directory quicklist and Walk Directories dialog. If grayed,
    415478FM/2 also places temporary entries for any directory chosen using the
    416479:link reftype=hd res=91500.Walk Directories:elink. dialog.
     
    420483checked, you'll have to set up each application separately, but
    421484configurations can be different than that in the monolithic FM/2
    422 application itself.  If you don't understand that, let's try this&colon.
     485application itself. If you don't understand that, let's try this&colon.
    423486if you run the Visual Tree program a lot, you'll probably want to check
    424 this.  Otherwise, you won't.
     487this. Otherwise, you won't.
    425488:p.
    426489If you check the :hp6.Free Drive Tree:ehp6. toggle, FM/2 will allow you
    427 to move the Drive Tree Container.  Otherwise it "pins" it in the upper
     490to move the Drive Tree Container. Otherwise it "pins" it in the upper
    428491left corner of the client window.
    429492:p.
    430493Normally FM/2 leaves a space below the Drive Tree just the right size for
    431 a minimized window.  Checking the :hp6.No space under Tree:ehp6. toggle
     494a minimized window. Checking the :hp6.No space under Tree:ehp6. toggle
    432495causes FM/2 to start without this space below the Drive Tree.
    433496:p.
    434497The :hp6.Save state of dir windows:ehp6. toggle, if checked, causes FM/2
    435498to "remember" the directory windows that are open when you close FM/2 so
    436 that it can open them again when you restart FM/2.  If you turn this on,
     499that it can open them again when you restart FM/2. If you turn this on,
    437500be sure to play with the Free Tree and Autotile toggles under the Windows
    438501menu to achieve the desired effect (everyone will want a different
    439 effect).  You'll probably want to omit any directories from the command
     502effect). You'll probably want to omit any directories from the command
    440503line if you turn on this toggle.
    441504:p.
     
    444507:p.
    445508If :hp6.Split Status:ehp6. is checked, you get two status lines at the
    446 bottom of the FM/2 window instead of one.  The left status line typically
     509bottom of the FM/2 window instead of one. The left status line typically
    447510contains information about the current container, the right about the
    448 current object in the container.  Cool.
     511current object in the container. Cool.
    449512:p.
    450513The :hp6.Start minimized:ehp6. and :hp6.Start maximized:ehp6. toggles
     
    453516The :hp6.Minimize to databar:ehp6. toggle, if on, causes FM/2 to
    454517minimize to a small, bar-shaped window (the :link reftype=hd
    455 res=99000.databar:elink.) showing some system information.  The
     518res=99000.databar:elink.) showing some system information. The
    456519databar can be run separately if desired -- look in the FM/2 folder.
    457520:p.
    458521The :hp6.Tile horizontal:ehp6. toggle, if on, causes FM/2 to favor
    459 tiling windows so they're taller than wide.  I suggest you think twice
     522tiling windows so they're taller than wide. I suggest you think twice
    460523before doing this; displaying files is basically a horizontal operation,
    461524not vertical (at least in countries that read left to right or right to
    462 left).  In other words, using this toggle will cause windows to be
     525left). In other words, using this toggle will cause windows to be
    463526biased to display side-by-side rather than one above another, which
    464527means that the horizontal reading space is limited, resulting in more
     
    468531The :hp6.Animate:ehp6. toggle, when on, causes internal FM/2 windows to
    469532be animated when they open and close (if you have animation turned on in
    470 the WPS System object, of course).  Silly.
     533the WPS System object, of course). Silly.
    471534:p.
    472535The :hp6.Blue/yellow LEDs:ehp6. toggle, when checked, causes FM/2 to
    473536display the thread LED as blue (off) and yellow (on) LEDs rather than
    474 the default red (off) and green (on) LEDs.  The change will not show up
     537the default red (off) and green (on) LEDs. The change will not show up
    475538on the application window until you close and then reopen FM/2.
    476539:p.
     
    484547
    485548:artwork name='bitmaps\general.bmp' align=left.
     549:p.
    486550This page contains controls that didn't seem to fit anywhere else.
    487551:p.
    488552:hp6.Confirm delete:ehp6. controls whether FM/2 will ask you to confirm
    489553the deletion of files (deleting directories or hidden/system files
    490 always requires confirmation).  It is recommended that you leave this
     554always requires confirmation). It is recommended that you leave this
    491555option on; FM/2 will let you confirm all files on which you're acting
    492556from one dialog, so it has minimal impact and provides a safety net.
    493557:p.
    494558The :hp6.Verify disk writes:ehp6. toggle turns system-level write
    495 verification on and off.  This is like typing :link reftype=launch
     559verification on and off. This is like typing :link reftype=launch
    496560object='CMD.EXE' data='/C HELP VERIFY'.VERIFY ON:elink. or VERIFY OFF at
    497561a command line.
     
    499563The :hp6.Don't move my mouse!:ehp6. toggle keeps FM/2 from moving your
    500564mouse (to place it in the center of a popup menu or over the Okay button
    501 in some dialogs).  Some people like the help, others don't. Take your
     565in some dialogs). Some people like the help, others don't. Take your
    502566pick.
    503567:p.
    504 :hp6.Link Sets Icon:ehp6. changes the action of a link-drag.  If this
     568:hp6.Link Sets Icon:ehp6. changes the action of a link-drag. If this
    505569toggle is set, a link drag causes FM/2 to try to set the icon of the
    506570target to the icon of the first dropped object (if the first dropped
    507571object has no .ICON EA and is not an icon file, the target's icon is
    508 reset.  Note that OS/2 sometimes buffers this info and an icon change
    509 may not show up immediately).  If not set, a link drag causes FM/2 to do
     572reset. Note that OS/2 sometimes buffers this info and an icon change
     573may not show up immediately). If not set, a link drag causes FM/2 to do
    510574a compare of the target with the dropped objects.
    511575:p.
    512576If :hp6.Default action Copy:ehp6. is checked, FM/2's windows perform a
    513577copy rather than move by default (note the highlighting on the mouse
    514 pointer as your cue).  Instead of pressing the Ctrl key to change a drag
     578pointer as your cue). Instead of pressing the Ctrl key to change a drag
    515579from a move to a copy, you'll need to press the Shift key to change a
    516 drag from a copy to a move (don't ask me why).  Note that this is the
    517 opposite of the standard OS/2 behavior, so know what you're doing.  I
     580drag from a copy to a move (don't ask me why). Note that this is the
     581opposite of the standard OS/2 behavior, so know what you're doing. I
    518582remind you that pressing F1 when you have a target in an FM/2 window
    519583will display some help on what the drag command would have performed.
     
    525589:p.
    526590FM/2 usually performs copy and move actions at the lowest "normal"
    527 priority available.  If you'd like FM/2 to use a true "idle" priority,
    528 check the :hp6.Idle Copy:ehp6. toggle.  Warning&colon. if a DOS program
     591priority available. If you'd like FM/2 to use a true "idle" priority,
     592check the :hp6.Idle Copy:ehp6. toggle. Warning&colon. if a DOS program
    529593is running, even in the background, idle priority threads slow
    530 :hp2.way:ehp2. down.  :hp3.Performance at true idle with DOS programs
     594:hp2.way:ehp2. down. :hp3.Performance at true idle with DOS programs
    531595running may not be acceptable.:ehp3.
    532596:p.
     
    536600:p.
    537601:hp6.Default delete perm.:ehp6. controls which type of deletion is the
    538 default for the Delete context submenu.  If this is checked, the default
     602default for the Delete context submenu. If this is checked, the default
    539603is permanent (unrecoverable) deletion.
    540604:p.
     
    546610default, FM/2 allows you to confirm the target directory to be used when
    547611you elect to move or copy file system objects using menu or accelerator
    548 key commands.  Otherwise, the operation is performed without
     612key commands. Otherwise, the operation is performed without
    549613intervention by you, moving or copying the objects to the :hp6.:link
    550614reftype=hd res=100065.Target directory:elink.:ehp6. (if one is set, of
     
    556620
    557621:artwork name='bitmaps\scan.bmp' align=left.
     622:p.
    558623This page contains controls related to how FM/2 scans your drives.
    559624:p.
    560625:hp6.Uppercase names:ehp6. and :hp6.Lowercase names:ehp6. control how
    561 FM/2 pretreats filenames before inserting them into the container.  The
    562 default is not to change the case of the filenames at all.  Changing
     626FM/2 pretreats filenames before inserting them into the container. The
     627default is not to change the case of the filenames at all. Changing
    563628these toggles will have an effect on the next rescan.
    564629:p.
    565630If :hp6.Load Subjects:ehp6. is checked, FM/2 loads object descriptions
    566 from their standard WPS .SUBJECT EAs during scans.  If you change the
     631from their standard WPS .SUBJECT EAs during scans. If you change the
    567632state of this toggle, you'll need to rescan to get the change to show up
    568 in FM/2's containers.  Note that only the Details view shows Subjects.
    569 Subjects may be direct-edited when showing in the container.  You can
     633in FM/2's containers. Note that only the Details view shows Subjects.
     634Subjects may be direct-edited when showing in the container. You can
    570635also pick :hp1.Subject:ehp1. from a context menu, whether Subjects are
    571636being loaded during scans or not, to view and optionally change the
    572 object description.  You can turn this off to increase scanning speed.
     637object description. You can turn this off to increase scanning speed.
    573638You can also adjust this on a drive-by-drive basis from the command line
    574639(see the :link reftype=launch object='E.EXE'
    575 data='READ.ME'.READ.ME:elink. that came with FM/2).
     640data='\FM2\README'.READ.ME:elink. that came with FM/2).
    576641:p.
    577642If :hp6.Load Longnames:ehp6. is checked, FM/2 loads the .LONGNAME
    578 extended attribute for non-HPFS drives.  This attribute usually contains
     643extended attribute for non-HPFS drives. This attribute usually contains
    579644a long name for objects that should be restored if the object is moved
    580 to an HPFS drive.  As for Subject, Longnames are only shown in the
    581 Details view.  You can turn this off to marginally increase scanning
    582 speed.  You can also adjust this on a drive-by-drive basis from the
     645to an HPFS drive. As for Subject, Longnames are only shown in the
     646Details view. You can turn this off to marginally increase scanning
     647speed. You can also adjust this on a drive-by-drive basis from the
    583648command line (see the :link reftype=launch object='E.EXE'
    584 data='READ.ME'.READ.ME:elink. that came with FM/2).
     649data='\FM2\README'.READ.ME:elink. that came with FM/2).
    585650:p.
    586651If :hp6.Load file icons:ehp6. and/or :hp6.Load directory icons:ehp6. are
    587652checked, FM/2 will load the icons of objects from the file system;
    588 otherwise it uses defaults.  Although turning these off can speed up
    589 scanning, it makes for boring containers.  This is PM, folks, enjoy the
     653otherwise it uses defaults. Although turning these off can speed up
     654scanning, it makes for boring containers. This is PM, folks, enjoy the
    590655bells and whistles! You can also adjust this on a drive-by-drive basis
    591656from the command line (see the :link reftype=launch object='E.EXE'
    592 data='READ.ME'.READ.ME:elink. that came with FM/2) so that you can, for
     657data='\FM2\README'.READ.ME:elink. that came with FM/2) so that you can, for
    593658instance, skip reading in icons from very slow drives (CD or floppy, for
    594659example) and/or from disks containing only DOS programs (DOS programs
    595660don't normally have special icons associated with them, anyway).
    596661:p.
    597 :hp6.Notes:ehp6.&colon.  some very slow drives (like EZ and ZIP drives)
     662:hp6.Notes:ehp6.&colon. some very slow drives (like EZ and ZIP drives)
    598663:hp1.will:ehp1. benefit from turning off some of the automatic
    599 information gathering above.  Experiment and adjust to taste. See also
     664information gathering above. Experiment and adjust to taste. See also
    600665the :link reftype=hd res=99980.Drive flags:elink. topic.
    601666:p.
     
    603668a find for more than one file at a time from working correctly. Symptoms
    604669range from invalid data returned to trapping of the requesting
    605 application.  While you'd think that these bugs would be fixed (and they
    606 are), new versions seem to reintroduce them again.  Therefore, FM/2
    607 provides the :hp6.Remote find bug:ehp6. toggle.  If checked, FM/2 will
    608 only ask for one file at a time from remote drives.  This is slower, but
    609 at least useable. In the meantime, ask you system administrator to
     670application. While you'd think that these bugs would be fixed (and they
     671are), new versions seem to reintroduce them again. Therefore, FM/2
     672provides the :hp6.Remote find bug:ehp6. toggle. If checked, FM/2 will
     673only ask for one file at a time from remote drives. This is slower, but
     674at least usable. In the meantime, ask you system administrator to
    610675upgrade the LAN software -- most of these bugs have been fixed in newer
    611676versions.
    612677:p.
    613678If you turn this toggle off (it's on by default) and FM/2 starts
    614 behaving strangely, turn it back off.  If FM/2 traps and you can't get
     679behaving strangely, turn it back off. If FM/2 traps and you can't get
    615680to the settings page, disconnect from the network, start FM/2, then
    616 turn off the toggle.  If that's not possible for some reason, use
     681turn off the toggle. If that's not possible for some reason, use
    617682FM/2's INI editor to view FM3.INI and delete the "RemoteBug" keyword
    618683from the INI (which will cause FM/2 to revert to the default setting).
     
    623688even if they do contain subdirectories until you double-click the drive.
    624689Floppy drives A&colon. and B&colon. receive this treatment without this
    625 toggle; it's for other removable drives, like CD-ROM drives.  This was
     690toggle; it's for other removable drives, like CD-ROM drives. This was
    626691added to allow folks with CD-ROM carousels to avoid having each CD
    627692loaded and scanned automatically at FM/2 startup.
    628693:p.
    629694The :hp6.Findbuf:ehp6. spin button controls how many files FM/2 searches
    630 for in one system call.  The higher this number, the faster FM/2 works
     695for in one system call. The higher this number, the faster FM/2 works
    631696(with properly operating FSDs that support "finding" more than one file
    632697at a time -- unfortunately, the FSDs that can benefit the most from this,
    633698network FSDs, are the ones most often broken), but the more memory is
    634 temporarily consumed as a container is filled.  If you habitually work
     699temporarily consumed as a container is filled. If you habitually work
    635700with directories containing great numbers of files and have sufficient
    636 memory, boosting this may be a good idea.  On the other hand, if you are
     701memory, boosting this may be a good idea. On the other hand, if you are
    637702extremely limited in memory (less than 16 megs), reducing this might be
    638 the thing to do.  The range is 16 to 2048, with 128 the default.
     703the thing to do. The range is 16 to 2048, with 128 the default.
    639704
    640705
     
    643708
    644709:artwork name='bitmaps\bubble.bmp' align=left.
     710:p.
    645711This page controls where FM/2 shows bubble help.
    646712:p.
     
    649715:p.
    650716:hp6.Drivebar help:ehp6. controls whether FM/2 shows drive freespace
    651 when the mouse pointer passes over drivebar buttons.  FM/2 will not show
     717when the mouse pointer passes over drivebar buttons. FM/2 will not show
    652718freespace for floppy drives A&colon. or B&colon., for CD-ROM drives, or
    653719for drives marked as Slow in the :link reftype=hd res=99980.Drive
     
    661727
    662728:artwork name='bitmaps\flash.bmp' align=left.
     729:p.
    663730This page allows you to select from a few pre-configured setups for FM/2
    664 in general.  You'll see this page automatically the first time you run
    665 FM/2.  Pick something that looks close to what you want without worrying
    666 too much about it  -- you can always change it later.  The idea is to
     731in general. You'll see this page automatically the first time you run
     732FM/2. Pick something that looks close to what you want without worrying
     733too much about it  -- you can always change it later. The idea is to
    667734give you some quick choices about the general way you'd like FM/2 to
    668735look and behave, and allow you to tweak specifics later as you get some
     
    678745You'll have to use the mouse and work from context menus and accelerator
    679746keys alone, but you'll have the maximum amount of free space within the
    680 main FM/2 window.  :hp3.Hint&colon.:ehp3. The System Menu contains the
     747main FM/2 window. :hp3.Hint&colon.:ehp3. The System Menu contains the
    681748command to unhide the pulldown menu, if that's going too far for you.
    682749:p.
     
    689756:p.
    690757:hp6.Max filenames:ehp6. puts FM/2's Directory Containers into a state
    691 that allows the most filenames per container.  Rather unattractive.
     758that allows the most filenames per container. Rather unattractive.
    692759:p.
    693760:hp6.Max speed:ehp6. turns off some automatic information gathering to
     
    703770Windows file manager, with one Directory container.
    704771:p.
    705 :hp6.Hector's way:ehp6. sets FM/2 up the way the author likes it.  Your
     772:hp6.Hector's way:ehp6. sets FM/2 up the way the author likes it. Your
    706773mileage may vary.
    707774:p.
     
    710777
    711778
    712 :h3 res=99970 name=PANEL_FIND.Find button
    713 :i1 id=aboutFINDB.Find button
    714 
    715 :artwork name='bitmaps\find.bmp' align=left.
    716 The :hp1.Find:ehp1. button can be clicked to bring up a dialog that will
    717 let you point-and-click on a file or directory name that will be
    718 imported to the current entry field.  For example, if you're in the
    719 :hp6.Editor:ehp6. entry field and click Find, you'll get a standard OS/2
    720 open dialog which you may use to find your editor executable.
    721 :p.
    722 Examples:
    723 :p.
    724 Editor:  "EPM.EXE %a"
    725 .br
    726 or       "Q.EXE %a"
    727 .br
    728 or       "VS.EXE %a"
    729 .br
    730 or       "CMD.EXE /C START /C /FS EMACS.EXE %a"
    731 .br
    732 Viewer:  "HVPM.EXE /K %a" (Hyperview PM, excellent viewer)
    733 .br
    734 or       "LSTPM.EXE %a"
    735 .br
    736 or       "LIST2.EXE %a"
    737 .br
    738 Compare: "COMP.COM %a"
    739 .br
    740 or       "CONTRAST.EXE %a"
    741 .br
    742 or       "GFC.EXE %a"
    743 .br
    744 or       "CMD.EXE /C MYCOMP.CMD %a"
    745 .br
    746 DirCmp:  "PMDMATCH.EXE" (PMDirMatch, excellent directory comparitor)
    747 .br
    748 Virus:   "OS2SCAN.EXE %p /SUB /A"
    749 :p.
    750 See also :link reftype=hd res=100075.Metastrings:elink..
    751 
     779
  • trunk/dll/ipf/objcnr.ipf

    r2 r268  
    22:i1 id=aboutObjectPath.Object Container
    33This dialog allows you to select a new folder (directory) to hold
    4 objects that FM/2 creates.  By default it is <WP_DESKTOP>.   FM/2 tries
     4objects that FM/2 creates. By default it is <WP_DESKTOP>.  FM/2 tries
    55to find the directory being used as the desktop folder first in the OS/2
    66system INI, and if that fails, uses the directory \DESKTOP on your boot
    77drive as the "desktop window object" directory -- this is the OS/2 2.1+
    8 default.  I suppose future versions of OS/2 could break this and make
    9 an update necessary, but IBM seems to think (though won't guarantee) it
    10 should always work.
     8default.
    119:p.
    12 A button labelled :hp1.Desktop:ehp1. allows you to restore the default
    13 <WP_DESKTOP> setting.  This will work whether the above fails or not.
     10A button labeled :hp1.Desktop:ehp1. allows you to restore the default
     11<WP_DESKTOP> setting. This will work whether the above fails or not.
    1412
    1513:h2 res=93100 name=PANEL_QUICKTREE.Quick Tree
     
    2119:p.
    2220If you select one of these subdirectories, the Directory Container
    23 window will switch to look into that directory.  You can click
     21window will switch to look into that directory. You can click
    2422Cancel if you change your mind.
    2523:p.
  • trunk/dll/ipf/printer.ipf

    r10 r268  
    22:i1 id=aboutPrinter.Print files
    33:artwork name='..\..\bitmaps\print.bmp' align=center.
    4 
     4:p.
    55This dialog, which appears before a selected group of one or more files
    66is to be printed, lets you finalize your selection and set the parameters
     
    88:p.
    99The listbox at the top of the dialog contains the files that are to be
    10 printed.  You can unhighlight (deselect) any files that you do
    11 :hp1.not:ehp1. want to print.  :hp6.Hint:ehp6.&colon. you might need to
     10printed. You can unhighlight (deselect) any files that you do
     11:hp1.not:ehp1. want to print. :hp6.Hint:ehp6.&colon. you might need to
    1212hold down the Ctrl key while clicking to unhighlight the first file.
    1313:p.
     
    1717specify the printer to which output should go (default is PRN, the
    1818default system printer, but you could specify LPT1, LPT2, etc., or even
    19 a text file).  Note that FM/2's printing is really meant for situations
     19a text file). Note that FM/2's printing is really meant for situations
    2020in which the PM printer objects and spooler aren't available -- you can
    2121just drag objects to the printer objects otherwise.
    2222:p.
    2323The rest of the controls are used to determine how FM/2 should format
    24 the text file for printing.  You can specify the width and length of the
     24the text file for printing. You can specify the width and length of the
    2525page (in columns and rows respectively), how many lines to leave blank
    2626for bottom and top margins, how many characters to leave blank for left
    2727and right margins, whether to print pages sequentially or print first
    28 odd pages, then even pages (:hp1.Alternate pages:ehp1.).  You can specify
     28odd pages, then even pages (:hp1.Alternate pages:ehp1.). You can specify
    2929the line spacing used (1 for single-spaced, 2 for double-spaced, etc.),
    30 and tell FM/2 if it needs to print a formfeed before and/or after each
     30and tell FM/2 if it needs to send a formfeed before and/or after each
    3131file it prints.
    3232:p.
    33 Click :hp1.Okay:ehp1. when you're ready to print.  Click :hp1.Cancel:ehp1.
     33Click :hp1.Okay:ehp1. when you're ready to print. Click :hp1.Cancel:ehp1.
    3434if you changed your mind and don't want to print anything.
    3535:p.
    3636:hp6.Notes&colon.:ehp6.
    3737:p.
    38 Not all files will print well with formatted printing turned on.  The
     38Not all files will print well with formatted printing turned on. The
    3939file should :hp1.not:ehp1. contain any control codes aside from carriage
    40 returns and linefeeds.  The file's lines should be short enough to fit
    41 within the confines of width - (left margin + right margin).  For files
     40returns and linefeeds. The file's lines should be short enough to fit
     41within the confines of width - (left margin + right margin). For files
    4242that were formatted to be viewed on-screen, this may mean setting your
    4343printer to use a narrower typeface and increasing the width parameter in
    44 the FM/2 print setup dialog above 80.  Refer to your printer
     44the FM/2 print setup dialog above 80. Refer to your printer
    4545documentation for how to change the default font.
    4646:p.
    4747When printing :hp1.Alternate pages:ehp1., FM/2 reverses the left and
    48 right margins when printing even numbered pages.  This is designed to
     48right margins when printing even numbered pages. This is designed to
    4949let you print front and back (page 2 on the back of page 1, etc.) and
    5050then bind the result along the left side (left of page 1, right of page
    51 2, etc.).  FM/2 will first print the odd numbered pages, beginning with
     512, etc.). FM/2 will first print the odd numbered pages, beginning with
    5252page 1, then prompt you before beginning to print the even numbered
    5353pages, beginning with page 2, thereby allowing you to reload the printer
  • trunk/dll/ipf/rename.ipf

    r10 r268  
    22:i1 id=aboutRenaming.Renaming
    33:artwork name='..\..\bitmaps\rename.bmp' align=center.
    4 When you rename a file sytem object other than by :link reftype=hd
     4:p.
     5When you rename a file system object other than by :link reftype=hd
    56res=98200.Direct Editing:elink., or a naming conflict arises, you get
    6 the Rename dialog.  Note that not all the controls discussed appear for
     7the Rename dialog. Note that not all the controls discussed appear for
    78simple rename procedures -- some are applicable only when copying or
    89moving files.
     
    1516renaming, the target name is initially the same as the source name). If
    1617the target file exists, you will be told whether the source is larger or
    17 smaller, older or newer.  You will be told whether the source and target
    18 are files or directories.  Sometimes you may see a warning "cannot
     18smaller, older or newer. You will be told whether the source and target
     19are files or directories. Sometimes you may see a warning "cannot
    1920access source."  This means that FM/2 could not open the source file in
    2021a test, and may indicate that the file is already in use and thus OS/2
    21 may not allow it to be renamed, moved or copied.  You can use this
     22may not allow it to be renamed, moved or copied. You can use this
    2223information display to make decisions more easily.
    2324:p.
    24 After entering the new target name, click :hp1.Okay:ehp1..  If the new
     25After entering the new target name, click :hp1.Okay:ehp1.. If the new
    2526target name exists, the display will be updated to reflect the new
    26 information.  You can, at that point, enter a new name to avoid the
     27information. You can, at that point, enter a new name to avoid the
    2728conflict or click :hp1.Overwrite:ehp1. (which will destroy the old
    2829target file, keeping in mind that you can't overwrite a file with
    29 itself).  :hp1.Skip:ehp1. can be used to skip one file when you are renaming
    30 several in one action; nothing will be done for that file.  Click
     30itself). :hp1.Skip:ehp1. can be used to skip one file when you are renaming
     31several in one action; nothing will be done for that file. Click
    3132:hp1.Cancel:ehp1. if you change your mind and want to abort the whole
    3233thing.
    3334:p.
    3435The :hp1.Rename Existing:ehp1. button allows you to rename (move) the
    35 existing file system object which is causing a naming conflict.  For
     36existing file system object which is causing a naming conflict. For
    3637example, if you are trying to copy a file to "C&colon.\MYFILE" and a
    3738"C&colon.\MYFILE" already exists, you could change the target name as
     
    4445in combination to avoid seeing this screen again for naming conflicts.
    4546Files which have existing targets that do not match an overwrite
    46 characteristic will be automatically skipped.  For example, if you don't
     47characteristic will be automatically skipped. For example, if you don't
    4748check either of the Overwrite... checkboxes, all existing files will be
    4849skipped, but if you check the ...older checkbox, all existing files
    4950older than the source file will be overwritten, while existing files
    50 newer than the source file will be skipped.  Exception:  You will always
     51newer than the source file will be skipped. Exception:  You will always
    5152be prompted if you try to overwrite a directory with a file.
    5253:p.
  • trunk/dll/ipf/select.ipf

    r10 r268  
    33:artwork name='..\..\bitmaps\select.bmp' align=center.
    44:artwork name='..\..\bitmaps\deselect.bmp' align=center.
     5
    56The Ctrl + F8 accelerator calls up the Select menu for a given
    67container. You can also, of course, get to it with the mouse via the
     
    89:p.
    910What follows is an item-by-item description of the commands in the
    10 Select menu.  Where both Select and Deselect commands are available,
     11Select menu. Where both Select and Deselect commands are available,
    1112only the Select command will be discussed to save space and avoid
    1213repetition.
    1314:p.
    14 :hp1.Select All:ehp1.  Selects all objects in a container.
     15:hp1.Select All:ehp1. Selects all objects in a container.
    1516:hp1.Deselect All:ehp1. has an accelerator Ctrl + \.
    1617:p.
    17 :hp1.Select All Files:ehp1.  Selects all the file objects in a
    18 container.  The accelerator key Ctrl + / is assigned to this command.
     18:hp1.Select All Files:ehp1. Selects all the file objects in a
     19container. The accelerator key Ctrl + / is assigned to this command.
    1920:p.
    20 :hp1.Select All Dirs:ehp1.  Selects all the directory objects in a
    21 container.  The accelerator key Shift + Ctrl + ? is assigned to this
    22 command (same as for Select All Files with the addition of the Shift
    23 key).  :hp1.Deselect All Dirs:ehp1. has an accelerator Shift + Ctrl + |
    24 (same as Deselect All with the addition of the Shift key).
     21:hp1.Select All Dirs:ehp1. Selects all the directory objects in a
     22container. The accelerator key Shift + Ctrl + ? is assigned to this
     23command :hp1.Deselect All Dirs:ehp1. has an accelerator Shift + Ctrl + |
    2524:p.
    26 :hp1.Select Mask:ehp1.  Allows you to select files that match a filemask.
     25:hp1.Select Mask:ehp1. Allows you to select files that match a filemask.
    2726The same dialog is used for this command that's used for the :link
    28 reftype=hd res=93400.Filter:elink. command.  When you first initiate
     27reftype=hd res=93400.Filter:elink. command. When you first initiate
    2928this command, FM/2 fills in a default mask built from the current
    30 object's name.  So, to quickly select all the *.BAK files in a
     29object's name. So, to quickly select all the *.BAK files in a
    3130container, you could select one of the files, then type Ctrl + = (the
    3231accelerator assigned to Select Mask) and press [Enter] to accept the
    3332default filemask built by FM/2 (*.BAK).
    3433:p.
    35 :hp1.Select clipboard:ehp1.  If the OS/2 clipboard contains a list of files
     34:hp1.Select clipboard:ehp1. If the OS/2 clipboard contains a list of files
    3635(such as can be created with the :hp1.Save to clipboard:ehp1. command),
    3736you can select any files present in both the container and the list with
    38 this command.  The accelerator for this command is Ctrl + ]. The
     37this command. The accelerator for this command is Ctrl + ]. The
    3938accelerator for the Deselect clipboard command is Shift + Ctrl + }.
    4039:p.
    41 :hp1.Select List:ehp1.  If you've saved a list to a file (such as can be
     40:hp1.Select List:ehp1. If you've saved a list to a file (such as can be
    4241created with the :link reftype=hd res=96000.Save to list file:elink.
    4342command), you can select any files present in both the listfile and the
    4443container with this command.
    4544:p.
    46 :hp1.Reselect:ehp1.  This command causes the container to reselect the
    47 last selected items.  The accelerator is Ctrl + '.
     45:hp1.Reselect:ehp1. This command causes the container to reselect the
     46last selected items. The accelerator is Ctrl + '.
    4847:p.
    49 :hp1.Invert selection:ehp1.  Selects what isn't, deselects what is. In
     48:hp1.Invert selection:ehp1. Selects what isn't, deselects what is. In
    5049other words, reverses the current selection set.
     50The accelerator is Ctrl + ;.
    5151:p.
    5252:hp2.Compare selections:ehp2.
     
    5454FM/2 provides Directory Containers with special selection commands that
    5555can be used to select file objects based on their relationship to file
    56 objects in other open Directory Containers.  These commands are extremely
     56objects in other open Directory Containers. These commands are extremely
    5757powerful tools that can let you, for instance, compare two directories to
    58 see what's different about them.  See also :link reftype=hd
     58see what's different about them. See also :link reftype=hd
    5959res=94900.Compare Directories:elink..
    6060:p.
    61 :hp1.Select if in all:ehp1.  This command selects any file objects that
     61:hp1.Select if in all:ehp1. This command selects any file objects that
    6262exist in all open Directory Containers.
    6363:p.
    64 :hp1.Select if in more than one:ehp1.  Selects any file objects that
     64:hp1.Select if in more than one:ehp1. Selects any file objects that
    6565exist in more than one open Directory Containers.
    6666:p.
    67 :hp1.Select if in one:ehp1.  Selects any file objects that exist in only
     67:hp1.Select if in one:ehp1. Selects any file objects that exist in only
    6868one open Directory Container.
    6969:p.
    70 :hp1.Select newest:ehp1.  Selects the newest file objects that exist in
     70:hp1.Select newest:ehp1. Selects the newest file objects that exist in
    7171more than one open Directory Container.
    7272:p.
    73 :hp1.Select oldest:ehp1.  Selects the oldest file objects that exist in
     73:hp1.Select oldest:ehp1. Selects the oldest file objects that exist in
    7474more than one open Directory Container.
    7575:p.
    76 :hp1.Select largest:ehp1.  Selects the largest file objects that exist in
     76:hp1.Select largest:ehp1. Selects the largest file objects that exist in
    7777more than one open Directory Container.
    7878:p.
    79 :hp1.Select smallest:ehp1.  Selects the smallest file objects that exist
     79:hp1.Select smallest:ehp1. Selects the smallest file objects that exist
    8080in more than one open Directory Container.
  • trunk/dll/ipf/seticon.ipf

    r2 r268  
    33object Information dialog.
    44:p.
    5 Set the radio button of the system pointer you want to change.  Then
    6 click Okay.  Click Cancel to abort if you change your mind.
     5Set the radio button of the system pointer you want to change. Then
     6click Okay. Click Cancel to abort if you change your mind.
    77:p.
    88Changes to system pointers are persistent (they stick around even when
  • trunk/dll/ipf/shadow.ipf

    r10 r268  
    22:i1 id=aboutShadow.Shadow
    33:artwork name='..\..\bitmaps\shadow.bmp' align=center.
     4:p.
    45FM/2 has the ability to create shadows of objects on your WPS desktop
    5 (or in other WPS folders).  To create shadows, select objects in an FM/2
     6(or in other WPS folders). To create shadows, select objects in an FM/2
    67window, then select :hp1.Shadow:ehp1. from a context menu or the Files
    78pulldown submenu (Create Objects submenu).
    89:p.
    910If only one shadow is being created, the shadow is placed directly into
    10 the folder you specify.  If more than one shadow is being created, FM/2
    11 first prompts you for the name of a folder.  This folder is then created
     11the folder you specify. If more than one shadow is being created, FM/2
     12first prompts you for the name of a folder. This folder is then created
    1213on the desktop and the shadows are placed inside that folder. You can
    1314move the shadows or folder elsewhere after that.
     
    1617:i1 id=aboutObjects.Real Objects
    1718:artwork name='..\..\bitmaps\object.bmp' align=center.
     19:p.
    1820FM/2 has the ability to create objects on your WPS desktop (or in other
    19 WPS folders).  To create objects, select objects in an FM/2 window, then
     21WPS folders). To create objects, select objects in an FM/2 window, then
    2022select :hp1.Real Objects:ehp1. from a context menu or the Files pulldown
    2123submenu (Create Objects submenu).
    2224:p.
    2325If only one object is being created, the object is placed directly into
    24 the folder you specify.  If more than one object is being created, FM/2
    25 first prompts you for the name of a folder.  This folder is then created
     26the folder you specify. If more than one object is being created, FM/2
     27first prompts you for the name of a folder. This folder is then created
    2628on the desktop and the objects are placed inside that folder. You can
    2729move the objects or folder elsewhere after that.
  • trunk/dll/ipf/term.ipf

    r2 r268  
    1313:hp1.B2:ehp1. = Mouse button 2, usually the right button
    1414:p.
    15 :hp1.B3:ehp1. = Mouse button 3, usually the middle button.  Not all mice
    16 have three buttons.  OS/2 will let you redefine the buttons using the
     15:hp1.B3:ehp1. = Mouse button 3, usually the middle button. Not all mice
     16have three buttons. OS/2 will let you redefine the buttons using the
    1717WPS' Mouse object in the System Setup folder.
    1818:p.
     
    2525:p.
    2626:hp1.:link reftype=hd res=97600.Pulldown menu:elink.:ehp1. = the action
    27 bar menu just under the title bar of a window.  If you don't know what a
     27bar menu just under the title bar of a window. If you don't know what a
    2828title bar is, run the OS/2 tutorial.
    2929:p.
    3030:hp1.:link reftype=hd res=97600.System menu:elink.:ehp1. = the icon at
    31 the top left of most PM main windows.  You can close a window by
    32 double-clicking the System menu icon with B1.  Click once and you get a
     31the top left of most PM main windows. You can close a window by
     32double-clicking the System menu icon with B1. Click once and you get a
    3333menu (called, oddly enough, the system menu).
    3434:p.
    3535:hp1.:link reftype=hd res=97700.Conditional cascade menu:elink.:ehp1. =
    3636a submenu with the right-pointing link arrow contained in a button on
    37 the menu item.  When the button is clicked, the submenu displays
    38 (cascades) as with a normal submenu.  When the menu item itself is
    39 clicked, a default action from the submenu is activated.  You can see
    40 which submenu item is the default as it has a checkmark by it.  A
     37the menu item. When the button is clicked, the submenu displays
     38(cascades) as with a normal submenu. When the menu item itself is
     39clicked, a default action from the submenu is activated. You can see
     40which submenu item is the default as it has a checkmark by it. A
    4141conditional cascade menu generally gives you a default option for a
    4242command and several related commands; for instance, in an :link
     
    4444cascade menu defaults to simply extracting the selected objects, but
    4545clicking the arrow button reveals several extract options that can be
    46 selected instead.  FM/2 uses conditional cascade menus to keep the menus
     46selected instead. FM/2 uses conditional cascade menus to keep the menus
    4747organized in such a way that often used commands are immediately
    4848available but many more commands are still accessible.
     
    5151buttons, usually with pictures on them, that you can click with your
    5252mouse to cause commands to be activated -- a sort of menu for
    53 illiterates.  The FM/2 toolbar can be turned on and off, can be changed
     53illiterates. The FM/2 toolbar can be turned on and off, can be changed
    5454from icon to text buttons and back again, and can display text below
    55 the icon buttons.  Brief help appears on the title bar when the mouse
     55the icon buttons. Brief help appears on the title bar when the mouse
    5656passes over a toolbar button.
    5757:p.
    58 :hp1.Toolbox:ehp1. = a collection of buttons in a toolbar.  FM/2 allows
     58:hp1.Toolbox:ehp1. = a collection of buttons in a toolbar. FM/2 allows
    5959you to customize and save toolboxes which you can load into the toolbar
    6060as desired.
    6161:p.
    6262:hp1.:link reftype=hd res=99000.Databar:elink.:ehp1. = a window to which
    63 you can cause FM/2 to be "minimized," or which can be run separately, that
     63you can minimize FM/2 to or which can be run separately, that
    6464shows occasionally updated information about your system, such as free
    6565drive space, threads/processes, time/date, etc.
    6666:p.
    6767:hp1.Drag and drop:ehp1. = an intuitive way of manipulating objects --
    68 this is more-or-less how you manipulate objects in the real world.  If
     68this is more-or-less how you manipulate objects in the real world. If
    6969you don't know how to drag and drop, you :hp2.really:ehp2. should run
    70 the OS/2 Tutorial.  Drag and drop is a superior method for manipulating
     70the OS/2 Tutorial. Drag and drop is a superior method for manipulating
    7171objects, as opposed to keyboard commands, because you choose both the
    7272command and the target in one operation.
     
    7979of changing the text of an object, as when you change the name of an
    8080object on the WPS by pointing at it, holding down the ALT key and
    81 clicking the text with B1.  FM/2 supports direct editing of file system
     81clicking the text with B1. FM/2 supports direct editing of file system
    8282object names as well as Subject and Longname fields in Details view.
    8383:p.
     
    8686and press [Enter])  The default action may sometimes be modified by
    8787the Shift state of the keyboard (if you hold down Shift or Ctrl
    88 while double-clicking or pressing [Enter]).  The :link reftype=hd
     88while double-clicking or pressing [Enter]). The :link reftype=hd
    8989res=90000.General Help:elink. topic explains default actions in detail.
    9090:p.
    9191:hp1.:link reftype=hd res=97700.Accelerator keys:elink.:ehp1. = key
    9292combinations that allow you to quickly give a program a command without
    93 going through menus or toolbars.  For example, FM/2's accelerator key to
    94 get help is Ctrl + F1.  Note that accelerators are case sensitive, so
     93going through menus or toolbars. For example, FM/2's accelerator key to
     94get help is Ctrl + F1. Note that accelerators are case sensitive, so
    9595that Ctrl + m isn't the same as Ctrl + M -- you'll need to hold down
    9696the Shift key or set Caps Lock to get the latter.
     
    9898:hp1.:link reftype=hd res=97600.Drive Tree:elink.:ehp1. = the special
    9999window that's always open in FM/2 displaying your drives in "tree"
    100 format.  If subdirectories are available, there will be a "+" sign to
     100format. If subdirectories are available, there will be a "+" sign to
    101101the left of the drive which you can click to show the subdirectories.
    102102Note that floppy drives (A&colon. and B&colon.) aren't checked for
     
    123123:hp1.:link reftype=hd res=99400.Quicklists:elink.:ehp1. = optional
    124124dropdown combo boxes at the top of the FM/2 window (below the toolbar,
    125 if it's on) that give quick access to several often used things.  Also
     125if it's on) that give quick access to several often used things. Also
    126126known as :hp1.user lists:ehp1..
    127127:p.
     
    133133:p.
    134134:hp1.Mask:ehp1. = a filemask that can contain wildcard characters (* and
    135 ?) and select one or more files.  In FM/2, filemasks can usually contain
    136 multiple masks separated by semicolons.  See :hp1.Filter:ehp1. link
     135?) and select one or more files. In FM/2, filemasks can usually contain
     136multiple masks separated by semicolons. See :hp1.Filter:ehp1. link
    137137above for more information.
    138138:p.
     
    140140upon which commands will act (also called the :hp1.cursored
    141141object:ehp1.). The current object in a container is indicated by a
    142 dotted outline around the object.  The current object may or may not
     142dotted outline around the object. The current object may or may not
    143143also be highlighted. There can only be one current object in a
    144144container.
     
    146146:hp1.:link reftype=hd res=98000.Highlighted objects:elink.:ehp1. =
    147147objects in a container which are indicated by a different color (usually
    148 darker) background.  If the current object is also highlighted, commands
    149 affect all highlighted objects.  Highlighted objects are sometimes
    150 referred to as :hp1.selected objects:ehp1..  Note that in the Drive Tree
     148darker) background. If the current object is also highlighted, commands
     149affect all highlighted objects. Highlighted objects are sometimes
     150referred to as :hp1.selected objects:ehp1.. Note that in the Drive Tree
    151151there is always one highlighted object (which will also be the current
    152152object), but in other containers there can be many or no highlighted
    153153objects, and, depending on the selection type you use (see :link
    154154reftype=hd res=97000.Windows toggle page:elink.), the current object may
    155 not be a highlighted object.  Thus understanding the distinction between
     155not be a highlighted object. Thus understanding the distinction between
    156156current and highlighted objects is important.
    157157:p.
     
    165165:p.
    166166:hp1.Tree view:ehp1. = a container view similar to an inverted tree,
    167 with roots at the top and leaves at the bottom.  The FM/2 Drive Tree
     167with roots at the top and leaves at the bottom. The FM/2 Drive Tree
    168168is an example of this sort of view, as is the default view of an
    169169OS/2 WPS Drive object.
    170170:p.
    171171:hp1.Icon view:ehp1. = a container view showing the object's name below
    172 the object's icon.  This is the default view for a WPS folder.
     172the object's icon. This is the default view for a WPS folder.
    173173:p.
    174174:hp1.Name view:ehp1. = a container view showing the object's name beside
     
    180180:p.
    181181:hp1.Details view:ehp1. = a container view showing full object
    182 information in rows.  A detail container is split into two sides with
     182information in rows. A detail container is split into two sides with
    183183one vertical scrollbar serving both sides, and two separate horizontal
    184 scrollbars.  Details view shows more information on the objects within
     184scrollbars. Details view shows more information on the objects within
    185185it than any other view; it also displays fewer objects for a given space.
    186186:p.
    187 :hp1.MLE:ehp1. = Multi Line Edit control.  This is something like a text
    188 editor.  They can (and do) come in all sizes.
     187:hp1.MLE:ehp1. = Multi Line Edit control. This is something like a text
     188editor. They can (and do) come in all sizes.
    189189:p.
    190190:hp1.Container whitespace:ehp1. = an empty part of a container (a part
    191 without an object on it).  
     191without an object on it).
    192192:p.
    193193:hp1.Monolithic application:ehp1. = FM/2 as run from the FM/2 program
    194194object, with the big window containing a Drive tree and Directory
    195 containers within it.  You can also run parts of FM/2 separately.
     195containers within it. You can also run parts of FM/2 separately.
    196196:p.
    197197See also these pictures&colon.
     
    212212:i1 id=aboutCURRENTOBJ.Current object &amp. selected objects
    213213:artwork align=left name='bitmaps\current.bmp'.
     214:p.
    214215The current object is the one with the dotted outline; the mouse pointer
    215 is pointing at it.  The selected objects are those with the darker
    216 outline.  If the current object is also selected, commands affect all
    217 selected objects.  Otherwise, commands affect only the current object.
     216is pointing at it. The selected objects are those with the darker
     217outline. If the current object is also selected, commands affect all
     218selected objects. Otherwise, commands affect only the current object.
    218219
    219220:h2 res=97700 name=PANEL_CASCADEMENU.Cascade menus &amp. accelerator keys
    220221:i1 id=aboutCASCADEMENU.Cascade menus &amp. accelerator keys
    221222FM/2 with a cascade menu off a pulldown menu open&colon.
     223:p.
    222224:artwork align=left name='bitmaps\cascade.bmp'.
     225:p.
    223226Notice the checked default action "FM/2 Window" on the Open cascade menu
    224 -- this is what would be executed if you clicked Open other than on the
    225 arrow button.  Clicking the button opens the cascade menu. Standard
     227-- this is what would be executed if you clicked Open instead of on the
     228arrow button. Clicking the button opens the cascade menu. Standard
    226229submenus have arrows that are not buttons; clicking anywhere on one of
    227230thse items opens the submenu.
     
    234237difference in appearance between the Miscellaneous cascade menu and the
    235238Select submenu.
     239:p.
    236240:artwork align=left name='bitmaps\submenu.bmp'.
    237241:p.
    238242Finally, note that the :link reftype=hd res=93300.Files:elink. pulldown
    239243menu is a "ghost" for a context menu requested on a file/directory
    240 object.  The :link reftype=hd res=93800.Views:elink. pulldown is a
    241 "ghost" for a context menu requested over container whitespace.  Since
     244object. The :link reftype=hd res=93800.Views:elink. pulldown is a
     245"ghost" for a context menu requested over container whitespace. Since
    242246you can select the container and/or item while requesting a context menu
    243247in one smooth motion with a mouse, context menus are faster than
     
    248252:i1 id=aboutCONTEXTSUBMENU.Context and sub menus
    249253FM/2 with a sub menu off a context menu open&colon.
     254:p.
    250255:artwork align=left name='bitmaps\context.bmp'.
     256:p.
    251257Here FM/2 is displaying a :link reftype=hd res=93700.context menu:elink.
    252 that was requested over whitespace in the Drive Tree.  This is the same
     258that was requested over whitespace in the Drive Tree. This is the same
    253259thing you'd get if you'd clicked the :link reftype=hd
    254260res=93800.Views:elink. pulldown menu with the Drive Tree active
     
    258264:i1 id=aboutDRAGDROP.Drag and drop
    259265FM/2 with a drag and drop operation underway&colon.
     266:p.
    260267:artwork align=left name='bitmaps\dragdrop.bmp'.
     268:p.
    261269Several files are being moved from a Directory Container to a directory
    262 in the Drive Tree.  Notice that in this picture several Directory
     270in the Drive Tree. Notice that in this picture several Directory
    263271Containers are open with different views (Details, Text and Name view)
    264272and that mini-icons are used in the Drive Tree container.
     
    267275:i1 id=aboutDIRECTEDIT.Direct editing
    268276:artwork align=left name='bitmaps\direct.bmp'.
    269 An example of direct editing.  Press and hold the ALT key while clicking
    270 the filename in the container with B1.  A new name can then be entered
     277:p.
     278An example of direct editing. Press and hold the ALT key while clicking
     279the filename in the container with B1. A new name can then be entered
    271280into the small MLE by the object's icon (where the name usually shows),
    272281and another click of B1 will accept the input, while Escape will abort
     
    274283:p.
    275284Note that the entire pathname of the object is presented for editing --
    276 this allows you to move the object as you rename it, if desired.  The
     285this allows you to move the object as you rename it, if desired. The
    277286filename portion of the pathname is initially highlighted for you, so
    278 there's no extra work for a simple file rename.  FM/2 also tries to
    279 enlarge the MLE created to make things easier.  Standard OS/2 editing
     287there's no extra work for a simple file rename. FM/2 also tries to
     288enlarge the MLE created to make things easier. Standard OS/2 editing
    280289keys work as expected.
  • trunk/dll/ipf/tutor.ipf

    r10 r268  
    22:i1 id=aboutTutorial.Tutorials
    33:artwork name='bitmaps\tutor.bmp' align=center.
    4 This tutorial section is provided for the complete novice.  If you
     4This tutorial section is provided for the complete novice. If you
    55already know how to use OS/2's WPS in general and have used other OS/2
    6 PM applications, you probably don't need this tutorial.  Go forth and be
     6PM applications, you probably don't need this tutorial. Go forth and be
    77productive.
    88:p.
    99This tutorial addresses the most often used commands in FM/2 -- the only
    10 commands that most "file managers" provide.  There are, of course, many
    11 more commands available in FM/2.  However, once you have the methodology
    12 for these basic commands mastered, other commands are easy to use.  Of
    13 course, if you're totally new to OS/2 PM and WPS, you should first run
    14 the OS/2 tutorial.  I'm not kidding -- PM programs have similar user
    15 interfaces, and it all begins with the WPS, so the OS/2 tutorial is a
    16 must for the new OS/2 user to begin understanding :hp1.all:ehp1. his
    17 applications.
     10commands that most "file managers" provide. There are, of course, many
     11more commands available in FM/2. However, once you have the methodology
     12for these basic commands mastered, other commands are easy to use.
    1813:p.
    1914Plesae pick a topic&colon.
     
    4641:i1 id=aboutContextTutorial.Using Context menus
    4742To request a context menu, first point the mouse arrow at an object.
    48 Then click mouse button 2 (B2, usually the right button).  A context
     43Then click mouse button 2 (B2, usually the right button). A context
    4944menu will then appear, if available.
    5045:p.
     
    5247be shown if one were requested over the :hp1.current object:ehp1..
    5348Keyboard-only users can use the :hp1.Files:ehp1. menu instead of context
    54 menus.  But stop being unproductively stubborn, get a pointing device.
     49menus. But stop being unproductively stubborn, get a pointing device.
    5550&colon.-)
    5651:p.
     
    6055To make things a little clearer to users who haven't used OS/2's WPS
    6156before, take a look at the following three pictures&colon.
     57:p.
    6258:artwork name='bitmaps\tcontxt1.bmp' align=left.
    63 A context menu that applies to one item.  The mouse arrow still points at
     59:p.
     60A context menu that applies to one item. The mouse arrow still points at
    6461the object on which the menu was requested -- that is the object that will
    65 be affected by the command selected from the menu.  You can see the dotted
     62be affected by the command selected from the menu. You can see the dotted
    6663outline with rounded corners around the object.
     64:p.
    6765:artwork name='bitmaps\tcontxt2.bmp' align=left.
    68 A context menu that applies to several items.  The mouse arrow still points
     66:p.
     67A context menu that applies to several items. The mouse arrow still points
    6968at the object on which the menu was requested -- since it is highlighted,
    7069all highlighted objects will be affected by the command selected from the
    7170menu.
     71:p.
    7272:artwork name='bitmaps\tcontxt3.bmp' align=left.
    73 A context menu that applies to a container as a whole.  The menu was
     73:p.
     74A context menu that applies to a container as a whole. The menu was
    7475requested over container whitespace (an empty part of the container),
    7576not over any of the objects that it contains.
     
    7778:h2 res=99810 name=PANEL_TRENAME.Rename tutorial
    7879:i1 id=aboutRenameTutorial.Rename Tutorial
     80:p.
    7981:artwork name='..\..\bitmaps\rename.bmp' align=left.
     82:p.
    8083Please select a method to learn about&colon.
    8184:p.
     
    8891:h3 res=99811 name=PANEL_TRENAMEDIRECT.Rename by direct editing
    8992:i1 id=aboutRenameDirectTutorial.Rename by Direct Editing
     93:p.
    9094:artwork align=left name='bitmaps\direct.bmp'.
     95:p.
    9196To rename a file system object, hold down the :hp1.Alt:ehp1. key and
    9297click on the object's name with mouse button 1 (B1, usually the left
    93 button).  The entire pathname of the object appears in a framed control
    94 known as an :hp1.MLE:ehp1..  You'll initially be located at the start of
     98button). The entire pathname of the object appears in a framed control
     99known as an :hp1.MLE:ehp1.. You'll initially be located at the start of
    95100the filename with the filename (excluding the path) highlighted (ready
    96 to be replaced by whatever you type).  The usual editing keys work
     101to be replaced by whatever you type). The usual editing keys work
    97102(arrows, home, end, insert, delete, etc.).
    98103:p.
    99 Type in the new name, then click the file system object again.  FM/2
     104Type in the new name, then click the file system object again. FM/2
    100105renames the object and updates the display.
    101106:p.
     
    106111:h3 res=99812 name=PANEL_TRENAMEDRAG.Rename by drag and drop
    107112:i1 id=aboutRenameDragTutorial.Rename by Drag and Drop
     113:p.
    108114:artwork name='bitmaps\drename.bmp' align=left.
     115:p.
    109116To invoke a rename using drag and drop, "grab" a file system object with
    110117the mouse by placing the mouse pointer on top of the object and
    111118depressing and holding mouse button 2 (B2, usually the right button).
    112119Still holding B2, "drag" the object to some whitespace (unoccupied space
    113 in the Directory Container -- a blank area) and then release B2.  The
     120in the Directory Container -- a blank area) and then release B2. The
    114121:link reftype=hd res=91400.Rename dialog:elink. will then appear and you
    115122can enter a new name for the object.
     
    123130:i1 id=aboutRenameKeyTutorial.Rename by Keystrokes
    124131Place the dotted cursor on the object you want to rename (make it the
    125 :hp1.current object:ehp1.).  Press Ctrl + r, the accelerator key
     132:hp1.current object:ehp1.). Press Ctrl + r, the accelerator key
    126133for the Rename command, or pick "Rename" from the :hp1.Files menu:ehp1..
    127134:p.
     
    133140:h2 res=99820 name=PANEL_TMOVE.Move tutorial
    134141:i1 id=aboutMoveTutorial.Move Tutorial
     142:p.
    135143:artwork name='..\..\bitmaps\mover.bmp' align=left.
     144:p.
    136145Please select a method to learn about&colon.
    137146:p.
     
    144153:h3 res=99821 name=PANEL_TMOVEDIRECT.Move by direct editing
    145154:i1 id=aboutMoveDirectTutorial.Move by Direct Editing
     155:p.
    146156:artwork align=left name='bitmaps\direct.bmp'.
     157:p.
    147158To move a file system object, hold down the :hp1.Alt:ehp1. key and
    148159click on the object's name with mouse button 1 (B1, usually the left
    149 button).  The entire pathname of the object appears in a framed control
    150 known as an :hp1.MLE:ehp1..  You'll initially be located at the start of
    151 the pathname.  Type in the new pathname, then click the file system
    152 object again.  FM/2 moves the object and updates the display.
     160button). The entire pathname of the object appears in a framed control
     161known as an :hp1.MLE:ehp1.. You'll initially be located at the start of
     162the pathname. Type in the new pathname, then click the file system
     163object again. FM/2 moves the object and updates the display.
    153164:p.
    154165You can abort the move by pressing the :hp1.ESCape:ehp1. key.
     
    158169:h3 res=99822 name=PANEL_TMOVEDRAG.Move by drag and drop
    159170:i1 id=aboutMoveDragTutorial.Move by Drag and Drop
     171:p.
    160172:artwork name='bitmaps\tmove.bmp' align=left.
     173:p.
    161174To move a file system object using drag and drop, "grab" a file system
    162175object with the mouse by placing the mouse pointer on top of the object
    163176and depressing and holding mouse button 2 (B2, usually the right
    164 button).  Still holding B2, "drag" the object to its destination (for
     177button). Still holding B2, "drag" the object to its destination (for
    165178instance, onto a directory in the Drive Tree), and then release B2.
    166179:p.
     
    172185:h3 res=99823 name=PANEL_TMOVEKEY.Move by keystrokes
    173186:i1 id=aboutMoveKeyTutorial.Move by Keystrokes
    174 Place the dotted cursor on the object you want to rename (make it the
    175 :hp1.current object:ehp1.).  Press Ctrl + m, the accelerator key
     187Place the dotted cursor on the object you want to move (make it the
     188:hp1.current object:ehp1.). Press Ctrl + m, the accelerator key
    176189for the Move command, or pick "Move" from the :hp1.Files menu:ehp1..
    177190:p.
     
    183196:h2 res=99830 name=PANEL_TCOPY.Copy tutorial
    184197:i1 id=aboutCopyTutorial.Copy Tutorial
     198:p.
    185199:artwork name='..\..\bitmaps\copier.bmp' align=left.
     200:p.
    186201Please select a method to learn about&colon.
    187202:p.
     
    194209:h3 res=99832 name=PANEL_TCOPYDRAG.Copy by drag and drop
    195210:i1 id=aboutCopyDragTutorial.Copy by Drag and Drop
     211:p.
    196212:artwork name='bitmaps\tcopy.bmp' align=left.
     213:p.
    197214To copy a file system object using drag and drop, press and hold the
    198215Ctrl key, then "grab" a file system object with the mouse by placing the
    199216mouse pointer on top of the object and depressing and holding mouse
    200 button 2 (B2, usually the right button).  Still holding B2 and Ctrl,
     217button 2 (B2, usually the right button). Still holding B2 and Ctrl,
    201218"drag" the object to its destination (for instance, onto a directory in
    202 the Drive Tree), and then release B2.  During a copy drag, the dragged
     219the Drive Tree), and then release B2. During a copy drag, the dragged
    203220object is "ghosted" rather than solid as during a move drag.
    204221:p.
     
    211228:i1 id=aboutCopyKeyTutorial.Copy by Keystrokes
    212229Place the dotted cursor on the object you want to rename (make it the
    213 :hp1.current object:ehp1.).  Press Ctrl + c, the accelerator key
     230:hp1.current object:ehp1.). Press Ctrl + c, the accelerator key
    214231for the Copy command, or pick "Copy" from the :hp1.Files menu:ehp1..
    215232:p.
     
    223240:i1 id=aboutCloneTutorial.Clone Tutorial
    224241You :hp1.clone:ehp1. a file system object by copying it into the same
    225 directory that already holds it.  The :link reftype=hd res=91400.Rename
     242directory that already holds it. The :link reftype=hd res=91400.Rename
    226243dialog:elink. will then appear because of the naming conflict, and allow
    227244you to specify a new name for the new, "cloned" copy of the object.
     
    231248:h2 res=99840 name=PANEL_TCOMPARE.Compare tutorial
    232249:i1 id=aboutCompareTutorial.Compare Tutorial
     250:p.
    233251:artwork name='..\..\bitmaps\linkdrag.bmp' align=left.
     252:p.
    234253To compare file system objects, link-drag one object onto another.
    235254:p.
    236255A link drag is initiated by placing the mouse cursor on the object to
    237256be dragged, holding down the Ctrl and Shift keys, and clicking mouse
    238 button 2 (B2, usually the right button).  While still holding the keys
     257button 2 (B2, usually the right button). While still holding the keys
    239258and B2, move the mouse to drag the object over the target object, then
    240 release B2.  During a link drag, a rubber-band line appears between the
     259release B2. During a link drag, a rubber-band line appears between the
    241260source object and the dragged object.
    242261:p.
    243262You can change the compare program from FM/2's :link reftype=hd
    244 res=94600.Internal Settings notebook:elink..  An internal default is
     263res=94600.Internal Settings notebook:elink.. An internal default is
    245264used if you leave the entry there blank.
    246265
    247266:h2 res=99850 name=PANEL_TVIEW.View tutorial
    248267:i1 id=aboutViewTutorial.View Tutorial
     268:p.
    249269:artwork name='..\..\bitmaps\view.bmp' align=left.
    250 Viewing files can be as simple as double-clicking their objects.  FM/2
     270:p.
     271Viewing files can be as simple as double-clicking their objects. FM/2
    251272will attempt to do to the object what should "logically" be done, which,
    252 in the case of text files, archives and the like, is to view them.  If
     273in the case of text files, archives and the like, is to view them. If
    253274you would like different actions taken, FM/2 provides :link reftype=hd
    254275res=90400.Associations:elink. to allow you to assign special viewer
    255276programs or actions to different file types.
    256277:p.
    257 You can also invoke viewing directly from the :hp1.Files:ehp1. and :link
     278You can also invoke viewing directly from the :hp1.Files:ehp1., :link
    258279reftype=hd res=93700.context:elink. menus, or by pressing the Ctrl + v
    259 accelerator key.  In this case, no other default actions will be taken
    260 even if one might be "obvious" -- the object will simply be viewed.  If,
     280accelerator key. In this case, no other default actions will be taken
     281even if one might be "obvious" -- the object will simply be viewed. If,
    261282for example, you wanted to view an executable, this is the method you'd
    262 need to use (the default double-click action would be to run the
     283need to use (the default double-click action would be to run an
    263284executable file, which is usually what you'd want to do).
    264285:p.
    265286You can change the viewing program from FM/2's :link reftype=hd
    266 res=94600.Internal Settings notebook:elink..  An internal default is
     287res=94600.Internal Settings notebook:elink.. An internal default is
    267288used if you leave the entry there blank.
    268289:p.
     
    272293:h2 res=99860 name=PANEL_TOPEN.Open tutorial
    273294:i1 id=aboutOpenTutorial.Open Tutorial
    274 "Opening" a file system object is an object-based concept.  When you
     295"Opening" a file system object is an object-based concept. When you
    275296open a directory, you get a view of the file system objects (files and
    276 directories) contained within that object.  When you open an executable
    277 file, you cause it to execute.  When you open a data file, you usually
     297directories) contained within that object. When you open an executable
     298file, you cause it to execute. When you open a data file, you usually
    278299cause its owning application (if known) to execute with the data file
    279 being loaded by the application.  This is known as a "default" open.
     300being loaded by the application. This is known as a "default" open.
    280301:p.
    281302But there are often several types of "open" operation that can be
    282 performed on an object.  For instance, you can open an object's Settings
    283 notebook.  FM/2 provides some variations on WPS open themes. You can
     303performed on an object. For instance, you can open an object's Settings
     304notebook. FM/2 provides some variations on WPS open themes. You can
    284305open either a WPS folder or an FM/2 Directory Container for a directory
    285306object, for instance (to find out more about opening an FM/2 Directory
    286307Container for a directory object, see the :link reftype=hd
    287 res=98900.Opening a Directory Container:elink. topic).
     308res=98900.Opening a Directory Container:elink. section).
    288309:p.
    289310To open an object's default WPS "view," use the F6 accelerator key, or
    290 press the Ctrl key while double-clicking the object.  The same type of
     311press the Ctrl key while double-clicking the object. The same type of
    291312"open" will be done on the object that would be done if you directly
    292313double-clicked the object in a WPS folder object (remember, WPS folders
     
    298319:p.
    299320For directory objects, you have the choice of WPS view type to open, as
    300 well -- Icon, Details or Tree view.  You pick these from the
     321well -- Icon, Details or Tree view. You pick these from the
    301322:hp1.Open:ehp1. cascade menu on the :hp1.Files:ehp1. menu or a context
    302323menu requested on the object (you request a context menu on an object by
    303324placing the mouse pointer on the object and clicking mouse button 2,
    304 B2).  A command to open an FM/2 Directory Container is also on that
     325B2). A command to open an FM/2 Directory Container is also on that
    305326cascade menu, and is the default.
    306327
    307328:h2 res=99870 name=PANEL_TDELETE.Delete tutorial
    308329:i1 id=aboutDeleteTutorial.Delete Tutorial
     330:p.
    309331:artwork name='..\..\bitmaps\delete.bmp' align=left.
    310332:artwork name='..\..\bitmaps\permdel.bmp' align=left.
     333:p.
    311334There are two styles of deleting under FM/2 -- a "regular" delete, that
    312335leaves the objects capable of being undeleted using OS/2's UNDELETE
    313336command or FM/2's Undelete Utility, and a "permanent" delete that does
    314 not leave the object recoverable.  "Permanent" deletions are usually
    315 faster than "recoverable" deletions.  You can select which type you want
     337not leave the object recoverable. "Permanent" deletions are usually
     338faster than "recoverable" deletions. You can select which type you want
    316339to be the default in FM/2's internal :link reftype=hd res=94600.Settings
    317340notebook:elink..
    318341:p.
    319 Note&colon.  You have to set up OS/2, using CONFIG.SYS, so that UNDELETE
    320 is enabled to do non-permanent deletions.  See :link reftype=launch
     342Note&colon. You have to set up OS/2, using CONFIG.SYS, so that UNDELETE
     343is enabled to do non-permanent deletions. See :link reftype=launch
    321344object='VIEW.EXE' data='CMDREF.INF UNDELETE'.UNDELETE:elink. in the OS/2
    322 online help.
     345online help. Note&colon. FM/2 does not use the "Trashcan" that comes with
     346eWorkPlace or XWorkPlace for non-permanent deletions. If you wish to use the
     347"Trashcan" can drag the items directly to it from FM/2.
    323348:p.
    324349You can delete objects in many ways&colon.
    325350:p.
    326 :hp1.Drag and drop:ehp1.  Drag the object(s) to FM/2's toolbar Trashcan
    327 icon, or to the WPS's Shredder icon. (You might want to pick up a
     351:hp1.Drag and drop:ehp1. Drag the object(s) to FM/2's toolbar Trashcan
     352icon, to the WPS's Shredder icon or to a Trashcan application. (You might want to pick up a
    328353replacement for the WPS Shredder like the free :hp1.mshred:ehp1. object
    329354written by the author of FM/2.)
    330355:p.
    331 :hp1.Files or context menu:ehp1.  Select the :hp1.Delete:ehp1. command
     356:hp1.Files or context menu:ehp1. Select the :hp1.Delete:ehp1. command
    332357or pick the type of delete from the cascade menu.
    333358:p.
    334 :hp1.Keyboard:ehp1.  The Ctrl + d accelerator key performs a "regular"
     359:hp1.Keyboard:ehp1. The Ctrl + d accelerator key performs a "regular"
    335360delete, Shift + Ctrl + D (also written as just "Ctrl + D" -- accelerator
    336361keys are case sensitive) performs a permanent delete.
     
    339364:i1 id=aboutMkdirTutorial.Make Directory Tutorial
    340365:artwork name='..\..\bitmaps\mkdir.bmp' align=left.
     366:p.
    341367To create a directory, use FM/2's Make Directory command.
    342368:p.
    343369You can pick this command from the :hp1.Files:ehp1. menu or a
    344 :hp1.context:ehp1. menu (under the Miscellaneous cascade menu).  You can
     370:hp1.context:ehp1. menu (under the Miscellaneous cascade menu). You can
    345371click the button on FM/2's toolbar. Or you can use the Shift + Ctrl
    346372+ "M" accelerator key.
     
    348374FM/2 presents you with a small dialog box in which you can type the name
    349375of the directory that you want to create -- FM/2 will try to fill in the
    350 entry field with a guess at the first part of what you want, but you can
     376entry field with a guess at the first part (parent directories) of what you want, but you can
    351377delete that if desired (:hp1.Shift + Home:ehp1., then touch the
    352378:hp1.Del:ehp1. key to do it quickly).
    353379:p.
    354 The directory created can be many levels deep.  FM/2 will create
     380The directory created can be many levels deep. FM/2 will create
    355381intermediate subdirectories as required if they do not already exist.
    356382For example, if you have a directory \myapps and want to create a
     
    366392:i1 id=aboutArchiveTutorial.Create Archive Tutorial
    367393:artwork name='..\..\bitmaps\archive.bmp' align=left.
     394:p.
    368395To create a new archive, select the file system objects you want in the
    369396archive, then select :hp1.Archive:ehp1. from the :hp1.Files:ehp1. menu
     
    378405the archive to be created and the type of archiving action (move or copy
    379406to archive, include subdirectories or not, recurse into subdirectories,
    380 etc.).  You can specify additional filemasks or place more obscure
     407etc.). You can specify additional filemasks or place more obscure
    381408options on the command line to be executed.
    382409:p.
     
    392419:i1 id=aboutExtractTutorial.Extract from Archive Tutorial
    393420:artwork name='..\..\bitmaps\extract.bmp' align=left.
     421:p.
    394422To extract from an archive, first place the dotted cursor on the file
    395423(make it the :hp1.current object:ehp1.), then select the
     
    411439:i1 id=aboutDoubleClick.Double-click actions
    412440
    413 Double-clicking a file system object causes a :hp1.default action:ehp1.
    414 to be taken.  FM/2 has its own set of defaults, but you can override
    415 those in many cases.  Here's a description of the FM/2 defaults and
     441Double-clicking a file system object causes its :hp1.default action:ehp1.
     442to be taken. FM/2 has its own set of defaults, but you can override
     443those in many cases. Here's a description of the FM/2 defaults and
    416444how to change them&colon.
    417445:p.
    418446If the object is a directory, the Directory Container switches to look
    419 into that directory.  If it's a file, FM/2 first checks to see if you've
     447into that directory. If it's a file, FM/2 first checks to see if you've
    420448assigned any :link reftype=hd res=90400.Associations:elink. that match
    421 the filename and signature (if applicable).  Next, FM/2 tries to view
    422 the file as an :link reftype=hd res=90200.archive:elink..  If it's not
     449the filename and signature (if applicable). Next, FM/2 tries to view
     450the file as an :link reftype=hd res=90200.archive:elink.. If it's not
    423451an archive, FM/2 checks to see if the file's an executable and runs it
    424 if so. Then INI and HLP files are checked by extensions and viewed as
    425 such.  If all else fails, FM/2 views the file using the configured or
     452if it is. Then INI and HLP files are checked by extensions and viewed as
     453such. If all else fails, FM/2 views the file using the configured or
    426454internal viewer.
    427455:p.
     
    434462WPS associations, runs executables, opens folders in their default view,
    435463or opens the Settings notebook for the object -- whatever
    436 double-clicking on the object in the WPS would do), and holding down the
    437 Shift key while double-clicking causes the file to be directly Viewed,
    438 bypassing the other steps listed above (for file objects; directory
    439 objects cause another FM/2 window to be opened).
     464double-clicking on the object in the WPS would do). Holding down the
     465Shift key while double-clicking causes file objects to be directly Viewed,
     466bypassing the steps listed above for file objects (for directory
     467objects this causes a new FM/2 container to be opened).
    440468:p.
    441469If you'd like more detail, go to the :link reftype=hd
     
    444472:p.
    445473You can change what FM/2 does on a double-click of a file object by
    446 using FM/2's :link reftype=hd res=90400.Associations:elink..  This is
     474using FM/2's :link reftype=hd res=90400.Associations:elink.. This is
    447475a very powerful tool for customizing FM/2's behavior, so when you're
    448476ready, be sure to look it over.
  • trunk/dll/ipf/util.ipf

    r10 r268  
    44FM/2 offers several utilities to make your life a little easier&colon.
    55:p.
    6 :link reftype=hd res=100045.Remap drives:elink.
    7 .br
    86:link reftype=hd res=90100.Collector:elink.
    97.br
     
    3432:hp2.System Setup:ehp2. folder, and command line windows from this menu.
    3533
    36 :h2 res=100045 name=PANEL_REMAP.Remap drives
    37 :i1 id=aboutRemap.Remap drives
    38 
    39 To remap (attach) a remote server to a local drive letter, enter the
    40 UNC server name in the entry field at the top center of this dialog,
    41 then select the drive letter from the left (attach) listbox to which to
    42 attach the server.  Finally, click the :hp1.Attach:ehp1. button.
    43 :p.
    44 To detach a local drive letter from a remote server, select the
    45 drive letter from the right (detach) listbox, then click the
    46 :hp1.Detach:ehp1. button.
    47 :p.
    48 When you're through remapping drives, click :hp1.Done:ehp1..
    49 :p.
    50 According to IBM LAN Server documentation, a UNC name consists of a
    51 double backslash, the name of the server, another backslash, and the
    52 name of the resource&colon.  \\servername\netname
    53 :p.
    54 Note that FM/2 saves the UNC names you enter in the listbox below the
    55 entry field.  You can recall these names later by clicking on them.
    56 The :hp1.Delete:ehp1. button deletes the currently selected name from
    57 the listbox, and the :hp1.Clear:ehp1. button removes all names from
    58 the listbox.  Names are added automatically.  Up to 200 names can be
    59 stored in this manner (kept on disk between sessions in a file named
    60 RESOURCE.DAT).
    61 
    6234.im collect.ipf
    6335
    6436.im comp.ipf
    6537
    66 :h2 res=92500 name=PANEL_UNDELETE.Undelete Files
    67 :i1 id=aboutUndelete.Undelete Files
    68 
    69 :artwork name='..\..\bitmaps\undelete.bmp' align=center.
    70 This leads to a dialog that interfaces with UNDELETE.COM to allow you to
    71 undelete files.  The drive that will be operated on is determined by the
    72 highlighted object in the directory tree.  This dialog filters out files
    73 that already exist on the disk.
    74 :p.
    75 The :hp1.Mask:ehp1. entry field lets you set a mask (which can include
    76 a directory path).  You can switch drives using the dropdown listbox.
    77 A :hp1.Subdirs:ehp1. button lets you choose whether to show files that
    78 can be undeleted in subdirectories as well.
    79 :p.
    80 You can always go directly to UNDELETE.COM if you have the need for more
    81 control.  This is provided only for convenience.
     38.im inis.ipf
    8239
    8340:h2 res=92600 name=PANEL_KILLPROC.Kill Processes
    8441:i1 id=aboutKillProc.Kill Processes
    8542:artwork name='..\..\bitmaps\killproc.bmp' align=center.
     43:p.
    8644This leads to a dialog that allows you to kill most renegade processes.
    8745If you run into a window that just won't close, or one that hides itself
    8846but doesn't quite go away, this may let you kill the hung process.
    8947:p.
    90 Obviously you'll want to exercise some care here.  FM/2 will remove its
     48Obviously you'll want to exercise some care here. FM/2 will remove its
    9149own PID (Process ID) from the list, but if you ran it from a command
    92 line you could still kill FM/2 by killing its parent.  You can also kill
    93 off the WPS (PMSHELL.EXE), but it should restart itself.  Some kernal
     50line you could still kill FM/2 by killing its parent. You can also kill
     51off the WPS (PMSHELL.EXE), but it should restart itself. Some kernal
    9452processes show up but can't be killed.
    9553:p.
    9654A checkbox allows you to set the Process Killer to use the undocumented
    97 DosQProcStat API instead of parsing PSTAT.EXE's output.  While this
     55DosQProcStat API instead of parsing PSTAT.EXE's output. While this
    9856removes the requirement of having an English version of PSTAT.EXE, you
    9957should be aware that the DosQProcStat can be changed by IBM without
    10058notice, possibly causing the Process Killer to fail and/or trap.
    10159
    102 :h2 res=92700 name=PANEL_INSTANT.Instant Batch File
     60:h2 res=92700 name=PANEL_INSTANT.Instant CMD File
    10361:i1 id=aboutInstant.Instant Batch File
    10462:artwork name='..\..\bitmaps\instant.bmp' align=center.
    105 This leads to a dialog that lets you quickly hack together a batch
    106 (command) file and run it (the currently highlighted tree directory will
    107 be its default directory).  The command file isn't saved; think of it as
     63:p.
     64This leads to a dialog that lets you quickly hack together a command
     65(batch) file and run it (the currently highlighted tree directory will
     66be its default directory). The command file isn't saved; think of it as
    10867an "extended command line" which allows you to enter more than one line
    10968at a time (for instance, when several tests must be made).
    110 
    111 :h2 res=92800 name=PANEL_COMMANDLINE.Command Line
    112 :i1 id=aboutCommandLine.Command Line
    113 :artwork name='..\..\bitmaps\cmdline.bmp' align=center.
    114 This brings up a windowed OS/2 command line.  F9 is the accelerator key
    115 for this command.
    116 :p.
    117 There are also commands to bring up a windowed DOS command line and
    118 a Win-OS/2 full screen session.
    119 
    120 .im inis.ipf
    12169
    12270:h2 res=94800 name=PANEL_VIEWINFS.View Bookshelf
     
    12472FM/2 presents a listbox containing all the .INF files found in the
    12573directories listed in your BOOKSHELF environment variable (see
    126 SET BOOKSHELF= in CONFIG.SYS).  You select the .INF file(s) you want
     74SET BOOKSHELF= in CONFIG.SYS). You select the .INF file(s) you want
    12775to view, then click the :hp1.View:ehp1. button.
    12876:p.
    12977If you selected more than one .INF file, FM/2 calls VIEW.EXE in such
    13078a way that all the files are presented at once (a single contents
    131 page appears listing the contents of all the .INF files).  Warning:
     79page appears listing the contents of all the .INF files). Warning:
    13280Don't select more than one filename with the same title (left column
    133 of listbox) -- View.exe will choke if you do, and be unable to read any
    134 of the files.
     81of listbox) -- IBM's View.exe will choke if you do, and be unable to read any
     82of the files. However Newview works fine.
    13583:p.
    13684You can enter text into the entry field below the listbox, and FM/2 will
    137 try to find the first listbox entry with matching text as you go.  If
     85try to find the first listbox entry with matching text as you go. If
    13886you click :hp1.Select:ehp1. FM/2 will highlight all matching entries
    13987(hint: empty the entry field and click Select to unhighlight
    140 everything).  If you click :hp1.Filter:ehp1. FM/2 will remove all but
     88everything). If you click :hp1.Filter:ehp1. FM/2 will remove all but
    14189highlighted items from the listbox (:hp1.Rescan:ehp1. will refill the
    14290listbox).
     
    14492The :hp1.AddDirs:ehp1. button will copy the contents of the entry field
    14593and add it to the directories listed in the BOOKSHELF environment variable.
    146 It should be in the same format as the HELP environment variable uses,
    147 fully qualified directory names separated by semi-colons.  The next time you
     94It should be in the same format that the BOOKSHELF environment variable uses,
     95fully qualified directory names separated by semi-colons. The next time you
    14896use the Bookshelf Viewer, FM/2 will remember this input and use it. This
    14997is an internal addition; your CONFIG.SYS and environment are not
     
    155103:p.
    156104When you're done with the dialog, press [ESCape] or click
    157 :hp1.Cancel:ehp1..  Any open .INF files remain open until you close them
     105:hp1.Cancel:ehp1.. Any open .INF files remain open until you close them
    158106(hint&colon. F3 will close an .INF file).
    159107:p.
    160 Note&colon.  this dialog is shared by the :hp2.:link reftype=hd
     108Note&colon. this dialog is shared by the :hp2.:link reftype=hd
    161109res=94850.View Helpfiles:elink.:ehp2. and :hp2.View Bookshelf:ehp2.
    162110commands. If you click on either while this dialog is up, the dialog is
    163 simply brought to the foreground.  Close it if you want to switch
     111simply brought to the foreground. Close it if you want to switch
    164112function. (This doesn't apply if you started this from the Bookshelf
    165113Viewer object in the FM/2 WPS folder.)
     
    169117FM/2 presents a listbox containing all the .HLP files found in the
    170118directories listed in your HELP environment variable (see SET HELP= in
    171 CONFIG.SYS).  You select the .HLP file you want to view, then click
     119CONFIG.SYS). You select the .HLP file you want to view, then click
    172120the :hp1.View:ehp1. button.
    173121:p.
     
    177125The :hp1.AddDirs:ehp1. button will copy the contents of the entry field
    178126and add it to the directories listed in the HELP environment variable.
    179 It should be in the same format as the HELP environment variable uses,
    180 fully qualified directory names separated by semi-colons.  The next time
    181 you use the Bookshelf Viewer, FM/2 will remember this input and use it.
     127It should be in the same format that the HELP environment variable uses,
     128fully qualified directory names separated by semi-colons. The next time
     129you use the HELP Viewer, FM/2 will remember this input and use it.
    182130This is an internal addition; your CONFIG.SYS and environment are not
    183131modified.
    184132:p.
    185133When you're done with the dialog, press [ESCape] or click
    186 :hp1.Cancel:ehp1..  Any open .HLP file will remain open until you close
     134:hp1.Cancel:ehp1.. Any open .HLP file will remain open until you close
    187135it.
    188136:p.
    189 Note&colon.  this dialog is shared by the :hp2.:link reftype=hd
     137Note&colon. this dialog is shared by the :hp2.:link reftype=hd
    190138res=94800.View Bookshelf:elink.:ehp2. and :hp2.View Helpfiles:ehp2.
    191139commands. If you click on either while this dialog is up, the dialog is
    192 simply brought to the foreground.  Close it if you want to switch
     140simply brought to the foreground. Close it if you want to switch
    193141function. (This doesn't apply if you started this from the Helpfile
    194 Viewer object in the FM/2 WPS folder.)
     142Viewer object in the FM/2 WPS folder or from the command line.)
    195143
     144:h2 res=92800 name=PANEL_COMMANDLINE.Command Lines
     145:i1 id=aboutCommandLine.Command Lines
     146:artwork name='..\..\bitmaps\cmdline.bmp' align=center.
     147:p.
     148There are three different command line choices. The first
     149brings up a windowed OS/2 command line. F9 is the accelerator key
     150for this command. The last two bring up a windowed DOS command line and
     151a Win-OS/2 full screen session respectively but only if you have installed DOS and
     152Win-OS/2 support.
     153
  • trunk/dll/ipf/walkem.ipf

    r10 r268  
    33
    44:artwork name='..\..\bitmaps\walk.bmp' align=center.
     5:p.
    56This dialog lets you pick a directory by "walking" through the
    6 directory structure of your drives.  It also lets you save and
     7directory structure of your drives. It also lets you save and
    78recall user-defined directories.
    89:p.
    9 On the left is a listbox containing all your drive letters.  If you
     10On the left is a listbox containing all your drive letters. If you
    1011select a drive, the directories on that drive fill the center listbox.
    1112:p.
     
    1617:p.
    1718The listbox on the right of the window (:hp1.User List:ehp1.) contains
    18 only directories that you add to it.  To add a directory, click
     19only directories that you add to it. To add a directory, click
    1920:hp1.Add:ehp1. when the desired directory name is displayed in the
    20 entry field at the bottom of the window.  To delete a directory,
    21 highlight it and click :hp1.Delete:ehp1..  To switch to one of these
     21entry field at the bottom of the window. To delete a directory,
     22highlight it and click :hp1.Delete:ehp1.. To switch to one of these
    2223user-defined directories, highlight it and click :hp1.Okay:ehp1. or
    23 double-click the directory.  You can add up to 100 directories.
     24double-click the directory. You can add up to 100 directories.
    2425:p.
    2526You can also select directories from the Recent directories drop-down
    26 list at the top right of the window.  FM/2 adds to this list
    27 automatically as you traverse your drives.  Just drop down the list
     27list at the top right of the window. FM/2 adds to this list
     28automatically as you traverse your drives. Just drop down the list
    2829and click the directory of choice.
    2930:p.
    3031When the desired directory is displayed in the bottom entry field of
    31 the dialog, click :hp1.Okay:ehp1. to exit.  Click :hp1.Cancel:ehp1. to
     32the dialog, click :hp1.Okay:ehp1. to exit. Click :hp1.Cancel:ehp1. to
    3233exit without selecting a directory.
    3334
  • trunk/dll/ipf/window.ipf

    r10 r268  
    22:i1 id=aboutWindowMenu.Windows Menu
    33:artwork name='..\..\bitmaps\window.bmp' align=center.
    4 The Windows submenu lets you control FM/2's child windows.  In addition,
     4:p.
     5The Windows submenu lets you control FM/2's child windows. In addition,
    56you can select child windows to give the focus from the bottom of the
    6 menu.  Following is a discussion of the "permanent" commands on the menu.
     7menu. Following is a discussion of the "permanent" commands on the menu.
    78:p.
    89:hp1.Tile&colon.:ehp1.
     
    2223:p.
    2324Brings up a dialog that lets you minimize, restore or close selected
    24 child windows.  You can also chord the mouse on a blank portion of the
     25child windows. You can also chord the mouse on a blank portion of the
    2526main client window to call up this dialog.
    2627:p.
     
    3637:i1 id=aboutWindowDlg.Windows List
    3738:artwork name='..\..\bitmaps\window.bmp' align=center.
     39:p.
    3840This dialog lets you minimize, restore or close selected child windows.
    3941It's accessed via toolbar button, :link reftype=hd
Note: See TracChangeset for help on using the changeset viewer.