Fix build process of PDF docs on macOS and update .gitignore

Note: the syntax of command/switch `sed -i` is slightly different
  on macOS vs. Linux and should not be used.

Move .gitignore parts referring to /documentation/ to their own file
  'documentation/.gitignore' and add new generated file(s).

.gitignore

@@ -51,42 +51,7 @@ etc/FLTKConfig.cmake
 /cairo/*.dll
 
 # /documentation/
-/documentation/.xvpics
-/documentation/blocks.0
-/documentation/blocks.6
-/documentation/blocks.z
-/documentation/checkers.0
-/documentation/checkers.6
-/documentation/checkers.z
-/documentation/Doxybook
-/documentation/Doxyfile
-/documentation/fltk.0
-/documentation/fltk.3
-/documentation/fltk-config.0
-/documentation/fltk-config.1
-/documentation/fltk-config.z
-/documentation/fltk.d
-/documentation/fltk.pdf
-/documentation/fltk.z
-/documentation/fluid.0
-/documentation/fluid.1
-/documentation/fluid.z
-/documentation/html
-/documentation/latex
-/documentation/sudoku.0
-/documentation/sudoku.6
-/documentation/sudoku.z
-/documentation/*.bck
-/documentation/*.bak
-/documentation/*.log
-
-# /documentation/src/
-/documentation/src/*.0
-/documentation/src/*.1
-/documentation/src/*.3
-/documentation/src/*.6
-/documentation/src/*.z
-/documentation/src/fltk-book.tex
+# see documentation/.gitignore
 
 # /examples/
 # see examples/.gitignore

documentation/.gitignore

@@ -0,0 +1,45 @@
+#
+# Files to be ignored by Git (do not commit)
+#
+
+# /documentation/
+.xvpics
+blocks.0
+blocks.6
+blocks.z
+checkers.0
+checkers.6
+checkers.z
+copyright.dox
+Doxybook
+Doxyfile
+fltk.0
+fltk.3
+fltk-config.0
+fltk-config.1
+fltk-config.z
+fltk.d
+fltk.pdf
+fltk.z
+fluid.0
+fluid.1
+fluid.z
+generated.dox
+html
+latex
+sudoku.0
+sudoku.6
+sudoku.z
+*.bck
+*.bak
+*.log
+
+# /documentation/src/
+src/*.0
+src/*.1
+src/*.3
+src/*.6
+src/*.z
+src/fltk-book.tex
+src/fltk-book.tex.in
+src/fltk-title.tex

documentation/Makefile

@@ -68,7 +68,7 @@ dist:	docs
 clean:
 	$(RM) Doxyfile Doxybook
 	$(RM) copyright.dox generated.dox
-	$(RM) fltk.pdf refman.pdf src/fltk-book.tex src/fltk-book.tex.in
+	$(RM) fltk.pdf refman.pdf src/fltk-title.tex src/fltk-book.tex.in src/fltk-book.tex
 	$(RMDIR) html latex
 	$(RM) *~ *.bck *.bak *.log
 	$(RM) $(MANPAGES) $(SRC_DOCDIR)/*.0
@@ -182,21 +182,24 @@ refman.pdf: $(HTMLFILES) Doxybook src/fltk-book.tex
 	$(DOXYDOC) Doxybook
 	./make_pdf
 
+src/fltk-title.tex: src/fltk-title.tex.in
+	echo "Generating $@ ..."
+	GIT_REVISION=`git rev-parse --short=10 HEAD`; \
+	sed -e"s/@GIT_REVISION@/$$GIT_REVISION/g" \
+	    < $< > $@
+
+src/fltk-book.tex.in: src/fltk-title.tex
+	echo "Generating $@ ..."
+	./make_header $< $@
+
 src/fltk-book.tex: src/fltk-book.tex.in
 	echo "Generating $@ ..."
 	DOXY_VERSION=`$(DOXYDOC) --version|cut -f1 -d' '`; \
 	YEAR=`date +%Y`; \
 	sed -e"s/@YEAR@/$$YEAR/g" \
 	    -e"s/@FLTK_VERSION@/$(FLTK_VERSION)/g" \
 	    -e"s/@DOXY_VERSION@/$$DOXY_VERSION/g" \
-	< $< > $@
-
-src/fltk-book.tex.in: src/fltk-title.tex.in
-	echo "Generating $@ ..."
-	GIT_REVISION=`git rev-parse --short=10 HEAD`; \
-	./make_header $< $@; \
-	sed -i -e"s/@GIT_REVISION@/$$GIT_REVISION/g" $@
-
+	    < $< > $@
 
 generated.dox: generated.dox.in
 	echo "Generating $@ ..."