Makefile

# Phil's multiplatform makefile template
# With auto-incrementing build number and automatic version.h generation
# Version 1.9, 2010-02-15
#
# The latest version of this Makefile can be found at http://www.philpem.me.uk/
#
#
# Copyright (c) 2010 Philip Pemberton <code@philpem.me.uk>
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in
# all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
# THE SOFTWARE.
#
#
# Instructions for use:
#   Run 'make init' to create the required directories
#   Add your source files to the 'SOURCES' list, and change the TARGET filename
#   Set the desired build type and platform in the BUILD_TYPE and PLATFORM
#     variables respectively
#   Set your project type (C only, or C++) in the SRC_TYPE variable
#   Add any libraries you need to link against to the 'LIB' list
#   Run 'make'
#
# Object files are created in the 'obj' subdirectory, from source code in the
# 'src' directory. Dependency files are created in the 'dep' directory from
# the same source code the object files are created from.
#
# Supported targets are:
#   all                 Build everything.
#   update-revision     Increment the build number without building anything.
#   clean-versioninfo   Delete src/version.h (will be rebuilt on the next
#                       'make all').
#   init                Initialise the build system for a new project.
#                       WARNING: overwrites .buildnum and src/version.h.in!
#   cleandep            Delete all dependency files.
#   clean               Delete all dependency, intermediate and target files.
#   tidy                Delete all dependency and intermediate files, leaving
#                       the target file intact.
#
# If you want to reset the build number to zero, delete '.buildnum'. This
# should be done whenever the major or minor version changes. Excluding
# .buildnum from version control may also be a good idea, depending on how
# you want your build numbers to work.
#
# The BUILD_TYPE variable contains the current build type. There are two
# supported build types:
#   debug       Debug mode - object files are compiled with debug information
#               and the target is left unstripped.
#   release     Release mode - object files are not compiled with debug info,
#               and the target is fed through strip to remove redundant
#               data.
#
# The PLATFORM variable contains the current target platform. There are two
# supported platforms:
#   linux       GNU/Linux with GNU Compiler Collection
#   win32       Windows 32-bit with MinGW
#
# The EXTSRC variable is used to specify other files to build. It is typically
# used to specify platform or build-type specific source files, e.g.
#
# ifeq ($(BUILD_TYPE),debug-memwatch)
#   CFLAGS += -g -ggdb
#   CPPFLAGS += -DMEMWATCH
#   INCPATH += ./memwatch
#   EXTSRC += memwatch/memwatch.c
# endif
#
# (example taken from one of my projects that allowed the use of Memwatch to
#  track down memory allocation/deallocation bugs)
#
#
# Change history:
#   1.9 - Bugfix -- if CFLAGS contained a forward-slash, sed would fall over.
#         Also added SDL support and fixed the date/time formats. To use SDL,
#         set ENABLE_SDL to "yes".
#   1.8 - Now supports the use of the wxWidgets GUI framework. To turn
#         this on, set ENABLE_WX to "yes".
#   1.7 - Now creates a basic Hgignore file and directory keepers for the
#         dep and obj directories.
#   1.6 - Added CFLAGS and CXXFLAGS to the command-lines for the dependency
#         building commands. This was causing issues with C99 / C++0x mode.
#   1.5 - Added support for Mercurial revision (changeset ID) display
#         Fixed a few issues with Subversion support (svn: and version 0 would
#         be displayed for exported code)
#

####
# Build configuration
####

# version information -- major.minor.extra
# note that VER_EXTRA can be overridden on the command line, e.g.:
# make VER_EXTRA=12345 all
VER_MAJOR	= 0
VER_MINOR	= 0
VER_EXTRA	?= 

# build platform: win32 or linux
PLATFORM	?=	linux
# build type: release or debug
BUILD_TYPE	?=	release

# target executable
TARGET		=	freebee

# source files that produce object files
SRC			=	main.c state.c memory.c wd279x.c wd2010.c keyboard.c tc8250.c diskraw.c diskimd.c i8274.c fbconfig.c toml.c
SRC			+=	musashi/m68kcpu.c musashi/m68kdasm.c musashi/m68kops.c musashi/softfloat/softfloat.c

# source type - either "c" or "cpp" (C or C++)
SRC_TYPE	=	c

