prima-cfgmaint(1) [debian man page]

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

NAME

       cfgmaint - configuration tool for Visual Builder

SYNTAX

       cfgmaint [ -rbxop ] command object [ parameters ]

DESCRIPTION

       Maintains widget palette configuration for the Visual Builder.  It can be stored in the system-wide and the 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 "command" and "object" arguments, where "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 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 add, list, and remove commands.

       p   Selects a page. Valid for all commands.

       w   Selects a widget. Valid for 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 object name. In case 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 an object to a new name, which is passed as additional parameter.  Can be either a widget or a page.

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

EXAMPLE

       Add a new module to the system-wide configuration:

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

       List widgets, 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

perl v5.14.2							    2009-02-24							       CFGMAINT(1)

pod::Prima::Timer(3)					User Contributed Perl Documentation				      pod::Prima::Timer(3)

NAME

       Prima::Timer - programmable periodical events

SYNOPSIS

	   my $timer = Prima::Timer-> create(
	       timeout => 1000, # milliseconds
	       onTick  => sub {
		  print "tick!
";
	       },
	   );

	   $timer-> start;

DESCRIPTION

       Prima::Timer arranges periodical notifications to be delivered in certain time intervals.  The notifications are triggered by the system,
       and are seen as "Tick" events. There can be many active Timer objects at one time, spawning events simultaneously.

USAGE

       Prima::Timer is a descendant of Prima::Component.  Objects of Prima::Timer class are created in standard fashion:

	 my $t = Prima::Timer-> create(
	    timeout => 1000,
	    onTick  => sub { print "tick
"; },
	 );
	 $t-> start;

       If no `owner` is given, $::application is assumed.

       Timer objects are created in inactive state; no events are spawned. To start spawning events, <start()> method must be explicitly called.
       Time interval value is assigned using the <::timeout> property in milliseconds.

       When the system generates timer event, no callback is called immediately, - an event is pushed into stack instead, to be delivered during
       next event loop.  Therefore, timeout value is not held accurately, and events may take longer time to pass. More accurate timing scheme, as
       well as timing with precision less than a millisecond, is not supported by the toolkit.

API

   Properties
       timeout MILLISECONDS
	   Manages time interval between "Tick" events.  In set-mode call, if the timer is in active state ( see "get_active()", the new timeout
	   value is applied immediately.

   Methods
       get_active
	   Returns a boolean flag, whether object is in active state or not. In the active state "Tick" events are spawned after "::timeout" time
	   intervals.

       get_handle
	   Returns a system-dependent handle of object

       start
	   Sets object in active state. If succeed, or if the object is already in active state, returns 1. If the system was unable to create a
	   system timer instance, 0 is returned.

       stop
	   Sets object in inactive state.

   Events
       Tick
	   A system generated event, spawned every "::timeout" milliseconds if object is in active state.

AUTHOR

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

SEE ALSO

       Prima, Prima::Object

perl v5.14.2							    2009-02-24						      pod::Prima::Timer(3)