[Docs] Fix missing parameter descriptions

montegoulding · montegoulding · commit 454859367626 · 2016-12-23T13:12:39.000+11:00
diff --git a/docs/dictionary/command/export-snapshot.lcdoc b/docs/dictionary/command/export-snapshot.lcdoc
@@ -61,14 +61,10 @@ The desired file format to save.
 -   GIF: Graphics Interchange Format
 -   PNG: Portable Network Graphics
 
-
 maskFile:
 Specifies the name and location of a file to export as an image mask.
 You can use a maskFile only when exporting in PBM format (paint).
 
-suffix:
-The usual possible suffixes for the export snapshot command.
-
 Description:
 Use the <export snapshot> <command> to export a screenshot to a <file>
 or <container>.
diff --git a/docs/dictionary/command/play-video.lcdoc b/docs/dictionary/command/play-video.lcdoc
@@ -2,7 +2,7 @@ Name: play video
 
 Type: command
 
-Syntax: play video {<video-file> | <video-url>}
+Syntax: play video {<videoFile> | <videoUrl>}
 
 Summary:
 Plays a full screen video.
@@ -61,9 +61,13 @@ command. This will use the <startTime> and <endTime> properties of the
 properties are interpreted as the number of milliseconds from the
 beginning of the video.
 
+Parameters:
+videoFile (string): The path to a video file to play.
+
+videoUrl (string): The url of a video file to play.
+
 References: play stop (command), play (command), templatePlayer (keyword),
 movieTouched (message), looping (property), endTime (property),
 playSelection (property), showController (property), startTime (property)
 
 Tags: multimedia
-
diff --git a/docs/dictionary/function/binaryDecode.lcdoc b/docs/dictionary/function/binaryDecode.lcdoc
@@ -29,18 +29,9 @@ binaryDecode(myFormat,placeHolder,importantStuff)
 Parameters:
 formatsList:
 The <formatsList> consists of one or more dataTypes, each followed
-optionally by an amount. A dataType is one of the following single
-letters: x: skip next amount bytes of data
+optionally by an amount. A dataType is one of the following single letters: 
 
-data (string):
-A string of encoded binary data.
-
-variablesList:
-A comma-separated list of local or global variable names. The number of
-variable names must be the same as the number of dataTypes specified in
-the <formatsList>, and the variables must already exist.
-
-amount:
+- x: skip next amount bytes of data
 - a: convert next amount bytes of data to characters
 - A: convert next amount bytes of data (skipping spaces) to characters
 - b: convert next amount bits of data to 1s and 0s
@@ -74,6 +65,14 @@ For example, the dataType "a3" requires only one variable, which will
 hold a 3-characterstring, but the dataType "h3" requires three
 variables, each of which will hold a single hex digit.
 
+data (string):
+A string of encoded binary data.
+
+variablesList:
+A comma-separated list of local or global variable names. The number of
+variable names must be the same as the number of dataTypes specified in
+the <formatsList>, and the variables must already exist.
+
 Returns:
 The <binaryDecode> <function> <return|returns> the number of dataTypes
 that were successfully converted and placed in <variable|variables> (not
diff --git a/docs/dictionary/function/binaryEncode.lcdoc b/docs/dictionary/function/binaryEncode.lcdoc
@@ -28,28 +28,10 @@ charToNum(binaryEncode("B*","01111111")) -- returns 127
 Parameters:
 formatsList:
 The <formatsList> consists of one or more dataTypes, each followed
-optionally by an amount. A dataType is one of the following single
-letters: x: output amount null characters
+optionally by an amount.
 
-dataStringList (string):
-A comma-separated list of dataStrings. Each dataString is a string, or
-an expression that evaluates to a string.
-
-amount (enum):
-
--  If the dataType is a, A, b, B, h, or H, the amount specifies the
-   number of characters or groups of the dataString to use; extra
-   characters are ignored. The * character Encodes the rest of the data
-   in the current dataString. If no amount is specified, the dataType is
-   used for one character.
--  If the dataType is c, C, s, S, i, I, n, N, m, M,  f, or d, the amount
-   specifies the number of dataStrings to encode. The * character
-   Encodes the rest of the dataStrings. If no amount is specified, the
-   dataType is used for one dataString.
--  If the dataType is x, the amount specifies how many nulls to place in
-   the returned value.
+A dataType is one of the following letters:
 
-One of the following items:
 -    c: encode amount numbers as signed 1-byte integers
 -    C: encode amount numbers as unsigned 1-byte integers
 -    s: encode amount numbers as signed 2-byte integers in host byte order
@@ -62,9 +44,26 @@ One of the following items:
 -    M: encode amount numbers as unsigned 4-byte integers in network byte order
 -    f: encode amount numbers as single-precision floating-point numbers
 -    d: encode amount numbers as double-precision floating-point numbers
- 
-The amount corresponding to each dataType is an integer or the * character:
+-    x: encode amount null characters
 
+The amount is an integer or * and specifies the encoding in the
+following way:
+
+-  If the dataType is a, A, b, B, h, or H, the amount specifies the
+   number of characters or groups of the dataString to use; extra
+   characters are ignored. The * character Encodes the rest of the data
+   in the current dataString. If no amount is specified, the dataType is
+   used for one character.
+-  If the dataType is c, C, s, S, i, I, n, N, m, M,  f, or d, the amount
+   specifies the number of dataStrings to encode. The * character
+   Encodes the rest of the dataStrings. If no amount is specified, the
+   dataType is used for one dataString.
+-  If the dataType is x, the amount specifies how many nulls to place in
+   the returned value.
+
+dataStringList (string):
+A comma-separated list of dataStrings. Each dataString is a string, or
+an expression that evaluates to a string.
 
 Returns:
 The <binaryEncode> <function> <return|returns> the binary string
