Fix some documentation comments.

Author: Alex Cole

_open_mp.inc

@@ -94,7 +94,7 @@ public const __SAMP_INCLUDES_VERSION = 0x037030;
  *   </code>
  *   Thus they are encoded here as:
  *   <code>
- *      (major << 28) | (minor << 21) | (patch << 14) | (prerel)
+ *      (major &lt;&lt; 28) | (minor &lt;&lt; 21) | (patch &lt;&lt; 14) | (prerel)
  *   </code>
  *   </remarks>
  */

file.inc

@@ -257,9 +257,11 @@ native fexist(const filename[]);
  * <summary>Return the size and the time stamp of a file.</summary>
  * <param name="filename">The name of the file.</param>
  * <param name="size">If the function is successful, this param-eter holds the size of the file on return.</param>
- * <param name="timestamp">If the function is successful, this parameter holds the time of the last modification of the file on return.</param>
+ * <param name="timestamp">If the function is successful, this parameter holds the time of the last modification of the file on
+ * return.</param>
  * <param name="attrib">If the function is successful, this parameter holds the file attributes.</param>
- * <param name="inode">If the function is successful, this parameter holds inode number of the file.  An inode number is a number that uniquely identifies a file, and it usually indicates the physical position of (the start of) the file on the disk or memory card.</param>
+ * <param name="inode">If the function is successful, this parameter holds inode number of the file.  An inode number is a number that
+ * uniquely identifies a file, and it usually indicates the physical position of (the start of) the file on the disk or memory card.</param>
  * <remarks>
  * In contrast to the function flength, this function does not need the file to be opened for querying its size.
  * <p/>
@@ -312,7 +314,8 @@ native filecrc(const filename[]);
 /**
  * <library>file</library>
  * <summary>Returns the free disk space.</summary>
- * <param name="volume">The name of the volume on systems that support multiple disks or multiple memory cards.  On single-volume systems, it is optional.</param>
+ * <param name="volume">The name of the volume on systems that support multiple disks or multiple memory cards.  On single-volume systems, it
+ * is optional.</param>
  * <remarks>
  * The maximum size that can be supported 2048 GiB (2 terabyte).
  * </remarks>
@@ -324,7 +327,8 @@ forward diskfree(const volume[] = "");
  * <library>file</library>
  * <summary>Set the file attributes.</summary>
  * <param name="filename">The name of the file.</param>
- * <param name="timestamp">Time of the last modification of the file.  When this parameter is set to zero, the time stamp of the file is not changed.</param>
+ * <param name="timestamp">Time of the last modification of the file.  When this parameter is set to zero, the time stamp of the file is not
+ * changed.</param>
  * <param name="attrib">A bit mask with the new attributes of the file.  When set to 0x0F, the attributes of the file are not changed.</param>
  * <remarks>
  * The time is in number of seconds since midnight at 1 January 1970: the start of the UNIX system epoch.

omp_dialog.inc

@@ -201,7 +201,8 @@ native GetPlayerDialog(playerid) = GetPlayerDialogID;
  * <remarks>A player's dialog doesn't hide when the gamemode restarts, causing the server to print <c>"Warning:
  * PlayerDialogResponse PlayerId: 0 dialog ID doesn't match last sent dialog ID"</c> if a player responded
  * to this dialog after restart.</remarks>
- * <remarks>Parameters can contain different values, based on dialog's <a href="https://open.mp/docs/scripting/resources/dialogstyles">style</a>.
+ * <remarks>Parameters can contain different values, based on dialog's
+ * <a href="https://open.mp/docs/scripting/resources/dialogstyles">style</a>.
  * </remarks>
  * <returns>
  *   Returning <b><c>0</c></b> in this callback will pass the dialog to another script in case no matching

omp_network.inc

@@ -414,7 +414,8 @@ native NetStats_MessagesRecvPerSecond(playerid);
  * 1.0% is outright bad.</remarks>
  * <remarks>This function has been found to be currently unreliable the output is not as expected when
  * compared to the client.  Therefore this function should not be used as a packet loss kicker. </remarks>
- * <remarks>A more accurate packetloss function can be found here: <a href="https://sampforum.blast.hk/showthread.php?tid=281&pid=2488911#pid2488911">
+ * <remarks>A more accurate packetloss function can be found here:
+ * <a href="https://sampforum.blast.hk/showthread.php?tid=281&pid=2488911#pid2488911">
  * https://sampforum.blast.hk/showthread.php?tid=281&pid=2488911#pid2488911</a></remarks>
  * <returns>The percentage packet loss as a float. <b><c>0.0</c></b> if player not connected.</returns>
  */

omp_player.inc

