Bug 9553

Summary:	[PATCH] dbus-send.1 - document syntax for container types
Product:	dbus	Reporter:	Jack Spaar <jspaar>
Component:	core	Assignee:	Havoc Pennington <hp>
Status:	RESOLVED FIXED	QA Contact:	John (J5) Palmieri <johnp>
Severity:	normal
Priority:	high
Version:	unspecified
Hardware:	x86 (IA32)
OS:	Linux (All)
Whiteboard:
i915 platform:		i915 features:
Attachments:	document syntax for arrays, etc. in dbus-send.1

Description Jack Spaar 2007-01-05 20:52:04 UTC

dbus-send supports messages containing arrays and other types which are not
documented on the manpage.

The attached patch against dbus-1.0.2/tools/dbus-send.1 documents the syntax for
array, dict, and variant.

It also corrects a minor typo in the --dest argument and expands the list of
parseable types to include: objpath, int16, uint16, int64, and uint64.

In any case, please consider including at least the example for arrays and
dicts, as these are actually useful in real life but the syntax is not easy to
discover.

Comment 1 Jack Spaar 2007-01-05 20:53:16 UTC

Created attachment 8307 [details] [review]
document syntax for arrays, etc. in dbus-send.1

Comment 2 Havoc Pennington 2007-01-05 22:40:59 UTC

Thank you, this patch looks good and needed.

Comment 3 Simon McVittie 2007-10-09 05:18:18 UTC

Thankyou for providing this patch. Since you filed this bug, the process of relicensing D-Bus to the MIT/X11 license quoted here has been started. Would you be willing for your patch to be relicensed as follows?

        Permission is hereby granted, free of charge, to any person
        obtaining a copy of this software and associated documentation
        files (the "Software"), to deal in the Software without
        restriction, including without limitation the rights to use, copy,
        modify, merge, publish, distribute, sublicense, and/or sell copies
        of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:

        The above copyright notice and this permission notice shall be
        included in all copies or substantial portions of the Software.

        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
        EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
        NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
        HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
        WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
        DEALINGS IN THE SOFTWARE.

Comment 4 Jack Spaar 2007-10-09 11:03:09 UTC

(In reply to comment #3)
>  Would you be willing for your patch to be relicensed as follows [MIT/X11]?

Yes, I hereby give my permission to relicense the patch under the MIT/X11 license.

s/ Jack Spaar, this 9th Oct. 2007


PS -- I hope this means you're going to actually apply it ;)

Comment 5 John (J5) Palmieri 2007-10-09 12:28:24 UTC

pushed to git Thanks

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.