documentation

src/main/java/me/jellysquid/mods/sodium/client/render/chunk/gfni/DirectTriggers.java

@@ -7,6 +7,10 @@
 import me.jellysquid.mods.sodium.client.render.chunk.gfni.TranslucentSorting.SectionTriggers;
 import net.minecraft.util.math.ChunkSectionPos;
 
+/**
+ * Performs direct triggering for sections that can't (or shouldn't) be
+ * topologically sorted and thus aren't eligible for GFNI triggering.
+ */
 class DirectTriggers implements SectionTriggers {
 	/**
 	 * A tree map of the directly triggered sections, indexed by their

src/main/java/me/jellysquid/mods/sodium/client/render/chunk/gfni/GFNITriggers.java

@@ -7,6 +7,10 @@
 import me.jellysquid.mods.sodium.client.render.chunk.gfni.TranslucentSorting.SectionTriggers;
 import net.minecraft.util.math.ChunkSectionPos;
 
+/**
+ * Performs Global Face Normal Indexing-based triggering as described in
+ * https://hackmd.io/@douira100/sodium-sl-gfni
+ */
 class GFNITriggers implements SectionTriggers {
 	/**
 	 * A map of all the normal lists, indexed by their normal.

src/main/java/me/jellysquid/mods/sodium/client/render/chunk/gfni/TranslucentSorting.java

@@ -9,8 +9,9 @@
 import net.minecraft.util.math.ChunkSectionPos;
 
 /**
- * Global Face Normal Indexing as described in
- * https://hackmd.io/@douira100/sodium-sl-gfni
+ * This class is the central point in translucency sorting. It counts the number
+ * of translucent data objects for each sort type and delegates triggering of
+ * sections for dynamic sorting to the trigger components.
  * 
  * Distances are stored as doubles and normals are stored as float vectors.
  *