This package browser is in early development. Mind the rough edges.

ecl-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.

Installation

Install ecl-mgl-pax 0.3.0-1.6782eb0 as follows:

guix install ecl-mgl-pax@0.3.0-1.6782eb0

Or install the latest version:

guix install ecl-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.