[EMAIL PROTECTED] wrote:

> I'd like to get comments on my new Networking document:
>
> http://www.rebol.com/docs/network.html
>
> See what you think.

pressed for time, so just few comments, sometimes maybe a little bit
off-topic, but still related ...

1) List of "chapters" - couldn't it be provided as a links? I like the
style of http://www.rebol.com/view/docs/view-users.html for e.g.
2) probe first next objname ... suggested already in the past, but it
requires reader already know how objects are stored. What about
mezzanines words-of, values-of, as proposed in the past?
3) "If you want to disable the proxy settings for a particular scheme,
you can set the proxy fields for false." - maybe it could be mentioned
it is NOT enough to let it be 'none - there's a difference in behavior.
Only 'false disables it ...
4) when setting proxy-type in user.r for e.g., "generic"  will NOT work,
while 'generic will ...
5) emails are explained nicely, while tcp communication (e.g. getting
page thru tcp://) is not ...
6) what does it mean 'copy allocates additional memory? ;-) weren't
write-io and read-io supposed to be just temporarily available in rebol?

7) maybe 'open could be explained in a special category. There's too
much refinements there and it needs some concept in description - e.g.
which port types are buffered, which aren't, when connections are
closed, in what cases port waits for closing port, 'update, querying of
port is not described in overall ... well, found something at the end of
docs, have no time to read thru carefully, so I will not delete 7) item
for the case something is ommited ...
8) as for cgi - another option could be added - when not creating object
out of query-string, we need to 'reduce block to get its words loaded.
My friend struggled with that one, as molded value of block seemed to
him everything is ready :-)

Later,
-pekr-

>
>
> -Carl

Reply via email to