Socket.server.connect command changes about de-re-basic

[mrleavitt]

Before I make any changes, could I query whether the parameter is better expressed as a logical or numeric expression? Whenever I see something that evaluates to either 0 or non-zero I think that maybe it's better thought of as a logical expression. If you agree, I'd add words something like this (yours, but with a few changes):

---

Socket.server.connect {< wait_lexp >}

The optional "wait" parameter determines if the command waits until a connection is made with a client. If the parameter is true (non-zero or missing), the command waits for the connection. If the parameter is false (0), the command completes immediately. Use socket.server.status to determine when the connection is made.

In general, it is better (safer, more robust) to set the parameter to false and explicitly monitor the connection's status, since it can avoid a problem if the program exits with no connection made.

---

Also, with regard to your last commend, I think I'd try to put the comment with the command (as above), as (it seems to me) that that's when someone is more likely to be thinking about it. If we put it in the introductory material, it might be forgotten by the time the coding starts.

What do you think?

[jMarcS]

You're right, the parameter really is a logical expression. Somehow I missed that we're using lexp in descriptions of parameters. That's much better.

To me, "true (non-zero or missing)" implies "missing" means "true" for logical expressions in general. I think more often "missing" means "false", just not for this command. Can you live with, "If the parameter is absent or true (non-zero)", or something similar?

Putting the advice about using the parameter where you have it works well. With yesterday's code change, there's an even more compelling reason to connect without the wait.

[mrleavitt]

Done.