Some missing tooltips and checking for spelling, grammar, punctuation errors etc across all tooltips (#20)

Quick pass through all tooltips to check for errors. Also added a few missing tooltips, but this is far from complete.

Author: Martin-Pitt

lsl_definitions.yaml

@@ -447,15 +447,15 @@ constants:
     type: integer
     value: '0x800'
   CHANGED_OWNER:
-    tooltip: ''
+    tooltip: The object has changed ownership.
     type: integer
     value: '0x80'
   CHANGED_REGION:
-    tooltip: ''
+    tooltip: The object has changed region.
     type: integer
     value: '0x100'
   CHANGED_REGION_START:
-    tooltip: ''
+    tooltip: The region this object is in has just come online.
     type: integer
     value: '0x400'
   CHANGED_RENDER_MATERIAL:
@@ -471,7 +471,7 @@ constants:
     type: integer
     value: '0x4'
   CHANGED_TELEPORT:
-    tooltip: ''
+    tooltip: The avatar to whom this object is attached has teleported.
     type: integer
     value: '0x200'
   CHANGED_TEXTURE:
@@ -625,7 +625,8 @@ constants:
     type: integer
     value: 2147483646
   COMBAT_LOG_ID:
-    tooltip: ''
+    tooltip: Messages from the region to the COMBAT_CHANNEL will all be from this ID.\n
+      Scripts may filter llListen calls on this ID to receive only system generated combat log messages.
     type: string
     value: "45e0fcfa-2268-4490-a51c-3e51bdfe80d1"
   CONTENT_TYPE_ATOM:
@@ -742,7 +743,7 @@ constants:
     type: integer
     value: '0'
   DAMAGE_TYPE_IMPACT:
-    tooltip: System damage generated by imapact with land or a prim.
+    tooltip: System damage generated by impact with land or a prim.
     type: integer
     value: '-1'
   DAMAGE_TYPE_NECROTIC:
@@ -1114,7 +1115,7 @@ constants:
     type: integer
     value: 1
   HTTP_PRAGMA_NO_CACHE:
-    tooltip: 'Allows enabling/disbling of the "Pragma: no-cache" header.\nUsage: [HTTP_PRAGMA_NO_CACHE,
+    tooltip: 'Allows enabling/disabling of the "Pragma: no-cache" header.\nUsage: [HTTP_PRAGMA_NO_CACHE,
       integer SendHeader]. When SendHeader is TRUE, the "Pragma: no-cache" header
       is sent by the script. This matches the default behavior. When SendHeader is
       FALSE, no "Pragma" header is sent by the script.'
@@ -2923,7 +2924,7 @@ vector position - position in local coordinates'
     type: integer
     value: 2
   PSYS_PART_START_COLOR:
-    tooltip: A vector <r.r, g.g, b.b> which determines the starting color of the object.
+    tooltip: A vector <r, g, b> which determines the starting color of the object.
     type: integer
     value: 1
   PSYS_PART_START_GLOW:
@@ -3269,7 +3270,7 @@ vector position - position in local coordinates'
     type: integer
     value: '8'
   REZ_DAMAGE_TYPE:
-    tooltip: Set the damage type applied when this object collides.
+    tooltip: Set the damage type applied when this object collides. [integer damage_type]
     type: integer
     value: '12'
   REZ_FLAGS:
@@ -3666,7 +3667,7 @@ vector position - position in local coordinates'
     type: integer
     value: '0x200'
   STATUS_DIE_AT_EDGE:
-    tooltip: Controls whether the object is returned to the owners inventory if it
+    tooltip: Controls whether the object is returned to the owner's inventory if it
       wanders off the edge of the world.\nIt is useful to set this status TRUE for
       things like bullets or rockets. The default is TRUE
     type: integer
@@ -4016,7 +4017,7 @@ vector position - position in local coordinates'
     type: integer
     value: 33
   VEHICLE_ANGULAR_FRICTION_TIMESCALE:
-    tooltip: "A vector of timescales for exponential decay of the vehicles angular\
+    tooltip: "A vector of timescales for exponential decay of the vehicle's angular\
       \ velocity about its preferred axes of motion (at, left, up).\n\t\t\tRange =\
       \ [0.07, inf) seconds for each element of the vector."
     type: integer
