Finalize release notes for 1.12 release.
[libguestfs.git] / RELEASE-NOTES
index 2c27642..cba6c9b 100644 (file)
@@ -1,74 +1,90 @@
 Release notes for libguestfs 1.12.0
 -----------------------------------
 
-LAST UPDATED TO COMMIT 1e9e351f178dcb425c4796c90fe7c8c5c250d100
-
 These release notes only cover the differences from the previous
 stable/dev branch split (1.10.0).  For detailed changelogs, please see
 the git repository, or the ChangeLog file distributed in the tarball.
 
 New features
 
- - virt-ls -lR option allows complex file iteration and guest analysis.
+  guestfish:
+
+   - guestfish strings can use escapes,
+     eg. ><fs> write /foo "line 1\nline 2\n"
+
+   - guestfish write-append command can be used to append to files.
+
+   - Long-running file uploads and downloads can be cancelled through the
+     API or by hitting ^C in guestfish.
+
+   - New guestfish "display" command for displaying graphical files
+     inside guests.
+
+   - In guestfish, tab completion now works on /dev/mapper devices.
 
- - virt-win-reg supports HKEY_USERS\<SID> and HKEY_USERS\<username>.
+  virt-inspector:
 
- - virt-win-reg new option --unsafe-printable-strings allows printable
-   strings to be displayed in the output (unsafely: read the documentation
-   before using).
+   - Inspection API can get an icon or logo for certain guests.
 
- Inspection API can get an icon or logo for certain guests.
  - virt-inspector includes the logo and hostname for certain guests.
 
- - virt-inspector includes the logo and hostname for certain guests.
+   - virt-inspector can now get the version and release numbers for RPM
+     packages.
 
- - virt-inspector can now get the version and release numbers for RPM
-   packages.
+   - CentOS and Scientific Linux are now treated as separate distros by
+     the inspection API.
 
- - virt-edit has been rewritten in C.
+  virt-resize:
 
- - guestfish, guestmount, virt-cat, virt-df, virt-edit, virt-filesystems,
-   virt-inspector, virt-ls and virt-rescue now allow you to use
-   "-d UUID" option to specify a guest by UUID.  This makes them more
-   robust to use from other programs.
+   - virt-resize can now handle btrfs.
 
- - virt-resize can now handle btrfs.
+   - New virt-resize --ntfsresize-force option allows Windows VMs to be
+     resized multiple times.
 
- - guestfish strings can use escapes, eg. ><fs> write /foo "line 1\nline 2\n"
+  other virt tools:
 
- - guestfish write-append command can be used to append to files.
+   - guestfish, guestmount, virt-cat, virt-df, virt-edit, virt-filesystems,
+     virt-inspector, virt-ls and virt-rescue now allow you to use
+     "-d UUID" option to specify a guest by UUID.  This makes them more
+     robust to use from other programs.
 
- guestfs_close now appears in trace messages.
  - virt-ls -lR option allows complex file iteration and guest analysis.
 
- - Long-running file uploads and downloads can be cancelled through the
-   API or by hitting ^C in guestfish.
+   - virt-win-reg supports HKEY_USERS\<SID> and HKEY_USERS\<username>.
 
- - Python binding adds explicit g.close() method.
+   - virt-win-reg new option --unsafe-printable-strings allows printable
+     strings to be displayed in the output (unsafely: read the documentation
+     before using).
 
- Python programs can now use the new event API.
  - virt-edit has been rewritten in C.
 
- - Python GIL is released during libguestfs calls, allowing multithreaded
-   Python programs to work properly.
+  API and language bindings:
 
- - New guestfish "display" command for displaying graphical files
-   inside guests.
+   - Java is now completely supported.
+     See http://libguestfs.org/guestfs-java.3.html
 
- 9pfs (Plan 9 filesystems exported from the host) are now supported.
  - JRuby is supported via the Java bindings.
 
- - Add -DGUESTFS_WARN_DEPRECATED=1 to warn about use of deprecated API
-   functions in C programs.
+   - guestfs_close now appears in trace messages.
 
- New manual page guestfs-recipes(1) with recipes.
  - Python binding adds explicit g.close() method.
 
- - CentOS and Scientific Linux are now treated as separate distros by
-   the inspection API.
+   - Python programs can now use the new event API.
 
- - mkfs-opts can now set inode size and sector size on created filesystems
-   (thanks Nikita Menkovich).
+   - Python GIL is released during libguestfs calls, allowing multithreaded
+     Python programs to work properly.
 
- In guestfish, tab completion now works on /dev/mapper devices.
  - 9pfs (Plan 9 filesystems exported from the host) are now supported.
 
- - New virt-resize --ntfsresize-force option allows Windows VMs to be
-   resized multiple times.
+   - Add -DGUESTFS_WARN_DEPRECATED=1 to warn about use of deprecated API
+     functions in C programs.
+
+   - New manual page guestfs-recipes(1) with recipes.
+
+   - mkfs-opts can now set inode size and sector size on created filesystems
+     (thanks Nikita Menkovich).
+
+   - guestfs_last_errno is now accessible from OCaml (as g#last_errno ()).
 
 Security
 
@@ -78,17 +94,9 @@ Security
 
 New APIs
 
-  btrfs-filesystem-resize
-  get-pgroup
-  inspect-get-icon
-  is-zero
-  is-zero-device
-  list-9p
-  list-dm-devices
-  mount-9p
-  ntfsresize-opts
-  set-pgroup
-  write-append
+  btrfs-filesystem-resize, get-pgroup, inspect-get-icon, is-zero,
+  is-zero-device, list-9p, list-dm-devices, mount-9p, ntfsresize-opts,
+  set-pgroup, write-append
 
 Internals
 
@@ -108,9 +116,11 @@ Internals
 
  - Use ./configure --enable-install-daemon to install /usr/sbin/guestfsd.
 
-Bugs fixed
+ - po-docs directory now covers all man pages.
+
+ - stderr from qemu process is now captured by the event subsystem.
 
-  ./bugs-in-changelog.sh 1.10.0.. | sort -n
+Bugs fixed
 
  - 602997 part-get-bootable gives wrong result with an unordered part layout
  - 661280 virt-rescue: panic when shutting down: "/sbin/reboot: No such file or directory"
@@ -118,6 +128,7 @@ Bugs fixed
  - 705200 guestmount attempt results in access denied
  - 714981 'list-filesystems' does not know about virtio 9p filesystems or detect existing mounts
  - 717786 libguestfs python bindings should have an explicit close call
+ - 721275 virt-resize in F16 should support btrfs
 
 
 Release notes for libguestfs 1.10.0