diff options
author | Boris Kolpackov <boris@codesynthesis.com> | 2023-10-12 10:17:52 +0200 |
---|---|---|
committer | Boris Kolpackov <boris@codesynthesis.com> | 2023-10-12 10:17:52 +0200 |
commit | ac0a159994961f57c2c1331e747e219067cd1f45 (patch) | |
tree | 96b884a10bfc7462a744ba68ad945743379ec44b | |
parent | 241da6af6df67634d81d5ae708df9272857113ad (diff) |
Minor tweaks to packaging guide
-rw-r--r-- | doc/packaging.cli | 13 |
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: |