NAME

cfgmaint - configuration tool for Visual Builder

SYNTAX

cfgmaint [ -rbxop ] command object [ parameters ]

DESCRIPTION

Maintains configuration of the widget palette in the Visual Builder. The widget palette can be stored in the system-wide and local user config files. cfgmaint allows adding, renaming, moving, and deleting the classes and pages in the Visual Builder widget palette.

USAGE

cfgmaint is invoked with the command and object arguments where the command defines the action to be taken and object the object to be handled.

Options

-r

Write configuration to the system-wide config file

-b

Read configuration from both the system-wide and user config files

-x

Do not write backups

-o

Read-only mode

-p

Execute use Prima; code before start. This option might be necessary when adding a module that relies on the toolkit but does not invoke the code itself.

Objects

m

Selects a module. Valid for the add, list, and remove commands.

p

Selects a page. Valid for all commands.

w

Selects a widget. Valid for the list, remove, rename, and move commands.

Commands

a

Adds a new object to the configuration. Can be either a page or a module.

d

Removes an object.

l

Prints the object name. In case the object is a widget, prints all registered widgets. If the string is specified as an additional parameter, it is treated as a page name, and only widgets from the page are printed.

r

Renames the object to a new name, which is passed as an additional parameter. Can be either a widget or a page.

m

If the object is a widget, relocates one or more widgets to a new page. If the object is a page, moves the page before the page specified as an additional parameter, or to the end if no additional page is specified.

EXAMPLE

Add a new module to the system-wide configuration:

cfgmaint -r a m CPAN/Prima/VB/New/MyCtrls.pm

List widgets that are present in both config files:

cfgmaint -b l w

Rename a page:

cfgmaint r p General Basic

FILES

Prima/VB/Config.pm, ~/.prima/vbconfig

AUTHOR

Dmitry Karasik, <dmitry@karasik.eu.org>.

SEE ALSO

VB, Prima::VB::CfgMaint