From 80c4320400421ee2433448b66364e21a077e9542 Mon Sep 17 00:00:00 2001
From: George Vlahavas <vlahavas@gmail.com>
Date: Mon, 3 Oct 2016 19:11:59 +0300
Subject: [PATCH] Update manpage for Fvwm and --max-icon-size

---
 man/xdgmenumaker.t2t | 51 +++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 46 insertions(+), 5 deletions(-)

diff --git a/man/xdgmenumaker.t2t b/man/xdgmenumaker.t2t
index 783bb08..e170224 100644
--- a/man/xdgmenumaker.t2t
+++ b/man/xdgmenumaker.t2t
@@ -28,20 +28,21 @@ The menu entries that are generated by **xdgmenumaker** are localised
 according to the running user locale settings.
 
 **xdgmenumaker** currently supports generating menus for //blackbox//,
-//compizboxmenu//, //fluxbox//, //icewm//, //jwm//, //pekwm// and
-//windowmaker//.
+//compizboxmenu//, //fluxbox//, //fvwm//, //icewm//, //jwm//, //pekwm//
+and //windowmaker//.
 
 **xdgmenumaker** requires //Python 2.7// or //3.x//, //pygtk//
 (for Python 2.7) or //pygobject// and //gobject-instrospection//
-(for Python 3.x), as well as //pyxdg//.
+(for Python 3.x), as well as //pyxdg//. //Pillow// is an optional
+dependency (used by the **--max-icon-size** option).
 
 
 = OPTIONS =
 
 : **-f, --format**
 specify the output format to use. Valid options are //blackbox//,
-//compizboxmenu//, //fluxbox//, //icewm//, //jwm//, //pekwm// and
-//windowmaker//.
+//compizboxmenu//, //fluxbox//, //fvwm//, //icewm//, //jwm//, //pekwm//
+and //windowmaker//.
 Specifying the output format is mandatory.
 
 : **-i, --icons**
@@ -60,6 +61,11 @@ do not create a submenu. Instead, place the application categories menus
 in the window manager's main menu. This option does not have any effect
 for //windowmaker// menus.
 
+: **--max-icon-size**
+restrict the maximum size for icons to the one specified with the
+//--size// option. Any icons that are larger than the specified size
+will get discarded and will not be used.
+
 : **--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
@@ -180,6 +186,41 @@ again:
 ``[exec] (Update Fluxbox Menu) {xdgmenumaker -f fluxbox > ~/.fluxbox/xdg_menu}``
 
 
+: **Fvwm**
+
+To generate an application menu for Fvwm, you can run **xdgmenumaker**
+like this:
+
+``$ xdgmenumaker -f fvwm > ~/.fvwm/xdgmenu``
+
+and then edit your main Fvwm configuration file and add a line to read
+that file:
+
+``read xdgmenu``
+
+and also include it somewhere in your main menu, for example:
+
+```
+AddToMenu MenuFvwmRoot  "Root Menu"             Title
++                       "Applications"          Popup xdgmenu
+```
+You could also put the menus for individual categories in your main menu
+if you want. Just look in the ``~/.fvwm/xdgmenu`` file for the category
+names.
+
+You can add the **xdgmenumaker** command as another item in your menu,
+if you want to update it:
+
+``+ "Update Fvwm Menu" Exec xdgmenumaker -f fvwm > ~/.fvwm/xdgmenu``
+
+and restart Fvwm to apply the changes.
+
+//NOTE:// If you're going to use the //--icons// option to include icons
+in your menus, you might consider using the //--max-icon-size//
+option too. Fvwm does not resize icons in its menu and having entries
+with icons that are too big makes for funny looking menus.
+
+
 : **IceWM**
 
 To generate an application menu for IceWM, run **xdgmenumaker** like this: