home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD2.bin / bbs / util / vmem-1.0.lha / VMem / Manual / VMem_OverView.manual < prev    next >
Text File  |  1994-08-01  |  8KB  |  191 lines
  1.                                 WELCOME TO
  2.  
  3.                                  * VMEM *
  4.  
  5.                          THE VIRTUAL MEMORY PACKAGE
  6.  
  7.                          FOR ALL AMIGA SYSTEMS WITH
  8.                             WORKBENCH 2 OR ABOVE
  9.  
  10.  
  11.                             OVERVIEW OF VMEM
  12.  
  13.         VMem is a package of several programs and files which allow your 
  14. AMIGA Access to almost infinite amounts of memory,by letting programs which 
  15. have been designed to use VMem to use a space on a disk as memory.
  16.  
  17.         When a program needs to use information, it needs somewhere to put
  18. it - and this 'somewhere' is normally your computer's memory. If there is
  19. not enough memory available, or other programs are using a lot of it, when
  20. the program tries to store information in memory, there won't be enough left,
  21. and the program will not work.
  22.  
  23.         This is where VMem comes in. When a program tries to store
  24. information through VMem and there isn't enough available, VMem copys other
  25. information which is not (currently) being used to a disk, and then frees
  26. the space which that information was using, a gives it the program that
  27. needs it at the time.When this program has finished with it, the other
  28. program's information is read back into it,and it is given back to the
  29. original owner.
  30.  
  31.         VMem also offers memory emulation which will let programs which need 
  32. types of memory which are not available on your system. For example, if a
  33. program tries to get FAST memory (the type on most memory expansions) VMem
  34. can 'talk it into' using CHIP memory (normal memory used for graphics and
  35. sound as well as general information) or PUBLIC memory (any kind).
  36.  
  37.  
  38.                            SO WHAT's THE CATCH ?
  39.  
  40.         As everyone knows, nothing's free. Virtual memory is no exception.
  41. Real memory is lightning fast compared to disk drives,or even hard disk
  42. drives, and since virtual memory has to use some kind of disk to store the
  43. memory on, programs can run a LOT slower. However, this is a small
  44. inconveniece considering the price of buying real memory.
  45.  
  46.         However, VMem is a "smart" bit of kit. It will only start saving
  47. stuff to disk when absolutly nessecary - the rest of the time, it just acts
  48. like real mem. See the Demo program if you don't believe me.
  49.  
  50.                         DISTRIBUTION and COPYRIGHT
  51.  
  52.    The programs and files in this distribution are freely distributable, but
  53. are also Copyright (c) By Lee Braiden. They may be freely distributed as long
  54. as no more than a nominal fee is charged to cover time and copying costs.
  55.  
  56.    Programmers can register as a VMem developer by sending £10 sterling to:
  57.  
  58.                 Lee Braiden,
  59.                 11 Poseyhill Rd.,
  60.                 Doagh,
  61.                 Co. Antrim,
  62.                 N.I.
  63.                 BT39 ORL
  64.  
  65.    Send money by EuroCheck (only in pounds sterling (£) ! ), uncrossed
  66. cheque, or British Royal Mail Postal Order. Please state the version of
  67. vmem.library you have (use the C:Version command to display the version)
  68. and any programs which you have written (or are writing) which use VMem.
  69.  
  70.    If you register you will be sent the next update of VMem (when it becomes
  71. available) and you will be kept up to date concerning further developments
  72. regarding VMem.
  73.  
  74.     If I get enough support for VMem, a future version of will include:
  75.  
  76.         *   Localized (multi-lingual) Prefs,etc
  77.  
  78.         *   MMU support (so that MMU-equiped machines hard-coded abilities
  79.             won't be replaced with slower,soft-coded ones.)
  80.  
  81.         *   Support for multiple dirs (VMem will store stuff in any dir
  82.             with enough space).
  83.  
  84.         *   AvailMem()-type function for virtual memory (to work out how
  85.             much you can squeeze into VMem's storage directories.
  86.  
  87.         *   And any other neat stuff I can think of.(Write to the address
  88.             above if you've any ideas).
  89.  
  90.  
  91.  
  92.                                  MISCELLANEOUS
  93.  
  94.         If you are having problems with any aspect of VMem, have found any
  95. bugs, or have comments, please feel free to send a letter (or disk)
  96. to the above address - it will be most welcome. A reply will be sent as
  97. soon as possible.
  98.  
  99.         Please note that even though every effort has been made to ensure
  100. the reliability VMem package, the author will not be held responsible for any
  101. damage or loss of data resulting directly or indirectly from use of the
  102. package.
  103.  
  104.  
  105.                                 COMMERCIAL USAGE
  106.  
  107.  
  108.   Commercial usage is allowed if the following conditions are met:
  109.  
  110.  
  111.         ·       You register as a VMem developer (see above).
  112.         ·       You state in your documentation that your program uses 
  113.                 vmem.library
  114.                 and that VMem is Copyright (c) 1994 By Lee Braiden.
  115.         ·       You send me a copy of your finished product(s) using 
  116.                 vmem.library.
  117.  
  118.  
  119.    If these conditions are met you are allowed to include the vmem.library,
  120. the prefs program, and the installation program (including all documentation files for 
  121. these programs) with your commercial product.
  122.  
  123.  
  124.                                 DISTRIBUTION
  125.  
  126.  
  127.    The complete VMem package contains the following files:
  128.  
  129.         VMem            (dir)                   ;main VMem directory
  130.                 Libs            (dir)           ;Shared library directory
  131.                         vmem.library            ;This is the main library
  132.                                                 ;for VMem
  133.                 Prefs           (dir)           ;VMem preferences dir
  134.                         Prefs                   ;VMem prefs controller
  135.                                                 ;program
  136.                 Manual  (dir)                   ;Contains most general docs
  137.                         VMem_Prefs.manual       ;manual for preferences
  138.                                                 ;program
  139.                         VMem_Prefs.guide        ;AmigaGuide version of above
  140.                         VMem_OverView.manual    ;this file
  141.                         VMem_OverView.guide     ;AmigaGuide version of this
  142.                                                 ;file
  143.                 Include (dir)                   ;Contains programmers'
  144.                                                 ;Include files
  145.                         CLib            (dir)
  146.                                 VMem_Protos.h
  147.                         Pragmas (dir)
  148.                                 VMem_Pragmas.h
  149.                         Proto           (dir)
  150.                                 VMem.h
  151.                         Libraries       (dir)
  152.                                 VMem.h
  153.                 AutoDocs        (dir)
  154.                         VMem.doc                ;autodocs for vmem.library
  155.                         VMem.guide              ;AmigaGuide version of
  156.                                                 ;autodocs
  157.                 Demo            (dir)
  158.                         Demo.c                  ;Example of programming
  159.                                                 ;with VMem
  160.                         Demo                    ;Actual Example Program
  161.                 FD              (dir)           ;Contains Amiga FD files
  162.                         VMem_Lib.fd     
  163.                 Install         (dir)
  164.                         Install                 ;Install Program for VMem
  165.                         Install.manual          ;Manual for Install program
  166.  
  167.  
  168.  
  169.    All of the files the author must remain unmodified unless permission is 
  170. explicitly given in this distribution.  None of these files may be
  171. distributed on its own, the entire package must be distributed as one whole.
  172. 'Demo' is full public domain and can be used in any way you like.
  173.  
  174.    There is one exception to the above.  If you plan to release a freely 
  175. distributable program (either public domain, freeware or shareware), you
  176. may include 'libs/vmem.library',  the installation program and the
  177. preference editor (each with their documentation and icons) with your
  178. distribution. It is left to the programmer to decide whether he wishes
  179. to register as a VMem developer. Registration is not required, but would
  180. certainly be appreciated. If you include VMem with a public domain,
  181. freeware or shareware program I'd