Re: [Libreoffice] [Libreoffice-qa] Naming builds. Please???

2011-12-05 Thread Lionel Elie Mamane
On Mon, Dec 05, 2011 at 06:22:33AM -0800, Pedro wrote:


>> There might be more commits in the other repositories in the
>> meantime => the question is what time to use. We might end up with
>> 5 times in the end, e.g.:

>> 41491491-41491527-41491568-41491597-41491613

>> It is quite complex in the end. Also, it would be hard for developers to
>> get the corresponding commit from it.

> That is why I suggested to established a different "birth" date for
> each repository.
> If we established a 2 day interval since TDF's birthday, then you would have

> 414.91491-412.91491-410.91491-408.91491-406.91491

Not, it is still harder than necessary for devs to find what commit
this corresponds to.

>> I see the following needs and solutions:

>>     + easily match about dialog with downloaded tarball

>>       => we need to use the same string in both

>>          I would add one more line with a time generated by configure
>>          to the about dialog. The same time should be used in the
>>          download tarball name

> That would be an easier solution. And human readable.

So the time you want to put is essentially a "build started" date, and
not even that. If an incremental build was done that did not rerun
configure, your date is not updated. We can fix that later point by
instead making that date a .PHONY target in make, but it still does
not satisfy me.

I still prefer my "date of last commit to repo" solution. Yes, we have
five dates instead of one, but that is the truth... If someone builds
with a recent core, but old binfilters, at least it
shows. Essentially, the "last commit" date is a *code* *version*
*number*, that is completely independent of when the build was
done. *That* is what we want.

>>     + easily match build with git commit

>>       => keep the git IDs in about dialog

> My suggestion was to replace the git IDs altogether with the age
> system.

No, the git IDs is the only thing that is easy to use in git. Git IDs
have to stay. Add the dates as an *alternative* for human consumption,
and as a monotonically increasing version number.

-- 
Lionel
___
LibreOffice mailing list
LibreOffice@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/libreoffice


Re: [Libreoffice] [Libreoffice-qa] Naming builds. Please???

2011-12-05 Thread Pedro
Hi Petr

> Hmm, we check out the five repositories one by one. It might take some
> time if you have slower network connection. There might be more commits
> in the other repositories in the meantime => the question is what time
> to use. We might end up with 5 times in the end, e.g.:
>
> 41491491-41491527-41491568-41491597-41491613
>
> It is quite complex in the end. Also, it would be hard for developers to
> get the corresponding commit from it.

That is why I suggested to established a different "birth" date for
each repository.
If we established a 2 day interval since TDF's birthday, then you would have

414.91491-412.91491-410.91491-408.91491-406.91491

Because the part before the point means days, a build from the
following day would be (assuming there were changes only to the core)

415.67866-412.91491-410.91491-408.91491-406.91491

I.e. you only need to read the first 3 digits to realize if it's older or newer.
Even better: because the fraction part after the point is also time,
you know that any value below 0.5 is before noon and any value greater
is between noon and midnight.

> I see the following needs and solutions:
>
>
>     + easily match about dialog with downloaded tarball
>
>       => we need to use the same string in both
>
>          I would add one more line with a time generated by configure
>          to the about dialog. The same time should be used in the
>          download tarball name

That would be an easier solution. And human readable.

>     + easily match build with git commit
>
>       => keep the git IDs in about dialog

My suggestion was to replace the git IDs altogether with the age
system. This solves the potential problem of the truncated 7 digits of
the SHA repeating sometime in the future and it is human readable.
But this is secondary if the date-time code is added to the about box
and to the tarball name (or Windows installer ;) )

>     + human readable string for official builds for normal users:
>
>      => I would add one more line, .e.g. 3.5.0-beta1
>         it will be used only in the official builds generated from
>         release tarballs or release tags

Couldn't agree more!

>
> Does it make sense?

Yes. I think that covers all problems.

Best regards,
Pedro


--
View this message in context: 
http://nabble.documentfoundation.org/Naming-builds-Please-tp3556898p3561557.html
Sent from the Dev mailing list archive at Nabble.com.___
LibreOffice mailing list
LibreOffice@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/libreoffice


Re: [Libreoffice] [Libreoffice-qa] Naming builds. Please???

