Xen devel - Sep 2012 - [PATCH] xl.cfg: videoram and stdvga documentation improvements

Hello,

xl.cfg.pod.5 documentation tweaks/improvements:

- videoram: Document that only qemu-xen-traditional device-model currently
   supports changing the amount of video memory for stdvga graphics device.

- videoram: Better document the default amount of videoram for both stdvga
  and Cirrus.

- stdvga: Add a note that stdvga allows bigger amount of videoram and
  bigger resolutions.


Signed-off-by: Pasi Kärkkäinen <pasik@iki.fi>

--- docs/man/xl.cfg.pod.5.orig  2012-08-25 02:10:29.199847688 +0300
+++ docs/man/xl.cfg.pod.5       2012-09-02 07:16:39.316782158 +0300
@@ -716,10 +716,18 @@
 Sets the amount of RAM which the emulated video card will contain,
 which in turn limits the resolutions and bit depths which will be
 available. This option is only available when using the B<stdvga>
-option (see below). The default is 8MB which is sufficient for
-e.g. 1600x1200 at 32bpp. When not using the B<stdvga> option the
-amount of video ram is fixed at 4MB which is sufficient for 1024x768
-at 32 bpp.
+option (see below). 
+The default amount of video ram for stdvga is 8MB which is sufficient 
+for e.g. 1600x1200 at 32bpp.
+
+When using the emulated Cirrus graphics card (B<stdvga=0>) 
+the amount of video ram is fixed at 4MB which is sufficient 
+for 1024x768 at 32 bpp.
+
+videoram option is currently only available when using the 
+qemu-xen-traditional device-model. Upstream qemu-xen device-model
+currently doesn''t support changing the amount of video memory
+for the emulated graphics device.
 
 =item B<stdvga=BOOLEAN>
 
@@ -727,6 +735,7 @@
 emulated graphics device. The default is false which means to emulate
 a Cirrus Logic GD5446 VGA card. If your guest supports VBE 2.0 or
 later (e.g. Windows XP onwards) then you should enable this.
+stdvga supports more video ram and bigger resolutions than Cirrus.
 
 =item B<vnc=BOOLEAN>


--x+6KMIRAuhnl3hBn
Content-Type: text/x-diff; charset=us-ascii
Content-Disposition: attachment;
filename="xl.cfg.pod.5-videoram-stdvga.patch"

--- docs/man/xl.cfg.pod.5.orig	2012-08-25 02:10:29.199847688 +0300
+++ docs/man/xl.cfg.pod.5	2012-09-02 07:16:39.316782158 +0300
@@ -716,10 +716,18 @@
 Sets the amount of RAM which the emulated video card will contain,
 which in turn limits the resolutions and bit depths which will be
 available. This option is only available when using the B<stdvga>
-option (see below). The default is 8MB which is sufficient for
-e.g. 1600x1200 at 32bpp. When not using the B<stdvga> option the
-amount of video ram is fixed at 4MB which is sufficient for 1024x768
-at 32 bpp.
+option (see below). 
+The default amount of video ram for stdvga is 8MB which is sufficient 
+for e.g. 1600x1200 at 32bpp.
+
+When using the emulated Cirrus graphics card (B<stdvga=0>) 
+the amount of video ram is fixed at 4MB which is sufficient 
+for 1024x768 at 32 bpp.
+
+videoram option is currently only available when using the 
+qemu-xen-traditional device-model. Upstream qemu-xen device-model
+currently doesn''t support changing the amount of video memory
+for the emulated graphics device.
 
 =item B<stdvga=BOOLEAN>
 
@@ -727,6 +735,7 @@
 emulated graphics device. The default is false which means to emulate
 a Cirrus Logic GD5446 VGA card. If your guest supports VBE 2.0 or
 later (e.g. Windows XP onwards) then you should enable this.
+stdvga supports more video ram and bigger resolutions than Cirrus.
 
 =item B<vnc=BOOLEAN>
 

--x+6KMIRAuhnl3hBn
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xen.org
http://lists.xen.org/xen-devel

--x+6KMIRAuhnl3hBn--

On Sun, 2012-09-02 at 05:41 +0100, Pasi Kärkkäinen
wrote:
> Hello,
> 
> xl.cfg.pod.5 documentation tweaks/improvements:
> 
> - videoram: Document that only qemu-xen-traditional device-model currently
>    supports changing the amount of video memory for stdvga graphics device.
> 
> - videoram: Better document the default amount of videoram for both stdvga
>   and Cirrus.
> 
> - stdvga: Add a note that stdvga allows bigger amount of videoram and
>   bigger resolutions.
> 
> 
> Signed-off-by: Pasi Kärkkäinen <pasik@iki.fi>
Acked-by: Ian Campbell <ian.campbell@citrix.com>

and applied, thanks Pasi.

I stripped some new trailing whitespace as I went.



_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xen.org
http://lists.xen.org/xen-devel