HHH-18654 - Change setting docs to use an asciidoc section per setting

Author: sebersole

local-build-plugins/src/main/java/org/hibernate/orm/properties/AsciiDocWriter.java

@@ -68,9 +68,7 @@ private static void write(
 			for ( SettingDescriptor settingDescriptor : sectionSettingDescriptors ) {
 				// write an anchor in the form `[[{anchorNameBase}-{settingName}]]`
 				tryToWriteLine( writer, "[[", anchorNameBase, "-", settingDescriptor.getName(), "]]" );
-
-				writeSettingName( settingDescriptor, writer );
-				writer.write( "::\n" );
+				tryToWriteLine( writer, "==== ", settingName( settingDescriptor ) );
 
 				writeMetadata( settingDescriptor, writer );
 
@@ -88,7 +86,6 @@ private static void writeMetadata(SettingDescriptor settingDescriptor, FileWrite
 			return;
 		}
 
-		writer.write( "+\n" );
 		writer.write( "****\n" );
 
 		writer.write(
@@ -125,27 +122,24 @@ private static void writeMetadata(SettingDescriptor settingDescriptor, FileWrite
 			writer.write( settingDescriptor.getApiNote() + "\n\n" );
 		}
 
-		writer.write( "****\n+\n" );
+		writer.write( "****\n\n" );
 	}
 
-	private static void writeSettingName(SettingDescriptor settingDescriptor, FileWriter writer) throws IOException {
-		writer.write( "`" );
-		if ( settingDescriptor.getLifecycleDetails().isDeprecated() ) {
-			writer.write( "[.line-through]#" );
-		}
-		else {
-			writer.write( '*' );
-		}
-
-		writer.write( settingDescriptor.getName() );
-
+	private static String settingName(SettingDescriptor settingDescriptor) {
 		if ( settingDescriptor.getLifecycleDetails().isDeprecated() ) {
-			writer.write( '#' );
+			return String.format(
+					Locale.ROOT,
+					"`[.line-through]#%s#`",
+					settingDescriptor.getName()
+			);
 		}
 		else {
-			writer.write( '*' );
+			return String.format(
+					Locale.ROOT,
+					"`%s`",
+					settingDescriptor.getName()
+			);
 		}
-		writer.write( '`' );
 	}
 
 	private static void tryToWriteLine(Writer writer, String prefix, String value, String... other) {

local-build-plugins/src/main/java/org/hibernate/orm/properties/jdk11/DomToAsciidocConverter.java

@@ -93,9 +93,6 @@ private void visitElement(Element element) {
 	}
 
 	private void visitDiv(Element div) {
-		if ( converted.length() != 0 ) {
-			converted.append( "\n+\n" );
-		}
 		for ( Node childNode : div.childNodes() ) {
 			visitNode( childNode );
 		}
@@ -129,7 +126,6 @@ private void visitUl(Element ul) {
 		if ( converted.lastIndexOf( "\n" ) != converted.length() - 1 ) {
 			converted.append( '\n' );
 		}
-		converted.append( "+\n" );
 		for ( Node childNode : ul.childNodes() ) {
 			visitNode( childNode );
 		}

local-build-plugins/src/main/java/org/hibernate/orm/properties/jdk17/JavadocToAsciidocConverter.java

@@ -195,12 +195,9 @@ private void visitElement(Element element) {
 		}
 
 		private void visitDiv(Element div) {
-			if ( converted.length() != 0 ) {
-				converted.append( "\n+\n" );
-			}
 			boolean deprecation = div.hasClass( "deprecationBlock" );
 			if ( deprecation ) {
-				converted.append( "+\n[WARNING]\n====\n" );
+				converted.append( "[WARNING]\n====\n" );
 			}
 			for ( Node childNode : div.childNodes() ) {
 				visitNode( childNode );
@@ -238,7 +235,6 @@ private void visitUl(Element ul) {
 			if ( converted.lastIndexOf( "\n" ) != converted.length() - 1 ) {
 				converted.append( '\n' );
 			}
-			converted.append( "+\n" );
 			for ( Node childNode : ul.childNodes() ) {
 				visitNode( childNode );
 			}