Move all task from debian/configure into normal debian/* files

Using the 'nodoc' Debian package profile and build option to
control the creation of documentation packages.

Updated minmum debhelper compat level from 9 to 10, matching the level
in Debian Buster.  Drop code to set higher compat level on newer versions
of Debian.

Uses versioned alternative depends to control the readline and
texlive-xetex build dependency.

Updated all build scripts and documentation to reflect that the
debian/configure script is obsolete.

Author: smoe

debian/.gitignore

@@ -1,8 +1,5 @@
 linuxcnc-uspace
 files
-rules
-compat
-control
 tmp
 linuxcnc
 linuxcnc-dev
@@ -16,9 +13,7 @@ linuxcnc-uspace.manpages
 
 *.debhelper
 shlibs.local
-linuxcnc-uspace.lintian-overrides
 
 autoreconf.after
 autoreconf.before
 debhelper-build-stamp
-

debian/compat

@@ -0,0 +1 @@
+10

debian/configure

@@ -14,25 +14,11 @@ set -e
 
 usage () {
     P=${0##*/}
-    cat 1>&2 <<EOF
-$P: Set up debian/ files to build for a particular kernel
+    cat <<EOF
+$P: Obsolete script to set up debian/ files to build for a particular kernel
 
 Usage:
-  $P [no-docs]
-
-  Extra options:
-
-    no-docs|nodocs
-        Skip building documentation.
-        Debian packaging will not know about documentation to exist at all.
-        If configured regularly but with the intent not to build the docs,
-        run "DEB_BUILD_OPTIONS=nodocs dpkg-buildpackage".
-
-    sim|uspace|noauto
-        Accepted for compatibility, but now ignored.
-
-    -h|--help|help
-	Show this help.
+  $P
 EOF
 }
 
@@ -43,11 +29,7 @@ if [ "$1" == "-h" ] || [ "$1" == "-help" ] || [ "$1" == "--help" ]; then
     exit 0
 fi
 
-EXTRA_BUILD=
-PYTHON_VERSION_NEXT=$(python3 -c 'import sys; print (sys.version[:2] + str(1+int(sys.version[2])))')
-LIBREADLINE_DEV="libeditreadline-dev | libreadline-gplv2-dev | libreadline-dev"
-
-ENABLE_BUILD_DOCUMENTATION=--enable-build-documentation=pdf
+ENABLE_BUILD_DOCUMENTATION=yes
 
 # Specialize these based on DISTRIB_NAME as needed
 # These do not run-time depend on a specific package because
@@ -83,131 +65,15 @@ elif [ -f /etc/lsb-release ]; then
     DISTRIB_NAME=$DISTRIB_ID-$DISTRIB_RELEASE
 fi
 
-if [ -n "$ENABLE_BUILD_DOCUMENTATION" ]; then
-    DOC_DEPENDS="dblatex (>= 0.2.12),\n    dvipng,\n    fonts-dejavu,\n    graphviz,\n    groff,\n    inkscape,\n    python3-lxml,\n    source-highlight,\n    texlive-extra-utils,\n    texlive-font-utils,\n    texlive-fonts-recommended,\n    texlive-lang-cyrillic,\n    texlive-lang-european,\n    texlive-lang-french,\n    texlive-lang-german,\n    texlive-lang-polish,\n    texlive-lang-spanish,\n    texlive-latex-recommended,\n    w3c-linkchecker,\n    xsltproc"
-    
-
-    case $DISTRIB_NAME in
-	Debian-9)
-	    ;; # No xetex in Debian 9 Stretch
-	*)
-	    # Not quite sure which packages is needed for xetex, but
-	    # texlive-xetex seem like a safe choice.  Need xetex to be
-	    # able to build Chinese PDF.
-	    DOC_DEPENDS="$DOC_DEPENDS,\n    texlive-xetex"
-	    ;;
-    esac
-else
-    DOC_DEPENDS=''
-fi
-
-MODUTILS_DEPENDS=kmod
-PYTHON_PACKAGING_DEPENDS=dh-python
-PYTHON_GST=python3-gst-1.0,gstreamer1.0-plugins-base
-TCLTK_VERSION=8.6
-PYTHON_IMAGING=python3-pil
-PYTHON_IMAGING_TK=python3-pil.imagetk
-QTVCP_DEPENDS="python3-pyqt5,\n    python3-pyqt5.qsci,\n    python3-pyqt5.qtsvg,\n    python3-pyqt5.qtopengl,\n    python3-opencv,\n    python3-dbus,\n    python3-espeak,\n    python3-dbus.mainloop.pyqt5,\n    python3-pyqt5.qtwebengine,\n    espeak-ng,\n    pyqt5-dev-tools,\n    gstreamer1.0-tools,\n    espeak,\n    sound-theme-freedesktop,\n    python3-poppler-qt5"
-YAPPS_RUNTIME="python3-yapps"
-DEBHELPER="debhelper (>= 12)"
-COMPAT="12"
-
-case $DISTRIB_NAME in
-    Ubuntu-25.*|Ubuntu-24.*|Ubuntu-21.*|Debian-11|Debian-11.*|Debian-12|Debian-12.*|Debian-13|Debian-13.*|Debian-testing|Debian-unstable)
-        LIBREADLINE_DEV=libeditreadline-dev
-        COMPAT=""
-        DEBHELPER="debhelper-compat (= 13)"
-        ;;
-    Ubuntu-20.*)
-        ;;
-    Debian-10|Debian-10.*|Raspbian-10|Raspbian-10.*)
-        ;;
-    *)
-        echo "unknown distribution: $DISTRIB_NAME"
-        echo "detected dependencies may be incomplete or wrong"
-        echo "please consider fixing it and submitting a pull request"
-        ;;
-esac
-
-TARGET=uspace
-EXTRA_RECOMMENDS=hostmot2-firmware-all
-MODULE_PATH=usr/lib/linuxcnc/modules
-MODULE_EXT=.so
-KERNEL_DEPENDS=libudev-dev,iptables
-KERNEL_DEPENDS_BUILD=libudev-dev
-KERNEL_HEADERS=
-KERNEL_VERSION=uspace
-MODUTILS_DEPENDS=
-if false; then
-MAIN_PACKAGE_NAME=linuxcnc
-OTHER_MAIN_PACKAGE_NAME=linuxcnc-uspace
-else
 DISTRIB_NAME=uspace-$DISTRIB_NAME
