http://ftp.x.org/contrib/applications/xscreensaver-2.24.tar.gz
[xscreensaver] / utils / Makefile.in
index 6828083c3932b04a5639275948b5acdaa86e7566..17fd7b664a331f1059a5db5d29641c783e1d73f2 100644 (file)
@@ -1,6 +1,79 @@
 # utils/Makefile.in --- xscreensaver, Copyright (c) 1997 Jamie Zawinski.
 # the `../configure' script generates `utils/Makefile' from this file.
 
+
+# The utilities in this directory are used mostly by the demos in ../hacks/.
+# The Makefile in that directory builds executables by simply referencing
+# the .o files in this directory.
+
+
+##############################################################################
+#
+# Some rambling about dynamic libraries follows, ignore it if you don't care
+# (which is almost assuredly the case.)
+#
+#
+# It would probably be sensible to just build a single .a file in this
+# directory, and link the hacks against that (statically.)  I haven't done
+# that for two reasons: first, it works now, and why fix what ain't broke;
+# second, it wouldn't actually improve anything for the end user (it would
+# just make the Makefiles be a little smaller.)
+#
+# People sometimes suggest that the stuff in this directory should be in a
+# dynamic library, and that the hacks should be linked dynamically against
+# it.  I haven't done this for a number of reasons:
+#
+#  *  First, the only thing that would improve would be disk space, in that
+#     the executable files themselves would be smaller.  That's it.  Many other
+#     things would get worse if we used a dynamic library:
+#
+#  *  Complication of installation procedures: suddenly, before any of the
+#     hacks will work, you need to have a dynamic library installed, and
+#     the system configured to use it.  This is, basically, rocket science.
+#     Most people don't know how to do this, it's a huge pain, and on many
+#     systems, it requires root access.
+#
+#  *  Complication of the Makefile: every system builds dynamic libraries
+#     differently.  Every compiler takes different flags.  I don't want to
+#     do the hand-holding for the scores of Unix systems and compilers on 
+#     which people try to build this program.
+#
+#  *  Reduction of maintainability: gdb is remarkably bad at dealing with
+#     debug info in dynamic libraries, and when debugging a hack, one would
+#     constantly be fighting the linker and the debugger (or linking
+#     statically when debugging.)
+#
+#  *  Version skew: when things are statically linked, it's perfectly ok to
+#     make incompatible changes to the APIs defined in this directory, so long
+#     as the current version in ../hacks/ is in sync.  Much more care would 
+#     need to be taken with such things if dynamic libraries were involved,
+#     to make sure that the major and minor versions of the library changed
+#     at the appropriate time.  This isn't too hard, but it's more work, and
+#     yet another opportunity to screw up.
+#
+#  *  Runtime memory usage goes *up*.  That's right, up!  When a program
+#     links in a dynamic library, the whole library is brought into the 
+#     address space, not just the files that are actually used.  Normally,
+#     this is ok, because if several programs are using (for example)
+#     libX11.so, chances are that the savings outweighs the overhead.  But
+#     the nature of xscreensaver is that only one of the hacks ever runs at
+#     a time -- so there would never be a second program using the utils/
+#     dynamic library with which things could be shared.
+#
+#  *  Runtime speed decreases slightly, since dynamic code is marginally
+#     slower.  On modern machines, this probably doesn't make a perceptible
+#     difference, however.
+#
+# So basically, I just don't think using libraries would be a win, and it would
+# definitely cause more of a maintenance and portability headache.  However,
+# if someone else wants to do the work to make it be an option to configure,
+# and verifies that it works on several (more than three) different Unixes,
+# I'd be happy to take the patches.
+#                                                           -- jwz, 30-Jun-98
+#
+##############################################################################
+
+
 @SET_MAKE@
 .SUFFIXES:
 .SUFFIXES: .c .o
@@ -21,7 +94,7 @@ SHELL         = /bin/sh
 
 X_CFLAGS       = @X_CFLAGS@
 
-INCLUDES       = -I$(srcdir) -I$(srcdir)/.. @INCLUDES@
+INCLUDES       = -I$(srcdir) -I.. @INCLUDES@
 
 SRCS           = alpha.c colors.c fade.c grabscreen.c hsv.c overlay.c \
                  resources.c spline.c usleep.c visual.c xmu.c xroger.c \
@@ -56,7 +129,7 @@ clean:
        -rm -f *.o a.out core
 
 distclean: clean
-       -rm -f Makefile *~ "#"*
+       -rm -f config.h Makefile *~ "#"*
 
 # Adds all current dependencies to Makefile
 depend:
