d updated markdown snippets

Author: actions-user

approvaltests-util/docs/StringUtils.md

@@ -23,7 +23,7 @@ For example
 List<Integer> number = Arrays.asList(1, 2, 3, 4, 5);
 String text = StringUtils.join(number, ", ");
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/StringUtilsTest.java#L51-L54' title='Snippet source file'>snippet source</a> | <a href='#snippet-join_collection' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/StringUtilsTest.java#L52-L55' title='Snippet source file'>snippet source</a> | <a href='#snippet-join_collection' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 will produce
 <!-- snippet: /approvaltests-util-tests/src/test/java/com/spun/util/StringUtilsTest.testJoinCollection.approved.txt -->
@@ -44,7 +44,7 @@ For example:
 List<Integer> number = Arrays.asList(1, 2, 3, 4, 5);
 String text = StringUtils.join(number, ", ", n -> StringUtils.padNumber(n, 3));
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/StringUtilsTest.java#L60-L63' title='Snippet source file'>snippet source</a> | <a href='#snippet-join_collection_with_lambda' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/StringUtilsTest.java#L61-L64' title='Snippet source file'>snippet source</a> | <a href='#snippet-join_collection_with_lambda' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 will Produce
 <!-- snippet: /approvaltests-util-tests/src/test/java/com/spun/util/StringUtilsTest.testJoinCollectionWithFunction.approved.txt -->

approvaltests-util/docs/reference/Query.md

@@ -31,7 +31,7 @@ Integer[] numbers = Range.get(1, 20);
 Integer[] evenQueryNumbers = Query.where(numbers, n -> n % 2 == 0).orderBy(OrderBy.Order.Descending, n -> n)
     .asArray();
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L34-L38' title='Snippet source file'>snippet source</a> | <a href='#snippet-query_example' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L33-L37' title='Snippet source file'>snippet source</a> | <a href='#snippet-query_example' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 Here is the exact same function but using Java Streams:
@@ -42,7 +42,7 @@ Here is the exact same function but using Java Streams:
 Integer[] evenStreamNumbers = Arrays.stream(numbers).filter(n -> n % 2 == 0)
     .sorted((o1, o2) -> o2.compareTo(o1)).toArray(Integer[]::new);
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L39-L42' title='Snippet source file'>snippet source</a> | <a href='#snippet-stream_example' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L38-L41' title='Snippet source file'>snippet source</a> | <a href='#snippet-stream_example' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 Another example using sum() vs. reduce():
@@ -53,7 +53,7 @@ Another example using sum() vs. reduce():
 String[] names = {"Llewellyn", "Scott"};
 int lengthsFromQuery = Query.sum(names, n -> n.length()).intValue();
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L46-L49' title='Snippet source file'>snippet source</a> | <a href='#snippet-query_sum_example' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L45-L48' title='Snippet source file'>snippet source</a> | <a href='#snippet-query_sum_example' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 Here is the exact same function but using Java Streams:
@@ -63,7 +63,7 @@ Here is the exact same function but using Java Streams:
 ```java
 int lengthsFromStream = (int) Arrays.stream(names).map(n -> n.length()).reduce(0, (a, b) -> a + b);
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L50-L52' title='Snippet source file'>snippet source</a> | <a href='#snippet-stream_sum_example' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L49-L51' title='Snippet source file'>snippet source</a> | <a href='#snippet-stream_sum_example' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 #### Other benefits
@@ -82,7 +82,7 @@ Using Query:
 ```java
 List<String> strings = Query.select(numbers, n -> "" + n);
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L57-L59' title='Snippet source file'>snippet source</a> | <a href='#snippet-list_is_queryable' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L56-L58' title='Snippet source file'>snippet source</a> | <a href='#snippet-list_is_queryable' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 Using Streams:
@@ -91,7 +91,7 @@ Using Streams:
 ```java
 List<String> strings2 = Arrays.stream(numbers).map(n -> "" + n).collect(Collectors.toList());
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L60-L62' title='Snippet source file'>snippet source</a> | <a href='#snippet-list_from_stream' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/org/lambda/query/QueryTest.java#L59-L61' title='Snippet source file'>snippet source</a> | <a href='#snippet-list_from_stream' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 ### API

approvaltests-util/docs/reference/RuntimeExceptions.md

@@ -36,7 +36,7 @@ catch (Throwable t)
   throw ObjectUtils.throwAsError(t);
 }
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/ObjectUtilsTest.java#L66-L77' title='Snippet source file'>snippet source</a> | <a href='#snippet-throw_as_error' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/ObjectUtilsTest.java#L67-L78' title='Snippet source file'>snippet source</a> | <a href='#snippet-throw_as_error' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 There are two things to note in this implementation.
@@ -58,7 +58,7 @@ the use of lambdas. Here are examples with and without return values:
 ObjectUtils.throwAsError(() -> methodThatMightThrowCheckedException());
 int i = ObjectUtils.throwAsError(() -> methodThatMightThrowCheckedExceptionWithReturnValue());
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/ObjectUtilsTest.java#L82-L85' title='Snippet source file'>snippet source</a> | <a href='#snippet-throw_as_error_lambda' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/ObjectUtilsTest.java#L83-L86' title='Snippet source file'>snippet source</a> | <a href='#snippet-throw_as_error_lambda' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 ## 3. Wrapping Actions/Functions
@@ -73,7 +73,7 @@ Queryable<String> paths = files.select(Functions.unchecked(
     // throws IOException
     s -> new File(s).getCanonicalPath()));
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/ObjectUtilsTest.java#L91-L95' title='Snippet source file'>snippet source</a> | <a href='#snippet-throw_as_unchecked' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/ObjectUtilsTest.java#L92-L96' title='Snippet source file'>snippet source</a> | <a href='#snippet-throw_as_unchecked' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 ---

approvaltests/docs/Configuration.md

@@ -154,7 +154,7 @@ Function2<Class, String, File> myFinder = new Function2<Class, String, File>()
   }
 };
 ```
