Bug 120150 [Commands] Javadoc bugs in ParameterizedCommand and ExecutionEvent
The constructor for ParameterizedCommand refers to "an array of quadruples (<code>String[]</code>)" for the 'parameterizations' parameter, however the type of that parameter is Parameterization[]. In ExecutionEvent there are several places where it says "parameter name" but I think it should say "parameter id". In the constructor: * @param parameters * The parameters to qualify the execution; must not be * <code>null</code>. This must be a map of parameter names (<code>String</code>) * to parameter values (<code>String</code>). And the method getParameter(final String parameterName) has the same problem. This analysis is based on the code in ParameterizedCommand.getParameterMap() that builds a Map of parameter id to parameter value which is passed to the ExecutionEvent constructor.
bundles/org.eclipse.core.commands/src/org/eclipse/core/commands/ExecutionEvent.java
* {@link IHandler#execute(ExecutionEvent)} method, so any problem getting
	 * the object value causes <code>ExecutionException</code> to be thrown.
	 * </p>
	 * 
	 * @param parameterId
	 *            The id of a parameter to retrieve the object value of.
	 * @return The object value of the parameter with the provided id.
	 * @throws ExecutionException
	 *             if the parameter object value could not be obtained for any
	 *             reason
	 * @since 3.2
	 */
	public final Object getObjectParameterForExecution(final String parameterId)
			throws ExecutionException {
		if (command == null) {
			throw new ExecutionException(
					"No command is associated with this execution event"); 
		}
		try {
			final ParameterType parameterType = command
					.getParameterType(parameterId);
			if (parameterType == null) {
				throw new ExecutionException(
						"Command does not have a parameter type for the given parameter"); 
			}
			final AbstractParameterValueConverter valueConverter = parameterType
					.getValueConverter();
			if (valueConverter == null) {
				throw new ExecutionException(
						"Command does not have a value converter");