normalize javadocs

Author: Lulu13022002

data/com/mojang/blaze3d/audio/Library.mapping

@@ -8,7 +8,7 @@ CLASS com/mojang/blaze3d/audio/Library
 		ARG 1 memoryStack
 		ARG 2 enableHrtf
 	METHOD getAvailableSoundDevices ()Ljava/util/List;
-		COMMENT {@return A list of strings representing the names of available sound devices, or an empty list if no devices are available}
+		COMMENT {@return a list of strings representing the names of available sound devices, or an empty list if no devices are available}
 	METHOD getChannelCount ()I
 		COMMENT {@return the number of channels available for audio playback}
 	METHOD getCurrentDeviceName ()Ljava/lang/String;
@@ -22,27 +22,27 @@ CLASS com/mojang/blaze3d/audio/Library
 		COMMENT @return {@code true} if the default device has changed since the last time this method was called, {@code false} otherwise
 	METHOD init (Ljava/lang/String;Z)V
 		COMMENT Initializes the OpenAL device and context.
-		COMMENT @throws IllegalStateException if an error occurs during initialization.
+		COMMENT @throws IllegalStateException if an error occurs during initialization
 		ARG 1 deviceSpecifier
-			COMMENT A string specifying the name of the audio device to use, or {@code null} to use the default device.
+			COMMENT a string specifying the name of the audio device to use, or {@code null} to use the default device
 		ARG 2 enableHrtf
-			COMMENT Whether to enable HRTF (head-related transfer function) for spatial audio.
+			COMMENT whether to enable HRTF (head-related transfer function) for spatial audio
 	METHOD openDeviceOrFallback (Ljava/lang/String;)J
 		COMMENT Opens the specified audio device, or the default device if the specifier is {@code null}.
-		COMMENT @return The handle of the opened device.
-		COMMENT @throws IllegalStateException if the device cannot be opened.
+		COMMENT @return the handle of the opened device
+		COMMENT @throws IllegalStateException if the device cannot be opened
 		ARG 0 deviceSpecifier
-			COMMENT The name of the audio device to open, or {@code null} to open the default device.
+			COMMENT the name of the audio device to open, or {@code null} to open the default device
 	METHOD releaseChannel (Lcom/mojang/blaze3d/audio/Channel;)V
 		COMMENT Releases a channel.
 		COMMENT @return whether the channel was successfully released
 		ARG 1 channel
-			COMMENT The channel to release.
+			COMMENT the channel to release
 	METHOD tryOpenDevice (Ljava/lang/String;)Ljava/util/OptionalLong;
 		COMMENT Attempts to open the specified audio device.
-		COMMENT @return an {@linkplain OptionalLong} containing the handle of the opened device if successful, or empty if the device could not be opened
+		COMMENT @return an {@link OptionalLong} containing the handle of the opened device if successful, or empty if the device could not be opened
 		ARG 0 deviceSpecifier
-			COMMENT A string specifying the name of the audio device to open, or {@code null} to use the default device.
+			COMMENT a string specifying the name of the audio device to open, or {@code null} to use the default device
 	CLASS ChannelPool
 		METHOD release (Lcom/mojang/blaze3d/audio/Channel;)Z
 			ARG 1 channel

data/com/mojang/blaze3d/audio/OpenAlUtil.mapping

@@ -2,29 +2,29 @@ CLASS com/mojang/blaze3d/audio/OpenAlUtil
 	COMMENT The OpenALUtil class provides utility functions for working with OpenAL audio.
 	METHOD alErrorToString (I)Ljava/lang/String;
 		COMMENT Converts an OpenAL error code to a human-readable error message.
-		COMMENT @return A String representing the error message for the given error code.
+		COMMENT @return a String representing the error message for the given error code
 		ARG 0 errorCode
-			COMMENT The OpenAL error code to convert
+			COMMENT the OpenAL error code to convert
 	METHOD alcErrorToString (I)Ljava/lang/String;
 		COMMENT Converts an ALC error code to a human-readable error message.
-		COMMENT @return A String representing the error message for the given error code.
+		COMMENT @return a String representing the error message for the given error code
 		ARG 0 errorCode
-			COMMENT The ALC error code to convert
+			COMMENT the ALC error code to convert
 	METHOD audioFormatToOpenAl (Ljavax/sound/sampled/AudioFormat;)I
 		COMMENT Converts an AudioFormat object to the corresponding OpenAL audio format code.