# additional object files that don't necessarily include source
EXT_OBJ		=
# libraries to link in -- these will be specified as "-l" parameters, the -l
# is prepended automatically
LIB			= m
# library paths -- where to search for the above libraries
LIBPATH		=
# include paths -- where to search for #include files (in addition to the
# standard paths
INCPATH		=
# garbage files that should be deleted on a 'make clean' or 'make tidy'
GARBAGE		=	obj/musashi/m68kmake obj/musashi/m68kmake.exe obj/musashi/m68kmake.o

# extra dependencies - files that we don't necessarily know how to build, but
# that are required for building the application; e.g. object files or
# libraries in sub or parent directories
EXTDEP		=

# Extra libraries
# wxWidgets: set to "yes" to enable, anything else to disable
ENABLE_WX	=	no
# wxWidgets: list of wxWidgets libraries to enable
WX_LIBS		=	std
# SDL: set to "yes" to enable, anything else to disable
ENABLE_SDL	=	yes

####
# Win32 target-specific settings
####
ifeq ($(strip $(PLATFORM)),win32)
	# windows executables have a .exe suffix
	TARGET := $(addsuffix .exe,$(TARGET))
	# console mode application
	EXT_CFLAGS = -mconsole
endif


####
# Tool setup
####
CC		=	gcc
CXX		=	g++
CFLAGS	=	-Wall -pedantic -std=gnu99 $(EXT_CFLAGS)
CXXFLAGS=	-Wall -pedantic -std=gnu++0x $(EXT_CXXFLAGS)
LDFLAGS	=	$(EXT_LDFLAGS)
RM		=	rm
STRIP	=	strip

###############################################################################
# You should not need to touch anything below here, unless you're adding a new
# platform or build type (or changing the version string format)
###############################################################################

####
# A quick sanity check on the platform type
####
ifneq ($(PLATFORM),linux)
ifneq ($(PLATFORM),win32)
    $(error Platform '$(PLATFORM)' not supported. Supported platforms are: linux, win32)
endif
endif

####
# Version info generation
####
# get the current build number
VER_BUILDNUM	= $(shell cat .buildnum)

#### --- begin Git revision grabber ---
# get the current Git ID
VER_GITREV=$(shell ((git rev-parse --short HEAD) || echo "NONE") 2>/dev/null)
ifneq ($(VER_GITREV),NONE)
   VER_VCS		= git
   VER_VCSREV	= $(VER_GITREV)
else
   VER_VCS		= none
   VER_VCSREV	= 0
endif

#### --- end version grabbers ---

# start creating the revision string
VER_FULLSTR		= $(VER_MAJOR).$(VER_MINOR).$(VER_BUILDNUM)$(VER_EXTRA)

# if this is a VCS release, include the SVN revision in the version string
# also create a revision string that is either "svn:12345", "hg:12345" or
# blank
ifneq ($(VER_VCS),none)
    VER_FULLSTR	+= ($(VER_VCS) $(VER_VCSREV))
    VER_VCSSTR	= $(VER_VCS):$(VER_VCSREV)
else
    VER_VCSSTR	=
endif


####
# Build-type specific configuration
####
ifeq ($(BUILD_TYPE),debug)
	CFLAGS		+= -g -ggdb -DDEBUG
	CXXFLAGS	+= -g -ggdb -DDEBUG
else
 ifeq ($(BUILD_TYPE),release)
	CFLAGS		+= -O2
	CXXFLAGS	+= -O2
 else
 	$(error Unsupported build type: '$(BUILD_TYPE)')
 endif
endif

####
# Musashi config file
####
ifeq ($(PLATFORM),linux)
	CFLAGS		+= -DMUSASHI_CNF=\"../m68kconf.h\"
	CXXFLAGS	+= -DMUSASHI_CNF=\"../m68kconf.h\"
endif
ifeq ($(PLATFORM),win32)
	CFLAGS		+= -DMUSASHI_CNF="../m68kconf.h"
	CXXFLAGS	+= -DMUSASHI_CNF="../m68kconf.h"
endif

