Re: platform specific notes

[Ralf Wildenhues]

Hi Gary,

* Gary V. Vaughan wrote on Thu, Mar 24, 2005 at 06:14:46PM CET:
> Ralf Wildenhues wrote:
> > I think we need a better place to put platform specific notes.
> > branch-1-5 README has some, but README is not generally accessible
> > - for users of libtoolized packages
> > - before `configure'ing _that_ package
> 
> Great idea!  Yes I like it.

Good.

> > I'm pretty sure I violated that golden
> > distribution/creation rule again, so please show me how to create
> > notes.txt properly.
> 
> All fine, except that you need to 'cd $(srcdir)' first in the make rule,

I don't understand why this should be necessary; it breaks use of $<.
I put it in the patch below, though.

> and you need to generate a copy from the bootstrap script before configure is
> called.  Since bootstrap already hacks up some quick and dirty makefiles,
> running 'make notes.txt' with an appropriate environment from the right point
> in bootstrap should do the trick.

Done.

> That done, please commit.

Thanks for review.

I had to change a couple more details -- setting SUFFIXES does not work
with the hacked-up Makefile, so I went for a simple rule.  I also
decided to move the emacs note to the end.

One more question: Do you think we should install notes.txt?

Regards,
Ralf


2005-03-28  Ralf Wildenhues  <address@hidden>

        * notes.texi: Platform-specific configuration notes.
        * doc/libtool.texi: Include as section.
        * bootstrap, doc/Makefile.am: build also as notes.txt, distribute.

Index: bootstrap
===================================================================
RCS file: /cvsroot/libtool/libtool/bootstrap,v
retrieving revision 1.59
diff -u -r1.59 bootstrap
--- bootstrap   15 Mar 2005 12:58:40 -0000      1.59
+++ bootstrap   28 Mar 2005 09:48:49 -0000
@@ -32,6 +32,7 @@
 : ${FGREP=fgrep}
 : ${SED=sed}
 : ${LN_S='ln -s'}
+: ${MAKEINFO=makeinfo}
 
 test -f ./configure.ac || {
   echo "bootstrap: can't find ./configure.ac, please rerun from top_srcdir"
@@ -63,7 +64,7 @@
 
 # Whip up some dirty Makefiles:
 makefiles=
-for dirty in ./Makefile ./tests/Makefile
+for dirty in ./Makefile ./tests/Makefile ./doc/Makefile
 do
   test -f $dirty || {
     makefiles="$makefiles $dirty"
@@ -90,6 +91,9 @@
   $MAKE ./testsuite AUTOTEST="$AUTOM4TE --language=autotest" \
     srcdir=. top_srcdir=.. PACKAGE="$2" VERSION="$3"
   cd ..
+  cd doc
+  $MAKE notes.txt srcdir=. top_srcdir=.. MAKEINFO="${MAKEINFO}"
+  cd ..
 }
 
 test -f clcommit.m4sh && $MAKE -f Makefile.maint commit \
Index: doc/Makefile.am
===================================================================
RCS file: /cvsroot/libtool/libtool/doc/Makefile.am,v
retrieving revision 1.4
diff -u -r1.4 Makefile.am
--- doc/Makefile.am     25 Nov 2003 15:48:22 -0000      1.4
+++ doc/Makefile.am     28 Mar 2005 09:48:49 -0000
@@ -1,4 +1,10 @@
 ## Process this file with automake to produce Makefile.in
 
 info_TEXINFOS = libtool.texi
-libtool_TEXINFOS = PLATFORMS fdl.texi
+libtool_TEXINFOS = PLATFORMS fdl.texi notes.texi
+EXTRA_DIST = notes.txt
+
+all-local: notes.txt
+
+notes.txt: notes.texi
+       cd $(srcdir) && $(MAKEINFO) --plaintext $(MAKEINFOFLAGS) -o $@ 
notes.texi
Index: doc/libtool.texi
===================================================================
RCS file: /cvsroot/libtool/libtool/doc/libtool.texi,v
retrieving revision 1.190
diff -u -r1.190 libtool.texi
--- doc/libtool.texi    28 Mar 2005 09:15:09 -0000      1.190
+++ doc/libtool.texi    28 Mar 2005 09:48:49 -0000
@@ -140,6 +140,7 @@
 Configuring libtool
 
 * LT_INIT::                     Configuring @code{libtool} in 
@file{configure.ac}.
+* Configure notes::             Platform-specific notes for configuration.
 
 Including libtool in your package
 
@@ -1825,6 +1826,7 @@
 
 @menu
 * LT_INIT::                     Configuring @code{libtool} in 
@file{configure.ac}.
+* Configure notes::             Platform-specific notes for configuration.
 @end menu
 
 @node LT_INIT
@@ -2122,6 +2124,16 @@
 @end example
 
 
address@hidden Configure notes
address@hidden Platform-specific configuration notes
+
+While Libtool tries to hide as many platform-specific features as possible,
+some have to be taken into account when configuring either the Libtool package
+or a libtoolized package.
+
address@hidden notes.texi
+
+
 @node Distributing
 @section Including libtool in your package