home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / apps / database / stcat52 / stdcat52.doc < prev    next >
Text File  |  1993-03-06  |  63KB  |  1,710 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                           STDCAT V5.2b User's Guide
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.          Copyright (c) 1988, 1989, 1990, 1991, 1992 By Bob Silliker
  24.                              All Rights Reserved
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                THIS SOFTWARE IS BEING DISTRIBUTED AS SHAREWARE
  31.                 IF YOU USE THIS PROGRAM ON A CONTINUING BASIS
  32.                     PLEASE REGISTER BY SENDING $15.00 TO
  33.  
  34.                              Bob Silliker 
  35.                              2828 Woodland Court 
  36.                              Langley, B.C.  
  37.                              Canada V2Y 1G1 
  38.                              (604) 534-0676 
  39.  
  40.                       email: bobs@wimsey.bc.ca 
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57. This manual was generated using PROFF V1.0 by Ozan S. Yigit & Steven Tress.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64. V5.2b                        STDCAT User's Guide                            1
  65.  
  66.  
  67. Introduction
  68.  
  69.     Stdcat  is  a  program  that  can be used to catalogue diskettes and hard
  70.     disk  partitions.   It is a GEM window application using four (4) windows
  71.     to  display  various  parts of a catalogue. A catalogue is organized into
  72.     sections  with  each  section containing a number of disks, disk contains
  73.     paths  (folders),  and  paths containing files.  Each section, disk, path
  74.     and file can, optionally, have a comment associated with it.  
  75.  
  76.     The  program  has  three (3) ways to view the information in a catalogue.
  77.     All  views support four (4) windows, although, it is not practical to use
  78.     all four windows in each view.  
  79.  
  80.     In  the  first  view,  which  is very much like the original program, the
  81.     windows  are  setup  dependantly  with  each window having it's own type.
  82.     The   window   names  are  SECTION,  DISK,  PATH  and  FILE.   To  access
  83.     information  in  the  catalogue  the user selects the SECTION of interest
  84.     which  will  cause  the disk window to display the disks in that section.
  85.     The user can then select a disk, path and file.  
  86.  
  87.     The  second  view  organizes  the  windows hierarchically.  That is, each
  88.     window  starts  with  SECTIONS.   The  user double clicks on a section of
  89.     interest  to  descend  to  the  disk  level.   The  user can then descend
  90.     further  into  paths  and  files  using the same method.  Each window can
  91.     look  at a different (or same) part of the catalogue.  The intention here
  92.     is to provide a means of comparing the contents of disks or paths.  
  93.  
  94.     In  the third view, the windows are flat with each window having it's own
  95.     type.   The window names are SECTIONS, DISK, PATH, and FILE.  Each window
  96.     displays all of it's type of information in the catalogue.  
  97.  
  98.     In  any  view the user can sort the windows, enable/disable/order fields,
  99.     and qualify (select) the information displayed in each window.  
  100.  
  101.     The  program  was  originally  written  to  suit  my  needs and my way of
  102.     organizing  diskettes.   Things have changed a lot from the first version
  103.     and  a  lot  of  people have had input into it's present form.  They know
  104.     who they are and I thank all of them for their help.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125. V5.2b                        STDCAT User's Guide                            2
  126.  
  127.  
  128. Quick Start
  129.  
  130.     I  know  that  you will not read the complete manual.  To get you started
  131.     here  is  a  simple  step  by step procedure.  If you want to convert old
  132.     catalogues  for  use  with V5.1b or V5.2b then you must read the sections
  133.     for the 'Open', 'Save' and 'Read' menu entries.  
  134.  
  135.     1) 
  136.         Run  the  program  from the desktop or your favourite shell (remember
  137.         that  some  shells  require something like 'gem stdcat50' to turn the
  138.         mouse on).  
  139.     2) 
  140.         When  the  'file  not  found' dialog is displayed just click on [OK].
  141.         This will bring up the menu and a blank screen.  
  142.     3) 
  143.         Select  the 'New' menu entry from the 'File' menu group.  This should
  144.         cause four (4) windows to be displayed.  
  145.     4) 
  146.         Select  the  'Add'  menu  entry  from  the  'Section'  menu group.  A
  147.         section dialog will appear.  
  148.     5) 
  149.         Enter  a section name (can be changed later if you want) and click on
  150.         [OK].   The  section  will be created and the dialog will dissappear.
  151.         The new section should be displayed in the SECTION window.  
  152.     6) 
  153.         Select  the 'Add' menu entry from the 'Disk' menu group.  A dialog to
  154.         add disks will appear.  
  155.     7) 
  156.         Place  the  disk  you  want to catalogue into either drive 'A' or 'B'
  157.         and  click  on  either [DRIVE A] or [Drive B].  The disk will be read
  158.         into  the  catalogue,  the dialog will close, and the contents of the
  159.         disk,  path,  and  file  windows will contain the information for the
  160.         disk.  
  161.     8) 
  162.         If  you want to enter a lot of disks at this time (before reading the
  163.         rest  of the manual) then create all of the sections you want, select
  164.         a  section  (highlight  it), select 'Add' from the 'Disk' menu group,
  165.         click  on  the [MULTI] dialog button (in the add disk dialog), if you
  166.         are  using  two  drives then click on [ALTERNATE A THEN B], place the
  167.         disk(s)  into  the drive(s) and select either [DRIVE A] or [DRIVE B].
  168.         When  the  disk has been read in, place another disk in the drive and
  169.         press  [RETURN]  or click on either [DRIVE A] or [DRIVE B].  When all
  170.         of  the  disks  for the section have been read in, click on [CANCEL].
  171.         The  disk  window  should  now contain all of the disks you have read
  172.         in.  Read the disks into the other sections using the same method.  
  173.  
  174.  
  175. New Features
  176.  
  177.     Version V5.2b of STDCAT has the following changes 
  178.  
  179.     Added: 
  180.             - 'group' field to each file entry.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186. V5.2b                        STDCAT User's Guide                            3
  187.  
  188.  
  189.             - find matches more than one pattern (eg. *.tos *.prg).  
  190.  
  191.             - qualify matches more than one pattern.  
  192.  
  193.             - qualify rejects one pattern (with a '^').  
  194.  
  195.             - repeated scrolling on window arrows and sliders.  
  196.  
  197.     Fixed: 
  198.             - 'find' path bug.  Used to only find one occurrance.  
  199.  
  200.     Changed: 
  201.             - the maximum number of files in a folder to 999.  
  202.  
  203.             - disabled 'Read' menu entry in flat view.  
  204.  
  205.  
  206.     Version V5.1b of STDCAT has the following changes 
  207.  
  208.     Added: 
  209.  
  210.             - a user defined disk number for each disk (000 to 999).  
  211.  
  212.             - local configuration to select DISK '# NAME' or 'NAME #'.  
  213.  
  214.             - saving the drive number a disk was added/updated from.  
  215.  
  216.             - selecting the saved drive number when updating disk name.  
  217.  
  218.             - the disk drive letters to the disk name dialog.  
  219.  
  220.             - a cancel button to the duplicate serial # warning.  
  221.  
  222.             - a bootable disk warning when disks are added or updated.  
  223.  
  224.     Fixed: 
  225.  
  226.             - the 'rename disk'-'trash the next disk(s) renamed' bug.  
  227.  
  228.             - the 'full window'-'default windows'-'empty slider' bug.  
  229.  
  230.             - the disk cursor to follow the last added/updated disk.  
  231.  
  232.             - the blank default setup filename after SaveAs bug.  
  233.  
  234.             - the output formatting for the dependant view.  
  235.  
  236.             - the add disk skip serial number check the default.  
  237.  
  238.  
  239.     Version  V5.0b  of  STDCAT  is  mostly  a  re-write  of  the  old  STDCAT
  240.     application.  The main changes are: 
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247. V5.2b                        STDCAT User's Guide                            4
  248.  
  249.  
  250.         Removed: 
  251.  
  252.                 - the disk number from each disk.  
  253.  
  254.                 - the old printer output format.  
  255.  
  256.  
  257.         Added: 
  258.                 - using the disk volume name to order disks.  
  259.  
  260.                 - the Flat view of the catalogue information.  
  261.  
  262.                 - the Hierarchical view of the catalogue information.  
  263.  
  264.                 - the section window.  
  265.  
  266.                 - the path window.  
  267.  
  268.                 - reading disks from Drive A, Drive B or alternate A and B.  
  269.  
  270.                 - reading hard disk partitions.  
  271.  
  272.                 - saving/restoring the setup (window sizes and positions and 
  273.                   user configured options).  
  274.  
  275.                 - qualification for each window (that is, only selecting 
  276.                   disks, paths and files that match a set of patterns on 
  277.                   the important window fields).  
  278.  
  279.                 - disabling of window fields.  
  280.  
  281.                 - several field ordering options for each window.  
  282.  
  283.                 - storing catalogue information into an ASCII file.  
  284.  
  285.                 - date format selection.  
  286.  
  287.                 - keyboard short cut key sequences for all menu operations.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308. V5.2b                        STDCAT User's Guide                            5
  309.  
  310.  
  311. Menus
  312.  
  313. ---------------------------------------------------------------------------
  314.  Catalog Section Disk    Path    File    View          Output  Misc
  315. ---------------------------------------------------------------------------
  316. |New    |Sort   |Sort   |Sort   |Sort   |Dependant    |Layout |Read Setup |
  317. |Open   |-------|-------|-------|-------|Hierarchical |Setup  |Save Setup |
  318. |Read   |Next   |Next   |Next   |Info   |Flattened    |-------|-----------|
  319. |-------|Prev   |Prev   |Prev   |Group  |-------------|Sizes  |Def Windows|*
  320. |Save   |-------|-------|-------|Comment|Field Order  |-------|Auto Newtop|
  321. |Save As|Info   |Info   |Info   |-------|Field Enable |Printer|-----------|
  322. |Close  |Name   |Name   |Comment|Find   |Field Sort   |File   |Disp Format|*
  323. |-------|Comment|Number |------- -------|Field Qualify|-------|Font Size  |
  324. |Quit   |-------|Comment|                -------------        |-----------|
  325.  -------|Add    |-------|                                     |Cat Limits |*
  326.         |-------|Add    |                                     |Cat Stats  |*
  327.         |Delete |Update |                                      -----------
  328.          -------|-------|
  329.                 |Cut    |
  330.                 |Paste  |
  331.                  ------- 
  332.  
  333. * - these menu entries have been abbreviated.
  334.  
  335.  
  336.  
  337.     Catalog Menu
  338.  
  339.         New
  340.  
  341.             Start  a new catalogue.  When selected, this menu entry will open
  342.             the  four  (4)  catalogue  windows  in  the default positions and
  343.             sizes.   All windows will be empty.  The user has to add at least
  344.             one section and then add disks into the section(s) created.  
  345.  
  346.             This  menu entry is enabled only when the catalogue is closed and
  347.             a new catalogue is not being created.  
  348.  
  349.  
  350.         Open
  351.  
  352.             Open  an  existing  catalogue.   When  selected,  this menu entry
  353.             displays   the  file  selector  dialog.   The  user  selects  the
  354.             catalogue  file  to  open  and  selects  the  [OK] dialog button.
  355.             Selecting the [CANCEL] dialog button causes the open to abort.  
  356.  
  357.             When  opening an existing catalogue the program loads in both the
  358.             catalogue   information  from  the  '.CAT'  file  and  the  setup
  359.             information   from   the  '.HI'  or  '.MED'  file  (depending  on
  360.             resolution).   The  positions  and  sizes  of the windows and all
  361.             user  controlled  options  are restored to the state they were in
  362.             when the catalogue was last closed or when the setup was saved.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369. V5.2b                        STDCAT User's Guide                            6
  370.  
  371.  
  372.             To  select  another  setup the user can use the 'Read Setup' menu
  373.             entry  under the 'Misc' menu group.  
  374.  
  375.             To  convert  V3.X  or V4.X files for use by STDCAT V5.1b or V5.2b
  376.             use  'Open  and  then  'Save'.   The 'Open' command will load and
  377.             translate  the  catalogue  to the new format.  The older versions
  378.             of  STDCAT cannot read the new format.  Please make a backup copy
  379.             of an old catalogue before you convert it.  
  380.  
  381.             This  menu entry is enabled only when the catalogue is closed and
  382.             a new catalogue is not being created.  
  383.  
  384.  
  385.         Read
  386.  
  387.             The read menu entry provides a means of combining catalogues.  
  388.  
  389.             If  the  number  of sections allowed in the catalogue is exceeded
  390.             the  remaining sections will not be read in.  The only way to get
  391.             all of the disks into the catalogue is to combine the sections.  
  392.  
  393.             The  program  doesn't  combine sections with the same name.  If a
  394.             catalogue  is read in and one of the section names is the same as
  395.             an  existing  section, and the read completes without error, then
  396.             there  will  be  two sections with the same name.  If you want to
  397.             combine  the sections then the disks must be cut from one section
  398.             and pasted into the other section.  
  399.  
  400.             The  program  will not 'Read' the files produced from the earlier
  401.             versions  of  STDCAT.   If you have a V3.X or V4.X formatted file
  402.             then  use  the  'Open'  menu  option  and  then  the  'Save' menu
  403.             option.   This  will  load  the  catalogue and then convert it to
  404.             V5.X  format.   Please make a backup copy of the catalogue before
  405.             converting it.  
  406.  
  407.             This  menu  entry  is enabled when the catalogue is open or a new
  408.             catalogue is being created.  
  409.  
  410.  
  411.         Save
  412.  
  413.             Save  the information in the catalogue.  When selected, this menu
  414.             entry  will  cause both the catalogue and setup information to be
  415.             written  to  disk.   If  the  catalogue  is floppy based then the
  416.             program  may prompt the user to place the catalogue disk into the
  417.             drive  if  it  thinks the diskette has been changed.  This is not
  418.             fool  proof,  you  can, if you try, make it write to any disk you
  419.             want (and of course you should be allowed to do that).  
  420.  
  421.             This  menu  entry  is enabled when the catalogue is open or a new
  422.             catalogue is being created.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430. V5.2b                        STDCAT User's Guide                            7
  431.  
  432.  
  433.         Save As
  434.  
  435.             Save  the  catalogue  under a new catalogue name.  When this menu
  436.             entry  is  selected  the  program will display the file selector.
  437.             The  user  is  expected  to select/enter a new catalogue name and
  438.             select  the [OK] dialog button.  If the user selects [CANCEL] the
  439.             save  will be aborted.  If the user selects [OK] then a catalogue
  440.             and  setup  file  will be created.  If the catalogue file already
  441.             exists  a  dialog  will  be displayed prompting the user to write
  442.             over  the  file  or cancel the operation.  If the user decides to
  443.             write  over  the  file  then  all  the  existing  information  is
  444.             replaced with the catalogue information currently loaded.  
  445.  
  446.             This  menu  entry  is enabled when the catalogue is open or a new
  447.             catalogue is being created.  
  448.  
  449.  
  450.         Close
  451.  
  452.             Close  the  catalogue.   If  any  changes  have  been made to the
  453.             catalogue   information   the   program  will  display  a  dialog
  454.             prompting  the  user  to:  save before closing; don't save before
  455.             closing;  or  abort  the  close.  If the user decides not to save
  456.             before   closing   then   all   changes  made  to  the  catalogue
  457.             information is thrown away.  
  458.  
  459.             Every  time the user closes a catalogue the program writes to the
  460.             setup  file.   This  is  automatic  and  can't, at the moment, be
  461.             turned off.  
  462.  
  463.             This  menu  entry  is  enabled  when a catalogue is open or a new
  464.             catalogue is being created.  
  465.  
  466.  
  467.         Quit
  468.  
  469.             Quit  the  program  and return to the desktop or shell.  If there
  470.             is  a catalogue open, and changes have been made to the catalogue
  471.             information,  or  a new catalogue is being been made, the program
  472.             will  display  a  dialog prompting the user to: save before quit;
  473.             don't  save  before  quit;  or  abort the quit operation.  If the
  474.             user  decides  not  to save before quitting then all changes made
  475.             to the catalogue are thrown away.  
  476.  
  477.             This menu entry is always enabled.  
  478.  
  479.  
  480.     Section Menu
  481.  
  482.  
  483.         Sort
  484.  
  485.             Sort  the  sections in each section window.  If automatic sorting
  486.  
  487.  
  488.  
  489.  
  490.  
  491. V5.2b                        STDCAT User's Guide                            8
  492.  
  493.  
  494.             of  sections  has  been  disabled (in the Field Sort dialog) then
  495.             this menu entry can be used to sort the sections.  
  496.  
  497.             The  program places a check beside this menu entry when automatic
  498.             sorting is enabled.  
  499.  
  500.             This  menu  entry  is  enabled  when  a  catalogue  is  open  and
  501.             automatic  sorting  of  sections  is  disabled  in the Field Sort
  502.             dialog.  
  503.  
  504.  
  505.         Next
  506.  
  507.             Move  the  cursor  to  the  next  section  in  the section window
  508.             associated  with  the  top  window.   This  is useful when in the
  509.             Hierarchical  catalog  view  and  the  top  window  is displaying
  510.             disks, paths or files.  
  511.  
  512.             This  menu  entry  is  enabled when a catalogue is open, there is
  513.             more  than  one  section in the section window, and the cursor is
  514.             not  on  the  last  section in the section window associated with
  515.             the top window.  
  516.  
  517.  
  518.         Prev
  519.  
  520.             Move  the  cursor  to  the previous section in the section window
  521.             associated  with  the  top  window.   This  is useful when in the
  522.             Hierarchical  catalog  view  and  the  top  window  is displaying
  523.             disks, paths or files.  
  524.  
  525.             This  menu  entry  is  enabled when a catalogue is open, there is
  526.             more  than  one  section in the section window, and the cursor is
  527.             not  on  the  first section in the section window associated with
  528.             the top window.  
  529.  
  530.  
  531.         Info
  532.  
  533.             Display the Section dialog in read-only mode.  
  534.  
  535.             This  menu entry is enabled when a catalogue is open and there is
  536.             at  least  one  section in the section window associated with the
  537.             top window.  
  538.  
  539.  
  540.         Name
  541.  
  542.             Display  the  Section  dialog  and  allow editing.  The cursor is
  543.             placed  on  the Section Name field.  Permits rapid entry of names
  544.             without touching the mouse once [MULTI] has been enabled.  
  545.  
  546.             This  menu entry is enabled when a catalogue is open and there is
  547.  
  548.  
  549.  
  550.  
  551.  
  552. V5.2b                        STDCAT User's Guide                            9
  553.  
  554.  
  555.             at  least  one  section in the section window associated with the
  556.             top window.  
  557.  
  558.  
  559.         Comment
  560.  
  561.             Display  the  Section  dialog  and  allow editing.  The cursor is
  562.             placed  on  the  comment field.   Permits rapid entry of comments
  563.             without touching the mouse once [MULTI] has been enabled.  
  564.  
  565.             This  menu entry is enabled when a catalogue is open and there is
  566.             at  least  one  section in the section window associated with the
  567.             top window.  
  568.  
  569.  
  570.         Add
  571.  
  572.             Add a section.  
  573.  
  574.             This  menu  entry  is  enabled  when  a catalogue is open and the
  575.             total  number  of  sections  in the catalogue is not equal to the
  576.             maximum allowable.  
  577.  
  578.  
  579.         Delete
  580.  
  581.             Delete  a  section.   Selecting  this  menu  entry  will  cause a
  582.             confirmation  dialog  to  be  displayed.  If [CANCEL] is selected
  583.             the  section  delete will be aborted.  If you delete a section by
  584.             mistake  then  just  quit the program without saving (all changes
  585.             will  be lost) and re-run the program.  The section will not have
  586.             been  deleted  from the file and you can re-run STDCAT.  This, of
  587.             course,  assumes  that you had, at one time, saved the section in
  588.             the catalogue.  
  589.  
  590.             This  menu  entry is enable when a catalogue is open and there is
  591.             at  least least one section in the section window associated with
  592.             the top window.  
  593.  
  594.  
  595.     Disk Menu
  596.  
  597.  
  598.         Sort
  599.  
  600.             Sort  the  disks  in  each  disk window.  If automatic sorting of
  601.             disks  has  been  disabled  (in  the Field Sort dialog) then this
  602.             menu  entry  can  be  used  to  sort  the  disks.   If you change
  603.             sections  in Hierarchical or Dependant catalogue view then a sort
  604.             will not be done on the disks in the disk window(s).  
  605.  
  606.             The  program places a check beside this menu entry when automatic
  607.             sorting is enabled.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613. V5.2b                        STDCAT User's Guide                           10
  614.  
  615.  
  616.  
  617.             This  menu  entry  is  enabled  when  a  catalogue  is  open  and
  618.             automatic  sorting  of  disks  is  disabled  in  the  Field  Sort
  619.             dialog.  
  620.  
  621.  
  622.         Next
  623.  
  624.             Move  the  cursor  to the next disk in the disk window associated
  625.             with  the  top  window.   This is useful when in the Hierarchical
  626.             catalogue view and the top window is displaying paths or files.  
  627.  
  628.             This  menu  entry  is  enabled when a catalogue is open, there is
  629.             more  than  one disk in the disk window, and the cursor is not on
  630.             the last disk in the window.  
  631.  
  632.  
  633.         Prev
  634.  
  635.             Move  the  cursor  to  the previous disk in the window associated
  636.             with  the  top  window.   This is useful when in the Hierarchical
  637.             catalogue view and the top window is displaying paths or files.  
  638.  
  639.             This  menu  entry  is  enabled when a catalogue is open, there is
  640.             more  than  one disk in the disk window, and the cursor is not on
  641.             the first disk in the window.  
  642.  
  643.  
  644.         Info
  645.  
  646.             Display the Disk dialog in read-only mode.  
  647.  
  648.             This  menu entry is enabled when a catalogue is open and there is
  649.             at  least  one  disk  in  the disk window associated with the top
  650.             window.  
  651.  
  652.  
  653.         Name
  654.  
  655.             Display  the Disk dialog and allow editing.  The cursor is placed
  656.             on  the  Disk  Name  field.  Permits rapid entry of names without
  657.             touching the mouse once [MULTI] has been enabled.  
  658.  
  659.             NOTE:  If  you  have  a  version  of  TOS  prior  to V1.4 you may
  660.             encounter  difficulty  renaming  disks.   Some  versions  of  the
  661.             Desktop  'Format'  menu  entry  created volume names that are not
  662.             removeable  using  the  regular  TOS file/directory routines.  In
  663.             these  cases  the version V5.1b and later versions of STDCAT will
  664.             complain that the volume name can't be deleted.  
  665.  
  666.             This  menu entry is enabled when a catalogue is open and there is
  667.             at  least  one  disk  in  the disk window associated with the top
  668.             window.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674. V5.2b                        STDCAT User's Guide                           11
  675.  
  676.  
  677.         Number
  678.  
  679.             Display  the Disk dialog and allow editing.  The cursor is placed
  680.             on  the  Disk Number field.  Permits rapid entry of names without
  681.             touching the mouse once [MULTI] has been enabled.  
  682.  
  683.             This  menu entry is enabled when a catalogue is open and there is
  684.             at  least  one  disk  in  the disk window associated with the top
  685.             window.  
  686.  
  687.  
  688.         Comment
  689.  
  690.             Display  the Disk dialog and allow editing.  The cursor is placed
  691.             on  the  comment field.   Permits rapid entry of comments without
  692.             touching the mouse once [MULTI] has been enabled.  
  693.  
  694.             This  menu entry is enabled when a catalogue is open and there is
  695.             at  least  one  disk  in  the disk window associated with the top
  696.             window.  
  697.  
  698.  
  699.         Add
  700.  
  701.             Add  a  floppy  disk  or  hard  disk  partition  to the currently
  702.             selected  section.   If  you add a partition please remember, and
  703.             take precautions against, the 40 folder bug.  
  704.  
  705.             To  alternate  loading  disks  from  drive  A  and B.  Select the
  706.             [ALTERNATE  A  AND  B]  button  and  turn  on the [MULTI] button.
  707.             After  selecting the first drive with the mouse you can just keep
  708.             feeding  in  disks  and  use  the  <RETURN>  key to load the next
  709.             disk.  
  710.  
  711.             You  should  be careful about the disks you attempt to catalogue.
  712.             Some  copy  protected  disks cause TOS to act in weird ways after
  713.             attempting  to  access  the  disk  through  the  regular TOS file
  714.             access  method.   I  have  a  GOLDRUNNER  disk  that causes my ST
  715.             behave  very  strangely  after opening the disk from the desktop.
  716.             This  disk  also  blows up STDCAT when adding it to the catalogue
  717.             and  the  weirdness  won't  go away until my ST is reset.  I have
  718.             also  seen  STDCAT  behave  in  strange  ways  after loading in a
  719.             magazine pseudo double sided disk.  
  720.  
  721.             If  you  want to catalogue these kinds of disks then create a new
  722.             catalogue  and load in these disks, slowly, saving often and into
  723.             different  catalogue  files.   Once  done, read the new catalogue
  724.             into a section in your main catalogue.  
  725.  
  726.             This  menu  entry  is  enabled  when  a catalogue is open and the
  727.             number  of  disks in the section does is not equal to the maximum
  728.             allowable.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735. V5.2b                        STDCAT User's Guide                           12
  736.  
  737.  
  738.         Update
  739.  
  740.             Update a Disk.  
  741.  
  742.             This  menu entry is enabled when a catalogue is open and there is
  743.             at  least  one  disk  in  the disk window associated with the top
  744.             window.  
  745.  
  746.  
  747.         Cut
  748.  
  749.             Cut  the  current  disk  from  the  section  into  the disk paste
  750.             buffer.    The   disk   is  deleted  from  the  section  and  the
  751.             information  is  left in a buffer that can be used to contain the
  752.             contents  of  several disk.  The user can then change the section
  753.             and  Paste the disk(s) into the section.  This is basically a way
  754.             of moving disks around.  
  755.  
  756.             If  you  use Cut on a disk and then use Cut on another disk there
  757.             will  be  two  disks in the paste buffer and when a Paste is done
  758.             both  disks  will  be  removed from the paste buffer and put into
  759.             the selected section.  
  760.  
  761.             If  you  want to view the disks that are in the paste buffer just
  762.             create  an  empty  section and paste the disks into that section.
  763.             The paste buffer is empty after this operation.  
  764.  
  765.             This  menu entry is enabled when a catalogue is open and there is
  766.             at least one disk.  
  767.  
  768.  
  769.         Paste
  770.  
  771.             Paste   the  contents  of  the  paste  buffer  into  the  current
  772.             section.   The  paste buffer can hold the contents of many disks.
  773.             Using paste causes the paste buffer to become empty.  
  774.  
  775.             To  empty  the  paste  buffer  just create a junk section and use
  776.             Paste  to  put the disks into the junk section.  The junk section
  777.             can then be deleted before saving the catalogue.  
  778.  
  779.             This  menu  entry is enable when a catalogue is open and there is
  780.             at  least  one section and the Paste buffer has the contents of a
  781.             disk in it.  
  782.  
  783.  
  784.     Path Menu
  785.  
  786.  
  787.         Sort
  788.  
  789.             Sort  the  paths  in  each  path window.  If automatic sorting of
  790.             paths  has  been  disabled  (in  the Field Sort dialog) then this
  791.  
  792.  
  793.  
  794.  
  795.  
  796. V5.2b                        STDCAT User's Guide                           13
  797.  
  798.  
  799.             menu  entry  can  be used to sort the paths.  If you change disks
  800.             in  Hierarchical or Dependant catalogue view then a sort will not
  801.             be done on the paths in the path window(s).  
  802.  
  803.             The  program places a check beside this menu entry when automatic
  804.             sorting is enabled.  
  805.  
  806.             This  menu  entry  is  enabled  when  a  catalogue  is  open  and
  807.             automatic  sorting  of  paths  is  disabled  in  the  Field  Sort
  808.             dialog.  
  809.  
  810.  
  811.         Next
  812.  
  813.             Move  the  cursor  to the next path in the path window associated
  814.             with  the  top  window.   This is useful when in the Hierarchical
  815.             catalogue view and the top window is displaying files.  
  816.  
  817.             This  menu  entry  is  enabled when a catalogue is open, there is
  818.             more  than  one path in the path window, and the cursor is not on
  819.             the last path in the window.  
  820.  
  821.  
  822.         Prev
  823.  
  824.             Move  the  cursor  to  the previous path in the window associated
  825.             with  the  top  window.   This is useful when in the Hierarchical
  826.             catalogue view and the top window is displaying paths or files.  
  827.  
  828.             This  menu  entry  is  enabled when a catalogue is open, there is
  829.             more  than  one path in the path window, and the cursor is not on
  830.             the first path in the window.  
  831.  
  832.  
  833.         Info
  834.  
  835.             Display the Path dialog in read-only mode.  
  836.  
  837.             This  menu entry is enabled when a catalogue is open and there is
  838.             at  least  one  path  in  the path window associated with the top
  839.             window.  
  840.  
  841.  
  842.         Comment
  843.  
  844.             Display  the Path dialog and allow editing.  The cursor is placed
  845.             on  the  comment field.   Permits rapid entry of comments without
  846.             touching the mouse once [MULTI] has been enabled.  
  847.  
  848.             This  menu entry is enabled when a catalogue is open and there is
  849.             at  least  one  path  in  the path window associated with the top
  850.             window.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857. V5.2b                        STDCAT User's Guide                           14
  858.  
  859.  
  860.     File Menu
  861.  
  862.  
  863.         Sort
  864.  
  865.             Sort  the  files  in  each  file window.  If automatic sorting of
  866.             files  has  been  disabled  (in  the Field Sort dialog) then this
  867.             menu  entry can be used to sort the files.  If you change folders
  868.             in  Hierarchical or Dependant catalogue view then a sort will not
  869.             be done on the files in the path window(s).  
  870.  
  871.             The  program places a check beside this menu entry when automatic
  872.             sorting is enabled.  
  873.  
  874.             This  menu  entry  is  enabled  when  a  catalogue  is  open  and
  875.             automatic  sorting  of  files  is  disabled  in  the  Field  Sort
  876.             dialog.  
  877.  
  878.  
  879.         Info
  880.  
  881.             Display the File dialog in read-only mode.  
  882.  
  883.             This  menu entry is enabled when a catalogue is open and there is
  884.             at  least  one  file  in  the file window associated with the top
  885.             window.  
  886.  
  887.  
  888.         Group
  889.  
  890.             Display  the File dialog and allow editing.  The cursor is placed
  891.             on  the  group  field.    Permits  rapid  entry  of  group values
  892.             without touching the mouse once [MULTI] has been enabled.  
  893.  
  894.             This  menu entry is enabled when a catalogue is open and there is
  895.             at  least  one  file  in  the file window associated with the top
  896.             window.  
  897.  
  898.  
  899.         Comment
  900.  
  901.             Display  the File dialog and allow editing.  The cursor is placed
  902.             on  the  comment field.   Permits rapid entry of comments without
  903.             touching the mouse once [MULTI] has been enabled.  
  904.  
  905.             This  menu entry is enabled when a catalogue is open and there is
  906.             at  least  one  file  in  the file window associated with the top
  907.             window.  
  908.  
  909.  
  910.         Find
  911.  
  912.             Display  the  Find dialog.  The find dialog is used to search for
  913.  
  914.  
  915.  
  916.  
  917.  
  918. V5.2b                        STDCAT User's Guide                           15
  919.  
  920.  
  921.             strings  in  the  catalogue.   The  user  enters  the  string and
  922.             selects which objects to search for.  
  923.  
  924.             The  backslash  character  '\'  is  used  indicate  that the next
  925.             character  should  be  taken  literally  (this is used to match a
  926.             character  without  being  interpreted  as  a  wild  card).  When
  927.             matching  a  path  name  it  is  necessary  to  use two backslash
  928.             characters   (eg.   \\AUTO\)  for  each  backslash  in  the  path
  929.             pattern.   The  first  backslash  says to take the next character
  930.             literally, which, in this case, is a backslash.  
  931.  
  932.             Any  pattern  starting  with  the '^' character matches everthing
  933.             but  the  selected  pattern (eg. ^*.prg means match all files not
  934.             matching *.prg).  
  935.  
  936.             The   string   to  be  found  may  contain  wild  cards  (special
  937.             characters that match one or more characters).  
  938.  
  939.                 '*' 
  940.                     Match 0 or more characters.  
  941.  
  942.                 '?' 
  943.                     Match a single character.  
  944.  
  945.                 '[characters]' 
  946.                     Match  any  single  character with one from the list (eg.
  947.                     [abcd] matches a,b,c or d).  
  948.  
  949.                 '^' 
  950.                     Used  as the first character in the '[]' list, it changes
  951.                     the  list to mean all characters not in the list.  Put it
  952.                     last  in  the list if you want match a '^' character (eg.
  953.                     [^abcd] macthes not a,b,c or d).  
  954.  
  955.                 '-' 
  956.                     Used  to  specify a range of characters in the '[]' list.
  957.                     Put  it first in the list to match the '-' character (eg.
  958.                     [a-d] matches a, b, c or d).  
  959.  
  960.  
  961.     View Menu
  962.  
  963.  
  964.         Dependant
  965.  
  966.             Switch  the  catalogue  view to the dependant mode.  In this mode
  967.             the  contents  of  a  window  depends on the item selected in the
  968.             window's   parent   window.    The   order   of   dependants   is
  969.             file->path->disk->section,  where -> means 'depends on'.  This is
  970.             similar to the older version of the catalogue program.  
  971.  
  972.  
  973.         Hierarchical
  974.  
  975.  
  976.  
  977.  
  978.  
  979. V5.2b                        STDCAT User's Guide                           16
  980.  
  981.  
  982.             Switch  the  catalogue  view  to  the hierarchical mode.  In this
  983.             mode  each  window is independant.  When this mode is entered for
  984.             the  first  time  all  of the windows will display sections.  The
  985.             user   descends   into   lower   levels   (disk  path,  file)  by
  986.             double-clicking  on  an item in a window.  Each window may access
  987.             different  pieces  of  the  catalogue  at the same time making it
  988.             possible to compare portions of the catalogue (visually).  
  989.  
  990.             Remember  that,  in  this view, the menu entries (eg. Info, Name,
  991.             Comment,  etc.)  operate  on  the the sections, disks, paths, and
  992.             files  ones associated with the top window.  If, for example, the
  993.             top  window  is  at  the  disk  level  and  the user accessed the
  994.             Section  Comment  menu  entry  then the section displayed will be
  995.             the  section  that  the  disks  in the top windare are associated
  996.             with.   If,  in  the same example, the File Comment menu entry is
  997.             accessed  the  the  file will be the first file in the first path
  998.             for the disk selected in the top window.  
  999.  
  1000.  
  1001.         Flattened
  1002.  
  1003.             Switch  the  catalogue  view to the flattened mode.  In this mode
  1004.             each  window  is  independant  and  contains  only  one  type  of
  1005.             catalogue  information.   The  section window, as usual, displays
  1006.             the  sections  available.   The  disk  window displays all of the
  1007.             disks   (regardless  of  section)  available.   The  path  window
  1008.             displays  all  of  the  paths and the file window displays all of
  1009.             the files.  
  1010.  
  1011.  
  1012.         Field Order
  1013.  
  1014.             Setup  the  field  ordering  options for each window.  There is a
  1015.             limited  number  of  field  ordering  options.   Each  window has
  1016.             several fixed formats.  
  1017.  
  1018.  
  1019.         Field Enable
  1020.  
  1021.             Displays  a  dialog  that  controls  the display of the fields in
  1022.             each window.  
  1023.  
  1024.  
  1025.         Field Sort
  1026.  
  1027.             Displays  a  dialog  that  allows the user to control the sorting
  1028.             options available in each window.  
  1029.  
  1030.  
  1031.         Field Qualify
  1032.  
  1033.             Displays   a   dialog   that  allows  the  user  to  qualify  the
  1034.             information  displayed  in  the  catalogue windows.  The user may
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040. V5.2b                        STDCAT User's Guide                           17
  1041.  
  1042.  
  1043.             use  the  same  wild  cards  used  in  the  Find  dialog to setup
  1044.             qualification patterns.  
  1045.  
  1046.             Fields  that  can  match  patterns  (eg. *.tos) can have multiple
  1047.             patterns  with  an  implied  or between patterns (eg. *.tos *.prg
  1048.             means  *.tos or *.prg).  You can also negate a pattern with using
  1049.             the  '^'  character at the start of the pattern (eg. ^*.tos means
  1050.             not *.tos).  
  1051.  
  1052.  
  1053.     Output Menu
  1054.  
  1055.  
  1056.         Layout
  1057.  
  1058.             Control  the  output  format.  This is where the user selects the
  1059.             general  type  (sections,  disks, paths, files) of information to
  1060.             output.   For the Flattened view the user may select any of the 4
  1061.             types of information to output.  
  1062.  
  1063.             When  the  [TRUNCATE]  button  is  selected,  the output will not
  1064.             exceed  the  number  of  columns specified in the 'Sizes' dialog.
  1065.             If  the  information  to be printed exceeds the length specified,
  1066.             it  is truncated.  No wrapping occurs.  When the [TRUCATE] button
  1067.             is  de-selected,  the  output  may  contain lines longer than the
  1068.             maximum specified in the 'Sizes' dialog.  
  1069.  
  1070.             The  information  and fields selected for output will be the same
  1071.             as  the  fields  selected  for  display.   If  you don't want the
  1072.             section  or  disk  name  (for  example)  when  printing  out  the
  1073.             information  for a file or path then disable these fields for the
  1074.             file or path window before generating the output.  
  1075.  
  1076.             Don't  forget  the  save/load setup feature of STDCAT.  Make good
  1077.             use of setup files, they can make using STDCAT a lot easier.  
  1078.  
  1079.  
  1080.         Config
  1081.  
  1082.             Configure  the  control  character  sequences sent to the output.
  1083.             The  program  allows  the  user  to  set  a  separate sequence of
  1084.             characters for the following operations: 
  1085.  
  1086.                 print init - send this at the start of a print job.
  1087.                 print term - send this at the end of a print job.
  1088.                 page init  - send this at the start of each page.
  1089.                 page term  - send this at the end of each page.
  1090.                 line init  - send this at the start of each line.
  1091.                 line term  - send this at the end of each line.
  1092.  
  1093.                 new page   - send this to get a new page.
  1094.                 new line   - send this to get a new line.
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101. V5.2b                        STDCAT User's Guide                           18
  1102.  
  1103.  
  1104.                 field sep  - field separation string.
  1105.  
  1106.             The  program  doesn't  have  any control characters embedded into
  1107.             it.   The  program  uses only these strings to control the motion
  1108.             of  the  printer.  By default, the program provides '\r\n' as the
  1109.             default new line and '\f' as the default new page.  
  1110.  
  1111.             The  field  separation  string  is  used when sending output to a
  1112.             file.   If  not specified the program pads the fields as it would
  1113.             when  displaying  the  fields in a window.  When it is specified,
  1114.             this is the only sequence of characters separating the fields.  
  1115.  
  1116.                 I  might  use this feature if I wanted to process some of the
  1117.                 catalogue  information  on a UNIX system.  I might be tempted
  1118.                 to  set  the  field  separator to a ':', or a tab '\t', if it
  1119.                 would  make  it  easier to manipulate the file using standard
  1120.                 UNIX utilities.  
  1121.  
  1122.                 If  the 'new page' string is left blank, the program will use
  1123.                 the  'new  line'  string  to page the output to the page size
  1124.                 specified in the Sizes dialog.  
  1125.  
  1126.  
  1127.         Sizes
  1128.  
  1129.             Setup  the  output  sizes,  indenting,  lines, columns, etc.  The
  1130.             values  set  here are used for both file and printer output.  The
  1131.             program  only  does a simple check on widths and lengths and will
  1132.             allow some, less than useful, combinations.  
  1133.  
  1134.             If  you  the  footer  line  count  is set to 0 and the 'new page'
  1135.             string  is specified, the printer will form-feed an extra page at
  1136.             times.   Removing  the 'new page' string or setting the footer to
  1137.             something other that 0 will correct the problem.  
  1138.  
  1139.  
  1140.         Printer
  1141.  
  1142.             Output  to the printer port.  All of the information displayed in
  1143.             the  catalogue windows will be sent to the printer.  To limit the
  1144.             output use the 'Qualify' menu entry.  
  1145.  
  1146.             To pause or abort printing press the 'ESC' key.  
  1147.  
  1148.  
  1149.         File
  1150.  
  1151.             Output  all  of  the catalogue information displayed into a file.
  1152.             The  program  prompts for a file using the standard file selector
  1153.             dialog  and,  if  the  file  is  open  for  writing,  outputs the
  1154.             catalogue  information  to the file.  The program will write over
  1155.             an existing file without complaining.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162. V5.2b                        STDCAT User's Guide                           19
  1163.  
  1164.  
  1165.             In  the  Flattened  view  the  program will create up to 4 files.
  1166.             Each  file  has  a  different  extension according to the type of
  1167.             information output.  
  1168.  
  1169.                 .PRS - section information
  1170.                 .PRD - disk information
  1171.                 .PRP - path information
  1172.                 .PRF - file information
  1173.  
  1174.             In the Dependant view the program will create 1 output file.  The
  1175.             extension of the file will be '.PRT'.
  1176.  
  1177.  
  1178.     Misc Menu
  1179.  
  1180.  
  1181.         Read Setup
  1182.  
  1183.             Read  a  setup  file  and  re-configure  the windows, dialogs and
  1184.             output.   The program puts the screens and dialogs into the state
  1185.             they were when the setup file was created.  
  1186.  
  1187.  
  1188.         Save Setup
  1189.  
  1190.             Save  the  window,  dialog  and output configuration into a file.
  1191.             The  setup  file  does not contain any window cursor or catalogue
  1192.             information and, therefore, may be used with all catalogues.  
  1193.  
  1194.             The  program  uses two file extensions '.HI' and '.MED' for setup
  1195.             files  (others  as  well  but  they  are  untested) and their use
  1196.             depends  on  the  graphics resolution.  This is necessary because
  1197.             there  didn't  seem  to  be  an  easy way to translate the window
  1198.             sizes from one resolution to another resolution.  
  1199.  
  1200.             It  is  possible  to  read  a '.HI' or '.MED' setup file when the
  1201.             program  is  in  the  other resolution.  The program detects this
  1202.             and  reads  all  of  the configuration information except for the
  1203.             window sizes.  
  1204.  
  1205.  
  1206.         Default Windows
  1207.  
  1208.             Put all four windows back to the default positions and sizes.  
  1209.  
  1210.             It  is  not  possible to get the section and path windows back to
  1211.             the  default  size  using  the  window sizer.  From my experience
  1212.             it's a GEM problem, but, I could be wrong.  
  1213.  
  1214.  
  1215.         Auto Newtop
  1216.  
  1217.             When  this  menu  entry  is  checked the program moves the window
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223. V5.2b                        STDCAT User's Guide                           20
  1224.  
  1225.  
  1226.             that the mouse is over to the top (active) position.  
  1227.  
  1228.             This  option  failed miserably in previous version of STDCAT when
  1229.             run  on  some  newer versions of GEM.  The old method of handling
  1230.             this  has  been  replaced  with something that should be a little
  1231.             more portable across the many GEM versions (we'll see).  
  1232.  
  1233.             Auto  Newtop  will  is  automatically  turned  off  when the user
  1234.             selects a top window with the keyboard keys 1, 2, 3 or 4.  
  1235.  
  1236.  
  1237.         Display Formats
  1238.  
  1239.             Configure the format for the date and file names.  
  1240.  
  1241.  
  1242.         Small Font
  1243.  
  1244.             When  this  menu entry is checked the font for the text displayed
  1245.             in  the  windows is switched to a smaller font.  This menu option
  1246.             is not enabled in medium resolution.  
  1247.  
  1248.  
  1249.         Catalog Stats
  1250.  
  1251.             Display the current statistics for the catalogue.  
  1252.  
  1253.  
  1254.         Catalog Limits
  1255.  
  1256.             Display a few of the size limitations of the program.  
  1257.  
  1258.  
  1259. The [MULTI] Button
  1260.  
  1261.     A  number of dialogs in STDCAT have a [MULTI] button.  This button causes
  1262.     the  dialog  to  be re-displayed when the <RETURN> is pressed or the [OK]
  1263.     button  is  selected with the mouse. In most cases the dialog is clear of
  1264.     input  and ready for data entry when it is re-displayed.  It provides for
  1265.     the  rapid entering of information into the catalogue without moving your
  1266.     hands from the keyboard.  
  1267.  
  1268.     Please  use  this  mode  of  operation  when  loading  disks and entering
  1269.     comments (at least).  It can make working with STDCAT a lot easier.  
  1270.  
  1271.  
  1272. Output Escape Sequences
  1273.  
  1274.     The  printer  setup  strings  may  use  any  of  the  following character
  1275.     sequences to output non-printable ascii characters and control codes.  
  1276.  
  1277.         \f     - form feed                   (\014 = ^L)
  1278.         \r     - carriage return             (\013 = ^K)
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284. V5.2b                        STDCAT User's Guide                           21
  1285.  
  1286.  
  1287.         \n     - newline                     (\012 = ^J)
  1288.         \b     - backspace                   (\010 = ^H)
  1289.         \t     - tab                         (\007 = ^G)
  1290.         \NNN   - a single character in octal (\003 = ^C)
  1291.         ^[A-Z] - control characters          (^C = \003)
  1292.  
  1293.  
  1294. Short Cut Keys
  1295.     All  menu functions are available from the keyboard with the exception of
  1296.     displaying  the  About  dialog.  Keyboard access to the menu functions is
  1297.     controlled  through  the  selection  of  a menu to work with and then the
  1298.     selection  of  a  menu  item.  To select a menu to work with press either
  1299.     the  CONTROL  or  ALT  keys and press the first letter of the menu title.
  1300.     For  example, if you want to access the Catalog menu press either CONTROL
  1301.     C  or  ALT-C.   This  will  place  a  small  zero  beside  the menu title
  1302.     (indicating  that  this  menu  is  selected).  Next press one of the keys
  1303.     from  the  list  below (for the file menu).  To select another menu entry
  1304.     from the file menu just press another key from the list below.  
  1305.  
  1306.     Use the 'ESC' key to clear the menu selected mark from the menu.  
  1307.  
  1308.           Catalog ALT-C       Section ALT-S        Disk  ALT-D
  1309.           -------------       -------------        -----------
  1310.           N - New             S - Sort             S - Sort
  1311.           O - Open            F - Next             F - Next
  1312.           R - Read            B - Prev             B - Prev
  1313.           S - Save            I - Info             I - Info
  1314.           A - Save As         N - Name             N - Name
  1315.           C - Close           C - Comment          D - Number
  1316.           Q - Quit            A - Add              A - Comment
  1317.                               D - Delete           C - Add
  1318.                                                    U - Update 
  1319.                                                    X - Cut
  1320.                                                    P - Paste 
  1321.  
  1322.           Path  ALT-P         File  ALT-F          View        ALT-V
  1323.           -----------         -----------          -----------------
  1324.           S - Sort            S - Sort             D - Dependant
  1325.           F - Next            I - Info             H - Hierarchical
  1326.           B - Prev            G - Group            F - Flattened
  1327.           I - Info            C - Comment          O - Field Order
  1328.           C - Comment         F - Find             E - Field Enable
  1329.                                                    S - Field Sort
  1330.                                                    Q - Field Qualify
  1331.  
  1332.  
  1333.           Output ALT-O        Misc          ALT-M
  1334.           ------------        -------------------
  1335.           L - Layout          R - Read Setup
  1336.           C - Config          S - Save Setup
  1337.           S - Sizes           W - Default Windows
  1338.           P - Printer         A - Auto Newtop
  1339.           F - File            D - Display Formats
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345. V5.2b                        STDCAT User's Guide                           22
  1346.  
  1347.  
  1348.                               F - Font Size
  1349.                               C - Catalog Stats
  1350.                               L - Catalog Limits
  1351.  
  1352.     The  arrow keys are used for three functions.  If an arrow key is pressed
  1353.     the  window  will  scroll in the selected direction by one row or column.
  1354.     If  the  SHIFT  key is used with an arrow key then the window will scroll
  1355.     by  one  page.   If  the  CONTROL key is used with UP ARROW or DOWN ARROW
  1356.     then  the  cursor in the top window will move to select the next/previous
  1357.     item.  
  1358.  
  1359.     Each  window  has a number key associated with it; 1 - Section; 2 - Disk;
  1360.     3  -  Path;  4  -  File.   Pressing  one  of these numbers will bring the
  1361.     associated  window  to  the  top.  In addition to these keys the user may
  1362.     use  the  INSERT  key  to  close  a window and the CLR-HOME key to make a
  1363.     window full (and return a window to it's normal size).  
  1364.  
  1365.  
  1366. Usage
  1367.  
  1368.     If you run STDCAT from a shell you can give it two arguments: 
  1369.  
  1370.         stdcat.prg [[catalogue-name] [catalogue-setup]] 
  1371.  
  1372.     The  first argument is the name of a catalogue file.  If you specify just
  1373.     a  catalogue  name  (without  a  preceeding '.', '\', or drive specifier)
  1374.     then  the  program  will  look in the directory (folder) specified in the
  1375.     STDCAT  environment  variable  (if it exists) for the catalogue file.  If
  1376.     there  is  no  environment  variable  then  the  program will look in the
  1377.     current directory.  
  1378.  
  1379.     If  the  first  argument  has  a  '.',  '\' or drive specifier before the
  1380.     catalogue  name  then  the  program  ignores the environment variable and
  1381.     looks for the catalogue file exactly as specified.  
  1382.  
  1383.     Each  time  the program reads in a catalogue the program attempts to read
  1384.     the  setup  for  that  catalogue  at the same time.  The program uses the
  1385.     name  of  the  catalogue with the extension '.HI' or '.MED' (depending on
  1386.     the resolution) to access the setup file.  
  1387.  
  1388.     To  change  the name of the setup file accessed the user can add a second
  1389.     parameter  to  the  command  line  that  indicates  the name of the setup
  1390.     file.   It  is  possible  to have the setup file in a different directory
  1391.     (folder).  
  1392.  
  1393.  
  1394. Environment
  1395.  
  1396.     The  program  looks in the environment for an STDCAT string.  If the path
  1397.     is  to  a  catalogue  file  then  the program will load this catalogue at
  1398.     startup.   The  setup  file will be the catalogue name with the extention
  1399.     HI  for  hi-resolution  and  MED for medium resolution.  If the catalogue
  1400.     file  doesn't exist then the program will display a dialog indicating the
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406. V5.2b                        STDCAT User's Guide                           23
  1407.  
  1408.  
  1409.     error.   To  setup an environment variable you either must have a program
  1410.     that  loads at boot time and allows you to setup environment variables or
  1411.     you must be running a shell that supports setting them.  
  1412.  
  1413.     In  the  shells  that  I am familiar with there is usually a startup file
  1414.     that will allow you to setup an environment variable using a line like: 
  1415.  
  1416.         setenv STDCAT=c:\catalogs\arcdisks.cat 
  1417.  
  1418.  
  1419. Future Enhancements
  1420.  
  1421.     These  are  some of the things that I would like to change if I decide to
  1422.     produce  an  update  to the program.  There is no guarantee that these or
  1423.     any other improvements will be made available.  
  1424.  
  1425.     Option to change the order of size, used, free.  
  1426.  
  1427.     Adjustable path field width.  
  1428.  
  1429.     Change qualify to have a reject pattern.  
  1430.  
  1431.     Indent file names on Dependant printout.  
  1432.  
  1433.     Page numbering on Dependant printout.  
  1434.  
  1435.     Page titles on Dependant printout.  
  1436.  
  1437.     Find a better way to determine video mode.  
  1438.  
  1439.     Load  a default setup file (stdcat.med, stdcat.hi) if the setup file with
  1440.     the name of the catalogue isn't found.  
  1441.  
  1442.     Output find search into a file.  
  1443.  
  1444.  
  1445.     Here  are  some  changes  that have been asked for that I am reluctant to
  1446.     add.  If any of these are something you would like then let me know.  
  1447.  
  1448.     Prompt for volume name during add.  
  1449.  
  1450.     Read comments from a file.  
  1451.  
  1452.     Reject some files from the catalogue when adding/updating.  
  1453.  
  1454.     Allow  deleting files from the catalogue or moving files from one disk to
  1455.     another  within the catalogue.  Then requesting the program to update the
  1456.     disks by moving the real files around.  
  1457.  
  1458.  
  1459. Notes
  1460.  
  1461.     By  now  everyone  with  a hard disk should know about the 40 folder bug.
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467. V5.2b                        STDCAT User's Guide                           24
  1468.  
  1469.  
  1470.     If  you  want  to  catalogue a partition please make sure you are running
  1471.     one  of  the  programs  used  to  extend this limit well beyond the total
  1472.     number  of  folders  on  your hard disk (eg. folderXXX).  I routinely use
  1473.     folder500.prg (I know it's overkill) on my hard disk.  
  1474.  
  1475.     There is no print or find capability for the Hier view.  
  1476.  
  1477.     There are no add disk or read catalogue capabilities for the Flat view.  
  1478.  
  1479.     For  those who want to output 'Find' information into a file, you can get
  1480.     something  like  it  by using the 'Flat View' and the qualify dialogue to
  1481.     setup  patterns  of  files you are interested in.  Don't forget to enable
  1482.     the qualifications.  
  1483.  
  1484.  
  1485. Bug Reporting
  1486.  
  1487.     Starting  with  STDCAT V5.1b a new bug history list will be started.  Any
  1488.     problems  or weirdness that you find is of interest to me.  Please let me
  1489.     know by mail or email.  
  1490.  
  1491.  
  1492.     If you have access to USENET you can contact me at: 
  1493.                     bobs@wimsey.bc.ca 
  1494.             or 
  1495.                     ...!uunet!ubc-cs!van-bc!bobs 
  1496.  
  1497.  
  1498.     Otherwise you can send land mail to me at: 
  1499.                     Bob Silliker 
  1500.                     2828 Woodland Court 
  1501.                     Langley, B.C., 
  1502.                     Canada V2Y 1G1 
  1503.                     (604) 534-0676 
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.                                 Table Of Contents
  1532.  
  1533.                                   STDCAT V5.2b
  1534.  
  1535.     Introduction.......................................................    1
  1536.  
  1537.     Quick Start........................................................    2
  1538.  
  1539.     New Features.......................................................    2
  1540.  
  1541.     Menus..............................................................    5
  1542.  
  1543.        Catalog.........................................................    5
  1544.  
  1545.           New..........................................................    5
  1546.  
  1547.           Open.........................................................    5
  1548.  
  1549.           Read.........................................................    6
  1550.  
  1551.           Save.........................................................    6
  1552.  
  1553.           Save As......................................................    6
  1554.  
  1555.           Close........................................................    7
  1556.  
  1557.           Quit.........................................................    7
  1558.  
  1559.        Section.........................................................    7
  1560.  
  1561.           Sort.........................................................    7
  1562.  
  1563.           Next.........................................................    8
  1564.  
  1565.           Prev.........................................................    8
  1566.  
  1567.           Info.........................................................    8
  1568.  
  1569.           Name.........................................................    8
  1570.  
  1571.           Comment......................................................    9
  1572.  
  1573.           Add..........................................................    9
  1574.  
  1575.           Delete.......................................................    9
  1576.  
  1577.        Disk............................................................    9
  1578.  
  1579.           Sort.........................................................    9
  1580.  
  1581.           Next.........................................................   10
  1582.  
  1583.           Prev.........................................................   10
  1584.  
  1585.  
  1586.                                      - 1 -
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.           Info.........................................................   10
  1594.  
  1595.           Name.........................................................   10
  1596.  
  1597.           Number.......................................................   10
  1598.  
  1599.           Comment......................................................   11
  1600.  
  1601.           Add..........................................................   11
  1602.  
  1603.           Update.......................................................   11
  1604.  
  1605.           Cut..........................................................   12
  1606.  
  1607.           Paste........................................................   12
  1608.  
  1609.        Path............................................................   12
  1610.  
  1611.           Sort.........................................................   12
  1612.  
  1613.           Next.........................................................   13
  1614.  
  1615.           Prev.........................................................   13
  1616.  
  1617.           Info.........................................................   13
  1618.  
  1619.           Comment......................................................   13
  1620.  
  1621.        File............................................................   13
  1622.  
  1623.           Sort.........................................................   14
  1624.  
  1625.           Info.........................................................   14
  1626.  
  1627.           Group........................................................   14
  1628.  
  1629.           Comment......................................................   14
  1630.  
  1631.           Find.........................................................   14
  1632.  
  1633.        View............................................................   15
  1634.  
  1635.           Dependant....................................................   15
  1636.  
  1637.           Hierarchical.................................................   15
  1638.  
  1639.           Flattened....................................................   16
  1640.  
  1641.           Field Order..................................................   16
  1642.  
  1643.           Field Enable.................................................   16
  1644.  
  1645.  
  1646.  
  1647.                                      - 2 -
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.           Field Sort...................................................   16
  1654.  
  1655.           Field Qualify................................................   16
  1656.  
  1657.        Output..........................................................   17
  1658.  
  1659.           Layout.......................................................   17
  1660.  
  1661.           Config.......................................................   17
  1662.  
  1663.           Sizes........................................................   18
  1664.  
  1665.           Printer......................................................   18
  1666.  
  1667.           File.........................................................   18
  1668.  
  1669.        Misc............................................................   19
  1670.  
  1671.           Read Setup...................................................   19
  1672.  
  1673.           Save Setup...................................................   19
  1674.  
  1675.           Default Windows..............................................   19
  1676.  
  1677.           Auto Newtop..................................................   19
  1678.  
  1679.           Display Formats..............................................   20
  1680.  
  1681.           Small Font...................................................   20
  1682.  
  1683.           Catalog Stats................................................   20
  1684.  
  1685.           Catalog Limits...............................................   20
  1686.  
  1687.     The [MULTI] Button.................................................   20
  1688.  
  1689.     Output Escape Sequences............................................   20
  1690.  
  1691.     Short Cut Keys.....................................................   21
  1692.  
  1693.     Usage..............................................................   22
  1694.  
  1695.     Environment........................................................   22
  1696.  
  1697.     Future Enhancements................................................   23
  1698.  
  1699.     Notes..............................................................   23
  1700.  
  1701.     Bug Reporting......................................................   24
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.                                      - 3 -
  1709.  
  1710.