Documentation fixes and revamp user guide

[ric-plt/lib/rmr.git] / doc / src / library / Makefile

diff --git a/doc/src/library/Makefile b/doc/src/library/Makefile
index ffa8a51..09f1192 100644 (file)
--- a/doc/src/library/Makefile
+++ b/doc/src/library/Makefile
@@ -1,4 +1,3 @@
-
 #==================================================================================
 #      Copyright (c) 2019 Nokia
 #      Copyright (c) 2018-2019 AT&T Intellectual Property.
@@ -16,14 +15,16 @@
 #   limitations under the License.
 #==================================================================================
 
+# most things here require a two pass build, but these might be useful
+
 %.ps: %.xfm
        pfm $< $@
 
 %.md: %.xfm
-       OUTPUT_TYPE=markdown tfm $< stdout | sed 's/^ //' >$@   
+       OUTPUT_TYPE=markdown tfm $< stdout | sed 's/^ //' >$@
 
 %.rst: %.xfm
-       OUTPUT_TYPE=rst tfm $< stdout | sed 's/^ //' >$@        
+       OUTPUT_TYPE=rst tfm $< stdout | sed 's/^ //' >$@
 
 %.txt: %.xfm
        OUTPUT_TYPE=txt tfm  $< stdout
@@ -32,6 +33,7 @@
 %.pdf: %.ps
        gs -dQUIET -dBATCH -dNOPAUSE -sDEVICE=pdfwrite -sOutputFile=$@ $<
 
+
 src = user.xfm advanced_use.im api_qref.im code_appendix.im code_send.im config.im failures.im general_use.im glossary.im index_snatch.im setup.im mbuf.im front_junk.im license.im
 code_src = $(shell ls code_*.im)
 
@@ -44,11 +46,11 @@ user.ps: $(src) $(code_src)
 
 user.md: $(src) $(code_src)
        OUTPUT_TYPE=markdown XFM_PASS=1 tfm $< /dev/null
-       OUTPUT_TYPE=markdown XFM_PASS=2 tfm $< $@
+       OUTPUT_TYPE=markdown XFM_PASS=2 tfm $< | sed 's/^ //' >$@
 
 user.rst: $(src) $(code_src)
        OUTPUT_TYPE=rst XFM_PASS=1 tfm $< /dev/null
-       OUTPUT_TYPE=rst XFM_PASS=2 tfm $< $@
+       GEN_TITLE=1 OUTPUT_TYPE=rst XFM_PASS=2 tfm $< | sed 's/^ //' >$@
 
 user.txt: $(src) $(code_src)
        OUTPUT_TYPE=txt XFM_PASS=1 tfm $< /dev/null