HACKING 1002 B

12345678910111213141516171819202122232425262728293031323334353637383940414243
  1. -*- mode: org; coding: utf-8; -*-
  2. #+TITLE: Hacking lzlib
  3. * Contributing
  4. By far the easiest way to hack on lzlib is to develop using Guix:
  5. #+BEGIN_SRC bash
  6. # Obtain the source code
  7. cd /path/to/source-code
  8. guix environment -l guix.scm
  9. # In the new shell, run:
  10. hall dist --execute && autoreconf -vif && ./configure && make check
  11. #+END_SRC
  12. You can now hack this project's files to your heart's content, whilst
  13. testing them from your `guix environment' shell.
  14. If you'd like to tidy the project again, but retain the ability to test the
  15. project from the commandline, simply run:
  16. #+BEGIN_SRC bash
  17. ./hall clean --skip "pre-inst-env" --execute
  18. #+END_SRC
  19. ** Manual Installation
  20. If you do not yet use Guix, you will have to install this project's
  21. dependencies manually:
  22. - autoconf
  23. - automake
  24. - pkg-config
  25. - texinfo
  26. - guile-hall
  27. - lzlib
  28. Once those dependencies are installed you can run:
  29. #+BEGIN_SRC bash
  30. hall dist -x && autoreconf -vif && ./configure && make check
  31. #+END_SRC