marginalia

marginalia copied to clipboard

Parse doctsrings in nested protocol sigs

2

This should be fully parsed by Marg: ``` (defprotocol Foo "This is a protocol docstring. It should be presented on the LHS doc view" (bar [this] "This is a protocol...

fogus

Docstrings in metadata are extracted, but the metadata key is shown with no value.

2

For example, given the following code: ``` clojure (def ^{:const true :doc "this is a thing"} a-thing {}) ``` marg will correctly identify the docstring and move it to the...

benjamin-bader

It would be very handy if marginalia supported github flavored markdown, for tables, for example.

wiseman

Can not find namespaces

1

The build succeeds, but only dependencies are listed in the uberdoc.html, namespaces are empty. Here is the maven output SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder". SLF4J: Defaulting to no-operation (NOP)...

htenes

Document namespaces in order of usage

2

The namespaces appear to be ordered arbitrarily, it would be more useful if the namespaces were ordered so that the dependencies come first (or possibly last depending on your preference)....

kurtharriger

Allow suppression of "Project" summary at the top

3

For some uses, I may not want to show the project metadata at the beginning of my Marginalia output. It would be nice to have a command-line option to disable...

eigenhombre

My `project.clj`'s description is in Portuguese, and has some diacritical marks. The file is saved in UTF-8, yet the text is messed up when Marginalia generates the documentation: "Provê" becomes...

hanjos

Create separate project for standalone exe

4

At the moment Marg is compiled to provide a -main entry point, but I think it should act as a pure library only. We should create a whole new project...

fogus

The tests attempt to import code from clojure.contrib, which has gone away. This is the result of running `lein test`: Exception in thread "main" java.io.FileNotFoundException: Could not locate clojure/contrib/java_utils__init.class or...

wjlroe

This breaks syntax highlighting for every function that comes after this function: ``` (defn breakage [] ;break ) ``` This is because marginalia rewrites this to ``` (defn breakage []...

dgrnbrg