From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:51986) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YBSnh-0007OA-JP for qemu-devel@nongnu.org; Wed, 14 Jan 2015 13:36:18 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YBSnc-0002DL-DO for qemu-devel@nongnu.org; Wed, 14 Jan 2015 13:36:17 -0500 Received: from mail-qg0-x235.google.com ([2607:f8b0:400d:c04::235]:57972) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YBSnc-0002C9-77 for qemu-devel@nongnu.org; Wed, 14 Jan 2015 13:36:12 -0500 Received: by mail-qg0-f53.google.com with SMTP id l89so8260712qgf.12 for ; Wed, 14 Jan 2015 10:36:07 -0800 (PST) Sender: Richard Henderson Message-ID: <54B6B711.2060603@twiddle.net> Date: Wed, 14 Jan 2015 10:36:01 -0800 From: Richard Henderson MIME-Version: 1.0 References: <1421250669-4347-1-git-send-email-kbastian@mail.uni-paderborn.de> <87fvbds7b9.fsf@fimbulvetr.bsc.es> <54B6BAF7.4070006@mail.uni-paderborn.de> <877fwpp6tu.fsf@fimbulvetr.bsc.es> In-Reply-To: <877fwpp6tu.fsf@fimbulvetr.bsc.es> Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Subject: Re: [Qemu-devel] [PATCH] tcg: Add doxygen documentation to the tcg frontend List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: =?UTF-8?B?TGx1w61zIFZpbGFub3Zh?= , qemu-devel@nongnu.org On 01/14/2015 10:15 AM, Lluís Vilanova wrote: > Sorry I wasn't clear. I meant that it might be better to remove tcg/README and > instead document all the operations (those in the readme and the additional > ones) in the header. If we did that, it would go somewhere else. There are two different (but clearly closely related) things that need documenting: (1) The functional interface used by target-*/translate.c. This is what Bastian is attempting to document now. (2) The intermediate language opcodes. This is what is currently documented in tcg/README. r~