From 9a549b6c860dd67835ad51b0df1a0e5965559f91 Mon Sep 17 00:00:00 2001 From: "K.B.Dharun Krishna" Date: Thu, 2 Mar 2023 21:50:46 +0530 Subject: [PATCH] distrobox-*: update pages --- pages/linux/distrobox-create.md | 4 ++-- pages/linux/distrobox-enter.md | 8 ++++---- pages/linux/distrobox-export.md | 20 ++++++++++---------- pages/linux/distrobox-host-exec.md | 8 ++++---- pages/linux/distrobox-list.md | 4 ++-- pages/linux/distrobox-rm.md | 4 ++-- pages/linux/distrobox-stop.md | 4 ++-- pages/linux/distrobox-upgrade.md | 10 +++++----- pages/linux/distrobox.md | 6 +++--- 9 files changed, 34 insertions(+), 34 deletions(-) diff --git a/pages/linux/distrobox-create.md b/pages/linux/distrobox-create.md index 8611c3bdb9..4a209d1d2b 100644 --- a/pages/linux/distrobox-create.md +++ b/pages/linux/distrobox-create.md @@ -1,8 +1,8 @@ # distrobox-create -> Create a distrobox container. More about distrobox: `tldr distrobox`. +> Create a distrobox container. See also: `tldr distrobox`. > The created container will be tightly integrated with the host, allowing sharing of the HOME directory of the user, external storage, external usb devices and graphical apps (X11/Wayland), and audio. -> More information: . +> More information: . - Create a distrobox using the Ubuntu Linux image: diff --git a/pages/linux/distrobox-enter.md b/pages/linux/distrobox-enter.md index 9cef44ac94..f2233840e7 100644 --- a/pages/linux/distrobox-enter.md +++ b/pages/linux/distrobox-enter.md @@ -1,14 +1,14 @@ # distrobox-enter -> Enter a distrobox container. More about distrobox: `tldr distrobox`. +> Enter a distrobox container. See also: `tldr distrobox`. > Default command executed is your SHELL, but you can specify different shells or entire commands to execute. If used inside a script, an application, or a service, you can specify the --headless mode to disable tty and interactivity. -> More information: . +> More information: . -- Enter a distrobox: +- Enter a distrobox container: `distrobox-enter {{container-name}}` -- Enter a distrobox and run `sh -l`: +- Enter a distrobox container and run `sh -l`: `distrobox-enter container-name -- sh -l` diff --git a/pages/linux/distrobox-export.md b/pages/linux/distrobox-export.md index 723d954180..6e0a9d94b4 100644 --- a/pages/linux/distrobox-export.md +++ b/pages/linux/distrobox-export.md @@ -1,25 +1,25 @@ # distrobox-export > Export app/service/binary from container to host OS. -> Subcommand of `distrobox`. More about distrobox: `tldr distrobox`. -> More information: . +> Subcommand of `distrobox`. See also: `tldr distrobox`. +> More information: . -- Export an app (eg: gedit) from the container to the host (will show up in your host system's application list): +- Export an app from the container to the host (the desktop entry/icon will show up in your host system's application list): -`distrobox-export --app {{gedit}} --extra-flags "--foreground"` +`distrobox-export --app {{package_name}} --extra-flags "--foreground"` - Export a binary from the container to the host: `distrobox-export --bin {{path/to/binary}} --export-path {{path/to/binary_on_host}}` -- Export a binary (eg: ranger) from the container to the host: +- Export a binary from the container to the host (i.e `$HOME/.local/bin`) : -`distrobox-export --bin {{/usr/bin/ranger}} --export-path {{$HOME/.local/bin}}` +`distrobox-export --bin {{path/to/binary}} --export-path {{path/to/export}}` -- Export a service (eg: syncthing) from container to the host (`--sudo` will run the service as root inside the container): +- Export a service from container to the host (`--sudo` will run the service as root inside the container): -`distrobox-export --service {{syncthing}} --extra-flags "--allow-newer-config" --sudo` +`distrobox-export --service {{package}} --extra-flags "--allow-newer-config" --sudo` -- Unexport/delete an exported app (eg: gedit): +- Unexport/delete an exported application: -`distrobox-export --app {{gedit}} --delete` +`distrobox-export --app {{package}} --delete` diff --git a/pages/linux/distrobox-host-exec.md b/pages/linux/distrobox-host-exec.md index f4f858a440..0515b1c9e2 100644 --- a/pages/linux/distrobox-host-exec.md +++ b/pages/linux/distrobox-host-exec.md @@ -1,13 +1,13 @@ # distrobox-host-exec > Execute a command on host while inside a distrobox container. -> Subcommand of `distrobox`. More about distrobox: `tldr distrobox`. -> More information: . +> Subcommand of `distrobox`. See also: `tldr distrobox`. +> More information: . -- Execute command on the host system, while inside of a container: +- Execute command on the host system from inside the container: `distrobox-host-exec "{{command}}"` -- Execute `ls` command on the host system, while inside of a container: +- Execute the `ls` command on the host system from inside the container: `distrobox-host-exec ls` diff --git a/pages/linux/distrobox-list.md b/pages/linux/distrobox-list.md index 148e1f220b..2c20aa5f0e 100644 --- a/pages/linux/distrobox-list.md +++ b/pages/linux/distrobox-list.md @@ -1,8 +1,8 @@ # distrobox-list -> List all distrobox containers. More about distrobox: `tldr distrobox`. +> List all distrobox containers. See also: `tldr distrobox`. > It detects them and lists them separately from the rest of normal podman or Docker containers. -> More information: . +> More information: . - List all distrobox containers: diff --git a/pages/linux/distrobox-rm.md b/pages/linux/distrobox-rm.md index e847acf8e8..0ee308f8ba 100644 --- a/pages/linux/distrobox-rm.md +++ b/pages/linux/distrobox-rm.md @@ -1,10 +1,10 @@ # distrobox-rm > Remove a distrobox container. -> Subcommand of `distrobox`. More about distrobox: `tldr distrobox`. +> Subcommand of `distrobox`. See also: `tldr distrobox`. > More information: . -- Remove a distrobox (remember to stop container before removing it): +- Remove a distrobox (Tip: Stop the container before removing it): `distrobox-rm {{container_name}}` diff --git a/pages/linux/distrobox-stop.md b/pages/linux/distrobox-stop.md index e578c51f65..461c600556 100644 --- a/pages/linux/distrobox-stop.md +++ b/pages/linux/distrobox-stop.md @@ -1,8 +1,8 @@ # distrobox-stop > Stop a distrobox container. -> Subcommand of `distrobox`. More about distrobox: `tldr distrobox`. -> More information: . +> Subcommand of `distrobox`. See also: `tldr distrobox`. +> More information: . - Stop a distrobox container: diff --git a/pages/linux/distrobox-upgrade.md b/pages/linux/distrobox-upgrade.md index b09f065c3e..964ab5202d 100644 --- a/pages/linux/distrobox-upgrade.md +++ b/pages/linux/distrobox-upgrade.md @@ -1,17 +1,17 @@ # distrobox-upgrade -> Upgrade a distrobox container. -> Subcommand of `distrobox`. More about distrobox: `tldr distrobox`. +> Upgrade one or multiple distrobox containers. +> Subcommand of `distrobox`. See also: `tldr distrobox`. > More information: . -- Upgrade a container using the container's package manager: +- Upgrade a container using the container's native package manager: `distrobox-upgrade {{container_name}}` -- Upgrade all containers using the containers' package managers: +- Upgrade all containers using the container's native package managers: `distrobox-upgrade --all` -- Upgrade specific containers via containers' package managers: +- Upgrade specific containers via container's native package managers: `distrobox-upgrade {{container1 container2 ...}}` diff --git a/pages/linux/distrobox.md b/pages/linux/distrobox.md index 5dcce1f75c..32e16fbe0c 100644 --- a/pages/linux/distrobox.md +++ b/pages/linux/distrobox.md @@ -1,7 +1,7 @@ # distrobox -> Use any Linux distribution inside your terminal by running it as a container. Install & use packages inside it while tightly integrating with host OS, sharing storage, HOME directory with GUI & audio capabilities. -> You can install any software inside it. Eg: installing a `.deb` package inside an ubuntu container running on an Arch Linux host system. Packages inside container can access host's files. +> Use any Linux distribution inside your terminal by running it as a container. Install & use packages inside it while tightly integrating with the host OS, sharing storage, and `home` directory with GUI & audio capabilities. +> You can install any software inside it. Eg: installing a `.deb` package inside an ubuntu container running on an Arch Linux host system. Packages inside the container can access the host's files. > More information: . - Show tldr page for distrobox-create (creating containers): @@ -16,7 +16,7 @@ `tldr distrobox-enter` -- Show tldr page for distrobox-host-exec (Execute command on host while inside a container): +- Show tldr page for distrobox-host-exec (Execute command on the host while inside a container): `tldr distrobox-host-exec`