Document argument mapping

[LordYuuma]

The examples and the documentation of functions and methods don't line up due to our renaming and in case of the self argument automatic name generation. Just like plain old GTKDoc, we should create a table per function, in which the arguments and their meaning are listed – especially the relation to C arguments.

[spk121]

Is this patchset still something that should be incorporated?

[LordYuuma]

I don't think ArgMap has changed since I've implemented this, so I'd say "yes" in the sense that it should still be working. As far as utility is concerned, I think something like this is necessary if we want to rely on generated documentation at all, as we don't perform any transformation on the docstrings. Without it, the Scheme arguments are given as some-parameter whereas the documentation refers to some_parameter with potentially n_some_parameter as a count that we don't expose to the Scheme side. Having the documentation of the individual arguments, which sometimes exists, in there is also a nice bonus.