mirror of https://gerrit.osmocom.org/pysim
53 lines
1.6 KiB
Makefile
53 lines
1.6 KiB
Makefile
# Minimal makefile for Sphinx documentation
|
|
#
|
|
|
|
# You can set these variables from the command line, and also
|
|
# from the environment for the first two.
|
|
SPHINXOPTS ?=
|
|
SPHINXBUILD ?= sphinx-build
|
|
SOURCEDIR = .
|
|
BUILDDIR = _build
|
|
|
|
# for osmo-gsm-manuals
|
|
OSMO_GSM_MANUALS_DIR ?= $(shell pkg-config osmo-gsm-manuals --variable=osmogsmmanualsdir 2>/dev/null)
|
|
OSMO_REPOSITORY = "pysim"
|
|
UPLOAD_FILES = $(BUILDDIR)/latex/osmopysim-usermanual.pdf
|
|
CLEAN_FILES = $(UPLOAD_FILES)
|
|
|
|
# Copy variables from Makefile.common.inc that are used in publish-html,
|
|
# as Makefile.common.inc must be included after publish-html
|
|
PUBLISH_REF ?= master
|
|
PUBLISH_TEMPDIR = _publish_tmpdir
|
|
SSH_COMMAND = ssh -o 'UserKnownHostsFile=$(OSMO_GSM_MANUALS_DIR)/build/known_hosts' -p 48
|
|
|
|
# Put it first so that "make" without argument is like "make help".
|
|
.PHONY: help
|
|
help:
|
|
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
|
|
|
|
$(BUILDDIR)/latex/pysim.pdf: latexpdf
|
|
@/bin/true
|
|
|
|
publish-html: html
|
|
rm -rf "$(PUBLISH_TEMPDIR)"
|
|
mkdir -p "$(PUBLISH_TEMPDIR)/pysim/$(PUBLISH_REF)"
|
|
cp -r "$(BUILDDIR)"/html "$(PUBLISH_TEMPDIR)/pysim/$(PUBLISH_REF)"
|
|
cd "$(PUBLISH_TEMPDIR)" && \
|
|
rsync \
|
|
-avzR \
|
|
-e "$(SSH_COMMAND)" \
|
|
"pysim" \
|
|
docs@ftp.osmocom.org:web-files/
|
|
rm -rf "$(PUBLISH_TEMPDIR)"
|
|
|
|
# put this before the catch-all below
|
|
include $(OSMO_GSM_MANUALS_DIR)/build/Makefile.common.inc
|
|
|
|
|
|
# Catch-all target: route all unknown targets to Sphinx using the new
|
|
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
|
|
%:
|
|
@if [ "$@" != "shrink" ]; then \
|
|
$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O); \
|
|
fi
|