osl-0.2.0.
[osl.git] / Makefile
index 967b00d..6f5b391 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -1,3 +1,13 @@
+# Implicit rules are implemented in make as suffix rules. The following rule
+# empties the suffix list to disable the predefined implicit rules. This
+# increases performance and avoids hard-to-debug behaviour.
+.SUFFIXES:
+MAKEFLAGS += -Rr
+CC := $(CC)
+ifeq ($(strip $(CC)),)
+       CC := cc
+endif
+
 # where to install
 PREFIX ?= /usr/local
 libdir := $(PREFIX)/lib
@@ -5,177 +15,123 @@ includedir := $(PREFIX)/include
 bindir := $(PREFIX)/bin
 mandir := $(PREFIX)/man/man1
 
-objects := osl.o util.o rbtree.o sha1.o
-fsck_objects := fsck.fsck.o osl.fsck.o util.fsck.o rbtree.fsck.o sha1.fsck.o fsck.cmdline.o
+objects := osl.o util.o rbtree.o sha1.o sha3.o sha256.o
+fsck_objects := fsck.o osl.o util.o rbtree.o sha1.o sha3.o sha256.o oslfsck.lsg.o
+deps := $(sort $(objects:.o=.d) $(fsck_objects:.o=.d))
 headers := osl.h
 executables := oslfsck
 man_pages := oslfsck.1
 
 INSTALL := install
-ifeq "$(origin CC)" "default"
-        CC := gcc
-endif
 MKDIR := mkdir -p
 RM := rm -f
 LN := ln
 LD := ld
+M4 := m4 -g
 OBJCOPY := objcopy
 
 # libosl's versioning consists of three numbers. Let's call them x, y and z.
-# The way x, y and z are interpreted depends on the OS.
 x := 0
-y := 1
-z := 1
+y := 2
+z := 0
 VERSION := $(x).$(y).$(z)
 
-# common flags
-CFLAGS += -Wno-sign-compare -g -Wunused -Wundef -W
-CFLAGS += -Wredundant-decls
-CFLAGS += -Os
-CFLAGS += -Wall
-CFLAGS += -Wuninitialized
-CFLAGS += -Wchar-subscripts
-CFLAGS += -Wformat-security
-CFLAGS += -Werror-implicit-function-declaration
-CFLAGS += -Wmissing-format-attribute
-CFLAGS += -Wunused-macros
-CFLAGS += -Wbad-function-cast
-
-# cflags used only for building library objects
-LIBCFLAGS += -fPIC
-LIBCFLAGS += -fvisibility=hidden
-
-uname_s := $(shell uname -s 2>/dev/null || echo "UNKNOWN_OS")
-
+OSL_CPPFLAGS += -DOSL_VERSION='"$(VERSION)"'
+
+OSL_CFLAGS += -g -Wunused -Wundef -W
+OSL_CFLAGS += -Wredundant-decls
+OSL_CFLAGS += -Os
+OSL_CFLAGS += -Wall
+OSL_CFLAGS += -Wuninitialized
+OSL_CFLAGS += -Wchar-subscripts
+OSL_CFLAGS += -Wformat-security
+OSL_CFLAGS += -Werror-implicit-function-declaration
+OSL_CFLAGS += -Wmissing-format-attribute
+OSL_CFLAGS += -Wunused-macros
+OSL_CFLAGS += -Wbad-function-cast
+OSL_CFLAGS += -fPIC
+OSL_CFLAGS += -fvisibility=hidden
+
+OSL_LDFLAGS += -Wl,-soname,$(soname)
+OSL_LDFLAGS += -Wl,-z,defs
+OSL_LDFLAGS += --shared
+
+# On ELf-based systems, the following conventions apply (see dhweeler's
+# Program Library HOWTO):
+#
+# The soname has the prefix ``lib'', the name of the library, the
+# phrase ``.so'', followed by a period and a version number that is
+# incremented whenever the interface changes.
 libname := osl
+soname := lib$(libname).so.$(x)
 
-ifeq ($(uname_s),Linux)
-       format := elf
-       LDFLAGS += -Wl,-soname,$(soname)
-       # disallow undefined symbols
-       LDFLAGS += -Wl,-z,defs
-endif
-ifeq ($(uname_s),Darwin)
-       # Darwin has its own idea on version numbers:
-       realname := lib$(libname).$(x).dylib
-       soname := $(realname)
-       linkername := lib$(libname).dylib
-       # The minor version number is an incremental number using the format
-       # X[.Y[.Z]]. To set the minor version number of a dynamic library, use
-       # the gcc -current_version option.
-       LDFLAGS += -current_version $(y).$(z)
-       #
-       # The compatibility version number of a library release specifies the
-       # earliest minor version of the clients linked against that release can
-       # use.
-       LDFLAGS += -compatibility_version $(y).0
-       LDFLAGS += -dynamiclib
-endif
-ifeq ($(uname_s),SunOS)
-       format := elf
-       # Solaris needs another set of flags
-       LDFLAGS += -z text
-       LDFLAGS += -z defs
-       CPPFLAGS += -I/opt/csw/include
-       LDFLAGS += -lc
-endif
+# The real name adds to the soname a period, a minor number, another
+# period, and the release number.
+realname := $(soname).$(y).$(z)
 
