home *** CD-ROM | disk | FTP | other *** search
/ The Best of Mecomp Multimedia 1 / Mecomp-CD.iso / amiga / tools / utillities / vinced / include / lib_readme < prev    next >
Text File  |  1997-05-08  |  3KB  |  92 lines
  1. ********************************************
  2. **             VeryNewCon                 **
  3. **                                        **
  4. ** © 1994-1997 THOR-Software              **
  5. **                                        **
  6. ** Include and Library files              **
  7. ********************************************
  8.  
  9. Files in this drawer (for coders only):
  10.  
  11. -vnc_lib.fd:
  12.    The library .fd-file, defining function entry points.
  13.  
  14. -vnc_lib.i:
  15.    Offsets of the vnc.library for assembler usage.
  16.  
  17.  
  18. The next four files are link libraries containing stub routines for SAS/
  19. Lattice C. You MAY use direct library calls to VNC without stub routines,
  20. although this is NOT RECOMMENDED. There is a small difference between the
  21. stub and the raw library functions: For almost all raw entry points the
  22. register a5 MUST contain a pointer to the ViNCWindow structure. This is
  23. not necessary if you use the stub-routines, but you MUST set the window
  24. affected with SetCNWindow() before calling functions of this type.
  25. This is a service ONLY available by the stub-routines.
  26.  
  27. The stub routines are NOT available for the Manx/Aztec compiler cause this
  28. compiler uses a private, non compatible library coding and a different
  29. base register. 
  30. If you want to use this compiler, you MUST use direct library calls. 
  31. I haven't tested this method, it is possible that you get problems cause 
  32. the register a5 is used. You may also contact me if you need the 
  33. stub routines for a different compiler...
  34.  
  35. -vnc.stub.lib
  36.    Standard library stub routines: No base relative addressing, parameters
  37.    are passed in the stack.
  38.  
  39. -vnc.stub.base.lib
  40.    Stub routines for base relative adressing. The base register is a5, as
  41.    used by Lattice/SAS.
  42.  
  43. -vnc.stub.rr.lib
  44.    Stub routines for registerized parameters with no base relative
  45.    addressing. The first two integer arguments are passed in d0,d1, the
  46.    first two pointers in a0,a1.
  47.  
  48. -vnc.stub.rr.base.lib
  49.    Stub routines for registerized parameters and base relative addressing
  50.    with register a5.
  51.  
  52.  
  53. New in this release are some beta releases of the C includes. They aren't
  54. done completely (some flags are missing), but are now at least tested. They
  55. compile as they should, and the offsets are correct. If you've trouble 
  56. with them, let me know.
  57.  
  58. The autodocs and a description of how to setup the internal hooks and a
  59. describtion of the hooks is missing at all. This will be done next!
  60.  
  61.  
  62. Requester.h
  63.     ViNCEd standard requesters, using either asl or arp.
  64.  
  65. Window.h
  66.     The base structure of an open window.
  67.  
  68. Prefs.h
  69.     Description of the prefs, saved to file, read by SetVNC
  70.     and internally used as well.
  71.  
  72. Dynamics.h
  73.     Dynamical memory management structures, line, word and
  74.     other related structures.
  75.  
  76. VNCBase.h
  77.     The library base structure.
  78.  
  79. Owner.h
  80.     ViNCEd owners, named consoles and sub-owners (streams)
  81.  
  82. Macros.h
  83.     Structures used for macros and buttons (simple)
  84.  
  85. Menu.h
  86.     Input structure for the automated menu builder.
  87.  
  88.  
  89.  
  90. Thomas,
  91.     May 8th, 1997
  92.