diff options
| -rw-r--r-- | dev/specs.mdwn | 31 |
1 files changed, 31 insertions, 0 deletions
diff --git a/dev/specs.mdwn b/dev/specs.mdwn new file mode 100644 index 0000000..a632889 --- /dev/null +++ b/dev/specs.mdwn @@ -0,0 +1,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/ |