Revise <p> style decisions

CONVENTIONS.md

@@ -189,10 +189,10 @@ Assume this is the decompiled content in Enigma, which does not show imports:
 ```java
 /**
  * Assume this class is from the {@code net.example.stuff} package.
- *
- * <p>You can link to {@link Optional} as it's part of the class signature (type parameter bound).
- *
- * <p>You must fully qualify {@link net.example.stuff.basic.BasicStuffUser} when linking as it is not in
+ * <p>
+ * You can link to {@link Optional} as it's part of the class signature (type parameter bound).
+ * <p>
+ * You must fully qualify {@link net.example.stuff.basic.BasicStuffUser} when linking as it is not in
  * any signature and is from a different package.
  */
 public class Stuff<T extends Optional<?>> {
@@ -203,8 +203,8 @@ public class Stuff<T extends Optional<?>> {
 
 	/**
 	 * You can link to {@link List} with the simple name as it's part of a method's signature.
-	 *
-	 * <p>You must fully qualify {@link net.example.util.UtilityClass} when linking because it is not part
+	 * <p>
+	 * You must fully qualify {@link net.example.util.UtilityClass} when linking because it is not part
 	 * of any signature (even though it is used in code) and is from a different package.
 	 */
 	public Stuff(List<Integer> opt) {

mappings/com/mojang/blaze3d/shader/GlslImportProcessor.mapping

@@ -34,8 +34,8 @@ CLASS net/minecraft/unmapped/C_zoomygsl com/mojang/blaze3d/shader/GlslImportProc
 	METHOD m_zkksxvxz process (Ljava/lang/String;)Ljava/util/List;
 		COMMENT Reads the source code supplied into a list of lines suitable for uploading to
 		COMMENT the GL Shader cache.
-		COMMENT
-		COMMENT <p>Imports are processed as per the description of this class.
+		COMMENT <p>
+		COMMENT Imports are processed as per the description of this class.
 		ARG 1 source
 	CLASS C_ctvnulwe Context
 		COMMENT A context for the parser to keep track of its current line and caret position in the file.

mappings/com/mojang/blaze3d/systems/RenderCallStorage.mapping

@@ -3,8 +3,8 @@ CLASS net/minecraft/unmapped/C_gxbhfeky com/mojang/blaze3d/systems/RenderCallSto
 	COMMENT three queues: a recording queue, a processing queue, and a last processed
 	COMMENT queue. The recording queue is equal to the processing queue during processing
 	COMMENT and different during recording.
-	COMMENT
-	COMMENT <p>This storage appears to be a work in progress, as its processing currently
+	COMMENT <p>
+	COMMENT This storage appears to be a work in progress, as its processing currently
 	COMMENT performs no operation.
 	FIELD f_ajurnmpu processing Z
 	FIELD f_cmneiads recording Z

mappings/com/mojang/blaze3d/texture/NativeImage.mapping

@@ -32,8 +32,8 @@ CLASS net/minecraft/unmapped/C_ayikuhxa com/mojang/blaze3d/texture/NativeImage
 	METHOD m_bhuofelc setPixelColor (III)V
 		COMMENT Sets the color of a pixel on this native image.
 		COMMENT The color to be set using this method should be in a ABGR format.
-		COMMENT
-		COMMENT <p>This is only supported when this native image's format is {@link NativeImage.Format#ABGR ABGR}
+		COMMENT <p>
+		COMMENT This is only supported when this native image's format is {@link NativeImage.Format#ABGR ABGR}
 		ARG 1 x
 		ARG 2 y
 		ARG 3 color
@@ -63,8 +63,8 @@ CLASS net/minecraft/unmapped/C_ayikuhxa com/mojang/blaze3d/texture/NativeImage
 	METHOD m_gnawjfwf getPixelColor (II)I
 		COMMENT Gets the color of a pixel on this native image.
 		COMMENT The color returned by this method will be in a ABGR format.
-		COMMENT
-		COMMENT <p>This is only supported when this native image's format is {@link NativeImage.Format#ABGR ABGR}.
+		COMMENT <p>
+		COMMENT This is only supported when this native image's format is {@link NativeImage.Format#ABGR ABGR}.
 		ARG 1 x
 		ARG 2 y
 	METHOD m_grhlefuk blendPixel (III)V

mappings/net/minecraft/block/AbstractBlock.mapping

@@ -140,11 +140,11 @@ CLASS net/minecraft/unmapped/C_triydqro net/minecraft/block/AbstractBlock
 	METHOD m_rocdemyx onUse (Lnet/minecraft/unmapped/C_txtbiemp;Lnet/minecraft/unmapped/C_cdctfzbn;Lnet/minecraft/unmapped/C_hynzadkk;Lnet/minecraft/unmapped/C_jzrpycqo;Lnet/minecraft/unmapped/C_laxmzoqs;Lnet/minecraft/unmapped/C_jdakttms;)Lnet/minecraft/unmapped/C_ozuepbyj;
 		COMMENT Called when this block is used by a player.
 		COMMENT This, by default, is bound to using the right mouse button.
-		COMMENT
-		COMMENT <p>This method is called on both the logical client and logical server, so take caution when overriding this method.
+		COMMENT <p>
+		COMMENT This method is called on both the logical client and logical server, so take caution when overriding this method.
 		COMMENT The logical side can be checked using {@link net.minecraft.world.World#isClient() world.isClient()}.
-		COMMENT
-		COMMENT <p>If the action result is successful on a logical client, then the action will be sent to the logical server for processing.
+		COMMENT <p>
+		COMMENT If the action result is successful on a logical client, then the action will be sent to the logical server for processing.
 		COMMENT
 		COMMENT @return an action result that specifies if using the block was successful.
 		ARG 1 state
@@ -177,8 +177,8 @@ CLASS net/minecraft/unmapped/C_triydqro net/minecraft/block/AbstractBlock
 		ARG 6 notify
 	METHOD m_umbsjste rotate (Lnet/minecraft/unmapped/C_txtbiemp;Lnet/minecraft/unmapped/C_mboglirk;)Lnet/minecraft/unmapped/C_txtbiemp;
 		COMMENT Applies a block rotation to a block state.
-		COMMENT
-		COMMENT <p>By default, this returns the provided block state.
+		COMMENT <p>
+		COMMENT By default, this returns the provided block state.
 		COMMENT
 		COMMENT @return the rotated block state
 		ARG 1 state
@@ -617,8 +617,8 @@ CLASS net/minecraft/unmapped/C_triydqro net/minecraft/block/AbstractBlock
 		METHOD m_dbqsutun liquid ()Lnet/minecraft/unmapped/C_triydqro$C_xnkxsdfy;
 		METHOD m_dfcscaql noCollision ()Lnet/minecraft/unmapped/C_triydqro$C_xnkxsdfy;
 			COMMENT Specifies that a block should have no collision bounds.
-			COMMENT
-			COMMENT <p>This also marks a block as non-opaque.
+			COMMENT <p>
+			COMMENT This also marks a block as non-opaque.
 		METHOD m_dsszzhch pistonBehavior (Lnet/minecraft/unmapped/C_mojvzhua;)Lnet/minecraft/unmapped/C_triydqro$C_xnkxsdfy;
 			ARG 1 pistonBehavior
 		METHOD m_eajltsia solidBlock (Lnet/minecraft/unmapped/C_triydqro$C_izsedryc;)Lnet/minecraft/unmapped/C_triydqro$C_xnkxsdfy;

mappings/net/minecraft/block/AbstractRailBlock.mapping

@@ -17,10 +17,12 @@ CLASS net/minecraft/unmapped/C_mgkftsgg net/minecraft/block/AbstractRailBlock
 		ARG 4 notify
 	METHOD m_oyknusit shouldDropRail (Lnet/minecraft/unmapped/C_hynzadkk;Lnet/minecraft/unmapped/C_cdctfzbn;Lnet/minecraft/unmapped/C_wqmdpcsg;)Z
 		COMMENT Checks if this rail should be dropped.
-		COMMENT
-		COMMENT <p>This method will return true if:
-		COMMENT <ul><li>The rail block is ascending.</li>
-		COMMENT <li>The block in the direction of ascent does not have a top rim.</li></ul>
+		COMMENT <p>
+		COMMENT This method will return true if:
+		COMMENT <ul>
+		COMMENT 	<li>The rail block is ascending.</li>
+		COMMENT 	<li>The block in the direction of ascent does not have a top rim.</li>
+		COMMENT </ul>
 		ARG 0 pos
 		ARG 1 world
 		ARG 2 shape

mappings/net/minecraft/block/Block.mapping

@@ -1,19 +1,19 @@
 CLASS net/minecraft/unmapped/C_mmxmpdoq net/minecraft/block/Block
 	COMMENT Represents a block that can be placed in a world.
-	COMMENT
-	COMMENT <p>There is exactly one instance for every type of block. Every stone
+	COMMENT <p>
+	COMMENT There is exactly one instance for every type of block. Every stone
 	COMMENT block for example in a world shares the same block instance. Each block
 	COMMENT instance is registered under the Block Registry.
 	COMMENT See {@link Blocks} for examples of block instances.
-	COMMENT
-	COMMENT <p>An item corresponding to a block is not automatically created. You
+	COMMENT <p>
+	COMMENT An item corresponding to a block is not automatically created. You
 	COMMENT may create your own {@link net.minecraft.item.BlockItem} and register it
 	COMMENT under the Item Registry
-	COMMENT
-	COMMENT <p>The translation key for the block name is determined by {@link
+	COMMENT <p>
+	COMMENT The translation key for the block name is determined by {@link
 	COMMENT #getTranslationKey}.
-	COMMENT
-	COMMENT <p>In the world, the actual voxels are not stored as blocks, but as
+	COMMENT <p>
+	COMMENT In the world, the actual voxels are not stored as blocks, but as
 	COMMENT {@linkplain BlockState block states}. The possible states of the block
 	COMMENT is defined by {@link appendProperties}.
 	COMMENT
@@ -66,8 +66,8 @@ CLASS net/minecraft/unmapped/C_mmxmpdoq net/minecraft/block/Block
 	METHOD m_bdlslsvh getStateManager ()Lnet/minecraft/unmapped/C_ezfeikaq;
 	METHOD m_bsuyxxeg getTranslationKey ()Ljava/lang/String;
 		COMMENT {@return the translation key for the name of this block}
-		COMMENT
-		COMMENT <p>By default, it returns {@code block.namespace.path} where {@code
+		COMMENT <p>
+		COMMENT By default, it returns {@code block.namespace.path} where {@code
 		COMMENT namespace} and {@code path} are of the identifier used for registering
 		COMMENT this block, but {@code /} in {@code path} is replaced with {@code .}.
 		COMMENT If the block is not registered, it returns {@code block.unregistered_sadface}.
@@ -180,10 +180,10 @@ CLASS net/minecraft/unmapped/C_mmxmpdoq net/minecraft/block/Block
 		ARG 3 size
 	METHOD m_ocypbslz replace (Lnet/minecraft/unmapped/C_txtbiemp;Lnet/minecraft/unmapped/C_txtbiemp;Lnet/minecraft/unmapped/C_vdvbsyle;Lnet/minecraft/unmapped/C_hynzadkk;II)V
 		COMMENT Replaces the {@code state} with the {@code newState} at the {@code pos}.
-		COMMENT
-		COMMENT <p>If the two state objects are identical, this method does nothing.
-		COMMENT
-		COMMENT <p>If the new state {@linkplain BlockState#isAir() is air},
+		COMMENT <p>
+		COMMENT If the two state objects are identical, this method does nothing.
+		COMMENT <p>
+		COMMENT If the new state {@linkplain BlockState#isAir() is air},
 		COMMENT breaks the block at the position instead.
 		ARG 0 state
 			COMMENT the existing block state
@@ -203,10 +203,10 @@ CLASS net/minecraft/unmapped/C_mmxmpdoq net/minecraft/block/Block
 		ARG 2 property
 	METHOD m_phnkbohu replace (Lnet/minecraft/unmapped/C_txtbiemp;Lnet/minecraft/unmapped/C_txtbiemp;Lnet/minecraft/unmapped/C_vdvbsyle;Lnet/minecraft/unmapped/C_hynzadkk;I)V
 		COMMENT Replaces the {@code state} with the {@code newState} at the {@code pos}.
-		COMMENT
-		COMMENT <p>If the two state objects are identical, this method does nothing.
-		COMMENT
-		COMMENT <p>If the new state {@linkplain BlockState#isAir() is air},
+		COMMENT <p>
+		COMMENT If the two state objects are identical, this method does nothing.
+		COMMENT <p>
+		COMMENT If the new state {@linkplain BlockState#isAir() is air},
 		COMMENT breaks the block at the position instead.
 		ARG 0 state
 			COMMENT the existing block state

mappings/net/minecraft/block/DyedCarpetBlock.mapping

@@ -7,6 +7,6 @@ CLASS net/minecraft/unmapped/C_jgxnpxls net/minecraft/block/DyedCarpetBlock
 		ARG 2 settings
 	METHOD m_qzraopws getDyeColor ()Lnet/minecraft/unmapped/C_arllgqae;
 		COMMENT {@return the color of this carpet when worn by a {@linkplain net.minecraft.entity.passive.LlamaEntity llama}}
-		COMMENT
-		COMMENT <p>If {@code null}, the llama will not appear to be wearing the carpet.
+		COMMENT <p>
+		COMMENT If {@code null}, the llama will not appear to be wearing the carpet.
 		COMMENT However, the carpet will remain wearable by the llama.

mappings/net/minecraft/block/entity/BellBlockEntity.mapping

@@ -62,8 +62,8 @@ CLASS net/minecraft/unmapped/C_lxkuepdf net/minecraft/block/entity/BellBlockEnti
 		ARG 1 entity
 	METHOD m_yxwdlhjo raidersHearBell (Lnet/minecraft/unmapped/C_hynzadkk;Ljava/util/List;)Z
 		COMMENT Determines whether at least one of the given entities would be affected by the bell.
-		COMMENT
-		COMMENT <p>This determines whether the bell resonates.
+		COMMENT <p>
+		COMMENT This determines whether the bell resonates.
 		COMMENT For some reason, despite affected by the bell, entities more than 32 blocks away will not count as hearing the bell.
 		ARG 0 pos
 		ARG 1 hearingEntities

mappings/net/minecraft/block/entity/EndGatewayBlockEntity.mapping

@@ -45,8 +45,8 @@ CLASS net/minecraft/unmapped/C_bgmbcwaf net/minecraft/block/entity/EndGatewayBlo
 		ARG 0 entity
 	METHOD m_tkkmaceb setupExitPortalLocation (Lnet/minecraft/unmapped/C_bdwnwhiu;Lnet/minecraft/unmapped/C_hynzadkk;)Lnet/minecraft/unmapped/C_hynzadkk;
 		COMMENT Finds teleport location and creates an island to teleport to (if there is none).
-		COMMENT
-		COMMENT <p>This does not create an exit portal.
+		COMMENT <p>
+		COMMENT This does not create an exit portal.
 		COMMENT
 		COMMENT @return the position of the exit portal
 		ARG 0 world

mappings/net/minecraft/client/MinecraftClient.mapping

@@ -3,39 +3,40 @@ CLASS net/minecraft/unmapped/C_ayfeobid net/minecraft/client/MinecraftClient
 	COMMENT The logical Minecraft client is responsible for rendering, sound playback and control input.
 	COMMENT The Minecraft client also manages connections to a logical server which may be the client's {@link net.minecraft.server.integrated.IntegratedServer} or a remote server.
 	COMMENT The Minecraft client instance may be obtained using {@link MinecraftClient#getInstance()}.
-	COMMENT
-	COMMENT <p>Rendering on a Minecraft client is split into several facilities.
+	COMMENT <p>
+	COMMENT Rendering on a Minecraft client is split into several facilities.
 	COMMENT The primary entrypoint for rendering is {@link net.minecraft.client.render.GameRenderer#render(float, long, boolean)}.
 	COMMENT <div class="quilt"><table border=1>
 	COMMENT <caption>Rendering facilities</caption>
 	COMMENT <tr>
-	COMMENT  <th><b>Thing to render</b></th> <th><b>Rendering facility</b></th>
+	COMMENT 	<th><b>Thing to render</b></th> <th><b>Rendering facility</b></th>
 	COMMENT </tr>
 	COMMENT <tr>
-	COMMENT  <td>World</td> <td>{@link net.minecraft.client.render.WorldRenderer}</td>
+	COMMENT 	<td>World</td> <td>{@link net.minecraft.client.render.WorldRenderer}</td>
 	COMMENT </tr>
 	COMMENT <tr>
-	COMMENT  <td>Blocks and Fluids</td> <td>{@link net.minecraft.client.render.block.BlockRenderManager}</td>
+	COMMENT 	<td>Blocks and Fluids</td> <td>{@link net.minecraft.client.render.block.BlockRenderManager}</td>
 	COMMENT </tr>
 	COMMENT <tr>
-	COMMENT  <td>Entities</td> <td>{@link net.minecraft.client.render.entity.EntityRenderDispatcher}</td>
+	COMMENT 	<td>Entities</td> <td>{@link net.minecraft.client.render.entity.EntityRenderDispatcher}</td>
 	COMMENT </tr>
 	COMMENT <tr>
-	COMMENT  <td>Block entities</td> <td>{@link net.minecraft.client.render.block.entity.BlockEntityRenderDispatcher}</td>
+	COMMENT 	<td>Block entities</td> <td>{@link net.minecraft.client.render.block.entity.BlockEntityRenderDispatcher}</td>
 	COMMENT </tr>
 	COMMENT <tr>
-	COMMENT  <td>Items</td> <td>{@link net.minecraft.client.render.item.ItemRenderer}</td>
+	COMMENT 	<td>Items</td> <td>{@link net.minecraft.client.render.item.ItemRenderer}</td>
 	COMMENT </tr>
 	COMMENT <tr>
-	COMMENT  <td>Items held in hand</td> <td>{@link net.minecraft.client.render.item.HeldItemRenderer}</td>
+	COMMENT 	<td>Items held in hand</td> <td>{@link net.minecraft.client.render.item.HeldItemRenderer}</td>
 	COMMENT </tr>
 	COMMENT <tr>
-	COMMENT  <td>Text</td> <td>{@link net.minecraft.client.font.TextRenderer}</td>
+	COMMENT 	<td>Text</td> <td>{@link net.minecraft.client.font.TextRenderer}</td>
 	COMMENT </tr>
 	COMMENT <tr>
 	COMMENT  <td>Game hud (health bar, hunger bar)</td> <td>{@link net.minecraft.client.gui.hud.InGameHud}</td>
 	COMMENT </tr>
-	COMMENT </table></div>
+	COMMENT </table>
+	COMMENT </div>
 	COMMENT
 	COMMENT @see net.minecraft.server.integrated.IntegratedServer
 	COMMENT @see net.minecraft.client.render.GameRenderer
@@ -241,8 +242,8 @@ CLASS net/minecraft/unmapped/C_ayfeobid net/minecraft/client/MinecraftClient
 		ARG 1 digit
 	METHOD m_eexpmkot shouldBlockMessages (Ljava/util/UUID;)Z
 		COMMENT Checks if the client should block messages from the {@code sender}.
-		COMMENT
-		COMMENT <p>If true, messages will not be displayed in chat and narrator will not process
+		COMMENT <p>
+		COMMENT If true, messages will not be displayed in chat and narrator will not process
 		COMMENT them.
 		ARG 1 sender
 	METHOD m_eezvcyrt stop ()V
@@ -318,8 +319,8 @@ CLASS net/minecraft/unmapped/C_ayfeobid net/minecraft/client/MinecraftClient
 	METHOD m_jgfcfpip isOptionalTelemetryAvailable ()Z
 	METHOD m_jiouzlzi getServer ()Lnet/minecraft/unmapped/C_mxzbwazq;
 		COMMENT Gets this client's own integrated server.
-		COMMENT
-		COMMENT <p>The integrated server is only present when a local single player world is open.
+		COMMENT <p>
+		COMMENT The integrated server is only present when a local single player world is open.
 	METHOD m_jtfycguy getVersionType ()Ljava/lang/String;
 	METHOD m_jytpvdsa countryEqualsISO3 (Ljava/lang/Object;)Z
 		ARG 0 o
@@ -405,8 +406,8 @@ CLASS net/minecraft/unmapped/C_ayfeobid net/minecraft/client/MinecraftClient
 	METHOD m_qflkyikk getSplashTextLoader ()Lnet/minecraft/unmapped/C_iyhcmfwn;
 	METHOD m_qgbmplum takeHugeScreenshot (Ljava/io/File;IIII)Lnet/minecraft/unmapped/C_rdaqiwdt;
 		COMMENT Takes a huge screenshot in the tga file format.
-		COMMENT
-		COMMENT <p>The {@code unitWidth} and {@code unitHeight} controls the size of the
+		COMMENT <p>
+		COMMENT The {@code unitWidth} and {@code unitHeight} controls the size of the
 		COMMENT partial image rendered; it does not affect the screenshot outcome, but may
 		COMMENT affect the screenshot performance.
 		COMMENT

mappings/net/minecraft/client/font/TextVisitFactory.mapping

@@ -18,8 +18,8 @@ CLASS net/minecraft/unmapped/C_qpsrdirb net/minecraft/client/font/TextVisitFacto
 		ARG 0 text
 	METHOD m_buphjbxo visitFormatted (Ljava/lang/String;ILnet/minecraft/unmapped/C_cpwnhism;Lnet/minecraft/unmapped/C_kexvwzdm;)Z
 		COMMENT Visits the code points of a string, applying the formatting codes within.
-		COMMENT
-		COMMENT <p>The visit is in forward direction.
+		COMMENT <p>
+		COMMENT The visit is in forward direction.
 		COMMENT
 		COMMENT @return {@code true} if the full string was visited, or {@code false} indicating
 		COMMENT the {@code visitor} terminated half-way
@@ -47,8 +47,8 @@ CLASS net/minecraft/unmapped/C_qpsrdirb net/minecraft/client/font/TextVisitFacto
 		ARG 3 codePoint
 	METHOD m_dhlhwpav visitFormatted (Ljava/lang/String;ILnet/minecraft/unmapped/C_cpwnhism;Lnet/minecraft/unmapped/C_cpwnhism;Lnet/minecraft/unmapped/C_kexvwzdm;)Z
 		COMMENT Visits the code points of a string, applying the formatting codes within.
-		COMMENT
-		COMMENT <p>The visit is in forward direction.
+		COMMENT <p>
+		COMMENT The visit is in forward direction.
 		COMMENT
 		COMMENT @return {@code true} if the full string was visited, or {@code false} indicating
 		COMMENT the {@code visitor} terminated half-way
@@ -68,8 +68,8 @@ CLASS net/minecraft/unmapped/C_qpsrdirb net/minecraft/client/font/TextVisitFacto
 		ARG 3 codePoint
 	METHOD m_icktwjgz visitFormatted (Ljava/lang/String;Lnet/minecraft/unmapped/C_cpwnhism;Lnet/minecraft/unmapped/C_kexvwzdm;)Z
 		COMMENT Visits the code points of a string, applying the formatting codes within.
-		COMMENT
-		COMMENT <p>The visit is in forward direction.
+		COMMENT <p>
+		COMMENT The visit is in forward direction.
 		COMMENT
 		COMMENT @return {@code true} if the full string was visited, or {@code false} indicating
 		COMMENT the {@code visitor} terminated half-way
@@ -82,8 +82,8 @@ CLASS net/minecraft/unmapped/C_qpsrdirb net/minecraft/client/font/TextVisitFacto
 	METHOD m_lcnitqwa visitFormatted (Lnet/minecraft/unmapped/C_xzalvetc;Lnet/minecraft/unmapped/C_cpwnhism;Lnet/minecraft/unmapped/C_kexvwzdm;)Z
 		COMMENT Visits the code points for every literal string and the formatting codes
 		COMMENT supplied by the renderable.
-		COMMENT
-		COMMENT <p>The visit is in forward direction.
+		COMMENT <p>
+		COMMENT The visit is in forward direction.
 		COMMENT
 		COMMENT @return {@code true} if the full string was visited, or {@code false} indicating
 		COMMENT the {@code visitor} terminated half-way

mappings/net/minecraft/client/gui/hud/InGameHud.mapping

@@ -1,7 +1,7 @@
 CLASS net/minecraft/unmapped/C_nepwsmgw net/minecraft/client/gui/hud/InGameHud
 	COMMENT Responsible for rendering the HUD elements while the player is in game.
-	COMMENT
-	COMMENT <p>The current instance used by the client can be obtained by {@link
+	COMMENT <p>
+	COMMENT The current instance used by the client can be obtained by {@link
 	COMMENT MinecraftClient#inGameHud MinecraftClient.getInstance().inGameHud}.
 	FIELD f_aazbtyrp WHITE I
 	FIELD f_akoeebzf currentStack Lnet/minecraft/unmapped/C_sddaxwyk;