documentation and script polishing for ipython