<p>laforge has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.osmocom.org/c/pysim/+/23714">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">contrib/jenkins.sh: Build and publish PDF manual<br><br>Change-Id: I3f01e93dd5a25d26feb3d067a171244a20f0f8e5<br>---<br>M contrib/jenkins.sh<br>M docs/Makefile<br>2 files changed, 25 insertions(+), 3 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://gerrit.osmocom.org:29418/pysim refs/changes/14/23714/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/contrib/jenkins.sh b/contrib/jenkins.sh</span><br><span>index dc2692c..2d9653a 100755</span><br><span>--- a/contrib/jenkins.sh</span><br><span>+++ b/contrib/jenkins.sh</span><br><span>@@ -1,4 +1,10 @@</span><br><span> #!/bin/sh</span><br><span style="color: hsl(120, 100%, 40%);">+# jenkins build helper script for pysim.  This is how we build on jenkins.osmocom.org</span><br><span style="color: hsl(120, 100%, 40%);">+#</span><br><span style="color: hsl(120, 100%, 40%);">+# environment variables:</span><br><span style="color: hsl(120, 100%, 40%);">+# * WITH_MANUALS: build manual PDFs if set to "1"</span><br><span style="color: hsl(120, 100%, 40%);">+# * PUBLISH: upload manuals after building if set to "1" (ignored without WITH_MANUALS = "1")</span><br><span style="color: hsl(120, 100%, 40%);">+#</span><br><span> </span><br><span> set -e</span><br><span> </span><br><span>@@ -24,8 +30,12 @@</span><br><span> pip install sphinx</span><br><span> pip install sphinxcontrib-napoleon</span><br><span> pip3 install -e 'git+https://github.com/osmocom/sphinx-argparse@master#egg=sphinx-argparse'</span><br><span style="color: hsl(0, 100%, 40%);">-(cd docs && make html)</span><br><span style="color: hsl(120, 100%, 40%);">+(cd docs && make html latexpdf)</span><br><span> </span><br><span> # run the test with physical cards</span><br><span> cd pysim-testdata</span><br><span> ../tests/pysim-test.sh</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+if [ "$WITH_MANUALS" = "1" ] && [ "$PUBLISH" = "1" ]; then</span><br><span style="color: hsl(120, 100%, 40%);">+      make -C "$base/docs" publish</span><br><span style="color: hsl(120, 100%, 40%);">+fi</span><br><span>diff --git a/docs/Makefile b/docs/Makefile</span><br><span>index d4bb2cb..dbc5276 100644</span><br><span>--- a/docs/Makefile</span><br><span>+++ b/docs/Makefile</span><br><span>@@ -8,13 +8,25 @@</span><br><span> SOURCEDIR     = .</span><br><span> BUILDDIR      = _build</span><br><span> </span><br><span style="color: hsl(120, 100%, 40%);">+# for osmo-gsm-manuals</span><br><span style="color: hsl(120, 100%, 40%);">+OSMO_GSM_MANUALS_DIR=$(shell pkg-config osmo-gsm-manuals --variable=osmogsmmanualsdir 2>/dev/null)</span><br><span style="color: hsl(120, 100%, 40%);">+OSMO_REPOSITORY = "pysim"</span><br><span style="color: hsl(120, 100%, 40%);">+UPLOAD_FILES = $(BUILDDIR)/latex/pysim.pdf</span><br><span style="color: hsl(120, 100%, 40%);">+CLEAN_FILES = $(UPLOAD_FILES)</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span> # Put it first so that "make" without argument is like "make help".</span><br><span style="color: hsl(120, 100%, 40%);">+.PHONY: help</span><br><span> help:</span><br><span>        @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-.PHONY: help Makefile</span><br><span style="color: hsl(120, 100%, 40%);">+$(BUILDDIR)/latex/pysim.pdf: latexpdf</span><br><span style="color: hsl(120, 100%, 40%);">+   @/bin/true</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+# put this before the catch-all below</span><br><span style="color: hsl(120, 100%, 40%);">+include $(OSMO_GSM_MANUALS_DIR)/build/Makefile.common.inc</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span> </span><br><span> # Catch-all target: route all unknown targets to Sphinx using the new</span><br><span> # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).</span><br><span style="color: hsl(0, 100%, 40%);">-%: Makefile</span><br><span style="color: hsl(120, 100%, 40%);">+%:</span><br><span>      @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)</span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/c/pysim/+/23714">change 23714</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.osmocom.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://gerrit.osmocom.org/c/pysim/+/23714"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: pysim </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-Change-Id: I3f01e93dd5a25d26feb3d067a171244a20f0f8e5 </div>
<div style="display:none"> Gerrit-Change-Number: 23714 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: laforge <laforge@osmocom.org> </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>