Manpage logo

reuse-lint - Verify whether a project is compliant with the REUSE Specification

NAME  SYNOPSIS  DESCRIPTION  CRITERIA  Bad licenses  Deprecated licenses  Licenses without file extension  Missing licenses  Unused licenses  Read errors  Files without copyright and license information  OPTIONS  AUTHOR  COPYRIGHT 

NAME

reuse-lint − Verify whether a project is compliant with the REUSE Specification

SYNOPSIS

reuse lint [options]

DESCRIPTION

reuse−lint verifies whether a project is compliant with the REUSE Specification located at https://reuse.software/spec.

CRITERIA

These are the criteria that the linter checks against.

Bad licenses

Licenses that are found in LICENSES/ that are not found in the SPDX License List or do not start with LicenseRef− are bad licenses.

Deprecated licenses

Licenses whose SPDX License Identifier has been deprecated by SPDX.

Licenses without file extension

These are licenses whose file names are a valid SPDX License Identifier, but which do not have a file extension.

Missing licenses

A license which is referred to in a comment header, but which is not found in the LICENSES/ directory.

Unused licenses

A license found in the LICENSES/ directory, but which is not referred to in any comment header.

Read errors

Not technically a criterion, but files that cannot be read by the operating system are read errors, and need to be fixed.

Files without copyright and license information

Every file needs to have copyright and licensing information associated with it. The REUSE Specification details several ways of doing it. By and large, these are the methods:

Placing tags in the header of the file.

Placing tags in a .license file adjacent to the file.

Putting the information in a REUSE.toml file, which must be in an ancestor directory relative to the file.

Putting the information in the .reuse/dep5 file. (Deprecated)

If a file is found that does not have copyright and/or license information associated with it, then the project is not compliant.

OPTIONS

−q, −−quiet

Do not print anything to STDOUT.

−j, −−json

Output the results of the lint as JSON.

−p, −−plain

Output the results of the lint as descriptive text. The text is valid Markdown. This option is the default.

−l, −−lines

Output one line per error, prefixed by the file path.

−−help

Display help and exit.

AUTHOR

Free Software Foundation Europe

COPYRIGHT

2017, Free Software Foundation Europe. CC-BY-SA-4.0


Updated 2026-06-01 - jenkler.se | uex.se