####
# wxWidgets support
####
ifeq ($(ENABLE_WX),yes)
	ifeq ($(BUILD_TYPE),debug)
		LIBLNK		+=	`wx-config --debug --libs $(WX_LIBS)`
		CFLAGS		+=	`wx-config --debug --cflags $(WX_LIBS)`
		CXXFLAGS	+=	`wx-config --debug --cxxflags $(WX_LIBS)`
		CPPFLAGS	+=	`wx-config --debug --cppflags $(WX_LIBS)`
	else
		ifeq ($(BUILD_TYPE),release)
			LIBLNK		+=	`wx-config --libs $(WX_LIBS)`
			CFLAGS		+=	`wx-config --cflags $(WX_LIBS)`
			CPPFLAGS	+=	`wx-config --cppflags $(WX_LIBS)`
			CXXFLAGS	+=	`wx-config --cxxflags $(WX_LIBS)`
		else
			$(error Unsupported build type: '$(BUILD_TYPE)')
		endif
	endif
endif

####
# SDL support
####
ifeq ($(ENABLE_SDL),yes)
	LIBLNK		+=	$(shell sdl2-config --libs)
	CFLAGS		+=	$(shell sdl2-config --cflags)
endif


####
# rules
####

# object files
OBJ		=	$(addprefix obj/, $(addsuffix .o, $(basename $(SRC))) $(EXT_OBJ)) $(addsuffix .o, $(basename $(EXTSRC)))

# dependency files
DEPFILES =	$(addprefix dep/, $(addsuffix .d, $(basename $(SRC))) $(EXT_OBJ)) $(addsuffix .d, $(basename $(EXTSRC)))

# path commands
LIBLNK	+=	$(addprefix -l, $(LIB))
LIBPTH	+=	$(addprefix -L, $(LIBPATH))
INCPTH	+=	$(addprefix -I, $(INCPATH))

CPPFLAGS +=	$(INCPTH)

####
# Make sure there is at least one object file to be linked in
####
ifeq ($(strip $(OBJ)),)
    $(error Unable to build: no object or source files specified in Makefile)
endif

####
# targets
####
.PHONY:	default all update-revision versionheader clean-versioninfo init cleandep clean tidy

all:	update-revision
	@$(MAKE) versionheader
	$(MAKE) $(TARGET)

# increment the current build number
NEWBUILD=$(shell expr $(VER_BUILDNUM) + 1)
update-revision:
	@echo $(NEWBUILD) > .buildnum

versionheader:
	@sed -e 's/@@datetime@@/$(shell LC_ALL=C date +"%a %d-%b-%Y %T %Z")/g'		\
		 -e 's/@@date@@/$(shell LC_ALL=C date +"%a %d-%b-%Y")/g'			\
		 -e 's/@@time@@/$(shell LC_ALL=C date +"%T %Z")/g'		\
		 -e 's/@@majorver@@/$(VER_MAJOR)/g'					\
		 -e 's/@@minorver@@/$(VER_MINOR)/g'					\
		 -e 's/@@extraver@@/$(subst \",,$(VER_EXTRA))/g'	\
		 -e 's/@@buildnum@@/$(VER_BUILDNUM)/g'				\
		 -e 's/@@buildtype@@/$(BUILD_TYPE)/g'				\
		 -e 's/@@vcs@@/$(VER_VCS)/g'						\
		 -e 's/@@vcsrev@@/$(VER_VCSREV)/g'					\
		 -e 's/@@vcsstr@@/$(VER_VCSSTR)/g'					\
		 -e 's/@@fullverstr@@/$(VER_FULLSTR)/g'				\
		 < src/version.h.in > src/version.h

# version.h creation stuff based on code from the Xen makefile
clean-versioninfo:
	@if [ ! -r src/version.h -o -O src/version.h ]; then \
		rm -f src/version.h; \
	fi
	@echo 0 > .buildnum

