flaw(7) [debian man page]

flaw(7) 						 Miscellaneous Information Manual						   flaw(7)

NAME

       flaw - a Lua OO management framework for awesome WM widgets

DESCRIPTION

       flaw stands for Fully Loaded AWesome.  It is a LUA object oriented library providing a thin abstraction layer above awesome widgets.  It is
       aimed at being simple and resources efficient.

       To achieve these goals, flaw provides the following concepts.

       gadgets
	      To add functionality to awesome widgets, flaw defines gadget objects, which are a wrapper around a widget.  All gadgets have proper-
	      ties,  events,  a  refresh  mechanism and a data provider (see below).  Gadgets can wrap all awesome widget type, namely text boxes,
	      image boxes, graphs or progress bars.  flaw provides many gadgets for common system information (like CPU or memory activity).

       provider
	      flaw tries to minimise system access and data refresh.  Since all information do not have the  same  expiration  rate,  all  gadgets
	      refresh  independently.	And  since some gadgets can share information, all data is provided by providers which can be shared among
	      gadgets.	Providers maintain status data from the system and refreshes only when necessary (ie. when the gadget  with  the  shortest
	      refresh rate demands it).

       events Events  are a way for the user to modify the gadget behaviour or properties when some conditions are met.  An event is composed of a
	      trigger, which computes the condition, and an action.  Event triggers are tested by the providers only when data changes.  Both  the
	      condition and the action are provided by the user.

USAGE

       flaw  depends  on  the lua-filesystem package which can be found http://luaforge.net/projects/luafilesystem.  Once installed, the following
       statement must be inserted in awesome configuration before any flaw gadget or mechanism is used.
	      require('flaw')

       Using flaw consists in creating gadgets, passing them parameters to customize their display and events to add some behaviour to	them,  and
       then  adding  them  in a wibox like any other awesome widget.  flaw and awful gadgets can live together. The complete flaw documentation is
       available in Luadoc format. Enter the following command to generate it.
	      LUA_PATH="path_toflaw/doclet/html/?;;" luadoc -d html --nofiles *.lua

DIAGNOSTICS

       flaw tries to recover upon bad invocations.  When something wrong occurs, it outputs warning or error messages to stderr (for  example,	if
       awesome was started with xsession, output will be found in ~/.xsession-errors ).

BUGS

       Certainly a lot.

AUTHOR

       David Soulayrol <david.soulayrol at gmail dot net>

SEE ALSO

       awesome(1), awesome-client(1), awesomerc(5)

								   FEBRUARY 2009							   flaw(7)

Data::Dumper::Concise::Sugar(3pm)			User Contributed Perl Documentation			 Data::Dumper::Concise::Sugar(3pm)

NAME

       Data::Dumper::Concise::Sugar - return Dwarn @return_value

SYNOPSIS

	 use Data::Dumper::Concise::Sugar;

	 return Dwarn some_call(...)

       is equivalent to:

	 use Data::Dumper::Concise;

	 if (wantarray) {
	    my @return = some_call(...);
	    warn Dumper(@return);
	    return @return;
	 } else {
	    my $return = some_call(...);
	    warn Dumper($return);
	    return $return;
	 }

       but shorter. If you need to force scalar context on the value,

	 use Data::Dumper::Concise::Sugar;

	 return DwarnS some_call(...)

       is equivalent to:

	 use Data::Dumper::Concise;

	 my $return = some_call(...);
	 warn Dumper($return);
	 return $return;

       If you need to force list context on the value,

	 use Data::Dumper::Concise::Sugar;

	 return DwarnL some_call(...)

       is equivalent to:

	 use Data::Dumper::Concise;

	 my @return = some_call(...);
	 warn Dumper(@return);
	 return @return;

       If you want to label your output, try DwarnN

	 use Data::Dumper::Concise::Sugar;

	 return DwarnN $foo

       is equivalent to:

	 use Data::Dumper::Concise;

	 my @return = some_call(...);
	 warn '$foo => ' . Dumper(@return);
	 return @return;

       If you want to output a reference returned by a method easily, try $Dwarn

	$foo->bar->{baz}->$Dwarn

       is equivalent to:

	 my $return = $foo->bar->{baz};
	 warn Dumper($return);
	 return $return;

       If you want to format the output of your data structures, try DwarnF

	my ($a, $c) = DwarnF { "awesome: $_[0] not awesome: $_[1]" } $awesome, $cheesy;

       is equivalent to:

	 my @return = ($awesome, $cheesy);
	 warn DumperF { "awesome: $_[0] not awesome: $_[1]" } $awesome, $cheesy;
	 return @return;

       If you want to immediately die after outputting the data structure, every Dwarn subroutine has a paired Ddie version, so just replace the
       warn with die.  For example:

	DdieL 'foo', { bar => 'baz' };

DESCRIPTION

	 use Data::Dumper::Concise::Sugar;

       will import Dwarn, $Dwarn, DwarnL, DwarnN, and DwarnS into your namespace. Using Exporter, so see its docs for ways to make it do something
       else.

   Dwarn
	 sub Dwarn { return DwarnL(@_) if wantarray; DwarnS($_[0]) }

   $Dwarn
	 $Dwarn = &Dwarn

   $DwarnN
	 $DwarnN = &DwarnN

   DwarnL
	 sub Dwarn { warn Data::Dumper::Concise::Dumper @_; @_ }

   DwarnS
	 sub DwarnS ($) { warn Data::Dumper::Concise::Dumper $_[0]; $_[0] }

   DwarnN
	 sub DwarnN { warn '$argname => ' . Data::Dumper::Concise::Dumper $_[0]; $_[0] }

       Note: this requires Devel::ArgNames to be installed.

   DwarnF
	 sub DwarnF (&@) { my $c = shift; warn &Data::Dumper::Concise::DumperF($c, @_); @_ }

TIPS AND TRICKS

   global usage
       Instead of always just doing:

	 use Data::Dumper::Concise::Sugar;

	 Dwarn ...

       We tend to do:

	 perl -MData::Dumper::Concise::Sugar foo.pl

       (and then in the perl code:)

	 ::Dwarn ...

       That way, if you leave them in and run without the "use Data::Dumper::Concise::Sugar" the program will fail to compile and you are less
       likely to check it in by accident.  Furthmore it allows that much less friction to add debug messages.

   method chaining
       One trick which is useful when doing method chaining is the following:

	 my $foo = Bar->new;
	 $foo->bar->baz->Data::Dumper::Concise::Sugar::DwarnS->biff;

       which is the same as:

	 my $foo = Bar->new;
	 (DwarnS $foo->bar->baz)->biff;

SEE ALSO

       You probably want Devel::Dwarn, it's the shorter name for this module.

perl v5.10.1							    2011-01-20					 Data::Dumper::Concise::Sugar(3pm)