On Thu, May 27, 2010 at 12:26:35PM +0600, ???? ????????? wrote:

2010/5/25 Daniel P. Berrange <berrange@redhat.com>:

...

On Tue, May 25, 2010 at 01:07:50PM +0600, ???? ????????? wrote:

...

For example, http://libvirt.org/formatdomain.html#elementsDisks does not contain <serial>xxxx</serial> tag. (https://bugzilla.redhat.com/show_bug.cgi?id=593266)

I wrote to community (users and developers). No one has added this information to the site...

The website is all stored in the main GIT repository

http://libvirt.org/git/?p=libvirt.git;a=summary

under the 'docs/' subdirectory. If you want to contribute, just send a patch for the .html.in file in docs/

Huge thanks. Patch attached. I will create more patches to documentation. Where to send them ?

Thanks, I have just pushed your patch to the repo. It'll appear on the website within the hour. commit dafd354d12e5f16844342ebbeb345fadd22fba69 Author: Марк Коренберг <socketpair gmail com> Date: Thu May 27 12:44:41 2010 +0100 Add docs on drive <serial> element * docs/formatdomain.html.in: Document <serial> element within <disk> and fix typo on <driver/> element Daniel

diff -ur docs/formatdomain.html.in docs.new/formatdomain.html.in --- docs/formatdomain.html.in 2010-05-27 11:35:33.995122526 +0600 +++ docs.new/formatdomain.html.in 2010-05-27 12:20:07.574622370 +0600 @@ -477,13 +477,16 @@ ... <devices> <disk type='file'> - <driver name="tap" type="aio" cache="default"> + <driver name="tap" type="aio" cache="default"/> <source file='/var/lib/xen/images/fv0'/> <target dev='hda' bus='ide'/> <encryption type='...'> ... </encryption> <shareable/> + <serial> + ... + </serial> </disk> </devices> ...</pre> @@ -532,6 +535,11 @@ between domains (assuming the hypervisor and OS support this), which means that caching should be deactivated for that device. </dd> + <dt><code>serial</code></dt> + <dd>If present, this specify serial number of virtual hard drive. + For example, it may look as <code><serial>WD-WMAP9A966149</serial></code>. + <span class="since">Since 0.7.1</span> + </dd> </dl>

<h4><a name="elementsUSB">USB and PCI devices</a></h4>

-- |: Red Hat, Engineering, London -o- http://people.redhat.com/berrange/ :| |: http://libvirt.org -o- http://virt-manager.org -o- http://deltacloud.org :| |: http://autobuild.org -o- http://search.cpan.org/~danberr/ :| |: GnuPG: 7D3B9505 -o- F3C9 553F A1DA 4AC2 5648 23C1 B3DF F742 7D3B 9505 :|