Hi Mikel,
On Thu, Nov 24, 2011 at 4:08 PM, Mikel Astiz <mikel.astiz@xxxxxxxxxxxx> wrote:
> Assuming that the request confirmation from the agent is not necessary,
> the rest of the reports can be achieved using signals in the transfer
> object itself.
>
> The main benefit of this is that the API is simpler and the client apps
> do not have to register the agent, and can simply listen to the relevant
> signals.
> ---
> doc/client-api.txt | 67 ++++++++++++---------------------------------------
> 1 files changed, 16 insertions(+), 51 deletions(-)
>
> diff --git a/doc/client-api.txt b/doc/client-api.txt
> index 67355c6..eb06d6b 100644
> --- a/doc/client-api.txt
> +++ b/doc/client-api.txt
> @@ -42,15 +42,6 @@ Methods dict GetProperties()
>
> Returns all properties for the session.
>
> - void AssignAgent(object agent)
> -
> - Assign an OBEX agent to this session. This allows
> - detailed progress reports about the transactions.
> -
> - void ReleaseAgent(object agent)
> -
> - Release a previously assigned OBEX agent.
> -
> Properties string Source [readonly]
>
> string Destination [readonly]
> @@ -64,8 +55,7 @@ Service org.openobex.client
> Interface org.openobex.ObjectPush
> Object path [variable prefix]/{session0,session1,...}
>
> -Methods void SendFiles(array{string} files, string destination,
> - object agent)
> +Methods void SendFiles(array{string} files, string destination)
>
> Send one or multiple local files to the remote device,
> and the given destination.
> @@ -281,58 +271,33 @@ Methods dict GetProperties()
>
> Cancels this transfer.
>
> -Properties string Name [readonly]
> -
> - Name of the transferred object.
> -
> - uint64 Size [readonly]
> +Properties uint64 Size [readonly, optional]
>
> - Size of the transferred object. If the size is
> + Size of the transferred object(s). If the size is
> unknown, then this property will not be present.
>
> - string Filename [readonly]
> -
> - Complete name of the file being received or sent.
> -
> -Agent hierarchy
> -===============
> -
> -Service unique name
> -Interface org.openobex.Agent
> -Object path freely definable
> -
> -Methods void Release()
> -
> - This method gets called when the service daemon
> - unregisters the agent. An agent can use it to do
> - cleanup tasks. There is no need to unregister the
> - agent, because when this method gets called it has
> - already been unregistered.
> -
> - string Request(object transfer)
> + string LocalFile [readonly]
Im not sure why you think LocalFile would suite better here, IMO
Filename is fine, also don't remove the Name as it may not match the
Filename.
--
Luiz Augusto von Dentz
--
To unsubscribe from this list: send the line "unsubscribe linux-bluetooth" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
