home *** CD-ROM | disk | FTP | other *** search
/ Millennium Time Capsule / AC2000.BIN / disks / ac6_disk / stamps11 / stamps.txt < prev   
Text File  |  1997-07-05  |  9KB  |  216 lines
  1.                               STAMP VALUES v1.1
  2.                               Stamp Values CPX
  3.                              by Linnhe Computing
  4.                       Copyright (c) 1997 Mark S Baines
  5.                              All Rights Reserved
  6.  
  7. Mark S Baines asserts the legal and moral right to be identified as the owner 
  8. of this work.
  9.  
  10.  
  11. STAMPS.CPX IS A FREEWARE PROGRAM
  12. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  13. STAMPS.CPX is protected under UK and international copyright law, and is NOT 
  14. public domain software. Mark S Baines owns the copyright to this program and 
  15. the document files.
  16.  
  17. You are hereby granted a licence to use these copies. You are not allowed to 
  18. alter the programs in any way, to do so is an infringement of my rights. 
  19. FREEWARE is NOT Public Domain!
  20.  
  21.  
  22. STAMPS.CPX - INVENTORY
  23. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  24. When distributed through any means whatsoever, this total package must not be 
  25. separated.
  26.  
  27. STAMPS.CPX    The CPX file
  28. STAMPALL.LST  The total list of stamps available at the Post Office data file
  29. STAMPS.LST    The list of stamps available to the user data file
  30. STAMPS.TXT    The documentation in standard ASCII text file
  31.  
  32.  
  33. STAMPS.CPX - WHAT IS IT?
  34. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  35. Stamp Values is a CPX program for the Atari XCONTROL panel accessory (or 
  36. alternatives, such as ZCONTROL or COPS). It shows you the combination of 
  37. stamps necessary to make up a certain value inputted.
  38.  
  39.  
  40. STAMPS.CPX - INSTALLATION
  41. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  42. Insert the STAMPS.CPX file and the two data files STAMPALL.LST and STAMPS.LST 
  43. into your system CPX folder.
  44.  
  45. You now need to do one of two things. Either reset your computer or have 
  46. XCONTROL reload your CPXs. Call the XCONTROL panel accessory and select the 
  47. Options/Setup menu item and click on the right-hand of the two large icons 
  48. which reloads all the CPX files. ZCONTROL has a similar feature. STAMPS.CPX 
  49. should now be available.
  50.  
  51.  
  52. STAMPS.CPX - DE-INSTALLATION
  53. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  54. Should you not want to use STAMPS.CPX any more, then de-installation is 
  55. simple. Delete the files:
  56.  
  57.     STAMPS.CPX, STAMPALL.LST and STAMPS.LST
  58.  
  59. from your CPX folder.
  60.  
  61.  
  62. STAMPS.CPX - USING IT
  63. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  64. After double-clicking on the STAMPS.CPX entry, enter the value of your letter 
  65. or parcel in the Value: box and click on [Calc] or press <Return>. The value 
  66. must be a decimal value, in pounds and pence.
  67.  
  68. The CPX will catch most input errors and correct them.
  69.  
  70. One or more boxes (up to 15) will be shown representing the stamps that you 
  71. need to stick on your letter or parcel. The values in these boxes are shown 
  72. in pounds and pence, therefore 0.02 represents a 2p stamp and 1.50 a £1.50 
  73. stamp. You are also shown the total number of stamps required.
  74.  
  75. The combination of stamps is chosen from those listed in the STAMPS.LST data 
  76. file. Initially, this is identical to the STAMPALL.LST which contains the 
  77. list of all the denominations of stamps available from the Post Office.
  78.  
  79. You may select the denominations of stamps you have available and hence 
  80. update the STAMPS.LST file by clicking on the [Setup] button. A list of all 
  81. the stamp denominations contained in the STAMPALL.LST data file is shown, up 
  82. to a maximum of 25. Stamp values that match those that you have available 
  83. (initially all the values until you modify them) will be already selected. In 
  84. this way you can see, out of the list of all the stamps available at the Post 
  85. Office, which stamps you have currently available to youself as saved in the 
  86. STAMPS.LST data file.
  87.  
  88. Make sure that each denomination you have is selected and then click on 
  89. [Save] or press <Return> to save the list to the STAMPS.LST data file. You 
  90. may also click on [OK] to temporarily make changes to thislist but this isn't 
  91. saved to the STAMPS.LST data file and therefore the selection isn't available 
  92. the next time you use the CPX.
  93.  
  94. Now when you click on [Calc] you'll only be shown the stamps you have 
  95. available.
  96.  
  97. On occasions, depending on the denominations of stamps you have available, 
  98. the list of stamps presented cannot exactly match the value inputted. The CPX 
  99. will present a list that, in total, will be greater than the value inputted 
  100. to avoid underpaying the postage on your letter or parcel.
  101.  
  102. At present the CPX doesn't give preference to 1st and 2nd class stamps, which 
  103. are more likely to be available to the user than any other denomination. If 
  104. you require this feature let me know. However, there is a way to achieve 
  105. this, and tune the CPX's preference for these (or any other stamps), which is 
  106. mentioned in the next section.
  107.  
  108. The [Info] button displays some brief Information about the program. The 
  109. [Cancel] button closes the CPX.
  110.  
  111.  
  112. STAMPS.CPX - STAMPALL.LST and STAMPS.LST data files
  113. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  114. These data files are ASCII files containing one entry per line. Each entry 
  115. consists of a four-figure number representing the stamp value in pence. 
  116. Leading zeros *are* necessary, so that a stamp with the value of 5p is 
  117. represented as 0005, a stamp valued at £10.00 is shown as 1000.
  118.  
  119. The minimum and maximum text line length is four characters. Each line ends 
  120. in the usual carriage return and line feed characters.
  121.  
  122. The CPX program allows up to 25 entries. The current STAMPALL.LST data file 
  123. contains 21 denominations.
  124.  
  125. You may edit these files to suit your own needs, for instance, when the cost 
  126. of a first class stamp goes up. It is also possible to modify the use of the 
  127. program so that it shows combinations of coins, for instance, rather than 
  128. stamps if you edit the STAMPALL.LST data file to contain a list of all 
  129. available coinage. However, in all cases, you must remain within the 
  130. limitations as already outlined. Failure to do so will be unpredictable. Use 
  131. an editor to change the STAMPALL.LST file or a word processor in ASCII or 
  132. non-word processor or program mode.
  133.  
  134. It is also possible to change the order of the values in the list so as to 
  135. give them preference over other values. When the CPX looks for possible stamp 
  136. denominations that match the value inputted it searches from the bottom of 
  137. the list working upwards. If you want to, say, give preference to 26p stamps 
  138. then you could move the entry for 0026 further down the list to, say, after 
  139. the £1.00 stamp value 0100. Then, the CPX will prefer 26p stamps to £1.00, 
  140. 50p etc. stamps. Care has to be taken here so that you don't end up with 10 
  141. times 26p stamps for a value of £2.60 when the more sensible thing to do is 
  142. to go to the Post Office and get a £2.00 stamp!
  143.  
  144. Both data files must be in the same folder as the STAMPS.CPX file, the 
  145. standard CPX folder for your system.
  146.  
  147. Whilst every effort has been made to ensure that the information given in the 
  148. STAMPALL.LST data file is accurate, no legal responsibility is accepted for 
  149. any errors, omissions or statements in that information.
  150.  
  151.  
  152. STAMPS.CPX - VERSION HISTORY
  153. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  154. V1.0
  155.     June 1997
  156.     The first release version.
  157. V1.1
  158.     July 1997
  159.     This release version.
  160.     List of stamps presented will now be greater, in total, than the value
  161.     inputted if an exact match cannot be made, thus avoiding underpayment of
  162.     postage.
  163.     The stamps available to the user, as stored in the STAMPS.LST file, are
  164.     already highlighted in the Setup page so that the user can see what has
  165.     previously been selected.
  166.     An OK button has been added to the Setup page allowing for temporary
  167.     adjustments to the list of denominations available to the user without
  168.     affecting the STAMPS.LST data file.
  169.  
  170.  
  171. STAMPS.CPX - LATEST VERSION
  172. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  173. The latest version of this program (together with all other Linnhe Computing 
  174. programs) is always available from:
  175.  
  176. The Linnhe Computing web site:
  177.     http://www.stsd.demon.co.uk/linnhe.html
  178.  
  179. CIX:
  180.     atari.st conference current filelist topic (such as atari.st/files97).
  181.  
  182. BBS networks:
  183.     FAN base FAN.UTIL.ACC
  184.  
  185. PD Libraries:
  186.     Floppyshop and FaST Club.
  187.  
  188.  
  189. STAMPS.CPX - THE ACKNOWLEDGEMENTS
  190. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  191. Thanks to Jon Ellis for his CPX articles in his excellent Programmers' Forum 
  192. series in ST Applications magazine.
  193.  
  194. Thanks to Joe Connor and Mike Kerslake for the idea and data and to Roger 
  195. Derry for suggestions for improvements.
  196.  
  197.  
  198. Slàinte mhath
  199. Mark S Baines
  200. Linnhe Computing
  201. Linnhe, Shore Street
  202. Inver
  203. Ross-shire
  204. IV20 1SF
  205.  
  206. 5th July 1997
  207.  
  208.  
  209. E-mail:
  210. Internet:    msbaines@cix.co.uk
  211. NeST:        90:102/107.0@nest.ftn
  212. FidoNet:     2:254/105.10@fidonet.org
  213. TurboNet:    100:101/12.10@turbonet.ftn
  214. AtariNet     51:502/0.10@atarinet.ftn
  215. Home Page:   http://www.stsd.demon.co.uk/linnhe.html
  216.