Re: [PATCH 13/25] Documentation: watch_queue.rst: fix sphinx warnings

From: Jonathan Corbet
Date: Fri Jul 17 2020 - 15:50:30 EST


On Fri, 17 Jul 2020 12:42:52 -0700
Randy Dunlap <rdunlap@xxxxxxxxxxxxx> wrote:

> > - * ``int remove_watch_from_object(struct watch_list *wlist,
> > - struct watch_queue *wqueue,
> > - u64 id, false);``
> > + * ``int remove_watch_from_object(struct watch_list *wlist,``
> > + ``struct watch_queue *wqueue,``
> > + ``u64 id, false);``
> >
> > Remove a watch from a watch list, where the watch must match the specified
> > watch queue (``wqueue``) and object identifier (``id``). A notification
> >
>
> Wow. If that's what it takes, well, OK, but it's sad IMHO.

It seems like it might be better to remove the quoting altogether? Either
that or just make a literal block.

jon