Pidgin-carman Manager API description
*************************************

Copyright (C) 2008  Claudio Takahasi <claudio.takahasi@openbossa.org>
Copyright (C) 2008  Luiz von Dentz <luiz.dentz@openbossa.org>
Copyright (C) 2008  Cidorvan Leite <cidorvan.leite@openbossa.org>
Copyright (C) 2008  Felipe Zimmerle <felipe.costa@openbossa.org>
Copyright (C) 2008  Bruno Abinader <bruno.abinader@openbossa.org>

Manager hierarchy
=================

Service		org.indt.carmanplugin
Interface       org.indt.carmanplugin.Manager
Object path	/

Methods
		void RequestAuthorization(string buddy)

			Request authorization from client to connect to a
                        remote buddy from Pidgin's contact list.

			Possible Errors: org.indt.carmanplugin.Error.AlreadyConnected
					org.indt.carmanplugin.Error.InProgress
					org.indt.carmanplugin.Error.InvalidArgs
					org.indt.carmanplugin.Error.Rejected

		void RegisterAgent(object path)

			Register an agent that will authorize or cancel
                        remote buddy connection request.

			Possible Errors: org.indt.carmanplugin.Error.AlreadyExists
					org.indt.carmanplugin.Error.InvalidArgs

		void UnregisterAgent(object path)

			Unregister the previous registered agent. This
			method call is restricted to the same application
			that registered the agent.

			Possible Errors: org.indt.carmanplugin.Error.DoesNotExists
					org.indt.carmanplugin.Error.InvalidArgs

                void RemoveBuddy(object path)

                        Disconnect buddy.

			Possible Errors: org.indt.carmanplugin.Error.DoesNotExists
					org.indt.carmanplugin.Error.InvalidArgs

Signals
		BuddyCreated(object path)

			This signal indicates that a buddy (indicated by his
                        object path) has been created.

                BuddyRemoved(object path)

                        This signal indicates that a buddy (indicated by his
                        object path) has been removed.

Buddy hierarchy
===============

Service		org.indt.carmanplugin
Interface       org.indt.carmanplugin.Buddy
Object path	/buddy[0..N]

Signals
		void DataAvailable(double latitude, double longitude,
					double altitude, double speed,
					double track, double rpm)

                        This signal indicates that there is data available to
                        be received from the buddy specified by his unique
                        object path.
