1
0
mirror of https://github.com/pgbackrest/pgbackrest.git synced 2024-12-12 10:04:14 +02:00

Remove user-facing documentation references to --vm=none.

This parameter is now optional and defaults to none so there is no reason to explicitly show it in user-facing documentation.

Also make the vm parameter in ci.pl optional to be consistent with how test.pl behaves.
This commit is contained in:
David Steele 2023-05-23 10:58:51 +03:00
parent 4ec51cdb2f
commit c633b187db
5 changed files with 18 additions and 24 deletions

View File

@ -25,7 +25,7 @@ arm64_task:
- chown -R testuser ${CIRRUS_WORKING_DIR?}
script:
- su - testuser -c "${CIRRUS_WORKING_DIR?}/test/ci.pl test --vm=none --sudo --no-tempfs --param=c-only --param=no-coverage"
- su - testuser -c "${CIRRUS_WORKING_DIR?}/test/ci.pl test --sudo --no-tempfs --param=c-only --param=no-coverage"
# FreeBSD 12
# ----------------------------------------------------------------------------------------------------------------------------------
@ -38,7 +38,7 @@ freebsd_12_task:
install_script: pkg update && pkg upgrade -y libiconv && pkg install -y bash git postgresql-libpqxx pkgconf libxml2 gmake perl5 libyaml p5-YAML-LibYAML rsync meson
script:
- cd .. && perl ${CIRRUS_WORKING_DIR}/test/test.pl --min-gen --make-cmd=gmake --vm=none --vm-max=2 --no-coverage --no-valgrind --module=command --test=backup
- cd .. && perl ${CIRRUS_WORKING_DIR}/test/test.pl --min-gen --make-cmd=gmake --vm-max=2 --no-coverage --no-valgrind --module=command --test=backup
debug_script:
- ls -lah ${CIRRUS_WORKING_DIR}
@ -55,7 +55,7 @@ freebsd_13_task:
script:
- rsync --version
- cd .. && perl ${CIRRUS_WORKING_DIR}/test/test.pl --min-gen --make-cmd=gmake --vm=none --vm-max=2 --no-coverage --no-valgrind --module=command --test=backup
- cd .. && perl ${CIRRUS_WORKING_DIR}/test/test.pl --min-gen --make-cmd=gmake --vm-max=2 --no-coverage --no-valgrind --module=command --test=backup
debug_script:
- ls -lah ${CIRRUS_WORKING_DIR}
@ -76,7 +76,7 @@ macos_ventura_task:
- brew install -q pkg-config openssl@1.1 libpq libxml2 libyaml meson
script:
- cd .. && ${CIRRUS_WORKING_DIR}/test/test.pl --min-gen --vm=none --vm-max=2 --no-coverage --no-valgrind --module=command --test=backup
- cd .. && ${CIRRUS_WORKING_DIR}/test/test.pl --min-gen --vm-max=2 --no-coverage --no-valgrind --module=command --test=backup
debug_script:
- ls -lah ${CIRRUS_WORKING_DIR}

View File

@ -100,8 +100,8 @@ jobs:
run: |
git config --global --add safe.directory ${GITHUB_WORKSPACE?}/pgbackrest
${GITHUB_WORKSPACE?}/pgbackrest/test/test.pl --vm=none --min-gen --no-valgrind --no-coverage --no-optimize --build-max=2 --module=command --test=backup
${GITHUB_WORKSPACE?}/pgbackrest/test/test.pl --vm=none --min-gen --no-valgrind --no-coverage --no-optimize --build-max=2 --module=postgres --test=interface
${GITHUB_WORKSPACE?}/pgbackrest/test/test.pl --min-gen --no-valgrind --no-coverage --no-optimize --build-max=2 --module=command --test=backup
${GITHUB_WORKSPACE?}/pgbackrest/test/test.pl --min-gen --no-valgrind --no-coverage --no-optimize --build-max=2 --module=postgres --test=interface
# Run meson unity build to check for errors, unused functions, and externed functions
unity:
@ -139,7 +139,7 @@ jobs:
- name: Check
run: |
cd ${HOME?} && ${GITHUB_WORKSPACE?}/pgbackrest/test/ci.pl test --vm=none --param=code-format-check
cd ${HOME?} && ${GITHUB_WORKSPACE?}/pgbackrest/test/ci.pl test --param=code-format-check
codeql:
runs-on: ubuntu-latest

