From: Sam Hartman <hartmans@mit.edu>
Date: Thu, 20 Jun 2002 16:40:02 +0000 (+0000)
Subject: Touch up comments on shared libraries
X-Git-Tag: krb5-1.3-alpha1~672
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=3a9ed34f678084460f57bb199f360d17b872f1f5;p=krb5.git

Touch up comments on shared libraries

git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@14547 dc483132-0cff-0310-8789-dd5450dbe970
---

diff --git a/doc/ChangeLog b/doc/ChangeLog
index b36379dd4..077cd5cca 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2002-06-20  Sam Hartman  <hartmans@mit.edu>
+
+	* implementor.texinfo (Operating System Notes for Shared Libraries):  Update why we don't use libtool
+	(Solaris  Shared Library Support): Update
+
 2002-06-18  Ken Raeburn  <raeburn@mit.edu>
 
 	* implementor.texinfo: Don't use @smallbook.
diff --git a/doc/implementor.texinfo b/doc/implementor.texinfo
index 178d6e746..52c05b4fb 100644
--- a/doc/implementor.texinfo
+++ b/doc/implementor.texinfo
@@ -460,21 +460,29 @@ will hardwire a path to the installed destination.
 @node Operating System Notes for Shared Libraries,  , Shared Library Theory, Shared Libraries
 @section Operating System Notes for Shared Libraries
 
-It would be nice to let some external package like GNU @code{libtool}
-handle all of this for us, but the last time we tried it,
-@code{libtool} was too slow, and didn't handle everything we need.
-So, for now, we deal with it all manually.
+From time to time users or developers suggest using GNU @code{Libtool}
+or some other mechanism to  generate shared libraries.  Experience
+with other packages suggests that Libtool tends to be difficult to
+debug and when it works incorrectly, patches are required to generated
+scripts to work around problems.  So far, the Kerberos shared library
+build mechanism, which sets a variety of makefile variables based on
+operating system type and then uses those variables in the build
+process has proven to be easier to debug and adequate to the task of
+building shared libraries for Kerberos.
+
 
 @menu
 * NetBSD Shared Library Support::  
 * AIX Shared Library Support::  
-* Solaris 5.3 Shared Library Support::  
+* Solaris  Shared Library Support::  
 * Alpha OSF/1 Shared Library Support::  
 @end menu
 
 @node NetBSD Shared Library Support, AIX Shared Library Support, Operating System Notes for Shared Libraries, Operating System Notes for Shared Libraries
 @subsection NetBSD Shared Library Support
 
+XXX I think this is horribly out of date and reflects pre-elf NetBSD.
+
 Shared library support has been tested under NetBSD 1.0A using 
 GCC 2.4.5. Due to the vagaries of the loader in the operating system,
 the library load path needs to be specified in building libraries and in
@@ -482,7 +490,7 @@ linking with them. Unless the library is placed in a standard location
 to search for libraries, this may make it difficult for developers to
 work with the shared libraries.
 
-@node AIX Shared Library Support, Solaris 5.3 Shared Library Support, NetBSD Shared Library Support, Operating System Notes for Shared Libraries
+@node AIX Shared Library Support, Solaris  Shared Library Support, NetBSD Shared Library Support, Operating System Notes for Shared Libraries
 @subsection AIX Shared Library Support
 
         AIX specifies shared library versions by combining multiple
@@ -505,16 +513,19 @@ compiler works fine.  In addition, the AIX 4.1 linker is able to build a
 shared @samp{libkrb5.a} when GNU C is used.
 
 
-@node Solaris 5.3 Shared Library Support, Alpha OSF/1 Shared Library Support, AIX Shared Library Support, Operating System Notes for Shared Libraries
-@subsection Solaris 5.3 Shared Library Support
+@node Solaris  Shared Library Support, Alpha OSF/1 Shared Library Support, AIX Shared Library Support, Operating System Notes for Shared Libraries
+@subsection Solaris  Shared Library Support
+
+Shared library support only works when using the Sunsoft C
+compiler. We are currently using version 3.0.1.  Modern versions of
+Solaris do not have this problem.
 
-Shared library support only works when using the Sunsoft C compiler. We
-are currently using version 3.0.1. 
 
 The path to the shared library must be specified at link time as well as
 when creating libraries. 
 
-@node Alpha OSF/1 Shared Library Support,  , Solaris 5.3 Shared Library Support, Operating System Notes for Shared Libraries
+
+@node Alpha OSF/1 Shared Library Support,  , Solaris  Shared Library Support, Operating System Notes for Shared Libraries
 @subsection Alpha OSF/1 Shared Library Support
 
 Shared library support has been tested with V2.1 and higher of the