Hello Mark,
Thanks that is looking helpful. The section on fnGetTCP_Socket is good.
Observations:
- it would be better if it didn't use browser Frames because it makes it difficult to link to a page within the docs.
- seems odd to categorise it by the implementation file - as an API I wouldn't expect to have to know which source file to use
Only a nit.
- a search or index function to look up functions by name is useful.
An observation on the API: the function naming seems a bit inconsistent. For example some TCP functions
fnHandleTCP
fnTCP_Listen
fnGetTCP_state
sometimes the TCP is at the start with an underscore after, sometimes in the middle, sometimes at the end. Sometimes the part after the underscore is capitalised (_Listen) , sometimes not (_state).
This is only minor but makes the API a little bit harder to use because the names of the functions are harder to remember and/or determine.