HaxeManual icon indicating copy to clipboard operation
HaxeManual copied to clipboard

terminology: instance vs member vs non-static

Open uvtc opened this issue 4 years ago • 2 comments

For consistency in the manual, which is the official term to use throughout: member method or instance method? (Or, is "method" shorthand for "member method"?)

Also, the manual says "non-static" in some places. Which is preferred, instance or non-static?

uvtc avatar May 25 '20 23:05 uvtc

What we have at the moment:

  • instance vs. static
  • variable vs. function
  • method = instance function
  • field = variable + function

An exception are constructors which are somewhere between instance and static.

Another problem is that we have final now which can't really be a variable... I think it would be common to use "field" for variable + final, but we already use it differently, so I'm not sure.

Simn avatar May 26 '20 05:05 Simn

Should the manual consistently call them

  • "instance fields, which are instance variables and methods", or
  • "member fields, which are member variables and methods"?

And then, it sounds like occurrences of the term "non-static" in the text should probably be changed to either "instance" or "member", correct?

Also, and aside, I understand that Haxe has both:

  • methods (either instance or static) as well as
  • functions (local, and now/soon (as of 4.2) module-level).

uvtc avatar Jun 11 '20 07:06 uvtc