Document ideal configure.ac structure

.github/workflows/quick.yaml

@@ -171,7 +171,7 @@ jobs:
         uses: actions/upload-artifact@v4
         with:
           name: build-logs-${{ matrix.os }}-${{ matrix.compiler.CC }}-${{ matrix.layer.nick }}
-          path: btlayer-*.log
+          path: "**/*.log"
 
   CodeQL-tests:
 

.github/workflows/slow.yaml

@@ -41,9 +41,8 @@ jobs:
           - opensuse-tumbleweed
           - ubuntu-focal
           - ubuntu-jammy
-          - ubuntu-noble # EOL 2036-04
-          - ubuntu-oracular # EOL 2025-07
-          - ubuntu-plucky
+          - ubuntu-noble
+          - ubuntu-questing
         compiler:
           - { CC: gcc, CXX: g++ }
           - { CC: clang, CXX: clang++ }
@@ -84,7 +83,7 @@ jobs:
         uses: actions/upload-artifact@v4
         with:
           name: build-logs-${{ matrix.os }}-${{ matrix.compiler.CC }}-${{ matrix.layer.nick }}
-          path: btlayer-*.log
+          path: "**/*.log"
 
   macos:
     runs-on: macos-14
@@ -140,53 +139,82 @@ jobs:
         uses: actions/upload-artifact@v4
         with:
           name: build-logs-macos
-          path: btlayer-*.log
+          path: "**/*.log"
 
   freebsd:
     strategy:
       matrix:
         osversion:
-          - 14.3
+          - "15.0"
+          - "14.3"
+          - "13.5"
+        platform:
+          - amd64
+          # We are ready to support multiple platforms, but
+          # - arm64 is too slow as of 2026-02 (> 6 hours per run, GitHub times out)
+          # - riscv64 not working as of 2026-02 (GitHub image is incomplete)
+          # We expect these problems to be solved some time soon.
+    runs-on: "${{ matrix.platform != 'arm64' && 'ubuntu-24.04' || 'ubuntu-24.04-arm' }}"
 
-    runs-on: ubuntu-24.04
-    name: freebsd(${{ matrix.osversion }})
+    name: freebsd(${{ matrix.osversion }},${{ matrix.platform }})
 
     steps:
       - name: Checkout Sources
         uses: actions/checkout@v4
 
+      - name: Setup ccache
+        uses: hendrikmuhs/ccache-action@v1.2.19
+        with:
+          verbose: 2 # default 0
+          key: ${{ github.job }}-${{ matrix.osversion }}-${{ matrix.platform }}
+          max-size: "250MB"
+          evict-old-files: "28d"
+
       - name: Run test-builds
         id: test-builds
         uses: vmactions/freebsd-vm@v1
         with:
           usesh: true
-          release: ${{ matrix.osversion }}
+          sync: rsync
+          copyback: true
+          release: "${{ matrix.osversion }}"
+          arch: "${{ matrix.platform }}"
           prepare: |
-            pkg update
+            export BATCH=yes
+            which nproc > /dev/null && echo "MAKE_JOBS_NUMBER?=`nproc --all`" >> /etc/make.conf
+            echo "OPTIONS_UNSET=CUPS DEBUG DOCS FONTCONFIG NLS X11" >> /etc/make.conf
+            echo "WITHOUT_MODULES=sound ntfs linux" >> /etc/make.conf
+            echo "WITHOUT_X11=yes" >> /etc/make.conf
+            echo "NO_SENDMAIL=true" >> /etc/make.conf
+            echo "IGNORE_OSVERSION=yes" >> /usr/local/etc/pkg.conf
+
             pkg install -y \
               autoconf \
               autoconf-archive \
               automake \
-              bash \
+              ccache \
               cppunit \
               gmake \
               libltdl \
               libtool \
-              m4 \
               nettle \
-              pkgconf \
-              translate-toolkit
+              pkgconf
+            ccache --set-config=cache_dir="$GITHUB_WORKSPACE/.ccache"
+            ccache --set-config=max_size='250MB'
+            ccache --set-config=compression=true
 
           run: |
             export MAKE=gmake
-            ./test-builds.sh
+            export CC='ccache cc'
+            export CXX='ccache c++'
+            ./test-builds.sh layer-02-maximus
 
       - name: Publish build logs
         if: success() || failure()
         uses: actions/upload-artifact@v4
         with:
