<p>Trevor Peirce has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.asterisk.org/c/asterisk/+/18734">View Change</a></p><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;">git pull ssh://gerrit.asterisk.org:29418/asterisk refs/changes/34/18734/1</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><p>To view, visit <a href="https://gerrit.asterisk.org/c/asterisk/+/18734">change 18734</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/+/18734"/><meta itemprop="name" content="View Change"/></div></div>
<div style="display:none"> Gerrit-Project: asterisk </div>
<div style="display:none"> Gerrit-Branch: 18 </div>
<div style="display:none"> Gerrit-Change-Id: I160d0b01fce862477ad55ac1aa708a730473eb6f </div>
<div style="display:none"> Gerrit-Change-Number: 18734 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: Trevor Peirce <trev@acrovoice.ca> </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>