25 Oct
2017
25 Oct
'17
6:52 p.m.
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Manuals for Osmocom GSM components".
The branch, master has been updated
via c481a988e33e4046c53f1f38d52522db67401820 (commit)
from 1b1b176e68730f5e42bf71e444c0ba1f3d9acea4 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
http://cgit.osmocom.org/osmo-gsm-manuals/commit/?id=c481a988e33e4046c53f1f3…
commit c481a988e33e4046c53f1f38d52522db67401820
Author: Neels Hofmeyr <neels(a)hofmeyr.de>
Date: Thu Oct 19 05:11:57 2017 +0200
refactor Makefile build rules, don't use the FORCE
The initial goal was to make sure we don't have overall FORCE rules causing
unnecessary rebuilds -- annoying while writing documentation. As I looked
through possible dependencies, I finally understood what's going on here.
Remove code dup and nicely sort which belongs where in build/Makefile.*.inc. In
each, describe in a top comment how to use it, and also unify how they are
used:
- Rename Makefile.inc to Makefile.docbook.inc and refactor
- Add Makefile.vty-reference.inc
- Add Makefile.common.inc
Make sure that we accurately pick up all dependencies.
Drop use of the macro called 'command', that silenced the actual command
lines
invoked and replaced them with short strings: it obscures what is actually
going on and makes the Makefiles hard to read and understand.
Each manual's makefile is greatly reduced to few definitions and a Makefile
include, e.g. one for asciidoc, one for VTY reference.
Move common/bsc_vty_additions.xml to OsmoBSC/vty/libbsc_vty_additions.xml, link
from OsmoNITB. It applies only to OsmoBSC and OsmoNITB.
Add a script that combines a VTY reference file with *all* additions files
found in a manual's vty/ dir. Call this from Makefile.vty-reference.inc.
Change-Id: I9758e04162a480e28c7dc83475b514cf7fd25ec0
-----------------------------------------------------------------------
Summary of changes:
OsmoBSC/Makefile | 55 +++-------------------
.../vty/libbsc_vty_additions.xml | 0
OsmoBTS/Makefile | 52 +++-----------------
OsmoGGSN/Makefile | 41 +++-------------
OsmoGSMTester/Makefile | 13 ++---
OsmoHLR/Makefile | 44 +++--------------
OsmoMGCP/Makefile | 33 ++-----------
OsmoMSC/Makefile | 44 +++--------------
OsmoNAT/Makefile | 33 ++-----------
OsmoNITB/Makefile | 46 +++---------------
OsmoNITB/vty/bsc_vty_additions.xml | 1 +
OsmoPCU/Makefile | 44 ++---------------
OsmoSGSN/Makefile | 45 +++---------------
build/Makefile.asciidoc.inc | 35 +++++++++++---
build/Makefile.common.inc | 14 ++++++
build/Makefile.docbook.inc | 35 ++++++++++++++
build/Makefile.inc | 47 ------------------
build/Makefile.vty-reference.inc | 42 +++++++++++++++++
build/vty_reference_combine.sh | 25 ++++++++++
19 files changed, 206 insertions(+), 443 deletions(-)
rename common/bsc_vty_additions.xml => OsmoBSC/vty/libbsc_vty_additions.xml (100%)
create mode 120000 OsmoNITB/vty/bsc_vty_additions.xml
create mode 100644 build/Makefile.common.inc
create mode 100644 build/Makefile.docbook.inc
delete mode 100644 build/Makefile.inc
create mode 100644 build/Makefile.vty-reference.inc
create mode 100755 build/vty_reference_combine.sh
hooks/post-receive
--
Manuals for Osmocom GSM components