--- trunk/lib/Frey.pm	2008/07/06 11:59:58	56
+++ trunk/lib/Frey.pm	2008/11/18 14:19:50	415
@@ -1,6 +1,8 @@
 package Frey;
 use Moose;
 
+our $VERSION = "0.19";
+
 has 'debug' => (
 	is => 'rw',
 	isa => 'Bool',
@@ -18,34 +20,41 @@
 The Norse god who dispenses peace, good weather, prosperity, and bountiful
 crops; the brother of Freya.
 
-=cut
+Basically you write L<Moose> classes which become deirectly callable from
+the web using REST API
 
-use Data::Dump qw/dump/;
-use File::Find;
+=head1 INTROSPECTION
 
-has 'classes' => (
-	is => 'ro',
-#	isa => 'HashRef[Str]',
-	default => sub {
-		my $self = shift;
-		# FIXME there must be better way to do this in Moose style
-		my $classes;
-		finddepth({ no_chdir => 1, wanted => sub {
-			return unless s/\.pm$//;
-			my @a = split(m!/!,$_);
-			if ( $#a != 2 ) {
-				warn "SKIP $_ [$#a]" if $self->debug;
-				return;
-			}
-			warn ">> $_ ",dump( @a ) if $self->debug;
-			my $package = "$a[1]::$a[2]";
-			warn "## $package\n";
-			push @$classes, { $package => "$_.pm" };
-		} }, 'lib');
-		warn "## classes = ",dump( $classes ) if $self->debug;
-		$classes;
-	},
-	lazy => 1,
-);
+Secondary goal is to have introspection.
+
+=head2 Moose classes
+
+All Moose classes have simple introspection API which use
+L<Frey::Introspect> to show class and it's pod (using L<Frey::Pod>). 
+
+Example of valid REST URL is
+
+  http://localhost:16001/Frey
+
+which will show L<Frey> class introspection.
+
+You can also add method invocation and optonal parametars to C<new>
+constructor like this:
+
+  http://localhost:16001/Frey::Pod/markup?class=Frey
+
+this is same using L<Frey::Pod> from perl as
+
+  Frey::Pod->new( class => 'Frey' )->markup;
+
+if you leave out parametars, L<Frey::Run> will ask for required ones.
+
+=head2 Database
+
+For database objects we support L<Fey> and when your objects are created
+C<< with 'Frey::Collection' >> they will have basic CRUD functionality
+implemented by L<Frey::ObjectBrowser>.
+
+=cut
 
 1;