doc: dynamic-debug: give the document a title

Signed-off-by: Jeremiah Mahler <jmmahler@gmail.com>
doc: dynamic-debug: format spec with spaces

The query spec uses a combination of spaces and tabs which will
cause it to look mis-formatted if the tab spacing is not set to 8.
Replace the tabs with spaces so it always looks right.

Signed-off-by: Jeremiah Mahler <jmmahler@gmail.com>
doc: dynamic-debug: fix wording "contain space"

Signed-off-by: Jeremiah Mahler <jmmahler@gmail.com>
doc: dynamic-debug: remove obvious "Examples:"

It is clear from the context when examples are given.
Remove the explicit statements that these are examples.

Signed-off-by: Jeremiah Mahler <jmmahler@gmail.com>
doc: dynamic-debug: remove pointless -n echo option

Dynamic debug doesn't care if newlines are given or not when
sending commands.  Remove the '-n' option from the examples since
they are not required.

Signed-off-by: Jeremiah Mahler <jmmahler@gmail.com>
doc: dynamic-debug: emphasize module (m) and function (f)

Include the command letter one of the examples to emphasize the
module and function that is being set.

Signed-off-by: Jeremiah Mahler <jmmahler@gmail.com>
doc: dynamic-debug: give example of how to clear all flags

Signed-off-by: Jeremiah Mahler <jmmahler@gmail.com>
doc: dynamic-debug: fix more wording issues

Signed-off-by: Jeremiah Mahler <jmmahler@gmail.com>
doc: dynamic-debug: re-write introduction

The introduction should give the reader a clear idea of what they
can do with the system and what its capabilities are.  Details
can be left for later in the document.  Re-write the introduction
to achieve this.

Signed-off-by: Jeremiah Mahler <jmmahler@gmail.com>
doc: dynamic-debug: shorten example to fit under 80 chars

One example uses a full path which is over 80 characters.  Since
it is unique and the exact path is not important, shorten it
looks nicer.

Signed-off-by: Jeremiah Mahler <jmmahler@gmail.com>