6 Troubleshooting

• Build Issues
• Test Issues

6.1 Troubleshooting Build Issues

• CURRY-COMPOSE-READER-MACROS LCURLY-BRACE-READER is undefined
• Deleting cache files

CURRY-COMPOSE-READER-MACROS::LCURLY-BRACE-READER is undefined

This usually indicates an issue with cache files created by ASDF.

To resolve this issue:

• select the try-recompiling restart at the repl, or
• delete cache files.

Deleting cache files

As part of the compilation process, ASDF saves compiled files to a cache as described in the ASDF manual. When dealing with some compilation issues (see CURRY-COMPOSE-READER-MACROS LCURLY-BRACE-READER is undefined), it may be necessary to delete the cache.

By default, the cache should be located in ~/.cache/common-lisp/[lisp-implementation]/path/to/local/projects/software-evolution-library.

To remove the cache, execute:

    rm -rf ~/.cache/common-lisp/[lisp-implementation]/path/to/local/projects/software-evolution-library

6.2 Troubleshooting Test Issues

• Did all unit tests pass?
• There are many test failures

Did all unit tests pass?

If the make check build target shows a sequence of dots with no ’E’ or ’X’ characters, all unit tests passed. See the stefil project page for more information on our unit testing framework.

There are many test failures

A large number of test failures usually indicates a major prerequisite is missing. To debug, try the following.

1. Ensure clang is on your $PATH.
2. Execute

   clang -g -O0 test/etc/hello-world/hello_world.c
   

If the above fails, the unit test failure is due to an external tool failing. Ensure clang and the compiler toolchain is properly installed on your system.