-ifeq ($(uname_s),NetBSD)
-       format := elf
-       LDFLAGS += -Wl,-soname,$(soname)
-endif
+# In addition, there's the name that the compiler uses when requesting
+# a library, (I'll call it the ``linker name''), which is simply the
+# soname without any version number.
+linkername := lib$(libname).so
 
-ifeq ($(uname_s),FreeBSD)
-       format := elf
-       LDFLAGS += -Wl,-soname,$(soname)
-endif
+all: $(realname) $(executables) $(man_pages) $(headers)
+shared: $(realname)
 
-ifeq ($(format),elf)
-       # On ELf-based systems, the following conventions apply (see dhweeler's
-       # Program Library HOWTO):
-       #
-       # The soname has the prefix ``lib'', the name of the library, the
-       # phrase ``.so'', followed by a period and a version number that is
-       # incremented whenever the interface changes.
-       soname := lib$(libname).so.$(x)
-
-       # The real name adds to the soname a period, a minor number, another
-       # period, and the release number.
-       realname := $(soname).$(y).$(z)
-
-       # In addition, there's the name that the compiler uses when requesting
-       # a library, (I'll call it the ``linker name''), which is simply the
-       # soname without any version number.
-       linkername := lib$(libname).so
-       LDFLAGS += --shared
+ifeq ($(findstring clean, $(MAKECMDGOALS)),)
+-include $(deps)
 endif
 
-all: $(realname) $(executables) $(man_pages)
-Makefile.deps: $(wildcard *.c *.h)
-       $(CC) -MM -MG *.c > $@
-osl.c fsck.c:
-
--include Makefile.deps
-
-fsck.cmdline.o: fsck.cmdline.c fsck.cmdline.h
-       $(CC) -c -DVERSION='"$(VERSION)"' $<
-
-%.fsck.o: %.c Makefile fsck.cmdline.c fsck.cmdline.h osl.h errtab.h
-       $(CC) -c -DVERSION='"$(VERSION)"' $(CPPFLAGS) $(CFLAGS) $< -o $@
-
-%.o: %.c Makefile errtab.h
-       $(CC) -c $(CPPFLAGS) $(CFLAGS) $(LIBCFLAGS) $<
-
-fsck.cmdline.h fsck.cmdline.c: fsck.ggo Makefile
-       gengetopt \
-               --conf-parser \
-               --unamed-opts=table \
-               --no-handle-version \
-               --file-name=fsck.cmdline \
-               --func-name=fsck_cmdline_parser \
-               --set-package="oslfsck" \
-               --arg-struct-name=fsck_args_info \
-               < $<
-
+# The files to generate before attempting to run the compiler. These
+# are the order-only prerequisites in the rule below.
+pre_deps := osl.h errtab.h oslfsck.lsg.h
+
+# The .d and .o files are both created from a single cc invocation.
+define CC_CMD
+       $(CC) $(OSL_CPPFLAGS) $(CPPFLAGS) \
+               -c -MMD -MF $(*F).d -MT $(*F).o \
+               $(OSL_CFLAGS) $(CFLAGS) $<
+endef
+%.o: %.c Makefile | $(pre_deps)
+       $(CC_CMD)
+%.d: %.c Makefile | $(pre_deps)
+       $(CC_CMD)
+
+fsck.o: oslfsck.lsg.h
 oslfsck: $(fsck_objects)
-       $(CC) -o $@ $(fsck_objects)
+       $(CC) -o $@ $(fsck_objects) $(LDFLAGS) -llopsub
 
-oslfsck.1: oslfsck
-       help2man -h --detailed-help -N ./$< > $@
+.PRECIOUS: %.lsg.h %.lsg.c
+%.lsg.c: %.suite
+       lopsubgen --gen-c < $<
 
-$(realname): $(objects)
-       $(CC) $(LDFLAGS) -o $@ $(objects)
+%.lsg.h: %.suite
+       lopsubgen --gen-header < $<
 
-$(libname).sym: osl.h.in
-       sed -Ene '/^int|^const/{s/.*(osl_.*)\(.*/\1/; p;}' $< > $@
-$(libname).ga: $(objects)
-       $(LD) -r -o $@ $(objects)
-lib$(libname).a: $(libname).ga $(libname).sym
-       $(OBJCOPY) --keep-global-symbols $(libname).sym $(libname).ga $@
+%.1: %.suite
+       lopsubgen --gen-man=$@ < $<
 
