2024-04-03 Fred Gleason <fredg@paravelsystems.com>

* Added an 'ExtendedNextPadEvents=' directive to rd.conf(5).

Signed-off-by: Fred Gleason <fredg@paravelsystems.com>

docs/manpages/rd.conf.xml

@@ -715,6 +715,27 @@
 	 aspects of Rivendell.
        </para>
        <variablelist>
+	 <varlistentry>
+	   <term>
+	     <userinput>ExtendedNextPadEvents = <replaceable>num</replaceable></userinput>
+	   </term>
+	   <listitem>
+	     <para>
+	       Instruct the PAD subsystem to provide an &quot;extended&quot;
+	       interface at TCP port <computeroutput>34290</computeroutput>,
+	       appending <replaceable>num</replaceable> &quot;next&quot;
+	       objects in addition to the standard &quot;next&quot; object.
+	     </para>
+	     <para>
+	       Setting <replaceable>num</replaceable> to
+	       <userinput>-1</userinput> will cause &quot;next&quot; objects
+	       for <emphasis>all</emphasis> upcoming events to be generated;
+	       while setting <replaceable>num</replaceable> to
+	       <userinput>0</userinput> will disable the extended PAD
+	       interface entirely.
+	     </para>
+	   </listitem>
+	 </varlistentry>
 	 <varlistentry>
 	   <term>
 	     <userinput>ServiceStartDelay = <replaceable>secs</replaceable></userinput>

docs/opsguide/pad.xml

@@ -96,6 +96,16 @@
 }]]>
 	</programlisting>
       </para>
+      <sect3 xml:id="sect.pad.the_json_interface.the_extended_json_interface">
+	<title>The Extended JSON Interface</title>
+	<para>
+	  An &quot;extended&quot; version of the above PAD feed that contains
+	  additional <code>next</code> objects is optionally available at
+	  TCP port 34290. See the <userinput>ExtendedNextPadEvents=</userinput>
+	  directive in the <userinput>[Tuning]</userinput> section of the
+	  <command>rd.conf</command><manvolnum>5</manvolnum> man page.
+	</para>
+      </sect3>
     </sect2>
 
     <sect2 xml:id="sect.pad.pypad">