[Pkg-xen-devel] Bug#644125: xenstore-utils has completely inadequate description

Craig Sanders cas at taz.net.au
Mon Oct 3 03:01:24 UTC 2011


Package: xenstore-utils
Version: 4.0.1-2

all it says is:

"Description: Xenstore utilities for Xen
 This package contains the Xenstore utilities."

Wow, i never would have guessed that a package called xenstore-utils
might contain Xenstore utilities.  I'm glad that's cleared up!

that just leaves a few tiny, niggling questions:

 1. WTF are the Xenstore utilities?
 2. What are they for?
 2. How do i know if/when i need them installed?
 3. Are they for installation on the Dom0 host or the DomU guest? 



The purpose of the Description field in a package is to tell someone,
particularly someone who has never encountered the package before, what
the package does.  Re-iterating the package name in slightly longer form
complete fails in this purpose.

it is a description which is completely accurate, yet at the same time
completely and utterly useless.

if you can't come up with a one or two paragraph summary yourself,
please at least cut-and-paste some minimally descriptive info from
the readme, install notes, web page, or whatever other relevant
documentation or info actually *describes* what the xenstore-utils do.

it doesn't need to be much.  just a paragraph or two will do.

craig

-- 
craig sanders <cas at taz.net.au>





More information about the Pkg-xen-devel mailing list