View File

@ -227,11 +227,11 @@ pgbackrest/doc/doc.pl --help
#### Without Docker
If Docker is not installed, then the available tests can be listed using `--vm=none`, and each test must then be run with `--vm=none`.
If Docker is not installed, then the available tests can be listed using `--dry-run`. Some tests require containers and will only be available when Docker is installed.
pgbackrest-dev => List tests that don't require a container
```
pgbackrest/test/test.pl --vm=none --dry-run
pgbackrest/test/test.pl --dry-run
--- output ---
@ -249,7 +249,7 @@ pgbackrest/test/test.pl --vm=none --dry-run
pgbackrest-dev => Run a test
```
pgbackrest/test/test.pl --vm=none --vm-out --module=common --test=wait
pgbackrest/test/test.pl --vm-out --module=common --test=wait
--- output ---
@ -306,7 +306,7 @@ An entire module can be run by using only the `--module` option.
pgbackrest-dev => Run a module
```
pgbackrest/test/test.pl --vm=none --module=postgres
pgbackrest/test/test.pl --module=postgres
--- output ---
@ -661,7 +661,7 @@ pgbackrest/test/test.pl --module=command --test=help --vm-out
```
To verify the `help` command output, build the pgBackRest executable:
```
pgbackrest/test/test.pl --vm=none --build-only
pgbackrest/test/test.pl --build-only
```
Use the pgBackRest executable to test the help output:
```

View File

@ -344,13 +344,13 @@ pgbackrest/doc/doc.pl --help
<section id="without-docker">
<title>Without Docker</title>
<p>If <proper>Docker</proper> is not installed, then the available tests can be listed using <setting>--vm=none</setting>, and each test must then be run with <setting>--vm=none</setting>.</p>
<p>If <proper>Docker</proper> is not installed, then the available tests can be listed using <setting>--dry-run</setting>. Some tests require containers and will only be available when Docker is installed.</p>
<execute-list host="{[host-contrib]}">
<title>List tests that don't require a container</title>
<execute output="y">
<exe-cmd>pgbackrest/test/test.pl --vm=none --dry-run</exe-cmd>
<exe-cmd>pgbackrest/test/test.pl --dry-run</exe-cmd>
<exe-cmd-extra>{[test-cmd-extra]}</exe-cmd-extra>
<exe-highlight>[0-9]+ tests selected|DRY RUN COMPLETED SUCCESSFULLY</exe-highlight>
</execute>
@ -360,7 +360,7 @@ pgbackrest/doc/doc.pl --help
<title>Run a test</title>
<execute output="y">
<exe-cmd>pgbackrest/test/test.pl --vm=none --vm-out --module=common --test=wait</exe-cmd>
<exe-cmd>pgbackrest/test/test.pl --vm-out --module=common --test=wait</exe-cmd>
<exe-cmd-extra>{[test-cmd-extra]}</exe-cmd-extra>
</execute>
</execute-list>
@ -371,7 +371,7 @@ pgbackrest/doc/doc.pl --help
<title>Run a module</title>
<execute output="y">
<exe-cmd>pgbackrest/test/test.pl --vm=none --module=postgres</exe-cmd>
<exe-cmd>pgbackrest/test/test.pl --module=postgres</exe-cmd>
<exe-cmd-extra>{[test-cmd-extra]}</exe-cmd-extra>
</execute>
</execute-list>
@ -759,7 +759,7 @@ pgbackrest/test/test.pl --module=command --test=help --vm-out
<p>To verify the <cmd>help</cmd> command output, build the <backrest/> executable:</p>
<code-block>
pgbackrest/test/test.pl --vm=none --build-only
pgbackrest/test/test.pl --build-only
</code-block>
<p>Use the <backrest/> executable to test the help output:</p>

View File

@ -56,7 +56,7 @@ test.pl [options] doc|test
####################################################################################################################################
# Command line parameters
####################################################################################################################################
my $strVm;
my $strVm = "none";
my @stryParam;
my $bNoTempFs;
my $bSudo;
@ -119,12 +119,6 @@ eval
pod2usage();
}
# VM must be defined
if (!defined($strVm))
{
confess &log(ERROR, '--vm is required');
}
################################################################################################################################
# Paths
################################################################################################################################