Packaging

Sorry packagers, I have committed two ultimate sins.

  1. I checked in some generated code into my repository.
  2. I have copied others' code into my repository, also known as "vendoring" code.

Debian packaging is at https://git.sr.ht/~technomancy/fennel-ls/log/debian/latest

Generated Code

The files inside src/fennel-ls/docs/generated/ are not hand-written, they are generated. The documentation embedded into fennel-ls needs to come from various documentation websites on the internet, such as the Lua Manual, and I use scripts to download and parse these sites into these generated files.

The content of these websites is available under the MIT license, so there isn't any licensing issue.

I understand if you want to build from source instead of relying on the output. You can rebuild these by running make rm-docs to remove the docs, and make docs to regenerate these files. However, this requires internet access. 

$ make rm-docs
$ make docs

Vendored Dependencies

The vendored dependencies are very easy to solve. You delete the dependency files by running make rm-deps. 

$ make rm-deps
rm -rf fennel deps/
$

Once these files are removed, you can safely use make to build the program. 

# Not shown here: install fennel and lua and make and lua-dkjson

# building
make

# testing (only works if faith and penlight and dkjson is installed)
make test

Dependencies Overview

Things marked with (vendored) are from the deps/ folder, or from your environment if you've built a clean one.

The specific versions of vendored packagens can be found in the vendoring script.