-<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/namer/NamerSamples.java#L17-L26' title='Snippet source file'>snippet source</a> | <a href='#snippet-define_alternative_source_directory_finder' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/namer/NamerSamples.java#L16-L25' title='Snippet source file'>snippet source</a> | <a href='#snippet-define_alternative_source_directory_finder' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 ### Using alternatives
 Thanks to the try block, the default is restored afterwards allowing tests to be independent.
@@ -167,7 +167,7 @@ try (SourceDirectoryRestorer sdr = TestUtils.registerSourceDirectoryFinder(myFin
   Approvals.verify("Ragunath");
 }
 ```
-<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/namer/NamerSamples.java#L27-L32' title='Snippet source file'>snippet source</a> | <a href='#snippet-configure_alternative_source_directory' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/namer/NamerSamples.java#L26-L31' title='Snippet source file'>snippet source</a> | <a href='#snippet-configure_alternative_source_directory' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 ---

approvaltests/docs/Features.md

@@ -95,7 +95,7 @@ ApprovalNamer namer = Approvals.createApprovalNamer();
 Function2<File, File, VerifyResult> approveEverything = (r, a) -> VerifyResult.SUCCESS;
 Approvals.verify(new FileApprover(writer, namer, approveEverything));
 ```
-<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/approvers/FileApproverTest.java#L66-L71' title='Snippet source file'>snippet source</a> | <a href='#snippet-custom_approver' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/approvers/FileApproverTest.java#L65-L70' title='Snippet source file'>snippet source</a> | <a href='#snippet-custom_approver' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 

approvaltests/docs/Reporters.md

@@ -79,7 +79,7 @@ At both the class and method level you can use the @UseReporter attribute to set
 ```java
 @UseReporter(DiffMergeReporter.class)
 ```
-<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/reporters/GenericDiffReporterTest.java#L21-L23' title='Snippet source file'>snippet source</a> | <a href='#snippet-use_reporter_single' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/reporters/GenericDiffReporterTest.java#L20-L22' title='Snippet source file'>snippet source</a> | <a href='#snippet-use_reporter_single' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 <!-- snippet: use_reporter_multiple -->

approvaltests/docs/how_to/ConsistentTimeZones.md

@@ -26,5 +26,5 @@ try (WithTimeZone tz = new WithTimeZone("UTC"))
 }
 // The computer's time zone will revert to previous setting here
 ```
-<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/parser/VelocityUtilsTest.java#L35-L41' title='Snippet source file'>snippet source</a> | <a href='#snippet-with_time_zone' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/parser/VelocityUtilsTest.java#L36-L42' title='Snippet source file'>snippet source</a> | <a href='#snippet-with_time_zone' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->

approvaltests/docs/how_to/PrintableWrappers.md

@@ -27,7 +27,7 @@ If you just wanted to wrap a single object. You can create a printable wrapper b
 Printable<Integer> one = new Printable(1, "one");
 assertEquals("one", one.toString());
 ```
