diff options
Diffstat (limited to 'html/build.html')
| -rw-r--r-- | html/build.html | 84 |
1 files changed, 76 insertions, 8 deletions
diff --git a/html/build.html b/html/build.html index 51ebb5d3..6cefc72a 100644 --- a/html/build.html +++ b/html/build.html @@ -107,10 +107,6 @@ This second scheme is useful for: the distribution on CD-ROM) </UL> -Beware that if you choose to use the second scheme for configuring -the software you must not use an absolute pathname when you run configure -(i.e. a pathname that begins with ``/''). - <A NAME="ConfigFiles"><P><HR WIDTH=65% ALIGN=right><H3>Configuration Files</H3></A> The configuration process is critical to the proper compilation, @@ -418,6 +414,56 @@ Creating port/install.sh from ../tiff-v3.4beta015/port/install.sh.in Done. </TT></PRE></UL> +<A NAME=DSOSupport><P><HR><H3>Shared Library Support</H3></A> + +It is desirable to make the TIFF library be a shared object +on systems that have support for shared libraries. +Unfortunately the rules to use to build a shared library +vary between operating systems and even compilers. +The distributed software includes support for building a shared +version of the library on a number of different systems. +This support is split between rules in the file +<B>libtiff/Makefile.in</B> that construct the shared library +and checks done by the <TT>configure</TT> script to verify that +the expected rules are supported by compilation tools for +the target system. + +<P> +To add new support for building a shared library both these files +must be updated. +In the configure script search for the section where the autoconfiguration +setting of the <TT>DSO</TT> parameter is handled and +add a new case for the target system that sets the +<TT>DSOSUF</TT>, +<TT>DSOLD</TT>, +<TT>DSOOPTS</TT>, +and +<TT>LIBCOPTS</TT> +options as appropriate for the system. +<TT>DSOSUF</TT> specifies the filename suffix used for the shared +library (e.g. ``.so'' for Dynamic Shared Objects on most SVR4-based +systems). +<TT>DSOLD</TT> specifies the program to use to build the shared library +from a compiled object file; typically ``${LD}'' though on some systems +it is better to use the C compiler directly so system-dependent options and +libraries are automatically supplied. +<TT>DSOOPTS</TT> are options that must be specified to <TT>DSOLD</TT> +when building the shared library. +<TT>LIBCOPTS</TT> are options to pass to the C compiler when constructing +a relocatable object file to include in a shared library; e.g. ``-K PIC'' +on a Sun system. +The <TT>DSO</TT> parameter must also be set to a unique label that identifies +the target system and compilation tools. +This label is used to select +a target in <B>libtiff/Makefile.in</B> to do the actual work in building +the shared library. +Finally, to complete support for the shared library added the appropriate +rules to <B>libtiff/Makefile.in</B> under the target specified in the +<TT>configure</TT> script. + + + + <A NAME="Parameters"><P><HR WIDTH=65% ALIGN=right><H3>Configuration Parameters</H3></A> This section gives a brief description of the less obvious @@ -475,9 +521,21 @@ the directories where the associated include files are located.</TD> </TR> <TR> -<TD VALIGN=top><TT>DSOOPTS</TT></TD> -<TD>When DSO's are built, the options to specify to <TT>CC</TT> -to create a DSO.</TD> +<TD VALIGN=top><TT>DIST_ALPHA</TT></TD> +<TD>The alpha version number for the distribution; e.g. if this +is version 3.4beta031 then the the major number is 31.</TD> +</TR> + +<TR> +<TD VALIGN=top><TT>DIST_MAJOR</TT></TD> +<TD>The major version number for the distribution; e.g. if this +is version 3.4beta031 then the the major number is 3.</TD> +</TR> + +<TR> +<TD VALIGN=top><TT>DIST_MINOR</TT></TD> +<TD>The minor version number for the distribution; e.g. if this +is version 3.4beta031 then the the major number is 4.</TD> </TR> <TR> @@ -487,6 +545,16 @@ If this is set to <TT>"a"</TT> then statically linked archives are used.</TD> </TR> <TR> +<TD VALIGN=top><TT>DSOSUF_VERSION</TT></TD> +<TD>When DSO's are built, a version-specific filename suffix for a DSO. +If this is set to something other than the value of <TT>DSO</TT> then +the file <B>libtiff.<TT>DSOSUF_VERSION</TT></B> will be installed and +a link to it named <B>libtiff.<TT>DSOSUF</TT></B> will automatically +be created. (Note that this means that rule for building the target +DSO must generate a file named <B>libtiff.<TT>DSOSUF_VERSION</TT></B>.)</TD> +</TR> + +<TR> <TD VALIGN=top><TT>ENVOPTS</TT></TD> <TD>Options to pass to <TT>CC</TT> to force ANSI C compilation.</TD> </TR> @@ -1037,7 +1105,7 @@ libtiff/mkversion.c program to generate libtiff/version.h. <ADDRESS> <A HREF="sam.html">Sam Leffler</A> / <A HREF="mailto:sam@engr.sgi.com">sam@engr.sgi.com</A>. -Last updated: $Date: 1996/02/09 22:08:41 $ +Last updated: $Date: 1996/03/18 22:21:04 $ </ADDRESS> </BODY> |