From patchwork Wed Apr 8 15:46:06 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mauro Carvalho Chehab X-Patchwork-Id: 11480449 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id D6B73112C for ; Wed, 8 Apr 2020 15:48:48 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id AEB3E20784 for ; Wed, 8 Apr 2020 15:48:48 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1586360928; bh=HotOvguNSrEPHftfF9hKyBfJBsne6Ihdoy/T4tXbhYE=; h=From:To:Cc:Subject:Date:In-Reply-To:References:List-ID:From; b=ZQbRXgEjoHETeIUUcJ8nAQH4NBvsTAzgJooO/5ruxv/ZndA6my0Y6fY0Ve8ftV860 KayU/KX2ylWNOdCrDIzoszaFtpYW2ECSlP6Q/dK1cJXTn1+DOz0VQMtT5lda9N8FF7 PsA3gB+hLbSc/xsCRU34lVUCnyYn4hxYscqVjqR4= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729772AbgDHPsb (ORCPT ); Wed, 8 Apr 2020 11:48:31 -0400 Received: from mail.kernel.org ([198.145.29.99]:49316 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729656AbgDHPqc (ORCPT ); Wed, 8 Apr 2020 11:46:32 -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 6826F214DB; Wed, 8 Apr 2020 15:46:31 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1586360791; bh=HotOvguNSrEPHftfF9hKyBfJBsne6Ihdoy/T4tXbhYE=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Lt+jV6NLjjSUuzvM1eh6p/kV/VaMpuQUMZVN8yaKKRxUlpPOayhxIQDzSJ1wEy0xy OzbOGzT97CWn02pDKeakWgMeP+MFRk0VTYLAjgaO8/ZEdLORAktBNo8aDkoIRwvLXW Szm00x1GzRlp+bwEsJb28bfqGazCDew33krW7rvM= Received: from mchehab by mail.kernel.org with local (Exim 4.92.3) (envelope-from ) id 1jMCuL-000cBN-JO; Wed, 08 Apr 2020 17:46:29 +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 14/35] fs: inode.c: get rid of docs warnings Date: Wed, 8 Apr 2020 17:46:06 +0200 Message-Id: <6f8105480235e30fb0193f493072b97625c8d5ea.1586359676.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.25.2 In-Reply-To: References: MIME-Version: 1.0 Sender: linux-fsdevel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-fsdevel@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) {