cl-mgl-pax 0.3.0-1.6782eb0
Exploratory programming environment and documentation generator
PAX provides an extremely poor man's Explorable Programming environment. Narrative primarily lives in so called sections that mix markdown docstrings with references to functions, variables, etc, all of which should probably have their own docstrings.
The primary focus is on making code easily explorable by using SLIME's M-.
(slime-edit-definition
). See how to enable some fanciness in Emacs Integration. Generating documentation from sections and all the referenced items in Markdown or HTML format is also implemented.
With the simplistic tools provided, one may accomplish similar effects as with Literate Programming, but documentation is generated from code, not vice versa and there is no support for chunking yet. Code is first, code must look pretty, documentation is code.
- Website: https://melisgl.github.io/mgl-pax/
- Licenses: Expat
- Package source: gnu/packages/lisp-xyz.scm
- Builds: See build status
- Issues: See known issues
Installation
Install cl-mgl-pax 0.3.0-1.6782eb0
as follows:
guix install cl-mgl-pax@0.3.0-1.6782eb0
Or install the latest version:
guix install cl-mgl-pax
You can also install packages in augmented, pure or containerized environments for development or simply to try them out without polluting your user profile. See the guix shell
documentation for more information.