From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([209.51.188.92]:52585) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ggRfg-0007so-50 for qemu-devel@nongnu.org; Mon, 07 Jan 2019 04:58:12 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ggRff-0005qI-GU for qemu-devel@nongnu.org; Mon, 07 Jan 2019 04:58:12 -0500 Received: from mx1.redhat.com ([209.132.183.28]:54766) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1ggRff-0005pu-BE for qemu-devel@nongnu.org; Mon, 07 Jan 2019 04:58:11 -0500 Date: Mon, 7 Jan 2019 10:58:09 +0100 From: Gerd Hoffmann Message-ID: <20190107095809.2rcbvrf6igqorf5z@sirius.home.kraxel.org> References: <5f0cba98be3d59c4f1d6118b0554429f9e7b3ceb.1545598229.git.DirtY.iCE.hu@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: Subject: Re: [Qemu-devel] [PATCH v2 27/52] audio: use size_t where makes sense List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Philippe =?utf-8?Q?Mathieu-Daud=C3=A9?= Cc: =?utf-8?B?S8WRdsOhZ8OzLCBab2x0w6Fu?= , qemu-devel@nongnu.org, Paolo Bonzini , Pavel Dovgalyuk Hi, > > void AUD_close_out (QEMUSoundCard *card, SWVoiceOut *sw); > > -int AUD_write (SWVoiceOut *sw, void *pcm_buf, int size); > > Can you add short documentation while modifying headers? Such: > > /** > * AUD_write: > * > * Returns: the number of bytes written. > */ While this certainly makes sense I don't think this should be done as part of this patch series, it is already big enough as-is. cheers, Gerd