2011-12-05 Thread Petr Mladek
Pedro Lino píše v So 03. 12. 2011 v 23:40 +:
> Hi Lionel
> 
> > Git commit IDs as identifiers have the huge problem that they are not
> > comparable (one cannot say which one is "greater") without referring
> > to the repository. How about we also put the *commit* (not author)
> > timestamp (in UTC) of the top node (commit), and maybe the branch?
> 
> That would help!
> 
> > Something like:
> >
> > Build assembled from:
> >  repo  commit   date   branch
> >  core: 4f11d0a 2011-11-16 21:57:28 master
> >  help: adcf6d5 2011-11-05 14:01:21 master
> >  ...
> >
> > Or instead of pretty-printing the date, just put it as seconds
> > since the epoch:
> >
> >  core: 4f11d0a 1321480648 master
> >  help: adcf6d5 1320501681 master
> 
> That would solve the problem when looking into the log file but not
> when looking at the About box.
> 
> Picking up your (excellent) idea of using the date and converting to a
> linear value: if each repository was given a Birth Date and time since
> that date converted to a linear value (age), using the Date function
> you could get a 10 digit value able to separate builds with one second
> time difference.
> 
> E.g. If the Core repository was created at midnight Sept 28th 2010
> (TDF's birthday) or in linear time (times 10 to eliminate the
> point) 404490, then the 4f11d0a 2011-11-16 21:57:28 master
> 
> age would be 41491490. This seems like a nice easy number to compare.
> In fact a build using code from one second later would be 41491491.

Hmm, we check out the five repositories one by one. It might take some
time if you have slower network connection. There might be more commits
in the other repositories in the meantime => the question is what time
to use. We might end up with 5 times in the end, e.g.:

41491491-41491527-41491568-41491597-41491613

It is quite complex in the end. Also, it would be hard for developers to
get the corresponding commit from it.


I think that we should first define what we expect from the version
number. Note that we could mention more lines in the about dialog.
They are easy to cut&paste, so they should not cause troubles.


I see the following needs and solutions:


+ easily match about dialog with downloaded tarball

  => we need to use the same string in both

 I would add one more line with a time generated by configure
 to the about dialog. The same time should be used in the
 download tarball name


+ easily match build with git commit

  => keep the git IDs in about dialog


+ human readable string for official builds for normal users:

 => I would add one more line, .e.g. 3.5.0-beta1
it will be used only in the official builds generated from
release tarballs or release tags


Does it make sense?


Best Regards,
Petr

___
LibreOffice mailing list
LibreOffice@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/libreoffice


Re: [Libreoffice] [Libreoffice-qa] Naming builds. Please???

2011-12-03 Thread Pedro Lino
> No, my idea was to put the above text in the about box, to replace our
> current 4f11d0a-adcf6d5-... string.

Oh, I see! But then it would be easier to use the "pretty printing
date" instead of having 2 strings to compare for each repository. That
would be a nice improvement.

What I was proposing was to replace 4f11d0a-adcf6d5-c4bb9bd with
41491490-etc-etc
which is a simple numeric value that will continually grow because it
is an age...

One year from now you would be using build 79831260-etc-etc and you
wouldn't have to look twice to know that this build was much newer
than 41491490-etc-etc

Even better, use the string as the actual number of days which is even
easier to visually compare: 414.91490-etc-etc now, 798.31260-etc-etc
in a year, 44534.31260-etc-etc ten years from today at the exact same
second

It's easy to visualize and to explain to anyone the logic.

Kind regards,
Pedro
___
LibreOffice mailing list
LibreOffice@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/libreoffice


Re: [Libreoffice] [Libreoffice-qa] Naming builds. Please???

2011-12-03 Thread Lionel Elie Mamane
On Sat, Dec 03, 2011 at 11:40:01PM +, Pedro Lino wrote:

>> Git commit IDs as identifiers have the huge problem that they are not
>> comparable (one cannot say which one is "greater") without referring
>> to the repository. How about we also put the *commit* (not author)
>> timestamp (in UTC) of the top node (commit), and maybe the branch?

>> Something like:

>> Build assembled from:
>>  repo  commit   date               branch
>>  core: 4f11d0a 2011-11-16 21:57:28 master
>>  help: adcf6d5 2011-11-05 14:01:21 master
>>  ...

>> Or instead of pretty-printing the date, just put it as seconds
>> since the epoch:

>>  core: 4f11d0a 1321480648 master
>>  help: adcf6d5 1320501681 master

> That would solve the problem when looking into the log file but not
> when looking at the About box.

No, my idea was to put the above text in the about box, to replace our
current 4f11d0a-adcf6d5-... string.

-- 
Lionel
___
LibreOffice mailing list
LibreOffice@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/libreoffice


Re: [Libreoffice] [Libreoffice-qa] Naming builds. Please???

2011-12-03 Thread Pedro Lino
Hi Lionel

