From: Richard W.M. Jones <rjones@redhat.com>
Date: Sat, 6 Aug 2011 14:49:55 +0000 (+0100)
Subject: docs: Clarify error handler example.
X-Git-Tag: 1.13.3~8
X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=commitdiff_plain;h=1bf3941b9ccabef122cc6479004d18ddcb935eef;hp=4bd1a5060bc95d8d933efa52f8d4aa26ecc118f5

docs: Clarify error handler example.
---

diff --git a/src/guestfs.pod b/src/guestfs.pod
index 76570a7..a1831c0 100644
--- a/src/guestfs.pod
+++ b/src/guestfs.pod
@@ -1344,8 +1344,6 @@ been printed to C<stderr> before the program exits.
 For other programs the caller will almost certainly want to install an
 alternate error handler or do error handling in-line like this:
 
- g = guestfs_create ();
- 
  /* This disables the default behaviour of printing errors
     on stderr. */
  guestfs_set_error_handler (g, NULL, NULL);
@@ -1354,9 +1352,12 @@ alternate error handler or do error handling in-line like this:
    /* Examine the error message and print it etc. */
    char *msg = guestfs_last_error (g);
    int errnum = guestfs_last_errno (g);
-   fprintf (stderr, "%s\n", msg);
+   fprintf (stderr, "%s", msg);
+   if (errnum != 0)
+     fprintf (stderr, ": %s", strerror (errnum));
+   fprintf (stderr, "\n");
    /* ... */
-  }
+ }
 
 Out of memory errors are handled differently.  The default action is
 to call L<abort(3)>.  If this is undesirable, then you can set a