From c394c854f46036fd6680afd600e44d9f47f1ceac Mon Sep 17 00:00:00 2001
From: Philippe Pittoli <karchnu@karchnu.fr>
Date: Sun, 5 Feb 2023 07:03:58 +0100
Subject: [PATCH] Presentation: explain how to display it.

---
 docs/libipc.md     |  6 ++++--
 docs/makefile      | 29 +++++++++++++++++++++++++++++
 docs/pres/makefile | 10 ----------
 3 files changed, 33 insertions(+), 12 deletions(-)
 create mode 100644 docs/makefile
 delete mode 100644 docs/pres/makefile

diff --git a/docs/libipc.md b/docs/libipc.md
index e00d594..1352316 100644
--- a/docs/libipc.md
+++ b/docs/libipc.md
@@ -1,7 +1,9 @@
 ## Before starting
 
-This file is a presentation.
-Better get the point tools here: https://git.baguette.netlib.re/Baguette/pointtools
+This file is a presentation based on the point tools:
+https://git.baguette.netlib.re/Baguette/pointtools
+
+To see it, type 'make'.
 
 TODO: Explain the problem
 TODO: Explain the solution
diff --git a/docs/makefile b/docs/makefile
new file mode 100644
index 0000000..19cbd25
--- /dev/null
+++ b/docs/makefile
@@ -0,0 +1,29 @@
+all: get-point-tools clean generate display
+
+BAGUETTE=https://git.baguette.netlib.re/Baguette
+get-point-tools:
+	@test -d catpoint || (git clone $(BAGUETTE)/catpoint.git && cd catpoint && make)
+	@test -d pointtools || (git clone $(BAGUETTE)/pointtools.git && cd pointtools && make)
+
+CATPOINT = $(PWD)/catpoint/catpoint
+MD2POINT = $(PWD)/pointtools/bin/md2point
+PRESENTATION = $(PWD)/libipc.md
+
+BDIR=tmp
+clean:
+	@-rm $(BDIR)/*.txt 2>/dev/null || true
+
+generate:
+	@cd $(BDIR) && (cat $(PRESENTATION) | $(MD2POINT))
+
+display:
+	@cd $(BDIR) && $(CATPOINT) *.txt
+
+help:
+	@echo "get-point-tools: get all relevant point tools (catpoint and md2point)"
+	@echo
+	@echo "generate: convert markdown into 'point' documents"
+	@echo "display:  run catpoint on all 'point' document"
+	@echo "clean:    remove all 'point' files"
+	@echo
+	@echo "By default: get point tools, generate then display the presentation"
diff --git a/docs/pres/makefile b/docs/pres/makefile
deleted file mode 100644
index 80b549a..0000000
--- a/docs/pres/makefile
+++ /dev/null
@@ -1,10 +0,0 @@
-all: clean generate display
-
-clean:
-	-rm ./*.txt 2>/dev/null || true
-
-generate:
-	cat ../libipc.md | md2point
-
-display:
-	catpoint *.txt