mikaela.github.io/n/reuse.md

2.5 KiB
Raw Blame History

REUSE notes

reuse is a tool for compliance with the REUSE recommendations.

says their GitHub description and in practice this means having a license header in all files or alternatively a file.license file. The tool can generate these, but I never remember the commands.

For more detailed explanation, consult reuse.software/tutorial


Adding headers

Copy-paste and add file name(s) to the end

# Autodetect how to add comment?
reuse annotate --copyright="Aminda Suomalainen <{{ page.email }}>" --license="CC0-1.0"
# Create a file.license
reuse annotate --copyright="Aminda Suomalainen <{{ page.email }}>" --license="CC0-1.0" --force-dot-license
# The usual # marks a comment
reuse annotate --copyright="Aminda Suomalainen <{{ page.email }}>" --license="CC0-1.0" --style python

Note!

  • --year 2023 can be specified if the date isnt this year.
  • annotate replaces existing headeer if any, to add before it instead, use --no-replace

Styles

  • c means // marks a comment
  • python means # marks a comment
  • html and css explain themselves
  • tex means % marks a comment
  • vim means " marks a comment
  • etc. when style is empty, supported ones are displayed, but I am unsure whether I need more and trying what reuse says works too.

Generic commands

  • reuse download --all - downloads all licenses found to LICENSES/
  • reuse lint - verifies compliancy
  • reuse supported-licenses | less - lists supported licenses identifiers

License identifiers I commonly use

  • CC0-1.0
  • CC-BY-4.0
  • CC-BY-ND-4.0
  • CC-BY-SA-4.0
  • BSD-3-Clause
  • EUPL-1.2

See also SPDX License List

Viewing source of this page reveals this one to be CC-BY-SA-4.0.