← Back to team overview

kicad-developers team mailing list archive

Re: New pcbnew features and versioning

 

If there are more than one commit in a given day, add a lower case alpha to the timestamp
like 20160407, then 20160407a, then 20160407b, and so on.

Just my $0.02
Jean-Paul
N1JPL


> On Apr 7, 2016, at 2:13 PM, Wayne Stambaugh <stambaughw@xxxxxxxxx> wrote:
> 
> I like it.  It's more meaningful than an integer.  The only time that
> doesn't work is when there is more than one feature change per day.
> Given that we have never made more than one file format change on a
> single day, I think we are safe. :)
> 
> On 4/7/2016 2:04 PM, Chris Pavlina wrote:
>> What about using the date the change was made as a "version number"? Can
>> integerize it like 20160407 for example. This allows easy cross-referencing of
>> a format version with the revision that it was made in, and is guaranteed to
>> increase monotonically if you use a YMD format :)
>> 
>> On Thu, Apr 07, 2016 at 07:47:10PM +0200, jp charras wrote:
>>> Le 07/04/2016 18:42, Chris Pavlina a écrit :
>>>> On Thu, Apr 07, 2016 at 06:36:40PM +0200, jp charras wrote:
>>>>> Le 07/04/2016 17:52, Wayne Stambaugh a écrit :
>>>>>> On 4/7/2016 9:47 AM, Chris Pavlina wrote:
>>>>>>> Hi all,
>>>>>>> 
>>>>>>> I'm targeting this email primarily at Wayne as versioning and release policy is
>>>>>>> involved.
>>>>>>> 
>>>>>>> We've got a bit of a problem right now. We're currently adding features to the
>>>>>>> pcbnew format - JP just merged rounded-rect pads and has a patch in development
>>>>>>> for custom pads, and I'm looking at a patch to add angled fields. Problem is:
>>>>>> 
>>>>>> JPs rounded rectangle commit is a problem.  I did not have a chance to
>>>>>> review JP's patch.  I would have recommended a file version bump.
>>>>> 
>>>>> It can be done now. This is not too late.
>>>>> Just I need to know if the new version is 5 or 4.1 (adding rounded rect pads is a minor change,
>>>>> because the file format does not change when rounded rect pads are not used)
>>>>> For me, a major change is more when new features are always stored in file, and the file can be
>>>>> never read by older versions.
>>>> 
>>>> The format version isn't an integer? What's the point of minor versions of
>>>> _file formats_? They don't mean anything to end users, they're just for
>>>> comparison...
>>>> 
>>> 
>>> Because it is not yet used, it can be what we want (what we prefer).
>>> 
>>> We can use only an integer or use (like many other version id) or a notation like x.y
>>> Something like
>>> * when x changes, the file is no more readable by older versions
>>> * when y changes, the file can be readable by older versions if the new feature is not used
>>> 
>>> This is just for us, poor developers (and yes, also for comparisons), not for users.
>>> 
>>> 
>>> This is just a decision to take (and the corresponding code to write, because it does not exist).
>>> 
>>> -- 
>>> Jean-Pierre CHARRAS
>> 
>> _______________________________________________
>> Mailing list: https://launchpad.net/~kicad-developers
>> Post to     : kicad-developers@xxxxxxxxxxxxxxxxxxx
>> Unsubscribe : https://launchpad.net/~kicad-developers
>> More help   : https://help.launchpad.net/ListHelp
>> 
> 
> _______________________________________________
> Mailing list: https://launchpad.net/~kicad-developers
> Post to     : kicad-developers@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~kicad-developers
> More help   : https://help.launchpad.net/ListHelp



References