← Back to team overview

kicad-developers team mailing list archive

Re: New pcbnew features and versioning

 

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
> 


Follow ups

References