Return-Path: From: Mikel Astiz To: CC: Mikel Astiz Subject: [RFC obexd 01/10] client-doc: reformatted to fit in 80 columns Date: Thu, 24 Nov 2011 15:08:53 +0100 Message-ID: <1322143742-31182-2-git-send-email-mikel.astiz@bmw-carit.de> In-Reply-To: <1322143742-31182-1-git-send-email-mikel.astiz@bmw-carit.de> References: <1322143742-31182-1-git-send-email-mikel.astiz@bmw-carit.de> MIME-Version: 1.0 Content-Type: text/plain Sender: linux-bluetooth-owner@vger.kernel.org List-ID: --- doc/client-api.txt | 56 +++++++++++++++++++++++++++++++-------------------- 1 files changed, 34 insertions(+), 22 deletions(-) diff --git a/doc/client-api.txt b/doc/client-api.txt index 3e61cf7..476ebfd 100644 --- a/doc/client-api.txt +++ b/doc/client-api.txt @@ -22,7 +22,8 @@ Methods void SendFiles(dict device, array{string} files, object agent) Request the business card from a remote device and store it in the local file. - void ExchangeBusinessCards(dict device, string clientfile, string file) + void ExchangeBusinessCards(dict device, string clientfile, + string file) Push the client's business card to the remote device and then retrieve the remote business card and store @@ -101,8 +102,10 @@ Methods void ChangeFolder(string folder) string Name : Object name in UTF-8 format string Type : Either "folder" or "file" - uint64 Size : Object size or number of items in folder - string Permission : Group, owner and other permission + uint64 Size : Object size or number of items in + folder + string Permission : Group, owner and other + permission guint64 Modified : Last change guint64 Accessed : Last access guint64 Created : Creation date @@ -150,7 +153,8 @@ Methods void Select(string location, string phonebook) Select the phonebook object for other operations. Should be call before all the other operations. - location : Where the phonebook is stored, possible inputs : + location : Where the phonebook is stored, possible + inputs : "INT" ( "INTERNAL" which is default ) "SIM" ( "SIM1" ) "SIM2" @@ -171,7 +175,8 @@ Methods void Select(string location, string phonebook) array{string vcard, string name} List() Return an array of vcard-listing data which contains the - vcard : name paired string, for example "1.vcf" : "John". + vcard : name paired string, for example "1.vcf" : + "John". string Pull(string vcard) @@ -190,36 +195,40 @@ Methods void Select(string location, string phonebook) uint16 GetSize() - Return the number of the non-null entries in the selected - phonebook object. + Return the number of the non-null entries in the + selected phonebook object. void SetFormat(string format) - Indicate the format of the vcard that should be return by - related methods. + Indicate the format of the vcard that should be return + by related methods. format : { "vcard21" (default) | "vcard30" } void SetOrder(string order) - Indicate the sorting method of the vcard-listing data returned - by List and Search methods. + Indicate the sorting method of the vcard-listing data + returned by List and Search methods. - order : { "indexed" (default) | "alphanumeric" | "phonetic" } + order : { "indexed" (default) | "alphanumeric" | + "phonetic" } void SetFilter(array{string}) - Indicate fields that should be contained in vcards return by - related methods. + Indicate fields that should be contained in vcards + return by related methods. - Give an empty array will clear the filter and return all fields - available in vcards. And this is the default behavior. + Give an empty array will clear the filter and return + all fields available in vcards. And this is the default + behavior. - Possible filter fields : "VERSION", "FN", ..., "ALL", "bit[0-63]" + Possible filter fields : "VERSION", "FN", ..., "ALL", + "bit[0-63]" array{string} ListFilterFields() - Return All Available fields that can be used in SefFilter method. + Return All Available fields that can be used in + SefFilter method. array{string} GetFilter() @@ -234,10 +243,12 @@ Object path [variable prefix]/{session0,session1,...} Methods void SetLocation(string location) - Set the phonebook object store location for other operations. Should - be called before all the other operations. + Set the phonebook object store location for other + operations. Should be called before all the other + operations. - location: Where the phonebook is stored, possible values: + location: Where the phonebook is stored, possible + values: "INT" ( "INTERNAL" which is default ) "SIM1" "SIM2" @@ -245,7 +256,8 @@ Methods void SetLocation(string location) string GetPhonebook() - Retrieve an entire Phonebook Object store from remote device + Retrieve an entire Phonebook Object store from remote + device void PutPhonebook(string obj) -- 1.7.6.4