[PATCH] NEWS: Announcing Network Metadata APIs

K Shiva Kiran posted 1 patch 8 months, 1 week ago
Patches applied successfully (tree, apply log)
git fetch https://github.com/patchew-project/libvirt tags/patchew/20230825153929.7258-1-shiva._5Fkr@riseup.net
There is a newer version of this series
NEWS.rst | 26 ++++++++++++++++++++++++++
1 file changed, 26 insertions(+)
[PATCH] NEWS: Announcing Network Metadata APIs
Posted by K Shiva Kiran 8 months, 1 week ago
Ref to patchset implementing the above:
https://listman.redhat.com/archives/libvir-list/2023-August/241250.html

Signed-off-by: K Shiva Kiran <shiva_kr@riseup.net>
---
 NEWS.rst | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/NEWS.rst b/NEWS.rst
index 73571f0019..01df22ef03 100644
--- a/NEWS.rst
+++ b/NEWS.rst
@@ -17,6 +17,32 @@ v9.7.0 (unreleased)
 
 * **New features**
 
+  * network: Support for `<title>` and `<metadata>` fields in Network XML
+
+    The `<title>` attribute can hold a short title defined by the user
+    and cannot contain newlines.
+    The `<description>` attribute holds any documentation that the user
+    wants to store.
+
+  * network: Support to view and modify User defined metadata
+
+    Two new APIs `virNetworkGetMetadata()` and `virNetworkSetMetadata()`
+    have been introduced. These allow users to view and modify the
+    contents of `<title>`, `<description>` and `<metadata>`.
+
+  * virsh: Introduces new commands `net-desc` and `net-metadata`
+
+    `net-desc` can be used to view and modify the Network's title and
+    description attributes.
+    `net-metadata` can be used to define or modify the custom metadata
+    attribute of the Network object.
+
+  * virsh: Adds `--title` option to the `net-list` command
+
+    This option prints the <title> attribute of the network in
+    an extra column. This option is usable only with the default
+    `--table` output.
+
 * **Improvements**
 
 * **Bug fixes**
-- 
2.42.0
Re: [PATCH] NEWS: Announcing Network Metadata APIs
Posted by Peter Krempa 8 months, 1 week ago
On Fri, Aug 25, 2023 at 21:09:27 +0530, K Shiva Kiran wrote:
> Ref to patchset implementing the above:
> https://listman.redhat.com/archives/libvir-list/2023-August/241250.html
> 
> Signed-off-by: K Shiva Kiran <shiva_kr@riseup.net>
> ---
>  NEWS.rst | 26 ++++++++++++++++++++++++++
>  1 file changed, 26 insertions(+)
> 
> diff --git a/NEWS.rst b/NEWS.rst
> index 73571f0019..01df22ef03 100644
> --- a/NEWS.rst
> +++ b/NEWS.rst
> @@ -17,6 +17,32 @@ v9.7.0 (unreleased)
>  
>  * **New features**
>  
> +  * network: Support for `<title>` and `<metadata>` fields in Network XML
> +
> +    The `<title>` attribute can hold a short title defined by the user
> +    and cannot contain newlines.
> +    The `<description>` attribute holds any documentation that the user
> +    wants to store.
> +
> +  * network: Support to view and modify User defined metadata
> +
> +    Two new APIs `virNetworkGetMetadata()` and `virNetworkSetMetadata()`
> +    have been introduced. These allow users to view and modify the
> +    contents of `<title>`, `<description>` and `<metadata>`.
> +
> +  * virsh: Introduces new commands `net-desc` and `net-metadata`
> +
> +    `net-desc` can be used to view and modify the Network's title and
> +    description attributes.
> +    `net-metadata` can be used to define or modify the custom metadata
> +    attribute of the Network object.
> +
> +  * virsh: Adds `--title` option to the `net-list` command
> +
> +    This option prints the <title> attribute of the network in
> +    an extra column. This option is usable only with the default
> +    `--table` output.

All of the above are really about a single feature. I don't have a
problem mentioning all the changed things although it can be shortened a
bit, but you don't need 4 setions in the NEWS file for all of it.