Add note about the way exception messages are compared.

Author: winkbrace

src/5.2/en/writing-tests-for-phpunit.xml

@@ -607,6 +607,16 @@ Tests: 1, Assertions: 1, Failures: 1.</screen>
       expectations for exceptions raised by the code under test.
     </para>
 
+    <note>
+      <para>
+        <indexterm><primary>expectExceptionMessage()</primary></indexterm>
+
+        Note that expectExceptionMessage asserts that the <literal>$actual</literal>
+        message contains the <literal>$expected</literal> message and doesn't perform
+        an exact string comparison.
+      </para>
+    </note>
+
     <para>
       <indexterm><primary>Annotation</primary></indexterm>
       <indexterm><primary>@expectedException</primary></indexterm>

src/5.3/en/writing-tests-for-phpunit.xml

@@ -607,6 +607,16 @@ Tests: 1, Assertions: 1, Failures: 1.</screen>
       expectations for exceptions raised by the code under test.
     </para>
 
+    <note>
+      <para>
+        <indexterm><primary>expectExceptionMessage()</primary></indexterm>
+
+        Note that expectExceptionMessage asserts that the <literal>$actual</literal>
+        message contains the <literal>$expected</literal> message and doesn't perform
+        an exact string comparison.
+      </para>
+    </note>
+
     <para>
       <indexterm><primary>Annotation</primary></indexterm>
       <indexterm><primary>@expectedException</primary></indexterm>

src/5.4/en/writing-tests-for-phpunit.xml

@@ -627,6 +627,16 @@ Tests: 1, Assertions: 1, Failures: 1.</screen>
       expectations for exceptions raised by the code under test.
     </para>
 
+    <note>
+      <para>
+        <indexterm><primary>expectExceptionMessage()</primary></indexterm>
+
+        Note that expectExceptionMessage asserts that the <literal>$actual</literal>
+        message contains the <literal>$expected</literal> message and doesn't perform
+        an exact string comparison.
+      </para>
+    </note>
+
     <para>
       <indexterm><primary>Annotation</primary></indexterm>
       <indexterm><primary>@expectedException</primary></indexterm>

src/5.5/en/writing-tests-for-phpunit.xml

@@ -627,6 +627,16 @@ Tests: 1, Assertions: 1, Failures: 1.</screen>
       expectations for exceptions raised by the code under test.
     </para>
 
+    <note>
+      <para>
+        <indexterm><primary>expectExceptionMessage()</primary></indexterm>
+
+        Note that expectExceptionMessage asserts that the <literal>$actual</literal>
+        message contains the <literal>$expected</literal> message and doesn't perform
+        an exact string comparison.
+      </para>
+    </note>
+
     <para>
       <indexterm><primary>Annotation</primary></indexterm>
       <indexterm><primary>@expectedException</primary></indexterm>

src/5.6/en/writing-tests-for-phpunit.xml

@@ -627,6 +627,16 @@ Tests: 1, Assertions: 1, Failures: 1.</screen>
       expectations for exceptions raised by the code under test.
     </para>
 
+    <note>
+      <para>
+        <indexterm><primary>expectExceptionMessage()</primary></indexterm>
+
+        Note that expectExceptionMessage asserts that the <literal>$actual</literal>
+        message contains the <literal>$expected</literal> message and doesn't perform
+        an exact string comparison.
+      </para>
+    </note>
+
     <para>
       <indexterm><primary>Annotation</primary></indexterm>
       <indexterm><primary>@expectedException</primary></indexterm>

src/5.7/en/writing-tests-for-phpunit.xml

@@ -627,6 +627,16 @@ Tests: 1, Assertions: 1, Failures: 1.</screen>
       expectations for exceptions raised by the code under test.
     </para>
 
+    <note>
+      <para>
+        <indexterm><primary>expectExceptionMessage()</primary></indexterm>
+
+        Note that expectExceptionMessage asserts that the <literal>$actual</literal>
+        message contains the <literal>$expected</literal> message and doesn't perform
+        an exact string comparison.
+      </para>
+    </note>
+
     <para>
       <indexterm><primary>Annotation</primary></indexterm>
       <indexterm><primary>@expectedException</primary></indexterm>

src/6.0/en/writing-tests-for-phpunit.xml

@@ -627,6 +627,16 @@ Tests: 1, Assertions: 1, Failures: 1.</screen>
       expectations for exceptions raised by the code under test.
     </para>
 
