From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mgamail.intel.com (mgamail.intel.com [198.175.65.12]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 4F8E0334692 for ; Wed, 15 Jul 2026 12:39:13 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.175.65.12 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784119155; cv=none; b=KvO/7fAaIPw1wAA2WMvU6YtmH6mhYdZLA9q7ANpIYmAZqMIsiQmg3bJGAO3j/JraUOflVHsHOA6EhGisZ+DJ4SIzT0LOBnHgIoV171AGvF0h6FFaE92N9Xe/wz2LufmkoLm42c13JUDEklO1YWKrw2l8zyYp5uHqj/6dcFTPKIA= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784119155; c=relaxed/simple; bh=HaHn6du7UJCN/OY2gbQQnyrEzeX3lUdDNjiP8v2c8Cw=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=pR1QeVlkVGUdaEIuFMc0ghlsaxeMo9c5vXfb+8aUfwDdAILwpDFnAyq8ydEfHFEE2ujSjLZW0URGPyi4nlawy+h2ciw43CgW9kZdfW0cXKlB5nltS4Dmmkp4qyprh7YC/86IrECJph652OKVN3oe5t70HHSmhUe/pUeRPTuyvtE= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.intel.com; spf=pass smtp.mailfrom=linux.intel.com; dkim=pass (2048-bit key) header.d=intel.com header.i=@intel.com header.b=R5AFOLh0; arc=none smtp.client-ip=198.175.65.12 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.intel.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linux.intel.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=intel.com header.i=@intel.com header.b="R5AFOLh0" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1784119153; x=1815655153; h=date:from:to:cc:subject:message-id:references: mime-version:in-reply-to; bh=HaHn6du7UJCN/OY2gbQQnyrEzeX3lUdDNjiP8v2c8Cw=; b=R5AFOLh0qMvL1fAF3Eheq0htHMPOkE3mdaObDgbI5GKHznVKfUnZldzj duId6PO3ORh41z/d8PB3OWCfzhpTZLICUj97aH8kCFjTI81eZNGV1YIJ7 jqzTrNlXPHAe80TVG85L2NCxl+COoIF4OiEorm/F/fldmltktD4yHTsJT BrJapSRUUm8+U3a3Ozjf3/uvCmRxniCYQHp1dV6H31x4J5zDTTOdRGqKv um6tbytzRQpG9QGJlesl8wcWXMNzbhfeAauI5/p1w2HDgCBhZzDkt851w eq6dt0qxGK+YfzZSEUhiuoZXGMHGAgPYk5SV+NNXwjNZQVeA73Nj6CrTs A==; X-CSE-ConnectionGUID: 7t9ABF4cQ6WQwEyX91VNpw== X-CSE-MsgGUID: xicppW9/QnKlaA07VqCWYA== X-IronPort-AV: E=McAfee;i="6800,10657,11847"; a="96270113" X-IronPort-AV: E=Sophos;i="6.25,165,1779174000"; d="scan'208";a="96270113" Received: from fmviesa004.fm.intel.com ([10.60.135.144]) by orvoesa104.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 15 Jul 2026 05:39:13 -0700 X-CSE-ConnectionGUID: 0sYvquUNRleP+whao6LD5g== X-CSE-MsgGUID: FHrpsGMqQa21fqZd4Q8rNA== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.25,165,1779174000"; d="scan'208";a="258132129" Received: from ettammin-mobl3.ger.corp.intel.com (HELO kekkonen.fi.intel.com) ([10.245.244.106]) by fmviesa004-auth.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 15 Jul 2026 05:39:11 -0700 Received: from kekkonen.localdomain (localhost [IPv6:::1]) by kekkonen.fi.intel.com (Postfix) with SMTP id 85AC512080C; Wed, 15 Jul 2026 15:39:10 +0300 (EEST) Date: Wed, 15 Jul 2026 15:39:10 +0300 Organization: Intel Finland Oy - BIC 0357606-4 - c/o Alberga Business Park, 6 krs, Bertel Jungin Aukio 5, 02600 Espoo From: Sakari Ailus To: Ricardo Ribalda Cc: Andy Shevchenko , Hans de Goede , Mauro Carvalho Chehab , Greg Kroah-Hartman , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org, linux-staging@lists.linux.dev Subject: Re: [PATCH 1/2] media: atomisp: Demote all broken kernel-doc comments Message-ID: References: <20260629-atomisp-kerneldoc-simple-v1-0-8ae282b85c5c@chromium.org> <20260629-atomisp-kerneldoc-simple-v1-1-8ae282b85c5c@chromium.org> Precedence: bulk X-Mailing-List: linux-staging@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20260629-atomisp-kerneldoc-simple-v1-1-8ae282b85c5c@chromium.org> On Mon, Jun 29, 2026 at 11:48:28AM +0000, Ricardo Ribalda wrote: > The atomisp code has been very heavily annotated in doxygen format. > > Unfortunately, both doxygen and kernel-doc use the same mark for signify > the beginning of a comment (/**). > > As a result of this, kernel-doc gets confused when it parses atomisp and > throws tons of warnings, which made us completely disable atomisp > kernel-doc checks in Media-CI. > > Demote all the broken comments so we can have 100% coverage. > > Future patches can convert the doxygen annotations to kernel-doc if this > is deemed useful. > > Signed-off-by: Ricardo Ribalda Acked-by: Sakari Ailus -- Sakari Ailus