<p>George Joseph <strong>submitted</strong> this change.</p><p><a href="https://gerrit.asterisk.org/c/asterisk/+/18732">View Change</a></p><div style="white-space:pre-wrap">Approvals:
  Joshua Colp: Looks good to me, but someone else must approve
  Kevin Harwell: Looks good to me, but someone else must approve
  George Joseph: Looks good to me, approved; Approved for Submit

</div><pre style="font-family: monospace,monospace; white-space: pre-wrap;">features: Update documentation for automon and automixmon<br><br>The current documentation is out of date and does not reflect actual<br>behaviour.  This change makes documentation clearer and accurately<br>reflect the purpose of relevant channel variables.<br><br>ASTERISK-30123<br><br>Change-Id: I160d0b01fce862477ad55ac1aa708a730473eb6f<br>---<br>M main/features_config.c<br>1 file changed, 15 insertions(+), 11 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/main/features_config.c b/main/features_config.c</span><br><span>index 50ca69b..ac0135a 100644</span><br><span>--- a/main/features_config.c</span><br><span>+++ b/main/features_config.c</span><br><span>@@ -184,30 +184,34 @@</span><br><span>                                  </description></span><br><span>                                 </configOption></span><br><span>                                <configOption name="automon"></span><br><span style="color: hsl(0, 100%, 40%);">-                                   <synopsis>DTMF sequence to start or stop monitoring a call</synopsis></span><br><span style="color: hsl(120, 100%, 40%);">+                                     <synopsis>DTMF sequence to start or stop Monitor on a call</synopsis></span><br><span>                                    <description></span><br><span>                                          <para>This will cause the channel that pressed the DTMF sequence</span><br><span>                                               to be monitored by the <literal>Monitor</literal> application. The</span><br><span>                                               format for the recording is determined by the <replaceable>TOUCH_MONITOR_FORMAT</replaceable></span><br><span>                                            channel variable. If this variable is not specified, then <literal>wav</literal> is the</span><br><span>                                          default. The filename is constructed in the following manner:</para></span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-                                              <para>    prefix-timestamp-filename</para></span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(120, 100%, 40%);">+                                                <para>    prefix-timestamp-suffix.fmt</para></span><br><span>                                             <para>where prefix is either the value of the <replaceable>TOUCH_MONITOR_PREFIX</replaceable></span><br><span>                                              channel variable or <literal>auto</literal> if the variable is not set. The timestamp</span><br><span style="color: hsl(0, 100%, 40%);">-                                               is a UNIX timestamp. The filename is either the value of the <replaceable>TOUCH_MONITOR</replaceable></span><br><span style="color: hsl(120, 100%, 40%);">+                                             is a UNIX timestamp. The suffix is either the value of the <replaceable>TOUCH_MONITOR</replaceable></span><br><span>                                              channel variable or the callerID of the channels if the variable is not set.</para></span><br><span>                                    </description></span><br><span style="color: hsl(120, 100%, 40%);">+                                  <see-also><ref type="configOption">automixmon</ref></see-also></span><br><span>                             </configOption></span><br><span>                                <configOption name="automixmon"></span><br><span style="color: hsl(0, 100%, 40%);">-                                        <synopsis>DTMF sequence to start or stop mixmonitoring a call </synopsis></span><br><span style="color: hsl(120, 100%, 40%);">+                                 <synopsis>DTMF sequence to start or stop MixMonitor on a call</synopsis></span><br><span>                                         <description></span><br><span style="color: hsl(0, 100%, 40%);">-                                             <para>Operation of the automixmon is similar to the <literal> automon </literal></span><br><span style="color: hsl(0, 100%, 40%);">-                                              feature, with the following exceptions:</span><br><span style="color: hsl(0, 100%, 40%);">-                                                 <replaceable>TOUCH_MIXMONITOR</replaceable> is used in place of <replaceable>TOUCH_MONITOR</replaceable></span><br><span style="color: hsl(0, 100%, 40%);">-                                                        <replaceable>TOUCH_MIXMONITOR_FORMAT</replaceable> is used in place of <replaceable>TOUCH_MIXMONITOR</replaceable></span><br><span style="color: hsl(0, 100%, 40%);">-                                                      There is no equivalent for <replaceable>TOUCH_MONITOR_PREFIX</replaceable>. <literal>"auto"</literal> is always how the filename begins.</para></span><br><span style="color: hsl(120, 100%, 40%);">+                                               <para>This will cause the channel that pressed the DTMF sequence</span><br><span style="color: hsl(120, 100%, 40%);">+                                                to be monitored by the <literal>MixMonitor</literal> application. The</span><br><span style="color: hsl(120, 100%, 40%);">+                                             format for the recording is determined by the <replaceable>TOUCH_MIXMONITOR_FORMAT</replaceable></span><br><span style="color: hsl(120, 100%, 40%);">+                                          channel variable. If this variable is not specified, then <literal>wav</literal> is the</span><br><span style="color: hsl(120, 100%, 40%);">+                                           default. The filename is constructed in the following manner:</para></span><br><span style="color: hsl(120, 100%, 40%);">+                                            <para>    prefix-timestamp-suffix.fmt</para></span><br><span style="color: hsl(120, 100%, 40%);">+                                              <para>where prefix is either the value of the <replaceable>TOUCH_MIXMONITOR_PREFIX</replaceable></span><br><span style="color: hsl(120, 100%, 40%);">+                                            channel variable or <literal>auto</literal> if the variable is not set. The timestamp</span><br><span style="color: hsl(120, 100%, 40%);">+                                             is a UNIX timestamp. The suffix is either the value of the <replaceable>TOUCH_MIXMONITOR</replaceable></span><br><span style="color: hsl(120, 100%, 40%);">+                                            channel variable or the callerID of the channels if the variable is not set.</para></span><br><span>                                    </description></span><br><span>                                         <see-also><ref type="configOption">automon</ref></see-also></span><br><span>                                </configOption></span><br><span></span><br></pre><div style="white-space:pre-wrap"></div><p>To view, visit <a href="https://gerrit.asterisk.org/c/asterisk/+/18732">change 18732</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.asterisk.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.asterisk.org/c/asterisk/+/18732"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: asterisk </div>
<div style="display:none"> Gerrit-Branch: 19 </div>
<div style="display:none"> Gerrit-Change-Id: I160d0b01fce862477ad55ac1aa708a730473eb6f </div>
<div style="display:none"> Gerrit-Change-Number: 18732 </div>
<div style="display:none"> Gerrit-PatchSet: 2 </div>
<div style="display:none"> Gerrit-Owner: Trevor Peirce <trev@acrovoice.ca> </div>
<div style="display:none"> Gerrit-Reviewer: Friendly Automation </div>
<div style="display:none"> Gerrit-Reviewer: George Joseph <gjoseph@digium.com> </div>
<div style="display:none"> Gerrit-Reviewer: Joshua Colp <jcolp@sangoma.com> </div>
<div style="display:none"> Gerrit-Reviewer: Kevin Harwell <kharwell@digium.com> </div>
<div style="display:none"> Gerrit-MessageType: merged </div>