From patchwork Sun Jun 9 16:42:29 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Greg KH X-Patchwork-Id: 166232 Delivered-To: patch@linaro.org Received: by 2002:a92:4782:0:0:0:0:0 with SMTP id e2csp54040ilk; Sun, 9 Jun 2019 09:49:22 -0700 (PDT) X-Google-Smtp-Source: APXvYqzCJodn6bnO1uAo4K02fJ4KFGMhI3c09AVq0Zg8Hoy50vuRSnTrzG9SmVjuAYc2Oeyn5adL X-Received: by 2002:a17:902:b691:: with SMTP id c17mr43884445pls.107.1560098962199; Sun, 09 Jun 2019 09:49:22 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1560098962; cv=none; d=google.com; s=arc-20160816; b=oXomIOcfKn8yzum0vMdC2miF4Uv1CGGxA24rO8GRmEb+d6fFzWcxadxfHdyghC8/Pn QC7+fHs2uNO+lENuxAMQhCbWxBsHR6Wc/DKVlZV/LFACKBNPOz5x5lPg9F4YervlZwKp SjyYvAg2SfTVGqTbvuQaen0EUG6rNQu24QAJVAfB96Rf3HZWjrkrSTiecxdi2KGBQM0z rV4LNrPIGCtsqEXShJt4E5ZnZ7T2bODJmyu443jzg30Or9WstIHXdhmFdlAfkks8B6Sx MChk1NJ1+KwQ5Hu8NtMHAab667I10EsOjId6P8Zg37vPBYOnIoHH2rBWVN0kMsrwf9Ff J+dw== 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 :user-agent:references:in-reply-to:message-id:date:subject:cc:to :from:dkim-signature; bh=uzX5+SvupaQRuaSBZdotRd0uokDRIX95PouopcHVFe0=; b=HNXoOSlNafdvgppkTXzBJFebzp0CBdgs6PSE45zirbY5pnaZm8nq1ueOwS0cVZOB+8 b9Y1ZPqEc+3c/K41Kv4ucl808CWh0jrKbLT76B1jLDveKwCT3pd5TZW+PDx4IXo3Pb8D OJ/zJJdXjgj3H1KUY34CsgofNQW4yd5pvbyBDQWM0YgsfgsYVfVSTB6L0RGvVI5RfVup 1Xjnb+ykPkUTMbronymHfu53wow07BhpeljJtntL5DBM4CdoCeTHyJzGa7AIxKlCvFk4 aoQLKvyUa3lnGjvDlqrC0IG0Z1sEdv0hj9BBCYffj+sjjAQBrxk/oS+BvDzIjJv9hHwi 8RsA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=q0VodXED; 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 k19si7522088pgh.143.2019.06.09.09.49.21; Sun, 09 Jun 2019 09:49:22 -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; dkim=pass header.i=@kernel.org header.s=default header.b=q0VodXED; 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 S1730801AbfFIQtV (ORCPT + 30 others); Sun, 9 Jun 2019 12:49:21 -0400 Received: from mail.kernel.org ([198.145.29.99]:48564 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1731412AbfFIQtL (ORCPT ); Sun, 9 Jun 2019 12:49:11 -0400 Received: from localhost (83-86-89-107.cable.dynamic.v4.ziggo.nl [83.86.89.107]) (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 A7127206DF; Sun, 9 Jun 2019 16:49:10 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1560098951; bh=gDN3Royv62WSTTTpPYuCAZqOoHLWjI5lA2MMTSlDF8o=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=q0VodXEDqY1Eoies2fsFmQxqByhQEfQiqn+t+G82FAX7xEu9H18NkVrkYG4C0Nm8M YLPX1M/6LXQdzyCcKHBizvm5XZ6WgBxEJCSncZ9FRzbkfwi/gr9Mk+lO4w1sgeLWD0 gFtRVtjzrnqQhRuPY5iMoKkPQenaDoevm3RPn4VM= From: Greg Kroah-Hartman To: linux-kernel@vger.kernel.org Cc: Greg Kroah-Hartman , stable@vger.kernel.org, Jani Nikula , Jonathan Corbet Subject: [PATCH 4.19 48/51] drm/i915: Maintain consistent documentation subsection ordering Date: Sun, 9 Jun 2019 18:42:29 +0200 Message-Id: <20190609164130.697342252@linuxfoundation.org> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190609164127.123076536@linuxfoundation.org> References: <20190609164127.123076536@linuxfoundation.org> User-Agent: quilt/0.66 MIME-Version: 1.0 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: Jonathan Corbet commit 551bd3368a7b3cfef01edaade8970948d178d40a upstream. With Sphinx 2.0 (or prior versions with the deprecation warnings fixed) the docs build fails with: Documentation/gpu/i915.rst:403: WARNING: Title level inconsistent: Global GTT Fence Handling ~~~~~~~~~~~~~~~~~~~~~~~~~ reST markup error: Documentation/gpu/i915.rst:403: (SEVERE/4) Title level inconsistent: I "fixed" it by changing the subsections in i915.rst, but that didn't seem like the correct change. It turns out that a couple of i915 files create their own subsections in kerneldoc comments using apostrophes as the heading marker: Layout '''''' That breaks the normal subsection marker ordering, and newer Sphinx is rather more strict about enforcing that ordering. So fix the offending comments to make Sphinx happy. (This is unfortunate, in that kerneldoc comments shouldn't need to be aware of where they might be included in the heading hierarchy, but I don't see a better way around it). Cc: stable@vger.kernel.org # v4.14+ Acked-by: Jani Nikula Signed-off-by: Jonathan Corbet Signed-off-by: Greg Kroah-Hartman --- drivers/gpu/drm/i915/i915_reg.h | 6 +++--- drivers/gpu/drm/i915/intel_workarounds.c | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) --- a/drivers/gpu/drm/i915/i915_reg.h +++ b/drivers/gpu/drm/i915/i915_reg.h @@ -32,7 +32,7 @@ * macros. Do **not** mass change existing definitions just to update the style. * * Layout - * '''''' + * ~~~~~~ * * Keep helper macros near the top. For example, _PIPE() and friends. * @@ -78,7 +78,7 @@ * style. Use lower case in hexadecimal values. * * Naming - * '''''' + * ~~~~~~ * * Try to name registers according to the specs. If the register name changes in * the specs from platform to another, stick to the original name. @@ -96,7 +96,7 @@ * suffix to the name. For example, ``_SKL`` or ``_GEN8``. * * Examples - * '''''''' + * ~~~~~~~~ * * (Note that the values in the example are indented using spaces instead of * TABs to avoid misalignment in generated documentation. Use TABs in the --- a/drivers/gpu/drm/i915/intel_workarounds.c +++ b/drivers/gpu/drm/i915/intel_workarounds.c @@ -37,7 +37,7 @@ * costly and simplifies things. We can revisit this in the future. * * Layout - * '''''' + * ~~~~~~ * * Keep things in this file ordered by WA type, as per the above (context, GT, * display, register whitelist, batchbuffer). Then, inside each type, keep the