summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJens Georg <mail@jensge.org>2021-10-24 16:49:12 +0200
committerJens Georg <mail@jensge.org>2021-10-27 11:20:55 +0200
commit3065367fc2d5cc23f66f13d030f25d3ad15f31c0 (patch)
tree5e89ce4e5dc3a783b103b3e1e8f47299296dd340 /doc
parent0175039d71cd72ee8c9b718e752d3fa81851359c (diff)
downloadgupnp-3065367fc2d5cc23f66f13d030f25d3ad15f31c0.tar.gz
all: Bump API version
Reset ABI version, also bump project version
Diffstat (limited to 'doc')
-rw-r--r--doc/gupnp-binding-tool.xml.in (renamed from doc/gupnp-binding-tool.xml)14
-rw-r--r--doc/meson.build13
2 files changed, 17 insertions, 10 deletions
diff --git a/doc/gupnp-binding-tool.xml b/doc/gupnp-binding-tool.xml.in
index e45f494..1e07f93 100644
--- a/doc/gupnp-binding-tool.xml
+++ b/doc/gupnp-binding-tool.xml.in
@@ -3,20 +3,20 @@
<refentry id="gupnp-binding-tool" xmlns:xi="http://www.w3.org/2003/XInclude">
<refmeta>
- <refentrytitle>gupnp-binding-tool-1.2</refentrytitle>
+ <refentrytitle>gupnp-binding-tool-@GUPNP_API_VERSION@</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="source">GUPnP</refmiscinfo>
<refmiscinfo class="version"><xi:include href="version.xml" parse="text"><xi:fallback /></xi:include></refmiscinfo>
</refmeta>
<refnamediv>
- <refname>gupnp-binding-tool-1.2</refname>
+ <refname>gupnp-binding-tool-@GUPNP_API_VERSION@</refname>
<refpurpose>creates C convenience wrappers for UPnP services</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
- <command>gupnp-binding-tool-1.2</command>
+ <command>gupnp-binding-tool-@GUPNP_API_VERSION@</command>
<arg choice="opt">--prefix <arg choice="req">PREFIX</arg></arg>
<arg choice="opt">--mode <arg choice="req">client|server</arg></arg>
<arg choice="req">SCPD file</arg>
@@ -26,7 +26,7 @@
<refsect1>
<title>Description</title>
<para>
- <command>gupnp-binding-tool-1.2</command> takes a <glossterm
+ <command>gupnp-binding-tool-@GUPNP_API_VERSION@</command> takes a <glossterm
linkend="scpd">SCPD file</glossterm> and generates convenience C functions
which call the actual GUPnP functions. The client-side bindings can be seen
as a service-specific version of the GUPnPServiceProxy API and the
@@ -81,7 +81,7 @@ igd_delete_port_mapping (GUPnPServiceProxy *proxy,
the argument direction.
</para>
<para>
- <command>gupnp-binding-tool-1.2</command> generates both synchronous and
+ <command>gupnp-binding-tool-@GUPNP_API_VERSION@</command> generates both synchronous and
asynchronous wrappers. The <function>igd_delete_port_mapping</function> example
above is the synchronous form, the asynchronous form is as follows:
</para>
@@ -126,7 +126,7 @@ igd_external_ip_address_add_notify (GUPnPServiceProxy *proxy,
gpointer userdata);</programlisting>
<para>
- All of the examples were produced with <filename>gupnp-binding-tool-1.2
+ All of the examples were produced with <filename>gupnp-binding-tool-@GUPNP_API_VERSION@
--prefix igd --mode client WANIPConnection.xml</filename>.
</para>
</refsect1>
@@ -169,7 +169,7 @@ igd_external_ip_address_variable_notify (GUPnPService *service,
variable value.
</para>
<para>
- All of the examples were produced with <filename>gupnp-binding-tool-1.2
+ All of the examples were produced with <filename>gupnp-binding-tool-@GUPNP_API_VERSION@
--prefix igd --mode server WANIPConnection.xml</filename>.
</para>
</refsect1>
diff --git a/doc/meson.build b/doc/meson.build
index 2fd0106..569bf01 100644
--- a/doc/meson.build
+++ b/doc/meson.build
@@ -38,6 +38,13 @@ if get_option('gtk_doc')
install : true)
endif
+docbook_man_page = configure_file(
+ input: 'gupnp-binding-tool.xml.in',
+ output: 'gupnp-binding-tool.xml',
+ configuration: api_config,
+ install: false
+)
+
xsltproc = find_program('xsltproc', required: false)
if xsltproc.found()
stylesheet = 'http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl'
@@ -67,15 +74,15 @@ if xsltproc.found()
xlstproc_flags,
'--noout',
stylesheet,
- 'gupnp-binding-tool.xml'
+ docbook_man_page
]
)
if (stylesheet_check.returncode() == 0)
message('Stylesheet ' + stylesheet + ' available')
custom_target(
'man 1 pages',
- input: 'gupnp-binding-tool.xml',
- output: 'gupnp-binding-tool-1.2.1',
+ input: docbook_man_page,
+ output: 'gupnp-binding-tool-@0@.1'.format(GUPNP_API_VERSION),
command: xsltproc_args,
depend_files : version_xml,
install: true,