--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/uiutils/hlplch/src/hlplch.cpp	Fri Feb 19 23:04:46 2010 +0200
@@ -0,0 +1,170 @@
+// Copyright (c) 2003-2009 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:
+// Help Launcher module
+// 
+//
+
+#include "hlplch.h"
+#ifdef SYMBIAN_ENABLE_SPLIT_HEADERS
+#include "hlplch_internal.h"
+#endif
+#include <apgcli.h>
+#include <barsc.h>
+#include <bautils.h>
+#include <lch.rsg>
+
+EXPORT_C void HlpLauncher::LaunchHelpApplicationL(RWsSession& aWsSession, TUid aUid)
+/** Launches the help application, passing a help file UID.
+
+@param aWsSession Application's window server session
+@param aUid Help file UID */
+	{
+	__UHEAP_MARK;
+	TBuf<32> cmdLine;
+	cmdLine.AppendNum((TInt)aUid.iUid);
+	TPtr8 ptr((TText8*)cmdLine.Ptr(), cmdLine.Length(),cmdLine.Length());
+	DoLaunchHelpApplicationL(aWsSession, ptr);
+	__UHEAP_MARKEND;
+	}
+
+EXPORT_C void HlpLauncher::LaunchHelpApplicationL(RWsSession& aWsSession)
+/** Launches the help application.
+
+@param aWsSession Application's window server session */
+	{
+	__UHEAP_MARK;
+	TBuf8<1> blank = _L8("");
+	DoLaunchHelpApplicationL(aWsSession, blank);
+	__UHEAP_MARKEND;
+	}
+
+EXPORT_C void HlpLauncher::LaunchHelpApplicationL(RWsSession& aWsSession, CArrayFix<TCoeHelpContext>* aContextList)
+/** Launches the help application, passing an array of help contexts.
+
+@param aWsSession Application's window server session
+@param aContextList Array of help contexts */
+	{
+	__UHEAP_MARK;
+
+	CHlpCmdLine* cmdLine=CHlpCmdLine::NewLC(aContextList);
+	DoLaunchHelpApplicationL(aWsSession, cmdLine->CmdLineL());
+	CleanupStack::PopAndDestroy();
+
+	__UHEAP_MARKEND;
+	}
+
+void HlpLauncher::DoLaunchHelpApplicationL(RWsSession& aWsSession, const TDesC8& aCmdLine)
+	{
+	TApaTaskList taskList(aWsSession);
+	TApaTask task = taskList.FindApp(KHlpAppUid);
+	if (task.Exists())
+		{
+		task.SendMessage (KHlpAppWsMsg, aCmdLine); 
+		task.BringToForeground();
+		}
+	else
+		{
+		CApaCommandLine* cmdLine=CApaCommandLine::NewLC();
+
+		// INC057477 fix
+		// Get and open the resource file
+		RFs f;
+		CleanupClosePushL(f);
+
+		User::LeaveIfError(f.Connect());
+		RResourceFile r;
+
+		r.OpenL(f, KHelpLauncherResource);
+		CleanupClosePushL(r);
+		
+		// Read the path of the help application from the resource file
+		r.ConfirmSignatureL();
+		TResourceReader resReader;
+		resReader.SetBuffer(r.AllocReadLC(R_HELP_PATH));
+		TPtrC16 helpPath = resReader.ReadTPtrC16();
+		cmdLine->SetExecutableNameL(helpPath);
+		CleanupStack::PopAndDestroy(); // AllocReadLC
+		CleanupStack::PopAndDestroy(); // close r
+		CleanupStack::PopAndDestroy(); // close f
+		
+		cmdLine->SetCommandL(EApaCommandOpen);
+		cmdLine->SetTailEndL(aCmdLine);
+		//EikDll::StartAppL(*cmdLine);
+		RApaLsSession lsSession;
+  		User::LeaveIfError(lsSession.Connect());
+  		CleanupClosePushL(lsSession);
+  		User::LeaveIfError(lsSession.StartApp(*cmdLine));
+  		CleanupStack::PopAndDestroy(&lsSession);
+		CleanupStack::PopAndDestroy(); //cmdLine
+		}
+	}
+
+CHlpCmdLine* CHlpCmdLine::NewL(CArrayFix<TCoeHelpContext>* aContextList)
+	{
+	CHlpCmdLine* self=CHlpCmdLine::NewLC(aContextList);
+	CleanupStack::Pop(); // self
+	return self;
+	}
+
+CHlpCmdLine* CHlpCmdLine::NewLC(CArrayFix<TCoeHelpContext>* aContextList)
+	{
+	CHlpCmdLine* self=new(ELeave)CHlpCmdLine(aContextList);
+	CleanupStack::PushL(self);
+	self->ConstructL();
+	return self;
+	}
+
+CHlpCmdLine::CHlpCmdLine(CArrayFix<TCoeHelpContext>* aContextList)
+		:iContextList(aContextList)
+	{
+	}
+
+CHlpCmdLine::~CHlpCmdLine()
+	{
+	delete iContextList;
+	delete iCmdLine;
+	}
+
+void CHlpCmdLine::ConstructL()
+	{
+	iCmdLine=CBufFlat::NewL(KMaxCmdLineLength);
+	}
+
+TPtr8 CHlpCmdLine::CmdLineL()
+	{
+	BuildCmdLineL();
+	TInt len = iCmdLine->Ptr(0).Size()/sizeof(TText8);
+	TPtr8 ptr((TText8*)iCmdLine->Ptr(0).Ptr(),len,len);
+
+	return ptr;
+	}
+
+void CHlpCmdLine::BuildCmdLineL()
+	{
+	TInt count=iContextList->Count();
+	iCmdLine->InsertL(iCmdLine->Size(), &count, sizeof(TInt));
+	for (TInt i=0; i < count; i++)
+		{
+		AddContextL(iContextList->At(i));
+		}
+	}
+
+void CHlpCmdLine::AddContextL(TCoeHelpContext& aContext)
+	{
+	TInt length=aContext.iContext.Size();
+	iCmdLine->InsertL(iCmdLine->Size(), &length, sizeof(TInt));
+	iCmdLine->InsertL(iCmdLine->Size(), aContext.iContext.Ptr(), aContext.iContext.Size());
+	iCmdLine->InsertL(iCmdLine->Size(), &aContext.iMajor, sizeof(TUid));
+	}
+