datapaths: Make packet_buffer private

Also cleans up some no-longer-accurate docstrings.
datapaths: Refactor

This makes a SoftwareSwitchBase class which doesn't have an
event to send data on the datapath.  The SoftwareSwitch
subclass retains the old behavior.