aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/intro.cli34
1 files changed, 24 insertions, 10 deletions
diff --git a/doc/intro.cli b/doc/intro.cli
index bdfddc8..18a42f2 100644
--- a/doc/intro.cli
+++ b/doc/intro.cli
@@ -166,6 +166,7 @@ hello/
│ └── testscript
├── buildfile
├── manifest
+├── README.md
└── repositories.manifest
\
@@ -268,8 +269,9 @@ $ cat manifest
: 1
name: hello
version: 0.1.0-a.0.z
-summary: hello executable
-license: TODO
+summary: hello C++ executable
+license: proprietary
+description-file: README.md
url: https://example.org/hello
email: you@example.org
#depends: libhello ^1.0.0
@@ -284,8 +286,13 @@ name, version, license, dependencies, etc., all in one place.
for details on the package manifest values.|
As you can see, \c{manifest} created by \l{bdep-new(1)} contains some dummy
-values which you would want to adjust before publishing your package. But
-let's resist the urge to adjust that strange looking \c{0.1.0-a.0.z} until we
+values which you would want to adjust before publishing your package.
+Specifically, you would want to review \l{bpkg#manifest-package-summary
+\c{summary}}, \l{bpkg#manifest-package-license \c{license}},
+\l{bpkg#manifest-package-url \c{url}}, and \l{bpkg#manifest-package-email
+\c{email}} as well as the \c{README.md} file referenced by
+\l{bpkg#manifest-package-description \c{description-file}}. Let's, however,
+resist the urge to adjust that strange looking \c{0.1.0-a.0.z} until we
discuss package versioning.
\N|Next to \c{manifest} you might have noticed the \c{repositories.manifest}
@@ -1658,6 +1665,7 @@ hello/
│ └── buildfile
├── buildfile
├── manifest
+├── README.md
└── repositories.manifest
\
@@ -1672,7 +1680,8 @@ hello/
│ │ ├── hello.cxx
│ │ └── buildfile
│ ├── buildfile
-│ └── manifest
+│ ├── manifest
+│ └── README.md
└── repositories.manifest
\
@@ -1913,11 +1922,14 @@ along these lines:
└── share/
└── doc/
├── libformat/
- │ └── manifest
+ │ ├── manifest
+ │ └── README.md
├── libhello/
- │ └── manifest
+ │ ├── manifest
+ │ └── README.md
└── libprint/
- └── manifest
+ ├── manifest
+ └── README.md
\
\N|The installation locations of various types of files (executables,
@@ -2213,7 +2225,8 @@ projects are presented below.
│ ├── testscript
│ └── buildfile
├── buildfile
-└── manifest
+├── manifest
+└── README.md
\
\
@@ -2228,7 +2241,8 @@ lib<name>/
│ └── buildfile
├── tests/
├── buildfile
-└── manifest
+├── manifest
+└── README.md
\
The canonical structure for both project types is discussed in detail in