*.adoc: use {srcdir} for out-of-tree builds

Define a new {srcdir} variable in Makefile.asciidoc.inc, that can be
used in all adoc files. The value is the same as the Makefile variable
$(srcdir). Use {srcdir} in the "include::" lines of all adoc files.

(moving manuals to project repositories 13/19)

Related: OS#3385
Change-Id: I823e3d534cbc9ffceb68d3ab14c9f6710ff2eb2a
This commit is contained in:
Oliver Smith 2018-11-15 11:00:01 +01:00
parent 2682f14611
commit 99b7cd1775
19 changed files with 82 additions and 82 deletions

View File

@ -29,7 +29,7 @@ support was so far for NITB only, but not for OsmoBSC.
[mscgen]
----
include::mgw/classic-bsc.msc[]
include::{srcdir}/mgw/classic-bsc.msc[]
----
=== OsmoBSC 2010-2017: IPA-style A over SCCPlite
@ -43,7 +43,7 @@ classic TDM transport.
[mscgen]
----
include::mgw/osmo-bsc-old-sccplite.msc[]
include::{srcdir}/mgw/osmo-bsc-old-sccplite.msc[]
----
@ -61,7 +61,7 @@ support shall be kept, if possible with reasonable effort.
[mscgen]
----
include::mgw/osmo-bsc-new-mgw.msc[]
include::{srcdir}/mgw/osmo-bsc-new-mgw.msc[]
----
@ -73,5 +73,5 @@ based BTSs from OsmoBSC.
[mscgen]
----
include::mgw/osmo-bsc-new-mgw-e1.msc[]
include::{srcdir}/mgw/osmo-bsc-new-mgw-e1.msc[]
----

View File

@ -7,15 +7,15 @@ Harald Welte <hwelte@sysmocom.de>
include::./common/chapters/preface.adoc[]
include::chapters/overview.adoc[]
include::{srcdir}/chapters/overview.adoc[]
include::chapters/running.adoc[]
include::{srcdir}/chapters/running.adoc[]
include::chapters/control.adoc[]
include::{srcdir}/chapters/control.adoc[]
include::chapters/counters.adoc[]
include::{srcdir}/chapters/counters.adoc[]
include::chapters/handover.adoc[]
include::{srcdir}/chapters/handover.adoc[]
include::./common/chapters/vty.adoc[]

View File

@ -64,7 +64,7 @@ established.
.Overview of A-bis connection establishment
["mscgen"]
----
include::abis/abis-startup.msc[]
include::{srcdir}/abis/abis-startup.msc[]
----
=== Identities
@ -77,13 +77,13 @@ parts:
* The BTS number at the site
* The TRX number within the BTS
include::abis/ipa.adoc[]
include::{srcdir}/abis/ipa.adoc[]
include::abis/oml.adoc[]
include::{srcdir}/abis/oml.adoc[]
include::abis/rsl.adoc[]
include::{srcdir}/abis/rsl.adoc[]
include::abis/rtp.adoc[]
include::{srcdir}/abis/rtp.adoc[]
include::./common/chapters/port_numbers.adoc[]

View File

@ -6,25 +6,25 @@ Harald Welte <hwelte@sysmocom.de>
include::./common/chapters/preface.adoc[]
include::chapters/overview.adoc[]
include::{srcdir}/chapters/overview.adoc[]
include::./common/chapters/abis.adoc[]
include::chapters/interfaces.adoc[]
include::{srcdir}/chapters/interfaces.adoc[]
include::chapters/control.adoc[]
include::{srcdir}/chapters/control.adoc[]
include::./common/chapters/vty.adoc[]
include::./common/chapters/logging.adoc[]
include::chapters/configuration.adoc[]
include::{srcdir}/chapters/configuration.adoc[]
include::chapters/dynamic-timeslots.adoc[]
include::{srcdir}/chapters/dynamic-timeslots.adoc[]
include::chapters/bts-models.adoc[]
include::{srcdir}/chapters/bts-models.adoc[]
include::chapters/architecture.adoc[]
include::{srcdir}/chapters/architecture.adoc[]
include::./common/chapters/trx_if.adoc[]

View File

@ -1335,7 +1335,7 @@ There is FSM implementing all the necessary states and transitions for DTX DL.
[[dtx_dl_fsm]]
[graphviz]
----
include::dtx.dot[]
include::{srcdir}/dtx.dot[]
----
The idea is that each state corresponds to the particular message type which have to be send to L1 next while state transition happens on incoming events like FACCH or Voice frames. There are 3 different classes of of events driving this FSM:

View File

@ -5,18 +5,18 @@ Harald Welte <hwelte@sysmocom.de>
include::./common/chapters/preface.adoc[]
include::chapters/overview.adoc[]
include::{srcdir}/chapters/overview.adoc[]
include::chapters/running.adoc[]
include::{srcdir}/chapters/running.adoc[]
//include::chapters/control.adoc[]
//include::{srcdir}/chapters/control.adoc[]
include::./common/chapters/vty.adoc[]
include::./common/chapters/logging.adoc[]
include::chapters/configuration.adoc[]
include::{srcdir}/chapters/configuration.adoc[]
include::./common/chapters/control_if.adoc[]

