Latest javadoc on successful CI build auto-pushed to gh-pages.

api/latest/com/google/common/truth/ThrowableSubject.html

@@ -143,7 +143,19 @@ <h2 title="Class ThrowableSubject" class="title">Class ThrowableSubject</h2>
 <hr>
 <pre>public class <span class="typeNameLabel">ThrowableSubject</span>
 extends <a href="Subject.html" title="class in com.google.common.truth">Subject</a></pre>
-<div class="block">Propositions for <code>Throwable</code> subjects.</div>
+<div class="block">Propositions for <code>Throwable</code> subjects.
+
+ <p>Truth does not provide its own support for calling a method and automatically catching an
+ expected exception, only for asserting on the exception after it has been caught. To catch the
+ exception, we suggest <a href="https://junit.org/junit4/javadoc/latest/org/junit/Assert.html?is-external=true#assertThrows-java.lang.Class-org.junit.function.ThrowingRunnable-" title="class or interface in org.junit" class="externalLink"><code>assertThrows</code></a> (JUnit), <a href="https://kotlinlang.org/api/latest/kotlin.test/kotlin.test/assert-fails-with.html"><code>
+ assertFailsWith</code></a> (<code>kotlin.test</code>), or similar functionality from your testing library of
+ choice.
+
+ <pre>
+ InvocationTargetException expected =
+     assertThrows(InvocationTargetException.class, () -> method.invoke(null));
+ assertThat(expected).hasCauseThat().isInstanceOf(IOException.class);
+ </pre></div>
 <dl>
 <dt><span class="simpleTagLabel">Author:</span></dt>
 <dd>Kurt Alfred Kluever</dd>

api/latest/com/google/common/truth/Truth.html

@@ -331,7 +331,9 @@ <h3>Method Summary</h3>
 <tr id="i25" class="rowColor">
 <td class="colFirst"><code>static <a href="ThrowableSubject.html" title="class in com.google.common.truth">ThrowableSubject</a></code></td>
 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#assertThat(java.lang.Throwable)">assertThat</a></span>&#8203;(@Nullable java.lang.Throwable&nbsp;actual)</code></th>
-<td class="colLast">&nbsp;</td>
+<td class="colLast">
+<div class="block">Begins an assertion about a <code>Throwable</code>.</div>
+</td>
 </tr>
 <tr id="i26" class="altColor">
 <td class="colFirst"><code>static <a href="BigDecimalSubject.html" title="class in com.google.common.truth">BigDecimalSubject</a></code></td>
@@ -542,6 +544,19 @@ <h4>assertThat</h4>
 <li class="blockList">
 <h4>assertThat</h4>
 <pre class="methodSignature">public static&nbsp;<a href="ThrowableSubject.html" title="class in com.google.common.truth">ThrowableSubject</a>&nbsp;assertThat&#8203;(@Nullable java.lang.Throwable&nbsp;actual)</pre>
+<div class="block">Begins an assertion about a <code>Throwable</code>.
+
+ <p>Truth does not provide its own support for calling a method and automatically catching an
+ expected exception, only for asserting on the exception after it has been caught. To catch the
+ exception, we suggest <a href="https://junit.org/junit4/javadoc/latest/org/junit/Assert.html?is-external=true#assertThrows-java.lang.Class-org.junit.function.ThrowingRunnable-" title="class or interface in org.junit" class="externalLink"><code>assertThrows</code></a> (JUnit), <a href="https://kotlinlang.org/api/latest/kotlin.test/kotlin.test/assert-fails-with.html"><code>
+ assertFailsWith</code></a> (<code>kotlin.test</code>), or similar functionality from your testing library
+ of choice.
+
+ <pre>
+ InvocationTargetException expected =
+     assertThrows(InvocationTargetException.class, () -> method.invoke(null));
+ assertThat(expected).hasCauseThat().isInstanceOf(IOException.class);
+ </pre></div>
 </li>
 </ul>
 <a id="assertThat(java.lang.Long)">

api/latest/com/google/common/truth/class-use/ThrowableSubject.html

@@ -151,7 +151,9 @@ <h3>Uses of <a href="../ThrowableSubject.html" title="class in com.google.common
 <tr class="altColor">
 <td class="colFirst"><code>static <a href="../ThrowableSubject.html" title="class in com.google.common.truth">ThrowableSubject</a></code></td>
 <th class="colSecond" scope="row"><span class="typeNameLabel">Truth.</span><code><span class="memberNameLink"><a href="../Truth.html#assertThat(java.lang.Throwable)">assertThat</a></span>&#8203;(@Nullable java.lang.Throwable&nbsp;actual)</code></th>
-<td class="colLast">&nbsp;</td>
+<td class="colLast">
+<div class="block">Begins an assertion about a <code>Throwable</code>.</div>
+</td>
 </tr>
 <tr class="rowColor">
 <td class="colFirst"><code><a href="../ThrowableSubject.html" title="class in com.google.common.truth">ThrowableSubject</a></code></td>

api/latest/index-all.html

@@ -270,7 +270,9 @@ <h2 class="title">A</h2>
 <dt><span class="memberNameLink"><a href="com/google/common/truth/Truth.html#assertThat(java.lang.String)">assertThat(String)</a></span> - Static method in class com.google.common.truth.<a href="com/google/common/truth/Truth.html" title="class in com.google.common.truth">Truth</a></dt>
 <dd>&nbsp;</dd>
 <dt><span class="memberNameLink"><a href="com/google/common/truth/Truth.html#assertThat(java.lang.Throwable)">assertThat(Throwable)</a></span> - Static method in class com.google.common.truth.<a href="com/google/common/truth/Truth.html" title="class in com.google.common.truth">Truth</a></dt>
-<dd>&nbsp;</dd>
+<dd>
+<div class="block">Begins an assertion about a <code>Throwable</code>.</div>
+</dd>
 <dt><span class="memberNameLink"><a href="com/google/common/truth/Truth.html#assertThat(java.math.BigDecimal)">assertThat(BigDecimal)</a></span> - Static method in class com.google.common.truth.<a href="com/google/common/truth/Truth.html" title="class in com.google.common.truth">Truth</a></dt>
 <dd>&nbsp;</dd>
 <dt><span class="memberNameLink"><a href="com/google/common/truth/Truth.html#assertThat(java.nio.file.Path)">assertThat(Path)</a></span> - Static method in class com.google.common.truth.<a href="com/google/common/truth/Truth.html" title="class in com.google.common.truth">Truth</a></dt>