Standardise some module docstring first lines

IPython/core/inputtransformer.py

@@ -1,3 +1,8 b''
+"""Input transformer classes to support IPython special syntax.
+
+This includes the machinery to recognise and transform ``%magic`` commands,
+``!system`` commands, ``help?`` querying, prompt stripping, and so forth.
+"""
 import abc
 import functools
 import re

IPython/core/ultratb.py

@@ -1,6 +1,6 b''
 # -*- coding: utf-8 -*-
 """
-ultratb.py -- Spice up your tracebacks!
+Verbose and colourful traceback formatting.
 
 **ColorTB**
 

IPython/kernel/zmq/datapub.py

@@ -1,4 +1,4 b''
-"""Publishing
+"""Publishing native (typically pickled) objects.
 """
 
 #-----------------------------------------------------------------------------

IPython/kernel/zmq/displayhook.py

@@ -1,3 +1,5 b''
+"""Replacements for sys.displayhook that publish over ZMQ.
+"""
 import sys
 
 from IPython.core.displayhook import DisplayHook

IPython/parallel/util.py

@@ -1,4 +1,4 b''
-"""some generic utilities for dealing with classes, urls, and serialization
+"""Some generic utilities for dealing with classes, urls, and serialization.
 
 Authors:
 

IPython/qt/console/completion_html.py

@@ -1,4 +1,4 b''
-"""a navigable completer for the qtconsole"""
+"""A navigable completer for the qtconsole"""
 # coding : utf-8
 #-----------------------------------------------------------------------------
 # Copyright (c) 2012, IPython Development Team.$

IPython/qt/console/completion_plain.py

@@ -1,4 +1,4 b''
-"""a simple completer for the qtconsole"""
+"""A simple completer for the qtconsole"""
 #-----------------------------------------------------------------------------
 # Copyright (c) 2012, IPython Development Team.$
 #

IPython/qt/console/completion_widget.py

@@ -1,3 +1,4 b''
+"""A dropdown completer widget for the qtconsole."""
 # System library imports
 from IPython.external.qt import QtCore, QtGui
 

IPython/qt/console/ipython_widget.py

@@ -1,5 +1,6 b''
-""" A FrontendWidget that emulates the interface of the console IPython and
-    supports the additional functionality provided by the IPython kernel.
+"""A FrontendWidget that emulates the interface of the console IPython.
+
+This supports the additional functionality provided by the IPython kernel.
 """
 
 #-----------------------------------------------------------------------------

IPython/terminal/console/completer.py

@@ -1,3 +1,5 b''
+"""Adapt readline completer interface to make ZMQ request.
+"""
 # -*- coding: utf-8 -*-
 import readline
 try:

IPython/utils/zmqrelated.py

@@ -1,4 +1,4 b''
-"""utilities for checking zmq versions"""
+"""Utilities for checking zmq versions."""
 #-----------------------------------------------------------------------------
 #  Copyright (C) 2013  The IPython Development Team
 #