-		COMMENT @return An integer representing the corresponding OpenAL audio format code.
-		COMMENT @throws IllegalArgumentException if the given AudioFormat is not a supported format.
+		COMMENT @return an integer representing the corresponding OpenAL audio format code
+		COMMENT @throws IllegalArgumentException if the given AudioFormat is not a supported format
 		ARG 0 format
-			COMMENT The AudioFormat object to convert
+			COMMENT the AudioFormat object to convert
 	METHOD checkALCError (JLjava/lang/String;)Z
 		COMMENT Checks for an ALC error and logs an error message if one is found.
-		COMMENT @return {@code true} if an ALC error was found, {@code false} otherwise.
+		COMMENT @return {@code true} if an ALC error was found, {@code false} otherwise
 		ARG 0 deviceHandle
-			COMMENT The handle of the device to check for errors on
+			COMMENT the handle of the device to check for errors on
 		ARG 2 operationState
-			COMMENT A String describing the operation being performed when the error occurred
+			COMMENT a String describing the operation being performed when the error occurred
 	METHOD checkALError (Ljava/lang/String;)Z
 		COMMENT Checks for an OpenAL error and logs an error message if one is found.
-		COMMENT @return {@code true} if an OpenAL error was found, {@code false} otherwise.
+		COMMENT @return {@code true} if an OpenAL error was found, {@code false} otherwise
 		ARG 0 operationState
-			COMMENT A String describing the operation being performed when the error occurred
+			COMMENT a String describing the operation being performed when the error occurred

data/com/mojang/blaze3d/audio/SoundBuffer.mapping

@@ -11,8 +11,8 @@ CLASS com/mojang/blaze3d/audio/SoundBuffer
 		COMMENT Returns an OptionalInt containing the OpenAL buffer handle for this SoundBuffer.
 		COMMENT If the buffer has not been created yet, creates the buffer and returns the handle.
 		COMMENT If the buffer cannot be created, returns an empty OptionalInt.
-		COMMENT @return An OptionalInt containing the OpenAL buffer handle, or an empty OptionalInt if the buffer cannot be created.
+		COMMENT @return an {@link OptionalInt} containing the OpenAL buffer handle, or an empty one, if the buffer cannot be created}
 	METHOD releaseAlBuffer ()Ljava/util/OptionalInt;
 		COMMENT Releases the OpenAL buffer associated with this SoundBuffer and returns it as an OptionalInt.
 		COMMENT If no buffer has been created yet, returns an empty OptionalInt.
-		COMMENT @return an {@linkplain OptionalInt} containing the OpenAL buffer handle, or an empty one, if the buffer has not been created
+		COMMENT @return an {@link OptionalInt} containing the OpenAL buffer handle, or an empty one, if the buffer has not been created

data/com/mojang/realmsclient/client/FileDownload.mapping

@@ -10,7 +10,7 @@ CLASS com/mojang/realmsclient/client/FileDownload
 		COMMENT Modifies a folder name to make sure it is valid to store on disk.
 		COMMENT @return the modified folder name
 		ARG 0 folderName
-			COMMENT The folder name to modify
+			COMMENT the folder name to modify
 	METHOD untarGzipArchive (Ljava/lang/String;Ljava/io/File;Lnet/minecraft/world/level/storage/LevelStorageSource;)V
 		ARG 1 worldName
 		ARG 2 tempFile

data/com/mojang/realmsclient/client/FileUpload.mapping

@@ -18,7 +18,7 @@ CLASS com/mojang/realmsclient/client/FileUpload
 		ARG 2 uploadResult
 	METHOD requestUpload (I)Lcom/mojang/realmsclient/gui/screens/UploadResult;
 		ARG 1 retries
-			COMMENT The number of times this upload has already been attempted
+			COMMENT the number of times this upload has already been attempted
 	METHOD retryUploadAfter (JI)Lcom/mojang/realmsclient/gui/screens/UploadResult;
 		ARG 1 seconds
 		ARG 3 retries

data/net/minecraft/ChatFormatting.mapping

@@ -29,7 +29,7 @@ CLASS net/minecraft/ChatFormatting
 		COMMENT Gets a value by its friendly name {@code null} if the given name does not map to a defined value.
 		ARG 0 friendlyName
 	METHOD getId ()I
