Add a manpage section about pekwm

man/xdgmenumaker.t2t

@@ -28,7 +28,7 @@ The menu entries that are generated by **xdgmenumaker** are localised
 according to the running user locale settings.
 
 **xdgmenumaker** currently supports generating menus for //fluxbox//,
-//icewm// and //windowmaker//.
+//icewm//, //pekwm// and //windowmaker//.
 
 pyxdg and pygtk are required by **xdgmenumaker**, in addition to python 2.
 
@@ -37,7 +37,7 @@ pyxdg and pygtk are required by **xdgmenumaker**, in addition to python 2.
 
 : **-f, --format**
 specify the output format to use. Valid options are //fluxbox//,
-//icewm// and //windowmaker//. Specifying the output format is
+//icewm//, //pekwm// and //windowmaker//. Specifying the output format is
 mandatory.
 
 : **-i, --icons**
@@ -49,6 +49,12 @@ do not create a submenu. Instead, place the application categories menus
 in the window manager's main menu. Only works with //fluxbox// and
 //icewm//.
 
+: **--pekwm-dynamic**
+create dynamic menus for pekwm. If you want to have dynamically
+generated menus for pekwm you have to use this option. Do not use it if
+you want to generate static menus for pekwm. Only works with //pekwm//
+of course.
+
 
 = GENERAL OPTIONS =
 
@@ -120,6 +126,45 @@ IceWM menu entries should always include an icon . So, by pointing it
 to a non existing icon, you essentially set it to use no icon. If you
 actually have an icewm icon named "_none_", that one will be used instead.
 
+: **pekwm**
+
+There are two ways to have an XDG menu in pekwm. The first one,
+auto-updates the menu, every time the menu is called. The second one,
+updates the menu only when the user wants to.
+
+**Dynamic Menus**
+
+Edit your //~/.pekwm/menu// file with your favourite text editor and add
+a like like the following one in the location that you want the
+dynamically generated menu to appear:
+
+```
+Entry = "" { Actions = "Dynamic /usr/bin/xdgmenumaker -n -i -f pekwm --pekwm-dynamic" }
+```
+
+Restart pekwm and the generated menu should appear. The menu will be
+automatically generated every time you access it, so it will always be
+up to date. But since xdgmenumaker will run every time you access the
+menu, the menu might not appear instantly.
+
+**Static Menus**
+
+Run
+```
+$ xdgmenumaker -n -i -f pekwm > ~/.pekwm/appsmenu
+```
+to create a file with the menu contents. Then edit your
+//~/.pekwm/menu// file to include that menu, by adding a line like the
+following, in the location that you want the menu to appear:
+```
+INCLUDE = "/home/your_user_name/.pekwm/appsmenu"
+```
+
+Restart pekwm and the generated menu should appear. The menu is static
+and if you add/remove any applications, you will have to run the
+xdgmenumaker command and restart pekwm all over again to update it. The
+advantage is that there will be no delay in displaying the menu.
+
 : **WindowMaker**
 
 There are two ways to have an XDG menu in WindowMaker. The first one,