Makefile readability, switch to PDF/A-1 for archival purposes

Author: simonrupf

Makefile

@@ -1,4 +1,23 @@
-.PHONY: build clean help
+# standard arguments used in all ghostscript commands
+PDF_ARGS=-sDEVICE=pdfwrite\
+         -dPDFA=1\
+         -sPDFACompatibilityPolicy=1\
+         -sColorConversionStrategy=RGB\
+         -sProcessColorModel=DeviceRGB\
+         -dNOPAUSE\
+         -dQUIET\
+         -dBATCH
+
+# these will be optimized for "screen"
+PDFS=ref/Intel\ Chips\ timeline.pdf\
+     ref/Intel\ 8085.pdf\
+     ref/MOS\ 6510.pdf
+
+# these need special treatment
+SPECIAL_PDFS=ref/Hitachi\ HD64180\ Hardware\ Manual\ 4th\ Edition.pdf\
+             ref/MOS\ MCS6500.pdf
+
+.PHONY: build clean help pdfs
 
 build: src/cpu-bitness.pdf ## Build the PDF document (default).
 
@@ -8,22 +27,29 @@ src/cpu-bitness.pdf: src/cpu-bitness.tex src/.cache/Tectonic
 src/.cache/Tectonic:
 	mkdir -p src/.cache/Tectonic
 
-ref: ref/Hitachi\ HD64180\ Hardware\ Manual\ 4th\ Edition.pdf ref/Intel\ Chips\ timeline.pdf ref/Intel\ 8085.pdf ## Create screen optimized PDFs of original reference material
+ref: pdfs ## Create screen optimized PDFs of original reference material
+
+pdfs: $(PDFS) $(SPECIAL_PDFS)
 
 ref/Hitachi\ HD64180\ Hardware\ Manual\ 4th\ Edition.pdf: ref/originals/HD64180Z\ Hardware\ Manual\ 4th\ Edition.pdf
-	gs -sDEVICE=pdfwrite -dCompatibilityLevel=1.3 -dPDFSETTINGS=/screen -dNOPAUSE -dQUIET -dBATCH -dFirstPage=2 -dLastPage=2 -sOutputFile=/tmp/HD64180-1.pdf "$<"
-	gs -sDEVICE=pdfwrite -dCompatibilityLevel=1.3 -dPDFSETTINGS=/screen -dNOPAUSE -dQUIET -dBATCH -dFirstPage=18 -dLastPage=18 -sOutputFile=/tmp/HD64180-2.pdf "$<"
-	gs -sDEVICE=pdfwrite -dCompatibilityLevel=1.3 -dPDFSETTINGS=/screen -dNOPAUSE -dQUIET -dBATCH -dFirstPage=51 -dLastPage=57 -sOutputFile=/tmp/HD64180-3.pdf "$<"
-	gs -sDEVICE=pdfwrite -dCompatibilityLevel=1.3 -dPDFSETTINGS=/screen -dNOPAUSE -dQUIET -dBATCH -dFirstPage=173 -dLastPage=182 -sOutputFile=/tmp/HD64180-4.pdf "$<"
-	gs -sDEVICE=pdfwrite -dCompatibilityLevel=1.3 -dPDFSETTINGS=/screen -dNOPAUSE -dQUIET -dBATCH -dFirstPage=220 -dLastPage=220 -sOutputFile=/tmp/HD64180-5.pdf "$<"
-	gs -sDEVICE=pdfwrite -dCompatibilityLevel=1.3 -dNOPAUSE -dQUIET -dBATCH -sOutputFile="$@" /tmp/HD64180-?.pdf
+	gs $(PDF_ARGS) -dPDFSETTINGS=/screen -dFirstPage=2   -dLastPage=2   -sOutputFile=/tmp/HD64180-1.pdf "$<"
+	gs $(PDF_ARGS) -dPDFSETTINGS=/screen -dFirstPage=18  -dLastPage=18  -sOutputFile=/tmp/HD64180-2.pdf "$<"
+	gs $(PDF_ARGS) -dPDFSETTINGS=/screen -dFirstPage=51  -dLastPage=57  -sOutputFile=/tmp/HD64180-3.pdf "$<"
+	gs $(PDF_ARGS) -dPDFSETTINGS=/screen -dFirstPage=173 -dLastPage=182 -sOutputFile=/tmp/HD64180-4.pdf "$<"
+	gs $(PDF_ARGS) -dPDFSETTINGS=/screen -dFirstPage=220 -dLastPage=220 -sOutputFile=/tmp/HD64180-5.pdf "$<"
+	gs $(PDF_ARGS) -sOutputFile="$@" /tmp/HD64180-?.pdf
 	rm /tmp/HD64180-?.pdf
 
 ref/Intel\ Chips\ timeline.pdf: ref/originals/Intel\ Chips\ timeline.pdf
-	gs -sDEVICE=pdfwrite -dCompatibilityLevel=1.6 -dPDFSETTINGS=/screen -dNOPAUSE -dQUIET -dBATCH -sOutputFile="$@" "$<"
-
 ref/Intel\ 8085.pdf: ref/originals/Intel\ 8085.pdf
-	gs -sDEVICE=pdfwrite -dCompatibilityLevel=1.3 -dPDFSETTINGS=/screen -dNOPAUSE -dQUIET -dBATCH -sOutputFile="$@" "$<"
+ref/MOS\ 6510.pdf: ref/originals/MOS\ 6510.pdf
+
+# doesn't contain OCR information and illegible with "screen" optimization
+ref/MOS\ MCS6500.pdf: ref/originals/MOS\ MCS6500.pdf
+	gs $(PDF_ARGS) -dPDFSETTINGS=/ebook -sOutputFile="$@" "$<"
+
+$(PDFS):
+	gs $(PDF_ARGS) -dPDFSETTINGS=/screen -sOutputFile="$@" "$<"
 
 clean: ## Removes the generated PDF and Tectonic cache.
 	rm -rf src/cpu-bitness.pdf .cache