Bug#706966: Info of new tag desktop-entry-lacks-keywords-entry is confusing

[Gaudenz Steinlin <gaudenz@debian.org>]

Hi

Niels Thykier <niels@thykier.net> writes:

> On 2013-05-06 16:23, Gaudenz Steinlin wrote:
>> Package: lintian
>> Version: 2.5.12
>> Severity: normal
>> 
>> The current wording of the desktop-entry-lacks-keywords-entry info text
>> is quite confusing because it talks about "categories" and "keywords"
>> but both are valid keys in .desktop files. But as I understand it the
>> text does not mean the "Categories" key but just talks about general
>> keywords as categories. With the current wording I first thought that
>> this lintian warning is about the "Categories" entry while it actually
>> is about the "Keywords" entry.
>> 
>> Current paragraph:
>> The categories for this desktop entry do not contain any Keywords.
>> Keywords should not be redundant with the values of Name or GenericName.
>> 
>
> Hi,
>
> Thanks for the report and the new suggestion.
>
>> Suggestd improved version:
>> The "Keywords" entry for this desktop file does not contain any
>       ^^^^^^^^^^^^^^^^
>
> Did you mean "Keywords" entry here?
>   "The entry

Yes I meant "Keywords" entry. But after rereading it might still not be
completely clear. Maybe this is better (but more verbose):
This .desktop file does either not contain a "Keywords" entry or it does
not contain any keywords not already present in the "Name" or
"GenericName" entries.

.desktop files are organized in key/value pairs (similar to .ini files).
"Keywords" is the name of the entry/key in the .desktop file containing
keywords relevant for this .desktop file.

Gaudenz

>
>> Keywords. Keywords should not be redundant with the values of Name or
>> GenericName.
>> 
>> Gaudenz
>> 
>> [...]
>
>
> ~Niels
>
>
>

-- 
Ever tried. Ever failed. No matter.
Try again. Fail again. Fail better.
~ Samuel Beckett ~