summaryrefslogtreecommitdiffstats
path: root/dev/specs.mdwn
blob: a6328895dc9bf9f08200dc54a7639bdd962e00e7 (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
[[!meta title="Specifications"]]

Specifications for the distribution are maintained in the
[doc/specs.git][specs-git] repository and published in HTML format on the
[specs Web site][specs-www].


Building Locally
================

Newer specifications like SPF 2.0 are multi-chapter books rendered from Markdown
source files using the custom-developed "markdownbook" software.  markdownbook
is currently used as a submodule of the specs repository.

One can download and build a local copy of the specifications from the
repository using the following commands:

    $ git clone git://git.os.libiquity.com/doc/specs.git
    $ cd specs
    $ git submodule init
    $ git submodule update
    $ make

This will render HTML versions of the specifications in the source tree.  You
can view these in a Web browser, e.g.:

    $ x-www-browser specs/spf-2.0/index.html


[specs-git]: http://git.os.libiquity.com/doc/specs.git
[specs-www]: http://specs.os.libiquity.com/