2019-07-16 Fred Gleason <fredg@paravelsystems.com>

* Added an rdairplay(1) man page.

ChangeLog

@@ -18865,3 +18865,5 @@
 	* Added switcher support for Grass Valley Series 7000 protocol.
 2019-07-16 Fred Gleason <fredg@paravelsystems.com>
 	* Added an rdlogmanager(1) man page.
+2019-07-16 Fred Gleason <fredg@paravelsystems.com>
+	* Added an rdairplay(1) man page.

docs/manpages/Makefile.am

@@ -31,7 +31,8 @@
 %.8:	%.xml
 	xsltproc $(DOCBOOK_STYLESHEETS)/manpages/docbook.xsl $<
 
-all-local:	rdclilogedit.1\
+all-local:	rdairplay.1\
+                rdclilogedit.1\
                 rdconvert.1\
                 rddbmgr.8\
                 rdexport.1\
@@ -43,7 +44,8 @@ all-local:	rdclilogedit.1\
                 rmlsend.1\
                 rdservice.8
 
-man_MANS = rdclilogedit.1\
+man_MANS = rdairplay.1\
+           rdclilogedit.1\
            rdconvert.1\
            rddbmgr.8\
            rdexport.1\
@@ -55,7 +57,9 @@ man_MANS = rdclilogedit.1\
            rmlsend.1\
            rdservice.8
 
-EXTRA_DIST = rdclilogedit.1\
+EXTRA_DIST = rdairplay.1\
+             rdairplay.xml\
+             rdclilogedit.1\
              rdclilogedit.xml\
              rdconvert.1\
              rdconvert.xml\

docs/manpages/rdairplay.xml

@@ -0,0 +1,95 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<refentry id="stdin" xmlns="http://docbook.org/ns/docbook" version="5.0">
+  <!--
+      Header
+  -->
+  <refmeta>
+    <refentrytitle>rdairplay</refentrytitle>
+    <manvolnum>1</manvolnum>
+    <refmiscinfo class='source'>July 2019</refmiscinfo>
+    <refmiscinfo class='manual'>Linux Audio Manual</refmiscinfo>
+  </refmeta>
+  <refnamediv>
+    <refname>rdairplay</refname>
+    <refpurpose>
+      Module for playing Rivendell logs
+    </refpurpose>
+  </refnamediv>
+  <info>
+    <author>
+      <personname>
+	<firstname>Fred</firstname>
+	<surname>Gleason</surname>
+	<email>fredg@paravelsystems.com</email>
+      </personname>
+      <contrib>Application Author</contrib>
+    </author>
+  </info>
+
+  <!--
+      Body
+  -->
+  <refsynopsisdiv id='synopsis'>
+    <cmdsynopsis>
+      <command>rdairplay</command>
+      <arg choice='opt'><replaceable>log-spec</replaceable>=<arg choice='opt'>:<replaceable>next-line</replaceable><arg choice='opt'>+</arg></arg></arg>
+      <sbr/>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1 id='description'><title>Description</title>
+  <para>
+    Where <replaceable>log-spec</replaceable> refers to one of the three
+    log machines (<userinput>--log1</userinput>, <userinput>--log2</userinput>
+    or <userinput>--log3</userinput>, referring to the
+    <computeroutput>Main Log</computeroutput>,
+    <computeroutput>Aux 1 Log</computeroutput>,
+    <computeroutput>Aux 2 Log</computeroutput> log machines, respectively)
+    and <replaceable>nextline</replaceable>
+    to the line number to do a 'make next' to after the log is loaded
+    (default = <userinput>0</userinput>). If the
+    <userinput>+</userinput> is appended, then the log is started after the
+    'make next'.
+  </para>
+  </refsect1>
+
+  <refsect1 id='examples'><title>Examples</title>
+  <variablelist remap='TP'>
+    <varlistentry>
+      <term>
+	<userinput>rdairplay --log1=MyLog</userinput>
+      </term>
+      <listitem>
+	<para>
+	  Load <userinput>MyLog</userinput> into the Main Log machine
+	</para>
+      </listitem>
+    </varlistentry>
+    <varlistentry>
+      <term>
+	<userinput>rdairplay --log2=MyLog:14+</userinput>
+      </term>
+      <listitem>
+	<para>
+	  Load <userinput>MyLog</userinput> into the Aux Log 1 machine,
+	  'Make Next' to line <userinput>14</userinput> and then start the log.
+	</para>
+      </listitem>
+    </varlistentry>
+    <varlistentry>
+      <term>
+	<userinput>rdairplay --log1=YourLog --log2=MyLog</userinput>
+      </term>
+      <listitem>
+	<para>
+	  Load <userinput>YourLog</userinput> into the Main Log machine
+	  and <userinput>MyLog</userinput> into the Aux Log 1 machine.
+	</para>
+      </listitem>
+    </varlistentry>
+
+  </variablelist>
+</refsect1>
+
+</refentry>
+

rdairplay/rdairplay.h

@@ -2,7 +2,7 @@
 //
 // The On Air Playout Utility for Rivendell.
 //
-//   (C) Copyright 2002-2018 Fred Gleason <fredg@paravelsystems.com>
+//   (C) Copyright 2002-2019 Fred Gleason <fredg@paravelsystems.com>
 //
 //   This program is free software; you can redistribute it and/or modify
 //   it under the terms of the GNU General Public License version 2 as
@@ -85,7 +85,7 @@
 #define METER_INTERVAL 20
 #define MASTER_TIMER_INTERVAL 100
 #define MESSAGE_WIDGET_WIDTH 410
-#define RDAIRPLAY_USAGE "[<log-spec>=[:<nextline>[+]]] [...]\n\nWhere <log-spec> refers to one of the three log machines\n('--log1', '--log2' or '--log3') and <nextline> to the line number\nto do a 'make next' to after the log is loaded (default = 0). If the\n'+' is appended, then the log is started after the 'make next'.\n\nExamples:\n rdairplay --log1=MyLog\n    Load 'MyLog' into the Main Log machine\n\n rdairplay --log2=MyLog:14+\n    Load 'MyLog' into the Aux Log 1 machine, 'Make Next'\n    to line 14 and then start the log.\n\n rdairplay --log1=YourLog --log2=MyLog\n    Load 'YourLog' into the Main Log machine and 'MyLog' into the\n    Aux Log 1 machine.\n"
+#define RDAIRPLAY_USAGE "[OPTIONS]\n"
 
 class MainWidget : public QWidget
 {

rivendell.spec.in

@@ -388,6 +388,7 @@ rm -rf $RPM_BUILD_ROOT
 /etc/pam.d/rddbconfig-root
 /etc/pam.d/rivendell
 /lib/systemd/system/rivendell.service
+%{_mandir}/man1/rdairplay.1.gz
 %{_mandir}/man1/rdclilogedit.1.gz
 %{_mandir}/man1/rdconvert.1.gz
 %{_mandir}/man1/rdexport.1.gz