Comments (5)
What is needed for this issue to be resolved?
from haxemanual.
What is needed for this issue to be resolved?
from haxemanual.
Well, documentation of the haxe.io package and how to use it. Output, Input, FileInput, StringInput, BytesInput... that kind of stuff.
from haxemanual.
Bytes is important seems that name is not familiar with people mastering POSIX/C terminology and there is considerable implementation there and no description. Also *Data types that seems to represent native objects - and for those the API should be very explicit even listing which native type is used on each platform since users micro optimizing at some point will have to cast them
Use a language in terms of POSIX or C since that is the common language on most platforms.
haxe.io types are poorly documented. None of them has a description and only few members are documented. This is huge blocker for new people since:
- Some types, like Bytes* have names that are unknown in POSIX and in general developers form other platforms are lost
- IO types needs to be clearly understood in order to optimally implement IO which is critical
- the only workaround is to read the haxe.io package source code it self in order to figure out, more or less, what these types do or optimal performance implementations when
I strongly recommend to mention posix names if there is a straight forward relation ship and other language types and not just mention "words like " native" or "array" or "int", for example, "BytesData
represents a native array of bytes which in general are stored as 8 bit unsigned integers, (integers in 0-255). Each target uses the optimal and minimal implementation, and if supported an ArrayBuffer view to avoid referencing the whole array. for example in C++ an unsigned short[] , in JavaScript an ArrayBuffer in python python.ArrayBuffer, "
Although this might seems exposing private code, users need to clearly understand exactly what the type represents, at least in terms of POSIX or C in order to implement optimal solutions need
My point, don't be high level here. (this is a feedback for the API not for the manual which it should by more high level, but since it seems the initiative is happening here...) thanks
from haxemanual.
Well, documentation of the haxe.io package and how to use it. Output, Input, FileInput, StringInput, BytesInput... that kind of stuff.
This section also includes the sys.io
functions right? I can write some sections about command line input/process spawn etc
from haxemanual.
Related Issues (20)
- JDK seems necessary for java target, but manual only says JRE HOT 1
- Semantics of different abstract implict cast kinds are not the same
- Style Guidelines discussion HOT 3
- [Moved] Documentation for UnsafeStringMap HOT 2
- Document differences between Java and JVM targets. HOT 5
- Repeat target specific information in "target details". HOT 2
- terminology: instance vs member vs non-static HOT 2
- hxml comment character - doesn't do what it says HOT 2
- Document the "is" keyword/operator. HOT 2
- Lua docs
- add notes about gzip encoded content to haxe.http.HttpBase
- haxe.Template sample fails with DCE HOT 2
- There is no entry explaining `comments` in Haxe Manual HOT 2
- Provide documentation for abstract classes.
- Field completion with pipe not working HOT 2
- Assignment operator missing (?)
- More specific Haxe/C++ requirements for MSVC
- Haxe 4.3 documentation TODO HOT 5
- [Question] Bypassing setter on initialization
- Conditional compilation version() function
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from haxemanual.