Merge branch 'master' into codex/create-building.md-for-codename-one-o1r15v

Author: shai-almog

CodenameOne/src/com/codename1/facebook/ui/LikeButton.java

@@ -31,8 +31,8 @@
 
 /**
  * Generic "Like" button that enables us to submit a like to facebook, to get the post id
- * required for the like functionality you will need to use a tool such as: 
- * https://developers.facebook.com/tools/explorer/?method=GET&path=me%2Fposts
+ * required for the like functionality you will need to use a tool such as:
+ * <a href="https://developers.facebook.com/tools/explorer/?method=GET&amp;path=me%2Fposts">https://developers.facebook.com/tools/explorer/?method=GET&amp;path=me%2Fposts</a>
  * You can ask it to list your posts and then seek the correct id within the returned JSON
  * 
  * @author Chen Fishbein

CodenameOne/src/com/codename1/io/JSONParser.java

@@ -47,7 +47,7 @@
  * 
  * <p>
  * The sample below includes JSON from <a href="https://anapioficeandfire.com/">https://anapioficeandfire.com/</a>
- * generated by the query <a href="http://www.anapioficeandfire.com/api/characters?page=5&pageSize=3">http://www.anapioficeandfire.com/api/characters?page=5&pageSize=3</a>:
+ * generated by the query <a href="http://www.anapioficeandfire.com/api/characters?page=5&amp;pageSize=3">http://www.anapioficeandfire.com/api/characters?page=5&amp;pageSize=3</a>:
  * </p>
  * <script src="https://gist.github.com/codenameone/f9fdacaac12583cd2eed.js"></script>
  * <img src="https://www.codenameone.com/img/developer-guide/json-parsing.png" alt="JSON Parsing Result">
@@ -548,7 +548,7 @@ public static void parse(Reader i, JSONParseCallback callback) throws IOExceptio
      * </p>
      * <p>
      * The sample below includes JSON from <a href="https://anapioficeandfire.com/">https://anapioficeandfire.com/</a>
-     * generated by the query <a href="http://www.anapioficeandfire.com/api/characters?page=5&pageSize=3">http://www.anapioficeandfire.com/api/characters?page=5&pageSize=3</a>:
+     * generated by the query <a href="http://www.anapioficeandfire.com/api/characters?page=5&amp;pageSize=3">http://www.anapioficeandfire.com/api/characters?page=5&amp;pageSize=3</a>:
      * </p>
      * <script src="https://gist.github.com/codenameone/f9fdacaac12583cd2eed.js"></script>
      * <img src="https://www.codenameone.com/img/developer-guide/json-parsing.png" alt="JSON Parsing Result">

CodenameOne/src/com/codename1/javascript/JavascriptContext.java

@@ -572,7 +572,7 @@ public void setAsync(String key, Object value) {
     /**
      * Calls the appropriate callback method given a URL that was received 
      * from the NavigationCallback.  It is set up to accept URLs of the 
-     * form cn1command:object.method?type1=value1&type2=value2&...&typen=valuen
+     * form cn1command:object.method?type1=value1&type2=value2&...&typen=valuen
      * 
      * <p>This method parses the URL and converts all arguments (including the 
      * object and method) into their associated Java representations, then 

CodenameOne/src/com/codename1/l10n/DateFormat.java

@@ -33,7 +33,7 @@
  * exposed.
  * 
  * @author Eric Coolman
- * @see http://docs.oracle.com/javase/6/docs/api/java/text/DateFormat.html
+ * @see <a href="http://docs.oracle.com/javase/6/docs/api/java/text/DateFormat.html">http://docs.oracle.com/javase/6/docs/api/java/text/DateFormat.html</a>
  */
 public class DateFormat extends Format {
 	/**

CodenameOne/src/com/codename1/l10n/Format.java

@@ -25,7 +25,7 @@
 /**
  * An abstract class for parsing and formatting localisation sensitive information, compatible with JDK 6.
  * 
- * @see http://docs.oracle.com/javase/6/docs/api/java/text/Format.html
+ * @see <a href="http://docs.oracle.com/javase/6/docs/api/java/text/Format.html">http://docs.oracle.com/javase/6/docs/api/java/text/Format.html</a>
  * @author Eric Coolman
  */
 public abstract class Format implements Cloneable {

CodenameOne/src/com/codename1/payment/Purchase.java

@@ -46,7 +46,7 @@
  * <p>In-app-purchase API's rely on managed server based products, other payment systems
  * use the manual approach. An application dealing with virtual goods must support both 
  * since not all devices feature in-app-purchase API's. An application dealing with physical
- * goods & services must use the latter according to the TOS of current in-app-purchase
+ * goods &amp; services must use the latter according to the TOS of current in-app-purchase
  * solutions.
  *
  * @author Shai Almog

CodenameOne/src/com/codename1/ui/animations/Motion.java

@@ -227,7 +227,7 @@ public static Motion createLinearMotion(int sourceValue, int destinationValue, i
 
     /**
      * Creates a linear motion starting from source value all the way to destination value for a color value.
-     * Unlike a regular linear motion a color linear motion is shifted based on channels where red, green & blue 
+     * Unlike a regular linear motion a color linear motion is shifted based on channels where red, green & blue
      * get shifted separately.
      * 
      * @param sourceValue the color from which we are starting 

CodenameOne/src/com/codename1/ui/html/HTMLComponent.java

@@ -464,7 +464,7 @@ public void setParser(HTMLParser parser) {
 
     /**
      * Adds the given symbol and code to the user defined char entities table.
-     * Symbols do not need to include leading & and trailing ; - these will be trimmed if given as the symbol
+     * Symbols do not need to include leading & and trailing ; - these will be trimmed if given as the symbol
      *
      * @param symbol The symbol to add
      * @param code The symbol's code

CodenameOne/src/com/codename1/ui/html/HTMLParser.java

@@ -42,7 +42,7 @@ public class HTMLParser extends XMLParser {
 
     /**
      * The list of empty tags (tags that naturally don't have any children).
-     * This is used to enable empty tags to be closed also in a non-strict way (i.e. <br> instead of <br&gt/;)
+     * This is used to enable empty tags to be closed also in a non-strict way (i.e. <br> instead of <br/>)
      * some of these tags are not a part of the XHTML-MP 1.0 standard, but including them here allows a more smooth parsing if the document is not strictly XHTML-MP 1.0
      */
     private static String[] EMPTY_TAGS = {"br","link","meta","base","area","basefont","col","frame","hr","img","input","isindex","param"};
@@ -113,7 +113,7 @@ protected Element createNewTextElement(String text) {
      * Overrides XMLParser.convertCharEntity to add in HTML char entities
      *
      * @param charEntity The char entity to convert
-     * @return A string containing a single char, or the original char entity string (with & and ;) if the char entity couldn't be resolved
+     * @return A string containing a single char, or the original char entity string (with & and ;) if the char entity couldn't be resolved
      */
     protected String convertCharEntity(String charEntity) {
         try {

CodenameOne/src/com/codename1/ui/html/HTMLUtils.java

@@ -80,8 +80,8 @@ private HTMLUtils() {
      * Converts an XML char entity to the matching character or string.
      * This is a convenience method that uses convertCharEntity with false for lookupHTMLentities and a null userDefinedCharEntities
      *
-     * @param charEntity The char entity to convert (Not including the & and ;)
-     * @return A string containing a single char, or the original char entity string (with & and ;) if the char entity couldn't be resolved
+     * @param charEntity The char entity to convert (Not including the & and ;)
+     * @return A string containing a single char, or the original char entity string  (with & and ;) if the char entity couldn't be resolved
      */
     public static String convertXMLCharEntity(String charEntity) {
         return convertCharEntity(charEntity, false, null);
@@ -91,8 +91,8 @@ public static String convertXMLCharEntity(String charEntity) {
      * Converts an HTML char entity to the matching character or string.
      * This is a convenience method that uses convertCharEntity with true for lookupHTMLentities and a null userDefinedCharEntities
      *
-     * @param charEntity The char entity to convert (Not including the & and ;)
-     * @return A string containing a single char, or the original char entity string (with & and ;) if the char entity couldn't be resolved
+     * @param charEntity The char entity to convert (Not including the & and ;)
+     * @return A string containing a single char, or the original char entity string  (with & and ;) if the char entity couldn't be resolved
      */
     public static String convertHTMLCharEntity(String charEntity) {
         return convertCharEntity(charEntity, true, null);
@@ -103,10 +103,10 @@ public static String convertHTMLCharEntity(String charEntity) {
      * Converts a char entity to the matching character or string.
      * This handles both numbered and symbol char entities (The latter is done via getCharEntityCode)
      *
-     * @param charEntity The char entity to convert (Not including the & and ;)
+     * @param charEntity The char entity to convert (Not including the & and ;)
       * @param lookupHTMLentities true to include the basic HTML named char entities (unicode 160-255), false otherwise
       * @param userDefinedCharEntities A hashtable containing (String,int) dentoing the char entity name and its unicode
-     * @return A string containing a single char, or the original char entity string (with & and ;) if the char entity couldn't be resolved
+     * @return A string containing a single char, or the original char entity string  (with & and ;) if the char entity couldn't be resolved
       */
     public static String convertCharEntity(String charEntity,boolean lookupHTMLentities,Hashtable userDefinedCharEntities) {
         int charCode=-1;