add title pages to the catalogs, with useful information like the creation date

common/Makefile.title

@@ -0,0 +1,15 @@
+SHELL = /bin/bash
+
+COMMIT_DATE := $(shell date -u +'%F %T UTC' \
+    -d "`git show --pretty=format:'%ci' | sed q`")
+GIT_HASH := $(shell git rev-parse HEAD)
+GIT_STATUS := $(shell [ -z "`git status -s -uno`" ] || echo +)
+
+title.ps:	../common/title.fig
+		fig2dev -L ps $< | \
+		    sed -e "s|<TITLE-NAME>|$(TITLE_NAME)|" \
+			-e "s/<DATE>/`date -u +'%F %T UTC'`/" \
+		        -e "s/<HEAD-HASH>/$(GIT_HASH)$(GIT_STATUS)/" \
+		        -e "s/<HEAD-DATE>/$(COMMIT_DATE)/" \
+			-e "s|<TITLE-FILE>|$(TITLE_FILE)|" >$@; \
+		[ "$${PIPESTATUS[*]}" = "0 0" ] || { rm -f $@ exit 1; }

common/title.fig

@@ -0,0 +1,22 @@
+#FIG 3.2  Produced by xfig version 3.2.5b
+Portrait
+Center
+Metric
+A4      
+100.00
+Single
+-2
+1200 2
+4 0 0 50 -1 18 36 0.0000 4 450 4350 450 1800 <TITLE-NAME>\001
+4 0 0 50 -1 18 18 0.0000 4 285 2100 450 6075 Git repository:\001
+4 0 0 50 -1 12 18 0.0000 4 255 8100 450 6390 git://projects.qi-hardware.com/kicad-libs.git\001
+4 0 0 50 -1 18 18 0.0000 4 225 975 450 6975 HEAD:\001
+4 0 0 50 -1 12 18 0.0000 4 165 1980 450 7245 <HEAD-HASH>\001
+4 0 0 50 -1 12 18 0.0000 4 165 1980 450 7560 <HEAD-DATE>\001
+4 0 0 50 -1 18 18 0.0000 4 285 1860 450 8145 This catalog:\001
+4 0 0 50 -1 19 18 0.0000 4 285 2895 450 2250 (for use with KiCad)\001
+4 0 0 50 -1 14 18 0.0000 4 270 4140 450 4185 http://qi-hardware.com/\001
+4 0 0 50 -1 18 25 0.0000 4 315 2520 450 3825 Qi-Hardware\001
+4 0 0 50 -1 12 18 0.0000 4 255 8460 450 8460 http://downloads.qi-hardware.com/people/werner/\001
+4 0 0 50 -1 12 18 0.0000 4 255 2880 675 8775 tmp/<TITLE-FILE>\001
+4 0 0 50 -1 12 18 0.0000 4 165 1080 450 9090 <DATE>\001

components/Makefile

@@ -4,8 +4,15 @@
 # Note that we don't have the concept of a "library of everything" so far.
 #
 
+SHELL = /bin/bash
+
 GEN = gencon.lib
 
+TITLE_NAME = SYMBOLS/COMPONENTS
+TITLE_FILE = kicad-libs-components.pdf
+
+include ../common/Makefile.title
+
 .PHONY:		all sch catalog view upload missing clean spotless
 
 all:		$(GEN)
@@ -19,8 +26,9 @@ sch:		$(GEN)
 DESCR-dcm:	*.dcm
 		../scripts/dcm2desc -L . >$@ || { rm -f $@; exit 1; }
 
-catalog catalog.pdf: HIERARCHY DESCR-dcm *.lib $(GEN)
+catalog catalog.pdf: HIERARCHY DESCR-dcm *.lib $(GEN) title.ps
-		genkicat -p -L . HIERARCHY DESCR-dcm >catalog.pdf || \
+		genkicat -p -L . -t title.ps HIERARCHY DESCR-dcm \
+		  >catalog.pdf || \
 		  { rm -f catalog.pdf; exit 1; }
 
 view:		catalog.pdf
@@ -39,7 +47,7 @@ missing:	$(GEN)
 #		./mkloe
 
 clean:
-		rm -f DESCR-dcm
+		rm -f DESCR-dcm title.ps
 
 spotless:	clean
 		rm -f catalog.pdf $(GEN)

modules/Makefile

@@ -18,6 +18,13 @@ MODULES=8_10-card 8_10-socket-ra \
  	xtal-2 xtal-4 \
 	zx62-b-5pa zx62m-b-5p
 
+SHELL = /bin/bash
+
+TITLE_NAME = FOOTPRINTS/MODULES
+TITLE_FILE = kicad-libs-modules.pdf
+
+include ../common/Makefile.title
+
 .SUFFIXES:	.fpd .mod
 .PHONY:		all brd catalog view upload missing clean spotless
 
@@ -33,9 +40,9 @@ modules.pro:	Makefile
 brd:		all modules.pro
 		pcbnew `pwd`/modules.brd
 
-catalog catalog.pdf: HIERARCHY $(MODULES:%=%.fpd)
+catalog catalog.pdf: HIERARCHY $(MODULES:%=%.fpd) title.ps
-		genkicat -F -p $(MODULES:%=-l %.fpd) HIERARCHY DESCR \
+		genkicat -F -p $(MODULES:%=-l %.fpd) -t title.ps \
-		  >catalog.pdf || \
+		  HIERARCHY DESCR >catalog.pdf || \
 		  { rm -f catalog.pdf; exit 1; }
 
 view:		catalog.pdf
@@ -49,6 +56,7 @@ missing:
 
 clean:
 		rm -f *~*.fpd
+		rm -f title.ps
 
 spotless:	clean
 		rm -f $(MODULES:%=%.mod)