Return-Path: <linux-kernel-owner@vger.kernel.org>
Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand
        id S1751488AbdIQB0I (ORCPT <rfc822;w@1wt.eu>);
        Sat, 16 Sep 2017 21:26:08 -0400
Received: from bombadil.infradead.org ([65.50.211.133]:49412 "EHLO
        bombadil.infradead.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org
        with ESMTP id S1751451AbdIQB0G (ORCPT
        <rfc822;linux-kernel@vger.kernel.org>);
        Sat, 16 Sep 2017 21:26:06 -0400
To: LKML <linux-kernel@vger.kernel.org>,
        "linux-doc@vger.kernel.org" <linux-doc@vger.kernel.org>,
        "Paul E. McKenney" <paulmck@linux.vnet.ibm.com>
From: Randy Dunlap <rdunlap@infradead.org>
Subject: rcu kernel-doc issues (4.14-rc1)
Cc: Jonathan Corbet <corbet@lwn.net>
Message-ID: <fe9c6796-f308-6905-a058-6c6e537fde13@infradead.org>
Date: Sat, 16 Sep 2017 18:26:04 -0700
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101
 Thunderbird/52.3.0
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Language: en-US
Content-Transfer-Encoding: 7bit
Sender: linux-kernel-owner@vger.kernel.org
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org
Content-Length: 2521
Lines: 77

On 4.14-rc1, I am seeing lots of warnings on rcu kernel-doc:

.. kernel-doc:: include/linux/rcupdate.h
   :external:
./Documentation/core-api/kernel-api.rst:357: ERROR: Error in "kernel-doc" directive:
unknown option: "external".

.. kernel-doc:: include/linux/rcupdate_wait.h
   :external:
./Documentation/core-api/kernel-api.rst:360: ERROR: Error in "kernel-doc" directive:
unknown option: "external".

.. kernel-doc:: include/linux/rcutree.h
   :external:
./Documentation/core-api/kernel-api.rst:363: ERROR: Error in "kernel-doc" directive:
unknown option: "external".

.. kernel-doc:: kernel/rcu/tree.c
   :external:
./Documentation/core-api/kernel-api.rst:366: ERROR: Error in "kernel-doc" directive:
unknown option: "external".

.. kernel-doc:: kernel/rcu/tree_plugin.h
   :external:
./Documentation/core-api/kernel-api.rst:369: ERROR: Error in "kernel-doc" directive:
unknown option: "external".

.. kernel-doc:: kernel/rcu/tree_exp.h
   :external:
./Documentation/core-api/kernel-api.rst:372: ERROR: Error in "kernel-doc" directive:
unknown option: "external".

.. kernel-doc:: kernel/rcu/update.c
   :external:
./Documentation/core-api/kernel-api.rst:375: ERROR: Error in "kernel-doc" directive:
unknown option: "external".

.. kernel-doc:: include/linux/srcu.h
   :external:
./Documentation/core-api/kernel-api.rst:378: ERROR: Error in "kernel-doc" directive:
unknown option: "external".

.. kernel-doc:: kernel/rcu/srcutree.c
   :external:
./Documentation/core-api/kernel-api.rst:381: ERROR: Error in "kernel-doc" directive:
unknown option: "external".

.. kernel-doc:: include/linux/rculist_bl.h
   :external:
./Documentation/core-api/kernel-api.rst:384: ERROR: Error in "kernel-doc" directive:
unknown option: "external".

.. kernel-doc:: include/linux/rculist.h
   :external:
./Documentation/core-api/kernel-api.rst:387: ERROR: Error in "kernel-doc" directive:
unknown option: "external".

.. kernel-doc:: include/linux/rculist_nulls.h
   :external:
./Documentation/core-api/kernel-api.rst:390: ERROR: Error in "kernel-doc" directive:
unknown option: "external".

.. kernel-doc:: include/linux/rcu_sync.h
   :external:
./Documentation/core-api/kernel-api.rst:393: ERROR: Error in "kernel-doc" directive:
unknown option: "external".

.. kernel-doc:: kernel/rcu/sync.c
   :external:

../kernel/rcu/tree.c:3091: ERROR: Unexpected indentation.
../kernel/rcu/tree.c:3118: ERROR: Unexpected indentation.
../kernel/rcu/tree.c:3119: WARNING: Bullet list ends without a blank line; unexpected unindent.


-- 
~Randy