From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on archive.lwn.net X-Spam-Level: X-Spam-Status: No, score=-5.8 required=5.0 tests=DKIM_INVALID,DKIM_SIGNED, MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI,SPF_HELO_NONE,SPF_NONE autolearn=ham autolearn_force=no version=3.4.2 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by archive.lwn.net (Postfix) with ESMTP id 2CD937D2EF for ; Wed, 5 Jun 2019 10:19:38 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727104AbfFEKTh (ORCPT ); Wed, 5 Jun 2019 06:19:37 -0400 Received: from casper.infradead.org ([85.118.1.10]:43968 "EHLO casper.infradead.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727083AbfFEKTh (ORCPT ); Wed, 5 Jun 2019 06:19:37 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=Content-Transfer-Encoding:Content-Type: MIME-Version:References:In-Reply-To:Message-ID:Subject:Cc:To:From:Date:Sender :Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help: List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=NdzflC4Gr8040iG9lX4cUUuc9anxbj+Ahlf/+7okbes=; b=EL3kHoOVTXGy+KW2xPo+W+a2QU uNEpWKc3YYCfEzzNwBmnkjaUEttxGHoMoogxPxFwnynlct5+azuC6t/BW70DZ5sXuF/1OCSn4XWEb H+fNvzbooSlncqfb8H5gUhgfzfobMHIEN7MHMrqBLvkgjz8rlfv9fdxMc2VUkMbX4S7Fr76aviirI gWkSgh5CkSqr4iCOv4MHlh7O1+R9CAzUD79Y6PnTNbBiRXvXV/aPN91NHqeOKmKkFAQaM7imMpPWn NkxRQug79Ozu4qoIH7VJwtLYq2qqE2qsZIW5jZczyj/RgMGr8OFHd5q9tbG/TXpC4CmDKUMNB/64Z AUONcWCg==; Received: from [179.182.172.34] (helo=coco.lan) by casper.infradead.org with esmtpsa (Exim 4.90_1 #2 (Red Hat Linux)) id 1hYT13-00021g-8L; Wed, 05 Jun 2019 10:19:33 +0000 Date: Wed, 5 Jun 2019 07:19:28 -0300 From: Mauro Carvalho Chehab To: David Howells Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Jonathan Corbet , keyrings@vger.kernel.org Subject: Re: [PATCH v2 15/22] docs: security: core.rst: Fix several warnings Message-ID: <20190605071928.704558cf@coco.lan> In-Reply-To: <26617.1559728436@warthog.procyon.org.uk> References: <21350864823e07cc951e1dc7f0601baa09920ac4.1559656538.git.mchehab+samsung@kernel.org> <26617.1559728436@warthog.procyon.org.uk> X-Mailer: Claws Mail 3.17.3 (GTK+ 2.24.32; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: linux-doc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org Em Wed, 05 Jun 2019 10:53:56 +0100 David Howells escreveu: > Mauro Carvalho Chehab wrote: > > > + * ``asym_eds_op`` and ``asym_verify_signature``:: > > + > > + int (*asym_eds_op)(struct kernel_pkey_params *params, > > + const void *in, void *out); > > + int (*asym_verify_signature)(struct kernel_pkey_params *params, > > + const void *in, const void *in2); > > That's redundant and shouldn't be necessary. This should equally fix it: * :: int (*asym_eds_op)(struct kernel_pkey_params *params, const void *in, void *out); int (*asym_verify_signature)(struct kernel_pkey_params *params, const void *in, const void *in2); The thing is that we need to teach Sphinx somehow that it should not try to interpret '*' (with is used there to identify bold/italy blocks) Using a '::' seems better than escaping all asterisks with a backslash. Thanks, Mauro