libguestfs.git/python, branch 1.18.7

podwrapper: Add --license parameter, which is required.

2012-08-30T21:04:55+00:00

This adds standard LICENSE and BUGS sections to all of the man pages
that are processed by podwrapper.

Modify all the calls to $(PODWRAPPER) to add the right --license
parameter according to the content.  Note that this relaxes the
license on some code example pages, making them effectively BSD-style
licensed.

(cherry picked from commit 2f97bf873b64384835f257f8916bf1ebb2af62b4)

man pages: Ensure consistent copyright/author sections, remove license

2012-08-30T21:04:55+00:00

section.

Ensure each man page contains consistent COPYRIGHT and AUTHOR
sections.

Remove the LICENSE section.  We will add that back in podwrapper in a
later commit.

(cherry picked from commit f1d98bbc79496947210ee0305f80440ed8557ec1)

python: Fix comment referring to Perl(!)

2012-08-30T20:26:32+00:00

(cherry picked from commit 7dd2389359d190e81696f1b2e91e719bdc1822f2)

build: Change calls to podwrapper.sh to use $(PODWRAPPER).

2012-08-05T20:12:22+00:00

This will allow us to easily change the location of this
script in future.
(cherry picked from commit f2ea617e224cd82496e56a41b5878063d6f02e3d)

New API: guestfs_shutdown: Cleanly shutdown the backend.

2012-07-06T16:36:30+00:00

The new API splits orderly close into a two-step process:

  if (guestfs_shutdown (g) == -1) {
    /* handle the error, eg. qemu error */
  }
  guestfs_close (g);

Note that the explicit shutdown step is only necessary in the case
where you have made changes to the disk image and want to handle write
errors.  Read the documentation for further information.

This change also:

 - deprecates guestfs_kill_subprocess

 - turns guestfs_kill_subprocess into the same as guestfs_shutdown

 - changes guestfish and other tools to call shutdown + close
   where necessary (not for read-only tools)

 - updates documentation

 - updates examples

(cherry picked from commit ffbf1475f7ae7c462db289ad4834391469e72edd)

perl, python, ruby: Fix comments on call to close method.

2012-07-06T16:36:30+00:00

Make the comments consistent.

Also make the Perl example call $g->close explicitly so it is
consistent with the other examples.
(cherry picked from commit 27ebf517fae972eee49ae5911a03fabe5f4b6e54)

examples: In create_disk example, don't call set_autosync.

2012-07-06T16:36:30+00:00

This is now set by default in all supported versions of libguestfs.
It's just confusing if the examples refer to it.
(cherry picked from commit 917550a117904ec1a06b77a7870a147014d71adb)

tests: Fix a few tests where /dev/null was being used with format=qcow2.

2012-06-28T08:13:41+00:00

This was always incorrect behaviour, but qemu appears to tolerate it.

This cherry picks just the test fixes from
commit 729bb9c6b5ae0c0e7c68dc802b1617936062f966.

build: Define builddir and abs_srcdir when they are missing.

2012-06-21T11:51:45+00:00

RHEL 5-era autoconf did not define these, so define them manually
when they are missing.

Define builddir as '.'  The scripts require this.  It won't work
in the srcdir != builddir case, but we don't care about that for
RHEL 5.

This commit also moves the builddir / abs_srcdir variable setting
above the include of subdir-rules.mk, in case that include uses
these variables.

Useful script:

  for f in $(find -name Makefile.am | xargs fgrep '$(abs_srcdir)' -l) ; do
    if ! grep -q '^abs_srcdir' $f; then
      echo missing in $f
    fi
  done
(cherry picked from commit 50aa9533e4a505e1c64dbedddb30491bfbb755d6)

python: Remove 'del g' from the docs, replace with 'g.close ()'.

2012-04-17T16:41:43+00:00

'del g' is a trap for the unwary.  If the handle has any other
references, it does nothing (in fact, it can be actively dangerous if
the user was expecting the appliance to go away).  In non-CPython it
can be delayed arbitrarily long.

Using 'g.close()' on the other hand is always safe.