@@ -78,7 +151,8 @@ distdepend::
        (                                                                   \
          awk '/^# .*Makefile.in ---/,/^# DO .*distdepend/' < Makefile.in ; \
          sed -e 's@ \./@ @g;s@ /[^ ]*@@g;/^.*:$$/d'                        \
-             -e 's@ \([^$$]\)@ $$(srcdir)/\1@g' ;                          \
+             -e 's@ \([^$$]\)@ $$(srcdir)/\1@g'                            \
+             -e 's@ $$(srcdir)/\(.*config.h\)@ \1@g' ;                     \
          echo ''                                                           \
        ) > /tmp/distdepend.$$$$ &&                                         \
        mv Makefile.in Makefile.in.bak &&                                   \
@@ -126,24 +200,24 @@ distdepend:: compile_axp.com compile_decc.com
 # DO NOT DELETE: updated by make distdepend
 
 alpha.o: $(srcdir)/utils.h
-alpha.o: $(srcdir)/../config.h
+alpha.o: ../config.h
 alpha.o: $(srcdir)/alpha.h
 alpha.o: $(srcdir)/hsv.h
 alpha.o: $(srcdir)/yarandom.h
 alpha.o: $(srcdir)/resources.h
 colors.o: $(srcdir)/utils.h
-colors.o: $(srcdir)/../config.h
+colors.o: ../config.h
 colors.o: $(srcdir)/hsv.h
 colors.o: $(srcdir)/yarandom.h
 colors.o: $(srcdir)/visual.h
 colors.o: $(srcdir)/colors.h
 fade.o: $(srcdir)/utils.h
-fade.o: $(srcdir)/../config.h
+fade.o: ../config.h
 fade.o: $(srcdir)/visual.h
 fade.o: $(srcdir)/usleep.h
 fade.o: $(srcdir)/fade.h
 grabscreen.o: $(srcdir)/utils.h
-grabscreen.o: $(srcdir)/../config.h
+grabscreen.o: ../config.h
 grabscreen.o: $(srcdir)/yarandom.h
 grabscreen.o: $(srcdir)/usleep.h
 grabscreen.o: $(srcdir)/colors.h
@@ -153,35 +227,37 @@ grabscreen.o: $(srcdir)/visual.h
 grabscreen.o: $(srcdir)/resources.h
 grabscreen.o: $(srcdir)/vroot.h
 hsv.o: $(srcdir)/utils.h
-hsv.o: $(srcdir)/../config.h
+hsv.o: ../config.h
 hsv.o: $(srcdir)/hsv.h
 overlay.o: $(srcdir)/utils.h
-overlay.o: $(srcdir)/../config.h
+overlay.o: ../config.h
 overlay.o: $(srcdir)/visual.h
 resources.o: $(srcdir)/utils.h
-resources.o: $(srcdir)/../config.h
+resources.o: ../config.h
 resources.o: $(srcdir)/resources.h
 spline.o: $(srcdir)/utils.h
-spline.o: $(srcdir)/../config.h
+spline.o: ../config.h
 spline.o: $(srcdir)/spline.h
-usleep.o: $(srcdir)/../config.h
+usleep.o: ../config.h
 visual.o: $(srcdir)/utils.h
-visual.o: $(srcdir)/../config.h
+visual.o: ../config.h
 visual.o: $(srcdir)/resources.h
 visual.o: $(srcdir)/visual.h
-xmu.o: $(srcdir)/../config.h
+xmu.o: ../config.h
 xroger.o: $(srcdir)/utils.h
-xroger.o: $(srcdir)/../config.h
-yarandom.o: $(srcdir)/../config.h
+xroger.o: ../config.h
+xroger.o: $(srcdir)/spline.h
+yarandom.o: ../config.h
 yarandom.o: $(srcdir)/yarandom.h
 erase.o: $(srcdir)/utils.h
-erase.o: $(srcdir)/../config.h
+erase.o: ../config.h
 erase.o: $(srcdir)/yarandom.h
 erase.o: $(srcdir)/usleep.h
 erase.o: $(srcdir)/resources.h
 sgivideo.o: $(srcdir)/utils.h
-sgivideo.o: $(srcdir)/../config.h
+sgivideo.o: ../config.h
 sgivideo.o: $(srcdir)/sgivideo.h
 sgivideo.o: $(srcdir)/resources.h
+sgivideo.o: $(srcdir)/visual.h
 sgivideo.o: $(srcdir)/usleep.h