[[ Docs ]] Various wording tweaks and reference updates

livecodeali · livecodeali · commit 3c8fce859a80 · 2015-07-31T13:47:36.000+01:00
diff --git a/docs/dictionary/command/create-widget.lcdoc b/docs/dictionary/command/create-widget.lcdoc
@@ -25,20 +25,20 @@ end repeat
 
 Parameters:
 controlName: The name to call the newly created <widget>. If you don't specify a name, the <widget> is created with a default name.
-widgetKind: The <kind> of <widget> to create. 
+widgetKind: The name of the module that defines the widget to be created.
 group: A reference or an expression that evaluates to a reference to a group on the current card. If you specify a group, the new <widget> is a member of the <group>, and exists on each <card> that has the <group>. If you don't specify a <group>, the <widget> is created on the current <card> and appears only on that <card>.
 
 It: The <create widget> command places the ID property of the newly created <widget> in the <it> variable.
 
 Description:
-Use the <create widget> command to make a new <widget> control or grouped <widget> control.
+Use the <create widget> command to make a new <widget> control or grouped <widget> control of <kind> <widgetKind>.
 
 If you use the invisible form, the <widget> is created with its <visible> property set to false, so it cannot be seen. Use this form to create a hidden <widget>, change its appearance or position, then make it visible.
 
 When the new <widget> is created, the pointer tool is automatically chosen.
 
 >*Note:* The <LCB extension|extension> of the specified <kind> must have been loaded using the <load extension> command. To see a list of the currently loaded <LiveCode Builder extension|extensions>, use the <loadedExtensions> <function>.
 
-References: kind (property), load extension (command), loadedExtensions (function), widget (object), card (object), group (object), visible (property), LiveCode Builder extension (glossary)
+References: kind (property), load extension (command), loadedExtensions (function), widget (object), card (object), group (object), visible (property), LiveCode Builder extension (glossary), it (keyword)
 
 Tags: objects, extensions
diff --git a/docs/dictionary/command/load-extension.lcdoc b/docs/dictionary/command/load-extension.lcdoc
@@ -25,7 +25,7 @@ load extension from data tExtensionData with resource path (tMyExtensionFolder &
 
 Parameters:
 filePath: The path to a compiled <LiveCode Builder extension> file.
-moduleData: Binary data that constitues a valid compiled <LiveCode Builder extension>.
+moduleData: Binary data that constitutes a valid compiled <LiveCode Builder extension>.
 resourcePath: The path to use for any operations in the <LiveCode Builder extension|extensions> that use resource files (eg 'image from resource file').
 
 The result:
@@ -36,6 +36,6 @@ Use the <load extension> <command> to load a <LiveCode Builder extension>.
 If the extension is a library, its public handlers will be added to the bottom of the message path.
 If it is a widget, it will be available as a control in the tools palette to drag out, or to create with the <create widget> <command>.
 
-References: unload extension (command), loadedExtensions (function), create widget (command), LiveCode Builder extension (glossary)
+References: unload extension (command), loadedExtensions (function), create widget (command), LiveCode Builder extension (glossary), result (function)
 
 Tags: extensions
diff --git a/docs/dictionary/function/loadedExtensions.lcdoc b/docs/dictionary/function/loadedExtensions.lcdoc
@@ -30,6 +30,6 @@ or (for <widget|widgets>) if it is available to create with the <create widget>
 
 Each line of the list returned by the <loadedExtensions> <function> is the <kind> of the corresponding <LiveCode Builder extension|extension>.
 
-References: create widget (command), load extension (command), unload extension (command), function (glossary), return (glossary), LiveCode Builder extension (glossary), widget (object), library LiveCode Builder extension (glossary)
+References: create widget (command), load extension (command), unload extension (command), function (glossary), return (glossary), LiveCode Builder extension (glossary), widget (object), library LiveCode Builder extension (glossary), line (keyword), kind (property)
 
 Tags: extensions
diff --git a/docs/dictionary/message/newWidget.lcdoc b/docs/dictionary/message/newWidget.lcdoc
@@ -24,7 +24,7 @@ Handle the <newWidget> <message> if you want to create additional <object|object
 
 Normally, the <newWidget> <message> is handled at a higher level of the <message path>, since the newly created <widget> does not yet have a <script>.
 
-The actual creation is not triggered by the <newWidget> <message>, so <trap|trapping> the <message> and not allowing it to <pass> does not prevent the <widget> from being created.
+The <newWidget> <message> is sent after the <widget> is created, so <trap|trapping> the <message> and not allowing it to <pass> does not prevent the <widget> from being created.
 
 References: script (property), copy (command), clone (command), paste (command), object (object), trap (glossary), widget (object), message (glossary), tool (glossary), message path (glossary), pass (control_st)
 
diff --git a/docs/dictionary/object/widget.lcdoc b/docs/dictionary/object/widget.lcdoc
@@ -23,9 +23,9 @@ on newWidget
 end newWidget
 
 Description:
-Use the <widget> <object type> to create a <widget> control. A <widget> is created as a <LiveCode Builder extension>. 
+Use the <widget> <object type> to create a <widget> control. <widget|Widgets> are created from <LiveCode Builder extension|LiveCode Builder extensions> that have previously been loaded into memory using the <load extension> <command>. 
 For more details on how to create widgets, please consult the *Extending Livecode* guide.
 
-References: control (keyword), object type (glossary), LiveCode Builder extension (glossary)
+References: load extension (command), control (keyword), object type (glossary), LiveCode Builder extension (glossary), command (glossary)
 
 Tags: objects, extensions
