desktop-entry-spec.xml patch

[Jonathan Blandford]

Ville Skyttä <ville.skytta at iki.fi> writes:

> On Sun, 2004-07-11 at 00:49, Ray Strode wrote:
> > On Sat, 2004-07-10 at 21:36 +0300, Ville Skyttä wrote:
> > > On Sat, 2004-07-10 at 02:21, Jonathan Blandford wrote:
> > > 
> > > > +     The difference between string and localestring is that the value
> > > > +     for a string key must contain only ASCII characters while the
> > > > +     value of a localestring key must contain UTF-8 characters.
> > > 
> > > Reflecting this in the names would make it more obvious, eg.
> > > asciistring/utf8string instead of string/localestring.
> > Note that localestrings aren't necessarily UTF-8 in legacy desktop
> > files. See:
> > 
> > http://freedesktop.org/Standards/desktop-entry-spec/0.9.4/apd.html
> 
> In that case, the quoted part from the proposed spec patch above (the
> "+" lines) should be updated somehow.  It currently says "must contain
> UTF-8 characters".

Is this clearer?

<para>
  Values of type 'string' must contain only ASCII characters
  excluding control characters.  Values of type 'localestring' are
  human readable, and are encoded in UTF-8 unless the
  <constant>Legacy-Mixed</constant> Encoding is specified (see <xref
  linkend="legacy-mixed"/>.)
</para>

Thanks,
-Jonathan