qemu-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Qemu-devel] [RFC 1.1] Fix "qemu" in documentation for version 1.1?


From: Stefan Weil
Subject: [Qemu-devel] [RFC 1.1] Fix "qemu" in documentation for version 1.1?
Date: Wed, 02 May 2012 23:04:37 +0200
User-agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.1.16) Gecko/20120317 Iceowl/1.0b1 Icedove/3.0.11

Hello,

the QEMU documentation (*texi, docs/*, maybe more files) still
includes lots of examples using the executable name "qemu"
which is no longer supported.

Even if a future version of QEMU will provide this name again
(maybe as a common entry point for all other executables),
there is no qemu executable today. That's a bit confusing for
new users of QEMU which don't know the history.

I think man pages and html documentation should be as correct
as possible and therefore suggest replacing "qemu" by
qemu-system-i386 (or qemu-system-x86_64, any other
executable, or randomly selected executables?) in *texi.

When "qemu" is not used for the name of the executable, it
should be written "QEMU".

Should the man page's current name (qemu.1) be changed or
linked to qemu-system-i386 and so on?

The examples in docs/* are less important for end users, so
fixing these is also less important for QEMU 1.1.

Please send suggestions and feedback whether patches for 1.1
seem reasonable or too late for that version.

Regards,

Stefan Weil





reply via email to

[Prev in Thread] Current Thread [Next in Thread]