-		COMMENT Returns the numerical color index that represents this formatting
+		COMMENT {@return the numerical color index that represents this formatting}
 	METHOD getName ()Ljava/lang/String;
 		COMMENT Gets the friendly name of this value.
 	METHOD getNames (ZZ)Ljava/util/Collection;
@@ -39,9 +39,9 @@ CLASS net/minecraft/ChatFormatting
 	METHOD isColor ()Z
 		COMMENT Checks if this is a color code.
 	METHOD isFormat ()Z
-		COMMENT {@code false} if this is just changing the color or resetting {@code true} otherwise.
+		COMMENT @return {@code false} if this is just changing the color or resetting {@code true} otherwise
 	METHOD lambda$static$0 (Lnet/minecraft/ChatFormatting;)Ljava/lang/String;
 		ARG 0 formatting
 	METHOD stripFormatting (Ljava/lang/String;)Ljava/lang/String;
-		COMMENT Returns a copy of the given string, with formatting codes stripped away.
+		COMMENT {@return a copy of the given string, with formatting codes stripped away}
 		ARG 0 text

data/net/minecraft/CrashReport.mapping

@@ -17,7 +17,7 @@ CLASS net/minecraft/CrashReport
 		COMMENT Gets the various sections of the crash report into the given StringBuilder
 		ARG 1 builder
 	METHOD getException ()Ljava/lang/Throwable;
-		COMMENT Returns the Throwable object that is the cause for the crash and Crash Report.
+		COMMENT {@return the Throwable object that is the cause for the crash and crash report}
 	METHOD getExceptionMessage ()Ljava/lang/String;
 		COMMENT Gets the stack trace of the Throwable that caused this crash report, or if that fails, the cause {@code .toString()}.
 	METHOD getFriendlyReport (Lnet/minecraft/ReportType;)Ljava/lang/String;
@@ -26,7 +26,7 @@ CLASS net/minecraft/CrashReport
 		ARG 1 type
 		ARG 2 links
 	METHOD getTitle ()Ljava/lang/String;
-		COMMENT Returns the description of the Crash Report.
+		COMMENT {@return the description of the crash report}
 	METHOD saveToFile (Ljava/nio/file/Path;Lnet/minecraft/ReportType;)Z
 		ARG 1 path
 		ARG 2 type

data/net/minecraft/CrashReportCategory.mapping

@@ -2,7 +2,9 @@ CLASS net/minecraft/CrashReportCategory
 	METHOD <init> (Ljava/lang/String;)V
 		ARG 1 title
 	METHOD fillInStackTrace (I)I
-		COMMENT Resets our stack trace according to the current trace, pruning the deepest 3 entries. The parameter indicates how many additional deepest entries to prune. Returns the number of entries in the resulting pruned stack trace.
+		COMMENT Resets our stack trace according to the current trace, pruning the deepest 3 entries.
+		COMMENT The parameter indicates how many additional deepest entries to prune.
+		COMMENT @return the number of entries in the resulting pruned stack trace
 		ARG 1 size
 	METHOD formatLocation (DDD)Ljava/lang/String;
 		ARG 0 x

data/net/minecraft/SharedConstants.mapping

@@ -96,7 +96,7 @@ CLASS net/minecraft/SharedConstants
 	METHOD debugVoidTerrain (Lnet/minecraft/world/level/ChunkPos;)Z
 		ARG 0 chunkPos
 	METHOD getCurrentVersion ()Lnet/minecraft/WorldVersion;
-		COMMENT @return the {@link WorldVersion world version}
+		COMMENT @return the {@linkplain WorldVersion world version}
 		COMMENT @throws IllegalStateException if a world version has not been set previously
 	METHOD getProtocolVersion ()I
 		COMMENT {@return the networking protocol version in use by this game version}

data/net/minecraft/Util.mapping

@@ -253,7 +253,8 @@ CLASS net/minecraft/Util
 		ARG 0 fileName
 		ARG 1 characterValidator
 	METHOD sequence (Ljava/util/List;)Ljava/util/concurrent/CompletableFuture;
-		COMMENT Takes a list of futures and returns a future of list that completes when all of them succeed or any of them error,
+		COMMENT Takes a list of futures.
+		COMMENT @return a future of list that completes when all of them succeed or any of them error
 		ARG 0 futures
 	METHOD sequenceFailFast (Ljava/util/List;)Ljava/util/concurrent/CompletableFuture;
 		ARG 0 completableFutures