build manuals moved here from osmo-gsm-manuals.git

Moved to doc/manuals/, with full commit history, in preceding merge commit.
Now incorporate in the build system.

Build with:

$ autoreconf -fi
$ ./configure --enable-manuals
$ make

Shared files from osmo-gsm-manuals.git are found automatically if
- the repository is checked out in ../osmo-gsm-manuals; or
- if it osmo-gsm-manuals was installed with "make install"; or
- OSMO_GSM_MANUALS_DIR is set.

Related: OS#3385
Change-Id: Ic3c5add3c87f0aadb1ffab668ce16be6d0805d33
This commit is contained in:
Oliver Smith 2018-11-14 10:47:01 +01:00 committed by Neels Hofmeyr
parent d9fb15603e
commit 39093768ca
7 changed files with 89 additions and 27 deletions

11
.gitignore vendored
View File

@ -61,3 +61,14 @@ tests/testsuite
tests/testsuite.log tests/testsuite.log
writtenconfig/ writtenconfig/
# manuals
doc/manuals/*.html
doc/manuals/*.svg
doc/manuals/*.pdf
doc/manuals/*__*.png
doc/manuals/*.check
doc/manuals/generated/
doc/manuals/osmomsc-usermanual.xml
doc/manuals/common
doc/manuals/build

View File

@ -181,6 +181,48 @@ AC_MSG_CHECKING([whether to enable VTY/CTRL tests])
AC_MSG_RESULT([$enable_ext_tests]) AC_MSG_RESULT([$enable_ext_tests])
AM_CONDITIONAL(ENABLE_EXT_TESTS, test "x$enable_ext_tests" = "xyes") AM_CONDITIONAL(ENABLE_EXT_TESTS, test "x$enable_ext_tests" = "xyes")
# Generate manuals
AC_ARG_ENABLE(manuals,
[AS_HELP_STRING(
[--enable-manuals],
[Generate manual PDFs [default=no]],
)],
[osmo_ac_build_manuals=$enableval], [osmo_ac_build_manuals="no"])
AM_CONDITIONAL([BUILD_MANUALS], [test x"$osmo_ac_build_manuals" = x"yes"])
AC_ARG_VAR(OSMO_GSM_MANUALS_DIR, [path to common osmo-gsm-manuals files, overriding pkg-config and "../osmo-gsm-manuals"
fallback])
if test x"$osmo_ac_build_manuals" = x"yes"
then
# Find OSMO_GSM_MANUALS_DIR (env, pkg-conf, fallback)
if test -n "$OSMO_GSM_MANUALS_DIR"; then
echo "checking for OSMO_GSM_MANUALS_DIR... $OSMO_GSM_MANUALS_DIR (from env)"
else
OSMO_GSM_MANUALS_DIR="$($PKG_CONFIG osmo-gsm-manuals --variable=osmogsmmanualsdir 2>/dev/null)"
if test -n "$OSMO_GSM_MANUALS_DIR"; then
echo "checking for OSMO_GSM_MANUALS_DIR... $OSMO_GSM_MANUALS_DIR (from pkg-conf)"
else
OSMO_GSM_MANUALS_DIR="../osmo-gsm-manuals"
echo "checking for OSMO_GSM_MANUALS_DIR... $OSMO_GSM_MANUALS_DIR (fallback)"
fi
fi
if ! test -d "$OSMO_GSM_MANUALS_DIR"; then
AC_MSG_ERROR("OSMO_GSM_MANUALS_DIR does not exist! Install osmo-gsm-manuals or set OSMO_GSM_MANUALS_DIR.")
fi
# Find and run check-depends
CHECK_DEPENDS="$OSMO_GSM_MANUALS_DIR/check-depends.sh"
if ! test -x "$CHECK_DEPENDS"; then
CHECK_DEPENDS="osmo-gsm-manuals-check-depends"
fi
if ! $CHECK_DEPENDS; then
AC_MSG_ERROR("missing dependencies for --enable-manuals")
fi
# Put in Makefile with absolute path
OSMO_GSM_MANUALS_DIR="$(realpath "$OSMO_GSM_MANUALS_DIR")"
AC_SUBST([OSMO_GSM_MANUALS_DIR])
fi
# https://www.freedesktop.org/software/systemd/man/daemon.html # https://www.freedesktop.org/software/systemd/man/daemon.html
AC_ARG_WITH([systemdsystemunitdir], AC_ARG_WITH([systemdsystemunitdir],
[AS_HELP_STRING([--with-systemdsystemunitdir=DIR], [Directory for systemd service files])],, [AS_HELP_STRING([--with-systemdsystemunitdir=DIR], [Directory for systemd service files])],,
@ -219,6 +261,7 @@ AC_OUTPUT(
tests/msc_vlr/Makefile tests/msc_vlr/Makefile
doc/Makefile doc/Makefile
doc/examples/Makefile doc/examples/Makefile
doc/manuals/Makefile
contrib/Makefile contrib/Makefile
contrib/systemd/Makefile contrib/systemd/Makefile
Makefile) Makefile)

View File

@ -1,3 +1,4 @@
SUBDIRS = \ SUBDIRS = \
examples \ examples \
manuals \
$(NULL) $(NULL)

View File

@ -1,10 +0,0 @@
TOPDIR = ..
ASCIIDOC = osmomsc-usermanual.adoc
ASCIIDOC_DEPS = chapters/*.adoc
include $(TOPDIR)/build/Makefile.asciidoc.inc
VTY_REFERENCE = osmomsc-vty-reference.xml
include $(TOPDIR)/build/Makefile.vty-reference.inc
include $(TOPDIR)/build/Makefile.common.inc

17
doc/manuals/Makefile.am Normal file
View File

@ -0,0 +1,17 @@
EXTRA_DIST = osmomsc-usermanual.adoc \
osmomsc-usermanual-docinfo.xml \
osmomsc-vty-reference.xml \
chapters \
images \
vty
if BUILD_MANUALS
ASCIIDOC = osmomsc-usermanual.adoc
ASCIIDOC_DEPS = $(srcdir)/chapters/*.adoc
include $(OSMO_GSM_MANUALS_DIR)/build/Makefile.asciidoc.inc
VTY_REFERENCE = osmomsc-vty-reference.xml
include $(OSMO_GSM_MANUALS_DIR)/build/Makefile.vty-reference.inc
include $(OSMO_GSM_MANUALS_DIR)/build/Makefile.common.inc
endif

View File

@ -6,35 +6,35 @@ OsmoMSC User Manual
Neels Hofmeyr <nhofmeyr@sysmocom.de> Neels Hofmeyr <nhofmeyr@sysmocom.de>
include::../common/chapters/preface.adoc[] 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/vty.adoc[]
include::../common/chapters/logging.adoc[] include::./common/chapters/logging.adoc[]
include::chapters/net.adoc[] include::{srcdir}/chapters/net.adoc[]
include::../common/chapters/smpp.adoc[] include::./common/chapters/smpp.adoc[]
include::../common/chapters/mncc.adoc[] include::./common/chapters/mncc.adoc[]
include::../common/chapters/control_if.adoc[] include::./common/chapters/control_if.adoc[]
include::../common/chapters/gsup.adoc[] include::./common/chapters/gsup.adoc[]
include::../common/chapters/port_numbers.adoc[] include::./common/chapters/port_numbers.adoc[]
include::../common/chapters/bibliography.adoc[] include::./common/chapters/bibliography.adoc[]
include::../common/chapters/glossary.adoc[] include::./common/chapters/glossary.adoc[]
include::../common/chapters/gfdl.adoc[] include::./common/chapters/gfdl.adoc[]

View File

@ -5,7 +5,7 @@
--> -->
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML 5.0//EN" <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML 5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd" [ "http://docbook.org/xml/5.0/dtd/docbook.dtd" [
<!ENTITY chapter-vty SYSTEM "../common/chapters/vty.xml" > <!ENTITY chapter-vty SYSTEM "./common/chapters/vty.xml" >
<!ENTITY sections-vty SYSTEM "generated/docbook_vty.xml" > <!ENTITY sections-vty SYSTEM "generated/docbook_vty.xml" >
]> ]>