diff options
author | Tristan Van Berkom <tristan.vanberkom@codethink.co.uk> | 2018-06-16 14:08:33 -0400 |
---|---|---|
committer | Tristan Van Berkom <tristan.vanberkom@codethink.co.uk> | 2018-06-16 16:14:04 -0400 |
commit | 6fa3f9228d365613ee5c6b8256b3b95914cc738a (patch) | |
tree | b253307161d8be55dbd0ff7fa201e959708dfbb5 /doc/Makefile | |
parent | 1b88e2c6f0e3b060d7319e69d9ddf45bed98596f (diff) | |
download | buildstream-6fa3f9228d365613ee5c6b8256b3b95914cc738a.tar.gz |
doc/Makefile: Stage stored sessions from session-storedtristan/getting-started
Separate the revisioned provisional session html files such
that the git tree does not become dirty as a result of a
documentation build process - which messes up the docs version
number and the version number printed in some command line output.
Diffstat (limited to 'doc/Makefile')
-rw-r--r-- | doc/Makefile | 23 |
1 files changed, 18 insertions, 5 deletions
diff --git a/doc/Makefile b/doc/Makefile index 70df67184..eaef15a61 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -32,7 +32,7 @@ BST2HTMLOPTS = --force endif -.PHONY: all clean templates templates-clean sessions sessions-clean html devhelp +.PHONY: all clean templates templates-clean sessions sessions-prep sessions-clean html devhelp # Canned recipe for generating plugin api skeletons # $1 = the plugin directory @@ -84,11 +84,24 @@ templates-clean: rm -rf source/elements rm -rf source/sources -# Generate the html fragments of colorized BuildStream terminal output only -# if they don't yet exist. This is expensive so you need to run `make clean` first -# if you want to regenerate them. +# Stage the stored sessions into the place where they will +# be used in the build. # -sessions: +# This is separated so that the git tree does not become +# dirty as a result of a documentation build process - which +# messes up the docs version number and the version number +# printed in some command line output. +# +sessions-prep: + mkdir -p source/sessions + cp source/sessions-stored/*.html source/sessions + +# By default, this will generate the html fragments of colorized BuildStream terminal +# output only if they don't yet exist. +# +# Specify BST_FORCE_SESSION_REBUILD=1 to force rebuild all session html files. +# +sessions: sessions-prep for file in $(wildcard sessions/*.run); do \ $(BST2HTML) $(BST2HTMLOPTS) --description $$file; \ done |