[PATCH] tracing: consolidate documents

[PATCH] tracing: consolidate documents

[Li Zefan]

Move tracepoints.txt, ftrace.txt and ftrace.txt to the new
directory trace/.

I don't find any references to those documents in both source
files and documents, so no extra work needs to be done.

Signed-off-by: Li Zefan <lizf@cn.fujitsu.com>
---
 Documentation/{ => trace}/ftrace.txt           |    0 
 Documentation/{tracers => trace}/mmiotrace.txt |    0 
 Documentation/{ => trace}/tracepoints.txt      |    0 
 3 files changed, 0 insertions(+), 0 deletions(-)
 rename Documentation/{ => trace}/ftrace.txt (100%)
 rename Documentation/{tracers => trace}/mmiotrace.txt (100%)
 rename Documentation/{ => trace}/tracepoints.txt (100%)

diff --git a/Documentation/ftrace.txt b/Documentation/trace/ftrace.txt
similarity index 100%
rename from Documentation/ftrace.txt
rename to Documentation/trace/ftrace.txt
diff --git a/Documentation/tracers/mmiotrace.txt b/Documentation/trace/mmiotrace.txt
similarity index 100%
rename from Documentation/tracers/mmiotrace.txt
rename to Documentation/trace/mmiotrace.txt
diff --git a/Documentation/tracepoints.txt b/Documentation/trace/tracepoints.txt
similarity index 100%
rename from Documentation/tracepoints.txt
rename to Documentation/trace/tracepoints.txt
-- 
1.5.4.rc3

[PATCH][RESEND] tracing: consolidate documents

[Li Zefan]

Move tracepoints.txt, ftrace.txt and mmiotrace.txt to the new
directory trace/

I don't find any references to those documents in both source
files and documents, so no extra work needs to be done.

Signed-off-by: Li Zefan <lizf@cn.fujitsu.com>
---

Fix a typo in changelog, and CC more people.

---
 Documentation/{ => trace}/ftrace.txt           |    0 
 Documentation/{tracers => trace}/mmiotrace.txt |    0 
 Documentation/{ => trace}/tracepoints.txt      |    0 
 3 files changed, 0 insertions(+), 0 deletions(-)
 rename Documentation/{ => trace}/ftrace.txt (100%)
 rename Documentation/{tracers => trace}/mmiotrace.txt (100%)
 rename Documentation/{ => trace}/tracepoints.txt (100%)

diff --git a/Documentation/ftrace.txt b/Documentation/trace/ftrace.txt
similarity index 100%
rename from Documentation/ftrace.txt
rename to Documentation/trace/ftrace.txt
diff --git a/Documentation/tracers/mmiotrace.txt b/Documentation/trace/mmiotrace.txt
similarity index 100%
rename from Documentation/tracers/mmiotrace.txt
rename to Documentation/trace/mmiotrace.txt
diff --git a/Documentation/tracepoints.txt b/Documentation/trace/tracepoints.txt
similarity index 100%
rename from Documentation/tracepoints.txt
rename to Documentation/trace/tracepoints.txt
-- 
1.5.4.rc3

Re: [PATCH][RESEND] tracing: consolidate documents

[Li Zefan]

Li Zefan wrote:
> Move tracepoints.txt, ftrace.txt and mmiotrace.txt to the new
> directory trace/
> 

Should we also move kmemtrace.txt to trace/, or leave it in vm/?

> I don't find any references to those documents in both source
> files and documents, so no extra work needs to be done.
> 

Re: [PATCH][RESEND] tracing: consolidate documents

[Ingo Molnar]

* Li Zefan <lizf@cn.fujitsu.com> wrote:

> Li Zefan wrote:
> > Move tracepoints.txt, ftrace.txt and mmiotrace.txt to the new
> > directory trace/
> > 
> 
> Should we also move kmemtrace.txt to trace/, or leave it in vm/?

Eduard, Pekka, any preferences?

Are symbolic links in Documentation/ frowned upon? I think it would 
be best to have the file in both places:

We do want to direct people interested in Documentation/vm/ to 
kmemtrace ... and we do want to let people who are interested in 
Documentation/trace/ that there's kmemtrace.

Tracing and instrumentation is generally a multi-subsystem thing.

	Ingo

[tip:tracing/urgent] tracing: consolidate documents

[Li Zefan]

