DESCRIPTION

A perl script which provides an output to read in with PipeRead to build an fvwm menu containing a directory listing. Almost everything can be configured.

HINTS

The title item with its own attached action is usually added to the menu. This may be used to define an action for the directory for which the menu is built, such as starting a terminal in this directory (the default). However, this may annoy some users. To disable the title action use --command-title "", to remove the title completely use --title "".

OPTIONS

--help

show the usage and exit

--version

show version and exit

--name name

menu name, used only with --reuse, default is MenuBrowser

--title title

menu title format, default is '%*-40p' - last 40 characters of the current full path. TAB can be specified as '\t', but in .fvwm2rc you should specify a double backslash or a real TAB.

Format specifiers: %d - the current directory name %p - the current directory full path

These specifiers can receive an optional integer size, positive for right adjusted string or negative for left adjusted, example: %8x; and optional *num or *-num, which means to leave only the first or last (if minus) num of chars, the num must be greater than 3, since the striped part is replaced with ``...'', example: %*30x. Both can be combined: %-10*-20x, this instructs to get only the 20 last characters, but if the length is less then 10 - to fill with up to 10 spaces on the right.

--item format

menu item format, default is '%n'. TAB and width modifiers for %n, %N and %s can be specified as described in --title above. Note, specifying a non default format slows the script.

an fvwm Exec command on directory title (usually the shell), default is ${SHELL-/bin/sh}. '-' means no Exec command, i.e. Nop. If the command is not started with '^' X terminal call is prepended. The command is started in the currently browsed directory.

--exec-file command

an fvwm Exec command on regular files, default is ${EDITOR-vi}. '-' means no Exec command, i.e. Nop. If the command is not started with '^' X terminal call is prepended. The actual file name is appended to the command.

--exec-app [command]

an fvwm Exec command on +x files, default is '-', which means the same command as on regular files. If no command is given, it is assumed to be empty - simply run the +x file. If the command is not started with '^' X terminal call is prepended. The actual file name is appended to the command.

--command-title command

an fvwm command to execute on title. If this option is not given (or command is '-'), the "--exec-title" is used instead. In the command, %d is substituted with the full directory path.

an fvwm command to execute on +x files. If this option is not given (or command is '-'), the "--command-app" is used instead. In the command, %f is substituted with the full file path.

In fact, --exec-app=^exec is equivalent to --command-app='Exec exec ``%f'''

--[no]reuse

no pop-up menus, reuse the same menu, default is --noreuse. When you specify this option the Menu action is used, not Popup. Also, the --name parameter is not ignored, and --dir parameter is ignored if there is ~/.fvwm/.fvwm-menu-directory.dir file. This file is only created or used with this option specified, it is the only solution for the current fvwm menu state.

--[no]check-subdirs

check all subdirs for having execute (+x) permission and replace ``Popup''/``Menu'' command with ``Nop'' for these without permissions. This has a visual effect of disabling popup triangle in the subdirectory item. The default is --nocheck-subdirs, because: 1) enabling this slows a bit the script, 2) with this option enabled, if no icons used and no dir/file separate sorting used there is no way to know that the item is directory and not file.

--special-dirs value

add .. or ~ or / special directories according to given optional value. Without with option these directories are not added. Default value if not specified is ``1,2''. The value is comma separated ordered special directory indexes, where 1 is parent directory, 2 is home directory, 3 is root directory. If minus is prepended to the value, special directories are added at the bottom of menu instead of top. Value ``0'' or any bad value is equivalent to non-specifying this option at all.

--[no]memory-for-speed

use speed optimization, i.e. use previously created directory menus without destroying it when closed, default is --nomemory-for-speed

Warning: speed optimization takes up a lot of memory
that is never free'd again while fvwm is running.

--menu-style name

assign MenuStyle name to the menus

--func-name name

overwrite the default MissingSubmenuFunction name that is ``FuncFvwmMenuDirectory''

Option parameters can be specified either using '=' or in the next argument. Short options are ok if not ambiguous: "-a", "-x", "-icon-f"; but be careful with short options, what is now unambiguous, can become ambiguous in the next versions.