Limit docs code snippets line length to max 60 chars (#317 / #318)

docs/default-locale-timezone.adoc

@@ -14,7 +14,8 @@ The default `Locale` can be specified using an https://docs.oracle.com/javase/8/
 @Test
 @DefaultLocale("zh-Hant-TW")
 void test_with_lanuage() {
-	assertThat(Locale.getDefault()).isEqualTo(Locale.forLanguageTag("zh-Hant-TW"));
+	assertThat(Locale.getDefault()).
+		isEqualTo(Locale.forLanguageTag("zh-Hant-TW"));
 }
 ----
 
@@ -29,19 +30,25 @@ Alternatively the default `Locale` can be specified according to https://docs.or
 @Test
 @DefaultLocale(language = "en")
 void test_with_lanuage() {
-	assertThat(Locale.getDefault()).isEqualTo(new Locale("en"));
+	assertThat(Locale.getDefault()).
+		isEqualTo(new Locale("en"));
 }
 
 @Test
-@DefaultLocale(language = "en", country = "EN")
+@DefaultLocale(language = "en",
+				country = "EN")
 void test_with_lanuage_and_country() {
-	assertThat(Locale.getDefault()).isEqualTo(new Locale("en", "EN"));
+	assertThat(Locale.getDefault()).
+		isEqualTo(new Locale("en", "EN"));
 }
 
 @Test
-@DefaultLocale(language = "en", country = "EN", variant = "gb")
+@DefaultLocale(language = "en",
+				country = "EN",
+				variant = "gb")
 void test_with_lanuage_and_country_and_vairant() {
-	assertThat(Locale.getDefault()).isEqualTo(new Locale("en", "EN", "gb"));
+	assertThat(Locale.getDefault()).
+		isEqualTo(new Locale("en", "EN", "gb"));
 }
 ----
 
@@ -58,13 +65,15 @@ class MyLocaleTests {
 
 	@Test
 	void test_with_class_level_configuration() {
-		assertThat(Locale.getDefault()).isEqualTo(new Locale("fr"));
+		assertThat(Locale.getDefault()).
+			isEqualTo(new Locale("fr"));
 	}
 
 	@Test
 	@DefaultLocale(language = "en")
 	void test_with_method_level_configuration() {
-		assertThat(Locale.getDefault()).isEqualTo(new Locale("en"));
+		assertThat(Locale.getDefault()).
+			isEqualTo(new Locale("en"));
 	}
 }
 ----
@@ -78,13 +87,15 @@ The default `TimeZone` is specified according to the https://docs.oracle.com/jav
 @Test
 @DefaulTimeZone("CET")
 void test_with_short_zone_id() {
-	assertThat(TimeZone.getDefault()).isEqualTo(TimeZone.getTimeZone("CET"));
+	assertThat(TimeZone.getDefault()).
+		isEqualTo(TimeZone.getTimeZone("CET"));
 }
 
 @Test
-@DefaultTimeZone("America/Los_Angeles")
+@DefaultTimeZone("Africa/Juba")
 void test_with_long_zone_id() {
-	assertThat(TimeZone.getDefault()).isEqualTo(TimeZone.getTimeZone("America/Los_Angeles"));
+	assertThat(TimeZone.getDefault()).
+		isEqualTo(TimeZone.getTimeZone("Africa/Juba"));
 }
 ----
 
@@ -97,13 +108,15 @@ class MyTimeZoneTests {
 
 	@Test
 	void test_with_class_level_configuration() {
-		assertThat(TimeZone.getDefault()).isEqualTo(TimeZone.getTimeZone("CET"));
+		assertThat(TimeZone.getDefault()).
+			isEqualTo(TimeZone.getTimeZone("CET"));
 	}
 
 	@Test
-	@DefaultTimeZone("America/Los_Angeles")
+	@DefaultTimeZone("Africa/Juba")
 	void test_with_method_level_configuration() {
-		assertThat(TimeZone.getDefault()).isEqualTo(TimeZone.getTimeZone("America/Los_Angeles"));
+		assertThat(TimeZone.getDefault()).
+			isEqualTo(TimeZone.getTimeZone("Africa/Juba"));
 	}
 }
 ----

docs/disable-if-display-name.adoc

@@ -12,14 +12,16 @@ As a consequence, instead of disabling the entire set of parameterized tests, ea
 @DisableIfDisplayName(contains = "disable")
 @ParameterizedTest(name = "See if enabled with {0}")
 @ValueSource(
-		strings = {
-				"disable who", // ~> disabled
-				"you, disable you", // ~> disabled
-				"why am I disabled", // ~> disabled
-				"what has been disabled must stay disabled", // ~> disabled
-				"fine disable me all you want", // ~> disabled
-				"not those one, though!" // ~> NOT disabled
-		}
+	// Disabled: 1,2,3, 4,5
+	// Not disabled: 6
+	strings = {
+		"disable who", // 1
+		"you, disable you", // 2
+		"why am I disabled", // 3
+		"what has been disabled must stay disabled", // 4
+		"fine disable me all you want", // 5
+		"not those one, though!" // 6
+	}
 )
 void testExecutionDisabled(String reason) {
 	if (reason.contains("disable"))
@@ -44,18 +46,21 @@ If substrings are not powerful enough, you can also use regular expressions:
 
 [source,java]
 ----
-// disable invocations whose display name contains "disable " or "disabled "
+// disable invocations whose display name
+// contains "disable " or "disabled "
 @DisableIfDisplayName(matches = ".*disabled?\\s.*")
 @ParameterizedTest(name = "See if enabled with {0}")
 @ValueSource(
-		strings = {
-				"disable who", // ~> disabled
-				"you, disable you", // ~> disabled
-				"why am I disabled", // ~> NOT disabled
-				"what has been disabled must stay disabled", // ~> disabled
-				"fine disable me all you want", // ~> disabled
-				"not those one, though!" // ~> NOT disabled
-		}
+	// Disabled: 1,2,4,5
+	// Not disabled: 3,6
+	strings = {
+		"disable who", // 1
+		"you, disable you", // 2
+		"why am I disabled", // 3
+		"what has been disabled must stay disabled", // 4
+		"fine disable me all you want", // 5
+		"not those one, though!" // 6
+	}
 )
 void single(String reason) {
 	// ...
@@ -73,4 +78,4 @@ void containsAndMatches_containsAndMatches(int number) {
 	if (number != 100)
 		fail("Test should've been disabled for " + number);
 }
-----
+----

docs/environment-variables.adoc

@@ -27,9 +27,11 @@ And setting a environment variable for a test execution:
 [source,java]
 ----
 @Test
-@SetEnvironmentVariable(key = "some variable", value = "new value")
+@SetEnvironmentVariable(key = "some variable",
+						value = "new value")
 void test() {
-	assertThat(System.getenv("some variable")).isEqualTo("new value");
+	assertThat(System.getenv("some variable")).
+		isEqualTo("new value");
 }
 ----
 
@@ -40,11 +42,15 @@ As mentioned before, both annotations are repeatable and they can also be combin
 @Test
 @ClearEnvironmentVariable(key = "1st variable")
 @ClearEnvironmentVariable(key = "2nd variable")
-@SetEnvironmentVariable(key = "3rd variable", value = "new value")
+@SetEnvironmentVariable(key = "3rd variable",
+						value = "new value")
 void test() {
-	assertThat(System.getenv("1st variable")).isNull();
-	assertThat(System.getenv("2nd variable")).isNull();
-	assertThat(System.getenv("3rd variable")).isEqualTo("new value");
+	assertThat(System.getenv("1st variable")).
+		isNull();
+	assertThat(System.getenv("2nd variable")).
+		isNull();
+	assertThat(System.getenv("3rd variable")).
+		isEqualTo("new value");
 }
 ----
 
@@ -55,9 +61,11 @@ Note that class level configurations are overwritten by method level configurati
 @ClearEnvironmentVariable(key = "some variable")
 class MyEnvironmentVariableTest {
 	@Test
-	@SetEnvironmentVariable(key = "some variable", value = "new value")
+	@SetEnvironmentVariable(key = "some variable",
+							value = "new value")
 	void test() {
-		assertThat(System.getenv("some variable")).isEqualTo("new value");
+		assertThat(System.getenv("some variable")).
+			isEqualTo("new value");
 	}
 }
 ----

docs/range-sources.adoc

@@ -28,9 +28,9 @@ It can be positive or negative:
 @ParameterizedTest
 @DoubleRangeSource(from = -0.1, to = -10, step = -0.1)
 void howColdIsIt(double d) {
-	System.out.println(d + " degrees Celsius is cold");
-	System.out.println(d + " degrees Fahrenheit is REALY cold");
-	System.out.println(d + " degrees Kelvin is too cold to be true");
+	System.out.println(d + " °C is cold");
+	System.out.println(d + " °F is REALY cold");
+	System.out.println(d + " K is too cold to be true");
 }
 ----
 

docs/report-entries.adoc

@@ -72,8 +72,10 @@ Just like `TestReporter::publishEntry` accepts a single string as value or a key
 [source,java]
 ----
 @Test
-@ReportEntry(key = "line1", value = "Once upon a midnight dreary")
-@ReportEntry(key = "line2", value = "While I pondered weak and weary")
+@ReportEntry(key = "line1",
+			value = "Once upon a midnight dreary")
+@ReportEntry(key = "line2",
+			value = "While I pondered weak and weary")
 void edgarAllanPoe() {
 	// YOUR TEST CODE HERE
 }
@@ -89,7 +91,9 @@ Just so:
 [source,java]
 ----
 @Test
-@ReportEntry(key = "line", value = "success entry", when = ReportEntry.PublishCondition.ON_SUCCESS)
+@ReportEntry(key = "line",
+			value = "success entry",
+			when = ReportEntry.PublishCondition.ON_SUCCESS)
 void sufferingFromSuccess() {
 	// YOUR TEST CODE HERE
 }

docs/retrying-test.adoc

@@ -43,7 +43,8 @@ The first two executions are marked as ignored/aborted, while the last as failed
 ```java
 @RetryingTest(3)
 void aborted() {
-	// test code that is aborted e.g. because of an Assumption.
+	// test code that is aborted,
+	// e.g. because of an Assumption.
 }
 ```
 

docs/standard-input-output.adoc

@@ -142,7 +142,8 @@ class ExampleConsoleReader {
 	private List<String> lines = new ArrayList<>();
 
 	public void readLines() {
-		BufferedReader reader = new BufferedReader(new InputStreamReader(System.in));
+		InputStreamReader is = new InputStreamReader(System.in);
+		BufferedReader reader = new BufferedReader(is);
 		for (int i = 0; i < 2; i++) {
 			String line = reader.readLine();
 			lines.add(line);
@@ -158,17 +159,22 @@ This is the unit test for this class, using `StdIoExtension`:
 
 [source, java]
 ----
-class ExampleConsoleReaderTest {
+class ConsoleReaderTest {
 
 	@Test
 	@StdIo({ "line1", "line2", "line3" })
 	void testReadLines(StdIn in) {
-		ExampleConsoleReader consoleReader = new ExampleConsoleReader();
+		ConsoleReader consoleReader = new ConsoleReader();
 
 		consoleReader.readLines();
 
-		// assertEquals(in.capturedLines(), "line1", "line2"); // This is failing
-		// assertEquals(in.capturedLines(), "line1", "line2", "line3"); // This is passing
+		String[] lines = in.capturedLines();
+
+		// This failing
+		// assertEquals(lines, "line1", "line2");
+
+		// This is passing
+		// assertEquals(lines, "line1", "line2", "line3");
 	}
 
 }

docs/system-properties.adoc

@@ -13,7 +13,8 @@ For example, clearing a system property for a test execution can be done as foll
 @Test
 @ClearSystemProperty(key = "some property")
 void test() {
-	assertThat(System.getProperty("some property")).isNull();
+	assertThat(System.getProperty("some property")).
+			isNull();
 }
 ----
 
@@ -22,9 +23,11 @@ And setting a system property for a test execution:
 [source,java]
 ----
 @Test
-@SetSystemProperty(key = "some property", value = "new value")
+@SetSystemProperty(key = "some property",
+					value = "new value")
 void test() {
-	assertThat(System.getProperty("some property")).isEqualTo("new value");
+	assertThat(System.getProperty("some property")).
+		isEqualTo("new value");
 }
 ----
 
@@ -35,11 +38,15 @@ As mentioned before, both annotations are repeatable and they can also be combin
 @Test
 @ClearSystemProperty(key = "1st property")
 @ClearSystemProperty(key = "2nd property")
-@SetSystemProperty(key = "3rd property", value = "new value")
+@SetSystemProperty(key = "3rd property",
+					value = "new value")
 void test() {
-	assertThat(System.getProperty("1st property")).isNull();
-	assertThat(System.getProperty("2nd property")).isNull();
-	assertThat(System.getProperty("3rd property")).isEqualTo("new value");
+	assertThat(System.getProperty("1st property")).
+		isNull();
+	assertThat(System.getProperty("2nd property")).
+        isNull();
+	assertThat(System.getProperty("3rd property")).
+		isEqualTo("new value");
 }
 ----
 
@@ -50,9 +57,11 @@ Note that class level configurations are overwritten by method level configurati
 @ClearSystemProperty(key = "some property")
 class MySystemPropertyTest {
 	@Test
-	@SetSystemProperty(key = "some property", value = "new value")
+	@SetSystemProperty(key = "some property",
+						value = "new value")
 	void test() {
-		assertThat(System.getProperty("some property")).isEqualTo("new value");
+		assertThat(System.getProperty("some property")).
+			isEqualTo("new value");
 	}
 }
 ----