From 0af2fee64b9408d4f2ece0176274318dee07ca69 Mon Sep 17 00:00:00 2001 From: Boris Kolpackov Date: Sat, 9 Jun 2018 18:02:49 +0200 Subject: Minor additions to intro --- doc/intro.cli | 23 +++++++++++++++-------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/doc/intro.cli b/doc/intro.cli index c766db6..ea29c48 100644 --- a/doc/intro.cli +++ b/doc/intro.cli @@ -226,11 +226,16 @@ sections). That \c{exe{hello\}} on the left of \c{:} is a \i{target} \i{prerequisites} (C++ source files, libraries, etc). This \c{buildfile} uses \l{b#name-patterns wildcard patterns} (that \c{*}) to automatically locate all the C++ source files. This means we don't have to edit our \c{buildfile} every -time we add a source file to our project. There also appears to be some -(commented out) infrastructure for importing and linking libraries (that -\c{libs} variable). We will see how to use it in a moment. Finally, the -\c{buildfile} also lists \c{testscript} as a prerequisite of \c{hello}. This -file tests our target. Let's take a look inside: +time we add, remove, or rename a source file in our project. There also +appears to be some (commented out) infrastructure for importing and linking +libraries (that \c{libs} variable). We will see how to use it in a moment. + +\N|for simple projects that follow the canonical structure we can often +completely ignore the presence of the build definition files thus approaching +the \i{build system-less} workflow found in languages like Rust and Go.| + +Finally, the \c{buildfile} also lists \c{testscript} as a prerequisite of +\c{hello}. This file tests our target. Let's take a look inside: \ $ cat hello/testscript @@ -363,7 +368,7 @@ future.| \ > bdep init -C ..\hello-debug @debug cc ^ config.cxx=cl ^ - \"config.cc.coptions=/MDd /Z7\" ^ + \"config.cc.coptions=/MDd /Od /Zi\" ^ config.cc.loptions=/DEBUG > bdep init -C ..\hello-release @release cc ^ @@ -458,7 +463,7 @@ test hello/test{testscript} ../hello-clang/hello/hello/exe{hello} \N|As we will see later, the \l{bdep-test(1)} command also allows us to test immediate (\c{--immediate|-i}) or all (\c{--recursive|-r}) dependencies of our -project.| +project. We call it \i{deep testing}.| While we are here, let's also check how hard it would be to cross-compile: @@ -658,7 +663,9 @@ a basic repository going is relatively easy \- all you need is an HTTP(S) server. Adding a repository web interface like that on \l{https://cppget.org cppget.org} will require running \l{https://cppget.org/brep \c{brep}}. And adding CI will require running a bunch of build bots -(\l{https://cppget.org/bbot \c{bbot}}).| +(\l{https://cppget.org/bbot \c{bbot}}). Note also that in \c{build2} +archive-based repositories can be federated with different sections of +the repository being hosted/managed potentially independently.| \N|CI support for version control-based repositories is a work in progress.| -- cgit v1.1