bind9/doc/dev/autoconf

<!--
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.
-->

Here are some hints on how to use autoconf correctly when doing
BIND 9 development.

Never edit the configure script directly.  Edit configure.in, commit
the changes, run "autoconf", and commit the new configure.  Doing two
separate commits ensures that the version numbers embedded in the
configure script are correct.

Don't edit config.h.in directly.  Instead, run "autoheader".  If it
complains about missing definitions, add them to acconfig.h, rerun
autoheader, commit acconfig.h if edited, and commit the generated
config.h.in.
Update the copyright information in all files in the repository 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. (cherry picked from commit 58bd26b6cf7bac3f614b6614cd2aff6075b6f9fa) 2021-06-03 02:37:05 -04:00			`<!--`
update file headers 2018-03-15 21:32:45 -04:00			`Copyright (C) Internet Systems Consortium, Inc. ("ISC")`
4401. [misc] Change LICENSE to MPL 2.0. 2016-06-27 00:56:38 -04:00
Update the copyright information in all files in the repository 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. (cherry picked from commit 58bd26b6cf7bac3f614b6614cd2aff6075b6f9fa) 2021-06-03 02:37:05 -04:00			`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.`
			`-->`
Update license headers to not include years in copyright in all applicable files 2018-02-23 03:53:12 -05:00
created 2001-10-22 19:00:21 -04:00			`Here are some hints on how to use autoconf correctly when doing`
			`BIND 9 development.`

			`Never edit the configure script directly. Edit configure.in, commit`
			`the changes, run "autoconf", and commit the new configure. Doing two`
			`separate commits ensures that the version numbers embedded in the`
			`configure script are correct.`

			`Don't edit config.h.in directly. Instead, run "autoheader". If it`
			`complains about missing definitions, add them to acconfig.h, rerun`
edited 2001-10-22 19:03:43 -04:00			`autoheader, commit acconfig.h if edited, and commit the generated`
			`config.h.in.`