From 057ea5697bab004eb56ee6b0338ae37f000ae23c Mon Sep 17 00:00:00 2001
From: "R. Tyler Croy" <tyler@monkeypox.org>
Date: Tue, 24 Jan 2017 20:35:53 -0800
Subject: [PATCH] Describe more of the format and rool

---
 .gitignore  |  1 +
 README.adoc | 38 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 39 insertions(+)

diff --git a/.gitignore b/.gitignore
index 3cf2ce1..1f86417 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,4 @@
 *.sw*
 build/
 obj/
+.ae/
diff --git a/README.adoc b/README.adoc
index 2d4cdc1..6d3a9cb 100644
--- a/README.adoc
+++ b/README.adoc
@@ -2,3 +2,41 @@
 
 The Analytical Engine (`ae`) is a Ada dependency management tool intended to
 make working with Ada project dependencies easier.
+
+
+== schematics.yaml
+
+[source,yaml]
+----
+catalogs:
+  - builtin://berriedale
+schematics:
+  - gtkada
+----
+
+
+== `ae` tool
+
+=== Installing schematics
+
+[source, bash]
+----
+% ae install
+----
+
+
+=== Using dependencies
+
+The subcommand `run` can be used to provide the appropriate environment
+variables for executing a program such that it can access installed schematics.
+
+[source, bash]
+----
+% ae run gprbuild
+----
+
+
+== .aerc
+
+The .aerc should be added to specific projects to override user-specific
+settings. Generally speaking these files should never be checked in.