Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
FVWM-THEMES-MENUAPP(1)		  FVWM Utility		  FVWM-THEMES-MENUAPP(1)

NAME
     fvwm-themes-menuapp - fvwm-themes menus utility

SYNOPSIS
     fvwm-themes-menuapp  --build-menu	or  --com-mode	or--help  or --version [
     --site] [ --menu-files [file1,file2,...] ] [ --remove-popup]  [  --com-name
     name]

DESCRIPTION
     This  script  is not a user script. It is used by Fvwm-Themes to do differ-
     rent task concerning menu and other related things.  This	scripts  can  do
     the following:

     Parse and rebuild FVWM configuration files to build a clean menu from them:
     application  not  in  the	path are removed, certain unuseful sub menus and
     separator are removed (--build-menus option).

     It can work in a locked way  and  communicate  (via  fvwm-themes-com)  with
     FvwmScript-Menus  or  any other programs (--com-mode option). See below for
     the  list	of  query  that  you  can   ask   to   fvwm-themes-menuapp   via
     fvwm-themes-com.

     Plan  for	the  future:  use  an  application data base and parse and build
     (Mini)Icon Styles.

OPTIONS
     You must use (only) one of the following four options:

     --help    - show the help and exit

     --version - show the version and exit

     --build-menus - Cause fvwm-themes-menuapp to build clean menus.

     --com-mode Run fvwm-themes-menuapp under the "communication mode".

     --menu-files [file1,file2,...] -  files  which  are  read	and  written  by
     fvwm-themes-menuapp.    By    default,    fvwm-themes-menuapp   will   read
     $FT_DATADIR/themes/default/menus-programs with the --site option.	 Without
     the  --site  option fvwm-themes-menuapp will read menus-programs and menus-
     extra     (if    found)	in     the     fvwm-themes     personal     dir:
     $FVWM_USERDIR/themes/personal.   If menus-programs is not found in this di-
     rectory the site's menus-programs file is used (the one under $FT_DATADIR).
     Moreover, if menus-extra is not found, a virtual such file  is  created  so
     that the "personal" menus can be created (MenuFvwmPersonal) in it.

     --site - Change the default for the --menu-files option.

     --remove-popup - Remove the sub menu popup that popup empty menu (only use-
     ful with --build-menus). In fact only certain sub menu popup are removed.

     --com-name  name - use name as name for communication with fvwm-themes-com.
     By default, "appmenu" is used, but you should use	 "appmenu-pid"	as  name
     where  pid is the pid of the program that want to talk to fvwm-themes-menu-
     app so that fvwm-themes-menuapp can exit if this program exit and	so  that
     fvwm-themes-menuapp  can  kill  the  program if an internal error happen in
     fvwm-themes-menuapp. On the other hand, if you  want  to  talk  with  fvwm-
     themes-menuapp  in,  say,	a  terminal  you must not give an name as "menu-
     app-an_integer" as name.

COMMUNICATION COMMANDS
     Start fvwm-themes-menuapp as:

	     fvwm-themes-menuapp --com-mode [--com-name=menuapp-pid ...]

     Then use fvwm-themes-com as:

	     fvwm-themes-com --name menuapp[-pid] [--lock-and-get] --message="Command"

     where Command is one of the following. All this commands are "lock and get"
     but the exit command. A return value of 0 indicate an error.

     menus-list - List of the menus.

     root-menus-list - List of the "root" menus.

     root-menus i - ith root menu.

     menu-items menu_name - List of the items of the menu menu_name.

     item menu_name:i - Information on the ith item of the menu menu_name.

     remove menu_name:i - Remove the ith item of the menu menu_name.

     move-up menu_name:i - Move up the ith item of the menu menu_name.

     move-down menu_name:i - Move down the ith item of the menu menu_name.

     add-or-edit-item	  X	--it='menu_name:i'     --t='type'     --n='name'
     --mi='menu-icon'	    --wd='working dir or window title' where X is either
     A for add or E for edit, see the code for details :)

     selection-items - List of the items in the selection.

     add-item-to-selection menu_name:i - Add the ith item of the menu  menu_name
     to the selection.

     remove-sel-item i - Remove the ith item of the selection.

     remove-all-sel-item - Remove all the selection items.

     copy-sel-item  menu_name:i:j - Copy the jth item of the selection after the
     ith item of the menu menu_name.

     copy-all-sel menu_name:i - Copy all the selection after the ith item of the
     menu menu_name.

     try - Out put the contents of the files (as soon as possible will	run  the
     good fvwm-themes-config command).

     save - wrote back the files

     exit - Stop fvwm-themes-menuapp.

USAGE
     When fvwm-themes is installed, fvwm-themes-menuapp is run as:

       fvwm-themes-menuapp --site --build-menus --remove-popup

     FvwmScript-Menus  used  (and  in fact is based on) fvwm-themes-menuapp. See
     this FvwmScript script for examples with the com-mode option.

AUTHORS
     Olivier Chapuis <olivier.chapuis@free.fr>, 5 May 2000.

COPYING
     The script is distributed by the same terms as fvwm itself.  See  GNU  Gen-
     eral Public License for details.

BUGS
     Report bugs to fvwm-themes-devel@lists.sourceforge.net.

perl v5.8.0			   2003-06-05		  FVWM-THEMES-MENUAPP(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=fvwm-themes-menuapp&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help