On Mon, Sep 28, 2009 at 08:23:34PM +0200, Sebastian Pipping wrote:
> Hello there!
> This may look like like a lot of text but it actually isn't.
> Please read on.  Thanks.

Thanks for your good work.
I agree with your changes it was indeed needed.

Actually, during my GSOC, I've noted layman-global.txt should be changed
to have a cleanier description information and it's probably the moment
to introduce this.

At the moment, <description> is used for very short descriptions:
<description>Arcon Overlay!</description>
or quite longer:
<description>A collection of Bazaar-related ebuilds, including release 
candidates of Bazaar.</description>
even ery long:
<description>Berkano overlay provides an overlay for Gentoo Linux with
ebuilds of bleeding edge software (such as live subversion builds) and other 
handy tools that are missing from the official portage tree. Areas of interest 
include multimedia and system administration.</description>

layman is a cli so it doesn't really care of the description lenght but
it's a pain to use in a GUI like PackageKit repository list. I think we
should introduce a <longdescription> field even with a lang parameter
like we already have in metadata.xml. So, description field will have to
be used for short descriptions (a few words) to complete the name of the
overlay like:
<description>experimental gnome ebuilds</description>

I don't think DTD have abilities to restrict field value lenght but even
if we will have to change a few <description> by hands, having a
<longdescription> field could help.

Sebastian, do you think you can add this to your set of changes ? (only
the new field in the DTD at the moment).


Reply via email to