New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add @api to ol.Sphere #2641
Add @api to ol.Sphere #2641
Conversation
this doesn't really close #2359, as there's still no docs on how to use Sphere, which was what that issue was mainly about. A simple workaround would be to add some docs with an example on how to use ol.sphere.WGS84 to ol.Sphere. |
You're right. Removing the "closes" annotation. |
@ahocevar do you agree with merging this? |
I do, but at least 1-2 sentences of documentation would be nice. |
Good call. I made other changes. The tissot example now uses the documented |
Looks great to me, but it seems Travis does not agree. |
Yep, I think it's now fixed. |
Closes #2359. |
* Class to create objects that can be used with {@link | ||
* ol.geom.Polygon.circular}. | ||
* | ||
* For example to create a sphere whose radius equal to the semi-major |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
whose radius is equal to
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Fixed. Thanks.
I agree that this resolves #2359 |
Adding
@api
tool.Sphere
makes it appear in the API docs, and provides a link fromol.geom.Polygon#circular
. As commented in #2359 this does not help withol.Sphere.WGS84
, but that problem can be handled separately.Adding
@api
tool.Sphere
also fixes a problem in the externs file generated by thegenerate-externs.js
task. Without the@api
annotation the externs file includes references to theol.Sphere
, which is unknown.Please review.