lkml.org 
[lkml]   [2020]   [Oct]   [1]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
SubjectRe: [PATCH v4 41/52] docs: kgdb.rst: fix :c:type: usages
On Wed, Sep 30, 2020 at 03:25:04PM +0200, Mauro Carvalho Chehab wrote:
> Which Sphinx 3, :c:type: can't be used anymore for structs,
> as this should be used only for typedefs.
>
> Rely on automarkup.py for struct references.
>
> This file has an special case, though: it uses the tag also
> to point to an array. Let's use, instead, :c:expr: for such
> purpose, as it should do the right thing.
>
> This should fix this warning:
>
> ./Documentation/dev-tools/kgdb.rst:875: WARNING: Unparseable C cross-reference: 'kdb_poll_funcs[]'
> Invalid C declaration: Expected end of definition. [error at 14]
> kdb_poll_funcs[]
> --------------^
>
> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>

Acked-by: Daniel Thompson <daniel.thompson@linaro.org>


Daniel.


> ---
> Documentation/dev-tools/kgdb.rst | 6 +++---
> 1 file changed, 3 insertions(+), 3 deletions(-)
>
> diff --git a/Documentation/dev-tools/kgdb.rst b/Documentation/dev-tools/kgdb.rst
> index c908ef4d3f04..77b688e6a254 100644
> --- a/Documentation/dev-tools/kgdb.rst
> +++ b/Documentation/dev-tools/kgdb.rst
> @@ -726,7 +726,7 @@ The kernel debugger is organized into a number of components:
> - contains an arch-specific trap catcher which invokes
> kgdb_handle_exception() to start kgdb about doing its work
>
> - - translation to and from gdb specific packet format to :c:type:`pt_regs`
> + - translation to and from gdb specific packet format to struct pt_regs
>
> - Registration and unregistration of architecture specific trap
> hooks
> @@ -846,7 +846,7 @@ invokes a callback in the serial core which in turn uses the callback in
> the UART driver.
>
> When using kgdboc with a UART, the UART driver must implement two
> -callbacks in the :c:type:`struct uart_ops <uart_ops>`.
> +callbacks in the struct uart_ops.
> Example from ``drivers/8250.c``::
>
>
> @@ -875,7 +875,7 @@ kernel when ``CONFIG_KDB_KEYBOARD=y`` is set in the kernel configuration.
> The core polled keyboard driver for PS/2 type keyboards is in
> ``drivers/char/kdb_keyboard.c``. This driver is hooked into the debug core
> when kgdboc populates the callback in the array called
> -:c:type:`kdb_poll_funcs[]`. The kdb_get_kbd_char() is the top-level
> +:c:expr:`kdb_poll_funcs[]`. The kdb_get_kbd_char() is the top-level
> function which polls hardware for single character input.
>
> kgdboc and kms
> --
> 2.26.2
>

\
 
 \ /
  Last update: 2020-10-01 13:30    [W:0.498 / U:5.996 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site