diff options
Diffstat (limited to 'tools')
| -rw-r--r-- | tools/Makefile.am | 6 | ||||
| -rw-r--r-- | tools/README.dbusmenu-bench | 27 |
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. |