Merge pull request #140 from gcongiu/2023.12.14_updates-for-release-7…

….1.0

Update version and documentation for release 7.1.0

RELEASENOTES.txt

@@ -5,6 +5,27 @@ For details on installing PAPI on your machine, consult the INSTALL.txt file
 in this directory.
 
 
+===============================================================================
+PAPI 7.1.0 RELEASE NOTES                                            18 Dec 2023
+===============================================================================
+
+PAPI 7.1.0 is now available. This release includes support for Intel Sapphire
+Rapids and AMD Zen4 preset events. The release also includes general
+improvements to the PAPI code in terms of design and functionality. Furthermore,
+the Counter Analysis Toolkit (CAT) and the Software-Defined Events (SDE) library
+have also been updated.
+
+Major Changes:
+
+* Support for Intel Sapphire Rapids native and preset events
+* Support for AMD Zen4 native and preset events
+* Support for event qualifiers in the ROCm component
+* New 'template' compomenent
+* Integration into Spack package manager
+* Integration into the Extreme-Scale Scientific Software Stack (E4S)
+* Refactored cuda component with multi-thread and multi-gpu support
+* Support for ARM Neoverse V1 and V2
+
 ===============================================================================
 PAPI 7.0.1 RELEASE NOTES                                            22 Feb 2023
 ===============================================================================

doc/Doxyfile-common

@@ -31,7 +31,7 @@ PROJECT_NAME           = PAPI
 # This could be handy for archiving the generated documentation or
 # if some version control system is used.
 
-PROJECT_NUMBER         = 7.0.1.0
+PROJECT_NUMBER         = 7.1.0.0
 
 # Using the PROJECT_BRIEF tag one can provide an optional one line description
 # for a project that appears at the top of each page and should give viewer

man/man1/PAPI_derived_event_files.1

@@ -1,4 +1,4 @@
-.TH "PAPI_derived_event_files" 1 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "PAPI_derived_event_files" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man1/papi_avail.1

@@ -1,4 +1,4 @@
-.TH "papi_avail" 1 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "papi_avail" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
@@ -65,7 +65,7 @@ There are no known bugs in this utility\&. If you find a bug, it should be repor
 .br
 
 .PP
-\fBSee Also:\fP
+\fBSee also\fP
 .RS 4
 PAPI_derived_event_files 
 .RE

man/man1/papi_clockres.1

@@ -1,4 +1,4 @@
-.TH "papi_clockres" 1 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "papi_clockres" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man1/papi_command_line.1

@@ -1,4 +1,4 @@
-.TH "papi_command_line" 1 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "papi_command_line" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man1/papi_component_avail.1

@@ -1,4 +1,4 @@
-.TH "papi_component_avail" 1 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "papi_component_avail" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man1/papi_cost.1

@@ -1,4 +1,4 @@
-.TH "papi_cost" 1 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "papi_cost" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man1/papi_decode.1

@@ -1,4 +1,4 @@
-.TH "papi_decode" 1 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "papi_decode" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man1/papi_error_codes.1

@@ -1,4 +1,4 @@
-.TH "papi_error_codes" 1 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "papi_error_codes" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man1/papi_event_chooser.1

@@ -1,4 +1,4 @@
-.TH "papi_event_chooser" 1 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "papi_event_chooser" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man1/papi_hardware_avail.1

@@ -1,4 +1,4 @@
-.TH "papi_hardware_avail" 1 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "papi_hardware_avail" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man1/papi_hybrid_native_avail.1

@@ -1,4 +1,4 @@
-.TH "papi_hybrid_native_avail" 1 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "papi_hybrid_native_avail" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man1/papi_mem_info.1

@@ -1,4 +1,4 @@
-.TH "papi_mem_info" 1 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "papi_mem_info" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man1/papi_multiplex_cost.1

@@ -1,4 +1,4 @@
-.TH "papi_multiplex_cost" 1 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "papi_multiplex_cost" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man1/papi_native_avail.1

@@ -1,4 +1,4 @@
-.TH "papi_native_avail" 1 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "papi_native_avail" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man1/papi_version.1

@@ -1,4 +1,4 @@
-.TH "papi_version" 1 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "papi_version" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man1/papi_xml_event_info.1

@@ -1,4 +1,4 @@
-.TH "papi_xml_event_info" 1 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "papi_xml_event_info" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man3/PAPIF_accum.3

