I think this raises a possibly wider issue: the common c++ library has many classes which look very interesting, however it is not very easy to know how to use them with just the documentation provided by kdoc.
I guess it would be valuable to provide some examples on how to uses the various classes provided. Even a small program of a few lines would be usefull to understand how the various methods of a class are supposed to work together.
I think this could even be integrated with kdoc, by using the @see tag to refer to an example related to a specific class / method.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
It would really help to have some examples using cc++ ...
I propose somthing like this for starters.
http://sourceforge.net/snippet/detail.php?type=snippet&id=100284
I will add this example to the distro.
I think this raises a possibly wider issue: the common c++ library has many classes which look very interesting, however it is not very easy to know how to use them with just the documentation provided by kdoc.
I guess it would be valuable to provide some examples on how to uses the various classes provided. Even a small program of a few lines would be usefull to understand how the various methods of a class are supposed to work together.
I think this could even be integrated with kdoc, by using the @see tag to refer to an example related to a specific class / method.