Re: schema files

[Ole Laursen <olau hardworking dk>]

Christian Rose <menthos@gnome.org> writes:

> b) <short> descriptions should NOT end in a period.
> c) <long> descriptions SHOULD end in a period.

[...]

> i) Make sure you have both <short> and useful <long> descriptions for
> all keys, for the benefit of the users.

I think this latter advice should be left out. If you don't have
anything on your mind for the long description (as is often the case),
making one up is just wasting bits and creating extra (often quite
boring) work for us.

Here's a grave example from the .pot file from Epiphany (but quite a
lot of modules have this sort of texts where the difference is just
a period):

  #: data/epiphany.schemas.in.h:22
  msgid "Match case for find in page"
  msgstr ""

  #: data/epiphany.schemas.in.h:23
  msgid "Match case for find in page."
  msgstr ""

-- 
Ole Laursen
http://www.cs.auc.dk/~olau/