From 1aee86408d575d6572b071d7564da7f006d1757e Mon Sep 17 00:00:00 2001 From: Martin Lucina Date: Tue, 9 Mar 2010 18:47:31 +0100 Subject: Documentation rewrite --- doc/zmq_strerror.txt | 25 +++++++++++++++---------- 1 file changed, 15 insertions(+), 10 deletions(-) (limited to 'doc/zmq_strerror.txt') diff --git a/doc/zmq_strerror.txt b/doc/zmq_strerror.txt index 2bdf762..61f30e3 100644 --- a/doc/zmq_strerror.txt +++ b/doc/zmq_strerror.txt @@ -4,24 +4,27 @@ zmq_strerror(3) NAME ---- -zmq_strerror - returns string describing the error number +zmq_strerror - get 0MQ error message string SYNOPSIS -------- -'const char *zmq_strerror (int errnum);' +*const char *zmq_strerror (int 'errnum');* DESCRIPTION ----------- -As 0MQ defines few additional (non-POSIX) error codes, standard -'strerror' isn't capable of translating those errors into human readable -strings. Instead, 'zmq_strerror' should be used. +The _zmq_strerror()_ function shall return a pointer to an error message string +corresponding to the error number specified by the 'errnum' argument. As 0MQ +defines additional error numbers over and above those defined by the operating +system, applications should use _zmq_strerror()_ in preference to the standard +_strerror()_ function. RETURN VALUE ------------ -Returns string describing the error number. +The _zmq_strerror()_ function shall return a pointer to an error message +string. ERRORS @@ -31,10 +34,11 @@ No errors are defined. EXAMPLE ------- +.Displaying an error message when a 0MQ context cannot be initialised ---- void *ctx = zmq_init (1, 1, 0); if (!ctx) { - printf ("error occured during zmq_init: %s\\n", zmq_strerror (errno)); + printf ("Error occurred during zmq_init(): %s\n", zmq_strerror (errno)); abort (); } ---- @@ -45,6 +49,7 @@ SEE ALSO linkzmq:zmq[7] -AUTHOR ------- -Martin Sustrik +AUTHORS +------- +The 0MQ documentation was written by Martin Sustrik and +Martin Lucina . -- cgit v1.2.3