aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2023-10-12 10:17:52 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2023-10-12 10:17:52 +0200
commitac0a159994961f57c2c1331e747e219067cd1f45 (patch)
tree96b884a10bfc7462a744ba68ad945743379ec44b /doc
parent241da6af6df67634d81d5ae708df9272857113ad (diff)
Minor tweaks to packaging guide
Diffstat (limited to 'doc')
-rw-r--r--doc/packaging.cli13
1 files changed, 12 insertions, 1 deletions
diff --git a/doc/packaging.cli b/doc/packaging.cli
index 0363e9a..0090c67 100644
--- a/doc/packaging.cli
+++ b/doc/packaging.cli
@@ -104,7 +104,12 @@ place the library source directory into a subdirectory.
After \l{#dont-from-scratch generating the project template with \c{bdep-new}},
don't forget to update at least the key values in the generated \c{manifest}:
-\c{version}, \c{license}, and \c{summary}.
+\l{#dont-forget-update-manifest-version \c{version}},
+\l{#dont-forget-update-manifest-license \c{license}}, and
+\l{#dont-forget-update-manifest-summary \c{summary}}.
+
+
+\h2#dont-forget-update-manifest-version|Don't forget to update \c{manifest} value \c{version}|
For \c{version}, use the upstream version directly if it is semver (or
semver-like, that is, has three version components). Otherwise, see
@@ -113,6 +118,9 @@ How do I handle projects that don't use semantic versioning?} and
\l{https://github.com/build2/HOWTO/blob/master/entries/handle-projects-which-dont-use-version.md
How do I handle projects that don't use versions at all?}
+
+\h2#dont-forget-update-manifest-license|Don't forget to update \c{manifest} value \c{license}|
+
For \c{license}, use the \l{https://spdx.org/licenses/ SPDX license ID} if at
all possible. If multiple licenses are involved, use the SPDX License
expression. See the
@@ -120,6 +128,9 @@ expression. See the
\c{license} manifest value} documentation for details and the list of the
most commonly used SPDX license IDs.
+
+\h2#dont-forget-update-manifest-summary|Don't forget to update \c{manifest} value \c{summary}|
+
For \c{summary} use a brief description of the functionality provided by the
package. Less than 70 characters is a good target to aim for. Don't capitalize
subsequent words unless proper nouns and omit the trailing dot. For example: