Bonus: stray #puts for debug.

The bug would leave trailing directories like
'.git'

Discussion at #250
Added white space to the titles and made header title h1
instead of an h2.

Discussion #250
- Use the auto-detected license.
- LocaPod#specification was removed.

* 'master' of github.com:CocoaPods/CocoaPods: (25 commits)
  Updated CHANGELOG.md
  Added acknowledgements_path to TargetDefinition class
  Use String.empty? instead of == ""
  Made Acknowledgements Plist title configurable
  Fixed Acknowledgements file names
  Removed unnecessary () from specs
  Improved Markdown Acknowledgements unit testing
  Improved Plist Acknowledgements unit testing some more
  Improve Acknowledgements unit testing
  Improve Plist Acknowledgements unit testing a little
  Completed basic implementation of Markdown Acknowledgements subclass
  WIP: Added Markdown Acknowledgements subclass
  Added Plist Acknowledgements sub-class
  Changed Local_pod license method to license_text and added fallback to file if no text specified
  Cleaned up BananaLib fixture a little
  Simplify Acknowledgement file saving
  Correct a few typos
  Minor changes to Acknowledgements header and footer text
  Integrate acknowledgements generator into install command
  Speculative fix for possible bug when a pod has no licence
  ...

Acknowledgements plist and markdown generation

If the paths of the pod are resolved when the directory is not
created, FileList will cache no files and not update subsequently.

Closes #269

Closes #254.

Specification refactor

Support for packaging storyboards in pods

- Usually only the header files are commented.
- The header files don't include private categories.
- Performance gains, as doc generation is quite slow.

One of the tests wasn't restoring the changes it made to the config.
As the test was difficult to track down and the problem would have
become only worse in the future, the issues was solved starting with
a new config before each run.

The performance impact seems negligible and the testing environment is
more predictable.