From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([208.118.235.92]:43193) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SPgj4-0004G8-C1 for qemu-devel@nongnu.org; Wed, 02 May 2012 17:04:43 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SPgj2-0002KR-Mo for qemu-devel@nongnu.org; Wed, 02 May 2012 17:04:41 -0400 Received: from v220110690675601.yourvserver.net ([78.47.199.172]:50090) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SPgj2-0002Jm-Gm for qemu-devel@nongnu.org; Wed, 02 May 2012 17:04:40 -0400 Received: from localhost (v220110690675601.yourvserver.net.local [127.0.0.1]) by v220110690675601.yourvserver.net (Postfix) with ESMTP id 523FC72800BC for ; Wed, 2 May 2012 23:04:38 +0200 (CEST) Received: from v220110690675601.yourvserver.net ([127.0.0.1]) by localhost (v220110690675601.yourvserver.net [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 66YJ8b-WMjXb for ; Wed, 2 May 2012 23:04:37 +0200 (CEST) Received: from flocke.weilnetz.de (p5086E93C.dip.t-dialin.net [80.134.233.60]) by v220110690675601.yourvserver.net (Postfix) with ESMTPSA id DE28A72800B0 for ; Wed, 2 May 2012 23:04:37 +0200 (CEST) Received: from localhost ([127.0.0.1] ident=stefan) by flocke.weilnetz.de with esmtp (Exim 4.72) (envelope-from ) id 1SPgiz-0001CS-Ba for qemu-devel@nongnu.org; Wed, 02 May 2012 23:04:37 +0200 Message-ID: <4FA1A165.40703@weilnetz.de> Date: Wed, 02 May 2012 23:04:37 +0200 From: Stefan Weil MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-15; format=flowed Content-Transfer-Encoding: 7bit Subject: [Qemu-devel] [RFC 1.1] Fix "qemu" in documentation for version 1.1? List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: QEMU Developers 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