home *** CD-ROM | disk | FTP | other *** search
/ BURKS 2 / BURKS_AUG97.ISO / SLAKWARE / D10 / TOOLS.TGZ / TOOLS.tar / usr / doc / tools-2.17 / README < prev    next >
Text File  |  1994-08-03  |  2KB  |  39 lines
  1.     These are the tools that are used to generate DLL jumptable libraries.
  2.  
  3.     The stuff under doc is some documentation that describes it
  4. all.  If you have groff, you can format this document in
  5. postscript/dvi/ascii/whatever and get a nice printout.  If I feel like
  6. uploading a large file, I may leave the postscript version in that
  7. directory before packing the distribution.  The README.* files explain
  8. how all of the tools work.  The postscript version should be current
  9. with version 2.9 of the tools.  If you do not want to print out the
  10. whole manual, you can see the file doc/table_description for the most
  11. recent list of supported libraries.
  12.  
  13.     The stuff under example is a very simple example of how
  14. sharable libraries work under linux.  You can just go down there and
  15. type "make" to build the sharable library, and then you can type "make
  16. testit" to generate a test program.  You must first compile and
  17. install the tools before you can run this test.
  18.  
  19.     The stuff in the tools directory is the source code for the
  20. various tools used to build the sharable libraries.  Please use the
  21. "make install" target in the tools directory to properly install the
  22. tools - they do not simply get copied to /usr/bin.
  23.  
  24.     With version 2.7, there is a call to ___main in the last slot
  25. of the jump table which calls all of the constructors for global
  26. objects that may be in the sharable library.  This should improve
  27. operation with libraries that contain C++ code.
  28.  
  29.     NOTE: BINARIES LINKED TO STUB LIBRARIES GENERATED BY TOOLS 2.7
  30. AND LATER WILL NOT RUN WITH SHARED IMAGES GENERATED BY TOOLS 2.6 AND
  31. EARLIER.  THIS IS BECAUSE OF THE CALL TO __main IN THE JUMP TABLE TO
  32. INITIALIZE THE CONSTRUCTORS.
  33.  
  34.     As of version 2.16, the tools have been moved to /usr/bin.
  35. Earlier versions of the dll tools required users' Makefiles to reference
  36. the /usr/dll directory; unless you don't think you will be encountering
  37. any such older Makefiles, you should do "make install-compat" in the tools
  38. directory to install a backwards-compatible set of symlinks in /usr/dll.
  39.