From ffd365342eefd3faae8737f02cf83407399ea000 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ond=C5=99ej=20M=C3=ADchal?= Date: Fri, 17 Dec 2021 16:24:20 +0200 Subject: [PATCH] doc: Highlight that --distro has to be used with --release ...unless the selected distro matches the host system. https://github.com/containers/toolbox/pull/977 https://github.com/containers/toolbox/pull/986 --- doc/toolbox-create.1.md | 3 ++- doc/toolbox-enter.1.md | 1 + doc/toolbox-run.1.md | 3 ++- 3 files changed, 5 insertions(+), 2 deletions(-) diff --git a/doc/toolbox-create.1.md b/doc/toolbox-create.1.md index ecde9f9..0e18615 100644 --- a/doc/toolbox-create.1.md +++ b/doc/toolbox-create.1.md @@ -82,7 +82,8 @@ confusion. **--distro** DISTRO, **-d** DISTRO Create a toolbox container for a different operating system DISTRO than the -host. Cannot be used with `--image`. +host. Cannot be used with `--image`. Has to be coupled with `--release` unless +the selected DISTRO matches the host. **--image** NAME, **-i** NAME diff --git a/doc/toolbox-enter.1.md b/doc/toolbox-enter.1.md index 94180bc..fda0072 100644 --- a/doc/toolbox-enter.1.md +++ b/doc/toolbox-enter.1.md @@ -32,6 +32,7 @@ The following options are understood: **--distro** DISTRO, **-d** DISTRO Enter a toolbox container for a different operating system DISTRO than the +host. Has to be coupled with `--release` unless the selected DISTRO matches the host. **--release** RELEASE, **-r** RELEASE diff --git a/doc/toolbox-run.1.md b/doc/toolbox-run.1.md index b8a2daa..e0dc098 100644 --- a/doc/toolbox-run.1.md +++ b/doc/toolbox-run.1.md @@ -34,7 +34,8 @@ entirely customized containers created from custom-built images. **--distro** DISTRO, **-d** DISTRO Run command inside a toolbox container for a different operating system DISTRO -than the host. +than the host. Has to be coupled with `--release` unless the selected system +matches the host system. **--release** RELEASE, **-r** RELEASE