From patchwork Wed May 22 20:50:30 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Corbet X-Patchwork-Id: 164894 Delivered-To: patch@linaro.org Received: by 2002:a92:9e1a:0:0:0:0:0 with SMTP id q26csp1328290ili; Wed, 22 May 2019 13:51:05 -0700 (PDT) X-Google-Smtp-Source: APXvYqxp9qYZiTRK9saHdg1SYWpvaasNj+00DqTjTzeb3cM4vNKFLp/Be4iBMpsb5fWSFSMRiXwv X-Received: by 2002:a17:902:8ec4:: with SMTP id x4mr10200537plo.249.1558558265226; Wed, 22 May 2019 13:51:05 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1558558265; cv=none; d=google.com; s=arc-20160816; b=GAdP3yaFCKS1RBXVLePiOU8JIMw8SOzj2F/wO5qKHu2DVQdHuYxd3ZyzpQ7SzGCMCY Xo0Yowd+HaxYrcxHJA+1IzBGv9Ts1pUCdHg2wp+axs0VYHJoE/H8kfhzR4aYE9prkhkN /+72bzQKL9CvE+I5ocJJxB2bYFri52lmbiZsJrtygYMw1IZiy+GPeGSCEUVzyvBxffBb +zseFKGSbZxDX3I+rmgAEin/iqY1COv9qWEixsWgLnKynntNngnKb0mnuz9RC1XSWMJ/ LkQftwif09MP2NqjHjCWmonjhSrGKDsHUvTsjcjxmDMRbb490UsPrgxJpECp9S1tJm9m Pfzg== 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; bh=IJvioq1BFZcYj8e84m3Ottwv2C5Xrbu5UWSb1TznFaA=; b=h3Qi9b2DeMq+gWCSNECFgf4NLx1EsR9aC/QTm8WIsJlVcDvsgALBLwAsE0mU71HPEq DbyPXeUUP02ICUAJ5vtn4cVoCGDcD74B71JT693AIsv4IN39IxaT/XmOCE7mmWPAh3Sj TE+VychmZ2XIp6ITDr8BvS2w0Qum/Cx0y6sbCrYre/4No5QOc7iEaUoCgHccj5IksbuG /yS6j8LqYqg+1CRFPzVVi8KzxMp0tRPUU0+esTozfgy7Xd9C+jBJQSbNfU/1Wm5yBLe3 ZrUCmDPnkj+z0eGEfNfPTn3mNTkUGH3TSvwVGSC9MgKGJwqV5FHGjDrcjlp/CN8uaAbe J85Q== 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 cp7si27333432plb.14.2019.05.22.13.51.04; Wed, 22 May 2019 13:51:05 -0700 (PDT) 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 S1730393AbfEVUvE (ORCPT + 30 others); Wed, 22 May 2019 16:51:04 -0400 Received: from ms.lwn.net ([45.79.88.28]:49324 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1730292AbfEVUu6 (ORCPT ); Wed, 22 May 2019 16:50:58 -0400 Received: from meer.lwn.net (localhost [127.0.0.1]) by ms.lwn.net (Postfix) with ESMTPA id CD9A812B3; Wed, 22 May 2019 20:50:57 +0000 (UTC) From: Jonathan Corbet To: linux-doc@vger.kernel.org Cc: linux-kernel@vger.kernel.org, Jani Nikula , Markus Heiser , Mauro Carvalho Chehab , Oleksandr Natalenko , Jonathan Corbet , George Spelvin Subject: [PATCH 4/8] lib/list_sort: fix kerneldoc build error Date: Wed, 22 May 2019 14:50:30 -0600 Message-Id: <20190522205034.25724-5-corbet@lwn.net> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190522205034.25724-1-corbet@lwn.net> References: <20190522205034.25724-1-corbet@lwn.net> MIME-Version: 1.0 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Commit 043b3f7b6388 ("lib/list_sort: simplify and remove MAX_LIST_LENGTH_BITS") added some useful kerneldoc info, but also broke the docs build: ./lib/list_sort.c:128: WARNING: Definition list ends without a blank line; unexpected unindent. ./lib/list_sort.c:161: WARNING: Unexpected indentation. ./lib/list_sort.c:162: WARNING: Block quote ends without a blank line; unexpected unindent. Fix the offending literal block and make the error go away. Fixes: 043b3f7b6388 ("lib/list_sort: simplify and remove MAX_LIST_LENGTH_BITS") Cc: George Spelvin Signed-off-by: Jonathan Corbet --- lib/list_sort.c | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) -- 2.21.0 diff --git a/lib/list_sort.c b/lib/list_sort.c index 06e900c5587b..712ed1f4eb64 100644 --- a/lib/list_sort.c +++ b/lib/list_sort.c @@ -120,7 +120,8 @@ static void merge_final(void *priv, cmp_func cmp, struct list_head *head, * The latter offers a chance to save a few cycles in the comparison * (which is used by e.g. plug_ctx_cmp() in block/blk-mq.c). * - * A good way to write a multi-word comparison is + * A good way to write a multi-word comparison is:: + * * if (a->high != b->high) * return a->high > b->high; * if (a->middle != b->middle)