spack/lib/spack/docs
Aiden Grossman 2802013dc6
Add license directive (#39346)
This patch adds in a license directive to get the ball rolling on adding in license 
information about packages to spack. I'm primarily interested in just adding
license into spack, but this would also help with other efforts that people are
interested in such as adding license information to the ASP solve for 
concretization to make sure licenses are compatible.

Usage:

Specifying the specific license that a package is released under in a project's
`package.py` is good practice. To specify a license, find the SPDX identifier for
a project and then add it using the license directive:

```python
   license("<SPDX Identifier HERE>")
```

For example, for Apache 2.0, you might write:

```python
   license("Apache-2.0")
```

Note that specifying a license without a when clause makes it apply to all
versions and variants of the package, which might not actually be the case.
For example, a project might have switched licenses at some point or have
certain build configurations that include files that are licensed differently.
To account for this, you can specify when licenses should be applied. For
example, to specify that a specific license identifier should only apply
to versionup to and including 1.5, you could write the following directive:

```python
   license("MIT", when="@:1.5")
```
2023-10-18 03:58:19 -07:00
..
_gh_pages_redirect
_pygments Update RtD and Sphinx configuration (#38046) 2023-06-05 17:39:11 +02:00
_static
build_systems docs: Replace package list with packages.spack.io (#40251) 2023-10-01 05:36:22 +02:00
example_files
images Make "minimal" the default duplicate strategy (#39621) 2023-10-06 10:24:21 +02:00
tables docs: update Spack prerequisites (#40381) 2023-10-09 13:41:36 +00:00
.gitignore docs: Replace package list with packages.spack.io (#40251) 2023-10-01 05:36:22 +02:00
basic_usage.rst docs: Replace package list with packages.spack.io (#40251) 2023-10-01 05:36:22 +02:00
binary_caches.rst Fix typo: binary_caches.rst (#39064) 2023-07-24 15:09:34 +02:00
bootstrapping.rst containerize: ensure bootstrap images contain all system dependencies (#36818) 2023-08-09 09:46:59 +02:00
build_settings.rst Make "minimal" the default duplicate strategy (#39621) 2023-10-06 10:24:21 +02:00
build_systems.rst license year bump (#34921) 2023-01-18 14:30:17 -08:00
chain.rst license year bump (#34921) 2023-01-18 14:30:17 -08:00
command_index.in
conf.py docs: Replace package list with packages.spack.io (#40251) 2023-10-01 05:36:22 +02:00
config_yaml.rst installer: Improve status reporting (#37903) 2023-07-12 08:54:45 +02:00
configuration.rst Relax environment manifest filename requirements and lockfile identification criteria (#37413) 2023-05-05 07:40:49 -05:00
containers.rst containerize: update docs to activate env before using container templates (#40493) 2023-10-13 06:59:44 +00:00
contribution_guide.rst docs: Replace package list with packages.spack.io (#40251) 2023-10-01 05:36:22 +02:00
developer_guide.rst Fix case spelling for Lmod and Tcl (#36215) 2023-03-19 01:42:50 +00:00
environments.rst docs: add quotes around some values in a YAML example (#38412) 2023-06-16 10:29:09 +02:00
extensions.rst license year bump (#34921) 2023-01-18 14:30:17 -08:00
features.rst Add a maintainers directive (#35083) 2023-01-27 07:51:24 +01:00
getting_started.rst modules: improve default naming scheme (#37808) 2023-05-28 10:06:30 +02:00
gpu_configuration.rst External ROCm: add example configuration (#39602) 2023-08-26 15:46:25 -07:00
index.rst docs: Replace package list with packages.spack.io (#40251) 2023-10-01 05:36:22 +02:00
Makefile API Docs: fix broken reference targets 2021-07-16 08:30:56 -07:00
mirrors.rst Relax environment manifest filename requirements and lockfile identification criteria (#37413) 2023-05-05 07:40:49 -05:00
module_file_generation.svg
module_file_support.rst modules: add support for conflict in lua modulefile (#36701) 2023-07-18 10:24:46 +02:00
packaging_guide.rst Add license directive (#39346) 2023-10-18 03:58:19 -07:00
pipelines.rst Ci backwards compat (#36045) 2023-04-10 16:46:45 -05:00
replace_conda_homebrew.rst docs: Replace package list with packages.spack.io (#40251) 2023-10-01 05:36:22 +02:00
repositories.rst Allow choosing the name of the packages subdirectory in repositories (#36643) 2023-05-04 23:36:21 +02:00
requirements.txt build(deps): bump python-levenshtein in /lib/spack/docs (#40461) 2023-10-12 14:38:33 +00:00
signing.rst buildcache extractall: extract directly into spec.prefix (#37441) 2023-08-02 17:06:13 +02:00
spack.yaml license year bump (#34921) 2023-01-18 14:30:17 -08:00