23 files changed, 0 insertions, 540 deletions

diff --git a/documentation/tools/Containerfile.almalinux b/documentation/tools/Containerfile.almalinux
deleted file mode 120000
index 7237e9b99f..0000000000
--- a/documentation/tools/Containerfile.almalinux
+++ /dev/null
@@ -1 +0,0 @@
-Containerfile.dnf
\ No newline at end of file
diff --git a/documentation/tools/Containerfile.apt b/documentation/tools/Containerfile.apt
deleted file mode 100644
index a573786f06..0000000000
--- a/documentation/tools/Containerfile.apt
+++ /dev/null
@@ -1,30 +0,0 @@
-ARG ARG_FROM=debian:12 # default value to avoid warning
-FROM $ARG_FROM
-
-ARG INCLUDE_ESSENTIAL_PACKAGES=0
-ARG ESSENTIAL=ubuntu_essential.sh
-ARG DOCS=ubuntu_docs.sh
-ARG DOCS_PDF=ubuntu_docs_pdf.sh
-
-ENV DEBIAN_FRONTEND=noninteractive
-ARG TZ=Europe/Vienna
-
-# relative to the location of the dockerfile
-COPY --chmod=777 ${ESSENTIAL} /temp/host_packages_essential.sh
-COPY --chmod=777 ${DOCS} /temp/host_packages_docs.sh
-COPY --chmod=777 ${DOCS_PDF} /temp/host_packages_docs_pdf.sh
-
-RUN ln -fs "/usr/share/zoneinfo/$TZ" /etc/localtime \
- && apt-get update \
- && apt-get install -y sudo \
- && if [ "$INCLUDE_ESSENTIAL_PACKAGES" = "1" ]; then yes | /temp/host_packages_essential.sh; fi \
- && yes | /temp/host_packages_docs.sh \
- && yes | /temp/host_packages_docs_pdf.sh \
- && apt-get --yes autoremove \
- && apt-get clean \
- && rm -rf /temp
-
-RUN git config --global --add safe.directory /docs
-
-ENTRYPOINT ["/usr/bin/env", "make", "-C", "documentation/"]
-CMD ["publish"]
diff --git a/documentation/tools/Containerfile.debian b/documentation/tools/Containerfile.debian
deleted file mode 120000
index 5a7a425197..0000000000
--- a/documentation/tools/Containerfile.debian
+++ /dev/null
@@ -1 +0,0 @@
-Containerfile.apt
\ No newline at end of file
diff --git a/documentation/tools/Containerfile.dnf b/documentation/tools/Containerfile.dnf
deleted file mode 100644
index 65c5267054..0000000000
--- a/documentation/tools/Containerfile.dnf
+++ /dev/null
@@ -1,29 +0,0 @@
-ARG ARG_FROM=fedora:40 # default value to avoid warning
-FROM $ARG_FROM
-
-ARG INCLUDE_ESSENTIAL_PACKAGES=0
-ARG ESSENTIAL=fedora_essential.sh
-ARG DOCS=fedora_docs.sh
-ARG DOCS_PDF=fedora_docs_pdf.sh
-ARG PIP3=pip3_docs.sh
-
-# relative to the location of the dockerfile
-COPY --chmod=777 ${ESSENTIAL} /temp/host_packages_essential.sh
-COPY --chmod=777 ${DOCS} /temp/host_packages_docs.sh
-COPY --chmod=777 ${DOCS_PDF} /temp/host_packages_docs_pdf.sh
-COPY --chmod=777 ${PIP3} /temp/pip3_docs.sh
-
-RUN dnf update -y \
- && dnf install -y sudo \
- && if [ "$INCLUDE_ESSENTIAL_PACKAGES" = "1" ]; then yes | /temp/host_packages_essential.sh; fi \
- && yes | /temp/host_packages_docs.sh \
- && yes | /temp/host_packages_docs_pdf.sh \
- && yes | /temp/pip3_docs.sh \
- && dnf autoremove -y \
- && dnf clean all -y \
- && rm -rf /temp
-
-RUN git config --global --add safe.directory /docs
-
-ENTRYPOINT ["/usr/bin/env", "make", "-C", "documentation/"]
-CMD ["publish"]
diff --git a/documentation/tools/Containerfile.fedora b/documentation/tools/Containerfile.fedora
deleted file mode 120000
index 7237e9b99f..0000000000
--- a/documentation/tools/Containerfile.fedora
+++ /dev/null
@@ -1 +0,0 @@
-Containerfile.dnf
\ No newline at end of file
diff --git a/documentation/tools/Containerfile.ubuntu b/documentation/tools/Containerfile.ubuntu
deleted file mode 120000
index 5a7a425197..0000000000
--- a/documentation/tools/Containerfile.ubuntu
+++ /dev/null
@@ -1 +0,0 @@
-Containerfile.apt
\ No newline at end of file
diff --git a/documentation/tools/Containerfile.zypper b/documentation/tools/Containerfile.zypper
deleted file mode 100644
index 3850b9ff9e..0000000000
--- a/documentation/tools/Containerfile.zypper
+++ /dev/null
@@ -1,36 +0,0 @@
-ARG ARG_FROM=opensuse/leap:15.4 # default value to avoid warning
-FROM $ARG_FROM
-
-ARG INCLUDE_ESSENTIAL_PACKAGES=0
-ARG ESSENTIAL=opensuse_essential.sh
-ARG DOCS=opensuse_docs.sh
-ARG DOCS_PDF=opensuse_docs_pdf.sh
-ARG PIP3=pip3_docs.sh
-
-# relative to the location of the dockerfile
-COPY --chmod=777 ${ESSENTIAL} /temp/host_packages_essential.sh
-COPY --chmod=777 ${DOCS} /temp/host_packages_docs.sh
-COPY --chmod=777 ${DOCS_PDF} /temp/host_packages_docs_pdf.sh
-COPY --chmod=777 ${PIP3} /temp/pip3_docs.sh
-
-# Zypper doesn't have environment variables to specify whether to run in
-# non-interactive mode like Debian does with DEBIAN_FRONTEND and piping yes to
-# the scripts doesn't need to be enough as well, so let's force all zypper calls
-# to be non-interactive by adding the appropriate flag in the scripts.
-RUN for script in /temp/*.sh; do \
-        sed -i 's/zypper/zypper --non-interactive/' $script; \
-    done
-
-RUN zypper update -y \
- && zypper install -y sudo \
- && if [ "$INCLUDE_ESSENTIAL_PACKAGES" = "1" ]; then yes | /temp/host_packages_essential.sh; fi \
- && yes | /temp/host_packages_docs.sh \
- && yes | /temp/host_packages_docs_pdf.sh \
- && yes | /temp/pip3_docs.sh \
- && zypper clean --all \
- && rm -rf /temp
-
-RUN git config --global --add safe.directory /docs
-
-ENTRYPOINT ["/usr/bin/env", "make", "-C", "documentation/"]
-CMD ["publish"]
diff --git a/documentation/tools/build-docs-container b/documentation/tools/build-docs-container
deleted file mode 100755
index f97cfc4025..0000000000
--- a/documentation/tools/build-docs-container
+++ /dev/null
@@ -1,175 +0,0 @@
-#!/usr/bin/env bash
-# -*- vim: set expandtab tabstop=2 shiftwidth=2:
-#
-# Build a container ready to build the documentation be reading the dependencies
-# listed in shell scripts in documentation/tools/host_packages_scripts, and
-# start a documentation build in this container.
-#
-# Usage:
-#
-#   ./documentation/tools/build-docs-container <image> [<make target>]
-#
-# e.g.:
-#
-#   ./documentation/tools/build-docs-container ubuntu:24.04 html
-#
-# Will build the docs in an Ubuntu 24.04 container in html.
-#
-# The container engine can be selected by exporting CONTAINERCMD in the
-# environment. The default is docker, but podman can also be used.
-
-set -eu -o pipefail
-
-SCRIPT_DIR=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" &>/dev/null && pwd)
-CONTAINERCMD=${CONTAINERCMD:-docker}
-DOCS_DIR="$SCRIPT_DIR/../.."
-SH_DIR="$SCRIPT_DIR/host_packages_scripts"
-INCLUDE_ESSENTIAL_PACKAGES=${INCLUDE_ESSENTIAL_PACKAGES:-0}
-
-function usage()
-{
-  echo "$0 -- script to build documentation from within a container
-
-$0 OCI_IMAGE [make arguments...]
-
-   OCI_IMAGE is an image:tag of an OCI image hosted on hub.docker.com. It is one
-   of:
-     - debian:12
-     - debian:13
-     - fedora:39
-     - fedora:40
-     - fedora:41
-     - fedora:42
-     - leap:15.5
-     - leap:15.6
-     - ubuntu:22.04
-     - ubuntu:24.04
-     - ubuntu:25.04
-
-   [make arguments] is one or more argument to pass to the make command of
-   documentation/Makefile, see that file for what's supported. This is typically
-   intended to be used to provide specific make targets.
-   Default: publish
-
-   Environment variables:
-
-   - CONTAINERCMD can be set to 'docker' or 'podman' to select the
-     container engine (default: 'docker').
-
-   - INCLUDE_ESSENTIAL_PACKAGES can be set to 0 or 1 to also include essential
-     packages listed in documentation/tools/host_packages_scripts/*_essential.sh.
-     This is not required to build the documentation but can be useful to validate
-     the installation of packages listed in these files (default: 0).
-"
-}
-
-main ()
-{
-  if [ "$#" -lt 1 ]; then
-    usage
-    exit 1
-  fi
-
-  local image="$1"
-  shift
-
-  OCI=$(which "$CONTAINERCMD")
-
-  # docker build doesn't accept 2 colons, so "sanitize" the name
-  local sanitized_dockername
-  sanitized_dockername=$(echo "$image" | tr ':.' '-')
-
-  local version
-  version=$(echo "$image" | awk -F: '{print $NF}')
-
-  case $image in
-    # Missing latexmk texlive-gnu-freefont packages at the very least
-    # "almalinux:8"*|\
-    # "almalinux:9"*)
-    #   containerfile=Containerfile.almalinux
-    #   docs=almalinux_docs.sh
-    #   docs_pdf=almalinux_docs_pdf.sh
-    #   pip3=pip3_docs.sh
-    #   ;;
-    # Missing python3-saneyaml
-    # "debian:11"*|\
-    "debian:12"*|\
-    "debian:13"*)
-      containerfile=Containerfile.debian
-      essential=ubuntu_essential.sh
-      docs=ubuntu_docs.sh
-      docs_pdf=ubuntu_docs_pdf.sh
-      ;;
-    "fedora:39"*|\
-    "fedora:40"*|\
-    "fedora:41"*|\
-    "fedora:42"*)
-      containerfile=Containerfile.fedora
-      essential=fedora_essential.sh
-      docs=fedora_docs.sh
-      docs_pdf=fedora_docs_pdf.sh
-      pip3=pip3_docs.sh
-      ;;
-    "leap:15.5"*|\
-    "leap:15.6"*)
-      image=opensuse/leap:$version
-      containerfile=Containerfile.zypper
-      essential=opensuse_essential.sh
-      docs=opensuse_docs.sh
-      docs_pdf=opensuse_docs_pdf.sh
-      pip3=pip3_docs.sh
-      ;;
-    "ubuntu:22.04"*|\
-    "ubuntu:24.04"*|\
-    "ubuntu:25.04"*)
-      containerfile=Containerfile.ubuntu
-      essential=ubuntu_essential.sh
-      docs=ubuntu_docs.sh
-      docs_pdf=ubuntu_docs_pdf.sh
-      ;;
-    *)
-      echo "$image not supported!"
-      usage
-      exit 1
-      ;;
-  esac
-
-  $OCI build \
-    --tag "yocto-docs-$sanitized_dockername:latest" \
-    --build-arg ARG_FROM="docker.io/$image" \
-    --build-arg INCLUDE_ESSENTIAL_PACKAGES="${INCLUDE_ESSENTIAL_PACKAGES}" \
-    --build-arg ESSENTIAL="$essential" \
-    --build-arg DOCS="$docs" \
-    --build-arg DOCS_PDF="$docs_pdf" \
-    --build-arg PIP3="${pip3:-}" \
-    --file "$SCRIPT_DIR/$containerfile" \
-    "$SH_DIR/"
-
-  local -a args_run=(
-    --rm
-    --interactive
-    --tty
-    --volume="$DOCS_DIR:/docs:rw"
-    --workdir=/docs
-    --security-opt label=disable
-  )
-
-  if [ "$(basename "$OCI")" = "docker" ]; then
-    args_run+=(
-      --user="$(id -u)":"$(id -g)"
-    )
-  elif [ "$(basename "$OCI")" = "podman" ]; then
-    # we need net access to fetch bitbake terms
-    args_run+=(
-      --cap-add=NET_RAW
-      --userns=keep-id
-    )
-  fi
-
-  $OCI run \
-    "${args_run[@]}" \
-    "yocto-docs-$sanitized_dockername" \
-    "$@"
-}
-
-main "$@"
diff --git a/documentation/tools/check-glossaries b/documentation/tools/check-glossaries
deleted file mode 100755
index b5dfe834e5..0000000000
--- a/documentation/tools/check-glossaries
+++ /dev/null
@@ -1,90 +0,0 @@
-#!/usr/bin/env python3
-
-import argparse
-import difflib
-import os
-import re
-
-from pathlib import Path
-
-
-def parse_arguments() -> argparse.Namespace:
-    parser = argparse.ArgumentParser(description="Print supported distributions")
-
-    parser.add_argument("-d", "--docs-dir",
-                        type=Path,
-                        default=Path(os.path.dirname(os.path.realpath(__file__))) / "documentation",
-                        help="Path to documentation/ directory in yocto-docs")
-
-    return parser.parse_args()
-
-
-glossaries = (
-    'ref-manual/variables.rst',
-    'ref-manual/terms.rst',
-)
-
-
-def main():
-
-    args = parse_arguments()
-    in_glossary = False
-    # Pattern to match:
-    # :term:`A <ABIEXTENSION>` :term:`B` :term:`C <CACHE>`
-    glossary_re = re.compile(r":term:`(?P<letter>[A-Z]{1})( <(?P<varname>[A-Z_]+)>)?`")
-    entry_re = re.compile(r"^   :term:`(?P<entry>.+)`\s*$")
-
-    for rst in glossaries:
-
-        glossary = {}
-        rst_path = Path(args.docs_dir) / rst
-
-        with open(rst_path, "r") as f:
-            for line in f.readlines():
-                if "check_glossary_begin" in line:
-                    in_glossary = True
-                    continue
-                if in_glossary:
-                    for m in re.finditer(glossary_re, line.strip()):
-                        letter = m.group("letter")
-                        varname = m.group("varname")
-                        if varname is None:
-                            varname = letter
-                        glossary[letter] = varname
-                if "check_glossary_end" in line:
-                    in_glossary = False
-                    break
-
-        entries = []
-
-        with open(rst_path, "r") as f:
-            for line in f.readlines():
-                m = re.match(entry_re, line)
-                if m:
-                    entries.append(m.group("entry"))
-
-        # We lower here because underscore (_) come before lowercase letters
-        # (the natural way) but after uppercase letters (which is not natural)
-        sorted_entries = sorted(entries, key=lambda t: t.lower())
-        diffs = list(difflib.unified_diff(entries,
-                                          sorted_entries,
-                                          fromfile="original_list",
-                                          tofile="sorted_list"))
-
-        if diffs:
-            print(f"WARNING: {rst}: entries are not properly sorted:")
-            print('\n'.join(diffs))
-
-        for letter in glossary:
-            try:
-                index = entries.index(glossary[letter])
-            except ValueError:
-                print(f"WARNING: {rst}: variable "
-                      f"{glossary[letter]} in glossary does not exist")
-            if index > 0 and entries[index - 1].startswith(letter[0]):
-                print(f"WARNING: {rst}: The variable {glossary[letter]} shouldn't be in "
-                     "the glossary.")
-
-
-if __name__ == "__main__":
-    main()
diff --git a/documentation/tools/host_packages_scripts/almalinux_docs.sh b/documentation/tools/host_packages_scripts/almalinux_docs.sh
deleted file mode 100644
index 8188d529a1..0000000000
--- a/documentation/tools/host_packages_scripts/almalinux_docs.sh
+++ /dev/null
@@ -1 +0,0 @@
-sudo dnf install git glibc-locale-source librsvg2-tools make python3-pip which
diff --git a/documentation/tools/host_packages_scripts/almalinux_docs_pdf.sh b/documentation/tools/host_packages_scripts/almalinux_docs_pdf.sh
deleted file mode 100644
index 8341eb8c25..0000000000
--- a/documentation/tools/host_packages_scripts/almalinux_docs_pdf.sh
+++ /dev/null
@@ -1 +0,0 @@
-sudo dnf install latexmk texlive-collection-fontsrecommended texlive-collection-latex texlive-collection-latexrecommended texlive-collection-xetex texlive-fncychap texlive-gnu-freefont texlive-tex-gyre texlive-xetex
diff --git a/documentation/tools/host_packages_scripts/almalinux_essential.sh b/documentation/tools/host_packages_scripts/almalinux_essential.sh
deleted file mode 100644
index 76c5280eeb..0000000000
--- a/documentation/tools/host_packages_scripts/almalinux_essential.sh
+++ /dev/null
@@ -1,5 +0,0 @@
-sudo dnf install -y epel-release
-sudo yum install dnf-plugins-core
-sudo dnf config-manager --set-enabled crb
-sudo dnf makecache
-sudo dnf install bzip2 ccache chrpath cpio cpp diffstat diffutils gawk gcc gcc-c++ git glibc-devel glibc-langpack-en gzip libacl make patch perl perl-Data-Dumper perl-Text-ParseWords perl-Thread-Queue python3 python3-GitPython python3-jinja2 python3-pexpect python3-pip rpcgen socat tar texinfo unzip wget which xz zstd
diff --git a/documentation/tools/host_packages_scripts/fedora_docs.sh b/documentation/tools/host_packages_scripts/fedora_docs.sh
deleted file mode 100644
index 8188d529a1..0000000000
--- a/documentation/tools/host_packages_scripts/fedora_docs.sh
+++ /dev/null
@@ -1 +0,0 @@
-sudo dnf install git glibc-locale-source librsvg2-tools make python3-pip which
diff --git a/documentation/tools/host_packages_scripts/fedora_docs_pdf.sh b/documentation/tools/host_packages_scripts/fedora_docs_pdf.sh
deleted file mode 100644
index 816f1c36ec..0000000000
--- a/documentation/tools/host_packages_scripts/fedora_docs_pdf.sh
+++ /dev/null
@@ -1 +0,0 @@
-sudo dnf install 'texlive-collection-lang*' latexmk texlive-collection-fontsextra texlive-collection-fontsrecommended texlive-collection-latex texlive-collection-latexextra texlive-collection-latexrecommended texlive-collection-xetex texlive-fncychap texlive-gnu-freefont texlive-tex-gyre texlive-xetex
diff --git a/documentation/tools/host_packages_scripts/fedora_essential.sh b/documentation/tools/host_packages_scripts/fedora_essential.sh
deleted file mode 100644
index 99e5d2c0b0..0000000000
--- a/documentation/tools/host_packages_scripts/fedora_essential.sh
+++ /dev/null
@@ -1 +0,0 @@
-sudo dnf install bzip2 ccache chrpath cpio cpp diffstat diffutils file findutils gawk gcc gcc-c++ git glibc-devel glibc-langpack-en gzip hostname libacl make patch perl perl-Data-Dumper perl-File-Compare perl-File-Copy perl-FindBin perl-Text-ParseWords perl-Thread-Queue perl-bignum perl-locale python python3 python3-GitPython python3-jinja2 python3-pexpect python3-pip rpcgen socat tar texinfo unzip wget which xz zstd $([ $(rpm -E %fedora) -ge 42 ] && echo "util-linux-script")
diff --git a/documentation/tools/host_packages_scripts/opensuse_docs.sh b/documentation/tools/host_packages_scripts/opensuse_docs.sh
deleted file mode 100644
index 7d36eb0f99..0000000000
--- a/documentation/tools/host_packages_scripts/opensuse_docs.sh
+++ /dev/null
@@ -1 +0,0 @@
-sudo zypper install git glibc-i18ndata make python3-pip rsvg-convert which
diff --git a/documentation/tools/host_packages_scripts/opensuse_docs_pdf.sh b/documentation/tools/host_packages_scripts/opensuse_docs_pdf.sh
deleted file mode 100644
index ee9f07886c..0000000000
--- a/documentation/tools/host_packages_scripts/opensuse_docs_pdf.sh
+++ /dev/null
@@ -1 +0,0 @@
-sudo zypper install 'texlive-collection-lang*' texlive-collection-fontsextra texlive-collection-fontsrecommended texlive-collection-latex texlive-collection-latexextra texlive-collection-latexrecommended texlive-collection-xetex texlive-fncychap texlive-gnu-freefont texlive-latexmk texlive-tex-gyre texlive-xetex
diff --git a/documentation/tools/host_packages_scripts/opensuse_essential.sh b/documentation/tools/host_packages_scripts/opensuse_essential.sh
deleted file mode 100644
index 0d37e9bd5a..0000000000
--- a/documentation/tools/host_packages_scripts/opensuse_essential.sh
+++ /dev/null
@@ -1,2 +0,0 @@
-sudo zypper install bzip2 chrpath diffstat gcc gcc-c++ git gzip hostname libacl1 make makeinfo patch python python-curses python-xml python3 python3-Jinja2 python3-curses python3-pexpect python3-pip rpcgen socat tar wget which xz zstd
-sudo pip3 install GitPython
diff --git a/documentation/tools/host_packages_scripts/pip3_docs.sh b/documentation/tools/host_packages_scripts/pip3_docs.sh
deleted file mode 100644
index fd6ad98053..0000000000
--- a/documentation/tools/host_packages_scripts/pip3_docs.sh
+++ /dev/null
@@ -1 +0,0 @@
-sudo pip3 install sphinx sphinx_rtd_theme pyyaml
diff --git a/documentation/tools/host_packages_scripts/ubuntu_docs.sh b/documentation/tools/host_packages_scripts/ubuntu_docs.sh
deleted file mode 100644
index d2a1832e27..0000000000
--- a/documentation/tools/host_packages_scripts/ubuntu_docs.sh
+++ /dev/null
@@ -1 +0,0 @@
-sudo apt install git librsvg2-bin locales make python3-saneyaml python3-saneyaml python3-sphinx-rtd-theme sphinx
diff --git a/documentation/tools/host_packages_scripts/ubuntu_docs_pdf.sh b/documentation/tools/host_packages_scripts/ubuntu_docs_pdf.sh
deleted file mode 100644
index d6310bd21d..0000000000
--- a/documentation/tools/host_packages_scripts/ubuntu_docs_pdf.sh
+++ /dev/null
@@ -1 +0,0 @@
-sudo apt install fonts-freefont-otf latexmk tex-gyre texlive-fonts-extra texlive-fonts-recommended texlive-lang-all texlive-latex-extra texlive-latex-recommended texlive-xetex
diff --git a/documentation/tools/host_packages_scripts/ubuntu_essential.sh b/documentation/tools/host_packages_scripts/ubuntu_essential.sh
deleted file mode 100644
index 6584a0403d..0000000000
--- a/documentation/tools/host_packages_scripts/ubuntu_essential.sh
+++ /dev/null
@@ -1 +0,0 @@
-sudo apt-get install build-essential chrpath cpio debianutils diffstat file gawk gcc git iputils-ping libacl1 locales python3 python3-git python3-jinja2 python3-pexpect python3-pip python3-subunit socat texinfo unzip wget xz-utils zstd
diff --git a/documentation/tools/update-documentation-conf b/documentation/tools/update-documentation-conf
deleted file mode 100644
index adfca3ca50..0000000000
--- a/documentation/tools/update-documentation-conf
+++ /dev/null
@@ -1,158 +0,0 @@
-#!/usr/bin/env python
-#
-# SPDX-License-Identifier: GPL-2.0-only
-#
-# documentation.conf update script
-#
-# Author: Paul Eggleton <paul.eggleton@linux.intel.com>
-#
-# Copyright (C) 2015 Intel Corporation
-#
-
-
-import sys
-import os
-import argparse
-import re
-from lxml import etree
-import logging
-
-def logger_create(name):
-    logger = logging.getLogger(name)
-    loggerhandler = logging.StreamHandler()
-    loggerhandler.setFormatter(logging.Formatter("%(levelname)s: %(message)s"))
-    logger.addHandler(loggerhandler)
-    logger.setLevel(logging.INFO)
-    return logger
-logger = logger_create('docconfupdater')
-
-def main():
-    parser = argparse.ArgumentParser(description="documentation.conf updater")
-    parser.add_argument('basepath', help='Path to OE-Core base directory')
-    parser.add_argument('-q', '--quiet', help='Print only warnings/errors', action='store_true')
-
-    args = parser.parse_args()
-
-    if args.quiet:
-        logger.setLevel(logging.WARN)
-
-    if not os.path.isdir(args.basepath):
-        logger.error('Specified base path %s not found')
-        return 1
-
-    doc_conf = os.path.join(args.basepath, 'meta', 'conf', 'documentation.conf')
-    if not os.path.exists(doc_conf):
-        logger.error('Unable to find %s' % doc_conf)
-        return 1
-
-    allowed_flags = ['doc']
-    flag_re = re.compile(r'\[(.+?)\]')
-
-    infos = {}
-    tree = etree.parse('ref-manual/ref-variables.xml')
-    root = tree.getroot()
-    for glossary in root.findall('glossary'):
-        for glossdiv in glossary.findall('glossdiv'):
-            for glossentry in glossdiv.findall('glossentry'):
-                info = glossentry.find('info')
-                if info is not None:
-                    infoline = ' '.join(info.text.split())
-                    infolinesplit = infoline.split('=', 1)
-                    if len(infoline) < 2:
-                        logger.warn('Invalid info line (no = character), ignoring: %s' % infoline)
-                        continue
-                    flags = flag_re.findall(infolinesplit[0])
-                    if not flags:
-                        logger.warn('Invalid info line (no varflag), ignoring: %s' % infoline)
-                        continue
-                    for flag in flags:
-                        if flag not in allowed_flags:
-                            logger.warn('Invalid info line (varflag %s not in allowed list), ignoring: %s' % (flag, infoline))
-                            continue
-                    infos[infolinesplit[0].rstrip()] = infolinesplit[1].lstrip()
-
-    if not infos:
-        logger.error('ERROR: Unable to find any info tags in the glossary')
-        return 1
-
-    def sortkey(key):
-        # Underscores sort undesirably, so replace them
-        return key.split('[')[0].replace('_', '-')
-
-    changed = False
-    lines = []
-    invars = False
-    lastletter = None
-    added = []
-    with open(doc_conf, 'r') as dcf:
-        for line in dcf:
-            if not invars:
-                if line.startswith('#') and 'DESCRIPTIONS FOR VARIABLES' in line:
-                    invars = True
-            elif not line.startswith('#'):
-                linesplit = line.split('=', 1)
-                if len(linesplit) > 1:
-                    key = linesplit[0].rstrip()
-                    lastletter = key[0]
-                    # Find anything in the dict that should come before the current key
-                    for dkey in sorted(infos.keys()):
-                        if sortkey(dkey) < sortkey(key):
-                            lines.append('%s = %s\n' % (dkey, infos[dkey]))
-                            added.append(dkey)
-                            del infos[dkey]
-                            changed = True
-                    newvalue = infos.get(key, None)
-                    if newvalue:
-                        del infos[key]
-                        if newvalue != linesplit[1].strip():
-                            lines.append('%s = %s\n' % (key, newvalue))
-                            changed = True
-                            continue
-                    elif key in added:
-                        # We already added a new value for this key, so skip it
-                        continue
-                elif lastletter:
-                    # Ensure we write out anything anything left over for this letter
-                    for dkey in sorted(infos.keys()):
-                        if dkey[0] == lastletter:
-                            lines.append('%s = %s\n' % (dkey, infos[dkey]))
-                            del infos[dkey]
-                            changed = True
-                        elif dkey[0] > lastletter:
-                            # List is sorted, so we're done
-                            break
-                    lastletter = None
-            lines.append(line)
-
-    if not invars:
-        logger.error('ERROR: Unable to find variables section in documentation.conf')
-        return 1
-
-    if infos:
-        changed = True
-        # Write out anything left over
-        lines.append('\n\n')
-        for key in sorted(infos.keys()):
-            lines.append('%s = %s\n' % (key, infos[key]))
-
-    if changed:
-        logger.info('Updating %s' % doc_conf)
-        with open(doc_conf, 'w') as dcf:
-            for line in lines:
-                dcf.write(line)
-    else:
-        logger.info('No changes required')
-
-    return 0
-
-
-if __name__ == "__main__":
-    try:
-        ret = main()
-    except Exception:
-        ret = 1
-        import traceback
-        traceback.print_exc(5)
-    sys.exit(ret)
-
-