X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=doc%2Fsrc%2Frtd%2FMakefile;h=a714e6ac10db9b2b507990a36a2bbe6edd6274b9;hb=refs%2Ftags%2F1.13.1;hp=4c64278f7b3cb9e96d4c9004d29b677fa3eff8c5;hpb=b7a4b52f73d51db6077d2c0b56be262c36f472f7;p=ric-plt%2Flib%2Frmr.git diff --git a/doc/src/rtd/Makefile b/doc/src/rtd/Makefile index 4c64278..a714e6a 100644 --- a/doc/src/rtd/Makefile +++ b/doc/src/rtd/Makefile @@ -36,11 +36,20 @@ docs = config-deploy developer-guide user-guide rel-notes overview -all:: $(docs:%=%.rst) $(docs:%=%.txt) $(docs:%=%.md) +all:: $(docs:%=%.rst) $(docs:%=%.txt) $(docs:%=%.md) -rel-notes.xfm: +rel-notes.xfm: ../../../CHANGES 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) for f in *.rst;\ @@ -51,6 +60,16 @@ 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 @@ -59,3 +78,5 @@ clean: nuke: clean rm -f *.ps *.pdf *.rst *.md +# make hack to force a rule to always be out of date +always: