From ac0a159994961f57c2c1331e747e219067cd1f45 Mon Sep 17 00:00:00 2001 From: Boris Kolpackov Date: Thu, 12 Oct 2023 10:17:52 +0200 Subject: Minor tweaks to packaging guide --- doc/packaging.cli | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) (limited to 'doc') 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: -- cgit v1.1