Fix/cleanup/rephrase miscellaneous stuff (#983)

* Add parens around params usage in VEC_SET macro

* Remove unnecessary space character in a xml

* Use defines instead of magic values in head/tail magic comments

* Use `OS_USEC_TO_CYCLES` to make a time look better in `Graph_TaskSet00`

* `0x25800` -> `sizeof(u16[SCREEN_HEIGHT][SCREEN_WIDTH])`

* `0x803DA800` -> `0x80400000 - frame buffer size`

* Use `OS_VI_` defines instead of hex

* Add empty line after some variable declarations

* Remove unused `extern CutsceneData` in `z_bg_dy_yoseizo.c`

* `Matrix_MtxFToYXZRotS` does not use `MTXMODE_`

* Use `MTXMODE_` more

* Remove `ASCII_TO_U32`, use `'IS64'`

* Add explicit `!= NULL` in some ternaries

* Use `INV_CONTENT`, `AMMO` macros more

* Use `PLAYER_AP_` enum more to compare to `Player#heldItemActionParam`

* Get rid of lowercase hex (outside libultra)

* `gWindMill*` -> `gWindmill*`

* Format and small fix enums in `z_boss_mo.h`

* Use `CHECK_BTN_ANY` more

* Fix xz/xy mistake in comment in tektite

* Rephrase comments mentioning "the devs" in a more neutral way

* Clean-up some objectively useless parens

* Fix some negative values written as u16 instead of s16 in ichains

* `SKJ_ACTON_` -> `SKJ_ACTION_`

* Run formatter

* Fix unk_ offset of `TransformUpdateIndex#unk_10` -> `unk_0E`

* Remove comments using in-game text

* Remove `U` suffix from integer literals

* Revert "Remove `ASCII_TO_U32`, use `'IS64'`"

This reverts commit c801337dde.

* Use `PLAYER_STR_*` to compare to `CUR_UPG_VALUE(UPG_STRENGTH)`

* Add empty line after decl x2

* Revert "Use `PLAYER_STR_*` to compare to `CUR_UPG_VALUE(UPG_STRENGTH)`"

This reverts commit d80bdb32da.

* Make `CUR_UPG_VALUE(UPG_STRENGTH)` compare to integers (eventually needs its own enum)

* Only use `PLAYER_SHIELD_` enum with `Player#currentShield`

* Only use `PLAYER_TUNIC_` enum with `Player#currentTunic`

include/z64.h

@@ -67,13 +67,13 @@ typedef struct {
 } GameInfo; // size = 0x15D4
 
 typedef struct {
-    /* 0x00000 */ u16 headMagic; // 1234
+    /* 0x00000 */ u16 headMagic; // GFXPOOL_HEAD_MAGIC
     /* 0x00008 */ Gfx polyOpaBuffer[0x17E0];
     /* 0x0BF08 */ Gfx polyXluBuffer[0x800];
     /* 0x0FF08 */ Gfx overlayBuffer[0x400];
     /* 0x11F08 */ Gfx workBuffer[0x80];
     /* 0x11308 */ Gfx unusedBuffer[0x20];
-    /* 0x12408 */ u16 tailMagic; // 5678
+    /* 0x12408 */ u16 tailMagic; // GFXPOOL_TAIL_MAGIC
 } GfxPool; // size = 0x12410
 
 typedef struct {
@@ -1658,15 +1658,15 @@ typedef struct {
     /* 0x0050 */ s32 viHeight;
     /* 0x0054 */ s32 viWidth;
     /* 0x0058 */ s32 unk_58; // Right adjustment?
-    /* 0x005c */ s32 unk_5C; // Left adjustment?
+    /* 0x005C */ s32 unk_5C; // Left adjustment?
     /* 0x0060 */ s32 unk_60; // Bottom adjustment?
     /* 0x0064 */ s32 unk_64; // Top adjustment?
     /* 0x0068 */ s32 viModeBase; // enum: {0, 1, 2, 3}
-    /* 0x006c */ s32 viTvType;
+    /* 0x006C */ s32 viTvType;
     /* 0x0070 */ u32 unk_70; // bool
     /* 0x0074 */ u32 unk_74; // bool
     /* 0x0078 */ u32 unk_78; // bool
-    /* 0x007c */ u32 unk_7C; // bool
+    /* 0x007C */ u32 unk_7C; // bool
     /* 0x0080 */ u32 viFeatures;
     /* 0x0084 */ u32 unk_84;
 } ViMode;

include/z64animation.h

@@ -212,7 +212,7 @@ typedef struct {
     /* 0x0004 */ TransformData* transformData;
     /* 0x0008 */ s16* copyValues;
     /* 0x000C */ s16 unk_0C;
-    /* 0x000E */ s16 unk_10;
+    /* 0x000E */ s16 unk_0E;
 } TransformUpdateIndex; // size = 0x10
 
 typedef struct {

include/z64math.h

@@ -3,7 +3,7 @@
 
 #include "ultra64.h"
 
-#define VEC_SET(V,X,Y,Z) V.x=X;V.y=Y;V.z=Z
+#define VEC_SET(V,X,Y,Z) (V).x=(X);(V).y=(Y);(V).z=(Z)
 
 typedef struct {
     f32 x, y;