Skip to contentSkip to conversation

Misc updates in Makefile and FAQ-BUILD.txt

PATCH In review Akira Yokosawa 2 participants 7 messages May 2, 2018 Kbuild

lore
Share & tools
lore
#0 lore raw

cover Misc updates in Makefile and FAQ-BUILD.txt

From 9a745e15ae38e8cfc329a365f2ff28112a19a5c3 Mon Sep 17 00:00:00 2001
From: Akira Yokosawa <[email protected]>
Date: Wed, 2 May 2018 12:31:27 +0900
Subject: [PATCH 0/5] Misc updates in Makefile and FAQ-BUILD.txt

Hi Paul,

This patch set is the result of trying Ubuntu Bionic to build perfbook.

One major issue is the incompatibility of a2ping 2.77p and Ghostscript 9.22. You need a2ping 2.83p which is upstream at
https://www.ctan.org/pkg/a2ping.

a2ping is basically a perl script, so you can easily use the latest one by putting it in your local bin directory.

Other changes in this set are fixes and modifications I made while testing on Ubuntu Bionic. The updated Makefile is tested on Ubuntu Trusty, Ubuntu Xenial, Ubuntu Bionic, Fedora 26, and Fedora 27.

Patch #1 updates message of "make help".
Patch #2 adds entry on a2ping compatibility issue in FAQ-BUILD.txt. Patch #3 adds note on Ubuntu Bionic.
Patch #4 employs "latexpand" of TeX Live instead of "texexpand". This frees us from dependency on latex2html package.

Patch #5 updates FAQ-BUILD.txt accordingly.

Thanks, Akira
--
Akira Yokosawa (5):
Makefile: Update help message
FAQ-BUILD: Add entry on compatibility of a2ping and Ghostscript
FAQ-BUILD: Add note on Ubuntu Bionic
Makefile: Use latexpand instead of texexpand
FAQ-BUILD: Remove latex2html in package list

 FAQ-BUILD.txt | 27 +++++++++++++++++++++++----
 Makefile      | 12 ++++++------
 2 files changed, 29 insertions(+), 10 deletions(-)
Signature · 1 line
2.7.4
#1 lore raw

PATCH 1/5 Makefile: Update help message

From 59863c5f0cbff34e90a1cbbea671f47d70c750a2 Mon Sep 17 00:00:00 2001
From: Akira Yokosawa <[email protected]>
Date: Sun, 15 Apr 2018 20:07:46 +0900
Subject: [PATCH 1/5] Makefile: Update help message

Fix typo and out-of-date dependency info displayed by "make help". Also move target "perfbook-tcb" under "Experimental targets:".

Also mention "make help" in FAQ-BUILD.txt.

---
 FAQ-BUILD.txt | 1 +
 Makefile      | 6 +++---
 2 files changed, 4 insertions(+), 3 deletions(-)
FAQ-BUILD.txt +1 -0
index e277d95..8b0e8aa 100644
@@ -17,6 +17,7 @@
 	A.	"make hb" will build perfbook-hb.pdf that is useful
 		for making hard-bound printouts.
 		"make 2c" will build perfbook.pdf.
+		"make help" will show you the full list of targets.
 
 4.	Isn't it possible to build perfbook-1c.pdf by just typing
 	"make"?
Makefile +3 -3
index 4167e20..9ac521c 100644
@@ -221,12 +221,12 @@ help:
 	@echo "Official targets (Latin Modern Typewriter for monospace font):"
 	@echo "  Full,              Abbr."
 	@echo "  perfbook.pdf,      2c:   (default) 2-column layout"
-	@echo "  perfbook-tcb,      tct:  2-column layout with table caption at bottom"
 	@echo "  perfbook-1c.pdf,   1c:   1-column layout"
 	@echo "  perfbook-hb.pdf,   hb:   For hardcover books (2-column)"
 	@echo
 	@echo "Experimental targets:"
 	@echo "  Full,              Abbr."
+	@echo "  perfbook-tcb,      tcb:  2c with table caption at bottom (prev default)"
 	@echo "  perfbook-msnt.pdf, msnt: 2c with newtxtt as monospace (non-slashed 0)"
 	@echo "  perfbook-mstx.pdf, mstx: 2c with txtt as monospace"
 	@echo "  perfbook-msr.pdf,  msr:  2c with regular thickness courier clone"
@@ -238,9 +238,9 @@ help:
 	@echo "  \"msnt\" requires \"newtxtt\". \"mstx\" is fallback target for older TeX env."
 	@echo "  \"msr\" and \"msn\" require \"nimbus15\"."
 	@echo "  \"msn\" doesn't cover bold face for monospace."
-	@echo "  \"1csf\" requires recent version (>=1.3i) of \"mathastext\"."
+	@echo "  \"1csf\" requires \"newtxsf\"."
 	@echo
