Re: First try of fvwm-menu-desktop which creates a full menu

2012-07-21 Thread Thomas Funk

Dan Espen des...@verizon.net wrote:
 Haven't you been doing CVS updates?
Sorry, used fvwm-menu-desktop.1 instead of fvwm-menu-desktop.1.in
Correct patch attached.

Thomas
--- /media/daten/shared/sourcen/cvs/fvwm/bin/fvwm-menu-desktop.1.in	2012-07-11 16:45:31.0 +0200
+++ fvwm-menu-desktop.1	2012-07-21 12:18:11.617683854 +0200
@@ -20,88 +20,86 @@
 fvwm-menu-desktop \- Reads XDG menu files and creates Fvwm menus
 
 .SH SYNOPSIS
-
 fvwm-menu-desktop
-[ \fB\-\-help\fR|\fB\-h\fR|\fB\-?\fR ]
-[ \fB\-\-verbose\fR|\fB\-v\fR ]
+[ \fB\-\-help\fR|\fB\-h\fR ]
+[ \fB\-\-version\fR|\fB\-v\fR ]
 [ \fB\-\-install\-prefix\fR \fIDIR\fR ]
 [ \fB\-\-desktop\fR \fINAME\fR ]
-[ \fB\-\-title\fR \fINAME\fR ]
+[ \fB\-\-menu\-type\fR \fINAME\fR ]
+[ \fB\-\-theme\fR \fINAME\fR ]
+[ \fB\-\-with\-titles\fR|\fB\-w\fR ]
 [ \fB\-\-enable\-mini\-icons\fR ]
+[ \fB\-\-size\fR|\fB\-s\fR \fINUM\fR ]
+[ \fB\-\-title\fR|\fB\-t\fR \fINAME\fR ]
+[ \fB\-\-insert\-in\-menu\fR \fINAME\fR ]
+[ \fB\-\-get\-menus\fR \fIall\fR|\fIdesktop\fR ]
+[ \fB\-\-set\-menus\fR \fImenu_paths\fR ]
+[ \fB\-\-verbose\fR ]
+
 
 .SH DESCRIPTION
-This is a python script which parses XDG menus definitions to build
+This is a python script which parses XDG menus definitions to build 
 corresponding fvwm menus.
 
-.SH USAGE
-To add the XDG application menu to the Utilities menu
-add the following to your fvwm config file (.fvwm/config):
-.EX
- ...
-AddToMenu Utilities Application Menu Popup FvwmMenu
-PipeRead 'fvwm-menu-desktop'
-.EE
-
-By default fvwm-menu-desktop
-builds the applications menu
-and the menu is named FvwmMenu.
-
-.EX
-AddToMenu Utilities KDE User Menu Popup kde\-user
-AddToMenu kde\-user
-+ DynamicPopupAction PipeRead 'fvwm-menu-desktop --desktop kde-user --enable-mini-icons [other options]'
-.EE
-
-If you think that fvwm-menu-desktop slows your startup too much do
-not use PipeRead.  Instead run  fvwm-menu-desktop
-and
-redirect the menu to a file and Read that file in
-your .fvwm2rc file.
-Another possibility is to use DynamicPopupAction
-(with fvwm menu), the menu will be built only if
-you pop up the menu. The
-following menu creates a kde\-all menu which contains the user menu
-which is built each time you pop up kde\-all and contains a pop up
-to the system menu which is built only the first time you pop it up.
-.EX
-AddToMenu kde\-all
-+ DynamicPopupAction FuncRecreateKdeAll
-
-AddToMenu kde\-sys
-+ DynamicPopupAction PipeRead 'fvwm-menu-desktop \\
-\-\-desktop kde\-sys [options, but \-\-destroy-type d* or n*]'
-
-AddToFunc FuncRecreateKdeAll \\
-I PipeRead 'fvwm-menu-desktop \\
-\-\-desktop kde\-user \-\-enable\-mini\-icons \-\-name kde\-all \\
-\-\-destroy-type dynamic [options you like]'
-+ I AddToMenu kde\-all  Nop
-+ I AddToMenu kde\-all Kde System%mini/mini\-k.xpm% Popup kde\-sys
-.EE
-
 .SH OPTIONS
 
 .IP Main Options
 
 .IP \fB\-\-help\fR
 Show the help and exit.
