@@ -2040,6 +2040,12 @@ These filters are added to the C<out> filters, set by C<apply_filter()>.

 C<filter> option is also available

 by C<insert()>, C<update()>, C<delete()>, C<select()>

+=item C<query>

+

+    query => 1

+

+C<execute> method return L<DBIx::Custom::Query> object, not executing SQL.

+

 =item C<type>

 Specify database data type.

@@ -2066,79 +2072,49 @@ Trun type rule off.

     $dbi->delete(table => 'book', where => {title => 'Perl'});

-Delete statement.

+Execute delete statement.

-The following opitons are currently available.

+The following opitons are available.

 =over 4

-=item C<table>

-

-Table name.

-

-    $dbi->delete(table => 'book');

-

-=item C<where>

-

-Where clause. This is hash reference or L<DBIx::Custom::Where> object

-or array refrence, which contains where clause and paramter.

-    

-    # Hash reference

-    $dbi->delete(where => {title => 'Perl'});

-    

-    # DBIx::Custom::Where object

-    my $where = $dbi->where(

-        clause => ['and', 'author = :author', 'title like :title'],

-        param  => {author => 'Ken', title => '%Perl%'}

-    );

-    $dbi->delete(where => $where);

-

-    # String(with where_param option)

-    $dbi->delete(

-        where => 'title like :title',

-        where_param => {title => '%Perl%'}

-    );

-    

 =item C<append>

-Append statement to last of SQL. This is string.

-

-    $dbi->delete(append => 'order by title');

+Same as C<select> method's C<append> option.

 =item C<filter>

 Same as C<execute> method's C<filter> option.

-=item C<query>

+=item C<id>

-Get L<DBIx::Custom::Query> object instead of executing SQL.

-This is true or false value.

+    id => 4

+    id => [4, 5]

-    my $query = $dbi->delete(query => 1);

+ID corresponding to C<primary_key>.

+You can delete rows by C<id> and C<primary_key>.

-You can check SQL.

+    $dbi->delete(

+        parimary_key => ['id1', 'id2'],

+        id => [4, 5],

+        table => 'book',

+    );

-    my $sql = $query->sql;

+The above is same as the followin one.

-=item C<id>

+    $dbi->delete(where => {id1 => 4, id2 => 5}, table => 'book');

-Delete using primary_key.

+=item C<query>

-    $dbi->delete(

-        primary_key => 'id',

-        id => 4,

-    );

+Same as C<execute> method's C<query> option.

-    $dbi->delete(

-        primary_key => ['id1', 'id2'],

-        id => [4, 5],

-    );

+=item C<table>

-The above is same as the followin ones.

+    table => 'book'

-    $dbi->delete(where => {id => 4});

+=item C<where>

-    $dbi->delete(where => {id1 => 4, id2 => 5});

+Same as C<select> method's C<where> option.

 =item C<primary_key>

@@ -2158,7 +2134,7 @@ Same as C<execute> method's C<type_rule_off> option.

     $dbi->delete_all(table => $table);

-Delete statement to delete all rows.

+Execute delete statement for all rows.

 Options is same as C<delete()>.

 =head2 C<insert>

@@ -2179,52 +2155,34 @@ Same as C<select> method's C<append> option.

 Same as C<execute> method's C<filter> option.

-=item C<query>

-

-Get L<DBIx::Custom::Query> object instead of executing SQL.

-This is true or false value.

-

-    my $query = $dbi->insert(query => 1);

-

-You can check SQL.

-

-    my $sql = $query->sql;

-

 =item C<id>

-Insert using primary_key.

+    id => 4

+    id => [4, 5]

-    $dbi->insert(

-        primary_key => 'id',

-        id => 4,

-        param => {title => 'Perl', author => 'Ken'}

-    );

+ID corresponding to C<primary_key>.

+You can insert a row by C<id> and C<primary_key>.

     $dbi->insert(

-        primary_key => ['id1', 'id2'],

+        {title => 'Perl', author => 'Ken'}

+        parimary_key => ['id1', 'id2'],

         id => [4, 5],

-        param => {title => 'Perl', author => 'Ken'}

+        table => 'book'

     );

-The above is same as the followin ones.

-

-    $dbi->insert(

-        param => {id => 4, title => 'Perl', author => 'Ken'}

-    );

+The above is same as the followin one.

     $dbi->insert(

-        param => {id1 => 4, id2 => 5, title => 'Perl', author => 'Ken'}

+        {id1 => 4, id2 => 5, title => 'Perl', author => 'Ken'},

+        table => 'book'

     );

 =item C<primary_key>

-See C<id> description.

+    primary_key => 'id'

+    primary_key => ['id1', 'id2']

-=item C<table>

-

-Table name.

-

-    $dbi->insert(table => 'book');

+Primary key. This is used by C<id> option.

 =item C<param>

@@ -2237,13 +2195,23 @@ first argument is received as C<param>.

     $dbi->insert({title => 'Perl', author => 'Ken'}, table => 'book');

+=item C<query>

+

+Same as C<execute> method's C<query> option.

+

+=item C<table>

+

+    table => 'book'

+

+Table name.

+

 =item C<type>

 Same as C<execute> method's C<type> option.

 =item C<type_rule_off> EXPERIMENTAL

-Turn type rule off.

+Same as C<execute> method's C<type_rule_off> option.

 =back

@@ -2413,92 +2381,99 @@ Filter based on type.

         where  => {author => 'Ken'},

     );

-Select statement.

+Execute select statement.

-The following opitons are currently available.

+The following opitons are available.

 =over 4

-=item C<table>

-

-Table name.

+=item C<append>

-    $dbi->select(table => 'book');

+    append => 'order by title'

+Append statement to last of SQL.

+    

 =item C<column>

-

-Column clause. This is array reference or constant value.

-

-    # Array reference

-    $dbi->select(column => ['author', 'title']);

-    # Constant value

-    $dbi->select(column => 'author');

+    column => 'author'

+    column => ['author', 'title']

+

+Column clause.

-Default is '*' if C<column> is not specified.

+if C<column> is not specified, '*' is set.

-    # Default

-    $dbi->select(column => '*');

+    column => '*'

-You can specify hash reference. This is EXPERIMENTAL.

+You can specify hash reference in array reference. This is EXPERIMENTAL.

-    # Hash reference EXPERIMENTAL

-    $dbi->select(column => [

+    column => [

         {book => [qw/author title/]},

         {person => [qw/name age/]}

-    ]);

+    ]

-This is expanded to the following one by C<col> method automatically.

+This is expanded to the following one by using C<col> method.

     book.author as "book.author",

     book.title as "book.title",

     person.name as "person.name",

     person.age as "person.age"

-You can specify array reference in array refernce.

+You can specify array reference in array reference.

-    $dbi->select(column => [

+    column => [

         ['date(book.register_datetime)', as => 'book.register_date']

-    ]);

+    ];

-These is joined and quoted.

+Alias is quoted and joined.

     date(book.register_datetime) as "book.register_date"

-=item C<where>

+=item C<filter>

-Where clause. This is hash reference or L<DBIx::Custom::Where> object,

-or array refrence, which contains where clause and paramter.

-    

-    # Hash reference

-    $dbi->select(where => {author => 'Ken', 'title' => 'Perl'});

-    

-    # DBIx::Custom::Where object

-    my $where = $dbi->where(

-        clause => ['and', 'author = :author', 'title like :title'],

-        param  => {author => 'Ken', title => '%Perl%'}

+Same as C<execute> method's C<filter> option.

+

+=item C<id>

+

+    id => 4

+    id => [4, 5]

+

+ID corresponding to C<primary_key>.

+You can select rows by C<id> and C<primary_key>.

+

+    $dbi->select(

+        parimary_key => ['id1', 'id2'],

+        id => [4, 5],

+        table => 'book'

     );

-    $dbi->select(where => $where);

-    # String(with where_param option)

+The above is same as the followin one.

+

     $dbi->select(

-        where => 'title like :title',

-        where_param => {title => '%Perl%'}

+        where => {id1 => 4, id2 => 5},

+        table => 'book'

     );

-=item C<join>

+=item C<param> EXPERIMETNAL

-Join clause used in need. This is array reference.

+    param => {'table2.key3' => 5}

-    $dbi->select(join =>

-        [

-            'left outer join company on book.company_id = company_id',

-            'left outer join location on company.location_id = location.id'

-        ]

-    );

+Parameter shown before where clause.

+    

+For example, if you want to contain tag in join clause, 

+you can pass parameter by C<param> option.

-If column cluase or where clause contain table name like "company.name",

-needed join clause is used automatically.

+    join  => ['inner join (select * from table2 where table2.key3 = :table2.key3)' . 

+              ' as table2 on table1.key1 = table2.key1']

+

+=item C<join>

+

+    join => [

+        'left outer join company on book.company_id = company_id',

+        'left outer join location on company.location_id = location.id'

+    ]

+        

+Join clause. If column cluase or where clause contain table name like "company.name",

+join clausees needed when SQL is created is used automatically.

     $dbi->select(

         table => 'book',

@@ -2510,59 +2485,56 @@ needed join clause is used automatically.

         ]

     );

-In above select, the following SQL is created.

+In above select, column and where clause contain "company" table,

+the following SQL is created

     select company.location_id as company__location_id

     from book

       left outer join company on book.company_id = company.id

     where company.name = Orange

-=item C<param> EXPERIMETNAL

+=item C<primary_key>

-Parameter shown before where clause.

-    

-    $dbi->select(

-        table => 'table1',

-        column => 'table1.key1 as table1_key1, key2, key3',

-        where   => {'table1.key2' => 3},

-        join  => ['inner join (select * from table2 where table2.key3 = :table2.key3)' . 

-                  ' as table2 on table1.key1 = table2.key1'],

-        param => {'table2.key3' => 5}

-    );

+    primary_key => 'id'

+    primary_key => ['id1', 'id2']

-For example, if you want to contain tag in join clause, 

-you can pass parameter by C<param> option.

+Primary key. This is used by C<id> option.

-=item C<append>

+=item C<query>

-Append statement to last of SQL. This is string.

+Same as C<execute> method's C<query> option.

-    $dbi->select(append => 'order by title');

-    

-=item C<id>

+=item C<type>

-Select using primary_key.

+Same as C<execute> method's C<type> option.

-    $dbi->select(

-        primary_key => 'id',

-        id => 4,

-    );

+=item C<table>

-    $dbi->select(

-        primary_key => ['id1', 'id2'],

-        id => [4, 5]

-    );

+    table => 'book'

-The above is same as the followin ones.

+Table name.

-    $dbi->insert(where => {id => 4});

+=item C<type_rule_off> EXPERIMENTAL

-    $dbi->insert(where => {id1 => 4, id2 => 5});

+Same as C<execute> method's C<type_rule_off> option.

-=item C<primary_key>

+=item C<where>

+    

+    # Hash refrence

+    where => {author => 'Ken', 'title' => 'Perl'}

+    

+    # DBIx::Custom::Where object

+    where => $dbi->where(

+        clause => ['and', 'author = :author', 'title like :title'],

+        param  => {author => 'Ken', title => '%Perl%'}

+    );

-See C<id> option.

+    # String(with where_param option)

+    where => 'title like :title',

+    where_param => {title => '%Perl%'}

+Where clause.

+    

 =item C<wrap> EXPERIMENTAL

 Wrap statement. This is array reference.

@@ -2571,139 +2543,79 @@ Wrap statement. This is array reference.

 This option is for Oracle and SQL Server paging process.

-=item C<filter>

-

-Same as C<execute> method's C<filter> option.

-

-=item C<query>

-

-Get L<DBIx::Custom::Query> object instead of executing SQL.

-This is true or false value.

-

-    my $query = $dbi->select(query => 1);

-

-You can check SQL.

-

-    my $sql = $query->sql;

-

-=item C<type>

-

-Same as C<execute> method's C<type> option.

-

-=item C<type_rule_off> EXPERIMENTAL

-

-Same as C<execute> method's C<type_rule_off> option.

-

 =back

 =head2 C<update>

-    $dbi->update(

-        table  => 'book',

-        param  => {title => 'Perl'},

-        where  => {id => 4}

-    );

+    $dbi->update({title => 'Perl'}, table  => 'book', where  => {id => 4});

-Update statement.

+Execute update statement.

-The following opitons are currently available.

+The following opitons are available.

 =over 4

-=item C<param>

-

-Update data. This is hash reference.

-

-    $dbi->update(param => {title => 'Perl'});

+=item C<append>

-If arguments is odd numbers, first argument is received as C<param>.

+Same as C<select> method's C<append> option.

-    $dbi->update(

-        {title => 'Perl'},

-        table => 'book',

-        where => {author => 'Ken'}

-    );

+=item C<filter>

-=item C<table>

+Same as C<execute> method's C<filter> option.

-Table name.

+=item C<id>

-    $dbi->update(table => 'book');

+    id => 4

+    id => [4, 5]

-=item C<where>

+ID corresponding to C<primary_key>.

+You can update rows by C<id> and C<primary_key>.

-Where clause. This is hash reference or L<DBIx::Custom::Where> object

-or array refrence.

-    

-    # Hash reference

-    $dbi->update(where => {author => 'Ken', 'title' => 'Perl'});

-    

-    # DBIx::Custom::Where object

-    my $where = $dbi->where(

-        clause => ['and', 'author = :author', 'title like :title'],

-        param  => {author => 'Ken', title => '%Perl%'}

-    );

-    $dbi->update(where => $where);

-    

-    # String(with where_param option)

     $dbi->update(

-        param => {title => 'Perl'},

-        where => 'id = :id',

-        where_param => {id => 2}

+        {title => 'Perl', author => 'Ken'}

+        parimary_key => ['id1', 'id2'],

+        id => [4, 5],

+        table => 'book'

     );

-    

-=item C<append>

-Append statement to last of SQL. This is string.

+The above is same as the followin one.

-    $dbi->update(append => 'order by title');

-

-=item C<filter>

+    $dbi->update(

+        {title => 'Perl', author => 'Ken'}

+        where => {id1 => 4, id2 => 5},

+        table => 'book'

+    );

-Same as C<execute> method's C<filter> option.

+=item C<param>

-=item C<query>

+    param => {title => 'Perl'}

-Get L<DBIx::Custom::Query> object instead of executing SQL.

-This is true or false value.

+Update data.

-    my $query = $dbi->update(query => 1);

+If C<update> method's arguments is odd numbers, first argument is received as C<param>.

-You can check SQL.

+    $dbi->update({title => 'Perl'}, table => 'book', where => {id => 2});

-    my $sql = $query->sql;

+=item C<primary_key>

-=item C<id>

+    primary_key => 'id'

+    primary_key => ['id1', 'id2']

-update using primary_key.

+Primary key. This is used by C<id> option.

-    $dbi->update(

-        primary_key => 'id',

-        id => 4,

-        param => {title => 'Perl', author => 'Ken'}

-    );

+=item C<query>

-    $dbi->update(

-        primary_key => ['id1', 'id2'],

-        id => [4, 5],

-        param => {title => 'Perl', author => 'Ken'}

-    );

+Same as C<execute> method's C<query> option.

-The above is same as the followin ones.

+=item C<table>

-    $dbi->update(

-        where => {id => 4}

-        param => {title => 'Perl', author => 'Ken'}

-    );

+    table => 'book'

-    $dbi->update(

-        where => {id1 => 4, id2 => 5},

-        param => {title => 'Perl', author => 'Ken'}

-    );

+Table name.

-=item C<primary_key>

+=item C<where>

-See C<id> option.

+Same as C<select> method's C<where> option.

 =item C<type>

@@ -2719,7 +2631,7 @@ Turn type rule off.

     $dbi->update_all(table => 'book', param => {title => 'Perl'});

-Update statement to update all rows.

+Execute update statement for all rows.

 Options is same as C<update()>.

 =head2 C<update_param>