On Thu, May 3, 2012 at 7:04 AM, Stefan Weil <s...@weilnetz.de> wrote: > 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.
"qemu-system-<something> is a bit verbose to just represent "your qemu executable of choice". What about "<qemu>" and just have a paragraph at the start of the documentation that specifies that <qemu> is the wildcard for whatever executable/target you picked. regards ronnie sahlberg