Commit-ID:  9f690b04fdf3fa5d7d6abab0bfd8628c3b91d503
Gitweb:     http://git.kernel.org/tip/9f690b04fdf3fa5d7d6abab0bfd8628c3b91d503
Author:     Li Zefan <lizf@cn.fujitsu.com>
AuthorDate: Thu, 9 Apr 2009 11:40:27 +0800
Committer:  Ingo Molnar <mingo@elte.hu>
CommitDate: Thu, 9 Apr 2009 05:54:42 +0200

tracing: consolidate documents

Move tracepoints.txt, ftrace.txt and mmiotrace.txt to the new
directory trace/.

I didnt find any references to those documents in both source
files and documents, so no extra work needs to be done.

Signed-off-by: Li Zefan <lizf@cn.fujitsu.com>
Cc: Steven Rostedt <rostedt@goodmis.org>
Cc: Frederic Weisbecker <fweisbec@gmail.com>
Cc: Pekka Paalanen <pq@iki.fi>
Cc: Mathieu Desnoyers <mathieu.desnoyers@polymtl.ca>
LKML-Reference: <49DD6E2B.6090200@cn.fujitsu.com>
Signed-off-by: Ingo Molnar <mingo@elte.hu>


---
 Documentation/{ => trace}/ftrace.txt           |    0
 Documentation/{tracers => trace}/mmiotrace.txt |    0
 Documentation/{ => trace}/tracepoints.txt      |    0
 3 files changed, 0 insertions(+), 0 deletions(-)

diff --git a/Documentation/ftrace.txt b/Documentation/trace/ftrace.txt
similarity index 100%
rename from Documentation/ftrace.txt
rename to Documentation/trace/ftrace.txt
diff --git a/Documentation/tracers/mmiotrace.txt b/Documentation/trace/mmiotrace.txt
similarity index 100%
rename from Documentation/tracers/mmiotrace.txt
rename to Documentation/trace/mmiotrace.txt
diff --git a/Documentation/tracepoints.txt b/Documentation/trace/tracepoints.txt
similarity index 100%
rename from Documentation/tracepoints.txt
rename to Documentation/trace/tracepoints.txt

Re: [PATCH][RESEND] tracing: consolidate documents

[Pekka Enberg]

On Thu, Apr 9, 2009 at 7:13 AM, Ingo Molnar <mingo@elte.hu> wrote:
>
> * Li Zefan <lizf@cn.fujitsu.com> wrote:
>
>> Li Zefan wrote:
>> > Move tracepoints.txt, ftrace.txt and mmiotrace.txt to the new
>> > directory trace/
>> >
>>
>> Should we also move kmemtrace.txt to trace/, or leave it in vm/?
>
> Eduard, Pekka, any preferences?
>
> Are symbolic links in Documentation/ frowned upon? I think it would
> be best to have the file in both places:
>
> We do want to direct people interested in Documentation/vm/ to
> kmemtrace ... and we do want to let people who are interested in
> Documentation/trace/ that there's kmemtrace.
>
> Tracing and instrumentation is generally a multi-subsystem thing.

I'm not sure a symbolic link is necessary. Just put it under trace/.

Re: [PATCH][RESEND] tracing: consolidate documents

[Ingo Molnar]

* Pekka Enberg <penberg@cs.helsinki.fi> wrote:

> On Thu, Apr 9, 2009 at 7:13 AM, Ingo Molnar <mingo@elte.hu> wrote:
> >
> > * Li Zefan <lizf@cn.fujitsu.com> wrote:
> >
> >> Li Zefan wrote:
> >> > Move tracepoints.txt, ftrace.txt and mmiotrace.txt to the new
> >> > directory trace/
> >> >
> >>
> >> Should we also move kmemtrace.txt to trace/, or leave it in vm/?
> >
> > Eduard, Pekka, any preferences?
> >
> > Are symbolic links in Documentation/ frowned upon? I think it would
> > be best to have the file in both places:
> >
> > We do want to direct people interested in Documentation/vm/ to
> > kmemtrace ... and we do want to let people who are interested in
> > Documentation/trace/ that there's kmemtrace.
> >
> > Tracing and instrumentation is generally a multi-subsystem thing.
> 
> I'm not sure a symbolic link is necessary. Just put it under trace/.

ok - i've amended the commit and have added your Ack - thanks!

	Ingo

[tip:tracing/urgent] tracing: consolidate documents

[Li Zefan]

