aboutsummaryrefslogtreecommitdiff
path: root/doc/intro.cli
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2020-07-12 10:18:05 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2020-07-12 10:18:05 +0200
commit9cdf198df15726486f68022e74276a28c64f9b9c (patch)
tree97662425a2381b70c5413df03036905963dec6d6 /doc/intro.cli
parente135a3112b15c88f0601583ca068f8adea7b605d (diff)
Mention glue buildfiles in introduction
Diffstat (limited to 'doc/intro.cli')
-rw-r--r--doc/intro.cli19
1 files changed, 17 insertions, 2 deletions
diff --git a/doc/intro.cli b/doc/intro.cli
index cac0030..795b65e 100644
--- a/doc/intro.cli
+++ b/doc/intro.cli
@@ -1766,6 +1766,7 @@ hello/
├── libhello/
│ ├── ...
│ └── manifest
+├── buildfile
├── packages.manifest
└── repositories.manifest
\
@@ -1774,8 +1775,21 @@ hello/
the project (repository) while \c{manifest} \- to the package.|
Besides the \c{libhello} directory the \c{new} command also created the
-\c{packages.manifest} file in the root directory of our project. Let's take a
-look inside:
+\c{buildfile} and \c{packages.manifest} files in the root directory of our
+project. First let's take a look inside \c{buildfile}:
+
+\
+import pkgs = */
+
+./: $pkgs
+\
+
+This is what we call a \i{glue \c{buildfile}}. Its purpose is to \"pull\"
+together several packages so that we are able to invoke the build system
+driver from the project root. See \l{b#intro-import Target Importation} for
+details.
+
+Now let's examine \c{packages.manifest}:
\
$ cat packages.manifest
@@ -1858,6 +1872,7 @@ hello/
│ ├── LICENSE -> ../LICENSE
│ └── manifest
├── LICENSE
+├── buildfile
├── packages.manifest
└── repositories.manifest
\