Return-Path: 
 <docs-return-8468-apmail-httpd-docs-archive=httpd.apache.org@httpd.apache.org>
Delivered-To: apmail-httpd-docs-archive@www.apache.org
Received: (qmail 27453 invoked from network); 7 Nov 2008 17:03:53 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2)
  by minotaur.apache.org with SMTP; 7 Nov 2008 17:03:53 -0000
Received: (qmail 6295 invoked by uid 500); 7 Nov 2008 17:03:59 -0000
Delivered-To: apmail-httpd-docs-archive@httpd.apache.org
Received: (qmail 6248 invoked by uid 500); 7 Nov 2008 17:03:59 -0000
Mailing-List: contact docs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:docs-help@httpd.apache.org>
list-unsubscribe: <mailto:docs-unsubscribe@httpd.apache.org>
List-Post: <mailto:docs@httpd.apache.org>
Reply-To: docs@httpd.apache.org
List-Id: <docs.httpd.apache.org>
Delivered-To: mailing list docs@httpd.apache.org
Received: (qmail 6237 invoked by uid 99); 7 Nov 2008 17:03:59 -0000
Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136)
    by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 07 Nov 2008 09:03:59 -0800
X-ASF-Spam-Status: No, hits=-0.0 required=10.0
	tests=SPF_PASS
X-Spam-Check-By: apache.org
Received-SPF: pass (athena.apache.org: local policy)
Received: from [217.160.171.50] (HELO jupiter.hal-nine-zero-zero-zero.net)
 (217.160.171.50)
    by apache.org (qpsmtpd/0.29) with SMTP; Fri, 07 Nov 2008 17:02:42 +0000
Received: (qmail 22754 invoked from network); 7 Nov 2008 17:03:25 -0000
Received: from unknown (HELO localhost) (217.160.171.50)
  by jupiter.hal-nine-zero-zero-zero.net with SMTP; 7 Nov 2008 17:03:25 -0000
From: =?iso-8859-1?q?Andr=E9_Malo?= <nd@perlig.de>
To: docs@httpd.apache.org
Subject: Re: Let's stop marking XML of translations outdated
Date: Fri, 7 Nov 2008 18:03:50 +0100
User-Agent: KMail/1.9.10
References: <20081107210755.8c202129.takashi@lans-tv.com>
 <4914474F.6070907@pc-tony.com> <20081108003138.3fbd6dc1.takashi@lans-tv.com>
In-Reply-To: <20081108003138.3fbd6dc1.takashi@lans-tv.com>
MIME-Version: 1.0
Content-Type: text/plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
Content-Disposition: inline
Message-Id: <200811071803.50488.nd@perlig.de>
X-Virus-Checked: Checked by ClamAV on apache.org

* Takashi Sato wrote:=20


> On Fri, 07 Nov 2008 13:49:03 +0000
>
> Tony Stevenson <tony@pc-tony.com> wrote:
> > Andr=E9 Malo wrote:
> >
> > [SNIP]
> >
> > > The whole point of the comment is to see which exact revisions of the
> > > original file you have to diff to see the changes.
> > >
> > > -1.
> >
> > Agreed,
> >
> > Very useful for diff's as Andre says.
> >
> > -1
>
> I don't mean to drop the whole comment.
> I just want to drop ":xxxxxx (outdated)".
>
> I don't see usefulness of ":xxxxxx (outdated)" since whether it is
> reliable depends on whether someone commit transformations.
>
> We can specify the revision HEAD:
> svn diff -r 600000:HEAD sitemap.xml
> People who don't use subversion client can open the original file to see
> the current revision.

I see...
The reason for the second revision is to avoid race conditions. Translators=
=20
don't always keep up with the current checkins. So the suggested workflow=20
behind all this is:

=2D svn diff -r<pasted> <originalfile> | <viewer>
=2D <editor> translatedfile
  - update
  - delete revision before colon
=2D (build validate-xml)
=2D checkin
=2D update transformation (the comment is adjusted)
=2D checkin

The update phase is arbitrarily long and we had it already that the origina=
l=20
was updated in the meantime.

The next time the repos is updated and the transformation is run for the=20
particular language, the comment is adjusted again.

And the (outdated) comment can be grepped for.

Hope that explains better the intentions. Maybe we should document that=20
better.

nd

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org