-<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/combinations/PrintableTest.java#L18-L21' title='Snippet source file'>snippet source</a> | <a href='#snippet-printable_single_label' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/combinations/PrintableTest.java#L14-L17' title='Snippet source file'>snippet source</a> | <a href='#snippet-printable_single_label' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 to access the value, simply call
@@ -38,7 +38,7 @@ to access the value, simply call
 Integer value = one.get();
 assertEquals(1, value);
 ```
-<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/combinations/PrintableTest.java#L22-L25' title='Snippet source file'>snippet source</a> | <a href='#snippet-printable_access' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/combinations/PrintableTest.java#L18-L21' title='Snippet source file'>snippet source</a> | <a href='#snippet-printable_access' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 #### Alternative `toString()` Function
@@ -51,7 +51,7 @@ You can also write a different function(lambda) to create the `toString()` and t
 Printable<Integer> two = new Printable(2, i -> "#" + i + ")");
 assertEquals("#2)", two.toString());
 ```
-<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/combinations/PrintableTest.java#L26-L29' title='Snippet source file'>snippet source</a> | <a href='#snippet-printable_single_lambda' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/combinations/PrintableTest.java#L22-L25' title='Snippet source file'>snippet source</a> | <a href='#snippet-printable_single_lambda' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 ### Wrap an array of objects
@@ -64,7 +64,7 @@ For convenience, if you want to do this to a whole list of items we have
 Printable<Integer> numbers[] = Printable.create(n -> "#" + n, 1, 2, 3, 4, 5);
 Approvals.verifyAll("Custom toString method", numbers, p -> String.format("%s -> %s", p, p.get()));
 ```
-<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/combinations/PrintableTest.java#L40-L43' title='Snippet source file'>snippet source</a> | <a href='#snippet-printable_array_lambda' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/combinations/PrintableTest.java#L36-L39' title='Snippet source file'>snippet source</a> | <a href='#snippet-printable_array_lambda' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 would produce
@@ -95,7 +95,7 @@ Printable<Integer> labeled[] = Printable.with().label(1, "first").label(2, "seco
     .label(4, "forth").label(5, "fifth").toArray();
 Approvals.verifyAll("Labeled", labeled, p -> String.format("%s -> %s", p, p.get()));
 ```
-<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/combinations/PrintableTest.java#L48-L52' title='Snippet source file'>snippet source</a> | <a href='#snippet-printable_array_labels' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/combinations/PrintableTest.java#L44-L48' title='Snippet source file'>snippet source</a> | <a href='#snippet-printable_array_labels' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 would produce:

approvaltests/docs/how_to/TestAVarietyOfValues.md

@@ -24,7 +24,7 @@ If you have more than one parameter that you want to vary, check out [Testing Co
 String[] inputs = {"input.value1", "input.value2"};
 Approvals.verifyAll("TITLE", inputs, s -> "placeholder " + s);
 ```
-<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/ApprovalsTest.java#L40-L43' title='Snippet source file'>snippet source</a> | <a href='#snippet-verifyallstartingpoint' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/ApprovalsTest.java#L39-L42' title='Snippet source file'>snippet source</a> | <a href='#snippet-verifyallstartingpoint' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 2. Modify the input container for your chosen values.

approvaltests/docs/reference/AwtApprovals.md

@@ -36,7 +36,7 @@ for every frame. Here is an example for a simple expanding box:
 SquareDrawer squareDrawer = new SquareDrawer();
 AwtApprovals.verifySequence(5, f -> squareDrawer.setSquareSize(f * 10));
 ```
-<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/awt/ApprovalsTest.java#L47-L50' title='Snippet source file'>snippet source</a> | <a href='#snippet-sequencepaintables' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/awt/ApprovalsTest.java#L46-L49' title='Snippet source file'>snippet source</a> | <a href='#snippet-sequencepaintables' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 **Note**: Method overloads allow specifying the time between frames or the time for each frame.