Re: [Qemu-devel] [5806] qemu-doc.texi: document downscript network option

[Jamie Lokier <jamie@shareable.org>]

Aurelien Jarno wrote a patch, resulting in:
> @item -net tap[,vlan=@var{n}][,fd=@var{h}][,ifname=@var{name}][,script=@var{file}][,downscript=@var{dfile}]
> Connect the host TAP network interface @var{name} to VLAN @var{n}
> and use the network script @var{file} to configure it. The default
> network script is @file{/etc/qemu-ifup}. Use @option{script=no} to
> disable script execution. If @var{name} is not provided, the OS
> automatically provides one. Use network script @var{dfile} to
> deconfigure the interface. Use @option{downscript=no} to disable
> script execution. @option{fd}=@var{h} can be used to specify the
> handle of an already opened host TAP interface.

Two things don't make sense:

   1. Do you have to write "downscript=no" to disable
      downscript execution?  If you don't need it, that part of the
      documentation is unnecessary.  If you do need it, then it's not
      backward-compatible with earlier QEMU versions.

   2. If you do need "downscript=no" to disable it, what's
      the default downscript name if you don't have "downscript=no"?

Also, it would be better for the text to describe the options in the
same order as the synopsis in the first line, especially describing
the two script options without anything else between.

-- Jamie