Add documentation head to all NPCs

src/npc/anju.c

@@ -1,6 +1,12 @@
+/**
+ * @file anju.c
+ * @ingroup NPCs
+ *
+ * @brief Anju NPC
+ */
 #include "entity.h"
-#include "player.h"
 #include "npc.h"
+#include "player.h"
 
 void Anju(Entity* this) {
     switch (this->action) {

src/npc/beedle.c

@@ -1,12 +1,17 @@
-#include "global.h"
+/**
+ * @file beedle.c
+ * @ingroup NPCs
+ *
+ * @brief Beedle NPC
+ */
 #include "entity.h"
+#include "functions.h"
+#include "game.h"
+#include "item.h"
 #include "message.h"
+#include "npc.h"
 #include "room.h"
 #include "script.h"
-#include "npc.h"
-#include "game.h"
-#include "functions.h"
-#include "item.h"
 
 typedef struct {
     Rect customHitbox;

src/npc/bigGoron.c

@@ -1,8 +1,14 @@
-#include "npc.h"
+/**
+ * @file bigGoron.c
+ * @ingroup NPCs
+ *
+ * @brief BigGoron NPC
+ */
 #include "functions.h"
-#include "screen.h"
 #include "hitbox.h"
 #include "item.h"
+#include "npc.h"
+#include "screen.h"
 
 static const u16 goronSounds[] = {
     SFX_VO_GORON1,

src/npc/bladeBrothers.c

@@ -1,15 +1,20 @@
-#include "global.h"
+/**
+ * @file bladeBrothers.c
+ * @ingroup NPCs
+ *
+ * @brief Blade Brothers NPC
+ */
 #include "entity.h"
 #include "flags.h"
-#include "player.h"
-#include "room.h"
-#include "message.h"
-#include "save.h"
-#include "script.h"
-#include "npc.h"
 #include "functions.h"
 #include "game.h"
 #include "item.h"
+#include "message.h"
+#include "npc.h"
+#include "player.h"
+#include "room.h"
+#include "save.h"
+#include "script.h"
 
 void sub_08068A1C(Entity*);
 void sub_08068A4C(Entity*);

src/npc/brocco.c

@@ -1,7 +1,13 @@
+/**
+ * @file brocco.c
+ * @ingroup NPCs
+ *
+ * @brief Brocco NPC
+ */
 #include "entity.h"
 #include "message.h"
-#include "save.h"
 #include "npc.h"
+#include "save.h"
 
 void sub_08063544(Entity*);
 void sub_0806362C(Entity*);

src/npc/carlov.c

@@ -1,7 +1,13 @@
-#include "sound.h"
+/**
+ * @file carlov.c
+ * @ingroup NPCs
+ *
+ * @brief Carlov NPC
+ */
 #include "entity.h"
-#include "room.h"
 #include "npc.h"
+#include "room.h"
+#include "sound.h"
 
 void Carlov(Entity* this) {
     if (this->action == 0) {

src/npc/carpenter.c

@@ -1,8 +1,13 @@
-#include "global.h"
+/**
+ * @file carpenter.c
+ * @ingroup NPCs
+ *
+ * @brief Carpenter NPC
+ */
 #include "entity.h"
-#include "player.h"
-#include "npc.h"
 #include "item.h"
+#include "npc.h"
+#include "player.h"
 
 static const SpriteLoadData gUnk_08110CA8[] = {
     { 0x51, 0x3f, 0x4 }, { 0x1451, 0x3f, 0x4 }, { 0x4001, 0x3f, 0x4 }, { 0, 0, 0 },

src/npc/castleMaid.c

@@ -1,12 +1,18 @@
+/**
+ * @file castleMaid.c
+ * @ingroup NPCs
+ *
+ * @brief Castle Maid NPC
+ */
 #define NENT_DEPRECATED
 #include "entity.h"
-#include "script.h"
-#include "save.h"
 #include "flags.h"
+#include "functions.h"
+#include "manager.h"
 #include "message.h"
 #include "npc.h"
-#include "manager.h"
-#include "functions.h"
+#include "save.h"
+#include "script.h"
 
 typedef struct {
     Entity base;

src/npc/castorWildsStatue.c

@@ -1,10 +1,16 @@
-#include "sound.h"
-#include "entity.h"
-#include "script.h"
-#include "functions.h"
-#include "flags.h"
+/**
+ * @file castorWildsStatue.c
+ * @ingroup NPCs
+ *
+ * @brief Castor Wilds Statue NPC
+ */
 #include "effects.h"
+#include "entity.h"
+#include "flags.h"
+#include "functions.h"
 #include "npc.h"
+#include "script.h"
+#include "sound.h"
 
 static const Hitbox gUnk_08110E94;
 

src/npc/cat.c

@@ -1,10 +1,15 @@
-#include "global.h"
+/**
+ * @file cat.c
+ * @ingroup NPCs
+ *
+ * @brief Cat NPC
+ */
+#include "enemy.h"
 #include "entity.h"
 #include "functions.h"
-#include "save.h"
 #include "message.h"
 #include "npc.h"
-#include "enemy.h"
+#include "save.h"
 
 static const Hitbox gUnk_08110EF0 = { 0, -1, { 5, 3, 3, 5 }, 5, 4 };
 

src/npc/clothesRack.c

@@ -1,3 +1,9 @@
+/**
+ * @file clothesRack.c
+ * @ingroup NPCs
+ *
+ * @brief Clothes Rack NPC
+ */
 #include "npc.h"
 
 void sub_0806DD90(Entity*);

src/npc/cow.c

@@ -1,9 +1,14 @@
-#include "global.h"
-#include "sound.h"
+/**
+ * @file cow.c
+ * @ingroup NPCs
+ *
+ * @brief Cow NPC
+ */
 #include "entity.h"
-#include "player.h"
-#include "npc.h"
 #include "functions.h"
+#include "npc.h"
+#include "player.h"
+#include "sound.h"
 
 void sub_0806920C(Entity* ent);
 void sub_0806924C(Entity* ent);

src/npc/cucco.c

@@ -1,6 +1,12 @@
-#include "npc.h"
+/**
+ * @file cucco.c
+ * @ingroup NPCs
+ *
+ * @brief Cucco NPC
+ */
 #include "functions.h"
 #include "kinstone.h"
+#include "npc.h"
 
 void (*const Cucco_Actions[])(Entity*);
 const u16 Cucco_Sounds[];

src/npc/cuccoChick.c

@@ -1,5 +1,11 @@
-#include "npc.h"
+/**
+ * @file cuccoChick.c
+ * @ingroup NPCs
+ *
+ * @brief Cucco Chick NPC
+ */
 #include "functions.h"
+#include "npc.h"
 
 void CuccoChick_Init(Entity*);
 void sub_0806E764(Entity*);
@@ -91,7 +97,7 @@ void sub_0806E838(Entity* this) {
 }
 
 void sub_0806E884(Entity* this) {
-    MessageNoOverlap(TEXT_INDEX(TEXT_MINISH, 0Xb6), this);
+    MessageNoOverlap(TEXT_INDEX(TEXT_MINISH, 0xB6), this);
 }
 
 void CuccoChick_Fusion(Entity* this) {

src/npc/dampe.c

@@ -1,11 +1,16 @@
-#include "global.h"
+/**
+ * @file dampe.c
+ * @ingroup NPCs
+ *
+ * @brief Dampe NPC
+ */
 #include "entity.h"
-#include "player.h"
-#include "room.h"
 #include "flags.h"
+#include "item.h"
 #include "message.h"
 #include "npc.h"
-#include "item.h"
+#include "player.h"
+#include "room.h"
 
 void Dampe(Entity* this) {
     switch (this->action) {

src/npc/din.c

@@ -1,7 +1,12 @@
-#include "global.h"
+/**
+ * @file din.c
+ * @ingroup NPCs
+ *
+ * @brief Din NPC
+ */
 #include "entity.h"
-#include "npc.h"
 #include "kinstone.h"
+#include "npc.h"
 
 void Din(Entity* this) {
     switch (this->action) {

src/npc/dog.c

@@ -1,8 +1,14 @@
-#include "entity.h"
+/**
+ * @file dog.c
+ * @ingroup NPCs
+ *
+ * @brief Dog NPC
+ */
 #include "collision.h"
+#include "entity.h"
 #include "functions.h"
-#include "npc.h"
 #include "item.h"
+#include "npc.h"
 
 void sub_08069FE8(Entity*);
 bool32 sub_08069EF0(Entity*);

src/npc/drLeft.c

@@ -1,6 +1,12 @@
-#include "npc.h"
+/**
+ * @file drLeft.c
+ * @ingroup NPCs
+ *
+ * @brief Dr Left NPC
+ */
 #include "functions.h"
 #include "item.h"
+#include "npc.h"
 
 void sub_0806BFD8(Entity* this);
 

src/npc/emma.c

@@ -1,3 +1,9 @@
+/**
+ * @file emma.c
+ * @ingroup NPCs
+ *
+ * @brief Emma NPC
+ */
 #include "entity.h"
 #include "functions.h"
 #include "screenTransitions.h"

src/npc/epona.c

@@ -1,9 +1,14 @@
-#include "global.h"
-#include "sound.h"
+/**
+ * @file epona.c
+ * @ingroup NPCs
+ *
+ * @brief Epona NPC
+ */
 #include "entity.h"
+#include "functions.h"
 #include "message.h"
 #include "npc.h"
-#include "functions.h"
+#include "sound.h"
 
 void sub_08065A64(Entity* this);
 void sub_08065AA4(Entity*);

src/npc/ezlo.c

@@ -1,3 +1,9 @@
+/**
+ * @file ezlo.c
+ * @ingroup NPCs
+ *
+ * @brief Ezlo NPC
+ */
 #include "npc.h"
 
 const u8 gUnk_08114134[];

src/npc/farmers.c

@@ -1,7 +1,13 @@
+/**
+ * @file farmers.c
+ * @ingroup NPCs
+ *
+ * @brief Farmers NPC
+ */
 #include "entity.h"
-#include "script.h"
 #include "functions.h"
 #include "npc.h"
+#include "script.h"
 
 static const SpriteLoadData gUnk_08113140[] = {
     { 0xf7, 0x48, 0x4 }, { 0x40f7, 0x48, 0x4 }, { 0, 0, 0 }, { 0xf8, 0x49, 0x4 }, { 0x40f8, 0x49, 0x4 }, { 0, 0, 0 },

src/npc/farore.c

@@ -1,4 +1,9 @@
-#include "global.h"
+/**
+ * @file farore.c
+ * @ingroup NPCs
+ *
+ * @brief Farore NPC
+ */
 #include "entity.h"
 #include "npc.h"
 #include "kinstone.h"

src/npc/festari.c

@@ -1,4 +1,9 @@
-#include "global.h"
+/**
+ * @file festari.c
+ * @ingroup NPCs
+ *
+ * @brief Festari NPC
+ */
 #include "entity.h"
 #include "functions.h"
 #include "npc.h"

src/npc/forestMinish.c

@@ -1,3 +1,9 @@
+/**
+ * @file forestMinish.c
+ * @ingroup NPCs
+ *
+ * @brief Forest Minish NPC
+ */
 #include "functions.h"
 #include "item.h"
 #include "kinstone.h"

src/npc/fusionMenuNPC.c

@@ -1,4 +1,11 @@
-#include "global.h"
+/**
+ * @file fusionMenuNPC.c
+ * @ingroup NPCs
+ *
+ * @brief Fusion Menu NPC
+ *
+ * Representation for the NPCs in the fusion menu.
+ */
 #include "entity.h"
 #include "npc.h"
 

src/npc/gentari.c

@@ -1,4 +1,9 @@
-#include "global.h"
+/**
+ * @file gentari.c
+ * @ingroup NPCs
+ *
+ * @brief Gentari NPC
+ */
 #include "entity.h"
 #include "npc.h"
 

src/npc/ghostBrothers.c

@@ -1,9 +1,15 @@
+/**
+ * @file ghostBrothers.c
+ * @ingroup NPCs
+ *
+ * @brief Ghost Brothers NPC
+ */
 #include "entity.h"
 #include "functions.h"
-#include "save.h"
-#include "screen.h"
 #include "message.h"
 #include "npc.h"
+#include "save.h"
+#include "screen.h"
 
 extern u32 gSpriteAnimations_GhostBrothers[];
 

src/npc/gina.c

@@ -1,7 +1,12 @@
-#include "global.h"
+/**
+ * @file gina.c
+ * @ingroup NPCs
+ *
+ * @brief Gina NPC
+ */
 #include "entity.h"
-#include "player.h"
 #include "npc.h"
+#include "player.h"
 
 void Gina(Entity* this) {
     switch (this->action) {

src/npc/gorman.c

@@ -1,3 +1,9 @@
+/**
+ * @file gorman.c
+ * @ingroup NPCs
+ *
+ * @brief Gorman NPC
+ */
 #include "functions.h"
 #include "npc.h"
 

src/npc/goron.c

@@ -1,3 +1,9 @@
+/**
+ * @file goron.c
+ * @ingroup NPCs
+ *
+ * @brief Goron NPC
+ */
 #include "effects.h"
 #include "entity.h"
 #include "functions.h"

src/npc/goronMerchant.c

@@ -1,11 +1,16 @@
-#include "global.h"
+/**
+ * @file goronMerchant.c
+ * @ingroup NPCs
+ *
+ * @brief Goron Merchant NPC
+ */
 #include "entity.h"
-#include "functions.h"
-#include "message.h"
 #include "flags.h"
-#include "save.h"
-#include "npc.h"
+#include "functions.h"
 #include "item.h"
+#include "message.h"
+#include "npc.h"
+#include "save.h"
 
 static u32 GoronMerchant_GetSalePrice(Entity*);
 

src/npc/gregal.c

@@ -1,7 +1,13 @@
+/**
+ * @file gregal.c
+ * @ingroup NPCs
+ *
+ * @brief Gregal NPC
+ */
 #include "entity.h"
-#include "script.h"
 #include "functions.h"
 #include "npc.h"
+#include "script.h"
 
 static const u32 gUnk_08113D84[] = {
     0x100c0200,

src/npc/guard.c

@@ -1,13 +1,18 @@
-#include "global.h"
+/**
+ * @file guard.c
+ * @ingroup NPCs
+ *
+ * @brief Guard NPC
+ */
 #include "entity.h"
-#include "player.h"
 #include "flags.h"
+#include "functions.h"
 #include "message.h"
+#include "npc.h"
+#include "player.h"
+#include "projectile.h"
 #include "room.h"
 #include "script.h"
-#include "functions.h"
-#include "npc.h"
-#include "projectile.h"
 
 typedef struct {
     u32 unk;

src/npc/guardWithSpear.c

@@ -1,11 +1,17 @@
+/**
+ * @file guardWithSpear.c
+ * @ingroup NPCs
+ *
+ * @brief Guard with Spear NPC
+ */
 #define NENT_DEPRECATED
 #include "entity.h"
-#include "script.h"
-#include "player.h"
-#include "npc.h"
 #include "functions.h"
-#include "object.h"
 #include "item.h"
+#include "npc.h"
+#include "object.h"
+#include "player.h"
+#include "script.h"
 
 typedef struct {
     Entity base;

src/npc/hurdyGurdyMan.c

@@ -1,7 +1,13 @@
+/**
+ * @file hurdyGurdyMan.c
+ * @ingroup NPCs
+ *
+ * @brief Hurdy Gurdy Man NPC
+ */
 #include "entity.h"
 #include "functions.h"
-#include "save.h"
 #include "npc.h"
+#include "save.h"
 
 static const SpriteLoadData gUnk_081144F0[] = { { 0x163, 0x59, 0x4 }, { 0x4163, 0x59, 0x4 }, { 0, 0, 0 } };
 

src/npc/kid.c

@@ -1,3 +1,9 @@
+/**
+ * @file kid.c
+ * @ingroup NPCs
+ *
+ * @brief Kid NPC
+ */
 #include "functions.h"
 #include "message.h"
 #include "npc.h"

src/npc/kingDaltus.c

@@ -1,8 +1,14 @@
+/**
+ * @file kingDaltus.c
+ * @ingroup NPCs
+ *
+ * @brief King Daltus NPC
+ */
 #include "entity.h"
-#include "script.h"
 #include "functions.h"
-#include "npc.h"
 #include "item.h"
+#include "npc.h"
+#include "script.h"
 
 void sub_08066654(Entity*);
 void sub_08066688(Entity*);

src/npc/kingGustaf.c

@@ -1,4 +1,9 @@
-#include "global.h"
+/**
+ * @file kingGustaf.c
+ * @ingroup NPCs
+ *
+ * @brief King Gustaf NPC
+ */
 #include "entity.h"
 #include "functions.h"
 #include "screen.h"

src/npc/librari.c

@@ -1,7 +1,12 @@
-#include "global.h"
+/**
+ * @file librari.c
+ * @ingroup NPCs
+ *
+ * @brief Librari NPC
+ */
 #include "entity.h"
-#include "npc.h"
 #include "item.h"
+#include "npc.h"
 
 void Librari(Entity* this) {
     switch (this->action) {

src/npc/librarians.c

@@ -1,10 +1,16 @@
+/**
+ * @file librarians.c
+ * @ingroup NPCs
+ *
+ * @brief Librarians NPC
+ */
 #include "entity.h"
-#include "script.h"
-#include "functions.h"
 #include "flags.h"
-#include "message.h"
-#include "sound.h"
+#include "functions.h"
 #include "item.h"
+#include "message.h"
+#include "script.h"
+#include "sound.h"
 
 extern void sub_08095BE0(Entity*, u32);
 

src/npc/mailbox.c

@@ -1,7 +1,12 @@
-#include "global.h"
+/**
+ * @file mailbox.c
+ * @ingroup NPCs
+ *
+ * @brief Mailbox NPC
+ */
+#include "effects.h"
 #include "entity.h"
 #include "message.h"
-#include "effects.h"
 #include "npc.h"
 
 void sub_08063280(Entity*);

src/npc/malon.c

@@ -1,7 +1,12 @@
-#include "global.h"
+/**
+ * @file malon.c
+ * @ingroup NPCs
+ *
+ * @brief Malon NPC
+ */
 #include "entity.h"
-#include "script.h"
 #include "npc.h"
+#include "script.h"
 
 void sub_08065864(Entity* this);
 void sub_08065880(Entity* this);

src/npc/mama.c

@@ -1,7 +1,13 @@
+/**
+ * @file mama.c
+ * @ingroup NPCs
+ *
+ * @brief Mama NPC
+ */
 #include "entity.h"
-#include "script.h"
-#include "save.h"
 #include "npc.h"
+#include "save.h"
+#include "script.h"
 
 static const SpriteLoadData gUnk_08113754[] = {
     { 0x101, 0x4e, 0x4 },

src/npc/marcy.c

@@ -1,8 +1,14 @@
+/**
+ * @file marcy.c
+ * @ingroup NPCs
+ *
+ * @brief Marcy NPC
+ */
 #include "entity.h"
-#include "functions.h"
 #include "flags.h"
-#include "message.h"
+#include "functions.h"
 #include "item.h"
+#include "message.h"
 
 void Marcy(Entity* this) {
     if (this->action == 0) {

src/npc/mayorHagen.c

@@ -1,9 +1,14 @@
-#include "global.h"
+/**
+ * @file mayorHagen.c
+ * @ingroup NPCs
+ *
+ * @brief Mayor Hagen NPC
+ */
 #include "entity.h"
-#include "player.h"
 #include "flags.h"
-#include "npc.h"
 #include "item.h"
+#include "npc.h"
+#include "player.h"
 
 void MayorHagen(Entity* this) {
     u32 v;

src/npc/melari.c

@@ -1,5 +1,11 @@
-#include "npc.h"
+/**
+ * @file melari.c
+ * @ingroup NPCs
+ *
+ * @brief Melari NPC
+ */
 #include "item.h"
+#include "npc.h"
 
 void sub_08068780(Entity*);
 void sub_08068708(Entity*);

src/npc/milkCart.c

@@ -1,3 +1,9 @@
+/**
+ * @file milkCart.c
+ * @ingroup NPCs
+ *
+ * @brief Milk Cart NPC
+ */
 #include "entity.h"
 #include "npc.h"
 

src/npc/minishEzlo.c

@@ -1,8 +1,14 @@
+/**
+ * @file minishEzlo.c
+ * @ingroup NPCs
+ *
+ * @brief Minish Ezlo NPC
+ */
 #define NENT_DEPRECATED
 #include "entity.h"
-#include "sound.h"
-#include "script.h"
 #include "npc.h"
+#include "script.h"
+#include "sound.h"
 
 typedef struct {
     Entity base;

src/npc/ministerPotho.c

@@ -1,8 +1,14 @@
+/**
+ * @file ministerPotho.c
+ * @ingroup NPCs
+ *
+ * @brief Minister Potho NPC
+ */
 #include "entity.h"
 #include "flags.h"
+#include "item.h"
 #include "message.h"
 #include "npc.h"
-#include "item.h"
 
 void sub_08066864(Entity*);
 void sub_080667E4(Entity*);

src/npc/moblinLady.c

@@ -1,3 +1,9 @@
+/**
+ * @file moblinLady.c
+ * @ingroup NPCs
+ *
+ * @brief Moblin Lady NPC
+ */
 #include "entity.h"
 #include "npc.h"
 

src/npc/mountainMinish.c

@@ -1,10 +1,16 @@
+/**
+ * @file mountainMinish.c
+ * @ingroup NPCs
+ *
+ * @brief Mountain Minish NPC
+ */
 #include "entity.h"
-#include "script.h"
-#include "functions.h"
-#include "message.h"
 #include "flags.h"
-#include "npc.h"
+#include "functions.h"
 #include "item.h"
+#include "message.h"
+#include "npc.h"
+#include "script.h"
 
 const u8 gUnk_08111284[][0x20] = {
     { 0x8, 0x1,  0x9, 0x1,  0xa, 0x1,  0xb, 0x83, 0xc, 0x83, 0xd, 0x83, 0xe, 0x83, 0xf, 0x80,

src/npc/mutoh.c

@@ -1,10 +1,16 @@
-#include "global.h"
+
+/**
+ * @file mutoh.c
+ * @ingroup NPCs
+ *
+ * @brief Mutoh NPC
+ */
 #include "entity.h"
-#include "player.h"
 #include "flags.h"
+#include "item.h"
 #include "message.h"
 #include "npc.h"
-#include "item.h"
+#include "player.h"
 
 static const SpriteLoadData gUnk_08110C00[] = {
     { 0x51, 0x3e, 0x4 },

src/npc/nayru.c

@@ -1,7 +1,12 @@
-#include "global.h"
+/**
+ * @file nayru.c
+ * @ingroup NPCs
+ *
+ * @brief Nayru NPC
+ */
 #include "entity.h"
-#include "npc.h"
 #include "kinstone.h"
+#include "npc.h"
 
 void Nayru(Entity* this) {
     switch (this->action) {

src/npc/npc23.c

@@ -1,9 +1,15 @@
+/**
+ * @file npc23.c
+ * @ingroup NPCs
+ *
+ * @brief NPC 23
+ */
 #include "entity.h"
-#include "player.h"
-#include "structures.h"
 #include "functions.h"
 #include "message.h"
 #include "npc.h"
+#include "player.h"
+#include "structures.h"
 
 bool32 sub_0806650C(Entity*);
 

src/npc/npc26.c

@@ -1,4 +1,9 @@
-#include "global.h"
+/**
+ * @file npc26.c
+ * @ingroup NPCs
+ *
+ * @brief NPC 26
+ */
 #include "entity.h"
 #include "npc.h"
 

src/npc/npc4E.c

@@ -1,3 +1,9 @@
+/**
+ * @file npc4E.c
+ * @ingroup NPCs
+ *
+ * @brief NPC 4E
+ */
 #include "entity.h"
 #include "flags.h"
 #include "functions.h"

src/npc/npc4F.c

@@ -1,3 +1,9 @@
+/**
+ * @file npc4F.c
+ * @ingroup NPCs
+ *
+ * @brief NPC 4F
+ */
 #include "npc.h"
 
 void NPC4F(Entity* this) {

src/npc/npc5.c

@@ -1,8 +1,14 @@
+/**
+ * @file npc5.c
+ * @ingroup NPCs
+ *
+ * @brief NPC 5
+ */
+#include "collision.h"
 #include "functions.h"
+#include "hitbox.h"
 #include "message.h"
 #include "npc.h"
-#include "hitbox.h"
-#include "collision.h"
 
 typedef struct {
     u8 unk_0;  // u8

src/npc/npc58.c

@@ -1,3 +1,9 @@
+/**
+ * @file npc58.c
+ * @ingroup NPCs
+ *
+ * @brief NPC 58
+ */
 #include "entity.h"
 #include "npc.h"
 

src/npc/npc9.c

@@ -1,4 +1,9 @@
-#include "global.h"
+/**
+ * @file npc9.c
+ * @ingroup NPCs
+ *
+ * @brief NPC 9
+ */
 #include "entity.h"
 #include "message.h"
 #include "npc.h"

src/npc/percy.c

@@ -1,9 +1,14 @@
-#include "global.h"
+/**
+ * @file percy.c
+ * @ingroup NPCs
+ *
+ * @brief Percy NPC
+ */
 #include "entity.h"
-#include "npc.h"
 #include "functions.h"
-#include "kinstone.h"
 #include "item.h"
+#include "kinstone.h"
+#include "npc.h"
 
 static const SpriteLoadData gUnk_08112E1C[] = {
     { 0x30f6, 0x47, 0x4 },

src/npc/phonograph.c

@@ -1,11 +1,17 @@
-#include "entity.h"
-#include "script.h"
-#include "functions.h"
-#include "fileselect.h"
-#include "screen.h"
+/**
+ * @file phonograph.c
+ * @ingroup NPCs
+ *
+ * @brief Phonograph NPC
+ */
 #include "common.h"
+#include "entity.h"
+#include "fileselect.h"
 #include "flags.h"
+#include "functions.h"
 #include "message.h"
+#include "screen.h"
+#include "script.h"
 
 #ifdef EU
 void sub_0806EABC(Entity* this);

src/npc/picolyteBottle.c

@@ -1,3 +1,9 @@
+/**
+ * @file picolyteBottle.c
+ * @ingroup NPCs
+ *
+ * @brief Picolyte Bottle NPC
+ */
 #define NENT_DEPRECATED
 #include "entity.h"
 #include "functions.h"

src/npc/pina.c

@@ -1,9 +1,15 @@
+/**
+ * @file pina.c
+ * @ingroup NPCs
+ *
+ * @brief Pina NPC
+ */
 #include "entity.h"
 #include "functions.h"
 #include "message.h"
-#include "save.h"
 #include "npc.h"
 #include "object.h"
+#include "save.h"
 
 void sub_08063B68(Entity* this);
 void sub_08063A80(Entity* this);

src/npc/pita.c

@@ -1,21 +1,23 @@
-#include "npc.h"
+/**
+ * @file pita.c
+ * @ingroup NPCs
+ *
+ * @brief Pita NPC
+ */
 #include "item.h"
+#include "npc.h"
 
 void Pita(Entity* this) {
     static const Hitbox gUnk_0810C428 = {
+        0,
+        2,
+        { 0, 0, 0, 0 },
 #if EU
-        0,
-        2,
-        { 0, 0, 0, 0 },
         6,
-        18,
 #else
-        0,
-        2,
-        { 0, 0, 0, 0 },
         10,
-        18,
 #endif
+        18,
     };
     if (this->action == 0) {
         this->action++;

src/npc/postman.c

@@ -1,8 +1,13 @@
-#include "global.h"
-#include "sound.h"
+/**
+ * @file postman.c
+ * @ingroup NPCs
+ *
+ * @brief Postman NPC
+ */
 #include "entity.h"
 #include "functions.h"
 #include "npc.h"
+#include "sound.h"
 #include "structures.h"
 
 extern void sub_08060528(Entity*);

src/npc/rem.c

@@ -1,6 +1,12 @@
+/**
+ * @file rem.c
+ * @ingroup NPCs
+ *
+ * @brief Rem NPC
+ */
 #include "functions.h"
-#include "npc.h"
 #include "item.h"
+#include "npc.h"
 
 extern void sub_0806A8C8(Entity*);
 

src/npc/simon.c

@@ -1,3 +1,9 @@
+/**
+ * @file simon.c
+ * @ingroup NPCs
+ *
+ * @brief Simon NPC
+ */
 #include "entity.h"
 #include "flags.h"
 #include "functions.h"

src/npc/sittingPerson.c

@@ -1,3 +1,9 @@
+/**
+ * @file sittingPerson.c
+ * @ingroup NPCs
+ *
+ * @brief Sitting Person NPC
+ */
 #include "npc.h"
 #include "functions.h"
 

src/npc/smallTownMinish.c

@@ -1,11 +1,16 @@
-#include "global.h"
+/**
+ * @file smallTownMinish.c
+ * @ingroup NPCs
+ *
+ * @brief Small Town Minish NPC
+ */
 #include "entity.h"
-#include "player.h"
-#include "script.h"
-#include "save.h"
-#include "npc.h"
 #include "functions.h"
 #include "item.h"
+#include "npc.h"
+#include "player.h"
+#include "save.h"
+#include "script.h"
 
 void SmallTownMinish(Entity* this) {
     static const Hitbox gUnk_081142FC = { -2, 1, { 0, 0, 0, 0 }, 6, 6 };

src/npc/smith.c

@@ -1,5 +1,11 @@
-#include "npc.h"
+/**
+ * @file smith.c
+ * @ingroup NPCs
+ *
+ * @brief Smith NPC
+ */
 #include "functions.h"
+#include "npc.h"
 
 static const SpriteLoadData gUnk_08110354[] = {
     { 0x4d, 0x38, 0x4 },

src/npc/stamp.c

@@ -1,10 +1,15 @@
-#include "global.h"
-#include "entity.h"
-#include "message.h"
-#include "functions.h"
+/**
+ * @file stamp.c
+ * @ingroup NPCs
+ *
+ * @brief Stamp NPC
+ */
 #include "effects.h"
-#include "npc.h"
+#include "entity.h"
+#include "functions.h"
 #include "kinstone.h"
+#include "message.h"
+#include "npc.h"
 
 void sub_08062CA4(Entity*);
 void sub_08062BD4(Entity*);

src/npc/stockwell.c

@@ -1,12 +1,18 @@
+/**
+ * @file stockwell.c
+ * @ingroup NPCs
+ *
+ * @brief Stockwell NPC
+ */
 #include "entity.h"
-#include "script.h"
-#include "room.h"
-#include "message.h"
 #include "functions.h"
+#include "game.h"
+#include "item.h"
+#include "message.h"
 #include "npc.h"
 #include "object.h"
-#include "item.h"
-#include "game.h"
+#include "room.h"
+#include "script.h"
 
 #ifndef EU
 static const Rect gUnk_0810FDA0 = { 0, 8, 10, 16 };

src/npc/sturgeon.c

@@ -1,8 +1,14 @@
+/**
+ * @file sturgeon.c
+ * @ingroup NPCs
+ *
+ * @brief Sturgeon NPC
+ */
 #include "entity.h"
 #include "functions.h"
+#include "item.h"
 #include "npc.h"
 #include "object.h"
-#include "item.h"
 
 const SpriteLoadData gUnk_0810FA38[] = {
     { 59, 140, 0 },

src/npc/syrup.c

@@ -1,5 +1,11 @@
-#include "npc.h"
+/**
+ * @file syrup.c
+ * @ingroup NPCs
+ *
+ * @brief Syrup NPC
+ */
 #include "functions.h"
+#include "npc.h"
 #include "object.h"
 
 static const SpriteLoadData gUnk_081121B4[] = {

src/npc/talon.c

@@ -1,6 +1,12 @@
-#include "npc.h"
+/**
+ * @file talon.c
+ * @ingroup NPCs
+ *
+ * @brief Talon NPC
+ */
 #include "functions.h"
 #include "item.h"
+#include "npc.h"
 
 static const SpriteLoadData gUnk_0810FEB0[] = {
     { 0x4b, 0x8b, 0 },

src/npc/teachers.c

@@ -1,9 +1,14 @@
-#include "global.h"
+/**
+ * @file teachers.c
+ * @ingroup NPCs
+ *
+ * @brief Teachers NPC
+ */
 #include "entity.h"
+#include "npc.h"
 #include "player.h"
 #include "save.h"
 #include "script.h"
-#include "npc.h"
 
 static const SpriteLoadData gUnk_08113910[] = {
     { 0x103, 0x4f, 0x4 }, { 0x2103, 0x4f, 0x4 }, { 0, 0, 0 },           { 0, 0, 0 },

src/npc/tingleSiblings.c

@@ -1,9 +1,14 @@
-#include "global.h"
+/**
+ * @file tingleSiblings.c
+ * @ingroup NPCs
+ *
+ * @brief Tingle Siblings NPC
+ */
 #include "entity.h"
-#include "npc.h"
 #include "functions.h"
 #include "item.h"
 #include "kinstone.h"
+#include "npc.h"
 
 extern void sub_08064DE4(Entity*);
 extern void sub_08064D78(Entity*);

src/npc/townMinish.c

@@ -1,8 +1,13 @@
-#include "global.h"
+/**
+ * @file townMinish.c
+ * @ingroup NPCs
+ *
+ * @brief Town Minish NPC
+ */
 #include "entity.h"
-#include "npc.h"
 #include "functions.h"
 #include "item.h"
+#include "npc.h"
 
 extern u32 sub_080B1AC8(u32, u32, u32);
 void sub_0806ACC4(Entity*);

src/npc/townsperson.c

@@ -1,6 +1,12 @@
-#include "npc.h"
+/**
+ * @file townsperson.c
+ * @ingroup NPCs
+ *
+ * @brief Townsperson NPC
+ */
 #include "functions.h"
 #include "item.h"
+#include "npc.h"
 
 typedef struct {
     u8 frame1;

src/npc/vaati.c

@@ -1,8 +1,13 @@
-#include "global.h"
+/**
+ * @file vaati.c
+ * @ingroup NPCs
+ *
+ * @brief Vaati NPC
+ */
 #include "entity.h"
+#include "functions.h"
 #include "script.h"
 #include "sound.h"
-#include "functions.h"
 
 extern void sub_08095CB0(Entity*);
 extern void CreateRepeatedSoundManager(Entity*);

src/npc/vaatiReborn.c

@@ -1,6 +1,11 @@
-#include "global.h"
-#include "npc.h"
+/**
+ * @file vaatiReborn.c
+ * @ingroup NPCs
+ *
+ * @brief Vaati Reborn NPC
+ */
 #include "functions.h"
+#include "npc.h"
 
 void VaatiRebornAction0(Entity* this);
 void VaatiRebornAction1(Entity* this);

src/npc/wheaton.c

@@ -1,3 +1,9 @@
+/**
+ * @file wheaton.c
+ * @ingroup NPCs
+ *
+ * @brief Wheaton NPC
+ */
 #include "npc.h"
 
 void Wheaton(Entity* this) {

src/npc/windTribespeople.c

@@ -1,7 +1,12 @@
-#include "global.h"
-#include "sound.h"
+/**
+ * @file windTribespeople.c
+ * @ingroup NPCs
+ *
+ * @brief Wind Tribespeople NPC
+ */
 #include "entity.h"
 #include "npc.h"
+#include "sound.h"
 
 void sub_0806C798(Entity*);
 void sub_0806C7D4(Entity*);

src/npc/zelda.c

@@ -1,9 +1,14 @@
-#include "global.h"
-#include "sound.h"
+/**
+ * @file zelda.c
+ * @ingroup NPCs
+ *
+ * @brief Zelda NPC
+ */
 #include "entity.h"
-#include "functions.h"
 #include "flags.h"
+#include "functions.h"
 #include "npc.h"
+#include "sound.h"
 
 void ZeldaFollower_Hide(Entity*, Entity*);
 void ZeldaFollower_Show(Entity*, Entity*);

src/npc/zeldaFollower.c

@@ -1,3 +1,9 @@
+/**
+ * @file zeldaFollower.c
+ * @ingroup NPCs
+ *
+ * @brief Zelda Follower NPC
+ */
 #include "common.h"
 #include "entity.h"
 #include "functions.h"