From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="gc1UBbXU" Received: from mail-ej1-x633.google.com (mail-ej1-x633.google.com [IPv6:2a00:1450:4864:20::633]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 7955A19A5; Thu, 23 Nov 2023 23:58:14 -0800 (PST) Received: by mail-ej1-x633.google.com with SMTP id a640c23a62f3a-a02ba1f500fso231990466b.0; Thu, 23 Nov 2023 23:58:14 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1700812693; x=1701417493; darn=vger.kernel.org; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=8p7dDjCm5/iLvLgQDDLJfWkSJwlYnIAvuwjTfuhLRQA=; b=gc1UBbXUlP65qYLy2lcZ13qIU61y4hbm3whIsSeXARn8+ezOhiy5g+7RzND6qABSmn +fwzDPv7ZLdb+fXb3dunhMAAOhha1ciSWswrSVyXY+LX9npbfs/f4VhhSUhcp0pXaKpe AQHHYQVcsihMmkvsjwZggcdnkR+2d4cdoJv0NtJIq80MrlnIXvNPaZgHEWQU7m1ZRgRi XT6Sr0CscnEfPUHtwp1XHHPCiFHpLuxpnNnO6dTkpcZyHl92bPG/d9ftSFgilhWKSflQ qk2BcYgK4ObNsONWweAKR/J/Vv6GlaXCxLxsbJJNLUWdDH3A033TDcTnRQ/2kD/PRa/R jTOA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1700812693; x=1701417493; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=8p7dDjCm5/iLvLgQDDLJfWkSJwlYnIAvuwjTfuhLRQA=; b=Z7Bd1ITn+ioPwECFAOVPcD5UT6SRZ2OGWk8Ehj170DWE9+Y2xNXt0Oj+lBoz7CqF7Y zvtR2kT3YDchi4mWJVp6RdmnYP/vnQxPQdAqAB8JlgJcMmByrlKnsrJ1klLiXsCkbMA/ c1C2u5R2tczxwN2Pk0SmkPTRh2XWKB0MUfj6MPt6ENiAZzsu8l2NUIcwD5L7UhCcmw9O twLdHdSpcUZzzb3pj92vH0hiuT0dqVPE1cumFbHjBF6KHwS4D54R8ZaAaHMMjsDfE9yd 5ZArK0m6xhGrabJS8IqpUSqgFEXnI0M/KCE9Zo4AX+ladoIyh52XW+aNCkhP9NFfGJMV f+FQ== X-Gm-Message-State: AOJu0Yx2/gy0vcOaNQ9ZhFxNGnq/+JMgEp1pfcs0KEE0SG0F30N0OcW+ s0ShCILYqNYDhW+WKZ3JQ8b6Rj9KXHIrY5INPqIFrS0Qzko= X-Google-Smtp-Source: AGHT+IEPyeMGcJbKf9VM4SzfT7pg1ea0f74KgjJ1BME+tFnbuB0Hw++ZZHZQ2HpsGcUa3T7xjYbBENVawrrltbDNsME= X-Received: by 2002:a17:906:3fd0:b0:9b2:c583:cd71 with SMTP id k16-20020a1709063fd000b009b2c583cd71mr1203541ejj.50.1700812692734; Thu, 23 Nov 2023 23:58:12 -0800 (PST) Precedence: bulk X-Mailing-List: linux-next@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 References: <20231124131331.23279543@canb.auug.org.au> In-Reply-To: <20231124131331.23279543@canb.auug.org.au> From: Amir Goldstein Date: Fri, 24 Nov 2023 09:58:00 +0200 Message-ID: Subject: Re: linux-next: build warning after merge of the vfs-brauner tree To: Stephen Rothwell Cc: Christian Brauner , Linux Kernel Mailing List , Linux Next Mailing List Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Fri, Nov 24, 2023 at 4:13=E2=80=AFAM Stephen Rothwell wrote: > > Hi all, > > After merging the vfs-brauner tree, today's linux-next build (htmldocs) > produced this warning: > > Documentation/filesystems/api-summary:14: include/linux/fs.h:1655: WARNIN= G: Definition list ends without a blank line; unexpected unindent. > include/linux/fs.h:1658: warning: Function parameter or member 'level' no= t described in '__sb_write_started' > > Introduced by commit > > 2a7b49f698d0 ("fs: create __sb_write_started() helper") Christian, Do you mind folding: @@ -1648,6 +1648,7 @@ static inline bool __sb_start_write_trylock(struct super_block *sb, int level) /** * __sb_write_started - check if sb freeze level is held * @sb: the super we write to + * @level: the freeze level * * > 0 sb freeze level is held * 0 sb freeze level is not held Thanks, Amir.