aboutsummaryrefslogtreecommitdiff
path: root/STYLES
blob: 49756f93e7d476d15b7a5c70fa87e8393874ebf4 (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 rule 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 => ...