Misc. updates in preparation for publishing.

Makefile.am

 
 ACLOCAL_AMFLAGS = -I m4 # use custom macro's in ./m4 
 
+
 # if we are building and linking to a nested copy of libcm
 if BUILD_LIBCM
-  SUBDIRS      = src/libcm  # causes recursive make into given sub-directories
+#  SUBDIRS      = src/libcm  # causes recursive make into given sub-directories
   AM_CPPFLAGS += -I$(srcdir)/src/libcm/src  -I$(srcdir)/src/libcm/src/dsp  -I$(srcdir)/src/libcm/src/vop  -I$(srcdir)/src/libcm/src/app
   AM_LDFLAGS  += -Lsrc/libcm/src
 endif

README.md

 
 ```
 
+Score Merge
+===========
+
+Copy the manual edits from 'frag.txt' to the correct location, beginning with measure 284, in the blank edit file 'edit0.txt'.
+
+```
+cmootls  --merge_edit -d edit0.txt  -b 284 -k frag.txt -o temp.txt
+```
+
+All the events in 'frag.txt' may not be able to be located in 'edit0.txt'. Warning messages will be generated for
+each of these events.
+
+```
+XScore warning: Sync error: meas:301 18 index:7 8 A#4 (midi:70) edit:!mp+ (RC:14)
+XScore warning: Sync error: meas:322 39 index:32 33 C2 (midi:36) edit:!!PPP (RC:14)
+XScore warning: Sync error: meas:335 52 index:15 16 D4 (midi:62) edit:!ppp (RC:14)
+XScore warning: Sync error: meas:343 60 index:18 19 E5 (midi:76) edit:%%a !mf (RC:14)
+XScore warning: Sync error: meas:343 60 index:18 20 D4 (midi:62) edit:!fff (RC:14)
+XScore warning: Sync error: meas:343 60 index:18 21 F#4 (midi:66) edit:!fff (RC:14)
+XScore warning: Sync error: meas:343 60 index:18 22 G1 (midi:31) edit:!mp (RC:14)
+XScore warning: Sync error: meas:343 60 index:18 23 B1 (midi:35) edit:!ff (RC:14)
+XScore warning: Sync error: meas:350 67 index:51 54 F4 (midi:65) edit:!mf+ (RC:14)
+XScore warning: Sync error: meas:350 67 index:50 55 A#5 (midi:82) edit:!mf+ (RC:14)
+```
+
+
 MIDI File Reports
 =================
 
 Score Follow Report
 ===================
 
-```
-cmtool  --score_follow -c round2.csv -i new_round2.mid -r report.txt -s report_svg.html
- ```
+    cmtool  --score_follow -c round2.csv -i new_round2.mid -r report.txt -s report_svg.html
+ 
  
 SVG Description
 ---------------

build/linux/debug/build.sh

 # 2) Run the program. ./foo
 # 3) Run gprof /libtool --mode=execute gprof ./foo
 
+# --enable-build_libcm - build libcm from local tree
+
 ../../../configure --prefix=${curdir} \
-		   --enable-debug --enable-build_libcm \
+		   --enable-debug \
 		   CFLAGS="-g -Wall" \
 		   CXXFLAGS="-g -Wall" \
-		   LIBS=
-
-#		   CPPFLAGS="-I/home/kevin/src/libcm/build/linux/debug/include " \
-#		   LDFLAGS="-L/home/kevin/src/libcm/build/linux/debug/lib" \
-
+		   CPPFLAGS="-I/home/kevin/src/libcm/build/linux/debug/include " \
+		   LDFLAGS="-L/home/kevin/src/libcm/build/linux/debug/lib" 
+                   LIBS=
 #make
 #make install

configure.ac

 AC_FUNC_STRTOD
 AC_CHECK_FUNCS([clock_gettime floor memmove memset mkdir pow rint select socket sqrt strcasecmp strchr strcspn strerror strspn strstr strtol])
 
+# check for he prerequisite libraries
+AC_CHECK_LIB([fftw3],[fftw_malloc],[AC_MSG_RESULT([The 'FFTW' library was found.])],[AC_MSG_ERROR([The 'FFTW' library was not found.])])
+AC_CHECK_LIB([asound],[snd_asoundlib_version],[AC_MSG_RESULT([The 'ALSA' library was found.])],[AC_MSG_ERROR([The 'ALSA' library was not found.])])
 
 # The following is a custom macro in ./m4/os_type.m4
 # be sure to also set "ACLOCAL_AMFLAGS = -I m4" in ./Makefile.am
        *) AC_MSG_ERROR([bad value ${enableval} for --enable-build_libcm]) ;;
      esac],[build_libcm=false])
      
-echo "build_libcm=${build_libcm}"
 
 # check if a nested copy of libcm exists in /src/libcm
 AC_CHECK_FILE([${srcdir}/src/libcm/src/cmGlobal.h],[local_libcm=true],[local_libcm=false])
 echo "local_libcm=${local_libcm}"
+echo "build_libcm=${build_libcm}"
 
 # set BUILD_LIBCM if a libcm build request was set and a nested copy of libcm exists
 AM_CONDITIONAL([BUILD_LIBCM], [test x$build_libcm = xtrue -a x$local_libcm = xtrue ])
 
+# enable debug
 AC_ARG_ENABLE([debug],
      [  --enable-debug    Turn on debugging],
      [case "${enableval}" in
 AC_DEFINE([NDEBUG], 1,[Debugging off.])
 fi
 
+# enable the use of Atlas library
 AC_ARG_ENABLE([vectop],
      [  --enable-vectop    Turn on use of Lapack and Atlas vector/matrix operations. ],
      [case "${enableval}" in
 fi
 
 
+# enable memory alignment
 AC_ARG_ENABLE([memalign],
      [  --enable-memalign    Turn on memory alignment on dynamic memory allocations. ],
      [case "${enableval}" in
 AC_DEFINE([CM_MEMALIGN], 1,[Turn on dynamic memory alignment.])
 fi
 
+# enable sonic arts code inclusion
 AC_ARG_ENABLE([sonicart],
      [  --enable-sonicart    Enable use of Sonic Arts proprietary code. ],
      [case "${enableval}" in
 
 # if local nested libcm then do recursive configure into subdirs
 if test x$build_libcm = xtrue -a x$local_libcm = xtrue; then
-AC_CONFIG_SUBDIRS([src/libcm])
+   AC_CONFIG_SUBDIRS([src/libcm])
 fi
 
 AC_OUTPUT

doc/xscore_gen.md

 - MIDI file suitable for audio rendering
 - SVG piano roll file
 
+```
+cmtools --score_gen -x GUTIM_20200803_utf8.xml -d edit0.txt -c score.csv -m score.mid -s score_svg.html -r report.txt
+```
+
 As with step 2 this step may need to be iterated several times
 to clear syntactic errors in the decoration data.
 

src/cmtools/cmtools.c

  kNoActionIdSelectedCtRC,
  kMissingRequiredFileNameCtRC,
  kScoreGenFailedCtRC,
+ kScoreEditMergeFailedCtRC,
  kScoreFollowFailedCtRC,
  kMidiFileRptFailedCtRC,
  kTimeLineRptFailedCtRC,
   "\n"
   "USAGE:\n"
   "\n"
-  "Parse an XML score file and decoration file to produce a score file in CSV format.\n"
+  "Parse an XML score file and 'edit' file to produce a score file in CSV format.\n"
   "\n"
-  "cmtool --score_gen -x <xml_file> -d <dec_fn> {-c <csvScoreOutFn} {-m <midiOutFn>} {-s <svgOutFn>} {-r report} {-b begMeasNumb} {t begTempoBPM}\n"
+  "cmtool --score_gen -x <xml_file> -d <edit_fn> {-c <csvScoreOutFn} {-m <midiOutFn>} {-s <svgOutFn>} {-r report} {-b begMeasNumb} {t begTempoBPM}\n"
   "\n"
   "Notes:\n"
-  "1.  If <dec_fn> does not exist then a decoration template file will be generated based on the MusicXML file. \n"
-  "2.  Along with the CSV score file MIDI and HTML/SVG files will also be produced based on the contents of the MusicXML and decoration file.\n"
-  "3. See README.md for a detailed description of the how to edit the decoration file.\n"
+  "1.  If <edit_fn> does not exist then a edit template file will be generated based on the MusicXML file. \n"
+  "2.  Along with the CSV score file MIDI and HTML/SVG files will also be produced based on the contents of the MusicXML and edit file.\n"
+  "3. See README.md for a detailed description of the how to edit the edit file.\n"
   "\n"
   "\n"
   "Use the score follower to generate a timeline configuration file.\n"
   return kOkCtRC;
 }
 
-cmRC_t score_gen( cmCtx_t* ctx, const cmChar_t* xmlFn, const cmChar_t* decFn, const cmChar_t* csvOutFn, const cmChar_t* midiOutFn, const cmChar_t* svgOutFn, unsigned reportFl, int begMeasNumb, int begTempoBPM, bool svgStandAloneFl, bool svgPanZoomFl, bool damperRptFl )
+cmRC_t score_gen( cmCtx_t* ctx, const cmChar_t* xmlFn, const cmChar_t* editFn, const cmChar_t* csvOutFn, const cmChar_t* midiOutFn, const cmChar_t* svgOutFn, unsigned reportFl, int begMeasNumb, int begTempoBPM, bool svgStandAloneFl, bool svgPanZoomFl, bool damperRptFl )
 {
   cmRC_t rc;
   if((rc = verify_file_exists(ctx,xmlFn,"XML file")) != kOkCtRC )
     return rc;
   
-  if( cmXScoreTest( ctx, xmlFn, decFn, csvOutFn, midiOutFn, svgOutFn, reportFl, begMeasNumb, begTempoBPM, svgStandAloneFl, svgPanZoomFl, damperRptFl ) != kOkXsRC )
+  if( cmXScoreTest( ctx, xmlFn, editFn, csvOutFn, midiOutFn, svgOutFn, reportFl, begMeasNumb, begTempoBPM, svgStandAloneFl, svgPanZoomFl, damperRptFl ) != kOkXsRC )
     return cmErrMsg(&ctx->err,kScoreGenFailedCtRC,"score_gen failed.");
     
   return kOkCtRC;
 }
 
+cmRC_t score_edit_merge( cmCtx_t* ctx, const cmChar_t* xmlFn, const cmChar_t* editFn, unsigned begMeasNumb, const cmChar_t* keyEditFn, unsigned keyMeasNumb, const cmChar_t* outFn )
+{
+  cmRC_t rc;
+  
+  if((rc = verify_file_exists(ctx,xmlFn,"XML file")) != kOkCtRC )
+    return rc;
+  
+  if((rc = verify_file_exists(ctx,editFn,"reference edit file")) != kOkCtRC )
+    return rc;
+
+  if((rc = verify_file_exists(ctx,editFn,"key edit file")) != kOkCtRC )
+    return rc;
+
+  if( cmXScoreMergeEditFiles( ctx, xmlFn, editFn, begMeasNumb, keyEditFn, keyMeasNumb, outFn ) != kOkXsRC )
+    return cmErrMsg(&ctx->err,kScoreEditMergeFailedCtRC,"Score merge failed failed.");
+    
+  return kOkCtRC;      
+}
+
+
+
 cmRC_t score_follow( cmCtx_t* ctx, const cmChar_t* csvScoreFn, const cmChar_t* midiInFn, const cmChar_t* matchRptOutFn, const cmChar_t* matchSvgOutFn,  const cmChar_t* midiOutFn, const cmChar_t* timelineFn )
 {
   cmRC_t rc;
    kInvalidPoId = kBasePoId,
    kActionPoId,
    kXmlFileNamePoId,
-   kDecorateFileNamePoId,
+   kEditFileNamePoId,
+   kKeyEditFileNamePoId,
+   kKeyMeasNumbPoId,
+   kOutEditFileNamePoId,
    kCsvOutFileNamePoId,
    kPgmRsrcFileNamePoId,
    kMidiOutFileNamePoId,
   enum {
         kNoSelId,
         kScoreGenSelId,
+        kScoreEditMergeSelId,
         kScoreFollowSelId,
         kMeasGenSelId,
         kScoreReportSelId,
   const cmChar_t* appTitle        = "cmtools";
   cmCtx_t         ctx;
   const cmChar_t* xmlFn           = NULL;
-  const cmChar_t* decFn           = NULL;
+  const cmChar_t* editFn          = NULL;
+  const cmChar_t* keyEditFn       = NULL;
+  const cmChar_t* outEditFn       = NULL;
   const cmChar_t* pgmRsrcFn       = NULL;
   const cmChar_t* csvScoreFn      = NULL;
   const cmChar_t* midiOutFn       = NULL;
   unsigned        svgStandAloneFl = 1;
   unsigned        svgPanZoomFl    = 1;
   int             begMeasNumb     = 0;
+  int             keyMeasNumb     = 0;
   int             begTempoBPM     = 60;
   unsigned        damperRptFl     = 0;
   unsigned        begMidiUId      = cmInvalidId;
 
   cmPgmOptInstallEnum( poH, kActionPoId, 'S', "score_gen",    0, kScoreGenSelId,    kNoSelId,  &actionSelId, 1,
     "Run the score generation tool.","Action selector");
+  
+  cmPgmOptInstallEnum( poH, kActionPoId, 'D', "merge_edit",    0, kScoreEditMergeSelId,    kNoSelId,  &actionSelId, 1,
+    "Synchronize and copy the edit information from one edit file into another.","Action selector");
 
   cmPgmOptInstallEnum( poH, kActionPoId, 'F', "score_follow", 0, kScoreFollowSelId, kNoSelId,  &actionSelId, 1,
     "Run the time line marker generation tool.",NULL);
     "Generate an audio file report.",NULL);
 
   
-  cmPgmOptInstallStr( poH, kXmlFileNamePoId,      'x', "muisic_xml_fn",0,    NULL,         &xmlFn,        1, 
+  cmPgmOptInstallStr( poH, kXmlFileNamePoId,      'x', "music_xml_fn",0,    NULL,         &xmlFn,        1, 
     "Name of the input MusicXML file.");
 
-  cmPgmOptInstallStr( poH, kDecorateFileNamePoId, 'd', "dec_fn",       0,    NULL,         &decFn,        1, 
-    "Name of a score decoration file.");
+  cmPgmOptInstallStr( poH, kEditFileNamePoId,      'd', "edit_fn",    0,    NULL,         &editFn,        1, 
+    "Name of a score edit file.");
+
+  cmPgmOptInstallStr( poH, kKeyEditFileNamePoId,   'k', "key_edit_fn", 0,    NULL,      &keyEditFn,     1, 
+    "Name of a score edit key file.");
 
+  cmPgmOptInstallInt( poH, kKeyMeasNumbPoId,       'q', "key_meas",     0,       1,         &keyMeasNumb,   1,
+    "Number of the first measure number to merge in the edit key filke (see --key_edit_fn)." );
+  
+
+  cmPgmOptInstallStr( poH, kOutEditFileNamePoId,   'o', "out_edit_fn", 0,    NULL,      &outEditFn,     1, 
+    "Name of a score edit merge file.");
+  
   cmPgmOptInstallStr( poH, kCsvOutFileNamePoId,   'c', "score_csv_fn",0,    NULL,         &csvScoreFn,    1, 
     "Name of a CSV score file.");
 
     switch( actionSelId )
     {
       case kScoreGenSelId:
-        rc = score_gen( &ctx, xmlFn, decFn, csvScoreFn, midiOutFn, svgOutFn, reportFl, begMeasNumb, begTempoBPM, svgStandAloneFl, svgPanZoomFl, damperRptFl );
+        rc = score_gen( &ctx, xmlFn, editFn, csvScoreFn, midiOutFn, svgOutFn, reportFl, begMeasNumb, begTempoBPM, svgStandAloneFl, svgPanZoomFl, damperRptFl );
+        break;
+
+      case kScoreEditMergeSelId:
+        rc = score_edit_merge( &ctx, xmlFn, editFn, begMeasNumb, keyEditFn, keyMeasNumb, outEditFn );
         break;
 
       case kScoreFollowSelId: