Docstring standards in Slycot #100

We have a bunch of different docstring styles used in the various definitions.

Some directly come from the __doc__ property of the wrapper functions generated by f2py, recognizable by the bounds qualifier.

Other functions use shape()

Sometimes we have blank space between the parameter definitions. Sometimes not.

What's your opinion on unifying this? Adhere to numpydoc and get closer to the documentation in numpy and scipy? Decide on a proper way to specify the shape?

The array('d') is also not consistent with numpydoc, I guess.

Would also affect the math formulas.