Documentation: Revise explanation of cdr.conf option 'Unanswered'

ASTERISK-24279 #close
Reported by: Matt Jordan
Review: https://reviewboard.asterisk.org/r/4109/
........

Merged revisions 427901 from http://svn.asterisk.org/svn/asterisk/branches/12
........

Merged revisions 427902 from http://svn.asterisk.org/svn/asterisk/branches/13


git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@427903 65c4cc65-6c06-0410-ace0-fbb531ad65f3

2 files changed, 16 insertions, 27 deletions

diff --git a/configs/samples/cdr.conf.sample b/configs/samples/cdr.conf.sample
index 458e19ab4..2c7cdf6f0 100644
--- a/configs/samples/cdr.conf.sample
+++ b/configs/samples/cdr.conf.sample
@@ -13,20 +13,13 @@
 ; any loading of backend CDR modules.  Default is "yes".
 ;enable=yes
 
-; Define whether or not to log unanswered calls. Setting this to "yes" will
-; report every attempt to ring a phone in dialing attempts, when it was not
-; answered. For example, if you try to dial 3 extensions, and this option is "yes",
-; you will get 3 CDR's, one for each phone that was rung. Default is "no". Some
-; find this information horribly useless. Others find it very valuable. Note, in "yes"
-; mode, you will see one CDR, with one of the call targets on one side, and the originating
-; channel on the other, and then one CDR for each channel attempted. This may seem
-; redundant, but cannot be helped.
-;
-; In brief, this option controls the reporting of unanswered calls which only have an A 
-; party. Calls which get offered to an outgoing line, but are unanswered, are still 
-; logged, and that is the intended behaviour. (It also results in some B side CDRs being
-; output, as they have the B side channel as their source channel, and no destination 
-; channel.)
+; Define whether or not to log unanswered calls that don't involve an outgoing
+; party. Setting this to "yes" will make calls to extensions that don't answer
+; and don't set a B side channel (such as by using the Dial application)
+; receive CDR log entries. If this option is set to "no", then those log
+; entries will not be created. Unasnwered Calls which get offered to an
+; outgoing line will always receive log entries regardless of this option, and
+; that is the intended behaviour.
 ;unanswered = no
 
 ; Define whether or not to log congested calls. Setting this to "yes" will
diff --git a/main/cdr.c b/main/cdr.c
index 02ce3d902..ef057f4a3 100644
--- a/main/cdr.c
+++ b/main/cdr.c
@@ -98,19 +98,15 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
 					</description>
 				</configOption>
 				<configOption name="unanswered">
-					<synopsis>Log calls that are never answered.</synopsis>
-					<description><para>Define whether or not to log unanswered calls. Setting this to "yes" will
-					report every attempt to ring a phone in dialing attempts, when it was not
-					answered. For example, if you try to dial 3 extensions, and this option is "yes",
-					you will get 3 CDR's, one for each phone that was rung. Some find this information horribly
-					useless. Others find it very valuable. Note, in "yes" mode, you will see one CDR, with one of
-					the call targets on one side, and the originating channel on the other, and then one CDR for
-					each channel attempted. This may seem redundant, but cannot be helped.</para>
-					<para>In brief, this option controls the reporting of unanswered calls which only have an A
-					party. Calls which get offered to an outgoing line, but are unanswered, are still
-					logged, and that is the intended behavior. (It also results in some B side CDRs being
-					output, as they have the B side channel as their source channel, and no destination
-					channel.)</para>
+					<synopsis>Log calls that are never answered and don't set an outgoing party.</synopsis>
+					<description><para>
+					Define whether or not to log unanswered calls that don't involve an outgoing party. Setting
+					this to "yes" will make calls to extensions that don't answer and don't set a side B channel
+					(such as by using the Dial application) receive CDR log entries. If this option is set to
+					"no", then those log entries will not be created. Unanswered calls which get offered to an
+					outgoing line will always receive log entries regardless of this option, and that is the
+					intended behavior.
+					</para>
 					</description>
 				</configOption>
 				<configOption name="congestion">