X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=doc%2Fsrc%2Frtd%2FMakefile;h=6ef174341200c86dd05217497c7c45580459868b;hb=refs%2Ftags%2F4.8.5;hp=a714e6ac10db9b2b507990a36a2bbe6edd6274b9;hpb=190665fe57168a4b9d544b88d3f69797f258c04c;p=ric-plt%2Flib%2Frmr.git diff --git a/doc/src/rtd/Makefile b/doc/src/rtd/Makefile index a714e6a..6ef1743 100644 --- a/doc/src/rtd/Makefile +++ b/doc/src/rtd/Makefile @@ -19,11 +19,11 @@ # This is a stand-alone make file as the RTD documentation is NOT built and packaged # with the normal CMake process and thus isn't covered in the CMake files. -# {X}fm is required to compile the source. +# {X}fm is required to compile the source. %.rst:: %.xfm - OUTPUT_TYPE=rst tfm $< | sed 's/^ //' >$@ + OUTPUT_TYPE=rst tfm $< | sed 's/^ //; s/ *$$//' >$@ %.ps:: %.xfm OUTPUT_TYPE=ps pfm $< $@ @@ -34,13 +34,17 @@ %.md:: %.xfm OUTPUT_TYPE=markdown tfm $< | sed 's/^ //' >$@ -docs = config-deploy developer-guide user-guide rel-notes overview +%.html:: %.xfm + OUTPUT_TYPE=html hfm $< $@ + +docs = config-deploy developer-guide rel-notes all:: $(docs:%=%.rst) $(docs:%=%.txt) $(docs:%=%.md) -rel-notes.xfm: ../../../CHANGES +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. @@ -48,15 +52,19 @@ rel-notes.xfm: ../../../CHANGES $(docs:%=%.rst): always $(docs:%=%.txt): always $(docs:%=%.md): always +$(docs:%=%.html): 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;\ + bash publish_lib.sh;\ + bash scrape_types.sh;\ for f in *.rst;\ do\ if ! diff -N -q $$f ../../../docs/$$f >/dev/null 2>&1;\ then\ - cp -p $$f ../../../docs/;\ + sed 's/ *$$//' $$f >../../../docs/$${f##*/};\ fi;\ done @@ -70,13 +78,16 @@ verify : $(docs:%=%.rst) fi;\ done +test: + bash publish_lib.sh; + # 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: