[PATCH 0/5] Misc updates in Makefile and FAQ-BUILD.txt

[PATCH 0/5] Misc updates in Makefile and FAQ-BUILD.txt

[Akira Yokosawa]

From 9a745e15ae38e8cfc329a365f2ff28112a19a5c3 Mon Sep 17 00:00:00 2001
From: Akira Yokosawa <akiyks@gmail.com>
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(-)

-- 
2.7.4

[PATCH 1/5] Makefile: Update help message

[Akira Yokosawa]

From 59863c5f0cbff34e90a1cbbea671f47d70c750a2 Mon Sep 17 00:00:00 2001
From: Akira Yokosawa <akiyks@gmail.com>
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.

Signed-off-by: Akira Yokosawa <akiyks@gmail.com>
---
 FAQ-BUILD.txt | 1 +
 Makefile      | 6 +++---
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/FAQ-BUILD.txt b/FAQ-BUILD.txt
index e277d95..8b0e8aa 100644
--- a/FAQ-BUILD.txt
+++ b/FAQ-BUILD.txt
@@ -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"?
diff --git a/Makefile b/Makefile
index 4167e20..9ac521c 100644
--- a/Makefile
+++ b/Makefile
@@ -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:
-- 
2.7.4

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

[Akira Yokosawa]

From 1300fe2c5c51e4427c3e3a19b303e346dda73fd9 Mon Sep 17 00:00:00 2001
From: Akira Yokosawa <akiyks@gmail.com>
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.

Signed-off-by: Akira Yokosawa <akiyks@gmail.com>
---
 FAQ-BUILD.txt | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/FAQ-BUILD.txt b/FAQ-BUILD.txt
index 8b0e8aa..ea2c57f 100644
--- a/FAQ-BUILD.txt
+++ b/FAQ-BUILD.txt
@@ -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?

-- 
2.7.4

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

[Akira Yokosawa]

From 37b458d896098180c42291fc05467ca33ce00609 Mon Sep 17 00:00:00 2001
From: Akira Yokosawa <akiyks@gmail.com>
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.

Signed-off-by: Akira Yokosawa <akiyks@gmail.com>
---
 FAQ-BUILD.txt | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/FAQ-BUILD.txt b/FAQ-BUILD.txt
index ea2c57f..e0ae289 100644
--- a/FAQ-BUILD.txt
+++ b/FAQ-BUILD.txt
@@ -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
-- 
2.7.4

[PATCH 4/5] Makefile: Use latexpand instead of texexpand

[Akira Yokosawa]

From 0e99d58218ee3552fa583eb0035e32b53265b667 Mon Sep 17 00:00:00 2001
From: Akira Yokosawa <akiyks@gmail.com>
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

Signed-off-by: Akira Yokosawa <akiyks@gmail.com>
---
 Makefile | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/Makefile b/Makefile
index 9ac521c..a208920 100644
--- a/Makefile
+++ b/Makefile
@@ -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 > $@
-- 
2.7.4

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

[Akira Yokosawa]

From 9a745e15ae38e8cfc329a365f2ff28112a19a5c3 Mon Sep 17 00:00:00 2001
From: Akira Yokosawa <akiyks@gmail.com>
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.

Signed-off-by: Akira Yokosawa <akiyks@gmail.com>
---
 FAQ-BUILD.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/FAQ-BUILD.txt b/FAQ-BUILD.txt
index e0ae289..bf81a85 100644
--- a/FAQ-BUILD.txt
+++ b/FAQ-BUILD.txt
@@ -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.
-- 
2.7.4

Re: [PATCH 0/5] Misc updates in Makefile and FAQ-BUILD.txt

[Paul E. McKenney]

On Wed, May 02, 2018 at 01:14:24PM +0900, Akira Yokosawa wrote:
> >From 9a745e15ae38e8cfc329a365f2ff28112a19a5c3 Mon Sep 17 00:00:00 2001
> From: Akira Yokosawa <akiyks@gmail.com>
> 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.

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

							Thanx, Paul

>         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(-)
> 
> -- 
> 2.7.4
>