From 97209bc5a9a9c1d5687aea831272e005791a96d7 Mon Sep 17 00:00:00 2001 From: Boris Kolpackov Date: Fri, 17 May 2019 09:39:20 +0200 Subject: Update introduction with README.md, new default license value --- doc/intro.cli | 34 ++++++++++++++++++++++++---------- 1 file changed, 24 insertions(+), 10 deletions(-) (limited to 'doc') 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/ │ └── buildfile ├── tests/ ├── buildfile -└── manifest +├── manifest +└── README.md \ The canonical structure for both project types is discussed in detail in -- cgit v1.1