Merge pull request #242 from havvg/feature/introspections

fix several phpDoc and type hints
Fix issue #254
Merge pull request #262 from cristianoc72/master

Fix issue #254
Fixed typos
Merge pull request #263 from pborreli/master

Fixed typos
Fix some skipped tests
Issue 244
Merge pull request #265 from cristianoc72/issue-244

Issue #244
Merge pull request #264 from cristianoc72/fix-tests

Fix some skipped tests
Fix additional newlines in generated AR code
Merge pull request #268 from fzaninotto/fix_whitespace

Fix additional newlines in generated AR code
Remove ability to iterate over a Criteria object

This was no longer used and conflicts with other potential features
ModelCriteria implements IteratorAggregate

Now the query can be iterated on, and this executes a find() in the background:

```
$books = BookQuery::create()
  ->filterByTitle('War%'); // see Ma, no find()!
foreach ($books as $book) {
  echo $book->getTitle();
}
```

In addition to saving one line of code, this delays the actual query execution to the moment
it's iterated on. Using MVC frameworks, this typically happens in the view rather than in
the controller, and therefore it can be seen as a way to hit the database more lazily.
Fix On Demand iterator not properly reenabling instance pooling.

The previous commit revealed a hidden bug. Don't forget to close the cursor on an OnDemandIterator
if you don't iterate on it, or instance pooling will be definitely disabled.
Move Criteria::CUSTOM logic to a specialized Criterion class

Refs #41.
Move Criteria::IN and Criteria::NOT_IN logic to a specialized Criterion class

Refs #41.
Move Criterion subclasses to a subnamespace.

Because the boss said so.

Refs #41.
Move Criteria::RAW logic to a specialized Criterion class

Refs #41.
Move Criteria::LIKE and Criteria::NOT_LIKE logic to a specialized Criterion class

Refs #41.
Move logic for Criteria::EQUAL and the likes to a specialized Criterion class

Refs #41.