home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine 1995 / ARCHIVE95.iso / discs / utilities / utility_03 / arcscan / read_me
Text File  |  1995-05-25  |  8KB  |  183 lines
  1. ARCHIVE Magazine Index Data for ARCSCAN II or III Filing Systems
  2. ================================================================
  3. [C] E.W.Ayers :             update to May 95
  4.  
  5. ARCSCAN is a trademark of RISC Developments Ltd.
  6.  
  7.                          NOTE - ARCSCANIII
  8.  
  9. RISC Developments' most recent version - ArcScanIII - is now multi-tasking.
  10. It is fully compatible with ArcScanII, and the ARCHIVE ArcScan files may be
  11. installed in ArcScanII or ArcScanIII and updated in the same way,
  12. as described below.
  13.  
  14.  
  15. 1. Organisation of ARCSCAN II & III
  16.  
  17. ARCSCAN II  & III provide for two types of files:
  18.  
  19. Type 0     Magazine Files  -  With regular Volume and Issue numbers
  20. Type 1     Others
  21.  
  22. The files are held within Directories, and a !Custom file tells ARCSCAN
  23. what files to offer in its menu display, where to find them, and how to
  24. display  the  information  contained  in them. To add new sets of data to
  25. ARCSCAN, the appropriate directories must be created to contain the data,
  26. and the !Custom file must be extended to specify them.
  27.  
  28. Once this has been done, files may be updated/extended, or further files
  29. may be added to any existing DIRECTORIES. Provided they conform to the
  30. format prescribed in the !Custom file, no further changes to the
  31. latter will be needed.
  32.  
  33.  
  34. 2. Data on this Disc
  35.  
  36. The ARCHIVE data on this disc includes three sets of files:
  37.  
  38.    ARCHIVE Magazine contents    -  Type 0
  39.                                 -  Directory 'Archive'
  40.                                 -  Files     ARvol01  (Vol1, 1-12)
  41.                                              ARvol02  (Vol2, 1-12)
  42.                                              ARvol03  (Vol3, 1-12)
  43.                                              ARvol04  (Vol4, 1-12)
  44.                                              ARvol05  (Vol5, 1-12)
  45.                                              ARvol06  (Vol6, 1-12)
  46.                                              ARvol07  (Vol7, 1-12)
  47.                                              ARvol08  (Vol8, 1-9)
  48.    ARCHIVE Monthly Discs        -  Type 0
  49.                                 -  Directory 'ArDiscs'
  50.                                 -  Files     Advol01  (Vol1, 1-12)
  51.                                              Advol02  (Vol2, 1-12)
  52.                                              Advol03  (Vol3, 1-12)
  53.                                              Advol04  (Vol4, 1-12)
  54.                                              Advol05  (Vol5, 1-12)
  55.                                              Advol06  (Vol6, 1-12)
  56.                                              Advol07  (Vol7, 1-12)
  57.                                              Advol08  (Vol8, 1-9)
  58.    ARCHIVE Care/Shareware Discs -  Type 1
  59.                                 -  Directory 'ShareCare'
  60.                                 -  Files     Careware   (Nos 1-21)
  61.                                              Shareware  (Nos 0-51)
  62.                                              WIMPed     (1 disc)
  63.  
  64. To add any of these to your ARCSCAN disc, or to update it, it is necessary
  65. only to make any appropriate changes to the !Custom file (see below), and
  66. then to copy the relevant DIRECTORY, along with its files, replacing any
  67. existing directories bearing the same names.
  68.  
  69.  
  70. 3. The !Custom File
  71.  
  72.  
  73.   3.1 The Length parameter
  74.  
  75. The !Custom file provides for specifying the maximum length of each entry
  76. in a file, and this is used to organise the 'paging' of the ARCSCAN
  77. display. For the Type 0 files above, the length is set to 6, so that
  78. several entries appear on each 'page' of the display. For the Type 1 file
  79. above, the length is set to 25 (the maximum allowed), so that the display
  80. shows one disc at a time. Setting this parameter wrongly, or exceeding the
  81. specified length for an entry, may result in parts of a record scrolling
  82. off the ARCSCAN display or being overwritten before they can be read.
  83.  
  84.  
  85.   3.2 Modifying the !Custom file
  86.  
  87.          **** BACKUP your ARCSCAN Disc before proceeding! ****
  88.  
  89. To modify your !Custom file, get !Edit installed on the DeskTop Icon Bar.
  90. Insert your ARCSCAN disc, and open a filer window. HOLDING DOWN SHIFT,
  91. double-click on !ArcScan to open a sub-window, which should contain the
  92. !Custom file. Drag this to !Edit. The latter should open a window
  93. displaying the file contents. Click MEN (centre button) on this window,
  94. and select Edit -> CR-LF, which should make the file readable.
  95.  
  96. Go to the foot of the list, using the scroll bars, and examine the last
  97. block of entries - it will start with '#' plus a number. NOTE THIS NUMBER
  98. - your entry will be the next number. At the end of the file you should
  99. find '##'. Position the cursor (SELect on the mouse pointer) to the
  100. immediate LEFT of this entry, and press RETURN. This should insert a blank
  101. line before the '##' file terminator. Move the cursor up to the start of
  102. it.
  103.  
  104. You now have to key in the entries for your new data. The formats are
  105. shown below for each of the three data sets. You may choose to enter just
  106. one, two or all three, but each entry must be matched by later creating
  107. the appropriate directory, else ARCSCAN is liable to have a nervous
  108. breakdown!
  109.  
  110.  
  111.   3.3 New Entries in !Custom file
  112.  
  113. The tables below show the entries for each of the three data sets. The
  114. parameter shown as <n> is to be replaced by the next entry number (without
  115. the '< >' ). The tabulated entries should be inserted between the last
  116. existing entry and the end-of-file marker '##', with no blank lines,
  117. extra spaces or other characters. NB no RETURN after the last item in the
  118. list!
  119.  
  120.  
  121.                       ***SPECIAL NOTE***
  122.  
  123. If you have already entered the 'ShareCare' directory and data from
  124. earlier discs, please check your !Custom file complies with the form given
  125. below, as the LENGTH parameter has had to be altered to accommodate the
  126. larger number of items on some later discs.
  127.  
  128.  
  129. ARCHIVE Magazine             Monthly Discs            Share/Careware Discs
  130. ----------------             -------------            --------------------
  131.  
  132. #<n>                         #<n>                     #<n>
  133. Archive                      ArDiscs                  ShareCare
  134. Archive                      ArDiscs                  ShareCare
  135. Archive                      ArDiscs                  Sharecare
  136. ARvol                        Advol                    *
  137. 0                            0                        1
  138. 6                            6                        25
  139.  
  140.   
  141.   3.4 Saving the Amended !Custom File
  142.  
  143. Now again select Edit -> CR-LF by the MEN button, to compact the data.
  144. Click MEN on your !ArcScan sub-window, select 'File !Custom -> ' and then
  145. the delete option to remove the old file. Click MEN on the !Edit window
  146. and select SAVE which will open a save box and an Icon. Check that the box
  147. still shows the filename as ....!Custom, and drag the Icon to your
  148. !ArcScan sub-window.
  149.  
  150.  
  151. 4. Loading Data Files
  152.  
  153. This is merely a matter of copying from this disc into your !ArcScan
  154. sub-window those directories that you have specified in the !Custom file.
  155. If you have earlier directories bearing the same names, these should first
  156. be deleted as described in section 3.4 for the !Custom file.
  157.  
  158. The copying may be done by leaving the DeskTop and using *COPY with the
  159. appropriate pathnames (and Option 'P' to prompt disc changes if you have
  160. only a single floppy drive).
  161.  
  162. The easier way however is to stay in the DeskTop and create (temporarily)
  163. a RAM Disk. Click MEN on the 'A' icon at the right of the icon bar. and
  164. select 'Task display'. A window will open showing memory allocations.
  165. Scroll down until you can see 'RAM disc'. Click SEL to the right of this
  166. and drag a red bar out to give, say, 256 K of RAM disk. Open the RAM disk
  167. filer by clicking on the icon that should now be visible at the left of
  168. the icon bar.
  169.  
  170. Now insert this disk and open the filer window containing the directories
  171. you want.  Drag the required directory to the RAM Disk window (it will
  172. carry all the contained files with it). 
  173. Re-insert your ARCSCAN disk and re-open the !ArcScan sub-window (remember
  174. to hold down SHIFT!).
  175. Drag the directory from the RAM disc window back into it.
  176.  
  177. You should now be in business, and double clicking on the !Arcscan icon in
  178. the MAIN ARCSCAN window should start ARCSCAN up. Your new directory should
  179. now appear in the list (On ARCSCANII, click on 'NEW DATA' to display this).
  180. The right-hand window should confirm the files actually loaded.
  181.  
  182.                          ----- o -----
  183.