AppData Guidelines

[Gerald B. Cox]

I've reviewed Packaging:AppData
<https://fedoraproject.org/wiki/Packaging:AppData> and have some questions.

When running fedpkg lint, I receive:*copyq.x86_64: E:
invalid-appdata-file /usr/share/appdata/copyq.appdata.xml*

I then issue appstream-util validate copyq.appdata.xml and receive:
*copyq.appdata.xml: FAILED:
• tag-missing           : <name> is not present
• tag-missing           : <summary> is not present
Validation of files failed*

However, when I run appstream-util validate-relax, it passes.

The guidelines indicate you MUST follow the AppData Specification Page
<http://people.freedesktop.org/~hughsient/appdata/>; but it doesn't
really give an indication of what is required, and what is optional.
It only says "should"; however:

If you read the description of <name> and <summary> it says the contents
for both of those fields are "usually the same as the
desktop file" - which indicates it is known to be a duplicate of what is in
the desktop file, but yet implies it is still required -
otherwise why bother to point out the correlation to the desktop file.

Upstream response is if they are duplicated in the desktop file, then they
aren't needed in the appdata file.

There is also a bug report
<https://bugzilla.redhat.com/show_bug.cgi?id=1185361> which discusses
rpmlint and validate-relax.  It touches upon the fact that
validate-relax may be missing some things, but doesn't appear to reach any
conclusion.

The Fedora guidelines say to use "validate-relax", but rpmlint appears to
use "validate".  Which
is correct?  Is <name> and <summary> optional or required?
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.fedoraproject.org/pipermail/devel/attachments/20150602/cae06cb4/attachment.html>