@@ -4026,8 +4027,8 @@ vector position - position in local coordinates'
     type: integer
     value: 35
   VEHICLE_ANGULAR_MOTOR_DIRECTION:
-    tooltip: The direction and magnitude (in preferred frame) of the vehicles angular
-      motor.The vehicle will accelerate (or decelerate if necessary) to match its
+    tooltip: The direction and magnitude (in preferred frame) of the vehicle's angular
+      motor. The vehicle will accelerate (or decelerate if necessary) to match its
       velocity to its motor.
     type: integer
     value: 19
@@ -4131,12 +4132,12 @@ vector position - position in local coordinates'
     value: 28
   VEHICLE_LINEAR_DEFLECTION_TIMESCALE:
     tooltip: The timescale for exponential success of linear deflection deflection.
-      It is another way to specify how much time it takes for the vehicles linear
+      It is another way to specify how much time it takes for the vehicle's linear
       velocity to be redirected to its preferred axis of motion.
     type: integer
     value: 29
   VEHICLE_LINEAR_FRICTION_TIMESCALE:
-    tooltip: "A vector of timescales for exponential decay of the vehicles linear\
+    tooltip: "A vector of timescales for exponential decay of the vehicle's linear\
       \ velocity along its preferred axes of motion (at, left, up).\n\t\t\tRange =\
       \ [0.07, inf) seconds for each element of the vector."
     type: integer
@@ -4146,7 +4147,7 @@ vector position - position in local coordinates'
     type: integer
     value: 31
   VEHICLE_LINEAR_MOTOR_DIRECTION:
-    tooltip: "The direction and magnitude (in preferred frame) of the vehicles linear\
+    tooltip: "The direction and magnitude (in preferred frame) of the vehicle's linear\
       \ motor. The vehicle will accelerate (or decelerate if necessary) to match its\
       \ velocity to its motor.\n\t\t\tRange of magnitude = [0, 30] meters/second."
     type: integer
@@ -4160,8 +4161,8 @@ vector position - position in local coordinates'
     type: integer
     value: 30
   VEHICLE_REFERENCE_FRAME:
-    tooltip: A rotation of the vehicles preferred axes of motion and orientation (at,
-      left, up) with respect to the vehicles local frame (x, y, z).
+    tooltip: A rotation of the vehicle's preferred axes of motion and orientation (at,
+      left, up) with respect to the vehicle's local frame (x, y, z).
     type: integer
     value: 44
   VEHICLE_TYPE_AIRPLANE:
@@ -4199,7 +4200,7 @@ vector position - position in local coordinates'
     value: 36
   VEHICLE_VERTICAL_ATTRACTION_TIMESCALE:
     tooltip: The period of wobble, or timescale for exponential approach, of the vehicle
-      to rotate such that its preferred "up" axis is oriented along the worlds "up"
+      to rotate such that its preferred "up" axis is oriented along the world's "up"
       axis.
     type: integer
     value: 37
@@ -4342,7 +4343,7 @@ events:
         tooltip: ''
         type: rotation
     tooltip: This event is triggered when a script comes within a defined angle of
-      a target rotation. The range and rotation, are set by a call to llRotTarget.
+      a target rotation. The range and rotation are set by a call to llRotTarget.
   at_target:
     arguments:
     - TargetNumber:
@@ -5386,7 +5387,7 @@ functions:
       are inclusive.\nUsing negative numbers for start and/or end causes the index
       to count backwards from the length of the list, so 0, -1 would delete the entire
       list.\nIf Start is larger than End the list deleted is the exclusion of the
-      entries; so 6, 4 would delete the entire list except for the 5th. list entry.
+      entries; so 6, 4 would delete the entire list except for the 5th list entry.
   llDeleteSubString:
     arguments:
     - Source:
@@ -5409,7 +5410,7 @@ functions:
       are inclusive.\nUsing negative numbers for Start and/or End causes the index
       to count backwards from the length of the string, so 0, -1 would delete the
       entire string.\nIf Start is larger than End, the sub-string is the exclusion
-      of the entries; so 6, 4 would delete the entire string except for the 5th. character.
+      of the entries; so 6, 4 would delete the entire string except for the 5th character.
   llDerezObject:
     arguments:
     - ID:
