Added docs to package fix issue #64

[christofdamian]

I were not able to fix #64 without moving everything around. So here is an pull request doing just that.
I quite understand if you don't like to do it.

[mlively]

This will definitely work for pear and composer, unfortunately it would break anybody that was using the older symfony2 vendor model since the src directory is changing. I am going to play around with this and see if I can figure out a way to get the best of both worlds.

[mlively]

Does the fedora rpm stuff utilize pear?

[christofdamian]

Yes, usually PHP packages are repacked from the PEAR packages where available.
When the tests are included they will be run when the package is build for addition safety. A lot of packages don't have any tests though.

[bfeaver]

I'm closing this pull request and the accompanying issue #64. With composer coming into existence and us not really maintaining the PEAR package, there doesn't seem much issue just letting this lie around.

I'll leave it up to @mlively if he wants to reopen.

[christofdamian]

Obviously I think this is a mistake.
PEAR is not only a useful distribution channel, that is used by many people including Linux distributions packagers.
It is also a way of improving the quality of software packages by not only targeting composer.

I'll will have to see how and if I manage for Fedora, as I personally don't use Phake any more at work.

[mlively]

I still think I can manage this when time permits. At least until there is as clear a path from composer to package distributions as there is for pear. At some point I will have to check and figure out why the pull request breaks. Seeings as I can't use this pull request I'll keep the request closed but I'll reopen the underlying issue.