[zeromq-dev] Fwd: ZMQ Closure - Change of Beginners Documentation

[Pieter Hintjens]

On Wed, May 25, 2011 at 8:22 AM, Mike Pearce <mike at kaew.be> wrote:

> I can assure everyone that what I wrote is a lot better than the very
> inaccurate section that currently exists and I am a bit sad that my
> submission ended so abruptly.

Well... the section you pointed to is in Ch1 and intended for people
starting to use 0MQ. We don't discuss multithreaded apps anywhere in
that section and it'd be inappropriate to start suddenly talking about
that before people have even understood what 0MQ really is.

There is lots of discussion about multiple threads later, including
quite explicit (in bold) instructions about how to handle ETERM and
how not to share sockets between threads:

http://zguide.zeromq.org/page:all#toc30
http://zguide.zeromq.org/page:all#toc38

I'm happy to add a note earlier on saying, 'warning, if you're doing
multiple threads', it's more complex than this', but for beginners the
advice is exactly as I wrote it. Close your sockets, THEN do zmq_term.
If you don't your app will block.

This is only misleading if you don't read the rest of the text.  But
since good design takes into account how people actually work, not how
we hope they'd work, I'll fix the text.

-Pieter