1.1.4 (2013/12/20)

	GENERAL

	BUG FIXES
	* Removed a debug line that was mistakenly left.  With it
	  "psrun" always printed the following when starting a program,
	      Event: '<event_name>', component index: <papi_comp_index>.
	  such as: "Event: 'PAPI_BR_CN', component index: 0."

	NEW COMPONENTS

	ENHANCEMENTS/FEATURE ADDITIONS

	API/HEADER FILE CHANGES

	NEW/CHANGED OPTIONS/ENVIRONMENT VARIABLES

	XML-RELATED CHANGES

	CONFIGURE/INSTALLATION UPDATES

	TEST SUITE/EXAMPLE PROGRAM UPDATES

	DOCUMENTATION UPDATES

	MISCELLANEOUS

1.1.3 (2013/11/05)

	GENERAL

	BUG FIXES
	* Added the dependency of "$(PKGS): base" in src/tcllib's
	  Makefile.am.  Needed in a parallel make (such as "make -j2").
	  Without it error messages such as the following occurs:
	    Generating top-level PerfSuite Tcl package index
	    cp: cannot create regular file `pkgIndex.tcl': File exists
	* For the "sampler" example, added "-lexpat".  Also added the
	  definition of LDLIBS, moving the "-l..."s from LDFLAGS to it.

	NEW COMPONENTS

	ENHANCEMENTS/FEATURE ADDITIONS
	* Added the support for PAPI non-CPU component events.
	  - hwpc-papi.c:
	    Existing code unconditionally set the component to 0
	    (== CPU) before calling PAPI_set_multiplex, thus did not
	    support non-CPU component events.  Changed to add one
	    event first, which will automatically set the eventset's
	    component to that of the event, then use PAPI_add_events
	    to add the rest.
	    PAPI_set_multiplex for a non-CPU component eventset could
	    return a non-PAPI_OK value, which could be ignored, such as
	    in the Cray Gemini NPU event case.  Changed the code to
	    retrieve the eventset's component and ignore it if it's not
	    CPU.  Existing code returned a failure here.
	  - hwpc.[ch], hwpc-{itimer,papi,perfmon}.[ch], null.[ch]:
	    Had a declaration change, where get_max_counters_xxx
	    changed from taking (void) as the arg to
	    (struct ps_hwpc_globals *globals).  This is needed by the
	    PAPI substrate to access the events to obtain the component
	    index, and then get the max counters with that info.
	  - hwpc.c:
	    In get_max_counters_papi:
	    changed to use the first event to retrieve the component
	    index, and changed from using
	    PAPI_get_opt(PAPI_MAX_MPX_CTRS, NULL) to
	    PAPI_get_cmp_opt(PAPI_MAX_MPX_CTRS, NULL, comp_index)
	    to get the limit for the correct component, instead of
	    always get the limit for the CPU component.

	  Tested with Cray XE6's Gemini network counters on NCSA's Blue
	  Waters machine's test system.
	* Added the feature to dynamically detect CPU type and set
	  the default event configuration file at run time, instead of
	  using the file determined at configure time.
	* Removed the functionality in psinv that printed out features
	  of x86 and x86-64 CPUs, since this functionality requires
	  high maintenance, but seems rarely used.

	API/HEADER FILE CHANGES

	NEW/CHANGED OPTIONS/ENVIRONMENT VARIABLES

	XML-RELATED CHANGES

	CONFIGURE/INSTALLATION UPDATES
	* Used the "papi2_any-null.xml", containing only the
	  "PAPI_TOT_CYC" and "PAPI_TOT_INS", as the default config
	  file, if the CPU family or model is unsupported, to avoid
	  issues.  Also used it as the default config file for IBM
	  Power CPUs, if the pvr version is unsupported.

	TEST SUITE/EXAMPLE PROGRAM UPDATES
	* Changed the domain in the PAPI test from KERNEL to ALL,
	  otherwise the PAPI_set_domain() call returns "invalid
	  argument" and fails.  This is due to a change in PAPI 5.1.1,
	  to exclude KERNEL from available domains if the OS
	  /proc/sys/kernel/perf_event_paranoid is set to 2.

	DOCUMENTATION UPDATES
	* Related to the removal of the functionality of displaying
	  CPU features in psinv, updated psinv's man page.

	MISCELLANEOUS
	* Removed 2 automake variables that are no longer used:
	  BFD_SHARED, BFD_H.

1.1.2 (2013/01/22)

	GENERAL

	BUG FIXES
	* If a threaded application does not call pthread_exit to stop
	  the threads, but calls exit to terminate the process, the
	  thread cleanup handlers, which PerfSuite uses to write XML
	  files automatically for the threads, will not be called, thus
	  only one XML file is generated for the main thread, and no
	  XML files are generated for the worker threads.  This seemed
	  to be the case for the GNU OpenMP implementation.  Made
	  changes to register the threads at initialization and cancel
	  them in the exit handler to handle this scenario.

	NEW COMPONENTS

	ENHANCEMENTS/FEATURE ADDITIONS

	API/HEADER FILE CHANGES

	NEW/CHANGED OPTIONS/ENVIRONMENT VARIABLES

	XML-RELATED CHANGES

	CONFIGURE/INSTALLATION UPDATES
	* Added the output of CPUID info in the configure stdout and
	  "config.log", to help debugging.
	* Made changes in "configure.ac" to support PAPI 5.x.

	TEST SUITE/EXAMPLE PROGRAM UPDATES
	* Split the previous PAPI multiplexed thread test to 2 tests:
	  one with 1-4 threads -- which is expected to pass on most
	  machines, and another with 8-256 threads (PAPI-mpx.at) --
	  which may fail on some machines.

	  In the second test, added a line to make sure it will fail
	  and an AT_XFAIL_IF condition to change the result to an
	  "expected failure".  This approach allows the test to be
	  considered passed, while keeping the "testsuite.log" file for
	  debugging.
	* In some cases, PAPI_add_events succeeds partially, adding
	  some but not all of the given events.  This occurred on
	  NCSA's Iforge machine (Intel Sandy Bridge CPUs, Linux kernel
	  version 2.6.32).  Given the 33 non-derived available events,
	  this function returned after adding 32 of them.

	  The libpshwpc test program "mpx-pthread.c" used to exit if
	  PAPI_add_events does not return with full success, thus in
	  such case the test would fail.  Relaxed this to exit only
	  when the return value is negative.

	DOCUMENTATION UPDATES

	MISCELLANEOUS
	* Removed the use of the PAPI_perror function in psjprof.c, due
	  to the API change in PAPI from 4.x to 5.x, where PAPI_perror
	  has been changed from taking 3 arguments to taking 1 argument,
	  similar to the perror function. 
	* Removed the use of a PAPI pre-defined macro: PAPI_MPX_DEF_DEG
	  in hwpc-papi.c and two libpshwpc test programs (mpx-pthread.c
	  and papitest.c).  PAPI 5 removed the definition, thus PerfSuite
	  could not be built with it.  Changed to use
	  PAPI_get_opt(PAPI_MAX_MPX_CTRS, NULL) to retrieve the value.
	* Related to the bug fix to write XML files for the worker
	  threads when the application calls exit instead of
	  pthread_exit to terminate, changed libpshwpc to always
	  register the threads instead of only when the signaling option
	  is specified, and split the exit handler to have a function to
	  cancel the threads.  Changed libpsrun to cancel the threads in
	  the psrun_fini function, thus give the threads a chance to
	  call the cleanup handler to write XML files.

1.1.1 (2012/05/22)

	GENERAL

	BUG FIXES
	* Last release (1.1.0) added the detection of Intel Westmere
	  processors, but missed the inclusion of the default event
	  configuration file for them.	Added the file "papi3_wsm.xml".
	* Fixed a minor error which printed 2 extra error lines in
	  configure output when PAPI is not available.
	* Added the detection of Core family CPUs for x86, otherwise
	  configure defaults them to P6 family; added the detection of
	  Core family CPUs for x86-64, instead of defaulting all
	  unsupported processors to Core family.
	* Fixed a long standing bug in Java XML parsing API that was
	  hidden most of the time.
	  PerfSuite's XML SAX parser assumed that the string value given
	  to the characters() method was the entire value of the XML tag
	  instead of parts of it, which is now proved wrong in IBM's JVM.
	  So the String.trim() method that was used to remove extra
	  spaces at the beginning and the end of an XML tag in the
	  characters() method needed to be removed.
	* In the script to generate the "psprocess" script, changed the
	  delimiter in the sed replace command for JAVAFLAGS from ':' to
	  '|', since some java flags could contain the colon, such as
	  "-XX:+UseParallelGC".

	NEW COMPONENTS

	ENHANCEMENTS/FEATURE ADDITIONS
	* psenv.csh.in, psenv.sh.in:
	  Changed to: add a path only when it's not already contained,
	  so that multiple "source psenv.sh" or "source psenv.csh" will
	  NOT contain duplicated directory entries.
	  Also, removed the unnecessary definition of MANPATH with a
	  PerfSuite entry when it is undefined, since "man" will auto-
	  matically scan the $PATH parts and search the corresponding
	  "../man" directories.
	* Added 3 new metrics definitions, so that L2 data cache miss
	  ratios and L2 cache miss ratio could be calculated from the
	  default event config file on Intel Westmere systems.
	* New support for AMD Interlagos and Intel Sandy Bridge systems.
	* New XML configuration files: "papi_interlagos.xml" and
	  "papi_sandybridge.xml".
	* New support for AMD Family 11h Turion systems, using the same
	  default event configuration file as that for AMD K10 systems.
	* Changed psinv to remove the output of "family" and "model" in
	  processor information, and use the CPUID output where it's
	  appropriate.
	* libperfsuite: updated the Intel cache descriptor 0x76 entry
	  according to Intel Application Note 485, April 2012 version.
	* Reduced the string lengths by 14 to fit in an 80-column
	  terminal in psrun and libpshwpc text output.
	* psinv: added a "-b" option to display the build details,
	  including the entire "configure" command line, hostname and
	  current working directory, for later debugging or
	  informational purposes.

	API/HEADER FILE CHANGES
	* Java XML parsing API: updated CPUInfo class to remove "family"
	  and "model" and add "cpuidInfo".

	NEW/CHANGED OPTIONS/ENVIRONMENT VARIABLES

	XML-RELATED CHANGES
	* Moved the metrics definition files under tools/psprocess/data/.
	  They used to be installed under src/tcllib/pshwpc/papi/, but if
	  Tcl was not available, then src/tcllib/ won't be built, and thus
	  these essential files won't be installed.  This change will
	  install them unconditionally.
	* Added 5 new DTDs for the changes in cpuinfo part of "machineinfo",
	  and the resulting changes in hwpcreport, hwpcprofilereport,
	  multihwpcreport, and multihwpcprofilereport.	Used "-0.3" to
	  indicate the new versions of these files.
	  The changes are that "family" and "model" tags were removed, and
	  a new "cpuidinfo" tag was added.
	* In the reports generated by libpshwpc, removed the output of
	  "family" and "model" in processor information, and use the CPUID
	  output where it's appropriate. Also use the "-0.3" version of
	  the DTDs.

	CONFIGURE/INSTALLATION UPDATES
	* At the end of "configure" output, print out a new section named
	  "Configuration Summary", and give warnings or suggestions
	  accordingly.
	* In "configure", added the checking of whether the JVM is 32-bit
	  while the system is 64-bit.
	  When this occurs, the JNI libraries can not be loaded, so all
	  JNI functionalities will fail.  Since in this case other features
	  still work, leave it as a warning, instead of aborting configure.
	* Updated the expected versions for the linux kernel and Tcl/Tk in
	  the configure script.	 Now also supports Linux kernel 3.x, tclsh
	  8.5/8.6 and wish 8.5/8.6.

	TEST SUITE/EXAMPLE PROGRAM UPDATES
	* Made the passing criterion of a few "psrun" test more strict --
	  to make sure that after running them, the "*.xml" files (or
	  "*.txt" files when "-F text" was given) were indeed generated.
	* Added a test case to test psrun's "-p" option.
	* Updated all the validation tests to use the "-0.3" version of
	  the DTDs, for the changes of removing "family" and "model" and
	  adding "cpuidinfo" in "machineinfo".
	* Updated the API_Demo.java example to remove "family" and "model"
	  and add "cpuidinfo" in "machineinfo" in the output.
	* Test flags:
	  Now support passing test flags to the "testsuite" command to
	  allow more functionalities, such as colored outputs in terminals
	  ("--color=auto") and parallel executions ("-j<n>").  An example
	  is 'make -ks check TESTFLAGS="--color=auto -j2"'.

	DOCUMENTATION UPDATES

	MISCELLANEOUS


1.1.0 (2011/10/18)

	GENERAL

	BUG FIXES
	* Java test cases for metric calculation API: corrected an erroneous
	  dependency on a file that will be built later, which can cause
	  a failure if "make check" is done before doing a "make".
	* libperfsuite: fixed an error in PPC32 support for itimer profiling,
	  which had segmentation faults due to the use of a wrong structure
	  in signal handling for PPC32 platforms.
	* Fixed errors and made improvement in many variables or macros such
	  as CFLAGS, CXXFLAGS, AM_CPPFLAGS, _LDFLAGS, _LIBADD, and _LDADD
	  in various Makefile.am files.
	* Java XML parsing API: made more robust by adding a sanity check 
	  "caches.size() >= cacheLevels", which could occur for a brand new
	  CPU that is not yet supported by PerfSuite's libperfsuite.
	* Java XML parsing API: fixed a long-standing bug that occurs
	  infrequently where "string1.concat(string2);" should have been
	  "string1 = string1.concat(string2);".  Observed only when parsing
	  the "<date>" tag in a multihwpcprofilereport.
	* psprocess (Java): added the missing "Run Time" line in text output
	  of processing an hwpcprofilereport.
	* libpsx and psprocess (Tcl): changed HAVE_CPLUS_DEMANGLE to
	  CPLUS_DEMANGLE_PIC in src/libpsx/demangle.c and
	  src/tcllib/psutils/cxxfilt/cxxfilt_init.c, so that in an environ-
	  ment where cplus_demangle() is available but is not shared, there
	  won't be link failures.
	* Removed the extra logic of removing empty directories in
	  "make uninstall" targets in the "metrics-java-api" and "psxml"
	  examples, so that consecutive "make uninstall"s will not fail.

	NEW COMPONENTS
	* New JVMTI agent named "psjprof", that can be used to profile Java
	  programs using hardware performance counters.  The agent allows
	  profiling of unmodified Java applications in a manner similar to
	  the "psjrun" agent.

	  The results are stored in XML files, one file per thread.  They
	  contain the locations (the source files and line numbers) where
	  the profiling samples were collected, and can be processed by
	  PerfSuite's "psprocess" tool.

	ENHANCEMENTS/FEATURE ADDITIONS
	* Java XML parsing API: enhanced the support for an hwpcprofilereport
	  for the inclusion of multiple profiles, one profile for an event.
	* psprocess (Java): enhanced the support for an hwpcprofilereport for
	  the inclusion of multiple profiles in both text and Cube format
	  output.
	* Java XML parsing API and metric calculation API: made the metric
	  calculation case-insensitive to the PAPI event names in the hwpc
	  counting report (which in turn came from the HWPC event
	  configuration file) and in the metric definition file, so event
	  names such as "PAPI_tot_cyc" are now supported for the purposes of
	  metric calculation.
	* psprocess (Java): in the text output when processing an
	  hwpcprofilereport, added the summary sections, and the support for
	  the "-s" and "-t" options in the existing nested detail section.

	API/HEADER FILE CHANGES
	* Java XML parsing API: added a method
	  PS_Report::newInstance(InputStream is, boolean validateDTD).
	  Needed to support remote projects in Eclipse PTP ETFw Feedback view
	  PerfSuite plug-in.
	* Java XML parsing API: added a method for
	  PS_HwpcProfileReport::getWallSecs().  Present in
	  PS_HwpcCountingReport but missing in PS_HwpcProfileReport.  Needed
	  by the psprocess Java version to print "Run Time".

	NEW/CHANGED OPTIONS/ENVIRONMENT VARIABLES

	XML-RELATED CHANGES

	CONFIGURE/INSTALLATION UPDATES
	* The cplus_demangle function check now detects whether the function
	  was compiled as position independent code, i.e., whether it can be
	  used to build a shared library, and records the result in the macro
	  CPLUS_DEMANGLE_PIC, to be used by the C source files.

	TEST SUITE/EXAMPLE PROGRAM UPDATES
	* Changed a test Java file due to the above Java XML parsing API
	  change that added a newInstance() method, which made the expression
	  "newInstance(null, null)" ambiguous for javac.
	* New test added for parsing a multihwpcprofilereport.
	* New test added for parsing an hwpcprofilereport with multiple
	  profiles in it.
	* Passing criterion for the psprocess Java "progress" test loosened,
	  to allow for the occasional case where no samples were collected.
	* Updated the cplus demangle JNI test, so that the test is skipped
	  if the cplus_demangle function is unavailable or was not compiled
	  as a position independent code.

	DOCUMENTATION UPDATES
	* Added a man page for the new Java profiling JVMTI agent: psjprof.
	* Added a man page for the existing JVMTI agent: psjrun.
	* Added a docbook file for the design of the psjprof JVMTI agent in
	  the source tree, but not installed.

	MISCELLANEOUS


1.0.0 (2011/03/15)

	GENERAL
	* No changes in this release over 1.0.0b2, except for update of the
	  version/release.


1.0.0 beta 2 (2011/02/11)

	GENERAL

	BUG FIXES
	* The psprocess driver script has been modified to more sensibly handle
	  the situation where the Java version of psprocess was not compiled,
	  and therefore not installed.  In this case, psprocess will fall back
	  to the Tcl implementation if available.  If neither the Java nor Tcl
	  versions were built, then psprocess itself will not be available.
	* psprocess (Java): removed a stack trace dump in the event that the
	  user provides an invalid URI as a filename for processing.

	NEW COMPONENTS

	ENHANCEMENTS/FEATURE ADDITIONS
	* libperfsuite: processor detection updated to reflect information as
	  described in the Intel Application Note 485, dated January 2011.
	  These changes allow for support of the Westmere processor.

	API/HEADER FILE CHANGES

	NEW/CHANGED OPTIONS/ENVIRONMENT VARIABLES

	XML-RELATED CHANGES

	CONFIGURE/INSTALLATION UPDATES

	TEST SUITE/EXAMPLE PROGRAM UPDATES

	DOCUMENTATION UPDATES
	* The psprocess man page has been modified to reflect the fact that the
	  default mode of operation is to use the Java-based version.

	MISCELLANEOUS


1.0.0 beta 1 (2010/10/26)

	GENERAL
	* PerfSuite now supports PowerPC/Linux systems (POWER4 and later).

	BUG FIXES
	* psprocess (Java): resource report handling made more robust when
	  processing load average data.
	* libpshwpc: output generation code made more defensive by checking to
	  ensure that LOGNAME has been set in the environment before accessing.
	  If not defined, the value of USER is checked.  If that is also not
	  defined, default to identifying the username as "UNKNOWN".

	NEW COMPONENTS

	ENHANCEMENTS/FEATURE ADDITIONS
	* New support for PPC32 and PPC64 systems.
	* New XML configuration files: "papi_power5.xml", "papi_power6.xml",
	  and "papi_power7.xml".
	* psprocess (Java) improved to more gracefully handle errors such as
	  invalid input files.  Error reporting also made more consistent.

	API/HEADER FILE CHANGES

	NEW/CHANGED OPTIONS/ENVIRONMENT VARIABLES

	XML-RELATED CHANGES

	CONFIGURE/INSTALLATION UPDATES
	* configure updated to more cleanly handle the case where TDOM is not
	  configured, but Java is.
	* configure was erroneously clearing out the variable CXXFLAGS during
	  Cube configuration.  Fixed.

	TEST SUITE/EXAMPLE PROGRAM UPDATES
	* Java test case for BFD/addr2line interface made more robust in the
	  situation where addr2line does not return line numbers.
	* Criteria for Java test cases covering metric calculation and
	  exception handling loosened, to allow for spurious output from the
	  JVM.
	* Added two missing Autotest .at files that had previously mistakenly
	  omitted from distribution (psprocess/tcl/tests/profilexml.at and
	  src/javalib/perfsuite/util/bfd/tests/cpp-dem-JNI.at).

	DOCUMENTATION UPDATES

	MISCELLANEOUS
	* Java PS_DEBUG output modified to be more consistent with the output
	  format from the C libraries.
	* Added additional mods/improvements contributed by SGI that were
	  mistakenly omitted from the 1.0.0a5 release.


1.0.0 alpha 5 (2010/09/14)

	GENERAL
	* The Java version of the psprocess command, introduced in PerfSuite
	  version 1.0.0a3, is now the default version invoked when "psprocess"
	  is executed.  The older Tcl version may be chosen by the user through
	  the psprocess option "--tcl" (must be the first argument supplied on
	  the command line), or through the environment variable PSPROCESS_MODE.

	BUG FIXES
	* libperfsuite: corrected cache level for Intel descriptor 0xca.
	* libperfsuite: added check for duplicate load map entries (same module
	  name), which was reported by SGI to occur under SLES11.  The second
	  entry encountered is now discarded.
	* psrun: wrapper for fork() modified to dlopen() and invoke fork() from
	  glibc, rather than using the internal function __libc_fork().  Mod
	  contributed by SGI.
	* psrun: SGI reported that MPT MPI, version 1.2.1 or later, changed
	  methods of launching tasks such that fork() was used, with the result
	  that psrun's wrapper was used instead.  This could occur prior to
	  psrun itself being initialized, with the effect of program failure.
	  Modified to guard against this case.  Mod contributed by SGI.

	NEW COMPONENTS

	ENHANCEMENTS/FEATURE ADDITIONS
	* "psinv -p" now displays the value of PAPI_VERSION_INCREMENT, labeled
	  as "Patch level".

	API/HEADER FILE CHANGES
	* Values of calculated metrics in Java metric calculator API are now
	  allowed to be negative.  Previously a metric whose calculated value
	  is negative is discarded.  A metric whose calculated value is
	  infinity, such as resulted in divide-by-0, is still discarded.

	NEW/CHANGED OPTIONS/ENVIRONMENT VARIABLES

	XML-RELATED CHANGES
	* PerfSuite-generated XML documents that involve PAPI-collected data
	  now identify the PAPI version with a string that consists of four
	  components: major version, minor version, revision, and increment.
	* New default configuration file added for Intel Core/Nehalem CPUs:
	  papi3_nhm.xml.

	CONFIGURE/INSTALLATION UPDATES
	* Configure bug fix: CUBE_LIBS variable handling modified to honor
	  user-supplied value properly.
	* configure now checks for the value of PAPI_VERSION_INCREMENT.
	* configure now detects x86/x86_64 processor model, including extended
	  model for newer Intel processors.
	* Removed check for __libc_fork().
	* configure now distinguishes Core/Nehalem processors.

	TEST SUITE/EXAMPLE PROGRAM UPDATES
	* libpshwpc Fortran test case(s) computation loop renamed so as to not
	  be identical to the C equivalent, which can cause conflicts with
	  Fortran compilers that do not mangle Fortran names uniquely.
	  Discovered when using the IBM xlf compiler.

	DOCUMENTATION UPDATES

	MISCELLANEOUS
	* psrun: separator character used to build the LD_PRELOAD environment
	  string changed from single space to a colon.  This is acceptable to
	  ld.so and is more compatible with SGI's dplace/MPI.  Thanks to SGI
	  for reporting this issue.


1.0.0 alpha 4 (2010/01/25)

	GENERAL
	* Updated for compatibility with PAPI 4.

	BUG FIXES
	* psprocess (Tcl version): addressed problem in generating gprof/gmon
	  style output that resulted in samples collected from highest PC
	  values being dropped from output file.
	* psprocess/Java: a performance fix in source code mapping.  An external
	  program ("file") was mistakenly started inside a tight loop that
	  iterates through each IP, causing significant delay.
	* psprocess/Java: a fix in source code mapping.  When a large amount of
	  errors occurred in using "addr2line" to perform source code mapping,
	  psprocess appeared to hang.
	* psprocess/Java: a fix to make XML-file-generating options such as
	  "-x" and "--combine" work for C++ programs, where special
	  characters used in C++ ("&", "<" and ">") need to be escaped in
	  generated XML files.
	* psprocess/Java: now calculates and compares MD5 sums when processing
	  profiles only if the given XML file contains an MD5 sum, instead of
	  always doing it.
	* libperfsuite: now excludes load map entries like [stack], [heap], and
	  [vdso] when constructing maps for profiling.
	* configure: handling of --with-mpi option was incorrect.

	NEW COMPONENTS

	ENHANCEMENTS/FEATURE ADDITIONS
	* Added additional error checking to the psprocess driver script to
	  ensure that the target version/executable has been configured and
	  installed before trying to execute it.  If not found, error message
	  output to the user.

	API/HEADER FILE CHANGES
	* Java metric calculator API change.
	  For the PS_MetricCalculator class, changed the API from creating
	  individual objects to using static methods for performing metric
	  calculations and returning results without creating these objects.
	  Removed the previous functionalities of representation (toString),
	  and choosing a system metric definition according to the event
	  class ("PAPI", "Perfmon").  These are now handled in psprocess/Java.

	NEW/CHANGED OPTIONS/ENVIRONMENT VARIABLES
	* psprocess/Java now supports "--glob" option.
	* psprocess/Java now supports environment variable LANG for localized
	  strings (metric descriptions, metric value numbers, event counts,
	  date and time, and most text headers such as date and username).
	* psprocess/Java: now supports "-r" option when processing
	  hwpcreport documents in profiling mode.
	* psinv: no longer prints error output when the user requests all info
	  with the "-v" option, but hardware event support has not been
	  configured.
	* New environment variable "PSPROCESS_NUMBER_NO_GROUPING".
	  When defined (to any value), the printed integers will not contain
	  the grouping separator ("," for thousands in English, and "." for
	  Spanish).  (psprocess/Java only)
	* New environment variable "PSPROCESS_XML_INDENT".
	  Its value determines the number of indentation spaces in psprocess
	  generated XML files.  The default value is 4.  (psprocess/Java only)
	* New environment variables "PSPROCESS_DESC_WIDTH",
	  "PSPROCESS_VALUE_WIDTH", and "PSPROCESS_PRECISION".
	  Their values determine the number of characters in the description,
	  value, and the number of digits after the decimal point in the
	  standard output generated by psprocess, respectively.  The default
	  values are 64, 15, and 3, tuned for an 80-column terminal.
	  (psprocess/Java only)

	XML-RELATED CHANGES
	* Changed the DOCTYPE line in all psprocess/Java generated XML files
	  so that it consistently takes 1 line, instead of some types taking
	  1 line, some types taking 2 lines.

	CONFIGURE/INSTALLATION UPDATES
	* Cube-related configuration now tested through new Autoconf macro
	  ACX_LIB_CUBE.
	* --with-mpi option updated to handle proper location of the MPI
	  header file in the absence of MPI_CPPFLAGS setting.
	* Added checking of the header file "stdio.h" and used the result
	  in two javalib tests.

	TEST SUITE/EXAMPLE PROGRAM UPDATES
	* New tests added for "-r" option of psprocess/Java with profiling
	  reports.
	* New test added for the Java JNI API to Cube C++ library.
	* New tests added for the "--glob" option of psprocess/Java.
	* New tests added to test counting reports and multihwpcreports count
	  mode with hardcoded input files, which test all options for the
	  report type.  Removed the 2 hardcoded tests that tested only the
	  "-o" option.  The purpose is so that when PAPI is unavailable, one
	  can still test the functionality of psprocess/Java.
	* Changed psprocess/Java tests for md5, pipeline and progress, so that
	  more tests can run (not skipped) when PAPI is unavailable.
	* Time needed to conduct test cases was shortened for many
	  psprocess/Java tests (those which use the "cpi" executable).
	* Updated the metrics example to correspond to the metrics API changes
	  listed above.
	* Hardware performance library (libpshwpc) test cases updated for
	  compatibility with PAPI 4 (papitest.c, mpx-pthread.c).

	DOCUMENTATION UPDATES
	* Updated Javadoc for metric calculator API to correspond to the
	  API changes listed above.

	MISCELLANEOUS
	* Added a debug message at warning level if two metric definitions
	  with the same name appear in the same file when parsing a metric
	  definition file.  Whether this message appears depends on the
	  PS_DEBUG level.
	* In Java XML parsing API, when parsing a PerfSuite XML file,
	  now assert that the values of cache level, size, linesize, and
	  associativity are positive integers, otherwise a RuntimeException
	  is thrown.
	* Now in psprocess/Java, for the command line option "--threshold" or
	  "-t", assert that the parsed value is valid: in [0.0, 100.0),
	  otherwise abort immediately.


1.0.0 alpha 3 (2009/10/28)

	GENERAL

	BUG FIXES
	* psrun: removed dlclose() of libpshwpc.so in destructor function to
	  avoid run-time complaints from ld.so.
	* libperfsuite: bad entry for one cache descriptor addressed, updated
	  descriptor information to August 2009 release of Intel AP-485.
	* libpshwpc: user-supplied threshold values ignored when profiling
	  using PAPI and native events.  Fixed.
	* psprocess: processing of profiling information for modules that are
	  not associated with a specific file (e.g., [stack]) previously
	  caused psprocess to exit, now handles by ignoring such entries.

	NEW COMPONENTS
	* New JVMTI-based agent named "psjrun", built on top of the PerfSuite
	  Java performance measurement package, that allows monitoring of
	  unmodified Java applications in the same manner as the "psrun"
	  command.
	* New Java-based version of "psprocess", supporting identical options
	  as the existing Tcl version, except "--glob", "-H", "-P", "--vmon",
	  "-e".  The "--glob" option, which is new to the Tcl version of
	  psprocess, will be implemented in the Java version in a later
	  release.
	* New C library "libpsx" added, meant for PerfSuite-internal use.

	ENHANCEMENTS/FEATURE ADDITIONS
	* Added Java XML parsing support for multihwpcprofilereport.
	* New configuration file for Intel Atom processors: "papi3_atom.xml".

	API/HEADER FILE CHANGES
	* Changed the type of sampleMap in PS_Module from Map<String,Long>
	  to Map<Long,Long>, to better reflect the type of the intended
	  values. Also now validate the values of PC and count to be added
	  in the sampleMap in parsing.
	* Changed the parent class of PS_HwpcProfileReport from PS_HwpcReport
	  to PS_Report, as there is no parent-child relationship between
	  PS_HwpcReport and PS_HwpcProfileReport.
	* Behavior of the newInstance method in PS_Report class modified in the
	  case when "null" is supplied as the "filename" argument.  This now
	  indicates that the XML document is to be read from standard input,
	  rather than being treated as an illegal argument.

	NEW/CHANGED OPTIONS/ENVIRONMENT VARIABLES
	* psprocess: new option accepted "--glob PATTERN".  This option allows
	  specification of multiple files based on a Tcl-style pattern given
	  as PATTERN (this style of pattern-matching is similar to that found
	  in standard shells).  The benefit of this option is that it is not
	  subject to shell limits for filename expansion when a very large
	  number of files match the shell wildcard characters.  psprocess
	  continues to accept trailing multiple filenames as input.
	* psprocess: filename keyword "stdin" is no longer recognized. Instead,
	  the command assumes that if no filenames are found on the command
	  line after option processing, that it should accept input from
	  standard input.  This behavior is more like standard UNIX utilities
	  and continues to allow psprocess to be used in a pipeline.
	* psprocess: supports selection of the Tcl or Java version of the tool
	  in one of two ways: either by specifying "--tcl" or "--java" as the
	  first option, or by setting the environment variable PSPROCESS_MODE
	  to the value "tcl" or "java".  If neither is given, the current
	  release uses the Tcl version by default.
	  
	XML-RELATED CHANGES
	* DTD for <hwpcprofilereport> documents (version 0.2) modified to
	  include <cputime> element within the <executioninfo> element.  This
	  change is intended to enforce uniformity of contents of 
	  <executioninfo> element between <hwpcreport> and <hwpcprofilereport>
	  documents. 

	CONFIGURE/INSTALLATION UPDATES

	TEST SUITE/EXAMPLE PROGRAM UPDATES

	DOCUMENTATION UPDATES
	* psprocess man page updated to reflect current state of the tool and
	  to document both the Tcl and Java versions.

	MISCELLANEOUS


1.0.0 alpha 2 (2009/08/31)

	GENERAL

	BUG FIXES
	* libperfsuite/timers.c: syntax error when compiled for debugging mode
	  and mmtimer is selected as RTC fixed.
	* configure script rejects with failure any Perfmon version that is not
	  supported by PerfSuite.
	* Intel x86 cache-detection code modified to be more defensive in the
	  event that an unrecognized cache is encountered.  Previously, would
	  result in a segfault.

	NEW COMPONENTS
	* New Java package "org.perfsuite.hwpc" that exposes the PerfSuite
	  hardware performance counting API (libpshwpc) to Java programs.
	  Although this package can operate in either counting or profiling
	  mode, it is probably most useful in counting mode only, as the
	  standard PerfSuite processing of statistical profiles will operate in
	  the context of the JVM, not the user's code.
	* New Java package "org.perfsuite.metrics" that provides the ability
	  to calculate derived metrics from a PerfSuite report XML document
	  and a metric definition file, and generate a localized string
	  representation of the descriptions and calculated values of
	  the derived metrics.
	  Example programs showing the use of the API can be found in the
	  directory $PREFIX/share/perfsuite/examples/metrics-java-api.

	ENHANCEMENTS/FEATURE ADDITIONS
	* libperfsuite inline assembly code for use of CPUID instruction
	  modified to allow PIC-compilation on systems where previously this
	  was not possible, due to compiler/register restrictions.  This change
	  allows the creation of libperfsuite as a shared library on additional
	  x86 platforms.
	* x86/Intel CPU cache descriptors updated per Intel AP-485, dated 3/09.
	* Modifications to new profile processing code in psprocess to reduce
	  memory consumption when creating <hwpcprofilereport> and
	  <multihwpcreport> XML documents.
	* Java API: Added the code to support parsing of the optional elements
	  "pid" and "thread" in PerfSuite HWPC reports. The two elements
	  were recently introduced in the hwpcreport and hwpcprofilereport
	  DTDs in release 1.0.0a1.
	* Java API: Added PS_Environment and PS_Debug classes under
	  src/javalib/perfsuite/util to read/parse environment variables,
	  and print debug messages.  Simplified existing code in
	  PS_ReportParser by using the new PS_Debug class.
	* psprocess now supports generation of Cube files from parallel runs
	  that are contained in a <multihwpcreport> document in profiling mode.

	API/HEADER FILE CHANGES
	* Java API: In CPUInfo class, getCaches() now returns List<List<Cache>>
	  instead of List<Cache>. The first item in the returned value
	  corresonds to level 1 cache, the second level 2, and so on.
	  Instead of a flat list of caches of all levels, the returned value
	  is now more structured. Similar change was done for getTLBs() too.
	  examples/psxml/API_Demo.java was updated accordingly.

	NEW/CHANGED OPTIONS/ENVIRONMENT VARIABLES
	* Java API: The environment variable PS_DEBUG, used in PerfSuite C API,
	  now also has effects on Java API.  Users can set it as a non-negative
	  integer to have optional debug messages printed out. The levels are:
	  0 and below = OFF, 1 = FATAL, 2 = WARNING, 3 = INFO,
	  4 and above = VERBOSE. If PS_DEBUG is set to a value that is not an
	  integer, Java library will throw a NumberFormatException.
	* Java API: Two new environment variables are added.
	  PS_DEBUG_PREFIX is a string that appears at the beginning of each
	  Java API debug message. Its default value is "PS_DEBUG";
	  PS_DEBUG_SEPARATOR is a string that separates the prefix, debug level
	  string, and the debug message. Its default value is ":", the colon
	  character. So by default, an INFO level debug message will appear as:
	  PS_DEBUG:INFO:<debug_message_body>.

	XML-RELATED CHANGES
	* Java API: Added a method getTotalCacheSizeOfLevel(int level) in
	  CPUInfo class. This is useful in generating meta data in TAU
	  PerfSuite report parsing, and useful by itself.
	* Java API: Added the code to support parsing of the optional elements
	  "pid" and "thread" in PerfSuite HWPC reports. The two elements were
	  recently introduced in the hwpcreport and hwpcprofilereport DTDs in
	  release 1.0.0a1.
	* Java API: Added code to honor the configure option 
	  "--enable-tests=no", so when the option is given, the "tests"
	  directory will not be built.

	CONFIGURE/INSTALLATION UPDATES
	* Java API: Made changes to create a single perfsuite.jar from all
	  classes under src/javalib/perfsuite, instead of multiple jar files,
	  to simplify installation and use.
	* Java API: Used JAVA primary to significantly simplify multiple
	  Makefile.am files under src/javalib/perfsuite, in the following
	  directories: xml, xml/tests, util.
	* Java JNI: The header files used for JNI that were created by the
	  program javah are no longer distributed. They are not dynamically
	  generated either. Instead, their contents are incorporated in the
	  corresponding *.c files.  Correspondingly, the checking of javah
	  program is removed from configure.
	* configure script modified to cause --with-pfm options to accept only
	  supported versions of libpfm (2.x, IA/64 only).
	* Disabled building of static versions of libraries for all current
	  Tcl and Java C-coded extensions.  Disabled building of static version
	  of psrun support libraries.
	* Support for detection of BFD library redone, encapsulated in new m4
	  macro ACX_LIB_BFD.  New variable BFD_LIB_SONAME is used to allow the
	  builder to specify a non-standard name to use for the BFD shared
	  library.  This was done to address a common user difficulty when
	  configuring and building, particularly on platforms where mixing of
	  PIC and non-PIC code is not accepted.  Additional variables accepted
	  by new implementation: BFD_CPPFLAGS, BFD_LDFLAGS, and BFD_LIBS.  The
	  variable BFD_LIBS is meant to allow specification of additional
	  libraries needed by libbfd (e.g. -liberty).
	* Support for detection of cplus_demangle() and needed library
	  (libiberty) redone and encapsulated in new macro ACX_FUNC_DEMANGLE.

	TEST SUITE/EXAMPLE PROGRAM UPDATES
	* New example CalcPi.java added to directory "cpi" that is an example
	  of using the org.perfsuite.hwpc package API.
	* "PAPI with POSIX threads (multiplexed)" test case in libpshwpc test
	  suite modified to exit gracefully if thread creation limit is
	  exceeded.

	DOCUMENTATION UPDATES
	* Javadoc documentation for PerfSuite Java packages is now installed in
	  $(PREFIX)/share/perfsuite/doc/javadoc
	* INSTALL file updated to add new information regarding "configure"
	  options related to binutils/BFD.

	MISCELLANEOUS
	* SA_RESTART flag added to libpshwpc interval timer interrupt handler
	  used for the itimer measurement class.
	* In an attempt to comply to a common coding standard, changed Java API
	  and testsuite code, so that when possible, the width does not exceed
	  80 characters per line.
	* Supplied configuration file "papi_profile_cycles.xml" changed so that
	  the profiling sample rate increased to 10,000,000.  Prior value was
	  far too low for the clock rate of today's processors.


1.0.0 alpha 1 (2009/03/04)

	GENERAL
	* Introduction of Java-based software into PerfSuite, with the first
	  component being a Java package for programmatic access to data
	  contained in PerfSuite-generated XML documents.  See "New Components"
	  section for details.  Also see "Configure/Installation" updates.

	BUG FIXES
	* Performance monitoring via libpshwpc/psrun has been modified slightly
	  to reverse the order in which wall clock time stamps and performance
	  information are updated.  In all prior versions of PerfSuite,
	  when measurements over any interval were obtained, the time stamp was
	  updated first, and then the measurement of interest.  This order has
	  been reversed, so that cost of updating measurement (e.g. counters)
	  is now inclusive in the wall clock time reported.
	* Buffer size in libperfsuite internal "_ps_getargs" and "ps_addrmap"
	  functions increased from 128 to the value of PATH_MAX (or 4096).
	  Buffer size was found to be insufficient on NSF NMI Build and Test 
	  system.  Related: format string used to break out fields of
	  load map entries now represented in a string rather than hardcoded
	  in the function source.

	NEW COMPONENTS
	* New Java package "org.perfsuite.xml" that provides the ability to
	  easily parse PerfSuite-generated XML documents and programmatic
	  access to the data contained in them.  The initial release can parse
	  data contained in the following types of PerfSuite documents:
	  	- hwpcreport (both counting and profiling)
	  	- multihwpcreport
	  	- resourcereport
	  Example programs showing the use of the API can be found in the
	  directory $PREFIX/share/perfsuite/examples/psxml.
	  NOTE: this package requires Java 1.5 or newer.
	* New Tcl extension "pscube" that provides an interface to the Cube
	  writer library.  See ENHANCEMENTS.

	ENHANCEMENTS/FEATURE ADDITIONS
	* PerfSuite can now generate output files suitable for use with the
	  Cube visualization tool.  Cube is part of Scalasca, a set of open
	  source software tools for scalable performance analysis.  For more
	  information on Cube and Scalasca and links to download the software
	  (note: Cube can be obtained as part of Scalasca or as a standalone
	  package), see http://www.scalasca.org/ 

	API/HEADER FILE CHANGES
	* libperfsuite: ps_cputimes() and its Fortran equivalent removed from
	  API.  Deprecated in PerfSuite release 0.6.2.

	NEW/CHANGED OPTIONS/ENVIRONMENT VARIABLES
	* New psprocess option "--cube", which can be supplied with profiling
	  reports, allows the creation of output files suitable for use with
	  the Cube visualizer.

	XML-RELATED CHANGES
	* New elements added to <hwpcreport> and <hwpcprofilereport> XML
	  documents: <pid> and <thread>, which contain the process ID and the
	  internally-generated thread identifier (zero-based). DTDs updated to
	  include these elements.
	* "Multi-documents" created with "psprocess -c" now include DTDs.
	* New format/version for <hwpcprofilereport> documents that places
	  module information at the top level of a hierarchy that includes
	  function, file, and line granularities.  New DTD for version 0.2
	  installed: "hwpcprofilereport-0.2.dtd".  Old DTD persists as we
	  migrate from prior PerfSuite versions moving forward.
	* Content of <date> element in <hwpcprofilereport> modified to be
	  consistent with the format of ctime().
	* New DTD "multihwpcprofilereport-0.2" added.

	CONFIGURE/INSTALLATION UPDATES
	* New option for "configure": "--enable-java", which requests that
	  the Java-based software in PerfSuite is built (default: no).
	* New option for "configure": "--with-cube=DIR", that requests support
	  for the Cube writer API.
	* Option "--enable-mpi" for "configure" changed to "--with-mpi=DIR",
	  where DIR defaults to "/usr".  Related environment variable
	  MPICPPFLAGS changed to MPI_CPPFLAGS to improve consistency with other
	  configure variable names.
	* ACX_LIB_PAPI macro modified to retain user-specified PAPI_LDFLAGS.

	TEST SUITE/EXAMPLE PROGRAM UPDATES
	* New example directory "psxml" that contains examples of using the
	  org.perfsuite.xml Java package.
	* Modified Autotest keywords in libpshwpc test suite (PAPI-only tests)
	  to allow testing of all pthreads-related tests with the common
	  keyword "pthreads".  Formerly used both "thread" and "pthreads".
	* Added an explicit unset of PS_DEBUG environment variable in the
	  setup (atlocal) for the psprocess test suite.
	* libperfsuite test suite now adds .libs subdirectory to the
	  environment when running the test suite. PS_DEBUG is removed from
	  the environment for test suite runs via "export -n".
	* psprocess test suite modified to skip tests that require psrun if
	  psrun was not built during a particular configuration.
	* New test case for psprocess checks XML output for profiling reports.

	DOCUMENTATION UPDATES
	* psprocess man page updated to document "--cube" option.

	MISCELLANEOUS
	* psprocess debugging output capabilities standardized on generic
	  debugging support in procedure perfsuite::psdebug.


0.6.2 (2009/03/02)

	* No changes since 0.6.2 beta 3, no new bugs reported, final release.


0.6.2 beta 3 (2009/01/12)

	BUG FIXES
	* Addressed problem of infinite loop encountered in processor detection
	  routine (libperfsuite), reported on Intel Xeon E5462 system.

	TEST SUITE/EXAMPLE PROGRAM UPDATES
	* Bug fix (libperfsuite test case psf_rtc-test.f): renamed "stop"
	  variable to "tstop" to avoid collision with Fortran keyword.  Also
	  removed unused "sleepsecs" variable.


0.6.2 beta 2 (2008/11/25)

	BUG FIXES
	* (src/libperfsuite/procfs.c) Modifications to handle non-standard
	  /proc/PID/cmdline entries that differ from what is documented in the
	  proc(5) man page.  Different formats were discovered on various
	  kernels and caused failure of ps_getargs-test case.
	* (src/libperfsuite/procfs.c) Modifications to handle situation where
	  process load map file can be successfully opened, but read access is
	  denied.
	* (src/libperfsuite/timers.h) Access to cycle counter, when <asm/msr.h>
	  is available, was found to not always provide a definition for a
	  suitable macro, depending on prefined compiler preprocessor
	  definitions.  Modified to provide fallback definitions in this case.
	* (configure.ac) Modified --with-papi and --with-pfm options in
	  configure to behave properly if supplied with no argument.

	DOCUMENTATION UPDATES
	* Documented (in the BUGS file) a bug and workaround for a failure of
	  psprocess to generate HTML output, observed on an x86-64 system with
	  tDOM 0.8.2.  This bug causes a memory deallocation error and core
	  dump during an <xslt:sort> transformation.
	

0.6.2 beta 1 (2008/10/31)

	GENERAL
	* Now developed using PAPI 3.6.2.
	* Now supports Intel Core/Core 2 platforms and AMD family K10.
	* Substantial changes in configure setup and options.  Please see the
	  separate CONFIGURE/INSTALLATION section below for details.

	BUG FIXES
	* Internal routines dealing with maintaining cache/TLB information
	  reworked, as segfault was occurring on newer platforms.  Moved
	  processor-independent cache management routines to a separate source
	  file (cache.c).  Removed "sectored" member from cache descriptor
	  data structure, as it was never used.
	* Formatting bug corrected in libpshwpc, which could have resulted in
	  negative sample counts output to XML document.
	* libperfsuite: IA-64 parsing of CPU speed from /proc/cpuinfo changed
	  from itc to cpu MHz.
	* Added additional error checking code in use of mmtimer to isolate
	  error locations on failure.
	* psprocess: fixed error that occurred on systems where the psbfd Tcl
	  extension is absent but pscxxfilt extension available.  Resulted in
	  runtime exception when post-processing profiling documents.
	* libpspapi (Tcl extension for PAPI): Automake variables not set
	  properly in order to ensure that the library needs PAPI's shared
	  library - manifested in failure of psconfig to determine available
	  PAPI events.

	NEW COMPONENTS
	  None

	ENHANCEMENTS/FEATURE ADDITIONS
	* Processor detection routine expanded to include new Intel
	  deterministic cache parameter information, required for Core.
	* New configuration file for Core systems using PAPI 3 called
	  "papi3_core.xml".
	* Adapted timing routines to work with mmtimer support in mainline
	  Linux kernel as well as earlier SGI-specific implementation.
	* Updated processor recognition routines for IA-64 to support later
	  Madison and Montecito processors.
	* Updated x86/x86-64 feature flag definitions for Intel processors.
	  Current as of Intel AP-485 (12/2007).  Note: extended feature flag
	  definitions are not currently displayed by psinv.

	API/HEADER FILE CHANGES
	  None

	NEW/CHANGED OPTIONS/ENVIRONMENT VARIABLES
	  None

	XML-RELATED CHANGES
	  None

	CONFIGURE/INSTALLATION UPDATES
	* Configuration option "--with-perfmon" renamed to "--with-pfm" and
	  reimplemented.  configure now accepts the variables PFM_CPPFLAGS,
	  PFM_LDFLAGS, and PFM_LIBS.  Help output describing these variables
	  has been added to the output of "configure --help" and the
	  description of the "--with-pfm" option to configure has been updated
	  accordingly.
	* Configuration option "--with-papi" reimplemented.  New variables
	  PAPI_CPPFLAGS, PAPI_LDFLAGS, and PAPI_LIBS can be supplied to
	  configure, help information added to configure.
	* Perfmon/Perfmon2 and PAPI autoconf M4 source now contained in
	  separate macro definition files "acx_lib_pfm.m4" and 
	  "acx_lib_papi.m4", both in "acmacros" subdirectory.
	* Added check for Intel-based x86_64 platforms in configure.ac, and
	  tagged as COREFAMILY.
	* Added configure check for caddr_t type with fallback definition of
	  char *.
	* Adapted configure-time check for mmtimer to include both linux and sn
	  include subdirectories.
	* Adapted configure script to recognize both string- and number-based
	  IA-64 processor family representation in /proc/cpuinfo.
	* autoconf 2.6.1, automake 1.10, libtool 1.5.24

	TEST SUITE/EXAMPLE PROGRAM UPDATES
	* Syntax error fix: cpi-mpi.c changed "endif" to close brace.
	* mpx-pthread test case modified slightly to help identify errors that
	  arise from Perfmon2 limitations on multiplexing.  The test case will
	  still indicate failure, but a message is written to standard error if
	  PAPI_start fails with ESYS and errno is E2BIG.
	* mpx-pthread array for counter values changed from "unsigned long long"
	  to "long long" to avoid signed-ness mismatch.
	* Modified ps_rtc-test and ps_hash-test to check for system error on
	  failure in RTC initialization and display perror() strings.
	* Several changes made to libpshwpc test suite Makefile to force the
	  proper libraries to be included at link time.  General cleanup of
	  build of this test suite via Makefile.am.
	* New environment variable PS_TESTSUITE_MAX_MALLOC recognized.  This
	  variable, which is interpreted in megabytes, can be used to limit the
	  amount of memory allocated during the memory usage test case in the
	  libperfsuite test suite (default is currently 1/10th of the total
	  memory available across the system).  This can be useful on systems
	  like the SGI Altix where administrators can restrict the maximum
	  memory available to any particular process to only the memory of the
	  local node.

	DOCUMENTATION UPDATES
	* INSTALL file updated to note recent updates in tDOM development.
	* Note added to INSTALL file to help explain PAPI/Perfmon2 errors that
	  may arise when running the multiplexed POSIX threads test case.

	MISCELLANEOUS
	* Removed any remaining references to perfctr.


0.6.2 alpha 6 (2006/12/11)

	GENERAL
	* Now developed using PAPI version 3.5.0 (older releases should still
	  work).
	* Default event configurations changed to reflect PAPI standard event
	  definitions in PAPI 3.5.0: papi3_p4.xml

	  ***************************************************************
	  ** NOTE: THIS MAY REQUIRE LOCAL ADJUSTMENTS OF XML DOCUMENTS **
	  **       INSTALLED IN $PREFIX/share/perfsuite/xml/pshwpc     **
	  **       DEPENDING ON WHICH VERSION OF PAPI IS IN USE        **
	  ***************************************************************

	BUG FIXES
	* libpshwpc: incorrect use of PAPI_sprofil() that manifested itself in
	  PAPI 3.5.0 fixed.  Previously, overflow was not reset by a call to
	  PAPI_sprofil() before cleaning out and destroying the associated
	  event set, resulting in PAPI_EINVAL runtime error from PAPI.
	* psprocess: CSV output from <multihwpcreport> counting documents
	  caused invalid array references and a runtime error if one of the
	  individual documents did not generate all the same metrics as the
	  others.  Now outputs an "empty" entry in the CSV output (i.e. ",,")
	* psprocess: processing of profile reports where a module listed in the
	  load map cannot be found (most likely to happen when the profiled
	  executable has been moved or renamed) was not handled properly and
	  resulted in premature error exit.  Modified to skip processing of any
	  such module with a warning notice to standard error.  When the user
	  has supplied an executable with the -e option, attempts to use it and
	  also signals this to the user via a message to standard error.
	* psrun: signal catching of SEGV changed to "one-shot" style to avoid
	  repeated (infinite) generation of warning messages to standard error.
	* libperfsuite: corrected two incorrect scanf formats used during scan
	  of /proc entries for cache/TLB info.
	* libperfsuite: addressed potential source of overflow/wrap when using
	  mmtimer.

	NEW COMPONENTS
	* New PSTcl C extension "psmd5", containing a single command
	  "::psmd5::md5" that performs MD5 checksum generation using MD5_RFC
	  (see ENHANCEMENTS/FEATURE ADDITIONS).  Built by default, unless
	  "--disable-md5" is given to configure.

	ENHANCEMENTS/FEATURE ADDITIONS
	* Added support for adjustable multiplexing interval (available only
	  with PAPI versions > 3.2.1).  Default remains 10000 microseconds.
	* psprocess updated to include support for adjustable multiplexing
	  interval.
	* psrun/libpshwpc now support generation of MD5 checksums that can be
	  included in the <hwpcreport> output XML document or text output if
	  selected.
	  Note: The MD5 checksum generation capability in libpshwpc is taken
	  from the MD5-RFC library, a freely-available implementation of the
	  MD5 algorithm written from the RFC 1321 spec (RSA-free).  Thanks go
	  to the author of this library, L. Peter Deutsch, for making his work
	  available.  Also note that this portion of the PerfSuite distribution
	  is covered under a separate license from the PerfSuite license.
	  See http://www.sourceforge.net/projects/libmd5-rfc/ and the source
	  code in directory ext/md5 for more information.
	* psprocess updated to display MD5 checksum information if present in
	  a given <hwpcreport> document.
	* psprocess, when invoked with the "-e executable" option and given an
	  <hwpcreport> that contains an MD5 checksum, will compare the checksum
	  found in the document with one computed from "executable" and report
	  a warning to standard error if the two checksums do not match.
	* Updated processor cache specifications per Intel AP-485 application
	  note, dated 9/2006.

	API/HEADER FILE CHANGES
	* PAPI-to-PerfSuite conversion routines signature change.  "ticks"
	  parameter changed from "long long" to "unsigned long long".

	NEW/CHANGED OPTIONS/ENVIRONMENT VARIABLES
	* New environment variable PS_HWPC_MPX_USEC recognized by libpshwpc and
	  psrun.  This variable, if set, should contain an integer representing
	  the multiplexing interval in microseconds (default 10000).
	* psprocess "-e executable" option is now strictly optional when
	  working with hwpcreport profiling documents.  It is still accepted
	  and used if a load map module is present in the hwpcreport but cannot
	  be located on the system.
	* New option to psrun "--md5" and new enviroment variable PS_HWPC_MD5
	  recognized by psrun/libpshwpc to request MD5 checksum generation.

	XML-RELATED CHANGES
	* <hwpcreport> DTD updated to include new attribute "multiplex_usec"
	  added to the <hwpceventdata> elements in counting reports.
	* psprocess now outputs a <command> element as a child of
	  <executioninfo> element when processing a profiling report and XML
	  output is selected (-x option to psprocess).  <hwpcprofilereport>
	  DTD updated to include new element as optional.
	* <hwpcreport> DTD updated to include new optional attribute "md5sum"
	  within a <command> element.  Value is the generated MD5 checksum in
	  hexadecimal format.

	CONFIGURE/INSTALLATION UPDATES
	* New configure option "--enable-md5" to control inclusion of MD5
	  checksum capability.  Enabled by default, use "--disable-md5" to omit
	  from the build.
	* autoconf 2.60, M4 1.4.4

	TEST SUITE/EXAMPLE PROGRAM UPDATES
	* "sampler" example operation documented through comments in the source
	  code.  Minor code change to use calloc rather than malloc-and-zero.
	* psprocess build adapted to honor --disable-tests configure option.
	* psprocess test suite atlocal.in modified to explicitly include the
	  test source directory in the Autotest path (in response to failure
	  after moving to autoconf 2.60).
	* "mpicheckargs" example moved from cpi to misc subdirectory.
	* Test case papitest.c in libpshwpc modified to address compiler
	  diagnostics about type mismatches.
	* New test case ps_md5-test to check basic MD5 checksum generation.

	DOCUMENTATION UPDATES
	* psrun man page: updated to include information about PS_HWPC_MD5 and
	  PS_HWPC_MPX_USEC environment variables and new --md5 option.
	* psprocess man page: updated to describe change in behavior of -e
	  option.

	MISCELLANEOUS
	* Source files renamed: psrun_resource.[ch] changed to resource.[ch].
	* Adjustments made to internal structure definitions to reduce padding
	  and maintain consistent type declarations/use (xmlparse.c, hwpc.c)
	* Adjustments made to libpshwpc (hwpc-{text,xml}.c) and psinv to
	  address signed-vs-unsigned compiler warnings.
	* psprocess HTTP agent URL changed to http://perfsuite.sourceforge.net
	  

0.6.2 alpha 5 (2006/06/01)

	BUG FIXES
	* psprocess: failure in combine operation did not exit with non-zero
	  exit status.  Fixed, and error report to user improved to help
	  indicate where the failure occurred.
	* psprocess: XSL stylesheet for one PAPI_FP_OPS-based metric
	  incorrectly used PAPI_FP_INS.  Affected -H option when using
	  psprocess with counting reports.
	* PSTcl: hwpc metric calculation generated runtime error if no derived
	  metrics were calculated for a particular metric definition file.  Now
	  returns empty list containing no metrics.
	* PSTcl: hwpc metric generation now checks to make sure each <name>
	  element in a metric definition contains no whitespace.  Previously
	  would have resulted in a Tcl runtime exception.

	NEW COMPONENTS
	None

	ENHANCEMENTS/FEATURE ADDITIONS
	* PSTcl psbfd extension reworked to use BFD mini symbols.  This should
	  result in a reduction of memory usage by the extension.
	* PSTcl psbfd extension modified to return BFD-generated error messages
	  as appropriate.  Error message/usage returned by psbfd::open changed
	  to refer to "object-file" rather than "executable".
	* PSTcl psbfd extension Tcl package version moved from 0.1 to 0.2.
	* psprocess now issues a warning to standard error when processing a
	  profiling XML document in which a file named within a <module>
	  element does not exist.  The user is responsible for modifying the
	  document to point to the correct executable or shared library.

	API/HEADER FILE CHANGES
	* PSTcl psbfd extension now defines two variables "version" and
	  "patchLevel" in namespace ::psbfd for access to versioning
	  information.

	NEW/CHANGED OPTIONS/ENVIRONMENT VARIABLES
	* psprocess now recognizes an environment variable PS_HWPC_METRICS_DIR
	  that can be used to specify an alternate directory to search for base
	  derived metrics definitions.  These definitions must conform to the
	  filename convention "CLASS_metrics.xml", where "CLASS" is identical
	  to the "class" attribute specified in the <hwpcreport> that is being
	  processed.  Note that this is different than the existing environment
	  variable PS_HWPC_METRICS, which allows the addition of user-defined
	  metrics that *supplement* the base metric definitions.
	* psprocess recognizes a new option "-M" or "--metricsdir" that can be
	  used for the same purpose as PS_HWPC_METRICS_DIR.  Both the new
	  option and environment variable have been documented in the psprocess
	  man page.

	XML-RELATED CHANGES
	None

	CONFIGURE/INSTALLATION UPDATES
	* PSTcl psbfd extension now installed with package version number
	  appended to installation directory name ($PREFIX/lib).  Subdirectory
	  in $PREFIX/lib changed from "bfd" to "psbfd". Subdirectory in
	  $PREFIX/share/perfsuite/tcllib/psutils removed as unnecessary.
	* Build system modified to build/test psrun prior to psprocess.
	* Moved auxiliary Autoconf macros from acinclude.m4 in top-level
	  distribution directory to new "acmacros" subdirectory.  acinclude.m4
	  no longer contained within the distribution.
	* Moved Autoconf "config" directory to "acaux".

	TEST SUITE/EXAMPLE PROGRAM UPDATES
	* psprocess test suite expanded to include tests with "live" psrun
	  output, resource reporting, correct operation of combine and extract
	  modes, file output, fast XML parser, use in pipeline, invalid input 
	  handling, calibration, annotation, validation, user-defined metrics,
	  abbreviated output. Test suite also checks basic tDOM operation.
	* Test group titles for psrun and psprocess changed to remove tool name
	  from title.
	* cpi-pthreads example program bug fix: ps_hwpc_stop() was being
	  called twice when compiled for non-threaded execution and enabled for
	  libpshwpc support.
	* cpi-pthreads and cpi-omp example programs modified to avoid several
	  compiler warnings.
	* New example program "maxwall.tcl" in examples/pstcl that adjusts
	  wall clock elements within <multihwpcreport> (counting mode) reports
	  to the maximum among them.

	DOCUMENTATION UPDATES
	* Removed out-of-date documentation for libpshwpc and psrun that was
	  previously installed in $PREFIX/share/perfsuite/doc.
	* Modified instructions related to PAPI build/test/installation in the
	  INSTALL file (users should follow the instructions provided in the
	  PAPI distribution).  This was done in 0.6.2a4 but not noted in the
	  CHANGES file.

	MISCELLANEOUS
	None

0.6.2 alpha 4 (2006/05/04)

	* Addressed a bug within psprocess when used in combine mode where
	  an unset variable was referenced, causing a runtime error.  Many
	  thanks to Henry Jin for finding and reporting the problem.

0.6.2 alpha 3 (2006/04/28)

NOTE: 2.6 kernel changes make libperfsuite incompatible with earlier
      PerfSuite 0.6.2 alpha releases.  Recompile and relink necessary.
      Constants and structure layouts have changed.

	GENERAL
	* Now developed/tested against 2.6-based kernels.

	BUG FIXES
	* Bug fix (libperfsuite): modification made to load map parsing
	  routine to arrange for writable modules to be included in the process
	  address map.  This had broken profiling functionality.
	* Bug fix (libperfsuite): ps_rtc(), when configured with --enable-rtc
	  set to gettimeofday, could have overflowed.  This has been addressed
	  but is still susceptible to overflow when the number of clock ticks
	  elapsed since the UNIX epoch exceeds available space in a 64-bit
	  signed integer (at current CPU speeds, this will occur in the middle
	  of the 21st century).
	* Bug fix (psrun): --info option was not reporting capability of
	  Perfmon-based profiling even if available.
	* Bug fix (psprocess): itimer-based profiles were not recognized when
	  generating gmon-format output.
	* Bug fix (psprocess): "-m" option was not being propagated to the
	  lower layers of software, resulting in no effect.
	* Bug fix (psprocess): field width adjustment for <multihwpcreport>
	  documents in which all metrics are less than 1.0.
	* Bug fix (libpshwpc/psinv/psrun test suites): atlocal was defining but
	  not exporting LD_LIBRARY_PATH.  Also arranged to preserve any
	  existing LD_LIBRARY_PATH settings.
	* Bug fix (psprocess): profiling address map management modified to
	  store all sample counts according to their original address within
	  the executing process, not offsets into the library file.  Previously
	  may have caused attribution of samples to the wrong module, with
	  shared libraries most vulnerable.
	* Bug fix (psbfd): memory leak in case of error occurrence during
	  BFD open/setup addressed.

	NEW COMPONENTS

	ENHANCEMENTS/FEATURE ADDITIONS
	* Updated x86 cache spec information per Intel Application Note 485
	  dated January 2006.
	* ps_procstat() routine modified to access per-thread information when
	  given PID 0 on 2.6 kernels and using the threaded version of
	  libperfsuite.  With earlier kernels, returns per-process data as
	  before.
	* New timers added for XML parsing and PC->addr mapping in psprocess.
	* Refactored psprocess profiling code related to PC->address mapping to
	  consolidate use of psbfd or addr2line.  Also short-circuited use of
	  psbfd or addr2line for modules with no associated samples.
	* Added L3 cache hit rate metric for Perfmon measurements.
	* Added cycles per TLB miss and loads/stores (separately and together)
	  per TLB miss metrics for PAPI measurements.
	* Added graduated loads/stores (when measured separately) per floating
	  point operation/instruction metrics for PAPI measurements.
	* New signal-catching capability added to libpshwpc and psrun, accessed
	  through the environment variable PS_HWPC_SIGNAL or the psrun options
	  "-S/--signal".  This requests, on receipt of the signals listed, that
	  performance monitoring data is written before the application exits.
	  Multiple signals may be listed in comma-separated value format.
	  Signals must be given as numbers, not names.  Default is the usual
	  behavior on signal receipt, with no performance data written if the
	  process terminates due to the signal.  psrun man page and usage
	  output updated.
	* XML configuration documents updated: papi3_p4.xml, papi3_k8.xml.
	  Updated to reflect events available in PAPI 3.2.0 (released
	  11/21/2005).
	* PSTcl binutils/file packages error-checking improved.  Updated to
	  recognize more recent error messages (file-4.12).  Updated to guard
	  against address lookups without having first opened a file.

	API/HEADER FILE CHANGES
	* API (header) change: ps_strerror() return type is now "const char *"
	* libperfsuite error code/string structure changed to read-only data.
	* API (libpshwpc entry point) change: PAPI-to-PerfSuite conversion
	  routines ps_hwpc_PAPI_write() and ps_hwpc_PAPI_hl_write() are no 
	  longer available if not configured with PAPI.  Previously, a call to
	  these routines would return PS_ENOTINSTALLED if PAPI was not
	  available, now will result in link-time error.  The prototypes for
	  these routines have been removed from <pshwpc.h> and placed in a new
	  header file <pshwpcpapi.h> that will be installed only if configured
	  with PAPI.
	* ps_cputimes() routine adapted for 2.6 kernels, returning the error
	  code PS_ENOTIMPLEMENTED.  Noted in <perfsuite.h> header file.
	  Also marked as deprecated in <perfsuite.h>.
	* psbfd "lookup" command now returns "??" instead of "?" for cases
	  where the file name cannot be determined.  This interface change was
	  made to more closely match the output of addr2line.  The shared
	  library in which this extension is implemented has been tagged with
	  a new revision (1.0.0) to reflect this interface change.
	* psbfd "open" command now returns the name of the file on success.
	* PSTcl ::perfmon::isAvail procedure modified to return FALSE when used
	  on a system on which perfmon is not installed.

	NEW/CHANGED OPTIONS/ENVIRONMENT VARIABLES
	* psrun exit status modified in the case where the monitored command's
	  exit status is requested and the command terminates due to signal
	  receipt: psrun now exits with status (signal number + 128).
	* psrun supports a new option "-R/--resourceonly", which requests
	  resource monitoring only (no performance monitoring).  The existing
	  option "-r/--resource" continues to do both performance and resource
	  monitoring as before.
	* New environment variable PS_HWPC_PIDDIR (recognized by libpshwpc)
	  which should contain an absolute path name of an existing directory
	  in which zero-length sentinel files are created that conform to the
	  template PID.HOSTNAME.  These sentinel files exist for the duration
	  of monitoring by libpshwpc. They are unlinked after monitoring is
	  completed through a call ps_hwpc_shutdown().  No PID sentinel files
	  are created by default.  Files are created per-process (not thread).
	* New environment variable PSPROCESS_MAPPER recognized by psprocess
	  that allows the user to force the use of the addr2line utility for
	  mapping PC values to source code lines.  The only recognized value
	  for this variable is "addr2line" (any other value issues a warning
	  message to standard error and uses the default). Man page updated.
	* New environment variable PSPROCESS_TRACE recognized by psprocess
	  that allows the user to specify a file name to which PC->source line
	  information is output. Man page updated.

	XML-RELATED CHANGES
	* Version number attribute for <hwpcreport> and <resourcereport>
	  documents has been changed from 0.1 to 0.2 as a result of new
	  elements/DTD in PerfSuite 0.6.2.
	* New DTD: <hwpcprofilereport> for documents generated by psprocess
	  with "-x" option. Installed in share/perfsuite/dtds/pshwpc.
	* New DTD: <machineinfo>, broken out into separate DTD for inclusion in
	  DTDs that share machine information.  Installed in above location.
	* All perfmon-based configuration files now list events using the
	  type attribute "preset" instead of "native".  Note that this means
	  that previous perfmon configuration files containing the name of the
	  event as the content of the element now require that it is listed as
	  an attribute (with no element content).
	* <hwpcprofilereport> documents now include DTD (SYSTEM).
	* New XSLT stylesheet for <hwpcprofilereport> documents, installed in
	  share/perfsuite/xml/pshwpc.  psprocess will use this stylesheet when
	  given the option "-H/--html", otherwise issues a warning and exits.
	* XSL stylesheet for libpshwpc PAPI reports (counting mode) updated to
	  include statistics for PAPI_FP_OPS similar to existing PAPI_FP_INS
	  statistics.  Thanks to Giuseppe Grieco for reporting this omission.

	CONFIGURE/INSTALLATION UPDATES
	* Added instructions for building multilib versions of PerfSuite to the
	  INSTALL file.
	* Added instructions for installing stripped binaries to INSTALL file.
	* Added information about installing Tcl development packages to the
	  INSTALL file.
	* Added check for Linux major/minor versions in configure script and
	  a new configure-time option: --with-kernel-srcdir=DIR.  Added
	  warning message if neither 2.4 nor 2.6 are determined to be in use.
	* configure script modified to explicitly test if "icc" is specified as
	  the C compiler and to exit with an error if so.
	* configure script modified to not add "/include" to the argument
	  supplied to --with-tclinclude option.  Thanks to Tirath Ramdas for
	  reporting this problem.
	* configure script modified to include compilation test in addition to
	  preprocessing test for header check of <asm/msr.h>.
	* configure test for PAPI_event_info_t vendor_name field changed to use
	  standard AC_CHECK_MEMBER macro.
	* Added check for Perfmon version in configure script.  Currently
	  disables direct Perfmon support if Perfmon major version is not 1.
	* Added check for volatile keyword in configure script.
	* configure script modified to check for xmllint.
	* configure script test against canonical system info changed to strict
	  triplet.
	* automake 1.9.6, libtool 1.5.22

	TEST SUITE/EXAMPLE PROGRAM UPDATES
	* Memory usage test case modified to allocate less memory.  Appeared
	  to cause hang problems on select systems.
	* New test case added: ps_tokenizer-test, to check new internal
	  tokenizer routine in libperfsuite.
	* New example program "sampler" that uses libpshwpc in conjunction with
	  interval timers to periodically sample performance data.
	* New example Perl script "psrunfull.pl" that executes a given
	  command under control of psrun using all available PAPI events.  The
	  script will rerun the command as many times as is necessary until all
	  events have been measured.  Many thanks to Kalev Leetaru for this
	  contribution.
	* New example PSTcl program "multihwpc-merge.tcl" that merges event
	  counts from <multihwpcreport> documents into a single <hwpcreport>.
	* New C/OpenMP example cpi program w/optional libpshwpc support.
	* New test program "mpicheckargs", installed in the examples/cpi
	  directory, that can be used to check if the MPI implementation in
	  use preserves command name and arguments, necessary for psrun to be
	  effective.
	* Added "-lperfsuite" explicitly to the matvec example PS variants.
	* papiavail.tcl example extended to check that PAPI is installed and
	  working before querying PAPI information.
	* All C versions of example/cpi program now can be compiled with
	  calls to libpshwpc under control of cpp macro PSHWPC.
	* Added option "-q" to getsolibs example that causes the loaded
	  libraries to be displayed on a single line, space-separated.
	* Added the GPL COPYING file to the threadrun example to reflect the
	  license terms of the original source from the VProf package.  This
	  only applies to the source file threadrun.c

	DOCUMENTATION UPDATES
	* ChangeLog renamed to CHANGES.
	* CHANGES added to files installed in $PREFIX/share/perfsuite/doc.
	* Added new section "MPI NOTES" to the psrun man page for hints about
	  using psrun with certain MPI launch commands.
	* Added mention of the examples subdirectory to the psprocess man page.

	MISCELLANEOUS
	* Format of psrun error messages changed slightly.  In some instances,
	  the string "psrun fatal error" is now "libpsrun fatal error".
	* Adjustment made to cycle counter access routine to detect 32-bit
	  compilation on x86-64 platforms.
	* libpshwpc _ps_hwpc_exclude_exe() routine made cancel-safe.
	* PSTcl BFD extension modified to address removal of <bfd.h> macro
	  (bfd_get_section_size_before_reloc) in more recent binutils versions.
	* Disabling of profil() modified in libpshwpc to supply non-NULL value
	  for the sample buffer, conforming to <unistd.h> prototype.
	* libperfsuite CPU info mutex changed to file-private.
	* Output routines in libpshwpc modified to use value of $LOGNAME rather
	  than getpwuid() in all cases.
	* libperfsuite and PSTcl routines updated according to changes in the
	  2.6 Linux /proc/PID/stat format.
	* Consolidated all environment/option string definitions used in psrun.
	* Added explicit "extern" qualifiers to libperfsuite library-internal
	  header files psdebug.h and psinternal.h.

0.6.2 alpha 2 (2005/02/08)
	
	* Bug fix (build system): Perfmon libpfm library was not being included
	  in link lines if PerfSuite was not configured with PAPI on IA-64.
	* Changed default psrun/libpshwpc configuration file for IA-64 when
	  not configuring with PAPI to pfm_ipc.xml if Perfmon is available,
	  otherwise defaults to profil.xml.
	* Usage output for psprocess corrected for "--calibrate" option.
	* Usage output and manual page for psrun updated to document new
	  environment variable PS_HWPC_SAMPLE_ENTRIES, recognized by
	  psrun/libpshwpc when profiling with perfmon.
	* New example script "getsolibs", in examples/misc, that helps to
	  determine what shared libraries are loaded by a program.
	* Removed use of tclsh in generation of package index for plotchart.
	* New "perfmon" Tcl package (this was added in 0.6.2a1 but not listed
	  in the ChangeLog).

0.6.2 alpha 1 (2005/02/04)

	GENERAL
	* Release level moved to 0.6.2 due to new APIs.  libperfsuite is not
	  backward-compatible with 0.6.1 versions.

	BUG FIXES
	* Bug fix (psprocess): error was generated if no event counts were in
	  a hwpcreport (counting).  Now exits with a message rather than
	  runtime error.
	* Bug fix (libperfsuite): extra safety check added to processor
	  detection routine to ensure that subsequent calls after failure do
	  not receive bad values.
	* Guard against invalid value given to psf_strerror() routine reworked
	  slightly.  Result may be different than in 0.6.1.
	* Added missing attributes to hwpcreport DTD (<module> element).
	* Removed check for executable files when opening files with the
	  binutils::addr2line function, which interferes with pc->line mapping
	  for shared libraries that do not have the execute bit set.
	* Bug fix (psrun): replaced method of calculating the process start
	  time for resource reporting, which could have returned erroneous
	  results on systems like the SGI Altix.
	* Bug fix (configure): explicit checks for <expat.h> and libexpat added
	  and if either unavailable, adjust configuration to skip libpshwpc and
	  psrun.

	NEW COMPONENTS
	* New "perfmon" measurement class added to libpshwpc and psrun that
	  provides direct access to the Perfmon library (libpfm-2.0 only) on
	  IA-64 systems.  Syntax is similar to PAPI, but uses the value
	  "perfmon" for the "class" attribute and IA-64 native event names.
	  Both counting and profiling are supported for serial and threaded
	  programs.  Several new example XML configuration files are supplied;
	  these have the filename prefix "pfm_".  psprocess updated to accept
	  output documents with IA-64 events and to calculate metrics based on 
	  them (suggestions for additions and corrections are welcome).
	* New "itimer" measurement class added to libpshwpc and psrun profiling
	  that allows you to perform interval timer-based profiling similar to
	  profil() with additional flexibility: the timer (event) can be any
	  one of ITIMER_REAL, ITIMER_VIRTUAL, or ITIMER_PROF, and the sampling
	  frequency can be adjusted through the "threshold" attribute.  Shared
	  libraries are also included in the profile.  ps_hwpc_profile and
	  hwpcreport DTDs updated.  An example itimer.xml configuration file is
	  installed in the standard config directory.  psprocess updated to
	  support itimer-based profiles. Test cases added.
	* New example directory for PSTcl examples, installed in 
	  share/perfsuite/examples/pstcl.  README file in the examples
	  directory updated with descriptions of the contents.
	* New XML document containing PAPI standard events and descriptions,
	  installed in share/perfsuite/xml/pshwpc.
	* New psxml Tcl package added.
	* New subdirectory "ext" for external software included in the
	  distribution.  Added "Plotchart" package from the tklib portion of
	  the standard Tcl library (tcllib).  This is not part of PerfSuite and
	  is covered under a separate BSD-style license (included).

	ENHANCEMENTS/FEATURE ADDITIONS
	* Added support for resource use reporting in psprocess.
	* psrun resource reporting is now thread-based rather than managed
	  through signals.
	* psrun resource reporting now tracks load averages over the course of
	  the run.  High-water marks based on 1/5/15-min load average are
	  reported as well as a histogram of load averages sampled during the
	  run. 
	* psrun resource reporting includes a description of the signal
	  that caused process termination if the process did not exit
	  normally (text output only)
	* The default threshold for hardware counter profiling has been set to
	  100000 uniformly (previously defaulted to 10000 for PAPI profiling).
	* psrun/libpshwpc plain text profiling output now includes a basic 
	  histogram display associated with each sampling address.  Each
	  asterisk represents 2.5% of the total samples collected over the run.
	* libpshwpc default XML output document prefix is now the basename of
	  the executable, rather than "pshwpc".  You can revert to the old
	  naming through the environment variable PS_HWPC_FILE.  This makes
	  behavior consistent with changes made to psrun beginning with 0.6.1
	  beta 6.
	* libpshwpc/psrun default output document prefix now includes the
	  hostname of the computer.  The hostname string includes all
	  characters up to the first "." (that is, a hostname like 
	  "localhost.localdomain" will be changed to only "localhost").
	* psprocess now accepts the keyword "stdin" in place of the name of an
	  XML document, allowing the command to be used in a pipeline.  This
	  should only be used in situations calling for exactly one XML 
	  document.  It also implies you cannot use the name "stdin" for an
	  input document.
	* New DTD: psmetrics.dtd, installed in share/perfsuite/dtds/pshwpc.
	* New DTD: resourcereport.dtd, installed in share/perfsuite/dtds/psrun.
	* DTD change: <hwpcreport> documents now include a <command> element,
	  content is the basename of the executable.  psprocess modified to
	  display this information.  Text-based output updated as well.
	* DTD change: new <cputime> element in <hwpcreport> documents with
	  <usertime> and <systemtime> contained.
	* DTD change: <hwpcreport> now includes optional "version" attribute
	  identifying the version of the underlying performance software layer.
	  The associated elements are <hwpceventdata> and <hwpcprofiledata>.
	* DTD change: changed <ps_hwpc_event> "name" attribute declaration to
	  CDATA instead of explicit strings.
	* DTD change: expanded acceptable values for the "class" attribute in
	  <ps_hwpc_eventlist> and <ps_hwpc_profile> documents.
	* DTD change: <profileevent> element is now mandatory for <hwpcreport>
	  documents where mode="profile".
	* psprocess now displays performance layer version information for
	  profiling runs, also added to libpshwpc plain text output for 
	  profiling runs (it is not currently displayed for counting runs).
	* psrun now issues a warning message to standard error if the
	  environment variable PSRUN_PID is set (this is reserved for psrun
	  internal use).
	* matvec-ps.f example modified to print out error strings on failure.
	* psinv now reports OS/system information as given by uname().
	* psrun profiling using the "null" class now outputs XML documents that
	  include <profileevent> and <threshold> elements, making them uniform 
	  with other profiling classes.

	API/HEADER FILE CHANGES
	* libperfsuite API change: ps_strerror is now
	  "char *ps_strerror(int code)", instead of copying the error string 
	  into a user buffer.  Fortran equivalent "psf_strerror" remains
	  unchanged.  This is incompatible with earlier releases.
	* libperfsuite API change: ps_cputimes prototype and associated data
	  structure ps_cputimes_t now represents CPU times as seconds (as a
	  floating point value) rather than jiffies.  Fortran API changed
	  similarly.
	* ps_addrmap() and ps_cpuid() routines removed from libperfsuite for
	  internal use only.
	* New libperfsuite routine: ps_dmemusage() can be used to obtain
	  information about the current amount of memory dynamically allocated.
	  Fortran equivalent PSF_dmemusage() available.
	* New libpshwpc routines: ps_hwpc_numevents(), ps_hwpc_read(),
	  ps_hwpc_eventnames(), ps_hwpc_version().
	* New libpshwpc_mpi routine: MPI_Pcontrol().  Calling with a value
	  of 0 disables monitoring, any other value resumes monitoring.  The
	  environment variable PS_HWPC_PMPI can be used to control monitoring:
	  setting to zero causes no monitoring to begin until a call to
	  MPI_Pcontrol() with a non-zero argument.  Default is for monitoring
	  to be started at the call to MPI_Init().
	* All continuation lines removed from <fperfsuite.h>
	* Standard error code PS_HWPC_EPAPI removed.  Any routines that 
	  returned PS_HWPC_EPAPI on error now return the new error 
	  code/constant PS_HWPC_EPERF.  Updated in <pserror.h> and
	  <fperfsuite.h>.
	* Tcl package name change: the Tcl extension for PAPI is now exported
	  as package "papi", while the shared library (C extension) support is
	  loaded as "pspapi" from within the Tcl papi package. psprocess,
	  example scripts, and package index files updated.  This allows a
	  subset of PAPI support regardless of the availability of PAPI itself.
	* Tcl ::procfs::stat command extended to include fields found in more
	  recent kernel sources, if present.
	* <pshwpc.h> now defines a data type ps_hwpc_value_t, which is
	  the type to use for storing the value of a performance counter.
	  Defined to "long long".

	NEW/CHANGED OPTIONS/ENVIRONMENT VARIABLES
	* New environment variable PS_HWPC_NOHOSTNAME is recognized - if set,
	  will disable inclusion of hostname.
	* All psinv options now have short and long (--) variants.  Man page
	  updated.
	* psinv can now write out a <ps_hwpc_eventlist> XML document containing
	  all available PAPI events that can be used as a starting point for a
	  custom psrun/libpshwpc configuration.  Syntax: psinv --papi=xml.
	  Output is sent to stdout and all other options are ignored.
	* psinv has a new option "-e/--events" to print native CPU performance
	  events (where supported). "--events=xml" prints events as an XML
	  document that can be used as a config starting point, as above.
	* Added --validate option to psprocess that requests validation of a
	  single XML document using the xmllint(1) utility.  No other
	  processing is done. Exit status is 0 if the document validates
	  against the external DTD, non-zero otherwise.
	* Added -f/--fast option to psprocess. This requests the use of a
	  simpler and faster version of the tDOM XML parser.
	* Added preliminary support for gprof "gmon.out" format output from
	  psprocess with profiles, selected through new --gmon option (produces
	  flat profiles only, you should supply the option "--flat-profile" to
	  gprof to avoid complaints about missing call graph data, you may also
	  want to add the gprof option "--line" to produce line-level
	  information).
	* Added calibration option to psprocess when used with hwpcreports in
	  counting mode.  These are very rough estimates of threshold values to
	  supply for a later profiling run in order to obtain a sample every
	  millisecond.
	* Added timing option to psprocess (-T/--timing) that reports internal
	  statistics on elapsed time used for psprocess operations.
	* psrun resource sampling interval is now user-adjustable through an
	  optional argument to the "-r/--resource" option.  Default interval is
	  1 second.
	* psrun supports new option -X/--exituser option, which requests that
	  psrun return the exit status of the command monitored, not of psrun
	  itself.  Setting the new environment variable PSRUN_EXITSTATUS to any
	  value has the same effect.
	* psrun supports new option -i/--info that shows the capabilities of a
	  particular installation of psrun.
	* libpshwpc recognizes a new environment variable PS_HWPC_SYSCONFIG to
	  request that the an alternate directory is searched for configuration
	  files.  If the variable has no value, check the standard directory.
	* psrun supports new option -C/--sysconfig to support searching of the
	  standard XML directory for configuration files.  Both variants accept
	  an optional argument to supply a specific directory; if not given,
	  the standard directory is searched.
	* psrun now recognizes the environment variable PSRUN_DORESOURCE to
	  request resource monitoring (similar to -r option).  Optional value
	  supplied specifies the number of seconds between samples.
	* psprocess has a new option "--extract" that will extract the
	  individual reports from an existing multi-report.
	* psprocess now supports writing out a multiple-profile VProf format
	  file from the original <hwpcprofile> documents directly.
	  Example: psprocess -c --vmon *.xml
	* Added to psrun the ability to choose to continue to run user 
	  application in the event of failure to start measurement by setting
	  the environment variable PSRUN_ONERROR to "ignore".
	* psrun resource reporting output documents now conform to the settings
	  of PS_HWPC_NOHOSTNAME and PS_HWPC_NOPID environment variables in the
	  same way as the primary output documents.

	MISCELLANEOUS
	* Tcl C extensions now compiled with Tcl stubs enabled.
	* psenv scripts now set TCLLIBPATH to include PerfSuite Tcl directory.
	* Removed use of tclsh for package index generation.
	* Improved memory management for profiling in libpshwpc.
	* Reduced condition variable checks in ps_hwpc_start() to first time
	  only, thereafter condition is retained in thread-specific data.
	* Slight source tree rearrangement for psprocess.
	* Information about using URLs with psprocess added to its man page.
	* New process management/ID routines in libperfsuite (internal use
	  only).
	* Tcl interface to PAPI is now available regardless of the actual
	  availability of the PAPI library, with a subset of
	  functionality/procedures.  See "User Interface/API Changes" above for
	  related information.
	* configure script now issues a message and fails if $CC isn't gcc, as
	  determined by autoconf.
 	* Added check in configure script for presence of Perfmon, enabled
	  through new --with-perfmon configure option.
	* Numerous code cleanups in libraries and tools.
	* README file removed from psrun subdirectory.
	* libpshwpc PAPI layer POSIX TSD key usage reduced to 1.
	* More information added to psrun man page to clarify operation.
	* Made appearance of usage output from the tools more uniform.
	* Added test cases for psrun resource reporting.
	* psrun-raw example modified to work with new output naming conventions
	  (hostname suppressed).
	* threadrun example modified to verify additional functionality.
	* Added new example program "misalign.c" that attempts to generate
	  misaligned data references.
	* Added new example program "profile_rate.c" to help in setting the
	  sampling rate for total cycles to approximate profil()/gprof.
	* Added new example program "psrun-batch" that executes psrun using
	  multiple configuration files.
	* Minor change to calculation of environment memory required in "hl.c"
	  example.
	* Added stricter checking of OS type in configure script.
	* Changed use of "__restrict__" keyword to "restrict" along with
	  definition generated by autoconf.
	* Several source files renamed in libpshwpc.
	* Determination of maximum available hardware counters moved to
	  a performance layer-specific runtime value returned.
	* Expanded PAPI functionality test case to include tests for
	  PAPI_event_name_to_code(), PAPI_query_event_verbose(),
	  PAPI_query_all_events_verbose(), PAPI_state(), PAPI_sprofil().
	* Changed libperfsuite Automake CFLAGS setting to force object file
	  renaming (maintainer issue)
	* Separate build and source trees are now supported. Use is documented
	  in the INSTALL file.
	* automake 1.9.3, libtool 1.5.10

0.6.1 (2005/01/06)

	* Bug fix (psprocess): two error messages were getting truncated
	  to a single word due to message catalog use.
	* Modified psrun's treatment of preloaded libraries to preserve any
	  settings in effect.
	* Modified the C++ demangling Tcl extension so that if demangling is
	  not available, the mangled name is returned instead of an error.
	* Modified the PAPI functionality test case adjustment from rc1
	  to disable PAPI_get_opt check for domain in releases prior to
	  3.0.8, instead of 3.0.7 (problems in IA-64 and Pentium III
	  PAPI substrates).  Also changed to ignore this error rather than
	  abort the test in case it persists.
	* Bug fix (configure): due to recent changes in location of
	  architecture definition, binutils was not disabled by default on
	  IA-64.

0.6.1 rc1 (2004/12/11)

	* Bug fix (libperfsuite): data structures in <pstypes.h> reworked
	  to adjust for insufficient sizes previously that could have
	  potentially wrapped around.  Two ps_procstat_t structure
	  members removed, five added.
	* Bug fix (libperfsuite): Fortran error reporting routine
	  psf_strerror() could have overwritten available string space
	  if the user called incorrectly.  Adjusted to guard for that case.
	* Bug fix (libpshwpc): adjustment made to adapt to new PAPI 3
	  "partial success" return from PAPI_add_events().
	* Bug fix (libpshwpc): XML parser internal memory allocation was not
	  expanded if the XML file being parsed contained large numbers of
	  events.  Modified to increase storage as needed in fixed increments.
	* Bug fix (psprocess): shared library removal added to generation
	  of VProf profiles from <multihwpcreport> profiles.
	* Bug fix (psprocess): section of code within shared library
	  removal routine would have always failed due to an unset
	  variable.  Changed to an error message reported to the user.
	* Bug fix (psprocess): adjusted frequency of sampling output
	  for profil-based profiling on Itanium systems from 10 ms to 1 ms.
	* Bug fix (psprocess): global variable was not declared as such
	  in routine generating CSV output.
	* Bug fix (libpshwpc test suite): failure to allocate additional
	  memory in memory reporting test case caused unintended error exit.
	* Bug fix (libpshwpc test suite): pthreads test was sensitive
	  to the user's current environment.  Forced to known state.
	* Bug fix (libpshwpc test suite): PAPI-only multiplexing stress 
	  test changed to exit normally if requested thread count exceeds
	  system limit.
	* PAPI functionality test case adjustment: PAPI_get_opt for
	  retrieving the domain was disabled before, has been reenabled
	  with bug fix applied in PAPI 3.0.7.  It remains disabled for
	  PAPI 2 versions and PAPI 3 versions less than 3.0.7.
	* Updated Tcl ::procfs::stat procedure to reflect fields found
	  in more recent kernels (2.4)
	* Improved psprocess error message reported to user when requesting
	  CSV output from a PAPI multihwpcreport and the PAPI shared library
	  is not found.
	* Threaded versions of ps_rtcinit() and ps_procstat() made 
	  cancel-safe.
	* psinv help output modified slightly.
	* Comment characters in <fperfsuite.h> changed from 'C' to '!'
	* Additional new PAPI3 events for Pentium 4 added to default
	  configuration file.
	* Compile-time architecture definitions moved out of Makefiles
	  and into common config.h header.
	* configure script warning message "PAPI 3 support is alpha"
	  removed, as PAPI 3 final is now released.
	* configure script modified to force PTHREAD_LIBS setting to
	  "-lpthread" if the user hasn't specified.
	* Shared library versioning is now explicitly set.
	* Added more information to the INSTALL file to describe additional
	  errors that may be observed when running the test suite.

0.6.1 beta 6 (2004/10/02)

	* A number of Pentium 4 PAPI events were added during the
	  PAPI 3.0.5 beta.  These have been updated as of the date of
	  this release.  Events related to level 3 cache are not
	  active by default, you may want to enable them in the
	  PerfSuite PAPI 3/Pentium 4 default configuration file.
	  Instructions on doing this added to the INSTALL file.
	* New option added to configure script: "--enable-rtc=TIMER",
	  that allows the use of a different interface for real
	  time clock access instead of using the system interval timer.
	  Accepted values for TIMER are "gettimeofday" and "mmtimer".
	  Thanks to Bernd Mohr for an example of mmtimer use.
	* Associated new routine added to libperfsuite: ps_rtcinit(void).
	  This routine should always be called by the main thread before
	  any later calls to ps_rtc().
	* UI change: psrun default XML output document prefix is now the
	  basename of the executable, rather than "psrun".  You can revert
	  to the old naming by using the psrun -o option or through the
	  environment variable PS_HWPC_FILE.
	* libperfsuite is now also built as a reentrant library,
	  called libperfsuite_r.  psrun now links with this version.
	* PMPI-based libpshwpc_mpi now supports Fortran.
	* Added capability to specify a flat-file exclusion database
	  through the environment variable PS_HWPC_EXCLUDEDB.  This
	  database should contain the full path names of executables
	  that should be excluded from measurement, one per line.
	* Modified psrun usage output to indicate that stdout/stderr
	  are recognized for output destination.  Added to man page.
	* psrun resource reporting extended to match output format
	  and destination used for performance data reporting.
	* Added support for plain text output when profiling.
	* Improved error reporting from PAPI in libpshwpc.
	* Improved thread-specific data deallocation in libpshwpc.
	* Improved support for direct preloading of libpsrun.
	* Clarified use of -t option in psprocess' man page.
	* Bug fix (libpshwpc): Modified handling of real-time clock to 
	  not include time when measurement is suspended.  Call to 
	  ps_hwpc_stop() updates wall clock time only if measurement is 
	  active at the time of the call.
	* Bug fix (psprocess): incorrect PAPI event used for calculation
	  of % cycles with no instructions completed metric.
	* Bug fix (psprocess): vmon-format sample data was being masked
	  to 8-bit, not 16-bit, values.
	* Revised implementation of routine used to locate executable
	  in load address map to use actual file rather than the
	  argument provided in the command line.
	* PAPI 3 library version now reported in full by psinv.  Requires
	  version of PAPI_get_opt() that supports PAPI_LIB_VERSION option.
	  Similar modification made to PAPI Tcl extension.
	* XML metric database changed from document element type
	  <ps_hwpc_metrics> to <psmetrics>.
	* Modified Tcl ::procfs::stat command to accept no arguments,
	  defaulting to "self".
	* Improved efficiency/memory management for processor detection
	  routine.
	* Updated cache specification detection per Intel application
	  note 7/2004.
	* Changed PAPI_FP_INS to PAPI_FP_OPS for Itanium 2 configurations
	  that use PAPI 3.
	* Added test cases for PAPI high-level conversion and "auto"
	  use from libpshwpc.  Added basic test for psrun text output.
	  Added test case to check PAPI's ability to handle large numbers
	  of threads, multiplexed and non-multiplexed.
	* Added new F77 CPI example program.
	* Updated Fortran 77 test programs to use more recent
	  language features.
	* Bug fix (uninitialized variable) in serial C cpi example program.
	* Bug fix (eventset not initialized to PAPI_NULL) in basic test case.
	* "extern" keyword added to all public function prototypes.
	* Improved build system ability to cope with non-g77 Fortran
	  compilers.  Tested with Intel 7/8. INSTALL instructions updated.
	* Added check in configure script to adjust for changes made
	  to PAPI_event_info_t structure during PAPI 3 beta.
	* Bus fix (test case) profiling tests were being done using
	  PAPI_TOT_INS, which on IA-64 with PAPI 3 is a derived event,
	  and cannot be profiled.  Changed to PAPI_TOT_CYC.
	* Added PTHREAD_LIBS and MPICPPFLAGS to the list of environment
	  variables displayed by configure --help and cached by autoconf.
	* Simplified testsuite setup further.

0.6.1 beta 5 (2004/06/09)

	* First support for AMD processors added.
	* psinv is now built as a dynamically linked executable.
	* Added support for plain text output from psrun/libpshwpc to
	  allow for one-shot runs without need to post-process with
	  psprocess.  Plain-text output is selected by setting the
	  environment variable PS_HWPC_FORMAT to the value "text" (case
	  insignificant).  psrun will accept the command-line option
	  "-F/--format FORMAT" with recognized values for FORMAT
	  being "text" or "xml".  Default output format is XML.
	  Man page updated.
	* Improved process/fork handling ability in psrun, thanks to
	  a suggestion by Phil Mucci.
	* Changed psrun use of atexit() to on_exit() if available
	  in order to preserve the exit status of the user application.
	* psrun initialization changed to ignore SIGPROF during startup.
	* psrun now accepts the option "-t INTEGER" to supply a profiling
	  threshold.
	* psrun now recognizes the environment variable PSRUN_PTHREADLIB
	  to specify an alternate POSIX threads library (default is
	  "libpthread.so.0").
	* Improved error checking in psrun for child process creation.
	* Removed PAPI_RES_STL from default Pentium 4 configuration
	  XML document.
	* Removed PAPI_BR_TKN from default Itanium configuration
	  XML document.
	* Modifications to handle change of PRESET_MASK to PAPI_PRESET_MASK
	  during PAPI 3 beta.
	* Minimum and maximum statistics in psprocess moved out to a
	  separate section and the hostname associated with each is now
	  displayed.
	* Added ability to supply peak MFLOP rate to psprocess when
	  working with <hwpcreport> documents through the "-P" option.
	* Improved error output from psprocess for the case when a user
	  supplies a profiling XML document but no executable.
	* DTD change: <hwpcreport> TLB elements allow the value "unified"
	  for their "type" attribute.
	* New "misc" examples directory.  Contains a shell script
	  "geneventlist" that uses psinv to generate an XML document
	  with all available hardware performance events - this can
	  be used as a starting point for psrun/libpshwpc configurations.
	* Updated processor feature detection per Intel application
	  note 2/2004.  Several cache descriptors were corrected by
	  Intel since this file was originally written.
	* Internal redefinitions of a few constants in <pstypes.h> and
	  psinv (not visible in use or output)
	* Bug fix (libperfsuite): instruction TLB associativity was
	  being incorrectly assigned for value 01h (Intel x86).
	* Bug fix (psrun/libpshwpc): non-threadsafe routine was being
	  used by libpshwpc (and psrun) that resulted in I/O-related
	  segfaults on process cleanup.
	* Bug fix (libpshwpc): Resource reclamation and resetting to
	  initial state added to ps_hwpc_shutdown() for serial cases.
	* Bug fix (libpshwpc): TLB associativity was not being output 
	  properly to XML documents.
	* Bug fix (libpshwpc): PS_hl_PAPI_write (C & Fortran) was
	  returning error code mistakenly.
	* Bug fix (libpshwpc_r): threaded version of the library was
	  segfaulting when using getpwuid() or getpwuid_r().  Replaced
	  with value of $LOGNAME.
	* Bug fix (libperfsuite): address map offsets were being taken
	  from the wrong field.  This had no effect on the tools but 
	  has been corrected.
	* Condition variable added to threaded version of libpshwpc
	  to help guard against improper sequence of execution by
	  different threads.
	* Modified implementation of access to timestamp counter on IA32.
	* Test case bug fix for load map access to others' processes.
	* Minor mods to installation instructions relating to tDOM on
	  AMD64.
	* Minor mods to installation instructions relating to PAPI 3.
	* Simplified testsuite environment setup for libperfsuite,
	  libpshwpc, psinv, and psrun.
	* Test case bug fix for load map access to others' processes.
	* Test case bug fix: invalid Fortran FORMAT statement.
	* Added detection of ability to use inline assembly with x86
	  ebx and with position-independent code.
	* Improved handling of bindir and libdir configure-time values.
	* Improved handling of PAPI configure-time options.
	* More comprehensive testing of Tcl support (split out detection
	  of tclsh/wish executables and Tcl C library access).

0.6.1 beta 4 (2004/03/14)

	* Internal modification made to XML document output routines
	  within libpshwpc to support use by external software
	* Additional error handling code added to psrun to block
	  errors that have been observed at the very end of the run.
	  See the BUGS file for more information.

0.6.1 beta 3 (2004/01/17)

	* Modifications made to support Pentium 4 with PAPI 3 (these 
	  should also help with any system where multiplexing must be 
	  used due to resource conflicts)
	* PAPI 3/P4 default configuration file modified and tested now
	* New psrun/libpshwpc configuration files for non-multiplexed 
	  floating point operation and total cycle counting
	* New configuration file for measuring non-NOP instructions 
	  retired on Itanium 2 (with PAPI 3)
	* New PAPI_FP_OPS-based metrics added to standard metric definitions
	* New examples directories included that contain several small 
	  examples of use, installed in PREFIX/share/perfsuite/examples
	* Bug fix for psprocess applied to <multi>-reports that have 
	  annotations embedded
	* Cache output for psprocess modified to display correct units
	* Modified PAPI compatibility layer to more closely match PAPI 2 
	  return code for event query
	* Environment variable PSPROCESS_FLUSH recognized to allow 
	  toggling of channel flush within psprocess.  This is a temporary 
	  fix to address inconsistent segfaults that have been observed and 
	  is not a permanent solution.  If you are not getting psprocess 
	  segfaults, no need to concern yourself with this.
	* Autotools setup modified to only include -ldl where needed (psrun)
	* Convenience scripts "psenv.sh" and "psenv.csh" added that can 
	  be used to set PerfSuite environment variables, installed in the 
	  bin subdirectory
	* All message catalogs separated out to their proper subdirectories
	* Additional psprocess string, pshwpc metric, and PAPI event 
	  translations (Italian/Spanish) added, autogenerated with AltaVista 
	  Babelfish
	* new man pages added for psenv, psinv, psprocess, psrun, and 
	  psconfig installed in PREFIX/man/man1 by default
	* New DTDs for libpshwpc-related XML documents that are installed 
	  in the package share subdirectory.  These are under development.
	* libpshwpc/psrun XML output documents now contain document type 
	  declarations pointing to the installed DTDs
	* libpshwpc/psrun XML output documents are now generated with a 
	  standalone attribute in the XML prologue
	* "HWPCNULL" class attribute for profil() experiments changed to "null"
	* "PAPI" class attribute changed to "null" for experiments where 
	  no hardware events are specified (resource usage collection only)
	* BUGS file now included in distribution to list symptoms and 
	  current status of known bugs in PerfSuite
	* Test suite feedback/progress output improved
	* autoconf 2.59, automake 1.8, libtool 1.5
	* bzip2 distribution added
	* perfsuite-bugs@lists.sourceforge.net new address for bug reports

0.6.1 beta 2 (2003/12/15)

	* Profiling with profil() (i.e., without performance counters) was 
	  adjusted to ensure that the main program's text space was used
	* Message catalog behavior corrected for Tcl 8.3
	* Cache line sizes were not being assigned to the correct cache 
	  level with new metric generation routines
	* Corrected derived metric XML database for L2/L3 bandwidth
	
$Id: CHANGES,v 1.598 2013/12/20 22:42:04 ruiliu Exp $
