diff mbox

[3/3] update version number from v1.4.1.0 to v1.5.0.0

Message ID 1448916225-28610-3-git-send-email-mike.holmes@linaro.org
State Superseded
Headers show

Commit Message

Mike Holmes Nov. 30, 2015, 8:43 p.m. UTC
Signed-off-by: Mike Holmes <mike.holmes@linaro.org>
---
 CHANGELOG                 | 34 ++++++++++++++++++++++++++++++++++
 include/odp/api/version.h |  4 ++--
 pkg/debian/changelog      |  5 +++++
 pkg/rpm/odp.spec          |  2 ++
 4 files changed, 43 insertions(+), 2 deletions(-)

Comments

Maxim Uvarov Dec. 1, 2015, 1:45 p.m. UTC | #1
On 11/30/2015 23:43, Mike Holmes wrote:
> Signed-off-by: Mike Holmes <mike.holmes@linaro.org>
> ---
>   CHANGELOG                 | 34 ++++++++++++++++++++++++++++++++++
>   include/odp/api/version.h |  4 ++--
>   pkg/debian/changelog      |  5 +++++
>   pkg/rpm/odp.spec          |  2 ++
>   4 files changed, 43 insertions(+), 2 deletions(-)
>
> diff --git a/CHANGELOG b/CHANGELOG
> index cd8c387..89966a9 100644
> --- a/CHANGELOG
> +++ b/CHANGELOG
> @@ -1,3 +1,37 @@
> +opendataplane (1.5.0.0)
> +   * API:
> +       - api: buffer: add functions to alloc/free multiple buffers at once
> +       - api: cpu: change order of arguments for diff function
> +       - api: crypto: add AES128-CBC encrypt/decrypt methods
> +       - api: crypto: add HMAC-SHA-256-128 support
> +       - api: crypto: move enums from platform types to odp and rename to fit the API format
> +       - api: packet: add functions to alloc/free multiple packets at once
> +       - api: queue: add odp_queue_info() function to retrieve queue information
> +       - api: time: change order of arguments for diff function
> +       - api: time: unbind CPU cycles from time API
> +   * Validation
> +       - performance: odp_pktio_perf: fix potential overflow in wait loop
> +       - test/example: avoid "cycle" word usage
> +       - ability to specify test install directory
> +       - buffer: add tests for buffer alloc/free multi functions
> +       - crypto: add test for AES128 CBC
> +       - crypto: add test for HMAC-SHA-256-128
> +       - crypto: limit packet size to maximum supported by platform
> +       - packet: add tests for packet alloc/free multi functions
> +       - queue: api validation tests for odp_queue_info()
> +       - remove strict dependency on CUnit 2.1-3
> +       - scheduler: add missing ticketlock unlock
> +   * General:
> +       - rpm packaging support
> +       - linux-generic: config: increase ODP_CONFIG_SCHED_GRPS to 256
> +       - linux-generic: cpumask: warn that CPU0 is used by control and worker thread
> +       - linux-generic: packet: add implementation for packet alloc/free multi
> +       - linux-generic: pool: add buffer_alloc_multi function
> +       - linux-generic: pool: add implementation for buffer alloc/free multi
> +       - linux-generic: queue: add odp_queue_info() function
> +       - linux-generic: validation: add run-test script for post install testing
> +       - platform: move list of API files to Makefile.inc so it is common to all platforms
> +
>   opendataplane (1.4.1.0)
>      * Validation
>          - pktio: test transmit error recovery
> diff --git a/include/odp/api/version.h b/include/odp/api/version.h
> index 8912177..58bb7ec 100644
> --- a/include/odp/api/version.h
> +++ b/include/odp/api/version.h
> @@ -37,7 +37,7 @@ extern "C" {
>    * Introduction of major new features or changes. APIs with different major
>    * versions are likely not backward compatible.
>    */
> -#define ODP_VERSION_API_MAJOR 4
> +#define ODP_VERSION_API_MAJOR 5
>   
>   /**
>    * ODP API minor version
> @@ -46,7 +46,7 @@ extern "C" {
>    * to the API. For an API with common generation and major version, but with
>    * different minor numbers the two versions are backward compatible.
>    */
> -#define ODP_VERSION_API_MINOR 1
> +#define ODP_VERSION_API_MINOR 0
>   
>   /**
>    * Returns ODP API version string
> diff --git a/pkg/debian/changelog b/pkg/debian/changelog
> index 1983a9a..7680cf1 100644
> --- a/pkg/debian/changelog
> +++ b/pkg/debian/changelog
> @@ -1,3 +1,8 @@
> +opendataplane (1.5.0.0-1) unstable; urgency=low
> +   * ODP release v1.5
> +
> + -- Maxim Uvarov <maxim.uvarov@linaro.org>  Mon, 30 Nov 2015 13:08:43 +0300
> +
>   opendataplane (1.4.1.0-1) unstable; urgency=low
>      * Validation
>          - pktio: test transmit error recovery
> diff --git a/pkg/rpm/odp.spec b/pkg/rpm/odp.spec
> index aa57476..e76fe58 100644
> --- a/pkg/rpm/odp.spec
> +++ b/pkg/rpm/odp.spec
> @@ -68,5 +68,7 @@ and guides in HTMLformats.
>   %post -p /sbin/ldconfig
>   %postun -p /sbin/ldconfig
>   %changelog
> +* Mon Nov 30 2015 - mike.holmes (at) linaro.org
> +- ODP release v1.5
>   * Tue Nov 10 2015 - anders.roxell (at) linaro.org
>   - Initial rpm release, ODP release v1.4
In RPM that lines also needed to be updated:
Version: 1.4
Release: 1

Moving change log to some common place is good thing. But if that 
packages needs directly go to distributive (debian or redhat),
than packages also have to have readable logs. If we provide it only as 
template and distributives will add their own changelogs
for packages (which is likely), than we can skip logs in .rpm and .deb 
and just update version on ./bootstrap stage.

Also CHANGELOG file has to be packaged, i.e. it has to be added to 
Makefile.am.

Maxim.
Mike Holmes Dec. 1, 2015, 1:58 p.m. UTC | #2
On 1 December 2015 at 08:45, Maxim Uvarov <maxim.uvarov@linaro.org> wrote:

> On 11/30/2015 23:43, Mike Holmes wrote:

>

>> Signed-off-by: Mike Holmes <mike.holmes@linaro.org>

>> ---

>>   CHANGELOG                 | 34 ++++++++++++++++++++++++++++++++++

>>   include/odp/api/version.h |  4 ++--

>>   pkg/debian/changelog      |  5 +++++

>>   pkg/rpm/odp.spec          |  2 ++

>>   4 files changed, 43 insertions(+), 2 deletions(-)

>>

>> diff --git a/CHANGELOG b/CHANGELOG

>> index cd8c387..89966a9 100644

>> --- a/CHANGELOG

>> +++ b/CHANGELOG

>> @@ -1,3 +1,37 @@

>> +opendataplane (1.5.0.0)

>> +   * API:

>> +       - api: buffer: add functions to alloc/free multiple buffers at

>> once

>> +       - api: cpu: change order of arguments for diff function

>> +       - api: crypto: add AES128-CBC encrypt/decrypt methods

>> +       - api: crypto: add HMAC-SHA-256-128 support

>> +       - api: crypto: move enums from platform types to odp and rename

>> to fit the API format

>> +       - api: packet: add functions to alloc/free multiple packets at

>> once

>> +       - api: queue: add odp_queue_info() function to retrieve queue

>> information

>> +       - api: time: change order of arguments for diff function

>> +       - api: time: unbind CPU cycles from time API

>> +   * Validation

>> +       - performance: odp_pktio_perf: fix potential overflow in wait loop

>> +       - test/example: avoid "cycle" word usage

>> +       - ability to specify test install directory

>> +       - buffer: add tests for buffer alloc/free multi functions

>> +       - crypto: add test for AES128 CBC

>> +       - crypto: add test for HMAC-SHA-256-128

>> +       - crypto: limit packet size to maximum supported by platform

>> +       - packet: add tests for packet alloc/free multi functions

>> +       - queue: api validation tests for odp_queue_info()

>> +       - remove strict dependency on CUnit 2.1-3

>> +       - scheduler: add missing ticketlock unlock

>> +   * General:

>> +       - rpm packaging support

>> +       - linux-generic: config: increase ODP_CONFIG_SCHED_GRPS to 256

>> +       - linux-generic: cpumask: warn that CPU0 is used by control and

>> worker thread

>> +       - linux-generic: packet: add implementation for packet alloc/free

>> multi

>> +       - linux-generic: pool: add buffer_alloc_multi function

>> +       - linux-generic: pool: add implementation for buffer alloc/free

>> multi

>> +       - linux-generic: queue: add odp_queue_info() function

>> +       - linux-generic: validation: add run-test script for post install

>> testing

>> +       - platform: move list of API files to Makefile.inc so it is

>> common to all platforms

>> +

>>   opendataplane (1.4.1.0)

>>      * Validation

>>          - pktio: test transmit error recovery

>> diff --git a/include/odp/api/version.h b/include/odp/api/version.h

>> index 8912177..58bb7ec 100644

>> --- a/include/odp/api/version.h

>> +++ b/include/odp/api/version.h

>> @@ -37,7 +37,7 @@ extern "C" {

>>    * Introduction of major new features or changes. APIs with different

>> major

>>    * versions are likely not backward compatible.

>>    */

>> -#define ODP_VERSION_API_MAJOR 4

>> +#define ODP_VERSION_API_MAJOR 5

>>     /**

>>    * ODP API minor version

>> @@ -46,7 +46,7 @@ extern "C" {

>>    * to the API. For an API with common generation and major version, but

>> with

>>    * different minor numbers the two versions are backward compatible.

>>    */

>> -#define ODP_VERSION_API_MINOR 1

>> +#define ODP_VERSION_API_MINOR 0

>>     /**

>>    * Returns ODP API version string

>> diff --git a/pkg/debian/changelog b/pkg/debian/changelog

>> index 1983a9a..7680cf1 100644

>> --- a/pkg/debian/changelog

>> +++ b/pkg/debian/changelog

>> @@ -1,3 +1,8 @@

>> +opendataplane (1.5.0.0-1) unstable; urgency=low

>> +   * ODP release v1.5

>> +

>> + -- Maxim Uvarov <maxim.uvarov@linaro.org>  Mon, 30 Nov 2015 13:08:43

>> +0300

>> +

>>   opendataplane (1.4.1.0-1) unstable; urgency=low

>>      * Validation

>>          - pktio: test transmit error recovery

>> diff --git a/pkg/rpm/odp.spec b/pkg/rpm/odp.spec

>> index aa57476..e76fe58 100644

>> --- a/pkg/rpm/odp.spec

>> +++ b/pkg/rpm/odp.spec

>> @@ -68,5 +68,7 @@ and guides in HTMLformats.

>>   %post -p /sbin/ldconfig

>>   %postun -p /sbin/ldconfig

>>   %changelog

>> +* Mon Nov 30 2015 - mike.holmes (at) linaro.org

>> +- ODP release v1.5

>>   * Tue Nov 10 2015 - anders.roxell (at) linaro.org

>>   - Initial rpm release, ODP release v1.4

>>

> In RPM that lines also needed to be updated:

> Version: 1.4

> Release: 1

>


Yes, that is a mistake, please update it when you make the actual release


>

> Moving change log to some common place is good thing. But if that packages

> needs directly go to distributive (debian or redhat),

> than packages also have to have readable logs.



I have CC'ed Fathi as I believe the new approach is the correct one driven
by his guidance. The package logs  have the change to the package listed
and the API changes etc are in their own log.


> If we provide it only as template and distributives will add their own

> changelogs

> for packages (which is likely), than we can skip logs in .rpm and .deb and

> just update version on ./bootstrap stage.

>


I dont know enough, Anders can you comment ?


>

> Also CHANGELOG file has to be packaged, i.e. it has to be added to

> Makefile.am.

>


I was not aware of that, thanks, please fix it when you make the release.


>

> Maxim.

>

>

>

>

>

> _______________________________________________

> lng-odp mailing list

> lng-odp@lists.linaro.org

> https://lists.linaro.org/mailman/listinfo/lng-odp

>




-- 
Mike Holmes
Technical Manager - Linaro Networking Group
Linaro.org <http://www.linaro.org/> *│ *Open source software for ARM SoCs
Bill Fischofer Dec. 1, 2015, 2:48 p.m. UTC | #3
Shouldn't the update log also mention the improved documentation as well?

On Tue, Dec 1, 2015 at 7:58 AM, Mike Holmes <mike.holmes@linaro.org> wrote:

>

>

> On 1 December 2015 at 08:45, Maxim Uvarov <maxim.uvarov@linaro.org> wrote:

>

>> On 11/30/2015 23:43, Mike Holmes wrote:

>>

>>> Signed-off-by: Mike Holmes <mike.holmes@linaro.org>

>>> ---

>>>   CHANGELOG                 | 34 ++++++++++++++++++++++++++++++++++

>>>   include/odp/api/version.h |  4 ++--

>>>   pkg/debian/changelog      |  5 +++++

>>>   pkg/rpm/odp.spec          |  2 ++

>>>   4 files changed, 43 insertions(+), 2 deletions(-)

>>>

>>> diff --git a/CHANGELOG b/CHANGELOG

>>> index cd8c387..89966a9 100644

>>> --- a/CHANGELOG

>>> +++ b/CHANGELOG

>>> @@ -1,3 +1,37 @@

>>> +opendataplane (1.5.0.0)

>>> +   * API:

>>> +       - api: buffer: add functions to alloc/free multiple buffers at

>>> once

>>> +       - api: cpu: change order of arguments for diff function

>>> +       - api: crypto: add AES128-CBC encrypt/decrypt methods

>>> +       - api: crypto: add HMAC-SHA-256-128 support

>>> +       - api: crypto: move enums from platform types to odp and rename

>>> to fit the API format

>>> +       - api: packet: add functions to alloc/free multiple packets at

>>> once

>>> +       - api: queue: add odp_queue_info() function to retrieve queue

>>> information

>>> +       - api: time: change order of arguments for diff function

>>> +       - api: time: unbind CPU cycles from time API

>>> +   * Validation

>>> +       - performance: odp_pktio_perf: fix potential overflow in wait

>>> loop

>>> +       - test/example: avoid "cycle" word usage

>>> +       - ability to specify test install directory

>>> +       - buffer: add tests for buffer alloc/free multi functions

>>> +       - crypto: add test for AES128 CBC

>>> +       - crypto: add test for HMAC-SHA-256-128

>>> +       - crypto: limit packet size to maximum supported by platform

>>> +       - packet: add tests for packet alloc/free multi functions

>>> +       - queue: api validation tests for odp_queue_info()

>>> +       - remove strict dependency on CUnit 2.1-3

>>> +       - scheduler: add missing ticketlock unlock

>>> +   * General:

>>> +       - rpm packaging support

>>> +       - linux-generic: config: increase ODP_CONFIG_SCHED_GRPS to 256

>>> +       - linux-generic: cpumask: warn that CPU0 is used by control and

>>> worker thread

>>> +       - linux-generic: packet: add implementation for packet

>>> alloc/free multi

>>> +       - linux-generic: pool: add buffer_alloc_multi function

>>> +       - linux-generic: pool: add implementation for buffer alloc/free

>>> multi

>>> +       - linux-generic: queue: add odp_queue_info() function

>>> +       - linux-generic: validation: add run-test script for post

>>> install testing

>>> +       - platform: move list of API files to Makefile.inc so it is

>>> common to all platforms

>>> +

>>>   opendataplane (1.4.1.0)

>>>      * Validation

>>>          - pktio: test transmit error recovery

>>> diff --git a/include/odp/api/version.h b/include/odp/api/version.h

>>> index 8912177..58bb7ec 100644

>>> --- a/include/odp/api/version.h

>>> +++ b/include/odp/api/version.h

>>> @@ -37,7 +37,7 @@ extern "C" {

>>>    * Introduction of major new features or changes. APIs with different

>>> major

>>>    * versions are likely not backward compatible.

>>>    */

>>> -#define ODP_VERSION_API_MAJOR 4

>>> +#define ODP_VERSION_API_MAJOR 5

>>>     /**

>>>    * ODP API minor version

>>> @@ -46,7 +46,7 @@ extern "C" {

>>>    * to the API. For an API with common generation and major version,

>>> but with

>>>    * different minor numbers the two versions are backward compatible.

>>>    */

>>> -#define ODP_VERSION_API_MINOR 1

>>> +#define ODP_VERSION_API_MINOR 0

>>>     /**

>>>    * Returns ODP API version string

>>> diff --git a/pkg/debian/changelog b/pkg/debian/changelog

>>> index 1983a9a..7680cf1 100644

>>> --- a/pkg/debian/changelog

>>> +++ b/pkg/debian/changelog

>>> @@ -1,3 +1,8 @@

>>> +opendataplane (1.5.0.0-1) unstable; urgency=low

>>> +   * ODP release v1.5

>>> +

>>> + -- Maxim Uvarov <maxim.uvarov@linaro.org>  Mon, 30 Nov 2015 13:08:43

>>> +0300

>>> +

>>>   opendataplane (1.4.1.0-1) unstable; urgency=low

>>>      * Validation

>>>          - pktio: test transmit error recovery

>>> diff --git a/pkg/rpm/odp.spec b/pkg/rpm/odp.spec

>>> index aa57476..e76fe58 100644

>>> --- a/pkg/rpm/odp.spec

>>> +++ b/pkg/rpm/odp.spec

>>> @@ -68,5 +68,7 @@ and guides in HTMLformats.

>>>   %post -p /sbin/ldconfig

>>>   %postun -p /sbin/ldconfig

>>>   %changelog

>>> +* Mon Nov 30 2015 - mike.holmes (at) linaro.org

>>> +- ODP release v1.5

>>>   * Tue Nov 10 2015 - anders.roxell (at) linaro.org

>>>   - Initial rpm release, ODP release v1.4

>>>

>> In RPM that lines also needed to be updated:

>> Version: 1.4

>> Release: 1

>>

>

> Yes, that is a mistake, please update it when you make the actual release

>

>

>>

>> Moving change log to some common place is good thing. But if that

>> packages needs directly go to distributive (debian or redhat),

>> than packages also have to have readable logs.

>

>

> I have CC'ed Fathi as I believe the new approach is the correct one driven

> by his guidance. The package logs  have the change to the package listed

> and the API changes etc are in their own log.

>

>

>> If we provide it only as template and distributives will add their own

>> changelogs

>> for packages (which is likely), than we can skip logs in .rpm and .deb

>> and just update version on ./bootstrap stage.

>>

>

> I dont know enough, Anders can you comment ?

>

>

>>

>> Also CHANGELOG file has to be packaged, i.e. it has to be added to

>> Makefile.am.

>>

>

> I was not aware of that, thanks, please fix it when you make the release.

>

>

>>

>> Maxim.

>>

>>

>>

>>

>>

>> _______________________________________________

>> lng-odp mailing list

>> lng-odp@lists.linaro.org

>> https://lists.linaro.org/mailman/listinfo/lng-odp

>>

>

>

>

> --

> Mike Holmes

> Technical Manager - Linaro Networking Group

> Linaro.org <http://www.linaro.org/> *│ *Open source software for ARM SoCs

>

>

>

> _______________________________________________

> lng-odp mailing list

> lng-odp@lists.linaro.org

> https://lists.linaro.org/mailman/listinfo/lng-odp

>

>
Fathi Boudra Dec. 1, 2015, 3:03 p.m. UTC | #4
On 1 December 2015 at 15:58, Mike Holmes <mike.holmes@linaro.org> wrote:
>
>
> On 1 December 2015 at 08:45, Maxim Uvarov <maxim.uvarov@linaro.org> wrote:
>>
>> On 11/30/2015 23:43, Mike Holmes wrote:
>>>
>>> Signed-off-by: Mike Holmes <mike.holmes@linaro.org>
>>> ---
>>>   CHANGELOG                 | 34 ++++++++++++++++++++++++++++++++++
>>>   include/odp/api/version.h |  4 ++--
>>>   pkg/debian/changelog      |  5 +++++
>>>   pkg/rpm/odp.spec          |  2 ++
>>>   4 files changed, 43 insertions(+), 2 deletions(-)
>>>
>>> diff --git a/CHANGELOG b/CHANGELOG
>>> index cd8c387..89966a9 100644
>>> --- a/CHANGELOG
>>> +++ b/CHANGELOG
>>> @@ -1,3 +1,37 @@
>>> +opendataplane (1.5.0.0)
>>> +   * API:
>>> +       - api: buffer: add functions to alloc/free multiple buffers at
>>> once
>>> +       - api: cpu: change order of arguments for diff function
>>> +       - api: crypto: add AES128-CBC encrypt/decrypt methods
>>> +       - api: crypto: add HMAC-SHA-256-128 support
>>> +       - api: crypto: move enums from platform types to odp and rename
>>> to fit the API format
>>> +       - api: packet: add functions to alloc/free multiple packets at
>>> once
>>> +       - api: queue: add odp_queue_info() function to retrieve queue
>>> information
>>> +       - api: time: change order of arguments for diff function
>>> +       - api: time: unbind CPU cycles from time API
>>> +   * Validation
>>> +       - performance: odp_pktio_perf: fix potential overflow in wait
>>> loop
>>> +       - test/example: avoid "cycle" word usage
>>> +       - ability to specify test install directory
>>> +       - buffer: add tests for buffer alloc/free multi functions
>>> +       - crypto: add test for AES128 CBC
>>> +       - crypto: add test for HMAC-SHA-256-128
>>> +       - crypto: limit packet size to maximum supported by platform
>>> +       - packet: add tests for packet alloc/free multi functions
>>> +       - queue: api validation tests for odp_queue_info()
>>> +       - remove strict dependency on CUnit 2.1-3
>>> +       - scheduler: add missing ticketlock unlock
>>> +   * General:
>>> +       - rpm packaging support
>>> +       - linux-generic: config: increase ODP_CONFIG_SCHED_GRPS to 256
>>> +       - linux-generic: cpumask: warn that CPU0 is used by control and
>>> worker thread
>>> +       - linux-generic: packet: add implementation for packet alloc/free
>>> multi
>>> +       - linux-generic: pool: add buffer_alloc_multi function
>>> +       - linux-generic: pool: add implementation for buffer alloc/free
>>> multi
>>> +       - linux-generic: queue: add odp_queue_info() function
>>> +       - linux-generic: validation: add run-test script for post install
>>> testing
>>> +       - platform: move list of API files to Makefile.inc so it is
>>> common to all platforms
>>> +
>>>   opendataplane (1.4.1.0)
>>>      * Validation
>>>          - pktio: test transmit error recovery
>>> diff --git a/include/odp/api/version.h b/include/odp/api/version.h
>>> index 8912177..58bb7ec 100644
>>> --- a/include/odp/api/version.h
>>> +++ b/include/odp/api/version.h
>>> @@ -37,7 +37,7 @@ extern "C" {
>>>    * Introduction of major new features or changes. APIs with different
>>> major
>>>    * versions are likely not backward compatible.
>>>    */
>>> -#define ODP_VERSION_API_MAJOR 4
>>> +#define ODP_VERSION_API_MAJOR 5
>>>     /**
>>>    * ODP API minor version
>>> @@ -46,7 +46,7 @@ extern "C" {
>>>    * to the API. For an API with common generation and major version, but
>>> with
>>>    * different minor numbers the two versions are backward compatible.
>>>    */
>>> -#define ODP_VERSION_API_MINOR 1
>>> +#define ODP_VERSION_API_MINOR 0
>>>     /**
>>>    * Returns ODP API version string
>>> diff --git a/pkg/debian/changelog b/pkg/debian/changelog
>>> index 1983a9a..7680cf1 100644
>>> --- a/pkg/debian/changelog
>>> +++ b/pkg/debian/changelog
>>> @@ -1,3 +1,8 @@
>>> +opendataplane (1.5.0.0-1) unstable; urgency=low
>>> +   * ODP release v1.5
>>> +
>>> + -- Maxim Uvarov <maxim.uvarov@linaro.org>  Mon, 30 Nov 2015 13:08:43
>>> +0300
>>> +
>>>   opendataplane (1.4.1.0-1) unstable; urgency=low
>>>      * Validation
>>>          - pktio: test transmit error recovery
>>> diff --git a/pkg/rpm/odp.spec b/pkg/rpm/odp.spec
>>> index aa57476..e76fe58 100644
>>> --- a/pkg/rpm/odp.spec
>>> +++ b/pkg/rpm/odp.spec
>>> @@ -68,5 +68,7 @@ and guides in HTMLformats.
>>>   %post -p /sbin/ldconfig
>>>   %postun -p /sbin/ldconfig
>>>   %changelog
>>> +* Mon Nov 30 2015 - mike.holmes (at) linaro.org
>>> +- ODP release v1.5
>>>   * Tue Nov 10 2015 - anders.roxell (at) linaro.org
>>>   - Initial rpm release, ODP release v1.4
>>
>> In RPM that lines also needed to be updated:
>> Version: 1.4
>> Release: 1
>
>
> Yes, that is a mistake, please update it when you make the actual release
>
>>
>>
>> Moving change log to some common place is good thing. But if that packages
>> needs directly go to distributive (debian or redhat),
>> than packages also have to have readable logs.
>
>
> I have CC'ed Fathi as I believe the new approach is the correct one driven
> by his guidance. The package logs  have the change to the package listed and
> the API changes etc are in their own log.

Package changelog documents only the package related changes.
ODP changelog documents ODP changes.
They are separate files.

Both should be shipped as part of the packages.
ODP changelog should be shipped as part of the source tarball.

>> If we provide it only as template and distributives will add their own
>> changelogs
>> for packages (which is likely), than we can skip logs in .rpm and .deb and
>> just update version on ./bootstrap stage.
>
>
> I dont know enough, Anders can you comment ?
>
>>
>>
>> Also CHANGELOG file has to be packaged, i.e. it has to be added to
>> Makefile.am.
>
>
> I was not aware of that, thanks, please fix it when you make the release.
>
>>
>>
>> Maxim.
>>
>>
>>
>>
>>
>> _______________________________________________
>> lng-odp mailing list
>> lng-odp@lists.linaro.org
>> https://lists.linaro.org/mailman/listinfo/lng-odp
>
>
>
>
> --
> Mike Holmes
> Technical Manager - Linaro Networking Group
> Linaro.org │ Open source software for ARM SoCs

Cheers,
Mike Holmes Dec. 1, 2015, 3:03 p.m. UTC | #5
On 1 December 2015 at 09:48, Bill Fischofer <bill.fischofer@linaro.org>
wrote:

> Shouldn't the update log also mention the improved documentation as well?

>


Absolutely, part of this restructure is to allow a place for a human
generated change log.

During 1.6 I expect merged API-NEXT changes to also add an entry to the
CHANGELOG as they merge to next, they will be generated from the excellent
git description for the patch in API-NEXT (please review the description
with this in mind) or a a patch to CHANGELOG directly

In the same vein we can do this for other important work directly applied
to master.
I suspect  that it may be best to make a call on a case by case basis for a
patch to CHANGELOG to be added to  a series so that the change and its
change log items are  reviewed together.


But for 1.5 we were not doing either of those so it is again just a git log.


>

> On Tue, Dec 1, 2015 at 7:58 AM, Mike Holmes <mike.holmes@linaro.org>

> wrote:

>

>>

>>

>> On 1 December 2015 at 08:45, Maxim Uvarov <maxim.uvarov@linaro.org>

>> wrote:

>>

>>> On 11/30/2015 23:43, Mike Holmes wrote:

>>>

>>>> Signed-off-by: Mike Holmes <mike.holmes@linaro.org>

>>>> ---

>>>>   CHANGELOG                 | 34 ++++++++++++++++++++++++++++++++++

>>>>   include/odp/api/version.h |  4 ++--

>>>>   pkg/debian/changelog      |  5 +++++

>>>>   pkg/rpm/odp.spec          |  2 ++

>>>>   4 files changed, 43 insertions(+), 2 deletions(-)

>>>>

>>>> diff --git a/CHANGELOG b/CHANGELOG

>>>> index cd8c387..89966a9 100644

>>>> --- a/CHANGELOG

>>>> +++ b/CHANGELOG

>>>> @@ -1,3 +1,37 @@

>>>> +opendataplane (1.5.0.0)

>>>> +   * API:

>>>> +       - api: buffer: add functions to alloc/free multiple buffers at

>>>> once

>>>> +       - api: cpu: change order of arguments for diff function

>>>> +       - api: crypto: add AES128-CBC encrypt/decrypt methods

>>>> +       - api: crypto: add HMAC-SHA-256-128 support

>>>> +       - api: crypto: move enums from platform types to odp and rename

>>>> to fit the API format

>>>> +       - api: packet: add functions to alloc/free multiple packets at

>>>> once

>>>> +       - api: queue: add odp_queue_info() function to retrieve queue

>>>> information

>>>> +       - api: time: change order of arguments for diff function

>>>> +       - api: time: unbind CPU cycles from time API

>>>> +   * Validation

>>>> +       - performance: odp_pktio_perf: fix potential overflow in wait

>>>> loop

>>>> +       - test/example: avoid "cycle" word usage

>>>> +       - ability to specify test install directory

>>>> +       - buffer: add tests for buffer alloc/free multi functions

>>>> +       - crypto: add test for AES128 CBC

>>>> +       - crypto: add test for HMAC-SHA-256-128

>>>> +       - crypto: limit packet size to maximum supported by platform

>>>> +       - packet: add tests for packet alloc/free multi functions

>>>> +       - queue: api validation tests for odp_queue_info()

>>>> +       - remove strict dependency on CUnit 2.1-3

>>>> +       - scheduler: add missing ticketlock unlock

>>>> +   * General:

>>>> +       - rpm packaging support

>>>> +       - linux-generic: config: increase ODP_CONFIG_SCHED_GRPS to 256

>>>> +       - linux-generic: cpumask: warn that CPU0 is used by control and

>>>> worker thread

>>>> +       - linux-generic: packet: add implementation for packet

>>>> alloc/free multi

>>>> +       - linux-generic: pool: add buffer_alloc_multi function

>>>> +       - linux-generic: pool: add implementation for buffer alloc/free

>>>> multi

>>>> +       - linux-generic: queue: add odp_queue_info() function

>>>> +       - linux-generic: validation: add run-test script for post

>>>> install testing

>>>> +       - platform: move list of API files to Makefile.inc so it is

>>>> common to all platforms

>>>> +

>>>>   opendataplane (1.4.1.0)

>>>>      * Validation

>>>>          - pktio: test transmit error recovery

>>>> diff --git a/include/odp/api/version.h b/include/odp/api/version.h

>>>> index 8912177..58bb7ec 100644

>>>> --- a/include/odp/api/version.h

>>>> +++ b/include/odp/api/version.h

>>>> @@ -37,7 +37,7 @@ extern "C" {

>>>>    * Introduction of major new features or changes. APIs with different

>>>> major

>>>>    * versions are likely not backward compatible.

>>>>    */

>>>> -#define ODP_VERSION_API_MAJOR 4

>>>> +#define ODP_VERSION_API_MAJOR 5

>>>>     /**

>>>>    * ODP API minor version

>>>> @@ -46,7 +46,7 @@ extern "C" {

>>>>    * to the API. For an API with common generation and major version,

>>>> but with

>>>>    * different minor numbers the two versions are backward compatible.

>>>>    */

>>>> -#define ODP_VERSION_API_MINOR 1

>>>> +#define ODP_VERSION_API_MINOR 0

>>>>     /**

>>>>    * Returns ODP API version string

>>>> diff --git a/pkg/debian/changelog b/pkg/debian/changelog

>>>> index 1983a9a..7680cf1 100644

>>>> --- a/pkg/debian/changelog

>>>> +++ b/pkg/debian/changelog

>>>> @@ -1,3 +1,8 @@

>>>> +opendataplane (1.5.0.0-1) unstable; urgency=low

>>>> +   * ODP release v1.5

>>>> +

>>>> + -- Maxim Uvarov <maxim.uvarov@linaro.org>  Mon, 30 Nov 2015 13:08:43

>>>> +0300

>>>> +

>>>>   opendataplane (1.4.1.0-1) unstable; urgency=low

>>>>      * Validation

>>>>          - pktio: test transmit error recovery

>>>> diff --git a/pkg/rpm/odp.spec b/pkg/rpm/odp.spec

>>>> index aa57476..e76fe58 100644

>>>> --- a/pkg/rpm/odp.spec

>>>> +++ b/pkg/rpm/odp.spec

>>>> @@ -68,5 +68,7 @@ and guides in HTMLformats.

>>>>   %post -p /sbin/ldconfig

>>>>   %postun -p /sbin/ldconfig

>>>>   %changelog

>>>> +* Mon Nov 30 2015 - mike.holmes (at) linaro.org

>>>> +- ODP release v1.5

>>>>   * Tue Nov 10 2015 - anders.roxell (at) linaro.org

>>>>   - Initial rpm release, ODP release v1.4

>>>>

>>> In RPM that lines also needed to be updated:

>>> Version: 1.4

>>> Release: 1

>>>

>>

>> Yes, that is a mistake, please update it when you make the actual release

>>

>>

>>>

>>> Moving change log to some common place is good thing. But if that

>>> packages needs directly go to distributive (debian or redhat),

>>> than packages also have to have readable logs.

>>

>>

>> I have CC'ed Fathi as I believe the new approach is the correct one

>> driven by his guidance. The package logs  have the change to the package

>> listed and the API changes etc are in their own log.

>>

>>

>>> If we provide it only as template and distributives will add their own

>>> changelogs

>>> for packages (which is likely), than we can skip logs in .rpm and .deb

>>> and just update version on ./bootstrap stage.

>>>

>>

>> I dont know enough, Anders can you comment ?

>>

>>

>>>

>>> Also CHANGELOG file has to be packaged, i.e. it has to be added to

>>> Makefile.am.

>>>

>>

>> I was not aware of that, thanks, please fix it when you make the release.

>>

>>

>>>

>>> Maxim.

>>>

>>>

>>>

>>>

>>>

>>> _______________________________________________

>>> lng-odp mailing list

>>> lng-odp@lists.linaro.org

>>> https://lists.linaro.org/mailman/listinfo/lng-odp

>>>

>>

>>

>>

>> --

>> Mike Holmes

>> Technical Manager - Linaro Networking Group

>> Linaro.org <http://www.linaro.org/> *│ *Open source software for ARM SoCs

>>

>>

>>

>> _______________________________________________

>> lng-odp mailing list

>> lng-odp@lists.linaro.org

>> https://lists.linaro.org/mailman/listinfo/lng-odp

>>

>>

>



-- 
Mike Holmes
Technical Manager - Linaro Networking Group
Linaro.org <http://www.linaro.org/> *│ *Open source software for ARM SoCs
diff mbox

Patch

diff --git a/CHANGELOG b/CHANGELOG
index cd8c387..89966a9 100644
--- a/CHANGELOG
+++ b/CHANGELOG
@@ -1,3 +1,37 @@ 
+opendataplane (1.5.0.0)
+   * API:
+       - api: buffer: add functions to alloc/free multiple buffers at once
+       - api: cpu: change order of arguments for diff function
+       - api: crypto: add AES128-CBC encrypt/decrypt methods
+       - api: crypto: add HMAC-SHA-256-128 support
+       - api: crypto: move enums from platform types to odp and rename to fit the API format
+       - api: packet: add functions to alloc/free multiple packets at once
+       - api: queue: add odp_queue_info() function to retrieve queue information
+       - api: time: change order of arguments for diff function
+       - api: time: unbind CPU cycles from time API
+   * Validation
+       - performance: odp_pktio_perf: fix potential overflow in wait loop
+       - test/example: avoid "cycle" word usage
+       - ability to specify test install directory
+       - buffer: add tests for buffer alloc/free multi functions
+       - crypto: add test for AES128 CBC
+       - crypto: add test for HMAC-SHA-256-128
+       - crypto: limit packet size to maximum supported by platform
+       - packet: add tests for packet alloc/free multi functions
+       - queue: api validation tests for odp_queue_info()
+       - remove strict dependency on CUnit 2.1-3
+       - scheduler: add missing ticketlock unlock
+   * General:
+       - rpm packaging support
+       - linux-generic: config: increase ODP_CONFIG_SCHED_GRPS to 256
+       - linux-generic: cpumask: warn that CPU0 is used by control and worker thread
+       - linux-generic: packet: add implementation for packet alloc/free multi
+       - linux-generic: pool: add buffer_alloc_multi function
+       - linux-generic: pool: add implementation for buffer alloc/free multi
+       - linux-generic: queue: add odp_queue_info() function
+       - linux-generic: validation: add run-test script for post install testing
+       - platform: move list of API files to Makefile.inc so it is common to all platforms
+
 opendataplane (1.4.1.0)
    * Validation
        - pktio: test transmit error recovery
diff --git a/include/odp/api/version.h b/include/odp/api/version.h
index 8912177..58bb7ec 100644
--- a/include/odp/api/version.h
+++ b/include/odp/api/version.h
@@ -37,7 +37,7 @@  extern "C" {
  * Introduction of major new features or changes. APIs with different major
  * versions are likely not backward compatible.
  */
-#define ODP_VERSION_API_MAJOR 4
+#define ODP_VERSION_API_MAJOR 5
 
 /**
  * ODP API minor version
@@ -46,7 +46,7 @@  extern "C" {
  * to the API. For an API with common generation and major version, but with
  * different minor numbers the two versions are backward compatible.
  */
-#define ODP_VERSION_API_MINOR 1
+#define ODP_VERSION_API_MINOR 0
 
 /**
  * Returns ODP API version string
diff --git a/pkg/debian/changelog b/pkg/debian/changelog
index 1983a9a..7680cf1 100644
--- a/pkg/debian/changelog
+++ b/pkg/debian/changelog
@@ -1,3 +1,8 @@ 
+opendataplane (1.5.0.0-1) unstable; urgency=low
+   * ODP release v1.5
+
+ -- Maxim Uvarov <maxim.uvarov@linaro.org>  Mon, 30 Nov 2015 13:08:43 +0300
+
 opendataplane (1.4.1.0-1) unstable; urgency=low
    * Validation
        - pktio: test transmit error recovery
diff --git a/pkg/rpm/odp.spec b/pkg/rpm/odp.spec
index aa57476..e76fe58 100644
--- a/pkg/rpm/odp.spec
+++ b/pkg/rpm/odp.spec
@@ -68,5 +68,7 @@  and guides in HTMLformats.
 %post -p /sbin/ldconfig
 %postun -p /sbin/ldconfig
 %changelog
+* Mon Nov 30 2015 - mike.holmes (at) linaro.org
+- ODP release v1.5
 * Tue Nov 10 2015 - anders.roxell (at) linaro.org
 - Initial rpm release, ODP release v1.4