82 lines
1 KiB
Markdown
82 lines
1 KiB
Markdown
|
# Lilith
|
||
|
|
|
||
|
|
> The theme of the jam is "first-class comments".
|
||
|
|
|
||
|
|
```c
|
||
|
|
// foo bar baz
|
||
|
|
```
|
||
|
|
|
||
|
|
``` clojure
|
||
|
|
; text that the parser throws away
|
||
|
|
|
||
|
|
(def <name> <value>)
|
||
|
|
(def ^{:doc "foo bar baz"} <name> <value>)
|
||
|
|
```
|
||
|
|
|
||
|
|
``` python
|
||
|
|
"""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
|
||
|
|
|
||
|
|
```
|
||
|
|
|
||
|
|
``` clojure
|
||
|
|
(defn foo [a b]
|
||
|
|
"Adds a and b
|
||
|
|
|
||
|
|
>>> (foo 1 2)
|
||
|
|
=> 3
|
||
|
|
"
|
||
|
|
(+ a b))
|
||
|
|
```
|
||
|
|
|
||
|
|
- Object code
|
||
|
|
- .... Other media?
|
||
|
|
|
||
|
|
``` clojure
|
||
|
|
(defn foo [a b]
|
||
|
|
(!doc "")
|
||
|
|
(!doctest "")
|
||
|
|
(!test "")
|
||
|
|
|
||
|
|
(!impl
|
||
|
|
(+ a b)))
|
||
|
|
```
|
||
|
|
|
||
|
|
``` clojure
|
||
|
|
(defn foo [a b]
|
||
|
|
"---
|
||
|
|
doc: |
|
||
|
|
Adds a and b
|
||
|
|
|
||
|
|
---
|
||
|
|
doctest:
|
||
|
|
- in: (foo 1 2)
|
||
|
|
out: 3
|
||
|
|
"
|
||
|
|
)
|
||
|
|
```
|
||
|
|
|
||
|
|
``` org
|
||
|
|
#+TITLE: foo
|
||
|
|
* my bullet
|
||
|
|
#+BEGIN_SRC clojure
|
||
|
|
(defn foo [a b] (+ a b))
|
||
|
|
#+END_SRC
|
||
|
|
```
|
||
|
|
|
||
|
|
`org-babel` `org-babel-tagle`
|
||
|
|
|
||
|
|
``` clojure
|
||
|
|
(defn foo [] ..)
|
||
|
|
```
|
||
|
|
|
||
|
|
####################################################################################################
|