Doxyzenize the file-level documentation of transports.c.
transports.c
has a big documentation blob documenting how the transports subsystem works.
Unfortunately, this is not currently visible by doxygen.
We should put it in the file-level Doxygen header so that it shows nicely in Doxygen documentation.