doc: use DX-friendly names in configuration option documentation

Change the generated config option documentation to use the DX-friendly
names defined for the configurator UI (instead of the XML element name
hierarchy previously used).

Options are grouped by the top-level section (aka complex type) they
belong to and then sorted alphabetically with these groups.

Use badges to indicate where options can be found in the configurator UI
and whether they're applicable to the Hypervisor or Pre/Post/Service VM.
Add a custom css style for the config-option doc that puts the first
paragraph of a glossary item on the same line as the glossary term so
these badges look pretty.

Added a acrn-custom.js patch that copies the alt text for images into a
title property for images within the config-doc document.  This provides
tooltip text when hovering over the badges.

Don't display options not visible in the configurator UI (elements with
acrn:views="").

A missing acrn:views or acrn:applicable-vm means we look for an
applicable value from an ancestor element.

Add processing of a second xs:documentation element within an
xs:annotation element. This second documentation element's content will
be appended as a new paragraph to the first xs:documentation content in
the generated documentation. Only the first xs:documentation element is
used by the Configurator for its tooltips.

Update documents that were referring to options by their XML names.

Because we're now using a glossary to provide links to config options,
we can't duplicate option names or glosary names anywhere in the doc
set.

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>

doc/tutorials/nvmx_virtualization.rst

@@ -124,7 +124,7 @@ with these settings:
 
 #. Configure system level features:
 
-   - Edit :option:`hv.FEATURES.SCHEDULER` to ``SCHED_NOOP`` to disable CPU sharing
+   - Edit ``hv.features.scheduler`` to ``SCHED_NOOP`` to disable CPU sharing
 
      .. code-block:: xml
         :emphasize-lines: 3,18
@@ -150,11 +150,11 @@ with these settings:
 
 #. In each guest VM configuration:
 
-   - Edit :option:`vm.nested_virtualization_support` on the Service VM section and set it to `y`
+   - Edit ``vm.nested_virtualization_support`` on the Service VM section and set it to `y`
      to enable the nested virtualization feature on the Service VM.
-   - Edit :option:`vm.lapic_passthrough` and set it to `y` to enable local
+   - Edit ``vm.lapic_passthrough`` and set it to `y` to enable local
      APIC passthrough on the Service VM.
-   - Edit :option:`vm.cpu_affinity.pcpu_id` to assign ``pCPU`` IDs to run the Service VM. If you are
+   - Edit ``vm.cpu_affinity.pcpu_id`` to assign ``pCPU`` IDs to run the Service VM. If you are
      using debug build and need the hypervisor console, don't assign
      ``pCPU0`` to the Service VM.
 
@@ -179,7 +179,7 @@ with these settings:
      the PCI-vUART for the Service VM. Refer to :ref:`Enable vUART Configurations <vuart_config>`
      for more details about VUART configuration.
 
-   - Set :option:`vm.console_vuart` to ``PCI``
+   - Set ``vm.console_vuart`` to ``PCI``
 
      .. code-block:: xml
         :emphasize-lines: 1

doc/tutorials/vcat_configuration.rst

@@ -13,12 +13,12 @@ into XML in the scenario file:
 
 #. Configure system level features:
 
-   - Edit :option:`hv.FEATURES.RDT.RDT_ENABLED` to `y` to enable RDT
+   - Edit ``hv.FEATURES.RDT.RDT_ENABLED`` to `y` to enable RDT
 
-   - Edit :option:`hv.FEATURES.RDT.CDP_ENABLED` to `n` to disable CDP.
+   - Edit ``hv.FEATURES.RDT.CDP_ENABLED`` to `n` to disable CDP.
      vCAT requires CDP to be disabled.
 
-   - Edit :option:`hv.FEATURES.RDT.VCAT_ENABLED` to `y` to enable vCAT
+   - Edit ``hv.FEATURES.RDT.VCAT_ENABLED`` to `y` to enable vCAT
 
      .. code-block:: xml
         :emphasize-lines: 3,4,5
@@ -34,9 +34,9 @@ into XML in the scenario file:
 
 #. In each Guest VM configuration:
 
-   - Edit :option:`vm.virtual_cat_support` to 'y' to enable the vCAT feature on the VM.
+   - Edit ``vm.virtual_cat_support`` to 'y' to enable the vCAT feature on the VM.
 
-   - Edit :option:`vm.clos.vcpu_clos` to assign COS IDs to the VM.
+   - Edit ``vm.clos.vcpu_clos`` to assign COS IDs to the VM.
 
      If ``GUEST_FLAG_VCAT_ENABLED`` is not specified for a VM (abbreviated as RDT VM):
      ``vcpu_clos`` is per CPU in a VM and it configures each CPU in a VM to a desired COS ID.