kernel: reorder, cleanup & document code in julia_gc.c (#5719)

Move all type and variable declarations to the top, add many
comments, and many other small tweaks.

No functional changes.