-osl_errors.h: errlist
-       echo '/** public error codes of the osl library. */' > $@
-       sed -e 's/\([A-Z_]*\)   .*/     E_OSL_\1/' \
-               -e '1s/^/enum osl_errors {/1' \
-               -e '1s/$$/=1/1' \
-               -e '$$!s/$$/,/g' \
-               -e '$$s/$$/};/1' $< >> $@
+$(realname): $(objects)
+       $(CC) $(OSL_LDFLAGS) $(LDFLAGS) -o $@ $(objects)
 
 errtab.h: errlist
        sed -e 's/^\([A-Z_]*\)\s*\(.*\)/OSL_ERROR(E_OSL_\1, \2)/g' $< > $@
 
-osl.h: osl.h.in osl_errors.h Makefile
+osl.h: osl.h.m4 errlist Makefile
        echo '#ifndef _OSL_H' > $@
        echo '#define _OSL_H' >> $@
-       cat osl.h.in osl_errors.h >> $@
+       $(M4) -DOUTPUT_MODE=C gendoc.m4 $< >> $@
+       echo '/** public error codes of the osl library. */' >> $@
+       sed -e 's/\([A-Z_]*\)   .*/     E_OSL_\1/' \
+               -e '1s/^/enum osl_errors {/1' \
+               -e '1s/$$/=1/1' \
+               -e '$$!s/$$/,/g' \
+               -e '$$s/$$/};/1' errlist >> $@
        echo '#endif /* _OSL_H */' >> $@
 clean:
-       rm -f *.o $(realname) osl.h osl_errors.h errtab.h fsck.cmdline.h \
-               fsck.cmdline.c oslfsck *.a *.ga *.sym
+       rm -f *.o $(realname) osl.h errtab.h oslfsck *.lsg.* *.d
 
 distclean: clean
        rm -f web/index.html web/oslfsck.1.html web/osl.png
-       rm -rf web/doxygen
 
 install-bin: $(executables)
        $(MKDIR) $(bindir)
@@ -188,25 +144,31 @@ install-man: $(man_pages)
 install-lib: $(realname) $(headers)
        $(MKDIR) $(libdir) $(includedir)
        $(RM) $(libdir)/$(linkername)
-       $(LN) -s $(libdir)/$(soname) $(libdir)/$(linkername)
+       $(LN) -s $(soname) $(libdir)/$(linkername)
        $(INSTALL) -m 755 $(realname) $(libdir)
        $(INSTALL) -m 644 $(headers) $(includedir)
 
 install: all install-bin install-man install-lib
+www: web/index.html web/osl.png web/api.html
 
-.PHONY: all clean install install-bin install-man install-lib
-
-web/%.1.html: %.1
-       man2html $< > $@
+.PHONY: all shared clean install install-bin install-man install-lib www
 
 web/osl.png: web/osl.pdf Makefile
        convert -scale 200x200 $< $@
 
-web/index.html: web/oslfsck.1.html web/index.html.in INSTALL README
-       sed -e '/@README@/,$$d' web/index.html.in > $@
-       grutatxt -nb < README >> $@
+web/index.html: oslfsck.1 web/header.html web/index.html.in INSTALL README QUICK_START
+       cat web/header.html > $@
+       sed -e '/@README@/,$$d' web/index.html.in >> $@
+       markdown < README >> $@
        sed -e '1,/@README@/d' -e '/@INSTALL@/,$$d' web/index.html.in >> $@
-       grutatxt -nb < INSTALL >> $@
-       sed -e '1,/@INSTALL@/d' -e '/@MAN_PAGE@/,$$d' web/index.html.in >> $@
-       sed -e '1,/Return to Main Contents/d' -e '/Index/,$$d' web/oslfsck.1.html >> $@
+       markdown < INSTALL >> $@
+       sed -e '1,/@INSTALL@/d' -e '/@QUICK_START@/,$$d' web/index.html.in >> $@
+       markdown < QUICK_START >> $@
+       sed -e '1,/@QUICK_START@/d' -e '/@MAN_PAGE@/,$$d' web/index.html.in >> $@
+       groff -m man -Thtml -P -l oslfsck.1 | sed -e '1,/^<body>/d; /^<\/body>/,$$d' >> $@
        sed -e '1,/@MAN_PAGE@/d' web/index.html.in >> $@
+
+web/api.html: osl.h.m4 web/header.html web/footer.html
+       cat web/header.html > $@
+       $(M4) -DOUTPUT_MODE=HTML gendoc.m4 $< >> $@
+       cat web/footer.html >> $@