-	@echo "All targets except for \"msns\" and \"mss\" use \"Latin Modern Typewriter font"
+	@echo "All targets except for \"msns\" and \"mss\" use \"Latin Modern Typewriter\" font"
 	@echo "for code snippets."
 
 clean:
Signature · 1 line
2.7.4
#2 lore raw

PATCH 2/5 FAQ-BUILD: Add entry on compatibility of a2ping and Ghostscript

In reply to Akira Yokosawa

From 1300fe2c5c51e4427c3e3a19b303e346dda73fd9 Mon Sep 17 00:00:00 2001
From: Akira Yokosawa <[email protected]>
Date: Sun, 15 Apr 2018 20:15:16 +0900
Subject: [PATCH 2/5] FAQ-BUILD: Add entry on compatibility of a2ping and Ghostscript

a2ping 2.77p is not compatible to Ghostscript 9.22 or later.

---
 FAQ-BUILD.txt | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)
FAQ-BUILD.txt +11 -2
index 8b0e8aa..ea2c57f 100644
@@ -74,7 +74,16 @@
 
 	A.	Please see #5 above.
 
-7.	When I try to build perfbook, it hangs after printing a line
+7.	I cannot build perfbook, neither can I find perfbook.log.
+	What am I missing?
+
+	A.	Updating a2ping can resolve the build error if you
+		have Ghostscript 9.22 or later.  Compatible a2ping
+		(2.83p) is available at:
+			https://www.ctan.org/pkg/a2ping
+		It is included in TeX Live 2018 or later.
+
+8.	When I try to build perfbook, it hangs after printing a line
 	reading "pdflatex 1".  How can I fix this?
 
 	A.	On UNIX-like systems, including Linux, type control-D.
@@ -88,7 +97,7 @@
 		perfbook.log output (or perfbook-1c.log output, depending
 		on which you were building) so that I can fix the scripts.
 
-8.	Some of experimental targets for alternative font won't build
+9.	Some of experimental targets for alternative font won't build
 	due to lack of necessary packages such as "newtxtt". How can I
 	install those packages?
 
Signature · 1 line
2.7.4
#3 lore raw

PATCH 3/5 FAQ-BUILD: Add note on Ubuntu Bionic

In reply to Akira Yokosawa

From 37b458d896098180c42291fc05467ca33ce00609 Mon Sep 17 00:00:00 2001
From: Akira Yokosawa <[email protected]>
Date: Sat, 28 Apr 2018 00:55:58 +0900
Subject: [PATCH 3/5] FAQ-BUILD: Add note on Ubuntu Bionic

Ubuntu Bionic has incompatible combination of a2ping (2.77p) and Ghostscript (9.22) at the moment.
It also has slightly different texlive packages from Ubuntu Xenial.

---
 FAQ-BUILD.txt | 9 +++++++++
 1 file changed, 9 insertions(+)
FAQ-BUILD.txt +9 -0
index ea2c57f..e0ae289 100644
@@ -47,6 +47,15 @@
 		On Ubuntu Trusty, in addition to the above, you need:
 			texlive-humanities
 
+		On Ubuntu Bionic, the following list should cover
+		necessary packages (except for -doc packages):
+			texlive-publishers texlive-pstricks
+			texlive-science texlive-fonts-extra
+			latex2html xfig inkscape graphviz fig2ps
+
+		You might need to fetch a version of a2ping which is
+		compatible with Ghostscript 9.22. See #7 below.
+
 		On Fedora 26, installing the following set of packages
 		suffices:
 			texlive-a2ping fig2ps graphviz inkscape latex2html
Signature · 1 line
2.7.4
#4 lore raw

PATCH 4/5 Makefile: Use latexpand instead of texexpand

In reply to Akira Yokosawa

From 0e99d58218ee3552fa583eb0035e32b53265b667 Mon Sep 17 00:00:00 2001
From: Akira Yokosawa <[email protected]>
Date: Mon, 30 Apr 2018 23:43:15 +0900
Subject: [PATCH 4/5] Makefile: Use latexpand instead of texexpand

latexpand of TeX Live [1] works similarly as texexpand. By this change, latex2html package becomes unnecessary for building perfbook.

While we are here, straighten dependency of autodate.tex and perfbook_flat.tex.

NOTE: Irrelevant warnings from latexpand are redirected to /dev/null.

[1]: https://www.ctan.org/pkg/latexpand

---
 Makefile | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)
Makefile +3 -3
index 9ac521c..a208920 100644
@@ -101,14 +101,14 @@ $(PDFTARGETS:.pdf=.bbl): %.bbl: %.aux $(BIBSOURCES)
 $(PDFTARGETS:.pdf=.aux): $(LATEXGENERATED) $(LATEXSOURCES)
 	sh utilities/runfirstlatex.sh $(basename $@)
 