@@ -1,10 +1,8 @@
-.TH "PAPIF_accum" 3 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_accum" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
-PAPIF_accum \- 
-.PP
-accumulate and reset counters in an event set  
+PAPIF_accum \- accumulate and reset counters in an event set  
 
 .SH SYNOPSIS
 .br
@@ -17,10 +15,10 @@ accumulate and reset counters in an event set
 .RS 4
 #include 'fpapi\&.h' 
 .br
-\fBPAPIF_accum\fP( C_INT EventSet, C_LONG_LONG(*) values, C_INT check )
+\fBPAPIF_accum( C_INT EventSet, C_LONG_LONG(*) values, C_INT  check )\fP
 .RE
 .PP
-\fBSee Also:\fP
+\fBSee also\fP
 .RS 4
 \fBPAPI_accum\fP 
 .RE

man/man3/PAPIF_add_event.3

@@ -1,10 +1,8 @@
-.TH "PAPIF_add_event" 3 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_add_event" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
-PAPIF_add_event \- 
-.PP
-add PAPI preset or native hardware event to an event set  
+PAPIF_add_event \- add PAPI preset or native hardware event to an event set  
 
 .SH SYNOPSIS
 .br
@@ -20,7 +18,7 @@ add PAPI preset or native hardware event to an event set
 \fBPAPIF_add_event( C_INT EventSet, C_INT EventCode, C_INT check )\fP
 .RE
 .PP
-\fBSee Also:\fP
+\fBSee also\fP
 .RS 4
 \fBPAPI_add_event\fP 
 .RE

man/man3/PAPIF_add_events.3

@@ -1,10 +1,8 @@
-.TH "PAPIF_add_events" 3 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_add_events" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
-PAPIF_add_events \- 
-.PP
-add multiple PAPI presets or native hardware events to an event set  
+PAPIF_add_events \- add multiple PAPI presets or native hardware events to an event set  
 
 .SH SYNOPSIS
 .br
@@ -17,10 +15,10 @@ add multiple PAPI presets or native hardware events to an event set
 .RS 4
 #include 'fpapi\&.h' 
 .br
-\fBPAPIF_add_events\fP( C_INT EventSet, C_INT(*) EventCodes, C_INT number, C_INT check )
+\fBPAPIF_add_events( C_INT EventSet, C_INT(*) EventCodes, C_INT number, C_INT  check )\fP
 .RE
 .PP
-\fBSee Also:\fP
+\fBSee also\fP
 .RS 4
 \fBPAPI_add_events\fP 
 .RE

man/man3/PAPIF_add_named_event.3

@@ -1,10 +1,8 @@
-.TH "PAPIF_add_named_event" 3 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_add_named_event" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
-PAPIF_add_named_event \- 
-.PP
-add PAPI preset or native hardware event to an event set by name  
+PAPIF_add_named_event \- add PAPI preset or native hardware event to an event set by name  
 
 .SH SYNOPSIS
 .br
@@ -20,7 +18,7 @@ add PAPI preset or native hardware event to an event set by name
 \fBPAPIF_add_named_event( C_INT EventSet, C_STRING EventName, C_INT check )\fP
 .RE
 .PP
-\fBSee Also:\fP
+\fBSee also\fP
 .RS 4
 \fBPAPI_add_named_event\fP 
 .RE

man/man3/PAPIF_assign_eventset_component.3

@@ -1,10 +1,8 @@
-.TH "PAPIF_assign_eventset_component" 3 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_assign_eventset_component" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
-PAPIF_assign_eventset_component \- 
-.PP
-assign a component index to an existing but empty EventSet  
+PAPIF_assign_eventset_component \- assign a component index to an existing but empty EventSet  
 
 .SH SYNOPSIS
 .br
@@ -20,7 +18,7 @@ assign a component index to an existing but empty EventSet
 \fBPAPIF_assign_eventset_component( C_INT EventSet, C_INT EventSet, C_INT check )\fP
 .RE
 .PP
-\fBSee Also:\fP
+\fBSee also\fP
 .RS 4
 \fBPAPI_assign_eventset_component\fP 
 .RE

man/man3/PAPIF_cleanup_eventset.3

