[libvirt] [PATCH v2 2/4] news: Introduce rules for the schema file and fix offending lines

Add stricter rules for the news file and fix offending entries. --- docs/news.xml | 39 ++++++++++++++++++++++++++------------- 1 file changed, 26 insertions(+), 13 deletions(-) diff --git a/docs/news.xml b/docs/news.xml index b2e21efca..5115cb1ab 100644 --- a/docs/news.xml +++ b/docs/news.xml @@ -5,9 +5,18 @@ This file will be processed to produce both HTML and plain text versions of the release notes. - Keep the style consistent with existing entries as much as possible: - each change should be documented by a short, one-sentence summary - and optionally a description where it's explained in more detail --> + Keep the style consistent with existing entries as much as possible. + + Each change should be documented by a short, one-sentence summary, which + should fit in a single line and should not contain any formatting tags. + + You can optionally add a description if you feel like the summary alone is + not enough to document the change accurately. The description may contain + a <code> tag for switching to non-proportional font. No other tags are + allowed. + + Lines should be kept under 80 columns, and should not exceed 100 columns. + --> <libvirt> <release version="v3.2.0" date="unreleased"> @@ -380,7 +389,7 @@ </change> <change> <summary> - nss: Introduce <code>libvirt_guest</code> + nss: Introduce libvirt_guest </summary> <description> New <code>libvirt_guest</code> nss module that translates libvirt @@ -640,7 +649,7 @@ <description> The new libssh transport allows one to connect to a running libvirtd via SSH, using the libssh library; for example: - <tt>qemu+libssh://<i>server</i>/system</tt>. + <code>qemu+libssh://server/system</code>. </description> </change> <change> @@ -654,17 +663,22 @@ </change> <change> <summary> - qemu: Users can now enable debug logging for native gluster - volumes in qemu using the "gluster_debug_level" option in qemu.conf + Allow debugging of gluster volumes in qemu </summary> + <description> + Users can now enable debug logging for native gluster + volumes in qemu using the "gluster_debug_level" option in qemu.conf + </description> </change> <change> <summary> - memory hotplug: Slot numbers for memory devices are now - automatically allocated and thus persistent. In addition slot numbers - can be specified without providing a base address, which simplifies - user configuration + Pre-allocate memory slots for memory hotplug </summary> + <description> + Slot numbers for memory devices are now automatically allocated and + thus persistent. In addition slot numbers can be specified without + providing a base address, which simplifies user configuration + </description> </change> <change> <summary> @@ -694,8 +708,7 @@ </change> <change> <summary> - virsh: Add support for passing an alternative persistent XML - to migrate command + virsh: Add support for passing an alternative persistent XML to migrate command </summary> </change> <change> -- 2.12.1