Re: [PATCH 2/3] Documentation: convert trace/ftrace-design.txt to rst format

From: Du, Changbin
Date: Fri Feb 16 2018 - 22:39:44 EST


On Fri, Feb 16, 2018 at 12:36:29PM -0500, Steven Rostedt wrote:
> On Fri, 16 Feb 2018 05:49:52 -0700
> Jonathan Corbet <corbet@xxxxxxx> wrote:
>
> > On Thu, 15 Feb 2018 22:57:05 -0500
> > Steven Rostedt <rostedt@xxxxxxxxxxx> wrote:
> >
> > > This document is out of date, and I rather have it updated before we
> > > make it more "available" elsewhere.
> >
> > Imagine that, an out-of-date doc in the kernel :)
> >
> > Seriously, though, I'd argue that (1) it's already highly available, and
> > (2) it's useful now. And (3) who knows when that update will happen?
> > Unless we have reason to believe that a new version is waiting on the
> > wings, I don't really see why we would want to delay this work.
>
> Actually, some of these documents I was thinking of labeling as
> "obsolete" or simply removing them. The ftrace-design one is about
> how to port ftrace to other architectures, and I already had to correct
> people that based their work on it.
>
> Yeah, I really need to get some time to update them, but like everyone
> else, that's just the 90th thing I have to do.
>
> -- Steve
Reading this doc, I think most of information are still useful for undertading the
implemeation. So how abount just put a caution at the begining of doc as below
defore get updated?
http://docservice.askxiong.com/linux-kernel/trace/ftrace-design.html

Anyway, I just converted them all. I will send them out. Please comemnt if some
of them should be removed.

--
Thanks,
Changbin Du