From d440a7188c90480fe84ff41bf2e04df9e675f8b6 Mon Sep 17 00:00:00 2001
From: liach <7806504+liach@users.noreply.github.com>
Date: Fri, 2 Apr 2021 16:26:16 +0700
Subject: [PATCH] Two annotations. They write cursed annotations (#2241)

* Two annotations. They write cursed annotations

Signed-off-by: liach <liach@users.noreply.github.com>

* stuff

* Update mappings/net/minecraft/obfuscate/DontObfuscate.mapping

Co-authored-by: enbrain <69905075+enbrain@users.noreply.github.com>

Co-authored-by: liach <liach@users.noreply.github.com>
Co-authored-by: enbrain <69905075+enbrain@users.noreply.github.com>
---
 .../minecraft/obfuscate/DontObfuscate.mapping | 23 +++++++++++++++++++
 .../minecraft/util/annotation/Debug.mapping   | 15 ++++++++++++
 2 files changed, 38 insertions(+)
 create mode 100644 mappings/net/minecraft/obfuscate/DontObfuscate.mapping
 create mode 100644 mappings/net/minecraft/util/annotation/Debug.mapping

diff --git a/mappings/net/minecraft/obfuscate/DontObfuscate.mapping b/mappings/net/minecraft/obfuscate/DontObfuscate.mapping
new file mode 100644
index 0000000000..b765f50f25
--- /dev/null
+++ b/mappings/net/minecraft/obfuscate/DontObfuscate.mapping
@@ -0,0 +1,23 @@
+CLASS net/minecraft/obfuscate/DontObfuscate
+	COMMENT This annotation applies to some unobfuscated elements within the Minecraft
+	COMMENT source code.
+	COMMENT
+	COMMENT <p>Its behavior appears as follows:
+	COMMENT <ul>
+	COMMENT <li>The annotation itself is not obfuscated.</li>
+	COMMENT <li>If a class is annotated, it is not obfuscated. It's not yet clear if its
+	COMMENT members will always become deobfuscated as well.</li>
+	COMMENT <li>If a member is annotated, it and its containing class is not obfuscated,
+	COMMENT but other members in the same class may stay obfuscated.</li>
+	COMMENT </ul>
+	COMMENT
+	COMMENT <p>Visit the use page for the usage of this annotation.
+	COMMENT
+	COMMENT <p>In addition, single-abstract-method interfaces used as lambda expressions
+	COMMENT always have their single abstract method unobfuscated per proguard behavior.
+	COMMENT
+	COMMENT <p>This annotation is not {@link java.lang.annotation.Documented}, and hence
+	COMMENT will not appear in the generated javadoc for annotated elements.
+	COMMENT
+	COMMENT @see net.minecraft.util.CubicSampler.RgbFetcher
+	COMMENT @see net.minecraft.world.level.ColorResolver#getColor
diff --git a/mappings/net/minecraft/util/annotation/Debug.mapping b/mappings/net/minecraft/util/annotation/Debug.mapping
new file mode 100644
index 0000000000..02c243bebc
--- /dev/null
+++ b/mappings/net/minecraft/util/annotation/Debug.mapping
@@ -0,0 +1,15 @@
+CLASS net/minecraft/class_5996 net/minecraft/util/annotation/Debug
+	COMMENT An annotation, mostly on side-effect-free methods.
+	COMMENT
+	COMMENT <p>Most methods annotated are getters that don't cause side-effects. Some of
+	COMMENT those methods also may execute dry-runs.
+	COMMENT
+	COMMENT <p>However, it is present on {@link
+	COMMENT net.minecraft.entity.passive.BeeEntity.MoveToHiveGoal}, and its purpose in that
+	COMMENT case is not yet clear.
+	COMMENT
+	COMMENT <p>This annotation has class retention and can be applied to a wide range of
+	COMMENT targets.
+	COMMENT
+	COMMENT <p>This annotation is not {@link java.lang.annotation.Documented}, and hence
+	COMMENT will not appear in the generated javadoc for annotated elements.