lua: Various fixes to the bindings (thanks Jerome Vuarand).

See http://article.gmane.org/gmane.comp.lang.lua.general/95065

Note that this is incompatible with existing code.  You
have to do:

  local G = require "guestfs"
  local g = G.create ()

ie. give the module your own name ("G" in that example).

3 files changed, 21 insertions, 11 deletions

diff --git a/lua/examples/create_disk.lua b/lua/examples/create_disk.lua
index 2dfc1fc2..c662a2c5 100644
--- a/lua/examples/create_disk.lua
+++ b/lua/examples/create_disk.lua
@@ -1,10 +1,10 @@
 -- Example showing how to create a disk image.
 
-require "guestfs"
+local G = require "guestfs"
 
-output = "disk.img"
+local output = "disk.img"
 
-g = Guestfs.create ()
+local g = G.create ()
 
 -- Create a raw-format sparse disk image, 512 MB in size.
 file = io.open (output, "w")
diff --git a/lua/examples/guestfs-lua.pod b/lua/examples/guestfs-lua.pod
index 18d427b5..193a9a97 100644
--- a/lua/examples/guestfs-lua.pod
+++ b/lua/examples/guestfs-lua.pod
@@ -6,8 +6,8 @@ guestfs-lua - How to use libguestfs from Lua
 
 =head1 SYNOPSIS
 
- require "guestfs"
- g = Guestfs.create ()
+ local G = require "guestfs"
+ g = G.create ()
  g:add_drive ("test.img", { format = "raw", readonly = true })
  g:launch ()
  devices = g:list_devices ()
@@ -20,15 +20,25 @@ programming language.  This page just documents the differences from
 the C API and gives some examples.  If you are not familiar with using
 libguestfs, you also need to read L<guestfs(3)>.
 
+=head2 REQUIRING THE MODULE
+
+C<require "guestfs"> returns the module, so you have to assign it
+to a local variable.  Typical usage is:
+
+ local G = require "guestfs"
+
+(you can use any name you want instead of C<G>, but in the examples
+in this man page we always use C<G>).
+
 =head2 OPENING AND CLOSING THE HANDLE
 
 To create a new handle, call:
 
- g = Guestfs.create ()
+ g = G.create ()
 
 You can also use the optional arguments:
 
- g = Guestfs.create { environment = 0, close_on_exit = 0 }
+ g = G.create { environment = 0, close_on_exit = 0 }
 
 to set the flags C<GUESTFS_CREATE_NO_ENVIRONMENT>
 and/or C<GUESTFS_CREATE_NO_CLOSE_ON_EXIT>.
@@ -95,7 +105,7 @@ second argument a list:
  eh = g:set_event_callback (cb, { "appliance", "library", "trace" })
 
 A list of all valid event types (strings) is in the global variable
-C<Guestfs.event_all>.
+C<G.event_all>.
 
 The callback (C<cb>) is called with the following parameters:
 
diff --git a/lua/examples/inspect_vm.lua b/lua/examples/inspect_vm.lua
index 1bee10b3..e35b4631 100644
--- a/lua/examples/inspect_vm.lua
+++ b/lua/examples/inspect_vm.lua
@@ -1,6 +1,6 @@
 -- Example showing how to inspect a virtual machine disk.
 
-require "guestfs"
+local G = require "guestfs"
 
 if table.getn (arg) == 1 then
    disk = arg[1]
@@ -8,7 +8,7 @@ else
    error ("usage: inspect_vm disk.img")
 end
 
-g = Guestfs.create ()
+local g = G.create ()
 
 -- Attach the disk image read-only to libguestfs.
 g:add_drive (disk, { -- format:"raw"
@@ -18,7 +18,7 @@ g:add_drive (disk, { -- format:"raw"
 g:launch ()
 
 -- Ask libguestfs to inspect for operating systems.
-roots = g:inspect_os ()
+local roots = g:inspect_os ()
 if table.getn (roots) == 0 then
    error ("inspect_vm: no operating systems found")
 end