<p>Harald Welte has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.osmocom.org/11151">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">Revert "osmo-config-merge: Add manual page"<br><br>This reverts commit 6dd00d876e2b947e070f776f90fbb8305a237d21.<br><br>Unfortunately, it seems older a2x versions don't support "-D" for<br>manpage generation:<br><br>All the osmocom master builds started to fail with:<br><br>make[2]: Entering directory '/build/deps/libosmocore/man'<br>a2x --doctype manpage --format manpage -D . osmo-config-merge.adoc<br>a2x: WARNING: --destination-dir option is only applicable to HTML based outputs<br>a2x: ERROR: "xmllint" --nonet --noout --valid "/build/deps/libosmocore/man/osmo-config-merge.xml" returned<br>non-zero exit status 127<br>Makefile:545: recipe for target 'osmo-config-merge.8' failed<br><br>Change-Id: I0f45362d3e978c328d962a5c0d883eade27b875c<br>---<br>M .gitignore<br>M Makefile.am<br>M configure.ac<br>D man/Makefile.am<br>D man/osmo-config-merge.adoc<br>5 files changed, 1 insertion(+), 95 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://gerrit.osmocom.org:29418/libosmocore refs/changes/51/11151/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/.gitignore b/.gitignore</span><br><span>index cb2ce68..451c883 100644</span><br><span>--- a/.gitignore</span><br><span>+++ b/.gitignore</span><br><span>@@ -81,7 +81,6 @@</span><br><span> doc/gb</span><br><span> doc/html.tar</span><br><span> doc/*.tag</span><br><span style="color: hsl(0, 100%, 40%);">-man/*.8</span><br><span> tags</span><br><span> </span><br><span> src/crc*gen.c</span><br><span>diff --git a/Makefile.am b/Makefile.am</span><br><span>index 745d482..de5eb35 100644</span><br><span>--- a/Makefile.am</span><br><span>+++ b/Makefile.am</span><br><span>@@ -1,7 +1,7 @@</span><br><span> ACLOCAL_AMFLAGS = -I m4</span><br><span> </span><br><span> AM_CPPFLAGS = $(all_includes) -I$(top_srcdir)/include</span><br><span style="color: hsl(0, 100%, 40%);">-SUBDIRS = include src src/vty src/codec src/gsm src/coding src/gb src/ctrl src/sim src/pseudotalloc utils tests man</span><br><span style="color: hsl(120, 100%, 40%);">+SUBDIRS = include src src/vty src/codec src/gsm src/coding src/gb src/ctrl src/sim src/pseudotalloc utils tests</span><br><span> </span><br><span> pkgconfigdir = $(libdir)/pkgconfig</span><br><span> pkgconfig_DATA = libosmocore.pc libosmocodec.pc libosmovty.pc libosmogsm.pc \</span><br><span>diff --git a/configure.ac b/configure.ac</span><br><span>index 529aad1..bc3358a 100644</span><br><span>--- a/configure.ac</span><br><span>+++ b/configure.ac</span><br><span>@@ -77,19 +77,6 @@</span><br><span> AC_PATH_PROG(DOXYGEN,doxygen,false)</span><br><span> AM_CONDITIONAL(HAVE_DOXYGEN, test $DOXYGEN != false && test "x$doxygen" = "xyes")</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-AC_ARG_ENABLE([man-doc],</span><br><span style="color: hsl(0, 100%, 40%);">-        [AS_HELP_STRING([--disable-man-doc], [Disable man page documentation])],</span><br><span style="color: hsl(0, 100%, 40%);">-        [ BUILD_MAN=$enableval ], [ BUILD_MAN="yes" ])</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-AS_IF([test "x$BUILD_MAN" = "xyes"], [</span><br><span style="color: hsl(0, 100%, 40%);">-      AC_CHECK_PROG(A2X, [a2x], [yes])</span><br><span style="color: hsl(0, 100%, 40%);">-      AS_IF([test "$A2X" != "yes"],</span><br><span style="color: hsl(0, 100%, 40%);">-       [AC_MSG_ERROR([a2x not found, please install asciidoc or use the</span><br><span style="color: hsl(0, 100%, 40%);">-         option --disable-man-doc])])</span><br><span style="color: hsl(0, 100%, 40%);">-])</span><br><span style="color: hsl(0, 100%, 40%);">-AM_CONDITIONAL(BUILD_MAN, test "x$BUILD_MAN" = "xyes")</span><br><span style="color: hsl(0, 100%, 40%);">-AC_SUBST(BUILD_MAN)</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span> # check for syscal fallback on glibc < 2.25 - can be removed once glibc version requirement is bumped</span><br><span> AC_CHECK_DECLS([SYS_getrandom], [], [], [[#include <sys/syscall.h>]])</span><br><span> </span><br><span>@@ -383,7 +370,6 @@</span><br><span>        libosmoctrl.pc</span><br><span>       libosmosim.pc</span><br><span>        include/Makefile</span><br><span style="color: hsl(0, 100%, 40%);">-        man/Makefile</span><br><span>         src/Makefile</span><br><span>         src/vty/Makefile</span><br><span>     src/codec/Makefile</span><br><span>diff --git a/man/Makefile.am b/man/Makefile.am</span><br><span>deleted file mode 100644</span><br><span>index b287714..0000000</span><br><span>--- a/man/Makefile.am</span><br><span>+++ /dev/null</span><br><span>@@ -1,15 +0,0 @@</span><br><span style="color: hsl(0, 100%, 40%);">-if BUILD_MAN</span><br><span style="color: hsl(0, 100%, 40%);">-man_MANS =  osmo-config-merge.8</span><br><span style="color: hsl(0, 100%, 40%);">-endif</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-ASCIIDOCS = osmo-config-merge.adoc</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-A2X_OPTS_MANPAGE = --doctype manpage --format manpage -D ${builddir}</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-%.8 : %.adoc</span><br><span style="color: hsl(0, 100%, 40%);">-            a2x ${A2X_OPTS_MANPAGE} $<</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-EXTRA_DIST = ${ASCIIDOCS}</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-CLEANFILES = \</span><br><span style="color: hsl(0, 100%, 40%);">-         osmo-config-merge.8</span><br><span>diff --git a/man/osmo-config-merge.adoc b/man/osmo-config-merge.adoc</span><br><span>deleted file mode 100644</span><br><span>index 205fb50..0000000</span><br><span>--- a/man/osmo-config-merge.adoc</span><br><span>+++ /dev/null</span><br><span>@@ -1,64 +0,0 @@</span><br><span style="color: hsl(0, 100%, 40%);">-osmo-config-merge(8)</span><br><span style="color: hsl(0, 100%, 40%);">-=====================</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-NAME</span><br><span>-----</span><br><span style="color: hsl(0, 100%, 40%);">-osmo-config-merge - Merge osmocom config snippets into an existing config</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-SYNOPSIS</span><br><span>---------</span><br><span style="color: hsl(0, 100%, 40%);">-[verse]</span><br><span style="color: hsl(0, 100%, 40%);">-*osmo-config-merge* <config-file> <config-patch> [--debug]</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-DESCRIPTION</span><br><span>------------</span><br><span style="color: hsl(0, 100%, 40%);">-This utility allows you to merge an incremental config "patch"</span><br><span style="color: hsl(0, 100%, 40%);">-into an osmocom-style config file.</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-The patch file follows the same syntax as the original config file.</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-It works by appending the leaf nodes of the patch file to the respective</span><br><span style="color: hsl(0, 100%, 40%);">-nodes of the input config file.</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-This process allows configuration file changes/updates to be performed</span><br><span style="color: hsl(0, 100%, 40%);">-in a more stable/reliable way than by means of (unified) diff files,</span><br><span style="color: hsl(0, 100%, 40%);">-as they break every time the context lines break.</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-osmo-config-merge doesn't suffer from this problem, as it understands</span><br><span style="color: hsl(0, 100%, 40%);">-the tree-like nature of VTY config files.</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-The resulting config is printed to stdout.</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-NOTE: This only works with configuration files that have proper</span><br><span style="color: hsl(0, 100%, 40%);">-indenting, i.e. every level in the hierarchy must be indented excatly</span><br><span style="color: hsl(0, 100%, 40%);">-one character, not multiple.</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-OPTIONS</span><br><span>--------</span><br><span style="color: hsl(0, 100%, 40%);">-*--debug*::</span><br><span style="color: hsl(0, 100%, 40%);">-      Show debugging output when parsing the config tree. Needs to be the last argument.</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-EXAMPLE USAGE</span><br><span>--------------</span><br><span style="color: hsl(0, 100%, 40%);">-[verse]</span><br><span style="color: hsl(0, 100%, 40%);">-$ osmo-config-merge osmo-msc.cfg.base osmo-msc_change_network.cfg > osmo-msc.cfg</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-EXIT STATUS</span><br><span>------------</span><br><span style="color: hsl(0, 100%, 40%);">-Exit status is 0 if the command was successful, and 1 in case of a</span><br><span style="color: hsl(0, 100%, 40%);">-wrong/missing argument. If the tool detects an error in the patch file the</span><br><span style="color: hsl(0, 100%, 40%);">-exit status is 2.</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-SEE ALSO</span><br><span>---------</span><br><span style="color: hsl(0, 100%, 40%);">-The official Osmocom documentation including the VTY config refernce can be</span><br><span style="color: hsl(0, 100%, 40%);">-found at: http://ftp.osmocom.org/docs/latest/</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-The Osmocom wiki is located at: http://projects.osmocom.org/</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-AUTHORS</span><br><span>--------</span><br><span style="color: hsl(0, 100%, 40%);">-osmo-config-merge was written by Harald Welte.</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-The man page was written by Daniel Willmann.</span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/11151">change 11151</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/11151"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: libosmocore </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>
<div style="display:none"> Gerrit-Change-Id: I0f45362d3e978c328d962a5c0d883eade27b875c </div>
<div style="display:none"> Gerrit-Change-Number: 11151 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: Harald Welte <laforge@gnumonks.org> </div>