http://ftp.x.org/contrib/applications/xscreensaver-2.24.tar.gz
[xscreensaver] / utils / Makefile.in
index 9198bd87d341d4b12663c23bc5463a72aca9ea27..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,17 +94,17 @@ 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 \
-                 yarandom.c
+                 yarandom.c erase.c sgivideo.c
 OBJS           = alpha.o colors.o fade.o grabscreen.o hsv.o overlay.o \
                  resources.o spline.o usleep.o visual.o xmu.o xroger.o \
-                 yarandom.o
+                 yarandom.o erase.o sgivideo.o
 HDRS           = alpha.h colors.h fade.h grabscreen.h hsv.h resources.h \
                  spline.h usleep.h utils.h version.h visual.h vroot.h xmu.h \
-                 yarandom.h
+                 yarandom.h erase.h sgivideo.h
 EXTRAS         = README Makefile.in ad2c
 VMSFILES       = compile_axp.com compile_decc.com vms-gtod.c vms-gtod.h \
                  vms-strdup.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:
@@ -69,7 +142,7 @@ depend:
 # close.  This excludes dependencies on files in /usr/include, etc.  It tries
 # to include only dependencies on files which are themselves a part of this
 # package.
-distdepend:
+distdepend::
        @echo updating dependencies in `pwd`/Makefile.in... ;               \
        $(DEPEND) -w 0 -f -                                                 \
        -s '# DO NOT DELETE: updated by make distdepend' $(DEPEND_FLAGS) -- \
@@ -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 &&                                   \
@@ -97,54 +171,93 @@ echo_tarfiles:
        $(CC) -c $(INCLUDES) $(DEFS) $(CFLAGS) $(X_CFLAGS) $<
 
 
+# Rules for generating the VMS makefiles on Unix, so that it doesn't have to
+# be done by hand...
+#
+VMS_AXP_COMPILE=$$ CC/DECC/PREFIX=ALL/DEFINE=(VMS,HAVE_CONFIG_H)/INCL=([],[-])
+
+compile_axp.com: Makefile.in
+       @echo generating $@ from $<...  ;                                   \
+       ( ( for c in $(SRCS) vms-*.c ; do                                   \
+             c=`echo $$c | tr a-z A-Z` ;                                   \
+             echo "$(VMS_AXP_COMPILE) $$c" ;                               \
+            done ;                                                         \
+         ) | sort ;                                                        \
+          echo '$$ lib/cre utils.olb_axp' ;                                \
+         echo '$$ lib utils.olb_axp *.obj' ;                               \
+         echo '$$! delete/noconf *.obj;' ;                                 \
+        ) > $@
+
+compile_decc.com: compile_axp.com
+       @echo generating $@ from $<...  ;                                   \
+       sed 's/axp/decc/g' < $< > $@
+
+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
 grabscreen.o: $(srcdir)/grabscreen.h
-grabscreen.o: $(srcdir)/vroot.h
+grabscreen.o: $(srcdir)/sgivideo.h
 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: ../config.h
+erase.o: $(srcdir)/yarandom.h
+erase.o: $(srcdir)/usleep.h
+erase.o: $(srcdir)/resources.h
+sgivideo.o: $(srcdir)/utils.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