From patchwork Tue Jul 19 11:42:54 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Daniel Vetter X-Patchwork-Id: 9236819 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id AB46560574 for ; Tue, 19 Jul 2016 11:43:13 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 99BFC20265 for ; Tue, 19 Jul 2016 11:43:13 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 8B8E726247; Tue, 19 Jul 2016 11:43:13 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-4.1 required=2.0 tests=BAYES_00,DKIM_SIGNED, RCVD_IN_DNSWL_MED,T_DKIM_INVALID autolearn=ham version=3.3.1 Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id D382220265 for ; Tue, 19 Jul 2016 11:43:12 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 08D186E2E3; Tue, 19 Jul 2016 11:43:08 +0000 (UTC) X-Original-To: intel-gfx@lists.freedesktop.org Delivered-To: intel-gfx@lists.freedesktop.org Received: from mail-wm0-x243.google.com (mail-wm0-x243.google.com [IPv6:2a00:1450:400c:c09::243]) by gabe.freedesktop.org (Postfix) with ESMTPS id E4E926E362 for ; Tue, 19 Jul 2016 11:43:05 +0000 (UTC) Received: by mail-wm0-x243.google.com with SMTP id o80so2537977wme.0 for ; Tue, 19 Jul 2016 04:43:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ffwll.ch; s=google; h=from:to:cc:subject:date:message-id; bh=S25ZPHpK8PlziuBHz35Nguds7T0SrjWRzLLcoJD6HpI=; b=Qocjd++56CkbAbCnJJYsO+7GYUKqMC4RPxuouEuIDKNK5bvFQIPqrF+KFw6X3PTjnU dYmuNtkGfrg4UoJtWBJQcHYPFXWBDFHUvBh+gPHP/FjofJ6Xf1rrlV/cdxoOj6HUDKe4 eSpdcHSNRLPRslh6Q1uR1zqQjYMhWQtYQ0Y/k= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id; bh=S25ZPHpK8PlziuBHz35Nguds7T0SrjWRzLLcoJD6HpI=; b=GxkVwN7vnU/3wl0CNJmUQAtiDk4IXsGOjhkVLL4ziQ6sZ8vbauMA3Oc39xSYrETvk7 8i6YfQ/GqSK9jymJkhS1mZASK5zQfocSXKAjlsfEzboeZafa18/ItIJ9L1xe1UsN23IA pUTDh+2lNVEYk1eazSaNdgTw7u4nvZbgeo5+r9UOMNJKiLIJRK1mLAMbOs0kjY17Z/mE oY3QbiFRogNA0UmbXrLCjmasxM4hF8MuXUp0BJZlEU4fKVH6KIA3N/Q87yPmX7hdjMnr aNAbU7Y0etO9WPxgcmf/RQNMJEFb9IvJnEfRoN2S9m4xAMkrHPG143Z+0sa07HCS9tJJ ToUg== X-Gm-Message-State: ALyK8tLjLkQjjFeMV0QhI36cgyJP/9TqZNgkODK9ZmE/wI4Rw1pg8GMQO9mTGZYE07NIQw== X-Received: by 10.28.4.194 with SMTP id 185mr3732973wme.91.1468928582901; Tue, 19 Jul 2016 04:43:02 -0700 (PDT) Received: from phenom.ffwll.local ([2a02:168:56b5:0:ac27:b86c:7764:9429]) by smtp.gmail.com with ESMTPSA id r16sm22205901wme.16.2016.07.19.04.43.01 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 19 Jul 2016 04:43:02 -0700 (PDT) From: Daniel Vetter To: DRI Development Date: Tue, 19 Jul 2016 13:42:54 +0200 Message-Id: <1468928575-11309-1-git-send-email-daniel.vetter@ffwll.ch> X-Mailer: git-send-email 2.8.1 Cc: Markus Heiser , Jonathan Corbet , Daniel Vetter , Intel Graphics Development , linux-doc@vger.kernel.org, Daniel Vetter Subject: [Intel-gfx] [PATCH 1/2] doc/sphinx: Enable keep_warnings X-BeenThere: intel-gfx@lists.freedesktop.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Intel graphics driver community testing & development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" X-Virus-Scanned: ClamAV using ClamSMTP Unfortunately warnings generated after parsing in sphinx can end up with entirely bogus files and line numbers as sources. Strangely for outright errors this is not a problem. Trying to convert warnings to errors also doesn't fix it. The only way to get useful output out of sphinx to be able to root cause the error seems to be enabling keep_warnings, which inserts a System Message into the actual output. Not pretty at all, but I don't really want to fix up core rst/sphinx code, and this gets the job done meanwhile. Cc: Markus Heiser Cc: Jonathan Corbet Cc: linux-doc@vger.kernel.org Signed-off-by: Daniel Vetter --- Documentation/conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/conf.py b/Documentation/conf.py index 6cc41a0555a3..a131139675cc 100644 --- a/Documentation/conf.py +++ b/Documentation/conf.py @@ -125,7 +125,7 @@ pygments_style = 'sphinx' #modindex_common_prefix = [] # If true, keep warnings as "system message" paragraphs in the built documents. -#keep_warnings = False +keep_warnings = True # If true, `todo` and `todoList` produce output, else they produce nothing. todo_include_todos = False