/*

* Copyright (c) 2005 Nokia Corporation and/or its subsidiary(-ies). 

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:  

*

*/

#ifndef VCOMMANDMERGER_H

#define VCOMMANDMERGER_H

//  INCLUDES

#include <e32base.h>

#include "vcommandapi.h"

class CVCommandMerger : public CBase

	{

	public:

		static CVCommandMerger* NewLC();

		/**

         * Compares the runnable component of the aTarget commands with the one of

         * aInjection commands. Returns the array of commands from aTarget that have counterparts

         * in aInjection with the equal Runnable, but with different spoken text or UI.

         * Difference in user texts only does not count

         * 

         * This is to detect the commands that should be removed when the system language 

         * is changed

         * 

         * @param aTarget Set of commands "already existing in the system".

         * @param aInjection Set of new commands to replace the aTarget commands with the equal

         *        runnables

         * 

         * @return Array of commands from aTarget that have counterparts

         *         in aInjection with the equal Runnable, but with different spoken text or UI.

		 */

		CVCommandArray* ProduceDeductionByRunnablesLC( const CVCommandArray& aTarget, 

											   	       const RVCommandArray& aInjection ) const;

        /**

         * Compares the runnable component of the aTarget commands with the one of

         * aInjection commands. Returns the array of commands consisting of everything

         * in aInjection, without the commands fully equal to any command in aTarget

         * Difference in user texts only does not count

         * 

         * This is to detect the commands that should be (re)trained when the system language 

         * is changed

         * 

         * @param aTarget Set of commands "already existing in the system".

         * @param aInjection Set of new commands to replace the aTarget commands with the equal

         *        runnables

         * 

         * @return the array of commands consisting of everything

         * in aInjection, without the commands fully equal to any command in aTarget

         */

         CVCommandArray* ProduceAdditionByRunnablesLC( const CVCommandArray& aTarget, 

											           const RVCommandArray& aInjection ) const;

	};

#endif // VCOMMANDMERGER_H

// End of File