Commit-ID:  66bb74888eb4bef4ba7c87c931ecb7ecca3a240c
Gitweb:     http://git.kernel.org/tip/66bb74888eb4bef4ba7c87c931ecb7ecca3a240c
Author:     Li Zefan <lizf@cn.fujitsu.com>
AuthorDate: Thu, 9 Apr 2009 11:40:27 +0800
Committer:  Ingo Molnar <mingo@elte.hu>
CommitDate: Thu, 9 Apr 2009 07:28:10 +0200

tracing: consolidate documents

Move kmemtrace.txt, tracepoints.txt, ftrace.txt and mmiotrace.txt to
the new trace/ directory.

I didnt find any references to those documents in both source
files and documents, so no extra work needs to be done.

Signed-off-by: Li Zefan <lizf@cn.fujitsu.com>
Acked-by: Pekka Paalanen <pq@iki.fi>
Cc: Steven Rostedt <rostedt@goodmis.org>
Cc: Frederic Weisbecker <fweisbec@gmail.com>
Cc: Mathieu Desnoyers <mathieu.desnoyers@polymtl.ca>
LKML-Reference: <49DD6E2B.6090200@cn.fujitsu.com>
Signed-off-by: Ingo Molnar <mingo@elte.hu>


---
 Documentation/{ => trace}/ftrace.txt           |    0
 Documentation/{vm => trace}/kmemtrace.txt      |    0
 Documentation/{tracers => trace}/mmiotrace.txt |    0
 Documentation/{ => trace}/tracepoints.txt      |    0
 4 files changed, 0 insertions(+), 0 deletions(-)

diff --git a/Documentation/ftrace.txt b/Documentation/trace/ftrace.txt
similarity index 100%
rename from Documentation/ftrace.txt
rename to Documentation/trace/ftrace.txt
diff --git a/Documentation/vm/kmemtrace.txt b/Documentation/trace/kmemtrace.txt
similarity index 100%
rename from Documentation/vm/kmemtrace.txt
rename to Documentation/trace/kmemtrace.txt
diff --git a/Documentation/tracers/mmiotrace.txt b/Documentation/trace/mmiotrace.txt
similarity index 100%
rename from Documentation/tracers/mmiotrace.txt
rename to Documentation/trace/mmiotrace.txt
diff --git a/Documentation/tracepoints.txt b/Documentation/trace/tracepoints.txt
similarity index 100%
rename from Documentation/tracepoints.txt
rename to Documentation/trace/tracepoints.txt

Re: [tip:tracing/urgent] tracing: consolidate documents

[Mathieu Desnoyers]

* Li Zefan (lizf@cn.fujitsu.com) wrote:
> Commit-ID:  9f690b04fdf3fa5d7d6abab0bfd8628c3b91d503
> Gitweb:     http://git.kernel.org/tip/9f690b04fdf3fa5d7d6abab0bfd8628c3b91d503
> Author:     Li Zefan <lizf@cn.fujitsu.com>
> AuthorDate: Thu, 9 Apr 2009 11:40:27 +0800
> Committer:  Ingo Molnar <mingo@elte.hu>
> CommitDate: Thu, 9 Apr 2009 05:54:42 +0200
> 
> tracing: consolidate documents
> 
> Move tracepoints.txt, ftrace.txt and mmiotrace.txt to the new
> directory trace/.
> 

We should probably move markers.txt while we are at it.

Mathieu

> I didnt find any references to those documents in both source
> files and documents, so no extra work needs to be done.
> 
> Signed-off-by: Li Zefan <lizf@cn.fujitsu.com>
> Cc: Steven Rostedt <rostedt@goodmis.org>
> Cc: Frederic Weisbecker <fweisbec@gmail.com>
> Cc: Pekka Paalanen <pq@iki.fi>
> Cc: Mathieu Desnoyers <mathieu.desnoyers@polymtl.ca>
> LKML-Reference: <49DD6E2B.6090200@cn.fujitsu.com>
> Signed-off-by: Ingo Molnar <mingo@elte.hu>
> 
> 
> ---
>  Documentation/{ => trace}/ftrace.txt           |    0
>  Documentation/{tracers => trace}/mmiotrace.txt |    0
>  Documentation/{ => trace}/tracepoints.txt      |    0
>  3 files changed, 0 insertions(+), 0 deletions(-)
> 
> diff --git a/Documentation/ftrace.txt b/Documentation/trace/ftrace.txt
> similarity index 100%
> rename from Documentation/ftrace.txt
> rename to Documentation/trace/ftrace.txt
> diff --git a/Documentation/tracers/mmiotrace.txt b/Documentation/trace/mmiotrace.txt
> similarity index 100%
> rename from Documentation/tracers/mmiotrace.txt
> rename to Documentation/trace/mmiotrace.txt
> diff --git a/Documentation/tracepoints.txt b/Documentation/trace/tracepoints.txt
> similarity index 100%
> rename from Documentation/tracepoints.txt
> rename to Documentation/trace/tracepoints.txt

