From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-qv1-f43.google.com (mail-qv1-f43.google.com [209.85.219.43]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id CD18C32142B for ; Mon, 2 Mar 2026 14:25:23 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.219.43 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772461525; cv=none; b=LVz+fu4SA+m3wpaYlysAIepgai79Ls/hpIQ3O+5dMTvWF7tuKNNIC/POD+F67vmhuwwRerSB3XU+MBHX/IPkNm7GRrfbjD0f7sRqmxIjgv0cacRDRIy+3LVMJBsETS5mBBGiVCaOygg407pXwznd2lMzpxKhEmK0ESwSmxKipoc= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772461525; c=relaxed/simple; bh=qy7aDVJ8fY/4O8G1mA98Bj+ItTmGpMx2905lMVvsEOk=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=eN/bkvYXyH/x8M4GamNW4bqjtMPP0T79vr17Jw10w632S/nc666ZQpr5P47xSu8sjAu56Wv+h8UhcjNEF4WHsGRA1KzXVQ4t+MOuhR2Lhh5j9IU4iupOLhP3bybF6nPdIWVkQaKL37N1CAFOL3g/UvzUuAUuJZuV+NyZp3viSY0= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=ziepe.ca; spf=pass smtp.mailfrom=ziepe.ca; dkim=pass (2048-bit key) header.d=ziepe.ca header.i=@ziepe.ca header.b=l0JxR00F; arc=none smtp.client-ip=209.85.219.43 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=ziepe.ca Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=ziepe.ca Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=ziepe.ca header.i=@ziepe.ca header.b="l0JxR00F" Received: by mail-qv1-f43.google.com with SMTP id 6a1803df08f44-899e87b04d8so31584846d6.3 for ; Mon, 02 Mar 2026 06:25:23 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ziepe.ca; s=google; t=1772461523; x=1773066323; darn=vger.kernel.org; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc:subject:date:message-id:reply-to; bh=TJvv+dHmg1dMk+zrpZ7EFL5nzk7Z7j7/n7g2yIloLCk=; b=l0JxR00FPjRjbyafasJ+YWEnfVmkm9g8sCTQSCTwwuflqZGy3+lu4jvVpNq3A8agwg AXd7tLcPfJT5R3OIBEArZ9TiQcn5+X/qLsufor40vQt8oyDhXL1PzbT24abzYDsplcM8 kCBK8Io5KabQP/McXR4Ih0umS7c9Tfyfk5B4ifC/QMQrdKfrGV5qJT7Ml42ccGjmD0Fy pcRMMD8ke1s9K9jq89CEqUTbzT3CrZ4zevh6tjw0yOfVzKapYaDn+gOFfaWNv5kNofTZ wwu1LZFVekIbm9zwT/sTjjew2GO7u7G6MZUIQqs8pkK3OWEHQUxjEJk89OHqFZA6QRuQ mEdw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1772461523; x=1773066323; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-gg:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=TJvv+dHmg1dMk+zrpZ7EFL5nzk7Z7j7/n7g2yIloLCk=; b=RAPJF+PAMZ/wMbeKHaFiW9PE7pVzUsFUetYWrm4RbNqxYemyvJMM2hgjabDNSxwmmF 7COHtglytnd8tbeWxRZj+hbIMgQ643AkNwRzhFxcv7ieA6uI6hFknq99v/9SjpC07Pi7 S/6NPpq2SadF5GLh+VQew1SR3hvSntTt7GB1WhQeJ3CrZbcUzZ1f3EhYbngHAOeFX/wT zMMQhW+sfEEeIeI2pP70b6y/tHnJcl3jb/QhHl8Txbq0aDM2a+McxyULSMHlVY+qsV+E JNTuk4S7gGe4aFvFM/ZvKVgIVkPJUlWMhtN5hhjwrpjFNa75TQshuEL11+WgceF6mQx7 RAHQ== X-Gm-Message-State: AOJu0YxFJ6A1mCZHFhtnPXawGIuKIwBu6oIVfBn6jcaD2eaSjXRY+czQ DEwBulKOPgwckPE0E1MtSh59kuYHkpMFDTK1tx98ekT7EIyUO0Ja3NN7sbQyyF7E5Mb5KKKcIS4 AN8jtn3I= X-Gm-Gg: ATEYQzyoJfuiLvYaDCcYnJ7fPPPEOChcQjqwX5nj59UZ72RCRLZEqayzdoH/6z9oR1e reGWjL7pJsBshOSqHXbQcHlDIZ6kLXk772tRQCFSZji8PTODB0unXZkF38cjvVdtziV79uP0p1T /VHHE3/VgrSy7Wme2AxvKE9YwVyRN2Z1V6T+jCG3LwS/8O+IgN7BDW82C2MZmxTOTZZ0NgzOCkb VK2OuRDhCzrtXfKid+V9avYOQs5RtP7SxrA9C1y2HnATSdNJ45eSPhBVF016vy5MTyOKml2Dvd+ Goespk5D3QR/G81AiCZXYJW5DdyaXSlLvZlmgt3GkorKdrhfGEC4LY16sfTtnha5sql2KRTg4ss NDsymKyLGbb6n8auBixb8gTt+iL7jsITGQztmbGckgKIgnQCxjAJWy6QR/m1uSm3o0XUg9ThcbY 2iE8nFNfGUY4Kd6pRFLBMbSiWeFhNzvb02AMavsP36qeIijTMXh7DMssLm1C7Ak2y+U3xf4ncbz jiBNrcg X-Received: by 2002:ad4:5bc7:0:b0:899:f50a:6d15 with SMTP id 6a1803df08f44-899f50a7244mr66650266d6.6.1772461522653; Mon, 02 Mar 2026 06:25:22 -0800 (PST) Received: from ziepe.ca (hlfxns017vw-142-162-112-119.dhcp-dynamic.fibreop.ns.bellaliant.net. [142.162.112.119]) by smtp.gmail.com with ESMTPSA id af79cd13be357-8cbbf6f9261sm1158810485a.26.2026.03.02.06.25.22 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 02 Mar 2026 06:25:22 -0800 (PST) Received: from jgg by wakko with local (Exim 4.97) (envelope-from ) id 1vx4D3-00000003gVp-1im1; Mon, 02 Mar 2026 10:25:21 -0400 Date: Mon, 2 Mar 2026 10:25:21 -0400 From: Jason Gunthorpe To: Randy Dunlap Cc: linux-kernel@vger.kernel.org, Andrew Morton , linux-mm@kvack.org Subject: Re: [PATCH] mm/mmu_notifier: clean up mmu_notifier.h kernel-doc Message-ID: <20260302142521.GX44359@ziepe.ca> References: <20260302005222.3470783-1-rdunlap@infradead.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20260302005222.3470783-1-rdunlap@infradead.org> On Sun, Mar 01, 2026 at 04:52:22PM -0800, Randy Dunlap wrote: > Eliminate kernel-doc warnings in mmu_notifier.h: > - add a missing struct short description > - use the correct format for function parameters > - add missing function return comment sections > > Warning: include/linux/mmu_notifier.h:236 missing initial short > description on line: * struct mmu_interval_notifier_ops > Warning: include/linux/mmu_notifier.h:325 function parameter 'interval_sub' > not described in 'mmu_interval_set_seq' > Warning: include/linux/mmu_notifier.h:325 function parameter 'cur_seq' > not described in 'mmu_interval_set_seq' > Warning: include/linux/mmu_notifier.h:346 function parameter 'interval_sub' > not described in 'mmu_interval_read_retry' > Warning: include/linux/mmu_notifier.h:346 function parameter 'seq' not > described in 'mmu_interval_read_retry' > Warning: include/linux/mmu_notifier.h:346 No description found for return > value of 'mmu_interval_read_retry' > Warning: include/linux/mmu_notifier.h:370 function parameter 'interval_sub' > not described in 'mmu_interval_check_retry' > Warning: include/linux/mmu_notifier.h:370 function parameter 'seq' not > described in 'mmu_interval_check_retry' > Warning: include/linux/mmu_notifier.h:370 No description found for return > value of 'mmu_interval_check_retry' > > Signed-off-by: Randy Dunlap > --- > Cc: Jason Gunthorpe > Cc: Andrew Morton > Cc: linux-mm@kvack.org > > include/linux/mmu_notifier.h | 31 ++++++++++++++++--------------- > 1 file changed, 16 insertions(+), 15 deletions(-) Reviewed-by: Jason Gunthorpe Jason