annotation updates

core/blockly.js

@@ -388,7 +388,7 @@ Blockly.prompt = function(message, defaultValue, callback) {
  * Helper function for defining a block from JSON.  The resulting function has
  * the correct value of jsonDef at the point in code where jsonInit is called.
  * @param {!Object} jsonDef The JSON definition of a block.
- * @return {function} A function that calls jsonInit with the correct value
+ * @return {function()} A function that calls jsonInit with the correct value
  *     of jsonDef.
  * @private
  */

core/field.js

@@ -68,7 +68,7 @@ Blockly.Field.cacheReference_ = 0;
 /**
  * Name of field.  Unique within each block.
  * Static labels are usually unnamed.
- * @type {string=}
+ * @type {string|undefined}
  */
 Blockly.Field.prototype.name = undefined;
 

core/variables.js

@@ -233,8 +233,8 @@ Blockly.Variables.generateUniqueName = function(workspace) {
  * Create a new variable on the given workspace.
  * @param {!Blockly.Workspace} workspace The workspace on which to create the
  *     variable.
- * @param {function(null|undefined|string)=} opt_callback A callback. It will
- *     return an acceptable new variable name, or null if change is to be
+ * @param {function(?string=)=} opt_callback A callback. It will
+ *     be passed an acceptable new variable name, or null if change is to be
  *     aborted (cancel button), or undefined if an existing variable was chosen.
  */
 Blockly.Variables.createVariable = function(workspace, opt_callback) {