Change in osmo-gsm-manuals[master]: Makefile.common.inc: add {, un}install targets

This is merely a historical archive of years 2008-2021, before the migration to mailman3.

A maintained and still updated list archive can be found at https://lists.osmocom.org/hyperkitty/list/gerrit-log@lists.osmocom.org/.

Harald Welte gerrit-no-reply at lists.osmocom.org
Sun Apr 14 14:04:27 UTC 2019


Harald Welte has submitted this change and it was merged. ( https://gerrit.osmocom.org/13597 )

Change subject: Makefile.common.inc: add {,un}install targets
......................................................................

Makefile.common.inc: add {,un}install targets

Allow installing generated pdfs with 'make install' in all Osmocom
projects using osmo-gsm-manuals. This makes proper debian packaging of
the manuals easier.

Autotools will automatically run this file's install target, when
running 'make install' in the top source dir. Do not install anything,
when OSMO_GSM_MANUALS_NO_INSTALL is set, and set this variable for the
tests dir, so we don't install the test pdfs.

Related: OS#3899
Change-Id: I66f33172fa410681acbaef4592e9405627948705
---
M build/Makefile.common.inc
M tests/Makefile.am
2 files changed, 30 insertions(+), 1 deletion(-)

Approvals:
  Jenkins Builder: Verified
  Pau Espin Pedrol: Looks good to me, but someone else must approve
  Harald Welte: Looks good to me, approved



diff --git a/build/Makefile.common.inc b/build/Makefile.common.inc
index aaad088..b98e83f 100644
--- a/build/Makefile.common.inc
+++ b/build/Makefile.common.inc
@@ -3,12 +3,18 @@
 # Other makefiles like Makefile.asciidoc.inc and Makefile.vty-reference.inc add
 # entries to UPLOAD_FILES and CLEAN_FILES.
 #
-# Include this file at the end to have the common targets (upload, clean etc.).
+# Put the repository name (e.g. "osmo-bts") into OSMO_REPOSITORY and include
+# this file at the end to have the common targets (upload, clean, install etc.).
 
 SSH_COMMAND = ssh -o 'UserKnownHostsFile=$(OSMO_GSM_MANUALS_DIR)/build/known_hosts' -p 48
 UPLOAD_PATH ?= generic at sysmocom-downloads:documents
 SYMLINKS = common build
 CLEAN_FILES += $(SYMLINKS)
+PDF_FILES = $(patsubst %.adoc,%.pdf,$(ASCIIDOC)) $(patsubst %.xml,%.pdf,$(VTY_REFERENCE))
+OSMO_REPOSITORY ?= osmo-gsm-manuals
+
+# Prefix (Makefile.am sets this to configure's --prefix when including)
+prefix ?= /usr/local
 
 $(SYMLINKS):
 	ln -s $(OSMO_GSM_MANUALS_DIR)/$@ $@
@@ -25,3 +31,23 @@
 	mkdir -p out
 	cp *.pdf out
 	rsync -avz -e "$(SSH_COMMAND)" ./out/ docs at rita.osmocom.org:web-files/latest/
+
+# Install and uninstall targets
+# Notes about OSMO_GSM_MANUALS_NO_INSTALL:
+# - osmo-gsm-manuals.git's tests/Makefile.am sets this, so the test pdfs will not
+#   get installed
+# - installing manuals by default is fine, because Osmocom projects won't include
+#   the whole Makefile.common.inc unless --enable-manuals is passed to configure.
+install: $(PDF_FILES)
+	if [ "$(OSMO_GSM_MANUALS_NO_INSTALL)" != "1" ]; then \
+		for i in $(PDF_FILES); do \
+			install -vDm644 "$$i" "$(DESTDIR)$(prefix)/share/doc/$(OSMO_REPOSITORY)-doc/$$i" || exit 1; \
+		done; \
+	fi
+
+uninstall:
+	if [ "$(OSMO_GSM_MANUALS_NO_INSTALL)" != "1" ]; then \
+		for i in $(PDF_FILES); do \
+			rm -v "$(DESTDIR)$(prefix)/share/doc/$(OSMO_REPOSITORY)-doc/$$i"; \
+		done; \
+	fi
diff --git a/tests/Makefile.am b/tests/Makefile.am
index 32f23b0..7dc9544 100644
--- a/tests/Makefile.am
+++ b/tests/Makefile.am
@@ -3,6 +3,9 @@
 	test-vty-reference.xml \
 	vty
 
+# Do not install any of the test pdfs
+OSMO_GSM_MANUALS_NO_INSTALL = 1
+
 # Generate adoc file that includes all chapters
 ASCIIDOC = test-usermanual.adoc
 ASCIIDOC_DEPS =

-- 
To view, visit https://gerrit.osmocom.org/13597
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings

Gerrit-Project: osmo-gsm-manuals
Gerrit-Branch: master
Gerrit-MessageType: merged
Gerrit-Change-Id: I66f33172fa410681acbaef4592e9405627948705
Gerrit-Change-Number: 13597
Gerrit-PatchSet: 5
Gerrit-Owner: osmith <osmith at sysmocom.de>
Gerrit-Reviewer: Harald Welte <laforge at gnumonks.org>
Gerrit-Reviewer: Jenkins Builder (1000002)
Gerrit-Reviewer: Pau Espin Pedrol <pespin at sysmocom.de>
Gerrit-Reviewer: osmith <osmith at sysmocom.de>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osmocom.org/pipermail/gerrit-log/attachments/20190414/0d2ae81d/attachment.htm>


More information about the gerrit-log mailing list