Re: [PATCH 1/3] docs-rst: infiniband: Convert user verbs doc to rst

[Joel Nider]

Jonathan Corbet <corbet@xxxxxxx> wrote on 01/14/2019 07:34:21 PM:

> From: Jonathan Corbet <corbet@xxxxxxx>
> To: Jason Gunthorpe <jgg@xxxxxxxx>
> Cc: Joel Nider <joeln@xxxxxxxxxx>, Leon Romanovsky <leon@xxxxxxxxxx>, 
Doug 
> Ledford <dledford@xxxxxxxxxx>, Mike Rapoport <rppt@xxxxxxxxxxxxx>, 
linux-
> doc@xxxxxxxxxxxxxxx, linux-kernel@xxxxxxxxxxxxxxx
> Date: 01/14/2019 07:37 PM
> Subject: Re: [PATCH 1/3] docs-rst: infiniband: Convert user verbs doc to 
rst
> 
> On Mon, 14 Jan 2019 09:56:21 -0700
> Jason Gunthorpe <jgg@xxxxxxxx> wrote:
> 
> > >  Documentation/infiniband/user_verbs.rst | 70 
+++++++++++++++++++++++++++++++++
> > >  Documentation/infiniband/user_verbs.txt | 69 
--------------------------------
> > >  2 files changed, 70 insertions(+), 69 deletions(-)
> > >  create mode 100644 Documentation/infiniband/user_verbs.rst
> > >  delete mode 100644 Documentation/infiniband/user_verbs.txt 
> > 
> > Thanks for getting this going Joel, I've been mulling over writing 
more
> > docs for this area for a while now.
> > 
> > Jonathan/linux-doc: Can you Ack at least the build system parts of
> > this please? I can take it through the rdma tree, unless you prefer
> > otherwise?
> 
> Can I make a request?  This appears to be user-oriented documentation; 
can
> we please place it into the userspace-api manual, rather than keeping it
> in its own silo?

I knew someone was going to ask me to do that :-)
I agree that userspace stuff should all be together, but I guess for 
historical reasons this one stayed in the infiniband section. So if Jason 
is ok with moving the doc, I'll take a look in the morning to see how best 
to work that into the patchset.

> Thanks,
> 
> jon
>