From nobody Sun Feb 8 14:53:24 2026 Received: from mail-pl1-f180.google.com (mail-pl1-f180.google.com [209.85.214.180]) (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 6B1931925BC for ; Wed, 31 Dec 2025 15:38:58 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.180 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1767195539; cv=none; b=uEnlbWMvA2od0/U19S4VBAmqS3B5KjDbiCfvEiBkuCMP7etQkJPVDmFD/ktUJPfYc5z949s953hfDrGAqDok8AYecdsDfW0HPoNHL5gjQReFkvTg6vSit38woIUBXibR9XLeAi0rnqaHNBCa5XTEOQGcIC3Q8BbR0HNGXIO+Shw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1767195539; c=relaxed/simple; bh=43UgmKUKlAPjZ/gPyh/0MaG1C7NAJcZi75DUup0/M68=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=Cf5zVfIgS174setbNfS0/K8aZ4M/R20m+b9u5E06oEWShjx0yaBgneFJwOC+f6P2DBM2zR7dVpIG4raV7McTh/xVY5yjYH3An73o3C1UTM54w8VWPbIpLgOVCmx7w49BjR5OArcrEDo6uP4eHlOBWFtQI40iSOCcon5e6ENgqVs= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=CCLwwizE; arc=none smtp.client-ip=209.85.214.180 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="CCLwwizE" Received: by mail-pl1-f180.google.com with SMTP id d9443c01a7336-2a081c163b0so101192925ad.0 for ; Wed, 31 Dec 2025 07:38:58 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1767195538; x=1767800338; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=MlZrdO/Vxycwwnf1zdplwB4vLmWzt9gW5Zk9L4ZO+ec=; b=CCLwwizEG0gXmFeD6j44KEBxUt0yz7vmQlwiGUX5ng6qPHdsJfkVW7J6Dj1fvjigl5 uQxhWjXt2rXcWU1QoGmX4O5Nm/h05AvkcIZfTIIlr2vUAp38qBO5WvsMU3ElZ7yt8Pk5 D9PJ1By/TdU6k3XZof1VaM430jRCmxQTuPtcxGqucGzN0ID2Vu2KAkaaKrwmUkO3YKgD 2wxhGPegz7OmM+vP7tU+pUXCy55GR1bs0h4HCVgyVT5zIov2vZJCMEVpitnU0sJoPhdS yVrVM/yKStPxnxjpyUd5hwFektojNtwc4VfZF3oIiT7gdUMwRyoDjRk1w/5I+m4udYJ2 AYag== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1767195538; x=1767800338; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=MlZrdO/Vxycwwnf1zdplwB4vLmWzt9gW5Zk9L4ZO+ec=; b=oZaqzGPa/T6y6Hw+U4kVZVvlLukTZCkjsJUktRjWTA0temxGiUiZLVJwuy7FUZ/9Gk c3HUjGMsoslxNpYiuTIrrlIGLucAv97grhj6g8ZqC2vJ3gZ9cG7bSgMP2kjTqcC+WRd+ Yol2djIMFZSCIls72ZWVKECcY81mAsob2Y/r23Opibdc2Wy3qKlDSG2fnMN7ihoJg2qK U7lvCRYm0auz2SqRIP44dIPuxekOnHJ0EqTBjUlXbvxrkhmf2X+NkHpVR7ItDT9fe89+ IzY1IREuWQwSbnm4tesVopeSaB9Reo4TcMtyUxByp55d2zKFBLjKk/Q4vaKd1XV4ASud f3iA== X-Forwarded-Encrypted: i=1; AJvYcCU3lgtgFtJKl3ATYzUzG1VLo5agd28bOOD5+ddm1HLMoZmySsV14at70aRLoKFxJTa/92Rj5YPrHT1tdcM=@vger.kernel.org X-Gm-Message-State: AOJu0YyDNaVaTVmGCqntZnFKdtiJRlrVEAy9EbELGS04kTqsJpvQq+8j QPoHUj4Tn+ARQ/wpSru1tH0uMUVz1bDTU8A0GXpezw0cmYYVdmeKmuff X-Gm-Gg: AY/fxX6UnIfuDJe7t2zoS6UBChtv3dRckGSjgihleveER2NLYytM9UqeN9GYrXdjUbe 49IutfHKtfNRBjB6b+BSQhqNvmB38+XAEitZwOS0+wP3jY4UNysn85KUB2g1YOQtkjcWBrEp5/J bSegmsIKs2CjKSLRBrflHpHmLZMSTKa7x4p261OmSy+/3+Rt/FBVhYOd7AWKdYH3tp3PP7xtBvg LTtnI6UVkgSVBZxY6effAsU3ksOZ2L3YbQuPDGwF1rakVKuE+inW/l7lsknoFdzJAOffYl666OH U8sYrRHpzYsgkdGv3m5Q3Cntoz6UVk1ayolhOFvw5Yv24z92pkMsxY7N6r/f55vHpzbWN8voQJz /d2U+Ll3C/WPwTfxGuJpOlOpctMb1ZZnHujjiqzQhhLFJ5L6p18m7cKmF4P7sus1JuB4izNvGgV L4rRZ9spdL0ejcnfwz5ARcY3kGF04NRKJRsnOMMGG1fMka/QFU13KReu9RQbzNpobD+DgAhnkoB Ip4vdCujd4= X-Google-Smtp-Source: AGHT+IEiVfyhWCyhkgiJZ6nHYWgX91kYMxuPxlDykSRDAMl0x6Wb3ujZQFNoe5fO5xkoJZL9pubP6A== X-Received: by 2002:a17:902:d50b:b0:2a0:f47c:cfc with SMTP id d9443c01a7336-2a2f283685amr354551265ad.34.1767195537693; Wed, 31 Dec 2025 07:38:57 -0800 (PST) Received: from kforge-fedora.gk.pfsense.com (static-103-70-166-143.unpl.net. [103.70.166.143]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-c1e7c5307c7sm30884375a12.28.2025.12.31.07.38.55 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 31 Dec 2025 07:38:57 -0800 (PST) From: Gopi Krishna Menon To: viro@zeniv.linux.org.uk, brauner@kernel.org, jack@suse.cz Cc: Gopi Krishna Menon , linux-fsdevel@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH] docs/vfs: Fix htmldocs build warning and error Date: Wed, 31 Dec 2025 21:08:49 +0530 Message-ID: <20251231153851.7523-1-krishnagopi487@gmail.com> X-Mailer: git-send-email 2.52.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Running "make htmldocs" generates the following build warning and error in fs/namei.c: Documentation/filesystems/api-summary:56: ./fs/namei.c:4952: WARNING: Inlin= e emphasis start-string without end-string. [docutils] Documentation/filesystems/api-summary:56: ./fs/namei.c:4942: ERROR: Unknown= target name: "o". [docutils] The error happens due to 'O_' being treated as a named reference by docutils and the warning happens due to '*' in 'struct file *' being treated as beginning of emphasis text. Replace 'O_' with 'O_*' to avoid being treated as a named reference and reword the return comment to fix the build warning and error. Signed-off-by: Gopi Krishna Menon --- fs/namei.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fs/namei.c b/fs/namei.c index aefb21bc0944..852fd007187f 100644 --- a/fs/namei.c +++ b/fs/namei.c @@ -4939,7 +4939,7 @@ EXPORT_SYMBOL(start_creating_user_path); /** * dentry_create - Create and open a file * @path: path to create - * @flags: O_ flags + * @flags: O_* flags * @mode: mode bits for new file * @cred: credentials to use * @@ -4950,7 +4950,7 @@ EXPORT_SYMBOL(start_creating_user_path); * the new file is to be created. The parent directory and the * negative dentry must reside on the same filesystem instance. * - * On success, returns a "struct file *". Otherwise a ERR_PTR + * On success, returns a pointer to struct file. Otherwise a ERR_PTR * is returned. */ struct file *dentry_create(struct path *path, int flags, umode_t mode, --=20 2.51.0