[libvirt] [PATCH v3 13/13] docs: Update news.xml with vbox changes.

[Dawid Zamirski]

---
 docs/news.xml | 74 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 74 insertions(+)

diff --git a/docs/news.xml b/docs/news.xml
index ef855d895..454c63d8b 100644
--- a/docs/news.xml
+++ b/docs/news.xml
@@ -37,8 +37,82 @@
     <section title="New features">
     </section>
     <section title="Improvements">
+      <change>
+        <summary>
+          vbox: Add support for configuring storage controllers
+        </summary>
+        <description>
+          The VirtualBox driver now supports the <code><controller></code>
+          element in the domain XML for configuring storage controllers in VBOX
+          VMs.  Additionally, libvirt's domain XML schema was updated to allow
+          optional <code>model</code> attribute for <code><controller
+              type='ide'></code> which is used by the VBOX driver to set the
+          IDE controller model to be one of 'piix4', 'piix4' (default), or
+          'ich6'.  Finally, with this change <code>dumpxml</code> generates
+          <code><controller></code> elements that correspond to current
+          VBOX VM storage controller configuration.
+        </description>
+      </change>
+      <change>
+        <summary>
+          vbox: Add support for attaching empty removable disks
+        </summary>
+        <description>
+          The VirutalBox driver now supports adding CD-ROM and floppy disk
+          devices that do not have the disk source specified. Previously such
+          devices were silently ignored.
+        </description>
+      </change>
+      <change>
+        <summary>
+          vbox: Add support for attaching SAS storage controllers
+        </summary>
+        <description>
+          In VirtualBox, SCSI and SAS are distinct controller types whereas
+          libvirt does not make such distinction. Therefore, the VBOX driver was
+          updated to allow attaching SAS controllers via <code><controller
+              type='scsi' model='lsisas1068'></code> element. If there are
+          both SCSI and SAS controllers present in the VBOX VM, the domain XML
+          can associate the disk device using the <code><address></code>
+          element with the <code>controller</code> attribute, and optionally,
+          set the port via <code>unit</code> attribute.
+        </description>
+      </change>
     </section>
     <section title="Bug fixes">
+      <change>
+        <summary>
+          vbox: Do not ignore failures to attach disk devices when defining
+        </summary>
+        <description>
+          The <code>define</code> now fails and reports an error if any of the
+          <code>controller</code> or <code>disk</code> devices specified in the
+          domain XML fail to attach to the VirtualBox VM.
+        </description>
+      </change>
+      <change>
+        <summary>
+          vbox: Fix <code>dumpxml</code> to always output disk devices 
+        </summary>
+        <description>
+          The VirtualBox driver was ignoring any disk devices in
+          <code>dumpxml</code> output if there was a SAS storage controller
+          attached to the VM.
+        </description>
+      </change>
+      <change>
+        <summary>
+          vbox: Fix <code>dumpxml</code> to always generate valid domain XML
+        </summary>
+        <description>
+          When a VirtualBox VM has multiple disks attached, each to a different
+          storage controller that uses 'sd' prefix for block device names e.g.
+          one disk attached to SATA and one to SCSI controller, it no longer
+          generates XML where both would have 'sda' device name assigned.
+          Instead it properly assigns 'sda' and 'sdb' to those disks in the
+          order of appearance.
+        </description>
+      </change>
     </section>
   </release>
   <release version="v3.9.0" date="2017-11-02">
-- 
2.14.3