home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / CDROM02.ZIP / CDROM.DOC < prev    next >
Encoding:
Text File  |  1994-10-03  |  5.2 KB  |  169 lines
  1.  
  2.           CDROM Update v0.2alpha
  3.           ======================
  4.  
  5.           (C) 1994 Graham Leggett
  6.           All Rights Reserved
  7.           Made in South Africa
  8.  
  9.  
  10. What This Program Does:
  11. =======================
  12.  
  13. This program is the answer to the prayers of RemoteAccess sysops who
  14. have more CDROMs online than they have CDROM drives.
  15.  
  16. This program will search for each defined CDROM, marking those files on
  17. missing CDs as either missing or unavailable. In addition, the path to
  18. each area on the CD will be updated to reflect the correct drive path.
  19.  
  20. In short, put any CD in any drive, this program will do the rest.
  21.  
  22.  
  23.  
  24. How To Configure The Program:
  25. =============================
  26.  
  27. When CDROM.EXE is executed, it looks for the configuration file CDROM.CFG
  28. in the same directory the program was executed from. If the configuration
  29. file cannot be found, the program will terminate with an error message.
  30.  
  31. This is a sample configuration file:
  32.  
  33.    ;
  34.    ; CDROM Update Configuration File
  35.    ; (C) 1994 Graham Leggett All Rights Reserved
  36.  
  37. If you have a registration key, enter it in place of the 12345678. If
  38. there is no key present, or if the key has been entered incorrectly,
  39. the program will ask you to press a key before continuing.
  40.  
  41.    ;
  42.    ; Registration Key:
  43.    ; Place your registration key here.
  44.  
  45.    ;12345678
  46.  
  47.  
  48. In order for the program to identify which CDs are in which drives, a
  49. signature file and a RemoteAccess group number must be defined for each
  50. CD. In addition, each CDROM area must be flagged with the CDROM flag in
  51. the RemoteAccess filebase. Insert a line containing the group number
  52. the CD belongs to, followed by the signature file itself for each CD
  53. you wish to include.
  54.  
  55.    ;
  56.    ; CDROM definition:
  57.    ; Insert the CD's group number, followed by that CD's signature file.
  58.  
  59.    2 windows\xboard.zip       ; Cream of the Crop III
  60.    3 001a\winlite1.zip        ; Night Owl 11
  61.    4 ra_cream.exe             ; Cream of the Crop II
  62.    5 allfiles.z               ; Gemini Atari CDROM
  63.    6 001a\4edit20.zip         ; Night Owl 12
  64.  
  65. Note:
  66.  
  67. 1) The signature file itself can be any file on the CD, however it must be
  68. unique. In the example above, the Cream of the Crop II signature file
  69. is a bad choice as the file "RA_CREAM.EXE" can also be found in the root
  70. directory of Cream of the Crop III. In this case Cream of the Crop II
  71. would be marked as available and in the same drive as Cream of the
  72. Crop III.
  73.  
  74. 2) If the CD and group are NOT defined in the configuration file, the
  75. CDROM program will completely ignore that CD.
  76.  
  77. 3) Do not include any path to the CD or any backslashes before the
  78. signature file, or the program will not be able to find the CD, and as
  79. a result will mark all the files on that CD as offline/missing.
  80.  
  81.  
  82. The next item that needs to be configured are the paths to your CDROM
  83. drives.
  84.  
  85.    ;
  86.    ; CDROM Drive definition:
  87.    ; Insert the path names of each CDROM drive.
  88.  
  89.    L:\                        ; I only have one CDROM drive :-(
  90.  
  91. The path may consist of just a drive letter as above, or it could
  92. include a directory with it (eg "J:\CDROM1\"). The trailing backslash
  93. must be present for the CDs to be detected properly.
  94.  
  95. Note:
  96.  
  97. 1) When the program has detected a CD in the drive, it will replace
  98. the first part of the pathname in each RemoteAccess file area with
  99. the path to the drive the CD is in. This will only happen if the first
  100. part of the existing filename is one of the defined paths above. This
  101. is a safety feature designed to stop you wrecking your paths by changing
  102. them to "L:\K:\J:\001A".
  103.  
  104.  
  105.  
  106. The Everpresent Disclaimer:
  107. ===========================
  108.  
  109. This software is guaranteed to take up disk space, nothing else. I've
  110. tried to make it as bug free and forgiving as I can, however this
  111. program is used at your own risk.
  112.  
  113. This program writes to the FILES.RA and the FDBxxx.HDR files in the
  114. RemoteAccess filebase. Making a quick backup of these files is
  115. suggested before you use this software.
  116.  
  117.  
  118.  
  119. Shareware:
  120. ==========
  121.  
  122. This program has been released as shareware. You're licensed to try the
  123. software out for 21 days, after which you must buy a license for it, or
  124. stop using it.
  125.  
  126. The shareware cost is R20 (that's 20 South African Rands, about $5.60 at
  127. current rates).
  128.  
  129. Please send the money to:
  130.      Graham Leggett
  131.      15 Okkerneut Street
  132.      Weltevreden Park
  133.      1709 South Africa
  134.  
  135. Please include some means for me to send your key to you. If you have
  136. an internet address, please include it and I will send it to you that
  137. way. You may also fetch your key by polling me at 5:7107/13.
  138.  
  139. If you would like to me to mail your key to you, add R3 to the shareware
  140. price, and if you would like me to crash the key to you, add R5 to the
  141. shareware price.
  142.  
  143.  
  144.  
  145. How To Reach Me:
  146. ================
  147.  
  148. Please report any bugs or problems you may encounter.
  149.  
  150. I may be reached at the following places:
  151.  
  152. The Green Dragon BBS - Fidonet 5:7107/13
  153. Internet - 090graha@uwcc.cc.wits.ac.za
  154.  
  155.  
  156.  
  157. Revision History:
  158. =================
  159.  
  160. v0.2alpha:
  161.  
  162. ■  Fixed a bug where a missing backslash behind the RA environment
  163.    variable caused the program not to find CONFIG.RA or FILES.RA.
  164.  
  165. v0.1alpha:
  166.  
  167. ■  Seems to work ok... :-]
  168.  
  169.