General - Various header fixes (#11145)

* General - Various header fixes

* more headers

* style

* more

* ret

* fix more return values

* Revert "fix more return values"

This reverts commit f9d0567.

* Apply suggestions from code review

Co-authored-by: johnb432 <58661205+johnb432@users.noreply.github.com>

* 7 headers

* Update fnc_canPlaceInBodyBag.sqf

* <X><Y> -> <X or Y>

* Apply suggestions from code review

Co-authored-by: johnb432 <58661205+johnb432@users.noreply.github.com>

* cached/erase namespace

* Update fnc_toBitmask.sqf

* Apply suggestion from @johnb432

Co-authored-by: johnb432 <58661205+johnb432@users.noreply.github.com>

* fix for doc funcs

* Update addons/vehicle_damage/functions/fnc_handleDamage.sqf

Co-authored-by: johnb432 <58661205+johnb432@users.noreply.github.com>

---------

Co-authored-by: johnb432 <58661205+johnb432@users.noreply.github.com>

Author: PabstMirror

addons/advanced_throwing/functions/fnc_drawArc.sqf

@@ -7,7 +7,7 @@
  * None
  *
  * Return Value:
- * Flight path (just for debug) <ARRAY>
+ * Flight path (just for debug) <ARRAY or NIL>
  *
  * Example:
  * call ace_advanced_throwing_fnc_drawArc

addons/artillerytables/functions/fnc_interactMenuOpened.sqf

@@ -7,7 +7,7 @@
  * 0: Menu Type (1 is self interaction) <NUMBER>
  *
  * Return Value:
- * Can Open <BOOL>
+ * None
  *
  * Example:
  * [1] call ace_artillerytables_fnc_interactMenuOpened

addons/attach/functions/fnc_canAttach.sqf

@@ -6,7 +6,7 @@
  * Arguments:
  * 0: vehicle that it will be attached to (player or vehicle) <OBJECT>
  * 1: unit doing the attach (player) <OBJECT>
- * 2: Array empty or containing a string of the attachable item <ARRAY>
+ * 2: Array empty or containing a string of the attachable item <STRING or ARRAY of STRING>
  *
  * Return Value:
  * Can Attach <BOOL>

addons/attach/functions/fnc_placeApprove.sqf

@@ -15,7 +15,7 @@
  * 3: Light Vehicle Classname <STRING>
  * 4: On Attach Text <STRING>
  * 5: Starting Pos of dummy item <ARRAY>
- * 5: Orientation of model <ARRAY>
+ * 6: Orientation of model <ARRAY>
  *
  * Return Value:
  * None

addons/backpacks/functions/fnc_backpackOpened.sqf

@@ -5,14 +5,13 @@
  *
  * Arguments:
  * 0: Who accessed your inventory? <OBJECT>
- * 1: Unit that wields the backpack <OBJECT>
- * 2: The backpack object <OBJECT>
+ * 1: The backpack object <OBJECT>
  *
  * Return Value:
  * None
  *
  * Example:
- * [bob, kevin, backpack] call ace_backpacks_fnc_backpackOpened
+ * [bob, backpack] call ace_backpacks_fnc_backpackOpened
  *
  * Public: No
  */

addons/captives/functions/fnc_doApplyHandcuffs.sqf

@@ -8,7 +8,7 @@
  * 1: target <OBJECT>
  *
  * Return Value:
- * The return value <BOOL>
+ * None
  *
  * Example:
  * [player, bob] call ACE_captives_fnc_doApplyHandcuffs;

addons/captives/functions/fnc_doRemoveHandcuffs.sqf

@@ -8,7 +8,7 @@
  * 1: Target <OBJECT>
  *
  * Return Value:
- * The return value <BOOL>
+ * None
  *
  * Example:
  * [bob, bill] call ACE_captives_fnc_doRemoveHandcuffs

addons/captives/functions/fnc_handleGetIn.sqf

@@ -9,7 +9,7 @@
  * 2: _unit <OBJECT>
  *
  * Return Value:
- * The return value <BOOL>
+ * None
  *
  * Example:
  * [car2, x, player] call ACE_captives_fnc_handleGetIn

addons/captives/functions/fnc_handleGetOut.sqf

@@ -9,7 +9,7 @@
  * 2: _unit <OBJECT>
  *
  * Return Value:
- * The return value <BOOL>
+ * None
  *
  * Example:
  * [car2, x, player] call ACE_captives_fnc_handleGetOut

addons/captives/functions/fnc_handleOnUnconscious.sqf

@@ -5,7 +5,7 @@
  *
  * Arguments:
  * 0: Unit <OBJECT>
- * 0: Is Unconsisisiouses <BOOL>
+ * 1: Is Unconscious <BOOL>
  *
  * Return Value:
  * None