dox icon indicating copy to clipboard operation
dox copied to clipboard

@:forward() for abstracts

Open RealyUniqueName opened this issue 10 years ago • 7 comments

Looks like @:forward() meta for abstract types is currently not supported. http://haxe.org/manual/types-abstract-forward.html

RealyUniqueName avatar Sep 24 '14 21:09 RealyUniqueName

I don't think we output any metadata at the moment, do we?

Simn avatar Oct 13 '14 09:10 Simn

Nope... I guess in this case you'd want to forward the documentation from the forwarded method.

dpeek avatar Oct 13 '14 09:10 dpeek

Ah, that didn't occur to me. I'm not sure that's a good idea though because the forwarded documentation might talk about this String and reference methods on the underlying type which are not forwarded to the abstract.

We should treat this just like normal class inheritance I think.

Simn avatar Oct 13 '14 09:10 Simn

I ran into this today and would like a fix. Are there any updates on this issue (from three years ago)? This is really a problem because, in my case (sample gist here) I can't simply write docs on non-existent methods in the non-abstract type.

nightblade9 avatar Oct 27 '17 18:10 nightblade9

We're having the same issue.

We use abstracts to support OpenGL ES 3.0, OpenGL ES 2.0, WebGL 2 and WebGL contexts. The abstracts use @:forward() to limit the properties and methods that are available (without having to retype them all, there are a lot!)

This page (especially) is disappointing:

http://api.lime.software/lime/graphics/OpenGLES2RenderContext.html

Supporting "Inherited Variables" and "Inherited Methods" would be a reasonable way to handle this probably

jgranick avatar Jul 13 '18 01:07 jgranick

@Simn @Gama11 is this a Haxe or a dox issue?

markknol avatar Jul 13 '18 09:07 markknol

Dox

Simn avatar Jul 13 '18 09:07 Simn

@Simn I think you can close this issue now.

sebthom avatar Feb 27 '23 21:02 sebthom