Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE consistently

[thirdparty/util-linux.git] / sys-utils / readprofile.8

diff --git a/sys-utils/readprofile.8 b/sys-utils/readprofile.8
index 9aef1bfba66847af0f3fb8ba242c5817cdf67b1e..c335644d7e077fd628eeaeb61a40b17c24d063b6 100644 (file)
--- a/sys-utils/readprofile.8
+++ b/sys-utils/readprofile.8
@@ -90,7 +90,32 @@ Display version information and exit.
 .TP
 \fB\-h\fR, \fB\-\-help\fR
 Display help text and exit.
-.SH EXAMPLES
+.SH FILES
+.nf
+/proc/profile              A binary snapshot of the profiling buffer.
+/usr/src/linux/System.map  The symbol table for the kernel.
+/usr/src/linux/*           The program being profiled :-)
+.fi
+.SH BUGS
+.LP
+.B readprofile
+only works with a 1.3.x or newer kernel, because
+.I /proc/profile
+changed in the step from 1.2 to 1.3
+.LP
+This program only works with ELF kernels.  The change for a.out
+kernels is trivial, and left as an exercise to the a.out user.
+.LP
+To enable profiling, the kernel must be rebooted, because no
+profiling module is available, and it wouldn't be easy to build.  To
+enable profiling, you can specify "profile=2" (or another number) on
+the kernel commandline.  The number you specify is the two-exponent
+used as profiling step.
+.LP
+Profiling is disabled when interrupts are inhibited.  This means that
+many profiling ticks happen when interrupts are re-enabled.  Watch
+out for misleading information.
+.SH EXAMPLE
 Browse the profiling buffer ordering by clock ticks:
 .nf
    readprofile | sort \-nr | less
@@ -120,31 +145,6 @@ Request profiling at 2kHz per CPU, and reset the profiling buffer:
 .nf
    sudo readprofile \-M 20
 .fi
-.SH BUGS
-.LP
-.B readprofile
-only works with a 1.3.x or newer kernel, because
-.I /proc/profile
-changed in the step from 1.2 to 1.3
-.LP
-This program only works with ELF kernels.  The change for a.out
-kernels is trivial, and left as an exercise to the a.out user.
-.LP
-To enable profiling, the kernel must be rebooted, because no
-profiling module is available, and it wouldn't be easy to build.  To
-enable profiling, you can specify "profile=2" (or another number) on
-the kernel commandline.  The number you specify is the two-exponent
-used as profiling step.
-.LP
-Profiling is disabled when interrupts are inhibited.  This means that
-many profiling ticks happen when interrupts are re-enabled.  Watch
-out for misleading information.
-.SH FILES
-.nf
-/proc/profile              A binary snapshot of the profiling buffer.
-/usr/src/linux/System.map  The symbol table for the kernel.
-/usr/src/linux/*           The program being profiled :-)
-.fi
 .SH AVAILABILITY
 The readprofile command is part of the util-linux package and is
 available from