mirror of
https://gitlab.isc.org/isc-projects/bind9.git
synced 2025-04-18 09:44:09 +03:00
58bd26b6cf
This commit converts the license handling to adhere to the REUSE specification. It specifically: 1. Adds used licnses to LICENSES/ directory 2. Add "isc" template for adding the copyright boilerplate 3. Changes all source files to include copyright and SPDX license header, this includes all the C sources, documentation, zone files, configuration files. There are notes in the doc/dev/copyrights file on how to add correct headers to the new files. 4. Handle the rest that can't be modified via .reuse/dep5 file. The binary (or otherwise unmodifiable) files could have license places next to them in <foo>.license file, but this would lead to cluttered repository and most of the files handled in the .reuse/dep5 file are system test files.
56 lines
1.4 KiB
Plaintext
56 lines
1.4 KiB
Plaintext
#!@PERL@ -w
|
|
#
|
|
# Copyright (C) Internet Systems Consortium, Inc. ("ISC")
|
|
#
|
|
# SPDX-License-Identifier: MPL-2.0
|
|
#
|
|
# This Source Code Form is subject to the terms of the Mozilla Public
|
|
# License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
# file, you can obtain one at https://mozilla.org/MPL/2.0/.
|
|
#
|
|
# See the COPYRIGHT file distributed with this work for additional
|
|
# information regarding copyright ownership.
|
|
|
|
# Input filter for feeding our source code into Doxygen.
|
|
|
|
# Slurp whole file at once
|
|
undef $/;
|
|
$_ = <>;
|
|
|
|
# It turns out that there are a lot of cases where we'd really like to
|
|
# use what Doxygen calls "brief" documentation in a comment. Doxygen
|
|
# has a shorthand way of doing this -- if one is writing C++. ISC
|
|
# coding conventions require C, not C++, so we have to do it the
|
|
# verbose way, which makes a lot of comments too long to fit on a
|
|
# single line without violating another ISC coding standard (80
|
|
# character line limit).
|
|
#
|
|
# So we use Doxygen's input filter mechanism to define our own
|
|
# brief comment convention:
|
|
#
|
|
# /*% foo */
|
|
#
|
|
# expands to
|
|
#
|
|
# /*! \brief foo */
|
|
#
|
|
# and
|
|
#
|
|
# /*%< foo */
|
|
#
|
|
# expands to
|
|
#
|
|
# /*!< \brief foo */
|
|
#
|
|
s{/\*%(<?)}{/*!$1 \\brief }g;
|
|
|
|
# Doxygen appears to strip trailing newlines when reading files
|
|
# directly but not when reading from an input filter. Go figure.
|
|
# Future versions of Doxygen might change this, be warned.
|
|
#
|
|
s{\n+\z}{};
|
|
|
|
# Done, send the result to Doxygen.
|
|
#
|
|
print;
|