From 0f7668cbae8db2d08a0ec93e02fdc18a5fb91299 Mon Sep 17 00:00:00 2001
From: Joseph Koshy <jkoshy@FreeBSD.org>
Date: Mon, 24 Nov 2008 08:11:33 +0000
Subject: [PATCH] - Document the rules used to determine when spellings of
 events   are equivalent. - Reorder text to make the manual page more
 coherent.

---
 lib/libpmc/pmc.3 | 40 ++++++++++++++++++++++++----------------
 1 file changed, 24 insertions(+), 16 deletions(-)

diff --git a/lib/libpmc/pmc.3 b/lib/libpmc/pmc.3
index 27aaa04ad857..af96fc09caf6 100644
--- a/lib/libpmc/pmc.3
+++ b/lib/libpmc/pmc.3
@@ -23,7 +23,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd September 16, 2008
+.Dd November 24, 2008
 .Os
 .Dt PMC 3
 .Sh NAME
@@ -446,6 +446,29 @@ optional parameters modifying the semantics of the hardware event
 being probed.
 Event names are PMC architecture dependent, but the PMC library defines
 machine independent aliases for commonly used events.
+.Pp
+Event specifiers spellings are case-insensitive and space characters,
+periods, underscores and hyphens are considered equivalent to each other.
+Thus the event specifiers
+.Qq "Example Event" ,
+.Qq "example-event" ,
+and
+.Qq "EXAMPLE_EVENT"
+are equivalent.
+.Ss PMC Architecture Dependent Events
+PMC architecture dependent event specifiers are described in the
+following manual pages:
+.Bl -column " PMC_CLASS_TSC " "MANUAL PAGE "
+.It Em "PMC Class"      Ta Em "Manual Page"
+.It Li PMC_CLASS_IAF    Ta Xr pmc.iaf 3
+.It Li PMC_CLASS_IAP    Ta Xr pmc.atom 3 , Xr pmc.core 3 , Xr pmc.core2 3
+.It Li PMC_CLASS_K7     Ta Xr pmc.k7 3
+.It Li PMC_CLASS_K8     Ta Xr pmc.k8 3
+.It Li PMC_CLASS_P4     Ta Xr pmc.p4 3
+.It Li PMC_CLASS_P5     Ta Xr pmc.p5 3
+.It Li PMC_CLASS_P6     Ta Xr pmc.p6 3
+.It Li PMC_CLASS_TSC    Ta Xr pmc.tsc 3
+.El
 .Ss Event Name Aliases
 Event name aliases are PMC-independent names for commonly used events.
 The following aliases are known to this version of the
@@ -472,21 +495,6 @@ Measure the number of interrupts seen.
 Measure the number of cycles the processor is not in a halted
 or sleep state.
 .El
-.Pp
-.Ss PMC Architecture Dependent Events
-PMC architecture dependent event specifiers are described in the
-following manual pages:
-.Bl -column " PMC_CLASS_TSC " "MANUAL PAGE "
-.It Em "PMC Class"      Ta Em "Manual Page"
-.It Li PMC_CLASS_IAF    Ta Xr pmc.iaf 3
-.It Li PMC_CLASS_IAP    Ta Xr pmc.atom 3 , Xr pmc.core 3 , Xr pmc.core2 3
-.It Li PMC_CLASS_K7     Ta Xr pmc.k7 3
-.It Li PMC_CLASS_K8     Ta Xr pmc.k8 3
-.It Li PMC_CLASS_P4     Ta Xr pmc.p4 3
-.It Li PMC_CLASS_P5     Ta Xr pmc.p5 3
-.It Li PMC_CLASS_P6     Ta Xr pmc.p6 3
-.It Li PMC_CLASS_TSC    Ta Xr pmc.tsc 3
-.El
 .Sh COMPATIBILITY
 The interface between the
 .Nm pmc