Polish "Escape reserved asciidoc character in generated documentation"

See spring-projectsgh-17663

Author: snicoll

Diff for: spring-boot-project/spring-boot-tools/spring-boot-configuration-docs/src/main/java/org/springframework/boot/configurationdocs/SingleConfigurationTableEntry.java

@@ -76,7 +76,8 @@ private void writeDescription(AsciidocBuilder builder) {
 			builder.append("|");
 		}
 		else {
-			builder.append("|+++", this.description.replace("|", "\\|"), "+++");
+			String cleanedDescription = this.description.replace("|", "\\|");
+			builder.append("|+++", cleanedDescription, "+++");
 		}
 	}
 

Diff for: spring-boot-project/spring-boot-tools/spring-boot-configuration-docs/src/test/java/org/springframework/boot/configurationdocs/SingleConfigurationTableEntryTests.java

@@ -90,13 +90,12 @@ void defaultValueWithBackslash() {
 	void descriptionWithPipe() {
 		ConfigurationMetadataProperty property = new ConfigurationMetadataProperty();
 		property.setId("spring.test.prop");
-		property.setDefaultValue("first\\second");
 		property.setDescription("This is a description with a | pipe.");
 		property.setType("java.lang.String");
 		SingleConfigurationTableEntry entry = new SingleConfigurationTableEntry(property);
 		AsciidocBuilder builder = new AsciidocBuilder();
 		entry.write(builder);
-		assertThat(builder.toString()).isEqualTo("|`+spring.test.prop+`" + NEWLINE + "|`+first\\\\second+`" + NEWLINE
+		assertThat(builder.toString()).isEqualTo("|`+spring.test.prop+`" + NEWLINE + "|" + NEWLINE
 				+ "|+++This is a description with a \\| pipe.+++" + NEWLINE);
 	}