-- 
Mathieu Desnoyers
OpenPGP key fingerprint: 8CD5 52C3 8E3C 4140 715F  BA06 3F25 A8FE 3BAE 9A68

Re: [tip:tracing/urgent] tracing: consolidate documents

[Pekka Paalanen]

On Thu, 9 Apr 2009 05:30:47 GMT
Li Zefan <lizf@cn.fujitsu.com> wrote:

> Commit-ID:  66bb74888eb4bef4ba7c87c931ecb7ecca3a240c
> Gitweb:     http://git.kernel.org/tip/66bb74888eb4bef4ba7c87c931ecb7ecca3a240c
> Author:     Li Zefan <lizf@cn.fujitsu.com>
> AuthorDate: Thu, 9 Apr 2009 11:40:27 +0800
> Committer:  Ingo Molnar <mingo@elte.hu>
> CommitDate: Thu, 9 Apr 2009 07:28:10 +0200
> 
> tracing: consolidate documents
> 
> Move kmemtrace.txt, tracepoints.txt, ftrace.txt and mmiotrace.txt to
> the new trace/ directory.
> 
> I didnt find any references to those documents in both source
> files and documents, so no extra work needs to be done.

There is one reference: kernel/trace/Kconfig, search for MMIOTRACE.
Fix that, and you have my ack on the mmiotrace.txt part.

> Signed-off-by: Li Zefan <lizf@cn.fujitsu.com>
> Acked-by: Pekka Paalanen <pq@iki.fi>

Hey, I didn't say anything yet. Maybe you meant Enberg?
There are at least two Pekkas here :-)

Thanks.


> Cc: Steven Rostedt <rostedt@goodmis.org>
> Cc: Frederic Weisbecker <fweisbec@gmail.com>
> Cc: Mathieu Desnoyers <mathieu.desnoyers@polymtl.ca>
> LKML-Reference: <49DD6E2B.6090200@cn.fujitsu.com>
> Signed-off-by: Ingo Molnar <mingo@elte.hu>
> 
> 
> ---
>  Documentation/{ => trace}/ftrace.txt           |    0
>  Documentation/{vm => trace}/kmemtrace.txt      |    0
>  Documentation/{tracers => trace}/mmiotrace.txt |    0
>  Documentation/{ => trace}/tracepoints.txt      |    0
>  4 files changed, 0 insertions(+), 0 deletions(-)
> 
> diff --git a/Documentation/ftrace.txt b/Documentation/trace/ftrace.txt
> similarity index 100%
> rename from Documentation/ftrace.txt
> rename to Documentation/trace/ftrace.txt
> diff --git a/Documentation/vm/kmemtrace.txt b/Documentation/trace/kmemtrace.txt
> similarity index 100%
> rename from Documentation/vm/kmemtrace.txt
> rename to Documentation/trace/kmemtrace.txt
> diff --git a/Documentation/tracers/mmiotrace.txt b/Documentation/trace/mmiotrace.txt
> similarity index 100%
> rename from Documentation/tracers/mmiotrace.txt
> rename to Documentation/trace/mmiotrace.txt
> diff --git a/Documentation/tracepoints.txt b/Documentation/trace/tracepoints.txt
> similarity index 100%
> rename from Documentation/tracepoints.txt
> rename to Documentation/trace/tracepoints.txt
> 


-- 
Pekka Paalanen
http://www.iki.fi/pq/

Re: [PATCH][RESEND] tracing: consolidate documents

[Randy Dunlap]

Pekka Enberg wrote:
> On Thu, Apr 9, 2009 at 7:13 AM, Ingo Molnar <mingo@elte.hu> wrote:
>> * Li Zefan <lizf@cn.fujitsu.com> wrote:
>>
>>> Li Zefan wrote:
>>>> Move tracepoints.txt, ftrace.txt and mmiotrace.txt to the new
>>>> directory trace/
>>>>
>>> Should we also move kmemtrace.txt to trace/, or leave it in vm/?
>> Eduard, Pekka, any preferences?
>>
>> Are symbolic links in Documentation/ frowned upon? I think it would
>> be best to have the file in both places:
>>
>> We do want to direct people interested in Documentation/vm/ to
>> kmemtrace ... and we do want to let people who are interested in
>> Documentation/trace/ that there's kmemtrace.
>>
>> Tracing and instrumentation is generally a multi-subsystem thing.
> 
> I'm not sure a symbolic link is necessary. Just put it under trace/.

