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>
This commit is contained in:
liach 2021-04-02 16:26:16 +07:00 committed by GitHub
parent 64eeb3383b
commit d440a7188c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 38 additions and 0 deletions

View File

@ -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

View File

@ -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.