From f9a8ca36f2017454e47c34e3afb36ab02287ffbb Mon Sep 17 00:00:00 2001 From: Benjamin A. Beasley Date: Feb 16 2024 13:40:39 +0000 Subject: Document the -l/-L options to %pyproject_save_files Copy essential commentary and recommendations from the README.md of pyproject-rpm-macros. --- diff --git a/guidelines/modules/ROOT/pages/Python.adoc b/guidelines/modules/ROOT/pages/Python.adoc index 9733b13..fea839a 100644 --- a/guidelines/modules/ROOT/pages/Python.adoc +++ b/guidelines/modules/ROOT/pages/Python.adoc @@ -1264,7 +1264,7 @@ Recommends: python3-pello+color %pyproject_install # Here, "pello" is the name of the importable module. -%pyproject_save_files pello +%pyproject_save_files -l pello %check @@ -1522,6 +1522,17 @@ To prevent Shell from expanding the globs, put them in `+''+`, e.g. `+%pyproject_save_files '*pytest'+`. As mentioned in the <> section, expressions like `+%pyproject_save_files '*'+` are not acceptable. ++ +The macro has these options: ++ +** `+-l+`: Declare that a missing license should terminate the build. +Packagers are encouraged to use this flag +when the `%license file` is not manually listed in `%files` +to avoid accidentally losing the file in a future version. +** `+-L+`: Explicitly disable the check for a missing license file. +When the `%license` file is manually listed in `%files`, +packagers can use this flag to ensure future compatibility +in case the `-l` behavior eventually becomes a default. [#pyproject_files] * `+%{pyproject_files}+`