Previous: Installing from the SVN Repository, Up: Installing


2.4 Regression Tests

To run the regression test suite you must have FOMUS, SBCL, LilyPond and libxml2 installed and the fomus, sbcl, lilypond and xmllint commands in your path. For xmllint to work, you must either be connected to the internet or must download the MusicXML DTDs and set up a catalog file that points xmllint to your local partwise.dtd file.

The command is:

     cd path/to/fomus/source/directory
     make installcheck

If successful, this will create two HTML files named check.html and checkdocs.html in the source directory. Open these in a web browser to compare test files to their outputs and verify that FOMUS is running correctly. The install check also prints out a summary of the results, which includes several other test suites in addition to the two mentioned above.

On my machine, I have the MusicXML DTD files stored in /home/david/local/share/musicxml/ and a catalog file in the same directory simply called catalog.xml. The contents of catalog.xml are:

     <?xml version="1.0"?>
     <!DOCTYPE catalog PUBLIC "-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN"
       "http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd">
     <catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
       <public publicId="-//Recordare//DTD MusicXML 2.0 Partwise//EN"
         uri="/home/david/local/share/musicxml/partwise.dtd"/>
     </catalog>

Then in my .profile file I have

     export XML_CATALOG_FILES="/etc/xml/catalog /home/david/local/share/musicxml/catalog.xml"