REUSE-ANNOTATE(1)                    reuse                   REUSE-ANNOTATE(1)

<?><?><?> (NAME)
       reuse-annotate - <?><?><?><?><?><?> <?><?><?><?><?><?><?> REUSE <?><?>
       <?><?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       reuse annotate [<?><?><?><?><?><?><?><?>] [<?><?><?><?> ...]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> reuse-annotate <?><?><?><?><?><?><?> REUSE <?><?>
       <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>.
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?>:
          <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> annotate
          <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
          <?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?>
          <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?>
          <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
          <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
          <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
          <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
          <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
          <?><?><?><?><?><?> <?><?><?><?>. <?><?><?><?> <?><?><?> <?><?><?>
          <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
          <?> <?><?><?><?><?><?><?><?><?><?> <?><?><?>.

       <?><?><?> REUSE <?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       (#!) <?><?> <?><?><?><?><?><?><?><?><?> XML (<?xml version="1.0"?>).
       <?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>---<?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?>---<?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?> REUSE
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?> <?> <?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> (<?><?><?><?> <?><?><?><?><?> // <?><?><?><?><?><?>
       /* ... */ <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> C++).
       <?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (MANDATORY OPTIONS)
       <?><?><?><?><?> <?><?><?> (one) <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?>. <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>(<?><?>)
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?>. <?><?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.

       -c, --copyright COPYRIGHT
              <?><?><?><?><?><?> <?><?> <?><?><?>. <?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?>. <?><?><?><?> <?><?><?> <?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> --year <?>
              --copyright-prefix <?><?> <?><?><?><?><?><?>.

       -l, --license LICENSE
              <?><?><?><?><?> <?><?><?><?> SPDX.

       --contributor CONTRIBUTOR
              <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>.
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> SPDX-FileContributor: <?><?><?><?><?>
              <?><?><?><?><?> <?><?>.

<?><?><?><?> <?><?><?><?><?><?><?><?> (OTHER OPTIONS)

       -y, --year YEAR
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?>(<?><?><?>) <?><?>
              <?><?><?>. <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              (<?><?><?><?><?><?>) <?><?><?><?><?> <?><?><?><?><?> '2017-2019'
              <?><?> '2017, 2019-2022, 2024-Present'.

       -s, --style STYLE
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?> <?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?>.

       --copyright-prefix PREFIX
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?>. <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> spdx <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?>:

                 spdx:               SPDX-FileCopyrightText: <year> <author>
                 spdx-c:             SPDX-FileCopyrightText: (C) <year> <author>
                 spdx-symbol:        SPDX-FileCopyrightText: (C) <year> <author>
                 spdx-string:        SPDX-FileCopyrightText: Copyright <year> <author>
                 spdx-string-c:      SPDX-FileCopyrightText: Copyright (C) <year> <author>
                 spdx-string-symbol: SPDX-FileCopyrightText: Copyright (C) <year> <author>
                 string:             Copyright <year> <author>
                 string-c:           Copyright (C) <year> <author>
                 string-symbol:      Copyright (C) <year> <author>
                 symbol:             (C) <year> <author>

       -t, --template TEMPLATE
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?><?>. <?><?><?> <?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              .reuse/templates/ <?><?><?><?> <?><?><?><?><?> .jinja2 <?><?>
              .commented.jinja2 <?><?><?><?><?><?> <?><?><?><?>.

       --exclude-year
              <?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?>.

       --merge-copyrights
              <?><?><?> <?><?> (<?><?> <?><?><?>) <?><?><?><?><?> <?><?>
              <?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
              <?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?>.

       --single-line
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?><?> C<?> <?><?><?> <?><?><?><?><?>
              // <?><?><?><?><?> <?><?><?>.

       --multi-line
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?><?> C<?> <?><?><?> <?><?><?><?><?>
              /* ... */ <?><?><?><?><?> <?><?><?>.

       -r, --recursive
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>.

       --no-replace
              <?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> <?>
              <?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?> <?>
              <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?>.

       --force-dot-license
              <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?> .license <?><?><?><?><?>.

       --fallback-dot-license
              <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?> .license <?><?><?><?><?> <?><?>.

       --skip-unrecognised
              <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?>.

       --help <?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?>.

<?><?><?><?><?><?> (TEMPLATES)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> SPDX <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> Jinja2 <?><?><?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>:

          {% for copyright_line in copyright_lines %}
          {{ copyright_line }}
          {% endfor %}
          {% for contributor_line in contributor_lines %}
          SPDX-FileContributor: {{ contributor_line }}
          {% endfor %}

          {% for expression in spdx_expressions %}
          SPDX-License-Identifier: {{ expression }}
          {% endfor %}

       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> Jinja2
       <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?> <?><?> <?><?> <?><?><?><?> .reuse/templates/ <?><?><?><?>
       <?><?><?><?>. <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> .jinja2 <?><?><?>
       <?><?><?>.

       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?>:

       o copyright_lines --- <?><?><?><?><?><?> <?><?>
         <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> (<?><?><?><?>).

       o contributor_lines --- <?><?><?><?><?><?> <?><?>
         <?><?><?><?><?><?><?><?><?><?><?><?><?><?> (<?><?><?><?>).

       o spdx_expressions --- <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
         <?><?><?><?> SPDX (<?><?><?><?>).

       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?>. <?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?> <?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?>. <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?>
       <?><?><?><?><?> .commented.jinja2 <?><?><?> <?><?><?><?>.

       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?>:

          /*
          {% for copyright_line in copyright_lines %}
           * {{ copyright_line }}
          {% endfor %}
          {% if copyright_lines and spdx_expressions %}
           *
          {% endif %}
          {% for expression in spdx_expressions %}
           * SPDX-License-Identifier: {{ expression }}
          {% endfor %}
          {% if "GPL-3.0-or-later" in spdx_expressions %}
           *
           * This program is free software: you can redistribute it and/or modify it under
           * the terms of the GNU General Public License as published by the Free Software
           * Foundation, either version 3 of the License, or (at your option) any later
           * version.
           *
           * This program is distributed in the hope that it will be useful, but WITHOUT
           * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
           * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
           *
           * You should have received a copy of the GNU General Public License along with
           * this program. If not, see <https://www.gnu.org/licenses>.
          {% endif %}
           */

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       reuse annotate --copyright="Jane Doe" --license=MIT my_file.py
       <?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?> (<?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?>):

          # SPDX-FileCopyrightText: 2019 Jane Doe
          #
          # SPDX-License-Identifier: MIT

<?><?><?><?><?><?><?> (AUTHOR)
       Free Software Foundation Europe

<?><?> <?><?><?> (COPYRIGHT)
       2017, Free Software Foundation Europe. CC-BY-SA-4.0

6.2.0                          December 17, 2025             REUSE-ANNOTATE(1)