@@ -1,10 +1,8 @@
-.TH "PAPIF_cleanup_eventset" 3 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_cleanup_eventset" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
-PAPIF_cleanup_eventset \- 
-.PP
-empty and destroy an EventSet  
+PAPIF_cleanup_eventset \- empty and destroy an EventSet  
 
 .SH SYNOPSIS
 .br
@@ -20,7 +18,7 @@ empty and destroy an EventSet
 \fBPAPIF_cleanup_eventset( C_INT EventSet, C_INT check )\fP
 .RE
 .PP
-\fBSee Also:\fP
+\fBSee also\fP
 .RS 4
 \fBPAPI_cleanup_eventset\fP 
 .RE

man/man3/PAPIF_create_eventset.3

@@ -1,10 +1,8 @@
-.TH "PAPIF_create_eventset" 3 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_create_eventset" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
-PAPIF_create_eventset \- 
-.PP
-create a new empty PAPI EventSet  
+PAPIF_create_eventset \- create a new empty PAPI EventSet  
 
 .SH SYNOPSIS
 .br
@@ -20,7 +18,7 @@ create a new empty PAPI EventSet
 \fBPAPIF_create_eventset( C_INT EventSet, C_INT check )\fP
 .RE
 .PP
-\fBSee Also:\fP
+\fBSee also\fP
 .RS 4
 \fBPAPI_create_eventset\fP 
 .RE

man/man3/PAPIF_destroy_eventset.3

@@ -1,10 +1,8 @@
-.TH "PAPIF_destroy_eventset" 3 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_destroy_eventset" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
-PAPIF_destroy_eventset \- 
-.PP
-empty and destroy an EventSet  
+PAPIF_destroy_eventset \- empty and destroy an EventSet  
 
 .SH SYNOPSIS
 .br
@@ -20,7 +18,7 @@ empty and destroy an EventSet
 \fBPAPIF_destroy_eventset( C_INT EventSet, C_INT check )\fP
 .RE
 .PP
-\fBSee Also:\fP
+\fBSee also\fP
 .RS 4
 \fBPAPI_destroy_eventset\fP 
 .RE

man/man3/PAPIF_enum_dev_type.3

@@ -1,10 +1,8 @@
-.TH "PAPIF_enum_dev_type" 3 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_enum_dev_type" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
-PAPIF_enum_dev_type \- 
-.PP
-returns handle of next device type  
+PAPIF_enum_dev_type \- returns handle of next device type  
 
 .SH SYNOPSIS
 .br
@@ -20,7 +18,7 @@ returns handle of next device type
 \fBPAPIF_enum_dev_type( C_INT modifier, C_INT handle_index, C_INT check )\fP
 .RE
 .PP
-\fBSee Also:\fP
+\fBSee also\fP
 .RS 4
 \fBPAPI_enum_dev_type\fP 
 .RE

man/man3/PAPIF_enum_event.3

@@ -1,10 +1,8 @@
-.TH "PAPIF_enum_event" 3 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_enum_event" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
-PAPIF_enum_event \- 
-.PP
-Return the number of events in an event set\&.  
+PAPIF_enum_event \- Return the number of events in an event set\&.  
 
 .SH SYNOPSIS
 .br
@@ -20,7 +18,7 @@ Return the number of events in an event set\&.
  \fBPAPIF_enum_event( C_INT  EventCode,  C_INT  modifier,  C_INT  check )\fP
 .RE
 .PP
-\fBSee Also:\fP
+\fBSee also\fP
 .RS 4
 \fBPAPI_enum_event\fP 
 .RE

man/man3/PAPIF_epc.3

@@ -1,10 +1,8 @@
-.TH "PAPIF_epc" 3 "Fri Mar 10 2023" "Version 7.0.1.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_epc" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
-PAPIF_epc \- 
-.PP
-Get named events per cycle, real and processor time, reference and core cycles\&.  
+PAPIF_epc \- Get named events per cycle, real and processor time, reference and core cycles\&.  
 
 .SH SYNOPSIS
 .br
@@ -20,7 +18,7 @@ Get named events per cycle, real and processor time, reference and core cycles\&
  \fBPAPIF_epc( C_STRING EventName, C_FLOAT real_time, C_FLOAT proc_time, C_LONG_LONG ref, C_LONG_LONG core, C_LONG_LONG evt, C_FLOAT epc, C_INT check )\fP
 .RE
 .PP
-\fBSee Also:\fP
+\fBSee also\fP
 .RS 4
 \fBPAPI_epc\fP 
 .RE