-          name: build-logs-freebsd-${{ matrix.osversion }}
-          path: btlayer-*.log
+          name: build-logs-freebsd-${{ matrix.osversion }}-${{ matrix.platform }}
+          path: "**/*.log"
 
   openbsd:
     runs-on: ubuntu-24.04
@@ -245,4 +273,4 @@ jobs:
         uses: actions/upload-artifact@v4
         with:
           name: build-logs-openbsd
-          path: btlayer-*.log
+          path: "**/*.log"

CONTRIBUTORS

@@ -440,6 +440,7 @@ Thank you!
     Reinhard Sojka <reinhard.sojka@parlament.gv.at>
     Rene Geile <rene.geile@t-online.de>
     Reuben Farrelly <reuben@reub.net>
+    Ricardo Ferreira Ribeiro <garb12@pm.me>
     Richard Huveneers <Richard.Huveneers@hekkihek.hacom.nl>
     Richard Huveneers <richard@hekkihek.hacom.nl>
     Richard Sharpe

COPYING

@@ -2,7 +2,7 @@
                        Version 2, June 1991
 
  Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
- 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+ <https://fsf.org/>
  Everyone is permitted to copy and distribute verbatim copies
  of this license document, but changing it is not allowed.
 
@@ -304,8 +304,7 @@ the "copyright" line and a pointer to where the full notice is found.
     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, write to the Free Software Foundation, Inc.,
-    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+    with this program; if not, see <https://www.gnu.org/licenses/>.
 
 Also add information on how to contact you by electronic and paper mail.
 
@@ -329,8 +328,8 @@ necessary.  Here is a sample; alter the names:
   Yoyodyne, Inc., hereby disclaims all copyright interest in the program
   `Gnomovision' (which makes passes at compilers) written by James Hacker.
 
-  <signature of Ty Coon>, 1 April 1989
-  Ty Coon, President of Vice
+  <signature of Moe Ghoul>, 1 April 1989
+  Moe Ghoul, President of Vice
 
 This General Public License does not permit incorporating your program into
 proprietary programs.  If your program is a subroutine library, you may

CREDITS

@@ -86,21 +86,21 @@ research project called The Harvest Information Discovery and Access System:
 
 acinclude/ax_cxx_compile_stdcxx.m4:
 
-#   Copyright (c) 2008 Benjamin Kosnik <bkoz@redhat.com>
-#   Copyright (c) 2012 Zack Weinberg <zackw@panix.com>
-#   Copyright (c) 2013 Roy Stogner <roystgnr@ices.utexas.edu>
-#   Copyright (c) 2014, 2015 Google Inc.; contributed by Alexey Sokolov <sokolov@google.com>
-#   Copyright (c) 2015 Paul Norman <penorman@mac.com>
-#   Copyright (c) 2015 Moritz Klammler <moritz@klammler.eu>
-#   Copyright (c) 2016, 2018 Krzesimir Nowak <qdlacz@gmail.com>
-#   Copyright (c) 2019 Enji Cooper <yaneurabeya@gmail.com>
-#   Copyright (c) 2020 Jason Merrill <jason@redhat.com>
-#   Copyright (c) 2021 Jörn Heusipp <osmanx@problemloesungsmaschine.de>
-#
-#   Copying and distribution of this file, with or without modification, are
-#   permitted in any medium without royalty provided the copyright notice
-#   and this notice are preserved. This file is offered as-is, without any
-#   warranty.
+dnl   Copyright (c) 2008 Benjamin Kosnik <bkoz@redhat.com>
+dnl   Copyright (c) 2012 Zack Weinberg <zackw@panix.com>
+dnl   Copyright (c) 2013 Roy Stogner <roystgnr@ices.utexas.edu>
+dnl   Copyright (c) 2014, 2015 Google Inc.; contributed by Alexey Sokolov <sokolov@google.com>
+dnl   Copyright (c) 2015 Paul Norman <penorman@mac.com>
+dnl   Copyright (c) 2015 Moritz Klammler <moritz@klammler.eu>
+dnl   Copyright (c) 2016, 2018 Krzesimir Nowak <qdlacz@gmail.com>
+dnl   Copyright (c) 2019 Enji Cooper <yaneurabeya@gmail.com>
+dnl   Copyright (c) 2020 Jason Merrill <jason@redhat.com>
+dnl   Copyright (c) 2021 Jörn Heusipp <osmanx@problemloesungsmaschine.de>
+dnl
+dnl   Copying and distribution of this file, with or without modification, are
+dnl   permitted in any medium without royalty provided the copyright notice
+dnl   and this notice are preserved. This file is offered as-is, without any
+dnl   warranty.
 
 ==============================================================================
 
@@ -117,26 +117,26 @@ dnl   and this notice are preserved.
 
 acinclude/pkg.m4:
 
-# Copyright © 2004 Scott James Remnant <scott@netsplit.com>.
-#
-# 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 2 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, write to the Free Software
-# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
-#
-# As a special exception to the GNU General Public License, if you
-# distribute this file as part of a program that contains a
-# configuration script generated by Autoconf, you may include it under
-# the same distribution terms that you use for the rest of that program.
+dnl Copyright © 2004 Scott James Remnant <scott@netsplit.com>.
+dnl
+dnl This program is free software; you can redistribute it and/or modify
+dnl it under the terms of the GNU General Public License as published by
+dnl the Free Software Foundation; either version 2 of the License, or
+dnl (at your option) any later version.
+dnl
+dnl This program is distributed in the hope that it will be useful, but
+dnl WITHOUT ANY WARRANTY; without even the implied warranty of
+dnl MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+dnl General Public License for more details.
+dnl
+dnl You should have received a copy of the GNU General Public License
+dnl along with this program; if not, write to the Free Software
+dnl Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+dnl
+dnl As a special exception to the GNU General Public License, if you
+dnl distribute this file as part of a program that contains a
+dnl configuration script generated by Autoconf, you may include it under
+dnl the same distribution terms that you use for the rest of that program.
 
 ==============================================================================
 
@@ -739,11 +739,7 @@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU Lesser General Public License for more details.
 
 You should have received a copy of the GNU Lesser General Public
-License along with GNU Libltdl; see the file COPYING.LIB.  If not, a
-copy can be downloaded from  http://www.gnu.org/licenses/lgpl.html,
-or obtained by writing to the Free Software Foundation, Inc.,
-51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
-
+License along with GNU Libltdl.  If not, see <https://www.gnu.org/licenses/>.
 
 ==============================================================================
 

acinclude/ax_cxx_compile_stdcxx.m4

@@ -1,54 +1,54 @@
-## Copyright (C) 1996-2026 The Squid Software Foundation and contributors
-##
-## Squid software is distributed under GPLv2+ license and includes
-## contributions from numerous individuals and organizations.
-## Please see the COPYING and CONTRIBUTORS files for details.
-##
-
-# ===========================================================================
-#  https://www.gnu.org/software/autoconf-archive/ax_cxx_compile_stdcxx.html
-# ===========================================================================
-#
-# SYNOPSIS
-#
-#   AX_CXX_COMPILE_STDCXX(VERSION, [ext|noext], [mandatory|optional])
-#
-# DESCRIPTION
-#
-#   Check for baseline language coverage in the compiler for the specified
-#   version of the C++ standard.  If necessary, add switches to CXX and
-#   CXXCPP to enable support.  VERSION may be '11', '14', '17', or '20' for
-#   the respective C++ standard version.
-#
-#   The second argument, if specified, indicates whether you insist on an
-#   extended mode (e.g. -std=gnu++11) or a strict conformance mode (e.g.
-#   -std=c++11).  If neither is specified, you get whatever works, with
-#   preference for no added switch, and then for an extended mode.
-#
-#   The third argument, if specified 'mandatory' or if left unspecified,
-#   indicates that baseline support for the specified C++ standard is
-#   required and that the macro should error out if no mode with that
-#   support is found.  If specified 'optional', then configuration proceeds
-#   regardless, after defining HAVE_CXX${VERSION} if and only if a
-#   supporting mode is found.
-#
-# LICENSE
-#
-#   Copyright (c) 2008 Benjamin Kosnik <bkoz@redhat.com>
-#   Copyright (c) 2012 Zack Weinberg <zackw@panix.com>
-#   Copyright (c) 2013 Roy Stogner <roystgnr@ices.utexas.edu>
-#   Copyright (c) 2014, 2015 Google Inc.; contributed by Alexey Sokolov <sokolov@google.com>
-#   Copyright (c) 2015 Paul Norman <penorman@mac.com>
-#   Copyright (c) 2015 Moritz Klammler <moritz@klammler.eu>
-#   Copyright (c) 2016, 2018 Krzesimir Nowak <qdlacz@gmail.com>
-#   Copyright (c) 2019 Enji Cooper <yaneurabeya@gmail.com>
-#   Copyright (c) 2020 Jason Merrill <jason@redhat.com>
-#   Copyright (c) 2021 Jörn Heusipp <osmanx@problemloesungsmaschine.de>
-#
-#   Copying and distribution of this file, with or without modification, are
-#   permitted in any medium without royalty provided the copyright notice
-#   and this notice are preserved.  This file is offered as-is, without any
-#   warranty.
+dnl Copyright (C) 1996-2026 The Squid Software Foundation and contributors
+dnl
+dnl Squid software is distributed under GPLv2+ license and includes
+dnl contributions from numerous individuals and organizations.
+dnl Please see the COPYING and CONTRIBUTORS files for details.
+dnl
+
+dnl ===========================================================================
+dnl  https://www.gnu.org/software/autoconf-archive/ax_cxx_compile_stdcxx.html
+dnl ===========================================================================
+dnl
+dnl SYNOPSIS
+dnl
+dnl   AX_CXX_COMPILE_STDCXX(VERSION, [ext|noext], [mandatory|optional])
+dnl
+dnl DESCRIPTION
+dnl
+dnl   Check for baseline language coverage in the compiler for the specified
+dnl   version of the C++ standard.  If necessary, add switches to CXX and
+dnl   CXXCPP to enable support.  VERSION may be '11', '14', '17', or '20' for
+dnl   the respective C++ standard version.
+dnl
+dnl   The second argument, if specified, indicates whether you insist on an
+dnl   extended mode (e.g. -std=gnu++11) or a strict conformance mode (e.g.
+dnl   -std=c++11).  If neither is specified, you get whatever works, with
+dnl   preference for no added switch, and then for an extended mode.
+dnl
+dnl   The third argument, if specified 'mandatory' or if left unspecified,
+dnl   indicates that baseline support for the specified C++ standard is
+dnl   required and that the macro should error out if no mode with that
+dnl   support is found.  If specified 'optional', then configuration proceeds
+dnl   regardless, after defining HAVE_CXX${VERSION} if and only if a
+dnl   supporting mode is found.
+dnl
+dnl LICENSE
+dnl
+dnl   Copyright (c) 2008 Benjamin Kosnik <bkoz@redhat.com>
+dnl   Copyright (c) 2012 Zack Weinberg <zackw@panix.com>
+dnl   Copyright (c) 2013 Roy Stogner <roystgnr@ices.utexas.edu>
+dnl   Copyright (c) 2014, 2015 Google Inc.; contributed by Alexey Sokolov <sokolov@google.com>
+dnl   Copyright (c) 2015 Paul Norman <penorman@mac.com>
+dnl   Copyright (c) 2015 Moritz Klammler <moritz@klammler.eu>
+dnl   Copyright (c) 2016, 2018 Krzesimir Nowak <qdlacz@gmail.com>
+dnl   Copyright (c) 2019 Enji Cooper <yaneurabeya@gmail.com>
+dnl   Copyright (c) 2020 Jason Merrill <jason@redhat.com>
+dnl   Copyright (c) 2021 Jörn Heusipp <osmanx@problemloesungsmaschine.de>
+dnl
+dnl   Copying and distribution of this file, with or without modification, are
+dnl   permitted in any medium without royalty provided the copyright notice
+dnl   and this notice are preserved.  This file is offered as-is, without any
+dnl   warranty.
 
 #serial 15
 

acinclude/ax_with_prog.m4

@@ -1,9 +1,9 @@
-## Copyright (C) 1996-2026 The Squid Software Foundation and contributors
-##
-## Squid software is distributed under GPLv2+ license and includes
-## contributions from numerous individuals and organizations.
-## Please see the COPYING and CONTRIBUTORS files for details.
-##
+dnl Copyright (C) 1996-2026 The Squid Software Foundation and contributors
+dnl
+dnl Squid software is distributed under GPLv2+ license and includes
+dnl contributions from numerous individuals and organizations.
+dnl Please see the COPYING and CONTRIBUTORS files for details.
+dnl
 
 dnl ===========================================================================
 dnl              http://autoconf-archive.cryp.to/ax_with_prog.html