public inbox for libc-locales@sourceware.org
 help / color / mirror / Atom feed
From: Roland McGrath <roland@redhat.com>
To: Dwayne Grant McConnell <decimal@us.ibm.com>
Cc: libc-locales@sources.redhat.com
Subject: glibc localedata bug reports
Date: Tue, 08 Nov 2005 04:46:00 -0000	[thread overview]
Message-ID: <20051108044525.27631180A19@magilla.sf.frob.com> (raw)
In-Reply-To: decimal at us dot ibm dot com's message of  , 7 November 2005 18:09:58 -0000 <20051107180958.30219.qmail@sourceware.org>

wrt http://sourceware.org/bugzilla/show_bug.cgi?id=1787

Locales folks, Dwayne is helping out with general glibc bugzilla triage,
and picking over the old reports.

Dwayne, localedata bugs are something of a special case.  The idea is that
there are fairly unambiguous objective criteria for localedata changes.
The information has to come from published official sources from the
governments of the localities in question, so competent delegates can
determine whether changes are appropriate, without further review by the
glibc maintainers.  The libc-locales mailing list is the default owner for
localedata.  Folks there know the localedata format issues and rules and
the international standards.  They've joined the list to volunteer their
efforts in reviewing localedata changes and new locales, and helping hone
outside contributions into correct changes in the proper form to go into libc.

My notion was to have a trusted person from the libc-locales list who signs
off on localedata changes that meet the criteria for inclusion.  We never
really got coherent procedures for this worked out.  I hope that we can get
this process in shape now as we get the general bugzilla procedures in
shape.  This person would be on the hook for verifying the submission is
appropriate in all regards, so I can let them go right in without worrying.

For some reports like 1787, you can easily see yourself that the changes
are OK in their content.  (You don't have to know much about localedata to
see that it's OK for a guy to update his own telephone number.)

localedata submissions have a few particular criteria for their content:
* References to official published government sources codifying the
  formatting details used in that locality.  
* Names using proper standard ISO codes.
* Verified working with glibc localedef/locale code.

In addition all glibc changes submitted need to meet some criteria:
* Copyright papers on file with FSF for authors and authors' employers.
  Contributors can tell you the state of this, but you need to verify it
  with the FSF's records.  The clerks are often slow to respond by email.
  To do final sign-off on new contributors' submissions, a person should
  have a gnu.org account so they can look in the file directly.
* Proper entries in the right ChangeLog.  Formatting must be correct,
  including the whitespace and TAB use.  Some places like localedata have a
  separate ChangeLog file; entries must be for the right file, with
  relative file names from the directory where that ChangeLog is.
  Entries must have "[BZ #nnn]" markers.

For convenience, ChangeLog entries should be separately pasted at the top
and not part of a patch.  The ideal for patches is so -p1 works from the
top libc directory (e.g. libc/localedata/foobar in a file name in diffs).
But -p0 is also fine, and -p1 or -p1 relative to localedata/ is acceptable
for localedata changes.  There is no reason to be especially picky about
that, as long as it's easy to apply the patch correctly.  For the same
reason, new files in patch form is usually easiest.

Copyright papers of course must be done properly and that is unavoidable.
For the other details it's up to you whether you want to put your efforts
into fixing up a submission or punt it back to the reporter to make their
own changes fit the proper form.


Thanks,
Roland

       reply	other threads:[~2005-11-08  4:46 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <20051107180958.30219.qmail@sourceware.org>
2005-11-08  4:46 ` Roland McGrath [this message]
2005-11-08  8:28   ` Petter Reinholdtsen
2005-11-11 11:24   ` Dwayne Grant McConnell

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20051108044525.27631180A19@magilla.sf.frob.com \
    --to=roland@redhat.com \
    --cc=decimal@us.ibm.com \
    --cc=libc-locales@sources.redhat.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).