libtool: Information sources

1 
1 15.1.1 Information sources
1 --------------------------
1 
1 Once it is clear that a new port is necessary, you'll generally need the
1 following information:
1 
1 canonical system name
1      You need the output of 'config.guess' for this system, so that you
1      can make changes to the libtool configuration process without
1      affecting other systems.
1 
1 man pages for 'ld' and 'cc'
1      These generally describe what flags are used to generate PIC, to
1      create shared libraries, and to link against only static libraries.
1      You may need to follow some cross references to find the
1      information that is required.
1 
1 man pages for 'ld.so', 'rtld', or equivalent
1      These are a valuable resource for understanding how shared
1      libraries are loaded on the system.
1 
1 man page for 'ldconfig', or equivalent
1      This page usually describes how to install shared libraries.
1 
1 output from 'ls -l /lib /usr/lib'
1      This shows the naming convention for shared libraries on the
1      system, including what names should be symbolic links.
1 
1 any additional documentation
1      Some systems have special documentation on how to build and install
1      shared libraries.
1 
1    If you know how to program the Bourne shell, then you can complete
1 the port yourself; otherwise, you'll have to find somebody with the
1 relevant skills who will do the work.  People on the libtool mailing
1 list are usually willing to volunteer to help you with new ports, so you
1 can send the information to them.
1 
1    To do the port yourself, you'll definitely need to modify the
1 'libtool.m4' macros to make platform-specific changes to the
1 configuration process.  You should search that file for the 'PORTME'
1 keyword, which will give you some hints on what you'll need to change.
1 In general, all that is involved is modifying the appropriate
1 configuration variables (⇒libtool script contents).
1 
1    Your best bet is to find an already-supported system that is similar
1 to yours, and make your changes based on that.  In some cases, however,
1 your system will differ significantly from every other supported system,
1 and it may be necessary to add new configuration variables, and modify
1 the 'ltmain.in' script accordingly.  Be sure to write to the mailing
1 list before you make changes to 'ltmain.in', since they may have advice
1 on the most effective way of accomplishing what you want.
1