Add class / API documentation

[timosachsenberg]

To move forward with the automatic API/class documentation, we need to support multi-line comments for methods. Instead of having only a single line doc string like:

  void myfunction(int s) # wrap-doc:This is a doc string

we need support for:

  void myfunction(int s)
  # wrap-doc:
                #   blabla
                #   -----
                #   blablaba
                #   -----
                #   :param s: bla

I think this already works for classes but not for methods.

[timosachsenberg]

How this could be done:

• needs to be added to PXDParser in autowrap https://github.com/uweschmitt/autowrap/blob/a33432e9424fbb156b721168cd3f2fcdaf67b682/autowrap/PXDParser.py
• use https://github.com/uweschmitt/autowrap/blob/master/tests/test_pxd_parser.py to test the functionality

[jpfeuffer]

An important thing to consider is that there might be multiline functions:

void myfunction(int s,
            bool b)

This might even be exploited for comments right now ;) Like this:

void myfunction(int s,  # this is a
            bool b)               # multiline comments

[tapaswenipathak]

Should @greengypsy or I takeover?

[jpfeuffer]

This should be done. See autowrap repository for the Multiline method doc fix. And see my recent commits here for the apidoc. We reopen if something does not work.