blob: 7c9815c1e8ae0c194b8dce03742b493fef544059 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
|
Styles for Boot Codes
---------------------
The core of the OpenAxiom system is mostly written Boot. A long
time ago, Boot was essentially a Lisp DSL with a much more palatable
syntax geared specifically for writing readable codes. As such it
tended to have lots of Lispism in it.
There days, Boot is no longer `just a syntactic sugar over Lisp',
even currently, we essentially translate to Lisp. Boot is a
programming language in of its own. In fact, we would like to remove
Lispism from Boot codes. The `rules' below are suggestions (or
guidelines) for writing `good Boot codes'.
* In general, you should precede your functions definitions with
++ comments that describes the semantics of the functions, its
pre- and post-conditions.
* Use -- comments only for non-descriptive remarks, such as in
function body.
* Always precede your functions definitions with type declarations.
Exception to this ruke should be rare and documented.
* Don't use Lisp functions directly in Boot codes, except where
they are for interfacing with Lisp.
Example:
-- GOOD --
first form in '(Mapping Record) => -- ...
-- BAD --
CAR form in '(Mapping Record) => -- ...
* Don't use `null' to test for Boolean values, use `not'
Example:
-- GOOD --
not $monitorNewworld => ...
-- BAD --
null $monitorNewworld => ...
|
