[bigint/bigint.git] / Makefile

#
# Matt McCutchen's Big Integer Library
#
# Please see the project Web site at
#    http://mysite.verizon.net/mccutchen/bigint/
# for more information and the latest version.
#
# December 23, 2004 development version
#
# NEWS:
# We're now using array indexes instead of pointers.
# After having used pointers for faster speed, I decided
# that they detracted too much from the readability of
# the program and that a good optimizing compiler should
# be able to produce as efficient code.

# The implicit rules we need
%.tag : %
	touch $@
%.o : %.cc
	g++ -c -O -Wall -Wextra -pedantic $<

# Default target
library : NumberlikeArray.hh.tag BigUnsigned.o BigInteger.o BigUnsignedInABase.o BigIntegerUtils.o

# Extra `include' dependencies
BigUnsigned.hh.tag : NumberlikeArray.hh.tag
BigUnsigned.o : BigUnsigned.hh.tag
BigInteger.hh.tag : BigUnsigned.hh.tag
BigInteger.o : BigInteger.hh.tag
BigUnsignedInABase.hh.tag : BigUnsigned.hh.tag
BigUnsignedInABase.o : BigUnsignedInABase.hh.tag
BigIntegerUtils.hh.tag : BigInteger.hh.tag
BigIntegerUtils.o : BigIntegerUtils.hh.tag

# sample program
sample : library sample.cc
	g++ -osample *.o sample.cc

clean :
	rm -f *.tag *.o sample

# The ``.tag'' mechanism allows for proper recompilation when a header file
# changes, considering that some header files may include others.
#
# If a header file X includes other header
# files Y and Z, we create a file X.tag that depends
# on X, Y.tag, and Z.tag.  Other headers that include X should
# depend on X.tag.
#
# Suppose Y is subsequently changed.  X doesn't get ``recompiled'',
# but anything that includes X should be recompiled.  Well, Y.tag becomes
# out-of-date, so X.tag becomes out-of-date, so anything depending on X.tag
# (that is, anything including X) becomes out-of-date.  Magic!
#
# In this system, the tag files are empty files used only for their
# timestamps.  If one wished to use precompiled headers, one could use
# ``.gch'' files exactly how ``.tag'' files are used now, except that
# their contents would be meaningful.
#
# However, the same sort of ``deadly diamond'' problem that surfaces with
# multiple inheritance also applies to precompiled headers.  The ``#ifndef''
# mechanism that prevents multiple inclusion doesn't work when headers are
# compiled independently in a hierarchical structure, since the second
# inclusion of a file won't even know there was a first inclusion.  For
# this reason, I just use ``.tag''s.
Commit	Line	Data
e67d6049 MM	1	#
	2	# Matt McCutchen's Big Integer Library
	3	#
	4	# Please see the project Web site at
	5	# http://mysite.verizon.net/mccutchen/bigint/
	6	# for more information and the latest version.
	7	#
05780f4b	8	# December 23, 2004 development version
e67d6049	9	#
05780f4b MM	10	# NEWS:
	11	# We're now using array indexes instead of pointers.
	12	# After having used pointers for faster speed, I decided
	13	# that they detracted too much from the readability of
	14	# the program and that a good optimizing compiler should
	15	# be able to produce as efficient code.
e67d6049	16
05780f4b MM	17	# The implicit rules we need
	18	%.tag : %
	19	touch $@
	20	%.o : %.cc
	21	g++ -c -O -Wall -Wextra -pedantic $<
e67d6049	22
05780f4b MM	23	# Default target
05780f4b MM	24	library : NumberlikeArray.hh.tag BigUnsigned.o BigInteger.o BigUnsignedInABase.o BigIntegerUtils.o
e67d6049	25
05780f4b MM	26	# Extra `include' dependencies
	27	BigUnsigned.hh.tag : NumberlikeArray.hh.tag
	28	BigUnsigned.o : BigUnsigned.hh.tag
	29	BigInteger.hh.tag : BigUnsigned.hh.tag
	30	BigInteger.o : BigInteger.hh.tag
	31	BigUnsignedInABase.hh.tag : BigUnsigned.hh.tag
	32	BigUnsignedInABase.o : BigUnsignedInABase.hh.tag
	33	BigIntegerUtils.hh.tag : BigInteger.hh.tag
	34	BigIntegerUtils.o : BigIntegerUtils.hh.tag
e67d6049	35
05780f4b MM	36	# sample program
	37	sample : library sample.cc
	38	g++ -osample *.o sample.cc
e67d6049	39
05780f4b MM	40	clean :
05780f4b MM	41	rm -f .tag .o sample
e67d6049	42
05780f4b MM	43	# The ``.tag'' mechanism allows for proper recompilation when a header file
	44	# changes, considering that some header files may include others.
	45	#
	46	# If a header file X includes other header
	47	# files Y and Z, we create a file X.tag that depends
	48	# on X, Y.tag, and Z.tag. Other headers that include X should
	49	# depend on X.tag.
	50	#
	51	# Suppose Y is subsequently changed. X doesn't get ``recompiled'',
	52	# but anything that includes X should be recompiled. Well, Y.tag becomes
	53	# out-of-date, so X.tag becomes out-of-date, so anything depending on X.tag
	54	# (that is, anything including X) becomes out-of-date. Magic!
	55	#
	56	# In this system, the tag files are empty files used only for their
	57	# timestamps. If one wished to use precompiled headers, one could use
	58	# ``.gch'' files exactly how ``.tag'' files are used now, except that
	59	# their contents would be meaningful.
	60	#
	61	# However, the same sort of ``deadly diamond'' problem that surfaces with
	62	# multiple inheritance also applies to precompiled headers. The ``#ifndef''
	63	# mechanism that prevents multiple inclusion doesn't work when headers are
	64	# compiled independently in a hierarchical structure, since the second
	65	# inclusion of a file won't even know there was a first inclusion. For
	66	# this reason, I just use ``.tag''s.