Scroll to navigation

PRIMA-CFGMAINT(1) User Contributed Perl Documentation PRIMA-CFGMAINT(1)

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

Write configuration to the system-wide config file
Read configuration from both the system-wide and user config files
Do not write backups
Read-only mode
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

Selects a module. Valid for the add, list, and remove commands.
Selects a page. Valid for all commands.
Selects a widget. Valid for the list, remove, rename, and move commands.

Commands

Adds a new object to the configuration. Can be either a page or a module.
Removes an object.
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.
Renames the object to a new name, which is passed as an additional parameter. Can be either a widget or a page.
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

2024-02-01 perl v5.38.2