Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18;
Date:   Fri, 17 Jul 2020 13:50:27 -0600
From:   Jonathan Corbet <corbet@lwn.net>
To:     Randy Dunlap <rdunlap@infradead.org>
Cc:     "Daniel W. S. Almeida" <dwlsalmeida@gmail.com>, mchehab@kernel.org,
        linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org
Subject: Re: [PATCH 13/25] Documentation: watch_queue.rst: fix sphinx
 warnings
Message-ID: <20200717135027.15d8bdb4@lwn.net>
In-Reply-To: <cf5f2227-c473-442b-7ad4-5ca3718a6672@infradead.org>
References: <20200717185624.2009393-1-dwlsalmeida@gmail.com>
        <20200717185624.2009393-13-dwlsalmeida@gmail.com>
        <cf5f2227-c473-442b-7ad4-5ca3718a6672@infradead.org>
Organization: LWN.net
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 8bit
Sender: linux-kernel-owner@vger.kernel.org
Precedence: bulk

On Fri, 17 Jul 2020 12:42:52 -0700
Randy Dunlap <rdunlap@infradead.org> 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