Implement --with-debugging-symbols switch in setup.py
- [x] closes N/A
- [x] tests added / passed
- [x] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
- [ ] whatsnew entry

This implements a switch that enables building Pandas with debugging symbols - useful for debugging or profiling native parts of the code.