From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-10.1 required=3.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY, SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id DE53CC2BA19 for ; Tue, 14 Apr 2020 16:53:58 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id B334620678 for ; Tue, 14 Apr 2020 16:53:58 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1586883238; bh=HotOvguNSrEPHftfF9hKyBfJBsne6Ihdoy/T4tXbhYE=; h=From:To:Cc:Subject:Date:In-Reply-To:References:List-ID:From; b=ENacJKm2OMXxMSFLfInCeY+J/m8qGil5ogc2w2je/d9Un9Eg6aUCkoIKYS7QgwLD9 1zE4WnCasQdH/kluZ++piE15IfXgt4NEdoAbPZZ6DpvDCD7eljhYYmzYucGYLz2lUI t6Q4seoTBXH9kUcf2wVHpU15qknyDdC09oE1zgIc= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2440741AbgDNQx4 (ORCPT ); Tue, 14 Apr 2020 12:53:56 -0400 Received: from mail.kernel.org ([198.145.29.99]:55518 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2440340AbgDNQtQ (ORCPT ); Tue, 14 Apr 2020 12:49:16 -0400 Received: from mail.kernel.org (ip5f5ad4d8.dynamic.kabel-deutschland.de [95.90.212.216]) (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 42236221F6; Tue, 14 Apr 2020 16:49:03 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1586882943; bh=HotOvguNSrEPHftfF9hKyBfJBsne6Ihdoy/T4tXbhYE=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=prVWUfSoL29beoF3B8BnWxinw0hgTYZ9QutzwrR5I+mcnioelfXrouule3uEC+8r5 8/ZE53E7GLZhJxItuhFPRr1px26DEdXpmaj99q8plWyON67f+8mLBpAeEyl33tY5b2 VQAWbSypRYasYtJaQq8C3MxOFRFyK5GDv81Na4Rc= Received: from mchehab by mail.kernel.org with local (Exim 4.92.3) (envelope-from ) id 1jOOk9-0068nN-Hg; Tue, 14 Apr 2020 18:49:01 +0200 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Jonathan Corbet , Alexander Viro , linux-fsdevel@vger.kernel.org Subject: [PATCH v2 31/33] fs: inode.c: get rid of docs warnings Date: Tue, 14 Apr 2020 18:48:57 +0200 Message-Id: X-Mailer: git-send-email 2.25.2 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Use *foo makes the toolchain to think that this is an emphasis, causing those warnings: ./fs/inode.c:1609: WARNING: Inline emphasis start-string without end-string. ./fs/inode.c:1609: WARNING: Inline emphasis start-string without end-string. ./fs/inode.c:1615: WARNING: Inline emphasis start-string without end-string. So, use, instead, ``*foo``, in order to mark it as a literal block. Signed-off-by: Mauro Carvalho Chehab --- fs/inode.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/fs/inode.c b/fs/inode.c index 93d9252a00ab..37226a9cfa4f 100644 --- a/fs/inode.c +++ b/fs/inode.c @@ -1606,14 +1606,14 @@ EXPORT_SYMBOL(iput); * @inode: inode owning the block number being requested * @block: pointer containing the block to find * - * Replaces the value in *block with the block number on the device holding + * Replaces the value in ``*block`` with the block number on the device holding * corresponding to the requested block number in the file. * That is, asked for block 4 of inode 1 the function will replace the - * 4 in *block, with disk block relative to the disk start that holds that + * 4 in ``*block``, with disk block relative to the disk start that holds that * block of the file. * * Returns -EINVAL in case of error, 0 otherwise. If mapping falls into a - * hole, returns 0 and *block is also set to 0. + * hole, returns 0 and ``*block`` is also set to 0. */ int bmap(struct inode *inode, sector_t *block) { -- 2.25.2