home *** CD-ROM | disk | FTP | other *** search
- These are the tools that are used to generate DLL jumptable libraries.
-
- The stuff under doc is some documentation that describes it
- all. If you have groff, you can format this document in
- postscript/dvi/ascii/whatever and get a nice printout. If I feel like
- uploading a large file, I may leave the postscript version in that
- directory before packing the distribution. The README.* files explain
- how all of the tools work. The postscript version should be current
- with version 2.9 of the tools. If you do not want to print out the
- whole manual, you can see the file doc/table_description for the most
- recent list of supported libraries.
-
- The stuff under example is a very simple example of how
- sharable libraries work under linux. You can just go down there and
- type "make" to build the sharable library, and then you can type "make
- testit" to generate a test program. You must first compile and
- install the tools before you can run this test.
-
- The stuff in the tools directory is the source code for the
- various tools used to build the sharable libraries. Please use the
- "make install" target in the tools directory to properly install the
- tools - they do not simply get copied to /usr/bin.
-
- With version 2.7, there is a call to ___main in the last slot
- of the jump table which calls all of the constructors for global
- objects that may be in the sharable library. This should improve
- operation with libraries that contain C++ code.
-
- NOTE: BINARIES LINKED TO STUB LIBRARIES GENERATED BY TOOLS 2.7
- AND LATER WILL NOT RUN WITH SHARED IMAGES GENERATED BY TOOLS 2.6 AND
- EARLIER. THIS IS BECAUSE OF THE CALL TO __main IN THE JUMP TABLE TO
- INITIALIZE THE CONSTRUCTORS.
-
- As of version 2.16, the tools have been moved to /usr/bin.
- Earlier versions of the dll tools required users' Makefiles to reference
- the /usr/dll directory; unless you don't think you will be encountering
- any such older Makefiles, you should do "make install-compat" in the tools
- directory to install a backwards-compatible set of symlinks in /usr/dll.
-