X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=doc%2Fsrc%2Frtd%2FMakefile;h=f3fbf41ace19a5d5ba93d03364b9b0814082c291;hb=117030c67f7a3722e64f1ecc3305a5862b3b7ce9;hp=7e49946a2a9458685b7f33af06af2ce670f016ad;hpb=392168d467d7949f391602f53f9fd62d2a64d12b;p=ric-plt%2Flib%2Frmr.git diff --git a/doc/src/rtd/Makefile b/doc/src/rtd/Makefile index 7e49946..f3fbf41 100644 --- a/doc/src/rtd/Makefile +++ b/doc/src/rtd/Makefile @@ -22,28 +22,41 @@ # {X}fm is required to compile the source. -%.rst:: %.xfm +%.rst:: %.xfm man_list.im OUTPUT_TYPE=rst tfm $< | sed 's/^ //' >$@ -%.ps:: %.xfm +%.ps:: %.xfm man_list.im OUTPUT_TYPE=ps pfm $< $@ -%.txt:: %.xfm +%.txt:: %.xfm man_list.im OUTPUT_TYPE=txt tfm $< $@ -%.md:: %.xfm +%.md:: %.xfm man_list.im OUTPUT_TYPE=markdown tfm $< | sed 's/^ //' >$@ docs = config-deploy developer-guide user-guide rel-notes overview -all:: $(docs:%=%.rst) $(docs:%=%.txt) $(docs:%=%.md) - echo ">>> rm rel-notes.xfm" +all:: $(docs:%=%.rst) $(docs:%=%.txt) $(docs:%=%.md) -rel-notes.xfm: +man_list.im:: always + bash gen_man_list.sh >man_list.im + +rel-notes.xfm:: always ksh fmt_changes.ksh >rel-notes.xfm + +# we force the docs to always be out of date so that we don't have to +# manage the list of man pages and other files that are read to generate the +# output needed for RTD. +# +$(docs:%=%.rst): always +$(docs:%=%.txt): always +$(docs:%=%.md): always + + # copy the .rst files which have changed into the docs (plural) directory at the root of the repo publish : $(docs:%=%.rst) + bash publish_man.sh;\ for f in *.rst;\ do\ if ! diff -N -q $$f ../../../docs/$$f >/dev/null 2>&1;\ @@ -52,11 +65,23 @@ publish : $(docs:%=%.rst) fi;\ done +# just list what would be published +verify : $(docs:%=%.rst) + for f in *.rst;\ + do\ + if ! diff -N -q $$f ../../../docs/$$f >/dev/null 2>&1;\ + then\ + echo "$$f would be published";\ + fi;\ + done + # ditch any intermediate files clean: rm -f rel-notes.xfm *.sp *.ca # ditch anything that can be rebuilt nuke: clean - rm -f *.ps *.pdf *.rst *.md + rm -f *.ps *.pdf *.rst *.md *.txt +# make hack to force a rule to always be out of date +always: