Skip to content

Marginalia Quick Start

Raynes edited this page Dec 1, 2011 · 3 revisions

Usage

Currently Marginalia can be used in a number of ways as described below.

Command Line

You can download the Marginalia 0.5.0 jar including packaged dependencies from Github.

Running Marginalia given the jar file linked above is as easy as:

java -jar marginalia-0.5.0-standalone.jar

This will search the PWD for a src directory which it will then traverse looking for Clojure source files to parse and generate documentation for. Marginalia also takes specific locations and files to generate docs for:

java -jar marginalia-0.5.0-standalone.jar <file1> <file2> ... <filen>

Arguments can be specific files or directories.

Leiningen

To use Marginalia in your own projects simply add the following to your project.clj file in the :dev-dependencies section:

[marginalia "0.5.0"]

After executing lein deps you can generate your complete source documentation with the following command:

lein marg

Marginalia accepts other options as outlined in the Command Line section above.

Maven

Not yet supported.

Clone this wiki locally