cosmetic changes, added documentation for core modifications