refactored the doc generator...

Signed-off-by: Alex A. Naanou <alex.nanou@gmail.com>

Makefile

@@ -1,6 +1,11 @@
 #----------------------------------------------------------------------
 
+# NOTE: this makes things run consistently on different systems including 
+# 		things like Android...
+SHELL := bash
 
+
+# LaTeX...
 ARGS :=
 
 # NOTE: need to run latex two times to build index, the simpler way to 
@@ -10,34 +15,8 @@ ARGS :=
 TEX := latexmk -lualatex $(ARGS)
 
 
-
+# Doc generator...
-#----------------------------------------------------------------------
+DOC := ./scripts/cls2tex.sh
-
-# Generate docs from latex package/class...
-#
-# 	- keep lines starting with \def\<module-name>@[A-Z]\+
-# 	- keep lines starting with '%%'
-# 	- %%%%% Text -> \subsection(Text)
-# 	- %%%% Text -> \section(Text)
-# 	- %% >> code -> \begin{verbatim}code\end{verbatim}
-#
-# NOTE: the idea of keeping latex docs in a latex file is far similar 
-# 		than all the stuff crammed into .dtx, at least for my needs:
-# 			- keep the code readable
-# 			- keep the docs readable
-# 		in both the repo and in installed form.
-# NOTE: this is evolving as need arises, when this gets too complicated 
-# 		we'll split it out into it's own script.
-# 		
-# XXX BUG: for some odd reason this produces different results when called 
-# 		from 'bash' and 'bash --login -i', mainly the egrep rule seems 
-# 		to be broken...
-# 		...also appears to be broken under termux...
-# 		.....seems that moving this out to a script would be the simplest way
-# 		to solve this odd instability...
-texToDoc = \
-	@echo "texToDoc: $1 -> $2"; \
-	./scripts/cls2tex.sh $1 $2 $3
 
 
 
@@ -50,19 +29,19 @@ texToDoc = \
 # NOTE: .sty and .cls are essentially the same in terms of documentation 
 # 		generation...
 %.tex: %.sty %-meta.tex
-	$(call texToDoc,$<,$@,%)
+	$(DOC) $< $@
 
 %.tex: %.cls %-meta.tex
-	$(call texToDoc,$<,$@,%)
+	$(DOC) $< $@
 
 
 # NOTE: this is a bit ugly, but allot less so than trying to push \verb
 # 		into a LaTeX macro/env and then getting it out again in one pice...
 %-meta.tex: %.sty
-	$(call texToDoc,$<,$@,M)
+	$(DOC) $< $@ M
 
 %-meta.tex: %.cls
-	$(call texToDoc,$<,$@,M)
+	$(DOC) $< $@ M
 
 
 

scripts/cls2tex.sh

@@ -1,13 +1,41 @@
 #!/usr/bin/env bash
 
-# usage: cls2tex.sh INPUT OUTPUT PREFIX
+# Generate docs from latex package/class...
+#
+# Usage: cls2tex.sh INPUT OUTPUT [PREFIX]
+#
+# 	- keep lines starting with \def\<module-name>@[A-Z]\+
+# 	- keep lines starting with '%%'
+# 	- %%%%% Text -> \subsection(Text)
+# 	- %%%% Text -> \section(Text)
+# 	- %% >> code -> \begin{verbatim}code\end{verbatim}
+#
+# NOTE: the idea of keeping latex docs in a latex file is far similar 
+# 		than all the stuff crammed into .dtx, at least for my needs:
+# 			- keep the code readable
+# 			- keep the docs readable
+# 		in both the repo and in installed form.
+# NOTE: this is evolving as need arises, when this gets too complicated 
+# 		we'll split it out into it's own script.
 
-cat $1 \
+INPUT=$1
-	| egrep '(^%'$3'|^\\edef\\.*@[A-Z][A-Z]+)' \
-	| sed 's/^\(\\edef\\\).*@/%'$3'\1/' \
-	| sed 's/%'$3'%%%% \(.*\)/%'$3'\\subsubsection{\1}\\label{subsubsec:\1}/' \
-	| sed 's/%'$3'%%% \(.*\)/%'$3'\\subsection{\1}\\label{subsec:\1}/' \
-	| sed 's/%'$3'%% \(.*\)/%'$3'\\section{\1}\\label{sec:\1}/' \
-	| sed 's/%'$3'\s\+>>\s\+\(.*\)/%'$3'\\begin{verbatim} \1 \\end{verbatim}/' \
-	| cut -c 3- - > $2
 
+OUTPUT=$2
+
+PREFIX=$3
+if [ -z $PREFIX ] ; then
+	PREFIX=%
+fi
+
+
+cat "$INPUT" \
+	| egrep '(^%'$PREFIX'|^\\edef\\.*@[A-Z][A-Z]+)' \
+	| sed 's/^\(\\edef\\\).*@/%'$PREFIX'\1/' \
+	| sed 's/%'$PREFIX'%%%% \(.*\)/%'$PREFIX'\\subsubsection{\1}\\label{subsubsec:\1}/' \
+	| sed 's/%'$PREFIX'%%% \(.*\)/%'$PREFIX'\\subsection{\1}\\label{subsec:\1}/' \
+	| sed 's/%'$PREFIX'%% \(.*\)/%'$PREFIX'\\section{\1}\\label{sec:\1}/' \
+	| sed 's/%'$PREFIX'\s\+>>\s\+\(.*\)/%'$PREFIX'\\begin{verbatim} \1 \\end{verbatim}/' \
+	| cut -c 3- - > "$OUTPUT"
+
+
+# vim:set ts=4 sw=4 nowrap :