Common Errors

Within these castle walls be forged Mavens of Computer Science ...

— Merlin, The Coder

Merlin Dynamic Libraries

The specified library path was not found

Helpful Hint

If you see the following error:

The specified library path was not found '/usr/local/lib/merlin/Igis-1.2.0/Igis/.build/debug'

This indicates that the specified  Coder Merlin™  libraries have been updated and the older version is no longer available. Simply update the dylib.manifest file with the latest version numbers for that library. All  Coder Merlin™  libraries can be found at /usr/local/lib/merlin.

john-williams@codermerlin:~/Experiences/W1501$ ls -dt /usr/local/lib/merlin/Igis*

/usr/local/lib/merlin/Igis-1.3.7

/usr/local/lib/merlin/Igis-1.3.6

/usr/local/lib/merlin/Igis-1.3.4

/usr/local/lib/merlin/Igis-1.2.9

In general, select the most recent version and then edit dylib.manifest updating the respective version number. For example, from:

   1 | Igis            1.2.0

   2 | Scenes          1.0.4

To:

   1 | Igis            1.3.7

   2 | Scenes          1.0.4

Be certain that the final line in the file ends with a RETURN

dylib.manifest has been changed but .dir-locals.el has not

Helpful Hint

If you see the following error:

ERROR: '/home/john-williams/Experiences/W1501/dylib.manifest' has been changed but '/home/john-williams/Experiences/W1501/.dir-locals.el' has not.

Did you mean to execute dylibEmacs?

This means that dylib.manifest has been updated but .dir-locals.el has not. This may be easily remedied by executing:

john-williams@codermerlin:~/Experiences/W1501$ rm .dir-locals.el

john-williams@codermerlin:~/Experiences/W1501$ dylibEmacs

IGIS

Address already in use

Helpful Hint

If you see the following error:

Starting...
Loading resources from /usr/local/lib/merlin/Igis-1.3.7/Igis/Sources/Igis/Resources
Error: bind(descriptor:ptr:bytes:): Address already in use (errno: 98)

This means that Igis is already running and you've attempted to start a second instance. This may be remedied by terminating any other running Igis jobs.

john-williams@codermerlin:~/Experiences/W1501$ jobs

[1]+ Stopped run

john-williams@codermerlin:~/Experiences/W1501$ kill %1

Merlin Mission Manager

This project doesn't permit changes to the file

Helpful Hint

If you see the following error:

This project doesn't permit changes to the file main.swift, however the file has been changed.
Restore the file to its original state or delete the file and execute merlin prepare.

This means that  Merlin Mission Manager  has detected a change to a file which may not be changed. This may be remedied by restoring the file and being certain to change only those files which may be changed. It's probably helpful to re-read the instructions.

john-williams@codermerlin:~/Merlin/M1301-15 (01) Karel Beeper Spread/C101 Move It [Karel]$  rm main.swift

john-williams@codermerlin:~/Merlin/M1301-15 (01) Karel Beeper Spread/C101 Move It [Karel]$  merlin prepare

Emacs

Syntax Highlighting

Helpful Hint

If emacs is not providing correct syntax highlighting, be sure that you've followed the instructions to recreate .dir-locals.el. If that doesn't resolve the issue, then within emacs:

1. Remove the workspace folder:

M-x lsp-workspace-folders-remove RETURN RETURN

2. Add the correct folder:

M-x lsp-workspace-folders-add RETURN

and then enter the folder containing Package.swift

3. Exit and restart emacs

Multiple Instances of Emacs

Helpful Hint

If you see the following error:

emacs is already running in this shell: [1]+ 3649039 Stopped                /usr/local/bin/emacs
        Type 'fg 1' to resume
Alternatively, you may specify --force-open to force open a new instance.

By default,  Coder Merlin™  prohibits launching multiple instances of Emacs in the same shell session. Instead, you are encouraged to re-use the same Emacs session to find other files. If you truly need multiple instances of Emacs, you can use the --force-open flag.

john-williams@codermerlin:~$  emacs --force-open