View File

@ -7,14 +7,14 @@ Neels Hofmeyr <nhofmeyr@sysmocom.de>
*NOTE: The osmo-gsm-tester is still in pre-alpha stage: some parts are still
incomplete, and details will still change and move around.*
include::chapters/intro.adoc[]
include::{srcdir}/chapters/intro.adoc[]
include::chapters/install.adoc[]
include::{srcdir}/chapters/install.adoc[]
include::chapters/config.adoc[]
include::{srcdir}/chapters/config.adoc[]
include::chapters/trial.adoc[]
include::{srcdir}/chapters/trial.adoc[]
include::chapters/test_api.adoc[]
include::{srcdir}/chapters/test_api.adoc[]
include::chapters/debugging.adoc[]
include::{srcdir}/chapters/debugging.adoc[]

View File

@ -8,19 +8,19 @@ Neels Hofmeyr <nhofmeyr@sysmocom.de>
include::./common/chapters/preface.adoc[]
include::chapters/overview.adoc[]
include::{srcdir}/chapters/overview.adoc[]
include::chapters/running.adoc[]
include::{srcdir}/chapters/running.adoc[]
include::chapters/subscribers.adoc[]
include::{srcdir}/chapters/subscribers.adoc[]
include::chapters/ussd.adoc[]
include::{srcdir}/chapters/ussd.adoc[]
include::./common/chapters/vty.adoc[]
include::./common/chapters/logging.adoc[]
include::chapters/control.adoc[]
include::{srcdir}/chapters/control.adoc[]
include::./common/chapters/control_if.adoc[]

View File

@ -8,19 +8,19 @@ Daniel Willmann <dwillmann@sysmocom.de>
include::./common/chapters/preface.adoc[]
include::chapters/overview.adoc[]
include::{srcdir}/chapters/overview.adoc[]
include::chapters/running.adoc[]
include::{srcdir}/chapters/running.adoc[]
include::./common/chapters/vty.adoc[]
include::./common/chapters/logging.adoc[]
include::chapters/configuration.adoc[]
include::{srcdir}/chapters/configuration.adoc[]
include::chapters/mgcp_extensions.adoc[]
include::{srcdir}/chapters/mgcp_extensions.adoc[]
//include::chapters/counters.adoc[]
//include::{srcdir}/chapters/counters.adoc[]
include::./common/chapters/port_numbers.adoc[]

View File

@ -8,19 +8,19 @@ Neels Hofmeyr <nhofmeyr@sysmocom.de>
include::./common/chapters/preface.adoc[]
include::chapters/overview.adoc[]
include::{srcdir}/chapters/overview.adoc[]
include::chapters/running.adoc[]
include::{srcdir}/chapters/running.adoc[]
include::chapters/control.adoc[]
include::{srcdir}/chapters/control.adoc[]
include::chapters/counters.adoc[]
include::{srcdir}/chapters/counters.adoc[]
include::./common/chapters/vty.adoc[]
include::./common/chapters/logging.adoc[]
include::chapters/net.adoc[]
include::{srcdir}/chapters/net.adoc[]
include::./common/chapters/smpp.adoc[]

View File

@ -8,25 +8,25 @@ Harald Welte <hwelte@sysmocom.de>
include::./common/chapters/preface.adoc[]
include::chapters/overview.adoc[]
include::{srcdir}/chapters/overview.adoc[]
include::chapters/running.adoc[]
include::{srcdir}/chapters/running.adoc[]
include::chapters/control.adoc[]
include::{srcdir}/chapters/control.adoc[]
include::./common/chapters/vty.adoc[]
include::./common/chapters/logging.adoc[]
include::chapters/net.adoc[]
include::{srcdir}/chapters/net.adoc[]
include::./common/chapters/bsc.adoc[]
include::./common/chapters/bts.adoc[]
include::chapters/bts-examples.adoc[]
include::{srcdir}/chapters/bts-examples.adoc[]
include::chapters/hlr.adoc[]
include::{srcdir}/chapters/hlr.adoc[]
include::./common/chapters/smpp.adoc[]

View File

@ -60,7 +60,7 @@ OsmoBSC or the BSC component inside OsmoNITB.
.Overview of Gb link establishment
["mscgen"]
----
include::gb/gb-startup.msc[]
include::{srcdir}/gb/gb-startup.msc[]
----
[[ident]]
@ -84,9 +84,9 @@ they connect to.
This means that typically each OsmoPCU has one unique set of NSEI,
NSVCI and BVCI in your network.
include::gb/ns.adoc[]
include::{srcdir}/gb/ns.adoc[]
include::gb/bssgp.adoc[]
include::{srcdir}/gb/bssgp.adoc[]
include::./common/chapters/port_numbers.adoc[]

View File

@ -7,17 +7,17 @@ Harald Welte <hwelte@sysmocom.de>
include::./common/chapters/preface.adoc[]
include::chapters/overview.adoc[]
include::{srcdir}/chapters/overview.adoc[]
include::chapters/running.adoc[]
include::{srcdir}/chapters/running.adoc[]
include::./common/chapters/vty.adoc[]
include::./common/chapters/logging.adoc[]
include::chapters/configuration.adoc[]
include::{srcdir}/chapters/configuration.adoc[]
include::chapters/counters.adoc[]
include::{srcdir}/chapters/counters.adoc[]
include::./common/chapters/gb.adoc[]

View File

@ -7,17 +7,17 @@ Harald Welte <hwelte@sysmocom.de>
include::./common/chapters/preface.adoc[]
include::chapters/overview.adoc[]
include::{srcdir}/chapters/overview.adoc[]
include::chapters/running.adoc[]
include::{srcdir}/chapters/running.adoc[]
include::chapters/control.adoc[]
include::{srcdir}/chapters/control.adoc[]
include::./common/chapters/vty.adoc[]
include::./common/chapters/logging.adoc[]
include::chapters/configuration.adoc[]
include::{srcdir}/chapters/configuration.adoc[]
include::./common/chapters/gb.adoc[]
@ -27,7 +27,7 @@ include::./common/chapters/oap.adoc[]
include::./common/chapters/gsup.adoc[]
include::chapters/counters.adoc[]
include::{srcdir}/chapters/counters.adoc[]
include::./common/chapters/port_numbers.adoc[]

View File

@ -8,15 +8,15 @@ Daniel Willmann <dwillmann@sysmocom.de>
include::./common/chapters/preface.adoc[]
include::chapters/overview.adoc[]
include::{srcdir}/chapters/overview.adoc[]
include::chapters/running.adoc[]
include::{srcdir}/chapters/running.adoc[]
include::./common/chapters/vty.adoc[]
include::./common/chapters/logging.adoc[]
include::chapters/configuration.adoc[]
include::{srcdir}/chapters/configuration.adoc[]
include::./common/chapters/port_numbers.adoc[]

View File

@ -5,14 +5,14 @@ Harald Welte <hwelte@sysmocom.de>
include::./common/chapters/preface.adoc[]
// include::chapters/overview.adoc[]
// include::{srcdir}/chapters/overview.adoc[]
include::./common/chapters/sigtran.adoc[]
include::./common/chapters/sigtran-osmocom.adoc[]
//include::chapters/running.adoc[]
// include::chapters/control.adoc[]
//include::{srcdir}/chapters/running.adoc[]
// include::{srcdir}/chapters/control.adoc[]
include::./common/chapters/vty.adoc[]

View File

@ -7,29 +7,29 @@ Pau Espin Pedrol <pespin@sysmocom.de>
include::./common/chapters/preface.adoc[]
include::chapters/overview.adoc[]
include::{srcdir}/chapters/overview.adoc[]
include::chapters/running.adoc[]
include::{srcdir}/chapters/running.adoc[]
include::./common/chapters/control_if.adoc[]
include::chapters/control.adoc[]
include::{srcdir}/chapters/control.adoc[]
include::./common/chapters/vty.adoc[]
include::./common/chapters/logging.adoc[]
include::chapters/counters.adoc[]
include::{srcdir}/chapters/counters.adoc[]
include::chapters/configuration.adoc[]
include::{srcdir}/chapters/configuration.adoc[]
include::chapters/trx-architectures.adoc[]
include::{srcdir}/chapters/trx-architectures.adoc[]
include::chapters/trx-devices.adoc[]
include::{srcdir}/chapters/trx-devices.adoc[]
include::chapters/trx-backends.adoc[]
include::{srcdir}/chapters/trx-backends.adoc[]
include::chapters/code-architecture.adoc[]
include::{srcdir}/chapters/code-architecture.adoc[]
include::./common/chapters/trx_if.adoc[]

View File

@ -5,7 +5,7 @@ Holger Hans Peter Freyther <holger@moiji-mobile.com>
include::./common/chapters/preface.adoc[]
include::chapters/scripting.adoc[]
include::{srcdir}/chapters/scripting.adoc[]
include::./common/chapters/vty.adoc[]

View File

@ -36,7 +36,7 @@ CLEAN_FILES += $(ASCIIDOC_NAME:%=%__*.png) $(ASCIIDOC_NAME:%=%__*.svg) $(ASCIIDO
CLEAN_FILES += $(ASCIIDOC_PDF) $(ASCIIDOC_NAME:%=%.html)
UPLOAD_FILES += $(ASCIIDOC_PDF)
ASCIIDOC_OPTS := -f $(BUILDDIR)/mscgen-filter.conf -f $(BUILDDIR)/diag-filter.conf -f $(BUILDDIR)/docinfo-releaseinfo.conf -f $(BUILDDIR)/python2-filter.conf
ASCIIDOC_OPTS := -f $(BUILDDIR)/mscgen-filter.conf -f $(BUILDDIR)/diag-filter.conf -f $(BUILDDIR)/docinfo-releaseinfo.conf -f $(BUILDDIR)/python2-filter.conf -a srcdir='$(srcdir)'
DBLATEX_OPTS := -s $(ASCIIDOCSTYLE) -P draft.mode=yes -P draft.watermark=0
ifeq (,$(BUILD_RELEASE))