generate typedefs from python

Put the typedefs close to the list of types, where they belong. Also add
some more commentary to generate-future-functions.py.