[Pkg-libvirt-maintainers] Bug#640470: libguestfs: [debconf_rewrite] Debconf templates and debian/control review

Christian Perrier bubulle at debian.org
Mon Sep 5 04:33:53 UTC 2011


Package: libguestfs
Version: N/A
Severity: normal
Tags: patch

Dear Debian maintainer,

On Wednesday, August 17, 2011, I notified you of the beginning of a review process
concerning debconf templates for libguestfs.

The debian-l10n-english contributors have now reviewed these templates,
and the proposed changes are attached to this bug report.

Please review the suggested changes, and if you have any
objections, let me know in the next 3 days.

However, please try to avoid uploading libguestfs with these changes
right now.

The second phase of this process will begin on Thursday, September 08, 2011, when I will
coordinate updates to translations of debconf templates.

The existing translators will be notified of the changes: they will
receive an updated PO file for their language.

Simultaneously, a general call for new translations will be sent to
the debian-i18n mailing list.

Both these calls for translations will request updates to be sent as
individual bug reports. That will probably trigger a lot of bug
reports against your package, but these should be easier to deal with.

The call for translation updates and new translations will run until
about Thursday, September 29, 2011. Please avoid uploading a package with fixed or changed
debconf templates and/or translation updates in the meantime. Of
course, other changes are safe.

Please note that this is an approximative delay, which depends on my
own availability to process this work and is influenced by the fact
that I simultaneously work on many packages.

Around Friday, September 30, 2011, I will contact you again and will send a final patch
summarizing all the updates (changes to debconf templates,
updates to debconf translations and new debconf translations).

Again, thanks for your attention and cooperation.


-- System Information:
Debian Release: wheezy/sid
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: i386 (i686)

Kernel: Linux 3.0.0-1-686-pae (SMP w/2 CPU cores)
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968)
Shell: /bin/sh linked to /bin/dash
-------------- next part --------------
--- libguestfs.old/debian/libguestfs0.templates	2011-08-12 09:49:01.605541217 +0200
+++ libguestfs/debian/libguestfs0.templates	2011-09-05 06:32:01.893281075 +0200
@@ -1,10 +1,22 @@
+# These templates have been reviewed by the debian-l10n-english
+# team
+#
+# If modifications/additions/rewording are needed, please ask
+# debian-l10n-english at lists.debian.org for advice.
+#
+# Even minor modifications require translation updates and such
+# changes should be coordinated with translators and reviewers.
+
 Template: libguestfs/update-appliance
 Type: boolean
 Default: false
 _Description: Create or update supermin appliance now?
- libguestfs needs a supermin appliance to perform its work. To
- generate or update it, network access to a package repository is
- needed.
+ A "supermin appliance" is mandatory for libguestfs.
+ It contains lists of files and directories. These will be
+ copied into an ad-hoc file system whenever libguestfs starts
+ a virtual machine.
  .
- update-guestfs-appliance(8) can also be used at a later time to
- create or update the supermin appliance.
+ To generate or update a supermin appliance, network access to a
+ package repository is needed.
+ .
+ This can be done later by using the update-guestfs-appliance(8) utility.
--- libguestfs.old/debian/control	2011-08-12 09:49:01.605541217 +0200
+++ libguestfs/debian/control	2011-09-05 06:33:51.339867642 +0200
@@ -26,31 +26,53 @@
 Section: admin
 Architecture: i386 amd64
 Depends: libguestfs0 (= ${binary:Version}), ${shlibs:Depends}, ${misc:Depends}
-Description: libguestfs filesystem interactive shell
+Description: guest disk image management system - file system shell
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
+ .
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
+ btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
+ vmdk.
+ .
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
+ .
  Guestfish is a shell and command-line tool for examining and modifying
- virtual machine filesystems.  It uses libguestfs and exposes all of the
- functionality of the guestfs API, see guestfs(3).
+ virtual machine file systems. It uses libguestfs and exposes all of the
+ functionality of the guestfs API; see guestfs(3).
 
 Package: libguestfs-dev
 Section: libdevel
 Architecture: i386 amd64
 Depends: libguestfs0 (= ${binary:Version}), ${misc:Depends}
-Description: library for accessing and modifying guest disk images
- libguestfs is a library for accessing and modifying guest disk images. Amongst
- the things this is good for: making batch configuration changes to guests,
- viewing and editing files inside guests, getting disk used/free statistics,
- migrating between virtualization systems, performing partial backups,
- performing partial guest clones, cloning guests and changing
- registry/UUID/hostname info, and much else besides.
- .
- It uses Linux kernel and qemu code, and can access any type of guest
- filesystem that Linux and qemu can, including but not limited to: ext2/3/4,
+Description: guest disk image management system - development headers
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
+ .
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
  btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
  vmdk.
  .
- libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, what
- filesystem is in each LV, etc.). It can also run commands in the context of 
- the guest. Also you can upload and download files and directories.
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
  .
  This package contains the development headers.
 
@@ -95,32 +117,54 @@
   strace,
   xfsprogs,
   zerofree
-Description: library for accessing and modifying guest disk images
- libguestfs is a library for accessing and modifying guest disk images. Amongst
- the things this is good for: making batch configuration changes to guests,
- viewing and editing files inside guests, getting disk used/free statistics,
- migrating between virtualization systems, performing partial backups,
- performing partial guest clones, cloning guests and changing
- registry/UUID/hostname info, and much else besides.
- .
- It uses Linux kernel and qemu code, and can access any type of guest
- filesystem that Linux and qemu can, including but not limited to: ext2/3/4,
+Description: guest disk image management system - shared library
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
+ .
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
  btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
  vmdk.
  .
- libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, what
- filesystem is in each LV, etc.). It can also run commands in the context of 
- the guest. Also you can upload and download files and directories.
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
 
 Package: guestmount
 Section: admin
 Architecture: i386 amd64
 Depends: libguestfs0 (= ${binary:Version}), ${shlibs:Depends}, ${misc:Depends}
-Description: mount guest filesystem using libguestfs and FUSE
- The guestmount program can be used to mount virtual machine filesystems
- and other disk images on the host.  It uses libguestfs for access to
- the guest filesystem, and FUSE (the "filesystem in userspace") to make
- it appear as a mountable device.
+Description: guest disk image management system - FUSE mount utility
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
+ .
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
+ btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
+ vmdk.
+ .
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
+ .
+ The guestmount utility can be used to mount virtual machine file systems and
+ other disk images on the host. It uses libguestfs for access to the guest
+ file system, and FUSE ("File system in USErspace") to make it appear as a
+ mountable device.
 
 Package: libguestfs-tools
 Section: admin
@@ -129,31 +173,53 @@
  libsys-virt-perl, libguestfs-perl (= ${binary:Version}),
  libwin-hivex-perl,
  libintl-perl, libstring-shellquote-perl
-Description: libguestfs virt tools
- This package contains virt tools including virt-cat, virt-df, virt-edit,
- virt-filesystems, virt-inspector, virt-ls, virt-make-fs, virt-rescue,
- virt-resize, virt-tar and virt-win-reg.
+Description: guest disk image management system - tools
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
+ .
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
+ btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
+ vmdk.
+ .
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
+ .
+ This package contains virtualization tools, including virt-cat, virt-df,
+ virt-edit, virt-filesystems, virt-inspector, virt-ls, virt-make-fs,
+ virt-rescue, virt-resize, virt-tar, and virt-win-reg.
 
 Package: libguestfs0-dbg
 Section: debug
 Architecture: i386 amd64
 Depends: ${shlibs:Depends}, ${misc:Depends}, libguestfs0 (= ${binary:Version})
-Description: library for accessing and modifying guest disk images
- libguestfs is a library for accessing and modifying guest disk images. Amongst
- the things this is good for: making batch configuration changes to guests,
- viewing and editing files inside guests, getting disk used/free statistics,
- migrating between virtualization systems, performing partial backups,
- performing partial guest clones, cloning guests and changing
- registry/UUID/hostname info, and much else besides.
- .
- It uses Linux kernel and qemu code, and can access any type of guest
- filesystem that Linux and qemu can, including but not limited to: ext2/3/4,
+Description: guest disk image management system - debug symbols
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
+ .
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
  btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
  vmdk.
  .
- libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, what
- filesystem is in each LV, etc.). It can also run commands in the context of 
- the guest. Also you can upload and download files and directories.
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
  .
  This package contains the debugging symbols.
 
@@ -161,22 +227,25 @@
 Section: doc
 Architecture: all
 Depends: ${shlibs:Depends}, ${misc:Depends}
-Description: library for accessing and modifying guest disk images
- libguestfs is a library for accessing and modifying guest disk images. Amongst
- the things this is good for: making batch configuration changes to guests,
- viewing and editing files inside guests, getting disk used/free statistics,
- migrating between virtualization systems, performing partial backups,
- performing partial guest clones, cloning guests and changing
- registry/UUID/hostname info, and much else besides.
- .
- It uses Linux kernel and qemu code, and can access any type of guest
- filesystem that Linux and qemu can, including but not limited to: ext2/3/4,
+Description: guest disk image management system - documentation
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
+ .
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
  btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
  vmdk.
  .
- libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, what
- filesystem is in each LV, etc.). It can also run commands in the context of 
- the guest. Also you can upload and download files and directories.
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
  .
  This package contains the documentation.
 
@@ -186,22 +255,25 @@
 Depends: ${shlibs:Depends}, ${misc:Depends}, ${python:Depends}, libguestfs0 (= ${binary:Version})
 Provides: python-libguestfs
 Conflicts: python-libguestfs
-Description: library for accessing and modifying guest disk images
- libguestfs is a library for accessing and modifying guest disk images. Amongst
- the things this is good for: making batch configuration changes to guests,
- viewing and editing files inside guests, getting disk used/free statistics,
- migrating between virtualization systems, performing partial backups,
- performing partial guest clones, cloning guests and changing
- registry/UUID/hostname info, and much else besides.
- .
- It uses Linux kernel and qemu code, and can access any type of guest
- filesystem that Linux and qemu can, including but not limited to: ext2/3/4,
+Description: guest disk image management system - Python bindings
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
+ .
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
  btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
  vmdk.
  .
- libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, what
- filesystem is in each LV, etc.). It can also run commands in the context of 
- the guest. Also you can upload and download files and directories.
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
  .
  This package contains the Python bindings.
  
@@ -213,22 +285,25 @@
  libxml-xpath-perl,
  libwin-hivex-perl,
  libsys-virt-perl
-Description: library for accessing and modifying guest disk images
- libguestfs is a library for accessing and modifying guest disk images. Amongst
- the things this is good for: making batch configuration changes to guests,
- viewing and editing files inside guests, getting disk used/free statistics,
- migrating between virtualization systems, performing partial backups,
- performing partial guest clones, cloning guests and changing
- registry/UUID/hostname info, and much else besides.
- .
- It uses Linux kernel and qemu code, and can access any type of guest
- filesystem that Linux and qemu can, including but not limited to: ext2/3/4,
+Description: guest disk image management system - Perl bindings
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
+ .
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
  btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
  vmdk.
  .
- libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, what
- filesystem is in each LV, etc.). It can also run commands in the context of 
- the guest. Also you can upload and download files and directories.
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
  .
  This package contains the Perl bindings.
  
@@ -238,24 +313,27 @@
 Depends: ${shlibs:Depends}, ${misc:Depends}, libguestfs0 (= ${binary:Version}),
  ${ocaml:Depends}
 Provides: ${ocaml:Provides}
-Description: library for accessing and modifying guest disk images
- libguestfs is a library for accessing and modifying guest disk images. Amongst
- the things this is good for: making batch configuration changes to guests,
- viewing and editing files inside guests, getting disk used/free statistics,
- migrating between virtualization systems, performing partial backups,
- performing partial guest clones, cloning guests and changing
- registry/UUID/hostname info, and much else besides.
+Description: guest disk image management system - OCaml bindings
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
  .
- It uses Linux kernel and qemu code, and can access any type of guest
- filesystem that Linux and qemu can, including but not limited to: ext2/3/4,
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
  btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
  vmdk.
  .
- libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, what
- filesystem is in each LV, etc.). It can also run commands in the context of 
- the guest. Also you can upload and download files and directories.
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
  .
- This package include the OCaml shared runtime stub libraries.
+ This package includes the OCaml shared runtime stub libraries.
  
 Package: libguestfs-ocaml-dev
 Section: ocaml
@@ -265,22 +343,25 @@
  libguestfs-dev (= ${binary:Version}), 
  ${ocaml:Depends}
 Provides: ${ocaml:Provides}
-Description: library for accessing and modifying guest disk images
- libguestfs is a library for accessing and modifying guest disk images. Amongst
- the things this is good for: making batch configuration changes to guests,
- viewing and editing files inside guests, getting disk used/free statistics,
- migrating between virtualization systems, performing partial backups,
- performing partial guest clones, cloning guests and changing
- registry/UUID/hostname info, and much else besides.
- .
- It uses Linux kernel and qemu code, and can access any type of guest
- filesystem that Linux and qemu can, including but not limited to: ext2/3/4,
+Description: guest disk image management system - OCaml development files
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
+ .
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
  btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
  vmdk.
  .
- libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, what
- filesystem is in each LV, etc.). It can also run commands in the context of 
- the guest. Also you can upload and download files and directories.
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
  .
  This package contains all the files needed to develop OCaml programs
- wich use OCaml bindings to libguestfs.
+ which use OCaml bindings to libguestfs.


More information about the Pkg-libvirt-maintainers mailing list