> Git commit IDs as identifiers have the huge problem that they are not
> comparable (one cannot say which one is "greater") without referring
> to the repository. How about we also put the *commit* (not author)
> timestamp (in UTC) of the top node (commit), and maybe the branch?

That would help!

> Something like:
>
> Build assembled from:
>  repo  commit   date               branch
>  core: 4f11d0a 2011-11-16 21:57:28 master
>  help: adcf6d5 2011-11-05 14:01:21 master
>  ...
>
> Or instead of pretty-printing the date, just put it as seconds
> since the epoch:
>
>  core: 4f11d0a 1321480648 master
>  help: adcf6d5 1320501681 master

That would solve the problem when looking into the log file but not
when looking at the About box.

Picking up your (excellent) idea of using the date and converting to a
linear value: if each repository was given a Birth Date and time since
that date converted to a linear value (age), using the Date function
you could get a 10 digit value able to separate builds with one second
time difference.

E.g. If the Core repository was created at midnight Sept 28th 2010
(TDF's birthday) or in linear time (times 10 to eliminate the
point) 404490, then the 4f11d0a 2011-11-16 21:57:28 master

age would be 41491490. This seems like a nice easy number to compare.
In fact a build using code from one second later would be 41491491.

All this takes is attributing an arbitrary birth date for each
repository and very simple calculations.

Please do consider this!

Thank you again, Lionel!
___
LibreOffice mailing list
LibreOffice@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/libreoffice


Re: [Libreoffice] [Libreoffice-qa] Naming builds. Please???

2011-12-03 Thread Pedro Lino
> No need to know. It is just a random (or not so random) sequence of
> hex digits. If nothing documents it to have some significance, don't
> assume it to have any significance.

Thank you for the clarification. It does have some significance.

>> Anyway, even if this was a combination of the GIT IDs it would still
>> be useless as an identification
>
> Well, is it claimed anywhere to be useful as an identification?

I (wrongly) assumed it was meant for identification. In fact if the
same build generates the same sequence then they are synonyms and can
be used for some sort of identification (as I just explained in a
previous email).

I realize from your answer that the code was generated simply to make
the folder name unique.

But this is irrelevant since the installer folder will no longer be created.
___
LibreOffice mailing list
LibreOffice@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/libreoffice


Re: [Libreoffice] [Libreoffice-qa] Naming builds. Please???

2011-12-03 Thread Tor Lillqvist
> I thought Andras was referring to the single 8 letter/number code
> added to the Windows install folder name.
> Where does that come from?

No need to know. It is just a random (or not so random) sequence of
hex digits. If nothing documents it to have some significance, don't
assume it to have any significance.

> Anyway, even if this was a combination of the GIT IDs it would still
> be useless as an identification

Well, is it claimed anywhere to be useful as an identification?

--tml
___
LibreOffice mailing list
LibreOffice@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/libreoffice


Re: [Libreoffice] [Libreoffice-qa] Naming builds. Please???

2011-12-03 Thread Pedro Lino
Hi Korrawit

> That is, if your 4f11d0a is the first group of IDs in About box, it's
> the core repository's commit ID.

Yes, obviously. Sorry for the confusion.
I thought Andras was referring to the single 8 letter/number code
added to the Windows install folder name.
Where does that come from?

Example:
Build ID: 4f11d0a-adcf6d5-c4bb9bd
Folder name LibO-dev 3.5 (4ec47f5f) Installation Files

Anyway, even if this was a combination of the GIT IDs it would still
be useless as an identification because different binaries using the
same core would have a different code depending on the repositories
used, right?

Regards,
Pedro
___
LibreOffice mailing list
LibreOffice@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/libreoffice


Re: [Libreoffice] [Libreoffice-qa] Naming builds. Please???

2011-12-03 Thread Korrawit Pruegsanusak
Hello Pedro, Andras, *

On Sat, Dec 3, 2011 at 20:16, Pedro Lino  wrote:
> So, 4f11d0a is a global commit ID calculated from the partial 5 git
> commit IDs?

No, it isn't. It's like what you've explained:

> So the About box says a286353-090bcba-3bf3b94
> which I just realized are the 7 first letters of each used repository commit 
> ID
>
> tinderbox: git sha1s
> core:a28635374613e556a0093c242823ea90a3704f74
> dictionaries:090bcbaa55370d7906b0cab08839fe88f4e80215
> help:3bf3b943ff05fda627498426a23f94cd0e0b7aab

That is, if your 4f11d0a is the first group of IDs in About box, it's
the core repository's commit ID.

Hope this helps. :)
Best Regards,
-- 
Korrawit Pruegsanusak
___
LibreOffice mailing list
LibreOffice@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/libreoffice