-.IP \fB\-\-verbose\fR
-Run verbosely.
+
+.IP \fB\-\-version\fR
+Show the version and exit.
+
 .IP \fB\-\-install-prefix\fR \fIDIR\fR
-Optional parameter to override the default location
-for XDG menu definitions.  The default location is /etc/xdg/menus.
+Optional parameter to override the default locations for XDG menu
+definitions. Related to the xdg specification the default location is
+/etc/xdg/menus and $HOME/.config/menus if exist.
+
 .IP \fB\-\-desktop\fR \fINAME\fR
-The name of the menus you want to generate.
-The default is application.
-.IP \fB\-\-title\fR \fINAME\fR
-Define the menu title of the top menu. Default
-is Gnome System Menu for gnome\-sys, Gnome User Menu for
-gnome\-user, Gnome Red Hat Menu for gnome\-redhat,
-Gnome Mandriva Menu for gnome\-mandriva. For KDE the
-default is given by KDE itself (or are similar to GNOME title).
-.IP \fB\-\-name\fR \fINAME\fR
-Define the menu name of the top menu. Default is the \-\-desktop
-name if you use one above.
+Optional parameter to override the \fINAME\fR of the main desktop
+environment installed on the system. If a system offers multiple
+desktop environments $XDG_MENU_PREFIX is typically set and is
+ignored if \-\-desktop is denoted. Possible names are: \fIgnome\fR,
+\fIkde\fR, \fIxfce\fR, \fIlxde\fR, \fIdebian\fR, etc.
+
+.IP \fB\-\-menu\-type\fR \fINAME\fR
+Defines which type of menus should be found. Possible \fINAME\fR types
+could be: \fIapplications\fR, \fIsettings\fR, \fIpreferences\fR, etc.
+
+Note that if the specified menu type doesn't exist the generated menu
+is empty!
+
+.IP \fB\-\-theme\fR \fINAME\fR
+Defines the used icon theme. Default is \fIgnome\fR but all others
+found in /usr/share/icons could be used except the \fIhicolor\fR theme
+because it's the default fallback theme if no icon is found.
+
+.IP \fB\-\-with\-titles\fR|\fB\-w\fR
+If this option is set menus are generated with titles. Default is no
+titles.
+
+.IP \fB\-\-title\fR|\fB\-t\fR \fINAME\fR 
+Option to define the menu title \fINAME\fR of the top menu used by Fvwms
+\fBPopup\fR command. Default is FvwmMenu.
+
+.IP 

CVS dane: * fvwm-menu-desktop.1.in: Applied patch from Thomas Funk.

2012-07-21 Thread cvs
CVSROOT:/home/cvs/fvwm
Module name:fvwm
Changes by: dane12/07/21 20:37:03

Modified files:
bin: Tag: branch-2_6 ChangeLog 
 fvwm-menu-desktop.1.in 

Log message:
* fvwm-menu-desktop.1.in: Applied patch from Thomas Funk.
Some changes.




Re: First try of fvwm-menu-desktop which creates a full menu

2012-07-21 Thread Dan Espen
Thomas Funk t.f...@web.de writes:

 Dan Espen des...@verizon.net wrote
 TF:

 All I really need is the words.
 I can add (t)groff/man markup as needed.
 Thanks for your accommodation but I've finished it already. Patch

Nice.  Regarding this section:

\ .SH ERRORS AND WARNINGS
\ \fBfvwm-menu-desktop\fR prints errors and warnings to STDERR. So these
\ messages could be redirect to e.g. ~/.xsessions-errors:

\ .RS
\ .EX
\ fvwm-menu-desktop  $FVWM_USERDIR/.menu 2 ~/.xsession-errors
\ .EE
\ .RE

Everything I run under fvwm already redirects to ~/.xsession-errors.
(I send it somewhere else, but same idea.)

Point is, isn't all error output, from everything under Fvwm already
going to an error file?
I don't think we need that section.

-- 
Dan Espen