úo┼£°∞I+╙î"8Rå╝
∙!`
íΣ$`Ü╘Mì╠ !6#l'¼)⌠*>+Ç,¿2τ5-6r7╡8∩<#=W>å@$B┴/C┴▒A_lr}Aol∩√AorΩAÿl⌠Aol°9Aol1╡Aolµ¢Aoºü┴A╧πBQA	º
ôpA3IzAuë}!ºA╖l$%uAo╬Ö(┬A	°[*ÉA
6lδ-«A
olÖ0ΓA
oL{4öArå8▌A¼└∞8≤A
µl▀9╙A
ol▓<¡A
ol_>≥A
o·QAÅA"6αCAbl≡D<Aow,FAíl.J┐AolφK£Ao╕ëOA▐⌠¿R Al╚S╓Ao$₧VΩAFlêWâAol[╣Aol─]±AoU╡_─Aüly`½Aoô$b╞A├┌ΩdnA%Xf▐A
Uo6h▀A
Ålj'Aol<nαAolr~AolÜtAoláw⌠Aooö{;A╛l╧lAol;âUAo╧ÉçΦA²xèEAC[╜Ä₧Açƒ[æA╔lnö5AolúÿΓAolà¢¥A
oα"₧ûAⁿ╕áèA2ABú%A lgñrA ok┘ª╫A!ƒl░⌐«A!o^¼uA ╡CreditsPress [PgDn] for information on using HELP!Using HelpFile ManagerFile ManagerUsing HelpFile Manager KeysFile Manager KeysFile ManagerMiscellaneous KeysMiscellaneous KeysFile Manager KeysFile Manager DeleteFile Manager DeleteFile Manager SortFile Manager SortFile Manager DeleteFile Manager ExecuteFile Manager ExecuteFile Manager SortFile Manager DescribeFile Manager DescribeFile Manager ExecuteFile Manager DrivesFile Manager DrivesFile Manager DescribeFile Manager TreeFile Manager TreeFile Manager DrivesFile Manager EditFile Manager EditFile Manager TreeFile Manager ListFile Manager ListFile Manager EditFile Manager CopyFile Manager CopyFile Manager ListFile Manager MkdirFile Manager MkdirFile Manager CopyFile Manager ArchiveFile Manager ArchiveFile Manager MkdirFile Manager SelectFile Manager SelectFile Manager ArchiveFile Manager ExitFile Manager ExitFile Manager SelectLocate FilesLocate FilesFile Manager ExitArchive ManagerArchive ManagerLocate FilesArchive Manager KeysArchive Manager KeysArchive ManagerArchive Manager SelectArchive Manager SelectArchive Manager KeysArchive Manager ExtractArchive Manager ExtractArchive Manager SelectArchive Manager DeleteArchive Manager DeleteArchive Manager ExtractPacket ManagerPacket ManagerArchive Manager DeletePacket Manager HeaderPacket ManagerPacket Manager ExportPacket Manager ExportPacket Manager HeaderPacket Manager DeletePacket Manager DeletePacket Manager ExportPacket Manager SplitPacket Manager SplitPacket Manager DeletePacked Message ViewPacked Message ViewPacket Manager SplitMessage ViewMessage ViewPacked Message ViewMessage ExportMessage ExportMessage_ViewPath/File SelectionPath/File SelectionPath/File Selection TreePath/File Selection TreePath/File Selection┌öÄ*	*UNREGISTERED Shareware Evaluation Version                      
           InspectA Version 1.00
              is a product of
   David L Nugent & Unique Computing Pty Ltd
             Copyright (c) 1992
                         

 This help system is arranged in a series of pages,  with a fast
 access index by topic.  When you invoke HELP!  by using F1, the
 help system is first searched  for information relating to your
 current operation and will display it when found.    From  that
 point, you can navigate forward and backwards by page using the
 keys  on  the  cursor  pad.
 
 To search for a particular topic  area,  press F1 again for the
 help system index.   This displays  a  complete  list  of  help
 topics  in which you can use the cursor keys to randomly access
 the help system database.    Press  ENTER to view any displayed
 topic.   Any single topic may occupy several help  pages,   and
 selecting a help topic will go to the first page.

 The top or bottom of  the  display may include [PgUp] or [PgDn]
 prompts which indicate either the continuation of  the  current
 topic on the previous/next pages, or a change of topic and what
 its title is.

 This is InspectA's File Management screen. Files in the current
 directory are presented in a list and may easily be manipulated
 or viewed directly from here.

 Your current view  may be restricted  to just  the file details
 on one panel to the left with the disk/server statistics on the
 right,  or you can display file descriptions  on a larger panel
 of use the entire screen.  ^Enter cycles the current view mode.

 The bottom line on the screen provides a list  of commonly used
 functions. Most of these (copy, move, delete) work on all files
 which are currently marked in the files list -  or, if none are
 marked, the current file only.  You can toggle the current file
 mark using SPACE,  or mark and move at the same time by holding
 down the Shift key  and using the cursor keys to travel  in the
 direction you wish to go.  Global mark/unmark is accessible via
 the F2 key.

 Each file is displayed showing its  attributes,  size and date,
 type information,  if known,  and an optional description.  The
 general format of each line in the list is:
  ╓───────────────────────────────────────────────────────────╖
  ║ 15460 14-Dec-91 12:43 TXT h readme.inf    Readme file     ║
  ║                                                    ║
  ║  File    │  ┌─────┘    │  │   │               │           ║
  ║  Size    Last       File  │   File Name    Description    ║
  ║         Updated     Type  │                               ║
  ║                          Special attributes:              ║
  ║  (v=volid s=system h=hidden r=read-only ∙=archive =dir)  ║
  ╙───────────────────────────────────────────────────────────╜
 The file size, date and time are the same as that shown  by the
 DIR command from the DOS prompt. The time may not be present in
 some view modes, depending on the width of your screen.

 The file type will show " ? " if it is yet to be determined, or
 is unknown.

 File descriptions are shown in either of the "larger" available
 view modes,  and only  if there is a valid description  file in
 the current directory.   The  actual name of  description files
 is determined by your setup, but the default is to use the 4DOS
 "descript.ion" file.

 If your setup  defines description files,  you can maintain the
 descriptions using the Insert key  (which modifies the existing
 comment or creates a new one) or by editing the file containing
 the description file directly using the "edit" function.

 Here's a list of  functions  and their corresponding keys which
 are available from  the  File  Manager.    "Control"  keys  are
 preceded by a carat symbol (^) prior the key, "Shift" keys by a
 hash  (#)  and "Alt" keys by '@'.   This means that you my hold
 down the Control (Ctrl),  Shift or  Alt key while you press the
 corresponding key.

 ■ Function Keys ──────────────────────────────────────────────┐

 F1      Accesses the on-line help system.
 F2      Toggles the global file marker; if all files are marked
         (marked  files  are  highlighted  and  a  square  block
         appears to the left of the file name),   they  are  all
         unmarked, else all files are marked.
 F3      Views the current file in list text/binary mode.

 F4      Invokes the editor with the  currently selected file as
         the file to edit.
 F5      Copy the current file, or all marked files.
 F6      Moves or renames the current file, or all marked files.
         Depending on the destination path  or  file  specified,
         this  will either move the files with the same names to
         a different place  on  the  same  or  another disk,  or
         rename the files.
         Use of that "wild cards" ('?' and '*') in file copy and
         rename  is  also  supported  (ie.   marked files can be
         renamed to *.cxx,  if  that is specified).
 F7      Creates a new directory.
 F8      Change the default sort order of the files list.
 F9      Logs a selected drive's directory tree,  and presents a
         graphical view of its directory structure.

 F10     Execute the  current file (if it is an executable),  or
         prompt for the program to execute with the current file
         as a command line argument.
 ESC     Exit InspectA, after restoring the original directory.

 ■ Miscellaneous ──────────────────────────────────────────────┐

 @Q      Exit InspectA, but maintain the directory  as currently
         displayed.
 Insert  Edit/create a file description  for the current file or
         directory.
 Del     Erase current or marked files.
 #Del    Erase current  or marked files  but  do not delete  the
         description of the file.
 ^Enter  Modify the size of the file display panel.
 #Enter  View the "dos" screen.

 ■ Mark/Unmark keys ───────────────────────────────────────────┐

 SPACE   Toggles the file mark for the current file.
 #Up     Mark file and move up.
 #Down   Mark file and move down.
 #PgUp   Mark files up one screenful.
 #PgDn   Mark files down one screenful.
 #Home   Mark all files from current to top of the list.
 #End    Mark all files from current to end of the list.

 ■ Change Directory ───────────────────────────────────────────┐

 ^PgUp   Change to parent directory.
 ^PgDn   Step into the currently highlighted directory.
 Enter   When on a directory entry  in the files list,  pressing
         ENTER causes the highlighted directory to be entered.

 ■ Utility Functions ──────────────────────────────────────────┐

 ^R      Rescan the current directory;  useful in networking and
         multitasking environments to  reread  the  disk when it
         has been changed from another task or workstation.
 ^S      Examines  all  files  in  the  current   directory   to
         determine the file type.
 ^E      Brings  up  the "Exec" (F10) prompt with the previously
         executed command, if any.
 ^F      Scans a  directory  and  all  subdirectories  for files
         matching a given file specification.  Used for wildcard
         searching.
 ^D      Select  a different drive to examine.
 @A      Add marked files to a compressed archive.

 These keys work globally throughout InspectA at all prompts and
 when selecting from lists.

 F1      Enter the on-line help system.
 @Z      Invokes a command shell,  optionally swapping  InspectA
         out of core memory to disk, EMS or XMS.
 @-      Display memory usage statistics.
 @X      Exit function/InspectA immediately.

 Confirm that you wish to delete the current or all marked files
 by answering YES to delete, or NO to abort.

 This  menu  selects the sorting criteria for files presented in
 the Files Manager. The following options are available:
  ┌
  │ ■ Unsorted  Sorts by the order in which files appear  on the
  │             physical disk (or apparently so,  in the case of
  │             some networks). *
  │ ■ Filename  Sort by name of the file.
  │ ■ Extension Sort by the  file extension.  Anything after the
  │             '.' in a filename is its  extension.
  │ ■ fileSize  Sorts by the size of files.
  │ ■ Date/time Sorts by the last update date/time.
  │ ■ fileType  Sorts by the file type. Use ^S to scan all files
  │             to attempt to determine their types.
  │ ■ Lexical   Sorts (effectively) by length of filename,  then
  │             alphabetically by file, useful for numeric names
  └
 *  Even under the 'Unsorted' option,  directories are placed at
    the top of the list.

 This allows the execution of external  programs  and  functions
 directly  from  the  File Manager.   If the current highlighted
 file is an executable (.EXE,  .COM, .BAT), InspectA prompts for
 command line arguments.   If not,   it assumes that you wish to
 use the filename as a command line argument.  If you don't wish
 to use the filename, clear the entry field using ^Y.

 This and most  other  line  prompts  provides  a  command  line
 history.    You can scroll back to previous commands entered at
 this same prompt using  the  UP  key,   or forward (if you have
 already scrolled backwards) using DOWN.

 On hitting ENTER,  the original DOS screen is restored and  the
 command  is  executed.    On returning to InspectA,  the status
 (known also as the ERRORLEVEL) of the program is displayed.  To
 clear the status  display  and  view  the entire screen,  press
 ^ENTER.  To return to the file manager, press any key.

 File descriptions from a descriptions  file are  displayed when
 in either of the "larger" view modes.   To edit the description
 for a file, move to it in the Files Manager and press INSERT.

 By default,  the existing description, if any, is displayed for
 editing.  This may be altered or deleted (using ^Y) as desired.
 Deleting the description for a  file will also remove reference
 to that file from the description file.   Adding a  description
 to  any  file in a directory which contains no description file
 will create one.

 This  prompt also  contains  command  line history  which makes
 it easy to copy descriptions from one entry to another.  "Edit"
 an existing description (to copy  from) and press ENTER.   Move
 to the file to which the description is to be copied  and  edit
 its  description, and  use  UP  to  scroll  back  to  the entry
 previously copied.

 Updates  to  file  descriptions  are  not   written   to   disk
 immediately,  but are cached.   The description file is updated
 only  when  the  directory  is  rescanned  (you  can explicitly
 request this by using ^R from the File Manager, but it may also
 be done automatically  after  carrying  out certain operations,
 such as editing files or  running  an  external  program),   or
 whenever you move out of the directory or exit InspectA.

 This is a list of  all  available  drives on your system,  both
 'logical' (SUBSTed, ASSIGNed and network) and 'physical'.   The
 current directory for all non-removable (not floppy) drives  is
 also displayed against the drive letter.

 Highlight a drive from the list  either  by  using  the  cursor
 keys,  or moving to the entry for a drive directory by pressing
 the  letter  corresponding  to  the  drive.   Select by hitting
 ENTER.  Abort (and retain your current drive) by using ESC.

 Some device  drivers  and  networks  cause  "phantom" drives to
 appear on this list; it will appear to the system as an invalid
 drive,  but attempts to determine the  current  directory  will
 fail.    These  drives  wiil show an "?ERROR" where the current
 directory normally will appear.   If  one  of these drives or a
 floppy drive without a diskette  is  selected,   InspectA  will
 refuse to change to it.

 This  is  a  graphical tree of the drive's directory structure.
 You can navigate around the tree  using the cursor keys to step
 from one entry to another.  The full path name of the currently
 highlighted directory is displayed at the bottom of the window.

 From this directory tree you can also add,  rename  and  remove
 directories.
 
   ■ ADD  a  directory  below the currently highlighted level by
     pressing Insert and entering the name.

   ■ RENAME the currently  highlighted  directory by pressing F2
     and entering its  new name.  This may result in an error on
     some types of network drives, or if the directory is in use
     by another workstation or task.

   ■ DELETE  a  directory  by  highlighting it and pressing Del.
     This will fail  if  the  directory  contains valid entries,
     such as files and sub-directories,  if the directory is  in
     use by another workstation or task,  or if the directory is
     your "current" directory.  (See below if you wish to change
     your current directory from this list).

 You can modify the size  of  the directory window using ^Enter.
 This allows displaying of the files  panel  and  the  directory
 tree at the same time.   You can make the currently highlighted
 directory current at any time by pressing SPACE.   This updates
 the files list but remains in the directory tree.   Updating of
 the  files  list  can be made automatic by toggling "follow-me"
 mode with F10 - as you walk around the tree the files list will
 be updated as  you  move  to  each  new directory.   This does,
 however,  slow things down a little,  especially  if  you  have
 directories containing many files.

 InspectA can optionally maintain a directory image  in the root
 directory of any drive that it scans.    This  helps  speed  up
 operations  at  the directory level significantly and is useful
 on drives where the  directory  structure  tends to change very
 little if at all (ie.   in most cases).   If the directory tree
 is invoked at any point and the current directory is found  not
 to be contained in the image file,  then InspectA will consider
 it  to  be  out  of  date  and force the drive to be completely
 rescanned.

 You can force InspectA to completely rescan a drive by using ^R
 when using the directory tree graph.   This  adds  any  missing
 directories  to  the  disk  image  and  deletes any removes any
 obsolete directories.

 If you always make  or  remove  directories within InspectA and
 opt to use on-disk directory images, InspectA will maintain the
 images and keep them accurate.

 Pressing F4 from the File Manager causes the editor (defined in
 the "EDITOR" environment variable,  or Q.EXE if not defined) to
 be executed with the highighted  file or directory name as  its
 command line argument.

 Pressing F3 from the File Manager causes the file list  program
 (defined  in  the "PAGER" environment variable,  or LIST.COM if
 not defined)  to  be  executed  with  the  highlighted  file or
 directory name as its command line argument.

                                     {See Also Path/File Select}
 This prompts for a path or file to copy,  move or rename files.
 If  a  destination directory is given,  the files are copied or
 moved as appropriate.  If the original file is a directory, you
 can only nominate a name to rename it to (no path component).

 You can also copy and move with wildcards, in much the same way
 as COPY works at  the  DOS  command  prompt.   You can also use
 wildcards ('?' and '*') when copying or moving  to  a different
 directory  so that you can rename files during the copy or move
 operation.

 During the copy or move operation,  any descriptions applicable
 to the file will be moved or copied with the target file.

 Moving or copying one or  more  MARKED files to a single target
 file (which already exists) is considered an  error.    If  any
 files are marked on the files list the expected destination can
 only  be a directory,  and if it does not exist,  InspectA will
 prompt to see if you wish to create it.   Selecting YES to this
 prompt  will  create the target directory "on-the-fly" and copy
 or move the selected files into it.

 To prevent accidentally  overwriting  existing files,  InspectA
 will prompt whenever a destination file from  a  copy  or  move
 operation is found to already exist.   It will prompt to ensure
 that this is intended.

 In addition,  if the target file is marked with the "read-only"
 attribute,  InspectA will prompt a second time, again to ensure
 that  this  is  the intention.   Read-only files are considered
 "protected",   but  InspectA  nevertheless  allows  this  to be
 overridden after confirmation.

 In response, select:
    ■ YES   To overwrite the target file
    ■ NO    To prevent overwrite
    ■ ALL   To overwrite the current and all remaining target
            files (don't prompt again).
    ■ ESC   Aborts the entire operation.

 There are a number of reasons why  a  copy  or  move  operation
 might fail:

  ■  Insufficient  disk  space on the target device (drive) in a
     copy operation or move from one device to another
  ■  Hardware  related failure  (sometimes occurs, especially on
     networks) which triggered a critical error during the move
  ■  Network directory or file permissions problem (not owner of
     the resource copied to,  or insufficient privilege to  open
     or read the original file
  ■  The original file  no  longer exists due to another process
     executed from another task or workstation
  ■  Attempts to copy over a directory with a file


                                     {See Also Path/File Select}
 Enter the name of a directory to create.

 If you are using diskmaps (see the manual on the  '-m'  command
 line  switch),   the directory structure in the disk image file
 will be automatically updated.

                                     {See Also Path/File Select}
 This allows  you  to  use  one  of  the  available  compression
 programs to archive one or more marked files.  If you select an
 existing archive to add  to,   its   type will be automatically
 determined and the correct archive program selected.

                  ╒═════╤═══════════════════════════╤═════════╕
                  │ Type│ Description               │ Source  │
                  ╞═════╪═══════════════════════════╪═════════╡
                  │ AR5 │ ARC version 5.x           │ SEA     │
 If  the  archive │ PKA │ PKARC/PKPAK               │ PKWARE  │
 selected    does │ PAK │ PAK 2.5x                  │ NoGate  │
 not  exist,  you │ AR6 │ ARC version 6.x           │ SEA     │
 will   be  asked │ AR7 │ ARC version 7             │ SEA     │
 to  select   the │ ZIP │ PKZIP                     │ PKWARE  │
 compression      │ LZH │ LHARC 1.x                 │ Yoshi   │
 software to  use │ LHA │ LHA 2.x                   │ Yoshi   │
 from   one    of │ ZOO │ ZOO 2.0                   │ Dhesi   │
 those  available │ ZOH │ ZOO 2.1+ high compression │ Dhesi   │
 from this list.  │ ARJ │ ARJ                       │ Jung    │
                  │ HPK │ HPACK pre-1.0             │ Gutmann │
                  ╘═════╧═══════════════════════════╧═════════╛
                          * REGISTERED/COMMERCIAL FEATURE ONLY *

 Whenever a file  is  selected  by  pressing  ENTER on the Files
 Manager and that file matches one of  the  file  specifications
 specified  in  InspectA's  .INI  file,   the specified external
 program is run,   usually  with  the  selected  filename on the
 command line.  This provides "hooks" so that custom editors and
 viewers can be invoked for particular types of files.

 The default action on selecting a file from the files  list  is
 to  invoke either the specialised view mode if the file type is
 known, or to use the external list program to view the file.

 InspectA has several internal viewing facilities for known file
 types;  and file types are determined independant from the file
 name itself:

  ■ MSG      If  the  file  is a  recognised  "FTS-0001"  format
             message  InspectA  will invoke message viewing mode
             and  display  the  message  contents,   header  and
             addressing  details.   Sometimes InspectA will fail
             to recognise *.MSG files  which have been corrupted
             in some way or are not valid for some other reason,
             the most common of which is a corrupted or  missing
             ASCII  date in the header since a decypherable date
             is used as part of the "signature" of *.MSG files.

  ■ PKT      FidoNet   FTS-0001  "type-2"   packet   files   are
             detected and the specialised  viewer provides a way
             of  listing  its  contents,    reading   individual
             constituent  messages,   diagnostics in the case of
             corrupt  packets,   reading  header  and addressing
             information,  with editing and splitting  functions
             useful for troubleshooting.

  ■ Archive  Several popular compressed archive formats are used
             and  recognised  by  InspectA  (see  "File  Manager
             Archive" for a complete list).  InspectA is able to
             read  and  present  a  list of their contents,  and
             allows  extracting,   viewing  and  deletion  of of
             individual component files

 The exit  prompts  ensures  that  you  don't  exit  InspectA by
 pressing ESC too many  times  to  quit  from  other  functions.
 Enter  "YES"  (the  default)  to  quit  to  DOS and restore the
 original directory and DOS screen, or NO to abort and return to
 InspectA's File Manager.

 This section provides the facility to locate files by  name  or
 partial  name  by  searching  a  drive  or  partial  drive (all
 directories below a given point).

 At the "Locate" prompt,  enter the filename - which may include
 the  wildcard  characters  '?  and  '*'.   The following prompt
 requests a directory name to search.   The directory name given
 and all subdirectories below this  point are searched.   If you
 wish to search an entire drive,  nominate its  "root directory"
 (The drive letter followed by a colon and backslash).

 As the drive is searched, files matching the file specification
 are  displayed.    You  can  terminate  the  search at any time
 before the seach is complete by pressing ESC.

 Once the  search  is  completed  or  has  been terminated,  the
 list of matching files is displayed.

 At this point,  you can elect to change  to  the  directory  in
 which any of the located files resides or abort by using ESC.

 The Archive Manager provides the ability to handle compressed
 archives made by the following software:
 ╒═══════╤══════╤═══════════════════════════════════════════════╕
 │ Type  │ Vers │ Notes                                         │
 ╞═══════╪══════╪═══════════════════════════════════════════════╡
 │ ARC   │ 7.12 │ Full subdirectory support and 'Trimming'      │
 │ PKARC │ 3.61 │ ARC 5.x + 'Squishing' compression             │
 │ PAK   │ 2.51 │ ARC 5.x + 'Crushing' and 'Distilling'         │
 │ ZIP   │ 2.00 │ Includes support for 'Deflating'              │
 │ LHA   │ 2.13 │ Includes LHARC 1.x + LHA 2.x                  │
 │ ZOO   │ 2.10 │ Low and high compression                      │
 │ ARJ   │ 2.30 │ All versions of ARC up to 2.30                │
 │ HPACK │ 0.75 │ Experimental compressor, may change for v1.0  │
 ╘═══════╧══════╧═══════════════════════════════════════════════╛

 When a known archive is selected for viewing, InspectA reads it
 and presents a  list  of  the  archive's  contents.   This list
 includes:

  √ File/Path   If the screen width  is 80 columns or less,  the
                'root'  filename  is presented.   If a directory
                name applies to the  entry,  it will be followed
                by and asterisk (*).
                If  the  screen  width is > 80 colums,  the full
                path and file name is displayed.

  √ Comp Size   Shows the size  of the file  as it exists within
                the archive (ie. compressed).

  √ Orig Size   Shows  the  original  uncompressed  size  of the
                member file.

  √ Red%        Shows the percentage by which  the file has been
                reduced.

  √ Method      Indicates  the type  of compression  used.  This
                tends to be specific to the archive  type,   and
                usually  colloquial  terms  for  the compression
                method  rather   than   having   any   technical
                significance.    "Storage"  universally means no
                compression.

  √ Date/Time   Original file's date/time stamp.
 If an archive is found to be empty,  this may indicate  that it
 is corrupt.   If such  an  archive  is encountered no managment
 functions are possible - InspectA will simply prompt for a key.

 In  addition to the usual cursor key handling for scrolling and
 inspecting the files list,  additional functions available from
 within the archive manager are:

  ■ Mark/Unmark ───────────────────────────────────────────────┐

 SPACE   Mark/unmarks the current file.
 #Up     Toggle mark on current file and move up one file.
 #Down   Toggle mark on current file and move down one file.
 F2      Mark or unmark all files.

  ■ Archive Management Functions ──────────────────────────────┐

 Del     Delete selected files (or current file).
 @E      Extract  selected files,  or if none  are selected  the
         current file, to a nominated directory.
 @S      Sort files in the current archive:
  ┌
  │ ■ Unsorted  Sorts by the order in which files appear  in the
  │             physical archive.
  │ ■ Pathname  Sorts by full pathname - files  are first sorted
  │             into directory order, then by filename.
  │ ■ Filename  Sorts by filename across directories.
  │ ■ Extension Sorts by file extension, then by filename.
  │ ■ fileSize  Sorts by size of file.
  │ ■ Date/time Sorts by date/time stamp on the file.
  └

 Selecting a file from  an  archive  list  is almost the same as
 selecting a file from the Files Manager.  Depending on the file
 type, InspectA will invoke one of its  view functions; archives
 within archives are  viewed  in  archive  mode,  *.MSG and FTSC
 type-2 packets in message and packet view modes,   and  general
 files with the external list utility.

                                     {See Also Path/File Select}
 This option allows individual or groups of (marked) files to be
 easily extracted.  Nominate or locate a path to extract to.  If
 the directory to extract to does not exist,  it will be created
 after confirmation.

 Files are extracted one at a time,  multiple at once (up to the
 maximum  command line  length)  or  all  at  once  by  use of a
 response file depending on what the archive software supports.

                                     {See Also Path/File Select}
 This option allows individual or groups of (marked) files to be
 deleted from the archive.   To ensure that accidental  deletion
 of files does not occur, InspectA prompts the user to make sure
 of what is intended.

 Files  are  deleted one at a time,  multiple at once (up to the
 maximum  command line  length)  or  all  at  once  by  use of a
 response file depending on what the archive software supports.

 InspectA's ability to handle FidoNet "type-2" packets is one of
 its  most powerful and unique features.  This is useful only to
 operators of FidoNet compatible  mail systems which handle this
 type of file, which consists of a packet "header" (or envelope)
 followed by zero or more individual messages.

 To manipulate packets,  InspectA first  scans the contents of a
 mail packet and  creates  an  in-memory  index.    Handling  of
 packets  up  to  5  megabytes in size presents no problem other
 than with processing speed,  and  for larger packets than this,
 InspectA includes a  unique  interactive  "split"  function  to
 break apart packets into smaller packets.

 InspectA begins examining a packet by reading  its  header  and
 scanning  individual messages as it creates its  index,  during
 which it displays a progress indicator.   This scanning process
 can be aborted  at  any  time  by  pressing ESC.   However,  if
 scanning of a packet is not run to completion,  no manipulation
 of its contents - except for "splitting" - are available.

 Once the scan has finished or been terminated,  a list  of  the
 packets constituent messages is displayed, showing:

  ■ Message List ──────────────────────────────────────────────┐

 √ Inf      Diagnostic  information -  This relates to the state
            of each individual  message,  whether some detection
            or anomoly has been discovered.   If this  field  is
            blank, it indicates (probable) "perfect health".  If
            not blank, one or more of the following messages may
            appear, with their meanings as follows:
       ∙ D  Malformed or invalid message date.
       ∙ L  One or more  of the variable length header fields is
            longer than maximum.
       ∙ I  Invalid (non-ascii) data detected in header data.
       ∙ G  Message body contained one or more NULs.
            Malformed  dates  are  (unfortunately) not uncommon.
            Other  flags  are  usually  an  indication  of  more
            serious packet orruption.

 √ Date     If the message date  can  be read,  it is  displayed
            here, or replaced by "*Invalid*" if not. InspectA is
            able  to  read  and  interpret  many  forms  of non-
            standard date strings,  even though they are flagged
            as such.

 √ From     Shows the name of the author of the message.

 √ To       Shows the name of the person to whom  the message is
            addressed.

 √ Subject  Shows the message subject.
 √ Area Tag If echomail area tags are enabled (see ^A below) the
            area tag found in the message is displayed,  else it
            is assumed to be netmail.

 Functions available from the Packet Manager are:

  ■ Mark/Unmark ───────────────────────────────────────────────┐

 SPACE   Mark/unmarks the current message.
 #Up     Toggle mark on current message and move up one.
 #Down   Toggle mark on current message and move down one.
 #PgUp   Toggle mark on all message up one screen.
 #PgDn   Toggle mark on all message down one screen.
 #Home   Toggle mark on all messages to beginning of packet.
 #End    Toggle mark on all messages to end of packet.
 F2      Mark or unmark all messages.

  ■ Packet Functions ──────────────────────────────────────────┐

 ^A      Toggle area/subject display - changes from showing each
         message subject  in the packet  to displaying  the echo
         area tag, if any, or "NETMAIL".

 @S      Sort messages within packet.
  ┌
  │ ■ Unsorted  Sorts by the order  in which messages appear  in
  │             the physical packet.
  │ ■ Area tag  Sorts alphabetically according to the applicable
  │             area tag.
  │ ■ msg Date  Sorts by individual message date.
  │ ■ msg siZe  Sorts messages, smallest to largest.
  │ ■ To        Sorts alphabetically by the addressee name.
  │ ■ From      Sorts alphabetically by the author name.
  │ ■ Orig addr Sorts by the originating net/node address.
  │ ■ Dest addr Sorts by the destination net/node address.
  │ ■ Date/time Sorts by date/time stamp on the file.
  │ ■ Subject   Sorts alphabetically by message subject.
  └
    Resorting a packet in memory does not change  it  physically
    in any way, and because sorting is useful for retrieval, the
    operation  does  does  not  automatically  set  the  "packet
    changed" flag (see below).   If  the packet is rebuilt after
    sorting, this will save the messages in the sorted order.

 @C      Sets or resets the "packet changed" status.   This  can
         only affect packets which have been fully scanned,  and
         will not work if you terminated the scan with ESC.   If
         a  packet  is considered changed you have the option of
         "rebuilding"  it  dynamically,   thus  eliminating  any
         messages which were deleted,   and correcting any minor
         format inconsistencies.
 @H      Display packet header information.
 @M      Export marked messages to  FTS-0001 *.MSG format.  Most
         FidoNet editors know how to read this type of file, and
         it is by far the most common format.
 ^S      Split current packet into multiple parts.

 On closing the packet by pressing ESC from this list,  InspectA
 checks the "packet changed" indicator and if it is set  prompts
 to see if you wish to repack it with the changes made.  If this
 response  is  confirmed,   the packet is rewritten - and if the
 packet was  originally  extracted  from  a  mail  archive,  the
 changed packet will replace the old one inside the archive.

 Three windows provide information about the packet header.  Use
 ENTER to cycle between them, and ESC to quit.

  ■ Packet Header       Displays details  of the  packet header,
                        including the source/destination  of the
                        packet and information about the product
                        it was made by.

  ■ Binary Dump         Shows the  packet header block  in "raw"
                        binary   format    for   more   detailed
                        examination.

  ■ Diagnostic          Shows status against a series  of status
                        checks made against the message overall,
                        being:

          √ Pkt Status  Shows the overall  status of  the packet
                        packet itself.  YES in this  entry means
                        that no serious errors were encountered.

          √ Invalid Hdr Indicates that information in the packet
                        header  appears  seriously  corrupted in
                        some way (it doubtful that you will ever
                        see this,  since  InspectA will normally
                        not auto-recognise a  file  as  being  a
                        packet if this status is set,  so packet
                        view  mode  would  not be invoked in the
                        first place).
          √ Packet Date Format of the packet data  is incorrect.
                        This  test  is not  applied to  type 2.2
                        packets (which don't contain a date).
          √ Short Pkt   The packet is not  terminated correctly.
                        This can indicate either that the packet
                        has been  truncated  (the  last  message
                        incomplete    and   perhaps   additional
                        messages missing) or  there is a problem
                        with the software used to  generate  the
                        packet.

          √ Suspect Hdr The  header appears  to be correct,  but
                        information in one or more fields is out
                        of range.
          √ Trash Data  One or more messages  within  the packet
                        has been found corrupt.

 Note that some of these problems can be automatically corrected
 by InspectA by forcing  the  "packet changed" on and rebuilding
 the packet.   In the case of badly corrupted messages,  the job
 may not be pefect,  but it will usually be  enough  to  correct
 most  packet  header  anomolies  and  almost all message header
 problems.   If messages are very  garbled,  it will probably be
 better to export these to *.MSG format and remove them from the
 packet.

 The @M key from  the  packed  message  list  allows one or more
 messages to be unpacked into FTS-0001 *.MSG format.    This  is
 the  one common format handled by most FidoNet message handlers
 and  editors  and  preserves  most  of  the  attributes  of the
 original  packed  message  (both  are  similar  in  design  and
 origin).   Exporting to *.MSG format requires no interpretation
 of data contained within the packed message.

 When exporting to this format, select a directory to export to.
 InspectA will automatically determine the "next message number"
 from the existing contents of  the  directory  and  will  never
 cause an existing message to be overwritten,  even in a  multi-
 tasking environment (unfortunately, some other programs are not
 so well behaved).

 Note  that  unpacking  in this fashion MAY cause zone and point
 information to be lost  from in-transit echomail messages.   In
 4D packet/addressing schemes used by most 4D  capable  echomail
 processors,   the packet header is used to determine the source
 and/or destination zone of individual messages.

 Individual messages can be deleted from  the message list using
 the Del key.   This does not affect the physical packet on disk
 until you confirm that  you  wish  to  rebuild it when exiting.
 The confirmation prompt before deleting a message appears  only
 before  deleting  the first message from any packet - deletions
 thereafter are silent.

 Deleting  one  or more messages from a packet sets the "changed
 packet" status.  You can toggle this off using @C and leave the
 packet silently without  rebuilding,   thereby aborting changes
 made.

 If you prevented InspectA from completing the initial  scan  on
 the entire packet deletions will not be allowed.

 The  packet  split function provides the ability to break apart
 very large  packets  into  chunks  which  can  be  handled more
 easily,  both  by  InspectA  and  other  software.    The  only
 limitation  on  the size of the source packet is available disk
 space.

 You are prompted for a directory  name to write the new packets
 to, and the maximum number of messages per packet.

 The resulting packets all have unique names,  but  inherit  the
 same  header  as  the original packet as well as adopt the same
 last write date and time.   This is so that the packets will be
 tossed by an echomail processor in the same order in which they
 would have been had the packet not been split.  The packet file
 names generated  are  guaranteed  to  be  assigned in ascending
 order.

 Individual messages within packets can  be examined and read by
 selecting one from the packet manager with the ENTER key.

 The message details  are  formated  and  displayed,   with  the
 message  header  details;   author  &  addressee details,  date
 written,   origin  and  destination  net/node  and  possibly an
 echomail area tag.   Note that  only  "raw"  and  uninterpreted
 header   information  is  displayed,   with  no  interpretation
 whatsoever (as would normally be required for a message editing
 interface, for example).  The display is intended for debugging
 purposes,  so control lines  are  not  read  and applied to the
 address in any way.   Therefore all header addresses  show  net
 and node number only.

 Beneath the dividing line,   the  message  body  is  displayed.
 "Hidden"  or  control  information  (any  line  in  the message
 starting with ^a,  SOH) can  be  suppressed or displayed at the
 viewer's option, and by default are switched on.  Quotes within
 the  message  body may be highlighted,  according to the colour
 configuration.

 Functions  available  from  within  Packed Message View  are as
 follows:

  ■ View Functions ────────────────────────────────────────────┐

 SPACE   Toggle the mark on this message. When pressed, the mark
         shown on the  dividing  line  should changed state from
         being invisible to visible or vice versa.  This has the
         same affect as SPACE on the message listing.

 Cursor  Move the cursor keys  Left and Right  to move  from one
 Keys    message to the next.  Home goes to the first message in
         the packet, and End to the last. The Up, Down, PgUp and
         PgDn  keys  shift  the  view  of  the message currently
         displayed;  ^PgUp to the top and ^PgDn to the bottom of
         the text.

 DELETE  Removes the current message  only from the packet.   If
         the  packet  has  not yet been modified,  InspectA will
         first ask for confirmation.    If the entire packet had
         not yet been fully scanned (ie.    the  usual  scan  on
         opening  the  packet  had been aborted),  InspectA will
         deny any modification.   If the  message is the last in
         the packet,  control will return automatically  to  the
         message list after the message is deleted.

         Note that changes do  not  take immediate effect in the
         physical packet until you  elect  to  rebuild  it  when
         closing the packet.

                                     {See Also Path/File Select}
 @W      Writes a text image  of the current message  to a named
         file or device.   If the file exists,  you can elect to
         either overwrite or append the file.

 @M      Exports the current message  to FTS-0001 *.MSG  format.
         Select a destination  directory  -  message numbers are
         allocated automatically from the  next  message  number
         available in the given directory.

 ^K      Toggle "hidden" (control) text view.

 ^S      Toggle SEEN-BY text view.

 F9, @L
 or ESC  Exits  message  view  mode  and  returns  to the packet
         message list.

 This is the FidoNet FTS-0001 message view mode.  The screen  is
 split into two sections: above the dividing line is the message
 header information,  which  includes  the original message date
 and time,  author and recipient,  origin and  destination  node
 addresses.   Below the line is the message body, which includes
 "hidden"  control  lines  (these  may  be toggled on and off by
 using ^K).

 You can view more of the message by using the cursor keys - Up,
 Down,  PgUp,  PgDn, ^PgUp and ^PgDn to display various parts of
 the message if it extends beyond a single screen.

 Press ESC to leave view mode and return to the Files Manager.

                                     {See Also Path/File Select}
 From within Message View,  @W  allows exporting of a message to
 text format.   Enter the destination device or file name  -  if
 the  nominated file exists you will be given the opportunity to
 overwrite or append the file.

 This prompt provides a prompt to select a "destination" path or
 file. This may be achieved in one of several ways:

   ■ Enter the destination path or file directly at the prompt,

   ■ Use previous entries by scrolling the history using the Up,
     Down, PgUp and PgDn cursor keys,

   ■ If selecting  a file  (if a directory name cannot be valid)
     enter  a directory name and press enter to invoke a list of
     files in that directory,

   ■ Press F6 after optionally entering a drive/path  from which
     to start.  This also invokes file seach mode and presents a
     list of files in the selected directory,

   ■ Press F9 after  optionally entering a drive/path from which
     to start.   A graphical tree of the  drive's  structure  is
     presented  -  select  a  destination  directory  using F10.
     Other directory maintenance operations may also be  carried
     out in this mode (see Path/File Selection Tree).

 These  may  be  used  in combination to locate any directory of
 file on your system.

 Using the files list [F6], directories may be changed by moving
 to a directory entry  and  selecting  it  with Enter,  or using
 ^PgUp and ^PgDn to move up and  down  directories  (as  in  the
 Files  Manager).   Switch drives by using ^D (which invokes the
 drive selection window), or press F9 for the directory tree.

 This  is  a  graphical tree of the drive's directory structure.
 You can navigate around the tree  using the cursor keys to step
 from one entry to another.  The full path name of the currently
 highlighted directory is displayed at the bottom of the window.

 From this directory tree you can also add,  rename  and  remove
 directories.
 
   ■ ADD  a  directory  below the currently highlighted level by
     pressing Insert and entering the name.

   ■ RENAME the currently  highlighted  directory by pressing F2
     and entering its  new name.  This may result in an error on
     some types of network drives, or if the directory is in use
     by another workstation or task.

   ■ DELETE  a  directory  by  highlighting it and pressing Del.
     This will fail  if  the  directory  contains valid entries,
     such as files and sub-directories,  if the directory is  in
     use by another workstation or task,  or if the directory is
     your "current" directory.  (See below if you wish to change
     your current directory from this list).