# initialise the build system for a new project
init:
	@mkdir -p src dep obj
	@echo "This file is a directory-keeper. Do not delete it." > dep/.keepme
	@echo "This file is a directory-keeper. Do not delete it." > obj/.keepme
	@echo 0 > .buildnum
	@echo 'syntax: glob' > .hgignore
	@echo 'obj/*.o' >> .hgignore
	@echo 'dep/*.d' >> .hgignore
	@echo '*~' >> .hgignore
	@echo '.*.sw?' >> .hgignore
	@echo '#define VER_COMPILE_DATETIME	"@@datetime@@"'			> src/version.h.in
	@echo '#define VER_COMPILE_DATE		"@@date@@"'				>> src/version.h.in
	@echo '#define VER_COMPILE_TIME		"@@time@@"'				>> src/version.h.in
	@echo '#define VER_COMPILE_BY			"@@whoami@@"'		>> src/version.h.in
	@echo '#define VER_COMPILE_HOST		"@@hostname@@"'			>> src/version.h.in
	@echo '#define VER_COMPILER			"@@compiler@@"'			>> src/version.h.in
	@echo '#define VER_BUILD_TYPE			"@@buildtype@@"'	>> src/version.h.in
	@echo '#define VER_CFLAGS				"@@cflags@@"'		>> src/version.h.in
	@echo ''													>> src/version.h.in
	@echo '#define VER_MAJOR				@@majorver@@'		>> src/version.h.in
	@echo '#define VER_MINOR				@@minorver@@'		>> src/version.h.in
	@echo '#define VER_BUILDNUM			@@buildnum@@'			>> src/version.h.in
	@echo '#define VER_EXTRA				"@@extraver@@"'		>> src/version.h.in
	@echo '#define VER_VCSREV				"@@vcsstr@@"'		>> src/version.h.in
	@echo ''													>> src/version.h.in
	@echo '#define VER_FULLSTR				"@@fullverstr@@"'	>> src/version.h.in
	@echo ''													>> src/version.h.in
	@echo Build system initialised

# remove the dependency files
cleandep:
	-rm $(DEPFILES)

# remove the dependency files and any target or intermediate build files
clean:	cleandep clean-versioninfo
	-rm $(OBJ) $(TARGET) $(GARBAGE)

# remove any dependency or intermediate build files
tidy:	cleandep clean-versioninfo
	-rm $(OBJ) $(GARBAGE)

#################################

$(TARGET):	$(OBJ) $(EXTDEP)
ifeq ($(SRC_TYPE),c)
	$(CC) $(CXXFLAGS) $(LDFLAGS) $(OBJ) $(LIBPTH) $(LIBLNK) -o $@
else
	$(CXX) $(CXXFLAGS) $(LDFLAGS) $(OBJ) $(LIBPTH) $(LIBLNK) -o $@
endif
ifeq ($(BUILD_TYPE),release)
	$(STRIP) $(TARGET)
endif

###
# extra rules
# example:
#src/parser.c:	src/parser.h


####
## musashi build rules
# 68k CPU builder
obj/musashi/m68kmake:	obj/musashi/m68kmake.o
	$(CC) $(CFLAGS) $(CPPFLAGS) obj/musashi/m68kmake.o -o $@
# 68k CPU sources
src/musashi/m68kops.h src/musashi/m68kops.c:	obj/musashi/m68kmake src/musashi/m68k_in.c
	./obj/musashi/m68kmake src/musashi src/musashi/m68k_in.c

####
# make object files from C source files
obj/%.o:	src/%.c
	$(CC) -c $(CFLAGS) $(CPPFLAGS) $< -o $@

##
# make object files from C++ source files
obj/%.o:	src/%.cc
	$(CXX) -c $(CXXFLAGS) $(CPPFLAGS) $< -o $@

obj/%.o:	src/%.cpp
	$(CXX) -c $(CXXFLAGS) $(CPPFLAGS) $< -o $@

###
# make C files from yacc/bison source
src/%.h src/%.c:	src/%.y
	$(YACC) $(YFLAGS) -d $<
	mv -f y.tab.c $*.c
	mv -f y.tab.h $*.h

###
# make C files from lex/flex source
src/%.c:	src/%.l
	$(LEX) $(LFLAGS) -o$@ $<

###
# make dependencies for our source files
dep/%.d:	src/%.c
	$(CC) -MM $(CFLAGS) $(CPPFLAGS) $< > $@.$$$$; \
		sed 's,\($*\)\.o[ :]*,obj/\1.o $@ : ,g' < $@.$$$$ > $@; \
		rm -f $@.$$$$

dep/%.d:	src/%.cpp
	$(CXX) -MM $(CXXFLAGS) $(CPPFLAGS) $< > $@.$$$$; \
		sed 's,\($*\)\.o[ :]*,obj/\1.o $@ : ,g' < $@.$$$$ > $@; \
		rm -f $@.$$$$

dep/%.d:	src/%.cc
	$(CXX) -MM $(CXXFLAGS) $(CPPFLAGS) $< > $@.$$$$; \
		sed 's,\($*\)\.o[ :]*,obj/\1.o $@ : ,g' < $@.$$$$ > $@; \
		rm -f $@.$$$$

####
# pull in the dependency files, but only for 'make $(TARGET)'
####

ifeq ($(MAKECMDGOALS),$(TARGET))
  -include $(DEPFILES)
endif