Re: [PATCH 00/32] Create an User's manual and improve development-process book

From: Daniel Vetter
Date: Tue Nov 08 2016 - 08:57:31 EST


On Thu, Oct 27, 2016 at 08:40:56PM -0200, Mauro Carvalho Chehab wrote:
> Em Thu, 27 Oct 2016 14:36:07 -0600
> Jonathan Corbet <corbet@xxxxxxx> escreveu:
>
> > On Thu, 27 Oct 2016 13:17:33 -0700
> > Andrew Morton <akpm@xxxxxxxxxxxxxxxxxxxx> wrote:
> >
> > > > This patch series continues the efforts of converting the Linux Kernel
> > > > documentation to Sphinx.
> > >
> > > hm, renaming Documentation/kernel-parameters.txt in linux-next is going
> > > to be a pain for the next two months. I have one large patch series
> > > which alters that file and I expect more will come.
> >
> > That's going to be a continuing hassle as we try to bring a bit of order
> > to Documentation/, especially as so much stuff doesn't go through the docs
> > tree. Hopefully this cycle will be done with the most obnoxious moves,
> > anyway.
>
> Perhaps you could use git filter to handle it, with something like (untested):
>
> $ git filter-branch -f --tree-filter 'for i in $(git grep -l kernel-parameters.txt); do sed s,Documentation/kernel-parameters.txt,Documentation/admin-guide/kernel-parameters.rst,g $i >a && mv a $i; done' some_origin_branch..

Iirc Andrew uses quilt, so raw sed to change the filename in the diff
metadata of patches should do the job. We maintain a similar quilt patch
pile monstrosity for embargoed enabling internally ;-)
-Daniel
--
Daniel Vetter
Software Engineer, Intel Corporation
http://blog.ffwll.ch