Received: by 2002:a05:6a10:6744:0:0:0:0 with SMTP id w4csp733194pxu; Fri, 23 Oct 2020 11:55:02 -0700 (PDT) X-Google-Smtp-Source: ABdhPJzZWnEVqt3VBqCqiUCTxj6/WZABDjS74mmwRXt5blIEV5ZfeHNCIcCOhi+zE6c6WbmeZizN X-Received: by 2002:a05:6402:134c:: with SMTP id y12mr3601548edw.344.1603479301944; Fri, 23 Oct 2020 11:55:01 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1603479301; cv=none; d=google.com; s=arc-20160816; b=qzbopwENLHGZ86oTJ6hIulNaLUVUk8NSQXO24Tmesz+zdxo42e70gBcuqQLlqZY0DP 0t0AsAr/NT55YtTPZ0hvF8V/DlihaYDqYnNWGXsi5jT6v7Bn68TkDjHL+ZwsyddTZzQb jDmgr9YZmYoNOFgA4pmpmJg2mQKceoCHsoO0DEdn4IoNIX9Uz9OG0g9/dsim1vsohu8m DIlXEIZ5RS9UtzHnT3Ib11QXOrled57i50X0du6sN16L0l2PVEKdc7Jivfu4CJFIN4og RHcykb/tdAFZ/O2Z9di7HJFxZyc0D1jQ31UNxjv1t4l9sRrbYISGNSCvKpHrQoSCAi2l AywQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=DicK5SyYqohhXYJnCHU8Qnq8fWxQEKtjdG1amJ6jx84=; b=s35S5Ja+HEEjflb+36asYzHpnfg4iIN9DcBigwdeJ9SDUIvP5Lpkl7jh64r1sToK3t hInWQ4UA44x+3VDwTTH+2cyHyfoRGSKIkM1xFTJIH/T+s2B9gBkjXvStct0+a3rNnyWo Ob+USX4uzgHrLBKJ5vmQjpArtDoKurfZLW7jWVifC6VqShDD3vZeBIMqEHYJ6vipQ6d7 8+Tyd7cIi9xyyO+Iw2EEGv+XaW5Q8PN5QpQHBfL/jx9r9HVdyP90vIBXoQmoZAbEIySr hJ5canK7ONZXZ42ns1gggDIv28Q2U7ebCLgAfyNr3eqaf/0OPVYJZy7n7gEuMKZRKnfV o0fw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=xAxL9zxT; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id a23si1439370edn.292.2020.10.23.11.54.40; Fri, 23 Oct 2020 11:55:01 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=xAxL9zxT; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S465759AbgJWQfR (ORCPT + 99 others); Fri, 23 Oct 2020 12:35:17 -0400 Received: from mail.kernel.org ([198.145.29.99]:33586 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751863AbgJWQdv (ORCPT ); Fri, 23 Oct 2020 12:33:51 -0400 Received: from mail.kernel.org (ip5f5ad5a3.dynamic.kabel-deutschland.de [95.90.213.163]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id B4D37246DC; Fri, 23 Oct 2020 16:33:48 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1603470828; bh=mdSdh5AGZt6OomnwQnDQKEOlC4NrmBkjBQ0E/tv2ezo=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=xAxL9zxTXBFGtdrarG7uuibMZOhjG5gKpg1OD8UyzeKOtxBxVfbz9TKwnYR8shj+8 ZbmH8Ss/WZdcFyhc3MyOZAkavbzReotyZxAAmORI3uTDXYLlFglulmkI2dqO/BjCcW VqJIVAfgqmhUkWc9aK18X9f794OlP+b5rJEceXZc= Received: from mchehab by mail.kernel.org with local (Exim 4.94) (envelope-from ) id 1kW00g-002Axl-Nf; Fri, 23 Oct 2020 18:33:46 +0200 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , Andrew Morton , Dan Williams , David Hildenbrand , Greg Kroah-Hartman , linux-kernel@vger.kernel.org Subject: [PATCH v3 52/56] resource: fix kernel-doc markups Date: Fri, 23 Oct 2020 18:33:39 +0200 Message-Id: <926c3c9de205325acf609ea5e28dd905bda9768b.1603469755.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.26.2 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: Mauro Carvalho Chehab Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Kernel-doc markups should use this format: identifier - description While here, fix a kernel-doc tag that was using, instead, a normal comment block. Signed-off-by: Mauro Carvalho Chehab --- kernel/resource.c | 24 ++++++++++++++---------- 1 file changed, 14 insertions(+), 10 deletions(-) diff --git a/kernel/resource.c b/kernel/resource.c index 3ae2f56cc79d..9738920abdca 100644 --- a/kernel/resource.c +++ b/kernel/resource.c @@ -320,9 +320,8 @@ int release_resource(struct resource *old) EXPORT_SYMBOL(release_resource); /** - * Finds the lowest iomem resource that covers part of [@start..@end]. The - * caller must specify @start, @end, @flags, and @desc (which may be - * IORES_DESC_NONE). + * find_next_iomem_res - Finds the lowest iomem resource that covers part of + * [@start..@end]. * * If a resource is found, returns 0 and @*res is overwritten with the part * of the resource that's within [@start..@end]; if none is found, returns @@ -337,6 +336,9 @@ EXPORT_SYMBOL(release_resource); * @desc: descriptor the resource must have * @first_lvl: walk only the first level children, if set * @res: return ptr, if resource found + * + * The caller must specify @start, @end, @flags, and @desc + * (which may be IORES_DESC_NONE). */ static int find_next_iomem_res(resource_size_t start, resource_size_t end, unsigned long flags, unsigned long desc, @@ -416,11 +418,9 @@ static int __walk_iomem_res_desc(resource_size_t start, resource_size_t end, } /** - * Walks through iomem resources and calls func() with matching resource - * ranges. This walks through whole tree and not just first level children. - * All the memory ranges which overlap start,end and also match flags and - * desc are valid candidates. - * + * walk_iomem_res_desc - Walks through iomem resources and calls func() + * with matching resource ranges. + * * * @desc: I/O resource descriptor. Use IORES_DESC_NONE to skip @desc check. * @flags: I/O resource flags * @start: start addr @@ -428,6 +428,10 @@ static int __walk_iomem_res_desc(resource_size_t start, resource_size_t end, * @arg: function argument for the callback @func * @func: callback function that is called for each qualifying resource area * + * This walks through whole tree and not just first level children. + * All the memory ranges which overlap start,end and also match flags and + * desc are valid candidates. + * * NOTE: For a new descriptor search, define a new IORES_DESC in * and set it in 'desc' of a target resource entry. */ @@ -1372,9 +1376,9 @@ static bool system_ram_resources_mergeable(struct resource *r1, !r1->child && !r2->child; } -/* +/** * merge_system_ram_resource - mark the System RAM resource mergeable and try to - * merge it with adjacent, mergeable resources + * merge it with adjacent, mergeable resources * @res: resource descriptor * * This interface is intended for memory hotplug, whereby lots of contiguous -- 2.26.2