From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jason Gunthorpe Subject: Re: [PATCH v3 13/33] docs: infiniband: convert docs to ReST and rename to *.rst Date: Mon, 10 Jun 2019 14:27:12 -0300 Message-ID: <20190610172712.GG18468@ziepe.ca> References: <09036fdb89c4bec94cb92d25398c026afdb134e7.1560045490.git.mchehab+samsung@kernel.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Content-Disposition: inline In-Reply-To: <09036fdb89c4bec94cb92d25398c026afdb134e7.1560045490.git.mchehab+samsung@kernel.org> Sender: linux-kernel-owner@vger.kernel.org To: Mauro Carvalho Chehab Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Jonathan Corbet , Doug Ledford , linux-rdma@vger.kernel.org List-Id: linux-rdma@vger.kernel.org On Sat, Jun 08, 2019 at 11:27:03PM -0300, Mauro Carvalho Chehab wrote: > The InfiniBand docs are plain text with no markups. > So, all we needed to do were to add the title markups and > some markup sequences in order to properly parse tables, > lists and literal blocks. > > At its new index.rst, let's add a :orphan: while this is not linked to > the main index.rst file, in order to avoid build warnings. > > Signed-off-by: Mauro Carvalho Chehab > --- > .../{core_locking.txt => core_locking.rst} | 64 ++++++----- > Documentation/infiniband/index.rst | 23 ++++ > .../infiniband/{ipoib.txt => ipoib.rst} | 24 ++-- > .../infiniband/{opa_vnic.txt => opa_vnic.rst} | 108 +++++++++--------- > .../infiniband/{sysfs.txt => sysfs.rst} | 4 +- > .../{tag_matching.txt => tag_matching.rst} | 5 + > .../infiniband/{user_mad.txt => user_mad.rst} | 33 ++++-- > .../{user_verbs.txt => user_verbs.rst} | 12 +- > drivers/infiniband/core/user_mad.c | 2 +- > drivers/infiniband/ulp/ipoib/Kconfig | 2 +- > 10 files changed, 174 insertions(+), 103 deletions(-) > rename Documentation/infiniband/{core_locking.txt => core_locking.rst} (78%) > create mode 100644 Documentation/infiniband/index.rst > rename Documentation/infiniband/{ipoib.txt => ipoib.rst} (90%) > rename Documentation/infiniband/{opa_vnic.txt => opa_vnic.rst} (63%) > rename Documentation/infiniband/{sysfs.txt => sysfs.rst} (69%) > rename Documentation/infiniband/{tag_matching.txt => tag_matching.rst} (98%) > rename Documentation/infiniband/{user_mad.txt => user_mad.rst} (90%) > rename Documentation/infiniband/{user_verbs.txt => user_verbs.rst} (93%) Looks OK to me, do you want to run these patches through the docs tree or through RDMA? Given that we've generally pushed doc updates through rdma, I think I'd prefer the latter? Jonathan? Thanks, Jason