docs: Update release notes for 8.0.0-dp-14

peter-b · peter-b · commit a7c7acd130f7 · 2016-01-28T11:24:02.000Z
* Updated overview, now with less **bold** and more mention of native
  theming improvements

* Updated OS X &amp; Android platform support info

* Minor formatting tweaks elsewhere
diff --git a/docs/lcb/notes/16681.md b/docs/lcb/notes/16681.md
@@ -5,8 +5,8 @@ version: 8.0.0-dp-13
 
 ## Date and time
 
-The date items returned by `the local time` are now adjusted so that
-the year and month are absolute, rather than offsets from 1900 and
-January respectively.
+* The date items returned by `the local time` are now adjusted so that
+  the year and month are absolute, rather than offsets from 1900 and
+  January respectively.
 
 # [16681] Returned date is not as documented
diff --git a/docs/notes/bugfix-16619.md b/docs/notes/bugfix-16619.md
@@ -1,10 +1,10 @@
-# No "wait" syntax in HTML5 standalones
+# No blocking syntax in HTML5 standalones
 
 In LiveCode 8.0.0-dp-11, changes were made to the HTML5 standalone
-engine to enable the use of `wait` (and related syntax; see
-[bug 16076](http://quality.livecode.com/show_bug.cgi?id/16076).  These
-changes made the HTML5 engine run unacceptably slowly, and have now
-been removed.
+engine to enable the use of the **wait** command (and related syntax;
+see [bug 16076](http://quality.livecode.com/show_bug.cgi?id/16076).
+These changes made the HTML5 engine run unacceptably slowly, and have
+now been removed.
 
-Instead of using `wait` in stacks for HTML5 deployment, the use of the
-`send <message> in <time>` syntax is recommended.
+Instead of using **wait** in stacks designed for HTML5 deployment, you
+can still use `send <message> in <time>`.
diff --git a/docs/notes/feature-faster_unicode_text_processing.md b/docs/notes/feature-faster_unicode_text_processing.md
@@ -1,7 +1,9 @@
 # Faster Unicode text processing
 
-By using its own implementation of the Unicode grapheme cluster breaking
-algorithm, the engine can now handle text processing with non-native 
-strings about 25% faster, as it no longer needs to incur the penalty of
-initialising an ICU grapheme break iterator which involved a complete
-copy of the target string.
+Text processing operations involving Unicode strings are now about 25%
+faster.
+
+The engine now has its own implementation of the Unicode 'grapheme
+cluster breaking' algorithm.  This means that it no longer needs to
+incur the penalty of initialising an ICU grapheme break iterator,
+which involves making a complete copy of the target string.
diff --git a/docs/notes/overview.md b/docs/notes/overview.md
@@ -2,33 +2,33 @@
 
 LiveCode 8.0 brings important new capabilities to all LiveCode developers:
 
-* Use new **custom controls and libraries** in your applications, including a new **browser widget**.
+* Use new custom controls and libraries in your applications, including a new browser widget.
 
-* Extend LiveCode with the new **LiveCode Builder language**
+* Extend LiveCode with the new LiveCode Builder language
 
-* **Deploy to HTML5** and run your application in a web browser
+* Deploy to HTML5 and run your application in a web browser
 
 * Many other improvements!
 
 ## Simplify design with widgets
 
-With LiveCode 8.0, your apps are set free from using the small range of user interface controls that were previously available in LiveCode.  The LiveCode engine now lets you load custom controls, called **widgets**, and use them in your apps just like any other control.
+With LiveCode 8.0, your apps are set free from using the small range of user interface controls that were previously available in LiveCode.  The LiveCode engine now lets you load custom controls, called widgets, and use them in your apps just like any other control.
 
 LiveCode comes with a selection of widgets that simplify creating many commonly-needed sets of controls in mobile apps, and if they aren't enough, you can download and install widgets created by members of the LiveCode development community and third-party vendors.
 
-One of the most exciting new widgets introduced in LiveCode 8.0 is the **browser widget**.  It replaces the revBrowser external with a much more powerful and flexible browser control that's easier to use and more reliable.
+One of the most exciting new widgets introduced in LiveCode 8.0 is the browser widget.  It replaces the revBrowser external with a much more powerful and flexible browser control that's easier to use and more reliable.
 
 The LiveCode IDE has also been extended and revised in order to support widgets and other extensions.  Widgets are now available in the "Tools" palette, and installed extensions can be viewed in the "Extension Manager".  The dictionary has been extended to include extension documentation.
 
 ## Extend Livecode with LiveCode Builder
 
-In LiveCode 8.0, the well-known LiveCode scripting language is joined by a brand new programming language called **LiveCode Builder**.  LiveCode Builder looks a lot like LiveCode script, and should be easy to learn for any experienced LiveCode developer.
+In LiveCode 8.0, the well-known LiveCode scripting language is joined by a brand new programming language called LiveCode Builder.  LiveCode Builder looks a lot like LiveCode script, and should be easy to learn for any experienced LiveCode developer.
 
 Using LiveCode Builder, it is now possible to extend LiveCode with new controls and libraries without any need to program in C or C++.  The IDE has a new "Extension Builder" tool that helps developers test, debug and package their extensions.
 
 For more information, please refer to the "Extending LiveCode" guide and the "LiveCode Builder" section of the dictionary.
 
-**Note:** LiveCode Builder is a new and experimental language.  There is **no stability guarantee** for the language or its standard libraries.  Be aware that the language syntax or features may change incompatibly in future versions of LiveCode!
+**Note:** LiveCode Builder is a new and experimental language.  There is no stability guarantee for the language or its standard libraries.  Be aware that the language syntax or features may change incompatibly in future versions of LiveCode!
 
 ## Deploy to the browser with HTML5
 
@@ -42,10 +42,14 @@ For more information, please refer to the "HTML5 Deployment" guide.
 
 LiveCode 8.0 includes many other enhancements, including:
 
-* more powerfuland complete **clipboard access**, sponsored by [FMProMigrator](https://www.fmpromigrator.com)
+* more powerful and complete clipboard access, sponsored by [FMProMigrator](https://www.fmpromigrator.com)
 
-* **SSL support for PostgreSQL connections**, sponsored by the community Feature Exchange
+* SSL support for PostgreSQL connections, sponsored by the community Feature Exchange
 
-* **Unicode printing** on Linux
+* optimised Unicode text processing
 
-* a new **JSON library** extension.
+* Unicode printing on Linux
+
+* a new JSON library extension
+
+* greatly improved native theming on desktop platforms
diff --git a/docs/notes/platforms.md b/docs/notes/platforms.md
@@ -62,8 +62,8 @@ Currently, the supported versions of Xcode are:
 * Xcode 4.6 on MacOS X 10.7
 * Xcode 5.1 on MacOS X 10.8
 * Xcode 6.2 on MacOS X 10.9
-* Xcode 6.2, 6.4 and 7.1 on Mac OS X 10.10
-* Xcode 7.2 on MacOS X 10.11
+* Xcode 6.2, 6.4, 7.1 and 7.2 on Mac OS X 10.10
+* Xcode 7.1 and 7.2 on MacOS X 10.11
 
 It is also possible to set other versions of Xcode, to allow testing on a wider range of iOS simulators. For instance, on Yosemite, you can add *Xcode 5.1* in the *Mobile Support* preferences, to let you test your stack on the *iOS Simulator 7.1*.
 
@@ -76,20 +76,29 @@ We currently support the following iOS Simulators:
 * 9.2
 
 ## Android
-LiveCode allows you to save your stack as an Android application, and also to deploy it on an Android device or simulator from the IDE.
+
+LiveCode allows you to save your stack as an Android application, and
+also to deploy it on an Android device or simulator from the IDE.
+
 Android deployment is possible from Windows, Linux and Mac OSX.
 
-To enable the deployment to an Android device, you need to download the [Android SDK](https://developer.android.com/sdk/index.html#Other) and to install the following component, using the *Android SDK Manager*:
+To enable deployment to Android devices, you need to download the
+[Android SDK](https://developer.android.com/sdk/index.html#Other), and
+then use the 'Android SDK Manager' to install:
 
-* Android SDK Platform for Android 4.0.3 (API 15)
-* Android SDK Platform Tools
-* Android SDK Build Tools
+* the latest "Android SDK Tools"
+* the latest "Android SDK Platform Tools"
 
-You also need to have Java *JDK 1.6* installed on your machine (or *openjdk-6* on Linux).
+You also need to install the Java Development Kit (JDK).  On Linux,
+this usually packaged as "openjdk".  LiveCode requires JDK version 1.6
+or later.
 
-Once you have set the path of your Android SDK in the *LiveCode Preferences > Mobile Support*, you can deploy your stack to Android devices running Android >= 2.3.3.
+Once you have set the path of your Android SDK in the "Mobile Support"
+section of the LiveCode IDE's preferences, you can deploy your stack
+to Android devices.
 
-Android Watch is not officially supported at the moment.
+Some users have reported successful Android Watch deployment, but it
+is not yet officially supported.
 
 ## HTML5
 
diff --git a/extensions/widgets/gradientrampeditor/notes/feature-selected_stop.md b/extensions/widgets/gradientrampeditor/notes/feature-selected_stop.md
@@ -8,5 +8,5 @@ selected stop.
 ## selectedStopChanged message
 The gradient ramp widget posts a **selectedStopChanged** message when the 
 selected stop of the widget is changed either by script (via the 
-selectedStop property) or by user interaction, i.e. clicking on one 
-of the widget's gradient stops.
+**selectedStop** property) or by user interaction, i.e. clicking on one 
+of the widget's gradient stops.