@@ -474,7 +474,8 @@ native bool:StopAudioStreamForPlayer(playerid);
 /**
  * <library>omp_player</library>
  * <summary>Creates an explosion that is only visible to a single player.  This can be used to isolate
- * explosions from other players or to make them only appear in specific <a href="https://www.open.mp/docs/scripting/functions/SetPlayerVirtualWorld">virtual
+ * explosions from other players or to make them only appear in specific
+ * <a href="https://www.open.mp/docs/scripting/functions/SetPlayerVirtualWorld">virtual
  * worlds</a>.</summary>
  * <param name="playerid">The ID of the player to create the explosion for</param>
  * <param name="x">The x coordinate of the explosion</param>
@@ -2765,8 +2766,7 @@ forward OnPlayerStreamOut(playerid, forplayerid);
  * <param name="amount">The amount of damage the player took (health and armour combined)</param>
  * <param name="weaponid">The ID of the <a href="https://www.open.mp/docs/scripting/resources/weaponids">weapon/reason</a>
  * for the damage</param>
- * <param name="bodypart">The body part that was hit. (NOTE: This parameter was added in <b>0.3z</b>.
- *  Leave it out if using an older version!)</param>
+ * <param name="bodypart">The body part that was hit.</param>
  * <seealso name="OnPlayerGiveDamage" />
  * <seealso name="OnPlayerWeaponShot" />
  * <remarks><a href="#GetPlayerHealth">GetPlayerHealth</a> and <a href="#GetPlayerArmour">GetPlayerArmour</a>
@@ -2799,8 +2799,7 @@ forward OnPlayerTakeDamage(playerid, issuerid, Float:amount, WEAPON:weaponid, bo
  * <param name="amount">The amount of health/armour damagedid has lost (combined)</param>
  * <param name="weaponid">The <a href="https://www.open.mp/docs/scripting/resources/weaponids">reason</a> that caused the
  * damage</param>
- * <param name="bodypart">The body part that was hit. (NOTE: This parameter was added in <b>0.3z</b>.
- *  Leave it out if using an older version!)</param>
+ * <param name="bodypart">The body part that was hit.</param>
  * <seealso name="OnPlayerTakeDamage" />
  * <remarks>
  *   Keep in mind this function can be inaccurate in some cases.<br />
@@ -3009,7 +3008,8 @@ forward OnPlayerInteriorChange(playerid, newinteriorid, oldinteriorid);
  * <summary>This callback is called when the state of any supported key is changed (pressed/released).
  *  Directional keys do not trigger OnPlayerKeyStateChange (up/down/left/right).</summary>
  * <param name="playerid">The ID of the player that pressed or released a key</param>
- * <param name="newkeys">A map (bitmask) of the keys currently held - see <a href="https://www.open.mp/docs/scripting/resources/keys">here</a></param>
+ * <param name="newkeys">A map (bitmask) of the keys currently held - see <a href="https://www.open.mp/docs/scripting/resources/keys">here</a>
+ * </param>
  * <param name="oldkeys">A map (bitmask) of the keys held prior to the current change - see
  * <a href="https://www.open.mp/docs/scripting/resources/keys">here</a></param>
  * <seealso name="GetPlayerKeys" />

omp_vehicle.inc

@@ -1777,18 +1777,12 @@ forward OnVehicleDamageStatusUpdate(vehicleid, playerid);
  * <param name="playerid">The ID of the player that sent a vehicle position sync update</param>
  * <param name="passenger_seat">The ID of the seat if the player is a passenger.  0=not in vehicle,
  * 1=front passenger, 2=backleft 3=backright 4+ is for coach/bus etc.  with many passenger seats</param>
- * <param name="new_x">The new X coordinate of the vehicle.</b>
- *  Leave it out if using an earlier version</param>
- * <param name="new_y">The new Y coordinate of the vehicle.</b>
- *  Leave it out if using an earlier version</param>
- * <param name="new_z">The new Z coordinate of the vehicle.</b>
- *  Leave it out if using an earlier version</param>
- * <param name="vel_x">The new X velocity of the vehicle.</b>
- *  Leave it out if using an earlier version</param>
- * <param name="vel_y">The new Y velocity of the vehicle.</b>
- *  Leave it out if using an earlier version</param>
- * <param name="vel_z">The new Z velocity of the vehicle.</b>
- *  Leave it out if using an earlier version</param>
+ * <param name="new_x">The new X coordinate of the vehicle.</param>
+ * <param name="new_y">The new Y coordinate of the vehicle.</param>
+ * <param name="new_z">The new Z coordinate of the vehicle.</param>
+ * <param name="vel_x">The new X velocity of the vehicle.</param>
+ * <param name="vel_y">The new Y velocity of the vehicle.</param>
+ * <param name="vel_z">The new Z velocity of the vehicle.</param>
  * <seealso name="OnTrailerUpdate" />
  * <remarks>This callback is called very frequently per second per unoccupied vehicle.  You should refrain
  * from implementing intensive calculations or intensive file writing/reading operations in this callback.</remarks>

string.inc

@@ -293,7 +293,8 @@ native bool:ispacked(const string[]);
  * <summary>Convert values to text.</summary>
  * <param name="dest">The string that will contain the formatted result.</param>
  * <param name="size">The maximum number of <em>cells</em> that the dest parameter can hold. This value includes the zero terminator.</param>
- * <param name="pack">If <c>true</c>, the string in <c>dest</c> will become a packed string. Otherwise, the string in dest will be unpacked.</param>
+ * <param name="pack">If <c>true</c>, the string in <c>dest</c> will become a packed string. Otherwise, the string in dest will be unpacked.
+ * </param>
  * <param name="format">The string to store in <c>dest</c>, which may contain placeholders (see the notes below).</param>
  * <param name="...">The parameters for the placeholders.  These values may be untagged, weakly tagged, or tagged as rational values.</param>
  * <remarks>