Sync/release 3.12.0

.github/workflows/linter.yml

@@ -58,10 +58,9 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           # Linters configuration.
           LINTER_RULES_PATH: '.'
-          # We are not interested in linting these files:
-          # * Markdown files under `doc` or `sphinx` directories, which belong to the
-          #   old docs, and are going to be replaced soon.
-          FILTER_REGEX_EXCLUDE: '(doc|sphinx)/.*\.md'
+          # We are not interested in linting files from the old docs, which are going
+          # to be removed soon:
+          FILTER_REGEX_EXCLUDE: 'old_docs/.*\.md'
           DOCKERFILE_HADOLINT_FILE_NAME: .hadolint.yaml
           GITLEAKS_CONFIG_FILE: .gitleaks.toml
           MARKDOWN_CONFIG_FILE: .markdownlint.yml

.github/workflows/main.yml

@@ -13,9 +13,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Step 1 - Checkout repository
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
       - name: Step 2 - Install python
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v5
         with:
           python-version: 3.7
       - name: Step 3 - Install dependencies
@@ -35,13 +35,13 @@ jobs:
 
     steps:
       - name: Step 1 - Checkout repository
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
       - name: Step 2 - Install python
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v5
         with:
           python-version: "${{ matrix.python-version }}"
       - name: Step 3 - Do some caching for python packages
-        uses: actions/cache@v2
+        uses: actions/cache@v4
         id: cache-python-packages
         with:
           path: ${{ env.pythonLocation }}

.gitignore

@@ -10,6 +10,7 @@
 *~
 \#*\#
 .*.swp
+*.bak
 
 # eclipse project files
 /.project
@@ -35,3 +36,10 @@ venv/*
 
 # pyenv
 .python-version
+
+# Sphinx docs
+docs/_build/*
+docs/contributor_guide/modules
+
+# Allow the man directory
+!docs/_build/man/

INSTALL.md

@@ -1,3 +1,3 @@
-## Barman INSTALL instructions
+# Barman INSTALL instructions
 
-For further information, see the "Installation" section in the official manual of Barman or the Markdown source file: [doc/manual/16-installation.en.md](https://github.com/EnterpriseDB/barman/blob/master/doc/manual/16-installation.en.md).
+For further information, see the "Installation" section in the official manual of Barman.

MANIFEST.in

@@ -1,5 +1,6 @@
 recursive-include barman *.py
 recursive-include rpm *
-recursive-include doc *
+recursive-include docs/barman.d *
+include docs/barman.conf
 include scripts/barman.bash_completion
-include AUTHORS NEWS ChangeLog LICENSE MANIFEST.in setup.py INSTALL README.rst
+include AUTHORS RELNOTES.md ChangeLog LICENSE MANIFEST.in setup.py INSTALL README.rst