CMSIS-Pack: /package/releases element

| CMSIS-Pack Version 1.6.3 Delivery Mechanism for Software Packs

- Main Page
- Usage and Description

All Pages
/package/releases element

Contains the release history of the Pack. This element is mandatory. No more than one such group can exist in a Pack. It contains the full release history of the Pack.

Example:

<package>
...
<releases>
...
</releases>
...
</package>

Parent Element | Element Chain
--- | ---
package | /package
Child Element | Description | Type | Occurrence
release | Contains the version number of the release with some brief information about the main changes in that specific release. | xs:string | 1..*

# /package/releases/release

Contains brief information of the main changes in each release version of a Pack. The content is a string written between the opening and closing release tags. The latest release version is always listed on top.

Example:

<releases>
<release version="1.1.1">Fixed a problem with the feature xyz.
</release>
<release version="1.1.0">Introduces a new feature xyz.
</release>
<release version="1.0.0">First published version.
</release>
</releases>

Example for a public repository:

<package>
...
<repository type="git">https://github.com/ARM-software/CMSIS-Driver.git</repository
<releases>
<release version="2.1.0" tag="2.1.0" url="https://github.com/ARM-software/CMSIS-Driver/archive/2.1.0.zip">
Added LAN9220 Ethernet MAC+PHY driver.
</release>
<release version="2.0.0" tag="2.0.0" url="https://github.com/ARM-software/CMSIS-Driver/archive/2.0.0.zip">
First published version.
</release>
</releases>
...
</package>

Parent Element | Element Chain
--- | ---
releases | /package/releases element
Attributes | Description | Type | Use
version | Version number of the release. The version format is described in Version Type. | VersionType | required
date | Release date (specified as YYYY-MM-DD, for example 2014-12-14 (14th December 2014). | xs:date | optional
tag | In case the repository element is specified, the tag attribute is used to specify the repository tag that corresponds to this release of the pack. | xs:string | optional
url | URL specifying the location of the pack of the specified version. This can be used to override the default location being `<url>/<vendor>`.<name>.<version>.pack | xs:anyURI | optional

deprecated

Pack is no longer officially supported after the set date. It will be excluded from checks for update. Deprecated packs may remain available for download from the server. Tools will continue to work but may provide indicators highlighting end of support for the pack and its content. Not recommended for use with new projects. Note this attribute is only relevant when set for the latest release located on top of the releases section.

xs:date

optional

replacement

Specifies the vendor and name of the Pack that shall be used instead. Use in conjunction with the deprecated attribute. E.g. the maintainer of the Pack A.X_DFP changes from vendor A to vendor B. In this case the attribute deprecated gets set in the A.X_DFP.pdsc and the replacement attribute set to B.X_DFP. Tools use this information to redirect users to a supported pack.

xs:string

optional