Usage on Windows

[noncom]

Running on Windows

It mostly just works, but still some issues were found to stand in the way.
I collected all the points I had to address when trying to run neomacs.

Getting Started

• Follow the instruction to build locally, but don't do the "(ql:quickload "neomacs") and (neomacs:start)" just yet. If you still did, no problem, it just won't work, restart the SBCL instance.
• Clone osicat to "quicklisp/local-projects".
  Note: the issue has been officially fixed, but the change has not yet propagated as per writing this, and it's not clear if it will propagate correctly any time soon. However, if you see it happened, then this step is not necessary, and needs to be removed from this instruction.
• Execute (ql:quickload "neomacs"). It will likely stop with the "Symbol "FSYNC" not found in the SB-POSIX package" error at some point, but the important part is that it downloaded the bknr-datastore library for us to modify.
  Note: If you fixed your installation on bknr-datastore before, there's going to be no error, so ignore the next point.
• Open the "txn.lisp" file that the error points at, find and replace all #+sbcl in it with #+(and sbcl (not win32)). Retry loading.
  Note: This is a known issue with the bknr-datastore libary, but it's unknown when it will be fixed, if ever.
• Run (neomacs:start).

Troubleshooting

• Problem: You're getting "Package LOG does not exist." error from ceramic when loading neomacs.
  Solution: You have missed the manual cloning of ceramic from the instruction to build locally. Ultralisp downloads a broken fork of ceramic by 40ants by default. Just remove it and correctly clone the original ceramic repo as described.
• Problem: lwcells library is not found when building neomacs.
  Solution: Clone lwcells into "quicklisp/local-projects". This problem should not happen, but it happened once for me, so I'll include the mention of it here just in case.