Pkg xen devel - Aug 2013 - Bug#466683: Expanding descriptions of some packages.

tags 466683 +patch
thanks

commit 765ac4708e4dd8a6fea0028d631a7c3363b286b7
Author: Ian Campbell <ijc at hellion.org.uk>
Date:   Fri Aug 16 10:30:17 2013 +0100

    * debian/changelog: Update
    * debian/templates/control.main.in: Update descriptions for some packages.

diff --git a/xen/debian/changelog b/xen/debian/changelog
index 6100e75..e5b25ef 100644
--- a/xen/debian/changelog
+++ b/xen/debian/changelog
@@ -1,5 +1,6 @@
 xen (4.3.0-1) UNRELEASED; urgency=low
 
+  [ Bastian Blank ]
   * New upstream release.
   * Call configure with proper arguments.
   * Remove now empty xen-docs package.
@@ -16,6 +17,9 @@ xen (4.3.0-1) UNRELEASED; urgency=low
     - Fix fallout from harderning flags.
   * Update Standards-Version to 3.9.4. No changes.
 
+  [ Ian Campbell ]
+  * Expand on the descriptions of some packages. (Closes: #466683)
+
  -- Bastian Blank <waldi at debian.org>  Tue, 23 Jul 2013 12:45:27 +0200
 
 xen (4.2.2-1) unstable; urgency=low
diff --git a/xen/debian/templates/control.main.in
b/xen/debian/templates/control.main.in
index 67dd825..afeddd5 100644
--- a/xen/debian/templates/control.main.in
+++ b/xen/debian/templates/control.main.in
@@ -2,27 +2,50 @@ Package: libxen- at version@
 Section: libs
 Depends: ${shlibs:Depends}, ${misc:Depends}
 Description: Public libs for Xen
- This package contains the shared libraries for Xen.
+ This package contains the shared toolstack libraries for Xen.
 
 Package: libxenstore3.0
 Section: libs
 Depends: ${shlibs:Depends}, ${misc:Depends}
 Description: Xenstore communications library for Xen
- This package contains the public libxenstore.
+ This package contains the client library interface to XenStore.
+ .
 
 Package: libxen-dev
 Section: libdevel
 Depends: libxen- at version@ (= ${binary:Version}), libxenstore3.0 (=
${binary:Version}), ${misc:Depends}
 Description: Public headers and libs for Xen
  This package contains the public headers and static libraries for Xen.
+ .
+ The libxenlight library is intended as a common base for all Xen toolstack
+ developers. The libxlutil library contains additional helpers which may be
+ useful to toolstack developers.
+ .
+ The libxenstore library allows usespace processes to interact with the
+ XenStore database. XenStore is a shared database used for interdomain
+ communication of configuration and status information. It is accessible to all
+ domains running on the same Xen host. See http://wiki.xen.org/wiki/XenStore
+ for more information.
+ .
+ The libxenctrl and libxenguest libraries are internal libraries intended for
+ use by the Xen toolstack and are not intended to be used directly. Toolstack
+ authors should use libxenlight.
 
 Package: xenstore-utils
 Section: admin
 Depends: ${shlibs:Depends}, ${misc:Depends}
 Conflicts: xen-utils-common (<= 3.1.0-1)
 Replaces: xen-utils-common (<= 3.1.0-1)
-Description: Xenstore utilities for Xen
- This package contains the Xenstore utilities.
+Description: Xenstore command line utilities for Xen
+ This package contains command line utilities for interacting with XenStore.
+ .
+ XenStore is a shared database used for interdomain communication of
+ configuration and status information. It is accessible to all domains running
+ on the same Xen host. See http://wiki.xen.org/wiki/XenStore for more
information.
+ .
+ In the common case these tools are used by the Xen toolstack running in
+ domain0 (or a driver domain) however they may also be used in a guest domain
+ to support local scripting which wants to communicate via XenStore.
 
 Package: libxen-ocaml
 Section: ocaml

Processing commands for control at bugs.debian.org:
> tags 466683 +patch
Bug #466683 [xenstore-utils] xenstore-utils: The package description doesn't
say what the utilities contained in the package are for.
Bug #644125 [xenstore-utils] xenstore-utils has completely inadequate
description
Added tag(s) patch.
Added tag(s) patch.
> thanks
Stopping processing here.

Please contact me if you need assistance.
-- 
466683: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=466683
644125: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=644125
Debian Bug Tracking System
Contact owner at bugs.debian.org with problems

Ian Campbell wrote:
> +  * Expand on the descriptions of some packages. (Closes: #466683)
Trivial typo here:
>  Package: libxen-dev
>  Section: libdevel
>  Depends: libxen- at version@ (= ${binary:Version}), libxenstore3.0 (=
${binary:Version}), ${misc:Depends}
>  Description: Public headers and libs for Xen
>   This package contains the public headers and static libraries for Xen.
> + .
> + The libxenlight library is intended as a common base for all Xen
toolstack
> + developers. The libxlutil library contains additional helpers which may
be
> + useful to toolstack developers.
> + .
> + The libxenstore library allows usespace processes to interact with the
                                      ^
s/usespace/userspace/.
-- 
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package

On Fri, 2013-08-16 at 15:21 +0100, Justin B Rye wrote:
> Ian Campbell wrote:
> > +  * Expand on the descriptions of some packages. (Closes: #466683)
> 
> Trivial typo here:
> 
> >  Package: libxen-dev
> >  Section: libdevel
> >  Depends: libxen- at version@ (= ${binary:Version}), libxenstore3.0 (=
${binary:Version}), ${misc:Depends}
> >  Description: Public headers and libs for Xen
> >   This package contains the public headers and static libraries for
Xen.
> > + .
> > + The libxenlight library is intended as a common base for all Xen
toolstack
> > + developers. The libxlutil library contains additional helpers which
may be
> > + useful to toolstack developers.
> > + .
> > + The libxenstore library allows usespace processes to interact with
the
>                                       ^
> s/usespace/userspace/.
Yep, thanks!

8<-------------------------

commit 9174a352a3be6a1b8961e6324f81c07edaf33922
Author: Ian Campbell <ijc at hellion.org.uk>
Date:   Fri Aug 16 10:30:17 2013 +0100

    * debian/changelog: Update
    * debian/templates/control.main.in: Update descriptions for some packages.

diff --git a/xen/debian/changelog b/xen/debian/changelog
index 6100e75..e5b25ef 100644
--- a/xen/debian/changelog
+++ b/xen/debian/changelog
@@ -1,5 +1,6 @@
 xen (4.3.0-1) UNRELEASED; urgency=low
 
+  [ Bastian Blank ]
   * New upstream release.
   * Call configure with proper arguments.
   * Remove now empty xen-docs package.
@@ -16,6 +17,9 @@ xen (4.3.0-1) UNRELEASED; urgency=low
     - Fix fallout from harderning flags.
   * Update Standards-Version to 3.9.4. No changes.
 
+  [ Ian Campbell ]
+  * Expand on the descriptions of some packages. (Closes: #466683)
+
  -- Bastian Blank <waldi at debian.org>  Tue, 23 Jul 2013 12:45:27 +0200
 
 xen (4.2.2-1) unstable; urgency=low
diff --git a/xen/debian/templates/control.main.in
b/xen/debian/templates/control.main.in
index 67dd825..2e9d8ee 100644
--- a/xen/debian/templates/control.main.in
+++ b/xen/debian/templates/control.main.in
@@ -2,27 +2,50 @@ Package: libxen- at version@
 Section: libs
 Depends: ${shlibs:Depends}, ${misc:Depends}
 Description: Public libs for Xen
- This package contains the shared libraries for Xen.
+ This package contains the shared toolstack libraries for Xen.
 
 Package: libxenstore3.0
 Section: libs
 Depends: ${shlibs:Depends}, ${misc:Depends}
 Description: Xenstore communications library for Xen
- This package contains the public libxenstore.
+ This package contains the client library interface to XenStore.
+ .
 
 Package: libxen-dev
 Section: libdevel
 Depends: libxen- at version@ (= ${binary:Version}), libxenstore3.0 (=
${binary:Version}), ${misc:Depends}
 Description: Public headers and libs for Xen
  This package contains the public headers and static libraries for Xen.
+ .
+ The libxenlight library is intended as a common base for all Xen toolstack
+ developers. The libxlutil library contains additional helpers which may be
+ useful to toolstack developers.
+ .
+ The libxenstore library allows userspace processes to interact with the
+ XenStore database. XenStore is a shared database used for interdomain
+ communication of configuration and status information. It is accessible to all
+ domains running on the same Xen host. See http://wiki.xen.org/wiki/XenStore
+ for more information.
+ .
+ The libxenctrl and libxenguest libraries are internal libraries intended for
+ use by the Xen toolstack and are not intended to be used directly. Toolstack
+ authors should use libxenlight.
 
 Package: xenstore-utils
 Section: admin
 Depends: ${shlibs:Depends}, ${misc:Depends}
 Conflicts: xen-utils-common (<= 3.1.0-1)
 Replaces: xen-utils-common (<= 3.1.0-1)
-Description: Xenstore utilities for Xen
- This package contains the Xenstore utilities.
+Description: Xenstore command line utilities for Xen
+ This package contains command line utilities for interacting with XenStore.
+ .
+ XenStore is a shared database used for interdomain communication of
+ configuration and status information. It is accessible to all domains running
+ on the same Xen host. See http://wiki.xen.org/wiki/XenStore for more
information.
+ .
+ In the common case these tools are used by the Xen toolstack running in
+ domain0 (or a driver domain) however they may also be used in a guest domain
+ to support local scripting which wants to communicate via XenStore.
 
 Package: libxen-ocaml
 Section: ocaml