-autodate.tex: $(LATEXSOURCES) $(BIBSOURCES) $(SVGSOURCES) $(FIGSOURCES) $(DOTSOURCES)
+autodate.tex: perfbook.tex $(LATEXSOURCES) $(BIBSOURCES) $(SVGSOURCES) $(FIGSOURCES) $(DOTSOURCES) $(EPSORIGIN)
 	sh utilities/autodate.sh >autodate.tex
 
-perfbook_flat.tex: perfbook.tex $(LATEXSOURCES) $(PDFTARGETS_OF_EPS) $(TARGETS_OF_SVG)
+perfbook_flat.tex: autodate.tex $(PDFTARGETS_OF_EPS) $(TARGETS_OF_SVG)
 	echo > qqz.tex
 	echo > contrib.tex
 	echo > origpub.tex
-	texexpand perfbook.tex > $@
+	latexpand --empty-comments perfbook.tex 1> $@ 2> /dev/null
 
 qqz.tex: perfbook_flat.tex
 	sh utilities/extractqqz.sh < $< | perl utilities/qqzreorder.pl > $@
Signature · 1 line
2.7.4
#5 lore raw

PATCH 5/5 FAQ-BUILD: Remove latex2html in package list

In reply to Akira Yokosawa

From 9a745e15ae38e8cfc329a365f2ff28112a19a5c3 Mon Sep 17 00:00:00 2001
From: Akira Yokosawa <[email protected]>
Date: Mon, 30 Apr 2018 23:50:23 +0900
Subject: [PATCH 5/5] FAQ-BUILD: Remove latex2html in package list

Update lists for distributions still supported.

---
 FAQ-BUILD.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)
FAQ-BUILD.txt +3 -3
index e0ae289..bf81a85 100644
@@ -41,7 +41,7 @@
 			texlive-latex-base texlive-latex-extra psutils
 			texlive-publishers-doc texlive-fonts-extra
 			texlive-math-extra texlive-publishers
-			texlive-science texlive-bibtex-extra latex2html
+			texlive-science texlive-bibtex-extra
 			gnuplot-x11 xfig inkscape graphviz fig2ps
 
 		On Ubuntu Trusty, in addition to the above, you need:
@@ -51,14 +51,14 @@
 		necessary packages (except for -doc packages):
 			texlive-publishers texlive-pstricks
 			texlive-science texlive-fonts-extra
-			latex2html xfig inkscape graphviz fig2ps
+			xfig inkscape graphviz fig2ps
 
 		You might need to fetch a version of a2ping which is
 		compatible with Ghostscript 9.22. See #7 below.
 
 		On Fedora 26, installing the following set of packages
 		suffices:
-			texlive-a2ping fig2ps graphviz inkscape latex2html
+			texlive-a2ping fig2ps graphviz inkscape
 			texlive-collection-latexextra
 
 		Other systems might provide similarly named packages.
Signature · 1 line
2.7.4
#6 lore raw
In reply to Akira Yokosawa
Quoted 21 lines · Akira Yokosawa
Quoted 1 line

From 9a745e15ae38e8cfc329a365f2ff28112a19a5c3 Mon Sep 17 00:00:00 2001

From: Akira Yokosawa <[email protected]>
Date: Wed, 2 May 2018 12:31:27 +0900
Subject: [PATCH 0/5] Misc updates in Makefile and FAQ-BUILD.txt

Hi Paul,

This patch set is the result of trying Ubuntu Bionic to build perfbook.

One major issue is the incompatibility of a2ping 2.77p and Ghostscript 9.22. You need a2ping 2.83p which is upstream at
https://www.ctan.org/pkg/a2ping.

a2ping is basically a perl script, so you can easily use the latest one by putting it in your local bin directory.

Other changes in this set are fixes and modifications I made while testing on Ubuntu Bionic. The updated Makefile is tested on Ubuntu Trusty, Ubuntu Xenial, Ubuntu Bionic, Fedora 26, and Fedora 27.

Quoted 7 lines

Patch #1 updates message of "make help".
Patch #2 adds entry on a2ping compatibility issue in FAQ-BUILD.txt. Patch #3 adds note on Ubuntu Bionic.
Patch #4 employs "latexpand" of TeX Live instead of "texexpand". This frees us from dependency on latex2html package.

Patch #5 updates FAQ-BUILD.txt accordingly.

Very nice!!! Applied and pushed, thank you!!!

Thanx, Paul

Quoted 16 lines

Thanks, Akira
--
Akira Yokosawa (5):
Makefile: Update help message
FAQ-BUILD: Add entry on compatibility of a2ping and Ghostscript
FAQ-BUILD: Add note on Ubuntu Bionic
Makefile: Use latexpand instead of texexpand
FAQ-BUILD: Remove latex2html in package list

 FAQ-BUILD.txt | 27 +++++++++++++++++++++++----
 Makefile      | 12 ++++++------
 2 files changed, 29 insertions(+), 10 deletions(-)
Signature · 1 line
2.7.4