Add @todo api and describe ol.geom.Geometry funcs

[pagameba]

The clone(), getSimplifiedGeometry() and getType() methods are all
base class methods documented in subclasses. They should appear in
ol.geom.Geometry in the API docs as well.

[elemoine]

I'd like that @tschaub and @ahocevar review this. Things I'm wondering:

• with this can we remove the @todo api annotations in ol.geometry.SimpleGeometry and ol.geometry.GeometryCollection?
• and will the exports work correctly?

[pagameba]

Agreed. I think there may be some other problems too. For instance, applyTransform is defined in ol.geom.Geometry with @todo api and is inherited in ol.geom.SimpleGeometry with @inheritDoc but the documentation in ol.geom.SimpleGeometry does not show the method as inherited.

[pagameba]

Actually now I see that inherited methods that are implemented in subclasses never get annotated as inherited, even though they inherit documentation.

[tschaub]

@pagameba - can you update this to use @api (instead of @todo api)?

[pagameba]

rebased and updated.

[pagameba]

Any objections to getting this in?

[tschaub]

Looks good to me to merge. We may need to address Eric's comments separately (making @inheritDoc copy parent doclet properties).

[osechet]

Hi,
sorry, I know this is an old issue but I would like to understand why the modifications made with this PR have been "cancelled" with commit 6134a8b. The methods are still defined in ol.geom.Geometry but they don't appear in the documentation.

[ahocevar]

@osechet #clone() does show up in the docs for all geometry subclasses, and so does #getType(). #getSimplifiedGeometry() is now #simplify().

[osechet]

@ahocevar Yes they appear in the subclasses but not in the ol.geom.Geometry class. This PR is about adding them in the doc of ol.geom.Geometry. It has been done than "cancelled" few months later. I'm sure there is a good reason. I just would like to know what is that reason.