aboutsummaryrefslogtreecommitdiff
path: root/tools
diff options
context:
space:
mode:
authorTed Gould <ted@gould.cx>2010-02-05 10:57:31 -0800
committerTed Gould <ted@gould.cx>2010-02-05 10:57:31 -0800
commitf3a13c8b0be55927b8b91ff37ba922ba323b44b7 (patch)
tree30b810d1530b567c9b597190b7746fcca201c715 /tools
parentfc35f16de9710c7aa59d3acf88eaa7c215838e36 (diff)
parent873763b18e85fe2d53f847e00d5207e4926bb619 (diff)
downloadlibdbusmenu-f3a13c8b0be55927b8b91ff37ba922ba323b44b7.tar.gz
libdbusmenu-f3a13c8b0be55927b8b91ff37ba922ba323b44b7.tar.bz2
libdbusmenu-f3a13c8b0be55927b8b91ff37ba922ba323b44b7.zip
Sync to trunk
Diffstat (limited to 'tools')
-rw-r--r--tools/Makefile.am6
-rw-r--r--tools/README.dbusmenu-bench27
2 files changed, 32 insertions, 1 deletions
diff --git a/tools/Makefile.am b/tools/Makefile.am
index eedfa29..77d6eef 100644
--- a/tools/Makefile.am
+++ b/tools/Makefile.am
@@ -16,4 +16,8 @@ dbusmenu_dumper_LDADD = \
../libdbusmenu-glib/libdbusmenu-glib.la \
$(DBUSMENUGLIB_LIBS)
-EXTRA_DIST = dbusmenu-bench
+doc_DATA = README.dbusmenu-bench
+
+EXTRA_DIST = \
+ $(doc_DATA) \
+ dbusmenu-bench
diff --git a/tools/README.dbusmenu-bench b/tools/README.dbusmenu-bench
new file mode 100644
index 0000000..91045df
--- /dev/null
+++ b/tools/README.dbusmenu-bench
@@ -0,0 +1,27 @@
+# Introduction
+
+dbusmenu-bench measures the time it takes to call various DBusMenu methods and
+print the results on stdout. A test dbusmenu application must be started before
+running dbusmenu-bench.
+
+A GLib test application is included in this archive. libdbusmenu-qt provides an
+equivalent Qt test application. They both can load the same menu hierarchy from
+a JSON file.
+
+# Using it
+
+1. Start dbusmenu-testapp:
+
+ dbusmenu-testapp /usr/share/libdbusmenu/json/test-gtk-label.json
+
+2. Run dbusmenu-bench
+
+ dbusmenu-bench --count 1000
+
+1000 is the number of times each DBusMenu method is called. Calling them 1000
+times helps getting meaningful average values.
+
+3. Stop dbusmenu-testapp
+
+For debugging purpose, you can also run dbusmenu-bench with the "--dump"
+parameter, which will dump the output of the called methods.