From 7ffc395db006cf6c4e4775f81603aa5fe31a18a1 Mon Sep 17 00:00:00 2001 From: George Vlahavas Date: Sat, 27 Jul 2024 20:12:54 +0300 Subject: [PATCH] Update documentation for openbox Include info about generating a dynamic pipe-menu. --- README.md | 15 ++++++++++++++- man/xdgmenumaker.t2t | 19 ++++++++++++++----- 2 files changed, 28 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index fd2978b..abf2395 100644 --- a/README.md +++ b/README.md @@ -212,7 +212,20 @@ refresh the menu, like this: Openbox ------- -You can create pipe menus for Openbox running xdgmenumaker like this: +xdgmenumaker creates pipe-menus for Openbox, which are, by definition, +dynamic menus. The simplest way to have an auto-generated "Applications" +submenu in the main Openbox menu, you can just add a line like the following +one somewhere inside the `` in your +`~/.config/openbox/menu.xml` file:: + + + +This menu will be generated every time you open the Openbox menu, so it will +always be up-to-date. + +Alternatively, you can create a static menu, which you can then include +through a pipe-menu in your main menu too. To do that, run +xdgmenumaker like this: $ xdgmenumaker -f openbox > ~/.cache/openbox/apps.menu diff --git a/man/xdgmenumaker.t2t b/man/xdgmenumaker.t2t index 058995c..0da7753 100644 --- a/man/xdgmenumaker.t2t +++ b/man/xdgmenumaker.t2t @@ -303,16 +303,25 @@ refresh the menu, like this: : **Openbox** -To generate an application menu for Openbox, run **xdgmenumaker** like this: +**xdgmenumaker** creates pipe-menus for Openbox, which are, by definition, +dynamic menus. The simplest way to have an auto-generated "Applications" +submenu in the main Openbox menu, you can just add a line like the following +one somewhere inside the //// in your +//~/.config/openbox/menu.xml// file:: -``$ xdgmenumaker -f openbox > ~/.cache/openbox/apps.menu`` +```` -or if you want icons in your menu: +This menu will be generated every time you open the Openbox menu, so it will +always be up-to-date. -``$ xdgmenumaker -i -f openbox > ~/.cache/openbox/apps.menu`` +Alternatively, you can create a static menu, which you can then include +through a pipe-menu in your main menu too. To do that, run +**xdgmenumaker** like this: + +``$ xdgmenumaker -f openbox > ~/.cache/openbox/apps.menu`` and you can then edit your //~/.config/openbox/menu.xml// file and add this -line somewhere in the //// section: +line somewhere in the //// section: ````