@@ -6557,7 +6558,7 @@ functions:
     tooltip: Returns the list of primitive attributes requested in the Parameters
       list for LinkNumber.\nPRIM_* flags can be broken into three categories, face
       flags, prim flags, and object flags.\n* Supplying a prim or object flag will
-      return that flags attributes.\n* Face flags require the user to also supply
+      return that flag's attributes.\n* Face flags require the user to also supply
       a face index parameter.
   llGetLinkSitFlags:
     arguments:
@@ -7228,7 +7229,7 @@ functions:
     func-id: 556
     return: string
     sleep: 0.0
-    tooltip: Returns an string that is the value passed to llRezObjectWithParams with
+    tooltip: Returns a string that is the value passed to llRezObjectWithParams with
       REZ_PARAM_STRING.\nIf the object was rezzed by an agent, this function returns
       an empty string.
   llGetStaticPath:
@@ -7284,7 +7285,7 @@ functions:
     return: string
     sleep: 0.0
     tooltip: Returns a sub-string from String, in a range specified by the Start and
-      End indicies (inclusive).\nUsing negative numbers for Start and/or End causes
+      End indices (inclusive).\nUsing negative numbers for Start and/or End causes
       the index to count backwards from the length of the string, so 0, -1 would capture
       the entire string.\nIf Start is greater than End, the sub string is the exclusion
       of the entries.
@@ -8880,7 +8881,7 @@ functions:
     func-id: 309
     return: void
     sleep: 1.0
-    tooltip: Opens world map for avatar who touched is is wearing the script, centred
+    tooltip: Opens world map for avatar who touched it or is wearing the script, centred
       on RegionName with Position highlighted. Only works for scripts attached to
       avatar, or during touch events.\nDirection currently has no effect.
   llMessageLinked:
@@ -10650,7 +10651,7 @@ functions:
     return: void
     sleep: 0.2
     tooltip: Sets the Render Material of Face on a linked prim, specified by LinkNumber.
-      Render Materail may be a UUID or name of a material in prim inventory.
+      Render Material may be a UUID or name of a material in prim inventory.
   llSetLinkSitFlags:
     arguments:
     - LinkNumber:
@@ -10665,7 +10666,7 @@ functions:
     func-id: 550
     return: void
     sleep: 0.0
-    tooltip: Returns the sit flags set on the specified prim in a linkset.
+    tooltip: Sets the sit flags for the specified prim in a linkset.
   llSetLinkTexture:
     arguments:
     - LinkNumber:
@@ -10795,7 +10796,7 @@ functions:
   llSetPayPrice:
     arguments:
     - Price:
-        tooltip: The default price shown in the textu input field.
+        tooltip: The default price shown in the text input field.
         type: integer
     - QuickButtons:
         tooltip: Specifies the 4 payment values shown in the payment dialog's buttons
@@ -10806,7 +10807,7 @@ functions:
     return: void
     sleep: 0.0
     tooltip: Sets the default amount when someone chooses to pay this object.\nPrice
-      is the default price shown in the textu input field.  QuickButtons specifies
+      is the default price shown in the text input field.  QuickButtons specifies
       the 4 payment values shown in the payment dialog's buttons.\nInput field and
       buttons may be hidden with PAY_HIDE constant, and may be set to their default
       values using PAY_DEFAULT.
@@ -11562,7 +11563,7 @@ functions:
     return: void
     sleep: 20.0
     tooltip: Sends an email with Subject and Message to the owner or creator of an
-      object .
+      object.
   llTeleportAgent:
     arguments:
     - AvatarID:
@@ -11753,7 +11754,7 @@ functions:
     return: void
     sleep: 0.0
     tooltip: If agent identified by AvatarID is sitting on the object the script is
-      attached to or is over land owned by the objects owner, the agent is forced
+      attached to or is over land owned by the object's owner, the agent is forced
       to stand up.
   llUnescapeURL:
     arguments:
@@ -12051,4 +12052,4 @@ controls:
     tooltip: state <target>\nIf the target state is not the same as the current one,
       change to the target state.
   while:
-    tooltip: while loop\nwhile (<condition>) {\n,,,\n}
+    tooltip: while loop\nwhile (<condition>) {\n...\n}