Thanks.  I like that too.

-- 
~Randy

Re: [tip:tracing/urgent] tracing: consolidate documents

[Pekka Enberg]

On Thu, Apr 9, 2009 at 6:53 PM, Pekka Paalanen <pq@iki.fi> wrote:
> On Thu, 9 Apr 2009 05:30:47 GMT
> Li Zefan <lizf@cn.fujitsu.com> wrote:
>
>> Commit-ID:  66bb74888eb4bef4ba7c87c931ecb7ecca3a240c
>> Gitweb:     http://git.kernel.org/tip/66bb74888eb4bef4ba7c87c931ecb7ecca3a240c
>> Author:     Li Zefan <lizf@cn.fujitsu.com>
>> AuthorDate: Thu, 9 Apr 2009 11:40:27 +0800
>> Committer:  Ingo Molnar <mingo@elte.hu>
>> CommitDate: Thu, 9 Apr 2009 07:28:10 +0200
>>
>> tracing: consolidate documents
>>
>> Move kmemtrace.txt, tracepoints.txt, ftrace.txt and mmiotrace.txt to
>> the new trace/ directory.
>>
>> I didnt find any references to those documents in both source
>> files and documents, so no extra work needs to be done.
>
> There is one reference: kernel/trace/Kconfig, search for MMIOTRACE.
> Fix that, and you have my ack on the mmiotrace.txt part.
>
>> Signed-off-by: Li Zefan <lizf@cn.fujitsu.com>
>> Acked-by: Pekka Paalanen <pq@iki.fi>
>
> Hey, I didn't say anything yet. Maybe you meant Enberg?
> There are at least two Pekkas here :-)

Haha! Yeah, I acked the kmemtrace part so Ingo is probably just confused. :-)

Re: [tip:tracing/urgent] tracing: consolidate documents

[Li Zefan]

>> tracing: consolidate documents
>>
>> Move kmemtrace.txt, tracepoints.txt, ftrace.txt and mmiotrace.txt to
>> the new trace/ directory.
>>
>> I didnt find any references to those documents in both source
>> files and documents, so no extra work needs to be done.
> 
> There is one reference: kernel/trace/Kconfig, search for MMIOTRACE.
> Fix that, and you have my ack on the mmiotrace.txt part.
> 

Oh, I forgot to grep Kconfig.. There is also a reference to
kmemtrace.txt in Kconfig. I'll fix it.

Re: [tip:tracing/urgent] tracing: consolidate documents

[Ingo Molnar]

* Pekka Paalanen <pq@iki.fi> wrote:

> On Thu, 9 Apr 2009 05:30:47 GMT
> Li Zefan <lizf@cn.fujitsu.com> wrote:
> 
> > Commit-ID:  66bb74888eb4bef4ba7c87c931ecb7ecca3a240c
> > Gitweb:     http://git.kernel.org/tip/66bb74888eb4bef4ba7c87c931ecb7ecca3a240c
> > Author:     Li Zefan <lizf@cn.fujitsu.com>
> > AuthorDate: Thu, 9 Apr 2009 11:40:27 +0800
> > Committer:  Ingo Molnar <mingo@elte.hu>
> > CommitDate: Thu, 9 Apr 2009 07:28:10 +0200
> > 
> > tracing: consolidate documents
> > 
> > Move kmemtrace.txt, tracepoints.txt, ftrace.txt and mmiotrace.txt to
> > the new trace/ directory.
> > 
> > I didnt find any references to those documents in both source
> > files and documents, so no extra work needs to be done.
> 
> There is one reference: kernel/trace/Kconfig, search for MMIOTRACE.
> Fix that, and you have my ack on the mmiotrace.txt part.

This fix is committed now so your ack now takes effect :)

> > Signed-off-by: Li Zefan <lizf@cn.fujitsu.com>
> > Acked-by: Pekka Paalanen <pq@iki.fi>
> 
> Hey, I didn't say anything yet. Maybe you meant Enberg?
> There are at least two Pekkas here :-)

Yeah, you should rename yourself and pick some unique name like 
Ingo. Oh wait ...

	Ingo