-MAIN_PACKAGE_NAME=linuxcnc-uspace
-OTHER_MAIN_PACKAGE_NAME=linuxcnc
-fi
-
-EXTRA_RECOMMENDS="$EXTRA_RECOMMENDS, linux-image-rt-amd64 [linux-amd64], linux-image-rt-686-pae [linux-i386]"
-CONFIGURE_REALTIME_ARG=--with-realtime=uspace
 
-subst () {
-sed \
-    -e "s#@COMPAT@#$COMPAT#g" \
-    -e "s#@DEBHELPER@#$DEBHELPER#g" \
-    -e "s#@DISTRIB_NAME@#$DISTRIB_NAME#g" \
-    -e "s#@DOC_DEPENDS@#$DOC_DEPENDS#g" \
-    -e "s#@EXTRA_BUILD@#$EXTRA_BUILD#g" \
-    -e "s#@EXTRA_RECOMMENDS@#$EXTRA_RECOMMENDS#g" \
-    -e "s#@KERNEL_DEPENDS@#$KERNEL_DEPENDS#g" \
-    -e "s#@KERNEL_DEPENDS_BUILD@#$KERNEL_DEPENDS_BUILD#g" \
-    -e "s#@KERNEL_HEADERS@#$KERNEL_HEADERS#g" \
-    -e "s#@KERNEL_VERSION@#$KERNEL_VERSION#g" \
-    -e "s#@LIBREADLINE_DEV@#$LIBREADLINE_DEV#g" \
-    -e "s#@MAIN_PACKAGE_NAME@#$MAIN_PACKAGE_NAME#g" \
-    -e "s#@MODULE_EXT@#$MODULE_EXT#g" \
-    -e "s#@MODULE_PATH@#$MODULE_PATH#g" \
-    -e "s#@MODUTILS_DEPENDS@#$MODUTILS_DEPENDS#g" \
-    -e "s#@OTHER_MAIN_PACKAGE_NAME@#$OTHER_MAIN_PACKAGE_NAME#g" \
-    -e "s#@PYTHON_GST@#$PYTHON_GST#g" \
-    -e "s#@PYTHON_IMAGING@#$PYTHON_IMAGING#g" \
-    -e "s#@PYTHON_IMAGING_TK@#$PYTHON_IMAGING_TK#g" \
-    -e "s#@PYTHON_PACKAGING_DEPENDS@#$PYTHON_PACKAGING_DEPENDS#g" \
-    -e "s#@PYTHON_VERSION_NEXT@#$PYTHON_VERSION_NEXT#g" \
-    -e "s#@QTVCP_DEPENDS@#$QTVCP_DEPENDS#g" \
-    -e "s#@RTAI_ARCHITECTURE@#$RTAI_ARCHITECTURE#g" \
-    -e "s#@TARGET@#$TARGET#g" \
-    -e "s#@CONFIGURE_REALTIME_ARG@#$CONFIGURE_REALTIME_ARG#g" \
-    -e "s#@TCLTK_VERSION@#$TCLTK_VERSION#g" \
-    -e "s#@XENOMAI_ARCHITECTURE@#$XENOMAI_ARCHITECTURE#g" \
-    -e "s|@YAPPS_RUNTIME@|$YAPPS_RUNTIME|g" \
-    -e "s#@ENABLE_BUILD_DOCUMENTATION@#$ENABLE_BUILD_DOCUMENTATION#g" \
-    -e '/^\s*,\s*$/d' \
-    "$@"
-}
-
-if [[ -z "${COMPAT}" ]]; then
-    rm -f compat
-else
-    subst compat.in > compat
+if [ -z "$ENABLE_BUILD_DOCUMENTATION" ]; then
+    echo "error: No need to run debian/configure any more."
+    echo "To build without documentation use:"
+    echo "   DEB_BUILD_OPTIONS=nodoc DEB_BUILD_PROFILES=nodoc debuild"
+    exit 1
 fi
 
-subst control.top.in > control
-
-echo >> control
-subst control.main-pkg.in >> control
-
-subst linuxcnc.install.in > ${MAIN_PACKAGE_NAME}.install
-subst linuxcnc.lintian-overrides.in > ${MAIN_PACKAGE_NAME}.lintian-overrides
-subst linuxcnc.manpages.in > ${MAIN_PACKAGE_NAME}.manpages
-
-subst rules.in > rules
-chmod +x rules
-
-if [ -n "$ENABLE_BUILD_DOCUMENTATION" ]; then
-    subst control.docs.in >> control
-fi
-
-
 rm -f ../build-stamp
 echo "I: Successfully configured for '$DISTRIB_NAME'."