new version info for v3.0.0

configure.ac

 AC_PREREQ([2.69])
-AC_INIT([yac], [2.6.2], [hanke@dkrz.de], [],
+AC_INIT([yac], [3.0.0], [hanke@dkrz.de], [],
   [https://dkrz-sw.gitlab-pages.dkrz.de/yac/])
 AC_CONFIG_MACRO_DIR([m4])
 AC_CONFIG_AUX_DIR([config])

doc/Doxyfile

@@ -38,7 +38,7 @@ PROJECT_NAME           = YetAnotherCoupler
 # could be handy for archiving the generated documentation or if some version
 # control system is used.
 
-PROJECT_NUMBER         = 2.6.2
+PROJECT_NUMBER         = 3.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 a

doc/src/interface.dox

@@ -234,6 +234,7 @@
         <li> \ref yac.Field.create
   <tr>
     <td style="vertical-align:top;width:33%">
+      \anchor routine_ref_def_meta
       <ul style="margin:0px">
         <li> \ref yac_cdef_component_metadata
         <li> \ref yac_cdef_component_metadata_instance
@@ -267,7 +268,7 @@
         <li> \ref yac.YAC.def_field_metadata
 </table>
 
-\subsection routine_ref_sync Synchronisation of definitions and definition of couples
+\subsection routine_ref_sync Synchronisation of definitions
 
 <table style="border: none;border-collapse: collapse;width:1500px">
   <tr>
@@ -281,6 +282,11 @@
     <td style="vertical-align:top;width:33%">
       <ul style="margin:0px">
         <li> \ref yac.YAC.sync_def
+</table>
+
+\subsection routine_ref_def_couple Definition of couples
+
+<table style="border: none;border-collapse: collapse;width:1500px">
   <tr>
     <td style="vertical-align:top;width:33%">
       <ul style="margin:0px">
@@ -355,6 +361,7 @@
         <li> \ref yac_fexchange "yac_fexchange (*)"
   <tr>
     <td style="vertical-align:top;width:33%">
+      \anchor routine_ref_exchange_get_action
       <ul style="margin:0px">
         <li> \ref yac_cget_action
         <li> \ref yac_cupdate
@@ -525,6 +532,7 @@
   <tr>
     <td style="vertical-align:top;width:33%">
     <td style="vertical-align:top;width:33%">
+      \anchor routine_ref_query_meta
       <ul style="margin:0px">
         <li> \ref yac_fcomponent_has_metadata "yac_fcomponent_has_metadata (*)"
         <li> \ref yac_fgrid_has_metadata "yac_fgrid_has_metadata (*)"

doc/src/version_info.dox

 /**
  * \page version_info Condensed release information
 
+\section version_300 Version 3.0.0 (Mar 2023)
+
+- various fixes
+- various improvements in configure environment
+- source to target point mapping now applies spread distance to distance
+  between target points and to bounding circles of target cells
+- updates libmtime to version 1.1.1
+- new configuration file format
+  - use of YAML or JSON instead of XML
+  - reduction of information in \ref yaml_file "configuration file"
+- reduction in and changes to
+  \ref init_yac_detail_overview "initialisation routines"
+  - does not take configuration as input anymore
+  - replaces group communicator concept with
+    \ref mpi_handshake_detail "MPI handshake algorithm"
+- various changes and renaming of interfaces
+  - `yac_cget_localcomm` -> \ref yac_cget_comp_comm
+  - `yac_cget_pair_rootcomm` -> \ref yac_cget_comps_comm
+  - `yac_csearch` -> \ref yac_cenddef
+  - `yac_r4_ptr` -> \ref yac_real_ptr
+  - `yac_r8_ptr` -> \ref yac_dble_ptr
+- new interfaces for
+  - \ref routine_ref_config_file "reading configuration files"
+    - contents of configuration file is added directly to local configuration
+    - possibility to read multiple configuration files
+  - \ref routine_ref_def_calendar "definition of calendar" (can be set in
+    configuration file and/or through interface)
+  - \ref routine_ref_sync "synchronisation of coupling configuration"
+    between processes
+  - \ref routine_ref_query "querying coupling configuration" of remote
+    components
+  - \ref routine_ref_def_couple "definition of couples" in definition phase
+  - \ref routine_ref_def_meta "definition of metadata" for components, grids,
+    and fields than can be \ref routine_ref_query_meta "queried" by all
+    processes after \ref routine_ref_sync "synchronisation of definitions"
+  - \ref routine_ref_enddef "emitting coupling configuration" in the
+    \ref phase_enddef "end of definition phase"
+- new constants in interface
+  - calendar types
+  - time unit types
+- improvement of python support
+  - new \ref yac.Grid.set_core_mask
+  - new \ref yac.Points.set_mask
+  - improves cleanup of yac instances
+  - various minor improvements and bug fixes
+- relieves rules for
+  - definition of components, grids, and fields; do not have
+    to be defined in coupling configuration anymore
+  - field names of couples; source and target field names do not
+    have to be identical anymore
+- removes GUI
+
 \section version_262 Version 2.6.2 (Dec 2022)
 
 - various bug fixes