source/projects/lilith/README.md

Lilith

The theme of the jam is "first-class comments".

// foo bar baz

; text that the parser throws away

(def <name> <value>)
(def ^{:doc "foo bar baz"} <name> <value>)

"""modules have __doc__ as a property defined by the FIRST heredoc-string in the file"""

def foo(a, b):
    """Adds a and b.

    >>> foo(1, 2)
    3
    """

    return a + b

(defn foo [a b]
    "Adds a and b

    >>> (foo 1 2)
    => 3
    "
    (+ a b))

• Object code
• .... Other media?

(defn foo [a b]
    (!doc "")
    (!doctest "")
    (!test "")

    (!impl
       (+ a b)))

(defn foo [a b]
    "---
    doc: |
       Adds a and b

    ---
    doctest:
      - in: (foo 1 2)
        out: 3
    "
    )

#+TITLE: foo
* my bullet
  #+BEGIN_SRC clojure
    (defn foo [a b] (+ a b))
  #+END_SRC

org-babel org-babel-tagle

(defn foo [] ..)

####################################################################################################