lots more comments and docstring improvements in ircop.py

Also fixed one embarrasing code wart that didn't affect functionality