clean up examples, build, and documentation for yarp bindings

[paulfitz]

• @apaikan suggests moving examples out of bindings directory (see adding Yarp Octave binding #316 (comment)), also giving better examples that show language specific syntax.
• @drdanz suggests turning off old method of building bindings separately (see adding Yarp Octave binding #316 (comment)).
• @arocchi proposes a set of cleanups for matlab bindings, see Simplify Matlab bindings compilation and installation #314.
• I've always wanted to run the equivalent of javadoc on each set of bindings and publish that output so that it is clear what the API is for each language.

[traversaro]

I guess this swig branch: swig/swig#170 is related to the last point.

[paulfitz]

Oh beautiful! Thanks @traversaro.

[traversaro]

cc @francesco-romano

[traversaro]

Note that apparently building bindings externally using a binary release of YARP is still a thing on Windows: #698 .

[francesco-romano]

@drdanz and me discussed about this.
I don't remember if we kept this "feature" or if we deprecated it, but for sure it should be still included in the bindings refactoring

[traversaro]

Related project: https://github.com/m7thon/doxy2swig .

[traversaro]

Related to

I've always wanted to run the equivalent of javadoc on each set of bindings and publish that output so that it is clear what the API is for each language.

The doxygen branch was merged in SWIG ( swig/swig#170 (comment) ), so that feature should be part of the next release.

[traversaro]

Related to

I've always wanted to run the equivalent of javadoc on each set of bindings and publish that output so that it is clear what the API is for each language.

The doxygen branch was merged in SWIG ( swig/swig#170 (comment) ), so that feature should be part of the next release.

SWIG 4 has been released, with the javadoc/pydoc feature available: https://sourceforge.net/p/swig/news/2019/04/swig-400-released/ .

[randaz81]

closed because too old. This issue might be not present anymore in newer versions of yarp/swig