[Podfile::DSL] Minor fix to comments
[Podfile::DSL] Improve path handling in #podspec

Ported from https://github.com/CocoaPods/CocoaPods/commit/da643ea1cfaaebdf97c930d6aee8d9542bb6a62c.