Received: by 2002:a05:6a10:6744:0:0:0:0 with SMTP id w4csp314297pxu; Tue, 6 Oct 2020 07:08:00 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyQYM3uh3Y9kJP7/+yCsJHTUIr5V5zPKwqqNGq7Vx6GTuMnljMb7PpwgG5KzR5je12ez8Pr X-Received: by 2002:a05:6402:d06:: with SMTP id eb6mr5491653edb.289.1601993280506; Tue, 06 Oct 2020 07:08:00 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1601993280; cv=none; d=google.com; s=arc-20160816; b=C8gstpKInOyytaGdngka1vhBZwnvFzzElXYpWTR4BnZN+h9554327zYV+cUQNCXPY0 ZwW+YfRcGpHmkLnjHW5cLxo/3VPqQl9yjOohau0ROYUNQuww9WdVCyfcSFx30pDoAldF /27ex90R89tc/xTN6QBRnD41GOzRmuRgbsJd1k69qNzeSEHt82BLkxofVQToK80MgI8l YdFqLpbseAXi/cigZkLeJ3qbkaGna87tQNDEpg75STtqTOvXEzd/bC6B+K2GtWiVxg5d 12skUb8/o1ldx4nypaPMX7cvAFxhqcaGsFSUlhIXl/n9vujxJSAL6N3oZvJ8JDOOPbHo ooZg== 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 :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=9j3ipvlGrE7WFWFk+va4dCuL067/ZlSjSOUZWG9awy4=; b=v1KLQIKi0qldu7o9jAteO87yR63jHuQnpE0PgFBYLo5gL9y1g5wjXUs3RKNfwVTyRv FVjGpBBEg0XE5BIjyZIDBR4FitvzTrqYBn31N4UYrFo3o+89AK7vVrIwdF6crUO4lft0 qqY++JDSgxxyhJJdvkcMCx3bECKR5cGeK2rW0LAnkXOfu13P+ZauKZguXpQPqwsNqQIQ ue7EhL1TwgV7goWwIu6Hwks50zG9EGsLkzvn/XbD3AzjNY1BYGJVl7qQipkICgoU3STW VT8tUd9GRZh7ZeqwDcd4Ygh/OeAECS38inGsgDLZxSIGL4yTwGeB9XczOjKJq9/9syNF 1g1Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=iMGXIwsJ; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id g1si2553062edl.158.2020.10.06.07.07.37; Tue, 06 Oct 2020 07:08:00 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=iMGXIwsJ; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726893AbgJFOFq (ORCPT + 99 others); Tue, 6 Oct 2020 10:05:46 -0400 Received: from mail.kernel.org ([198.145.29.99]:33620 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726478AbgJFOD4 (ORCPT ); Tue, 6 Oct 2020 10:03:56 -0400 Received: from mail.kernel.org (ip5f5ad5bd.dynamic.kabel-deutschland.de [95.90.213.189]) (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 A82A12220C; Tue, 6 Oct 2020 14:03:54 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1601993034; bh=t45gM+mcpDbpIhRjbW9Zpxht62jX3d9x8Bi3cqTwnL4=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=iMGXIwsJKReYrGuE8IXZQnvswFoVHmMkPlnN/xWOLFweyg+s5kMKui3R2EyDy64iG Vb0VH9jug1sYe+PTzomkBri7sCkN2ZntQkf1ib+n0P57nb15gnsVI36OA0u3BsD+dm PaWjDkbn4JHYGtu9/bbX+ccoRpyU25cqIF0Rjoh8= Received: from mchehab by mail.kernel.org with local (Exim 4.94) (envelope-from ) id 1kPnZI-0019GD-KM; Tue, 06 Oct 2020 16:03:52 +0200 From: Mauro Carvalho Chehab To: Linux Doc Mailing List , Jonathan Corbet Cc: Mauro Carvalho Chehab , =?UTF-8?q?Andr=C3=A9=20Almeida?= , Mike Rapoport , Randy Dunlap , Takashi Iwai , linux-kernel@vger.kernel.org Subject: [PATCH v5 38/52] docs: block: blk-mq.rst: get rid of :c:type Date: Tue, 6 Oct 2020 16:03:35 +0200 Message-Id: X-Mailer: git-send-email 2.26.2 In-Reply-To: References: MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Sender: Mauro Carvalho Chehab Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org The :c:type macros are not used properly there, as reported by Sphinx 3: ./Documentation/block/blk-mq.rst:112: WARNING: Unparseable C cross-reference: 'hctx->dispatch' Invalid C declaration: Expected end of definition. [error at 4] hctx->dispatch ----^ Also, they won't be generating any cross references. So, replace them by a literal markup. Reviewed-by: André Almeida Signed-off-by: Mauro Carvalho Chehab --- Documentation/block/blk-mq.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/block/blk-mq.rst b/Documentation/block/blk-mq.rst index 86a632af02b0..a980d23af48c 100644 --- a/Documentation/block/blk-mq.rst +++ b/Documentation/block/blk-mq.rst @@ -110,9 +110,9 @@ block layer removes requests from the associated software queues and tries to dispatch to the hardware. If it's not possible to send the requests directly to hardware, they will be -added to a linked list (:c:type:`hctx->dispatch`) of requests. Then, +added to a linked list (``hctx->dispatch``) of requests. Then, next time the block layer runs a queue, it will send the requests laying at the -:c:type:`dispatch` list first, to ensure a fairness dispatch with those +``dispatch`` list first, to ensure a fairness dispatch with those requests that were ready to be sent first. The number of hardware queues depends on the number of hardware contexts supported by the hardware and its device driver, but it will not be more than the number of cores of the system. -- 2.26.2