+    <note>
+      <para>
+        <indexterm><primary>expectExceptionMessage()</primary></indexterm>
+
+        Note that expectExceptionMessage asserts that the <literal>$actual</literal>
+        message contains the <literal>$expected</literal> message and doesn't perform
+        an exact string comparison.
+      </para>
+    </note>
+
     <para>
       <indexterm><primary>Annotation</primary></indexterm>
       <indexterm><primary>@expectedException</primary></indexterm>

src/6.1/en/writing-tests-for-phpunit.xml

@@ -627,6 +627,16 @@ Tests: 1, Assertions: 1, Failures: 1.</screen>
       expectations for exceptions raised by the code under test.
     </para>
 
+    <note>
+      <para>
+        <indexterm><primary>expectExceptionMessage()</primary></indexterm>
+
+        Note that expectExceptionMessage asserts that the <literal>$actual</literal>
+        message contains the <literal>$expected</literal> message and doesn't perform
+        an exact string comparison.
+      </para>
+    </note>
+
     <para>
       <indexterm><primary>Annotation</primary></indexterm>
       <indexterm><primary>@expectedException</primary></indexterm>

src/6.2/en/writing-tests-for-phpunit.xml

@@ -627,6 +627,16 @@ Tests: 1, Assertions: 1, Failures: 1.</screen>
       expectations for exceptions raised by the code under test.
     </para>
 
+    <note>
+      <para>
+        <indexterm><primary>expectExceptionMessage()</primary></indexterm>
+
+        Note that expectExceptionMessage asserts that the <literal>$actual</literal>
+        message contains the <literal>$expected</literal> message and doesn't perform
+        an exact string comparison.
+      </para>
+    </note>
+
     <para>
       <indexterm><primary>Annotation</primary></indexterm>
       <indexterm><primary>@expectedException</primary></indexterm>

src/6.3/en/writing-tests-for-phpunit.xml

@@ -627,6 +627,16 @@ Tests: 1, Assertions: 1, Failures: 1.</screen>
       expectations for exceptions raised by the code under test.
     </para>
 
+    <note>
+      <para>
+        <indexterm><primary>expectExceptionMessage()</primary></indexterm>
+
+        Note that expectExceptionMessage asserts that the <literal>$actual</literal>
+        message contains the <literal>$expected</literal> message and doesn't perform
+        an exact string comparison.
+      </para>
+    </note>
+
     <para>
       <indexterm><primary>Annotation</primary></indexterm>
       <indexterm><primary>@expectedException</primary></indexterm>

src/6.4/en/writing-tests-for-phpunit.xml

@@ -627,6 +627,16 @@ Tests: 1, Assertions: 1, Failures: 1.</screen>
       expectations for exceptions raised by the code under test.
     </para>
 
+    <note>
+      <para>
+        <indexterm><primary>expectExceptionMessage()</primary></indexterm>
+
+        Note that expectExceptionMessage asserts that the <literal>$actual</literal>
+        message contains the <literal>$expected</literal> message and doesn't perform
+        an exact string comparison.
+      </para>
+    </note>
+
     <para>
       <indexterm><primary>Annotation</primary></indexterm>
       <indexterm><primary>@expectedException</primary></indexterm>

src/6.5/en/writing-tests-for-phpunit.xml

@@ -627,6 +627,16 @@ Tests: 1, Assertions: 1, Failures: 1.</screen>
       expectations for exceptions raised by the code under test.
     </para>
 
+    <note>
+      <para>
+        <indexterm><primary>expectExceptionMessage()</primary></indexterm>
+
+        Note that expectExceptionMessage asserts that the <literal>$actual</literal>
+        message contains the <literal>$expected</literal> message and doesn't perform
+        an exact string comparison.
+      </para>
+    </note>
+
     <para>
       <indexterm><primary>Annotation</primary></indexterm>
       <indexterm><primary>@expectedException</primary></indexterm>

src/7.0/en/writing-tests-for-phpunit.xml

@@ -627,6 +627,16 @@ Tests: 1, Assertions: 1, Failures: 1.</screen>
       expectations for exceptions raised by the code under test.
     </para>
 
+    <note>
+      <para>
+        <indexterm><primary>expectExceptionMessage()</primary></indexterm>
+
+        Note that expectExceptionMessage asserts that the <literal>$actual</literal>
+        message contains the <literal>$expected</literal> message and doesn't perform
+        an exact string comparison.
+      </para>
+    </note>
+
     <para>
       <indexterm><primary>Annotation</primary></indexterm>
       <indexterm><primary>@expectedException</primary></indexterm>