Received: by 2002:a25:8b91:0:0:0:0:0 with SMTP id j17csp2648067ybl; Mon, 20 Jan 2020 06:53:26 -0800 (PST) X-Google-Smtp-Source: APXvYqzivlGeNL8HUVY6cyqO3tUnAFdcqaTYmgX6wCiBAAjYif2p/oiOOtmRbJNOJYCpObfVJkFz X-Received: by 2002:a9d:68d3:: with SMTP id i19mr15396312oto.71.1579532006264; Mon, 20 Jan 2020 06:53:26 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1579532006; cv=none; d=google.com; s=arc-20160816; b=KkPksRKzuTZMGUzKiKeCAFvAptSctfhH4wOmFCbdWwhcUtoF6VBOpg0uLTshCiJBB+ 5S/eEIob2kSzxLQHZ1Y4v3NqwGioPParMi7rlkQdySMjFzLGR2Z1ZPTrXEUdP6Ng46xU Jqt+ATRzMxupYVv0n5Vrk3xiQOAe32g1DDLHJTreFTauCZdz+fYUL8Prw7vQ+hSsmZZL Cx74dor05Ma/GOiR/Gobe7N0lfaRTjyjM6yv3+wGshEl75g/UF99F0sfa1aS6IKgWJy6 tIgnPnbtay8bmQ9v8FTXym8djk3+7BNK9I07VMuDh7/JEhupmUn2gp+KHf55mResPcoc kfUA== 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 :organization:references:in-reply-to:message-id:subject:cc:to:from :date; bh=s+DeLRyW9M4zVTlT1wtowyaKjbWL2mPMWFDLlC2pzOE=; b=oFcJQRDCOg8ssUHrgToYRPc+x0TzItSaS7Re7rERJqTtEc8BHR20uYtfWBAAafUdQY KTtyAl6Jt2mizCpGMxbMM/yRM3Vgr818bJQArn4jaN2YxAHKOao6THM9mQMO4+ZZUj8B aqTWjDjAF6Bn4zD/A/QFWudX3+j1+lYe8MFRvF5DDAO8byXif0aCEGyOWBvcW6JTzJUX XUQn5Cbbx9WWQ1piZKSLLAqeZi/r4Fg9dzuM2MbNkW/KgmGbHfiB8lfmK1AoCAYVzJRj Zshb5rB1LFLGypPEiRgQdwaSCQGPCWdBnDi1mGhi01Wc3PXGru6s3RB6B5X/c1cXCsYm gP0Q== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id o20si19132249otl.60.2020.01.20.06.53.14; Mon, 20 Jan 2020 06:53:26 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728843AbgATOvL (ORCPT + 99 others); Mon, 20 Jan 2020 09:51:11 -0500 Received: from mx2.suse.de ([195.135.220.15]:42442 "EHLO mx2.suse.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726642AbgATOvL (ORCPT ); Mon, 20 Jan 2020 09:51:11 -0500 X-Virus-Scanned: by amavisd-new at test-mx.suse.de Received: from relay2.suse.de (unknown [195.135.220.254]) by mx2.suse.de (Postfix) with ESMTP id 91FE9B1E5; Mon, 20 Jan 2020 14:51:09 +0000 (UTC) Date: Mon, 20 Jan 2020 15:51:07 +0100 From: Jean Delvare To: Luca Ceresoli Cc: linux-doc@vger.kernel.org, linux-i2c@vger.kernel.org, Wolfram Sang , Peter Rosin , linux-kernel@vger.kernel.org Subject: Re: [PATCH 16/26] docs: i2c: smbus-protocol: fix kernel-doc function syntax Message-ID: <20200120155107.1b3d5e86@endymion> In-Reply-To: <20200105225012.11701-16-luca@lucaceresoli.net> References: <20200105224006.10321-1-luca@lucaceresoli.net> <20200105225012.11701-1-luca@lucaceresoli.net> <20200105225012.11701-16-luca@lucaceresoli.net> Organization: SUSE Linux X-Mailer: Claws Mail 3.17.4 (GTK+ 2.24.32; x86_64-suse-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Sun, 5 Jan 2020 23:50:02 +0100, Luca Ceresoli wrote: > This clarifies these are functions (and would/will adds a hyperlink to the > function documentation if/when documented). > > Signed-off-by: Luca Ceresoli > --- > Documentation/i2c/smbus-protocol.rst | 4 ++-- > 1 file changed, 2 insertions(+), 2 deletions(-) > > diff --git a/Documentation/i2c/smbus-protocol.rst b/Documentation/i2c/smbus-protocol.rst > index 997945e90419..3c0fb3a2044d 100644 > --- a/Documentation/i2c/smbus-protocol.rst > +++ b/Documentation/i2c/smbus-protocol.rst > @@ -118,7 +118,7 @@ byte. But this time, the data is a complete word (16 bits):: > > Functionality flag: I2C_FUNC_SMBUS_READ_WORD_DATA > > -Note the convenience function i2c_smbus_read_word_swapped is > +Note the convenience function i2c_smbus_read_word_swapped() is > available for reads where the two data bytes are the other way > around (not SMBus compliant, but very popular.) > > @@ -152,7 +152,7 @@ specified through the Comm byte.:: > > Functionality flag: I2C_FUNC_SMBUS_WRITE_WORD_DATA > > -Note the convenience function i2c_smbus_write_word_swapped is > +Note the convenience function i2c_smbus_write_word_swapped() is > available for writes where the two data bytes are the other way > around (not SMBus compliant, but very popular.) > Reviewed-by: Jean Delvare -- Jean Delvare SUSE L3 Support