Merge 3cc91b7dba into 9776b1a283

pages/common/bandwhich.md

@@ -1,24 +1,24 @@
 # bandwhich
 
 > Display the current network utilization by process, connection or remote IP/hostname.
-> More information: <https://github.com/imsnif/bandwhich>.
+> More information: <https://github.com/imsnif/bandwhich#usage>.
 
 - Show the remote addresses table only:
 
-`bandwhich --addresses`
+`bandwhich {{[-a|--addresses]}}`
 
 - Show DNS queries:
 
-`bandwhich --show-dns`
+`bandwhich {{[-s|--show-dns]}}`
 
 - Show total (cumulative) usage:
 
-`bandwhich --total-utilization`
+`bandwhich {{[-t|--total-utilization]}}`
 
 - Show the network utilization for a specific network interface:
 
-`bandwhich --interface {{eth0}}`
+`bandwhich {{[-i|--interface]}} {{eth0}}`
 
 - Show DNS queries with a given DNS server:
 
-`bandwhich --show-dns --dns-server {{dns_server_ip}}`
+`bandwhich {{[-s|--show-dns]}} {{[-d|--dns-server]}} {{dns_server_ip}}`

pages/common/buku.md

@@ -1,7 +1,7 @@
 # buku
 
 > Command-line browser-independent bookmark manager.
-> More information: <https://github.com/jarun/Buku?tab=readme-ov-file#usage>.
+> More information: <https://github.com/jarun/Buku#usage>.
 
 - Display all bookmarks matching "keyword" and with "privacy" tag:
 

pages/common/fakedata.md

@@ -13,11 +13,11 @@
 
 - Generate data with a specific output format:
 
-`fakedata --format {{csv|tab|sql}} {{generator}}`
+`fakedata {{[-f|--format]}} {{csv|tab|sql}} {{generator}}`
 
 - Generate a given number of data items (defaults to 10):
 
-`fakedata --limit {{n}} {{generator}}`
+`fakedata {{[-l|--limit]}} {{n}} {{generator}}`
 
 - Generate data using a custom output template (the first letter of generator names must be capitalized):
 

pages/common/gh-alias.md

@@ -13,7 +13,7 @@
 
 - Set a shell command as a `gh` subcommand:
 
-`gh alias set --shell {{alias_name}} {{command}}`
+`gh alias set {{[-s|--shell]}} {{alias_name}} {{command}}`
 
 - Delete a command shortcut:
 

pages/common/gh-api.md

@@ -9,19 +9,19 @@
 
 - Create a reaction for a specific issue:
 
-`gh api --header {{Accept:application/vnd.github.squirrel-girl-preview+json}} --raw-field '{{content=+1}}' {{repos/:owner/:repo/issues/123/reactions}}`
+`gh api {{[-H|--header]}} {{Accept:application/vnd.github.squirrel-girl-preview+json}} {{[-f|--raw-field]}} '{{content=+1}}' {{repos/:owner/:repo/issues/123/reactions}}`
 
 - Display the result of a GraphQL query in JSON format:
 
-`gh api graphql --field {{name=':repo'}} --raw-field '{{query}}'`
+`gh api graphql {{[-f|--field]}} {{name=':repo'}} {{[-f|--raw-field]}} '{{query}}'`
 
 - Send a request using a custom HTTP method:
 
-`gh api --method {{POST}} {{endpoint}}`
+`gh api {{[-X|--method]}} {{POST}} {{endpoint}}`
 
 - Include the HTTP response headers in the output:
 
-`gh api --include {{endpoint}}`
+`gh api {{[--include]}} {{endpoint}}`
 
 - Do not print the response body:
 

pages/common/gh-auth.md

@@ -21,7 +21,7 @@
 
 - Log in with a specific GitHub Enterprise Server:
 
-`gh auth login --hostname {{github.example.com}}`
+`gh auth login {{[-h|--hostname]}} {{github.example.com}}`
 
 - Refresh the session to ensure authentication credentials have the correct minimum scopes (removes additional scopes requested previously):
 
@@ -29,4 +29,4 @@
 
 - Expand the permission scopes:
 
-`gh auth refresh --scopes {{repo,admin:repo_hook,admin:org,admin:public_key,admin:org_hook,...}}`
+`gh auth refresh {{[-s|--scopes]}} {{repo,admin:repo_hook,admin:org,admin:public_key,admin:org_hook,...}}`

pages/common/gh-browse.md

@@ -13,11 +13,11 @@
 
 - Open the settings page of the current repository in the default web browser:
 
-`gh browse --settings`
+`gh browse {{[-s|--settings]}}`
 
 - Open the wiki of the current repository in the default web browser:
 
-`gh browse --wiki`
+`gh browse {{[-w|--wiki]}}`
 
 - Open a specific issue or pull request in the web browser:
 
@@ -25,7 +25,7 @@
 
 - Open a specific branch in the web browser:
 
-`gh browse --branch {{branch_name}}`
+`gh browse {{[-b|--branch]}} {{branch_name}}`
 
 - Open a specific file or directory of the current repository in the web browser:
 
@@ -33,4 +33,4 @@
 
 - Print the destination URL without open the web browser:
 
-`gh browse --no-browser`
+`gh browse {{[-n|--no-browser]}}`

pages/common/gh-completion.md

@@ -5,15 +5,15 @@
 
 - Print a completion script:
 
-`gh completion --shell {{bash|zsh|fish|powershell}}`
+`gh completion {{[-s|--shell]}} {{bash|zsh|fish|powershell}}`
 
 - Append the `gh` completion script to `~/.bashrc`:
 
-`gh completion --shell {{bash}} >> {{~/.bashrc}}`
+`gh completion {{[-s|--shell]}} {{bash}} >> {{~/.bashrc}}`
 
 - Append the `gh` completion script to `~/.zshrc`:
 
-`gh completion --shell {{zsh}} >> {{~/.zshrc}}`
+`gh completion {{[-s|--shell]}} {{zsh}} >> {{~/.zshrc}}`
 
 - Display the subcommand help:
 

pages/common/gh-gist.md

@@ -9,7 +9,7 @@
 
 - Create a new Gist with a specific [desc]ription:
 
-`gh gist create {{path/to/file1 path/to/file2 ...}} --desc "{{description}}"`
+`gh gist create {{path/to/file1 path/to/file2 ...}} {{[-d|--desc]}} "{{description}}"`
 
 - Edit a Gist:
 
@@ -17,8 +17,8 @@
 
 - List up to 42 Gists owned by the currently logged in user:
 
-`gh gist list --limit {{42}}`
+`gh gist list {{[-L|--limit]}} {{42}}`
 
 - View a Gist in the default browser without rendering Markdown:
 
-`gh gist view {{id|url}} --web --raw`
+`gh gist view {{id|url}} {{[-w|--web]}} {{[-r|--raw]}}`

pages/common/gh-issue-create.md

@@ -9,23 +9,23 @@
 
 - Create a new issue with the `bug` label interactively:
 
-`gh issue create --label "{{bug}}"`
+`gh issue create {{[-l|--label]}} "{{bug}}"`
 
 - Create a new issue interactively and assign it to the specified users:
 
-`gh issue create --assignee {{user1,user2,...}}`
+`gh issue create {{[-a|--assignee]}} {{user1,user2,...}}`
 
 - Create a new issue with a title, body and assign it to the current user:
 
-`gh issue create --title "{{title}}" --body "{{body}}" --assignee "{{@me}}"`
+`gh issue create {{[-t|--title]}} "{{title}}" {{[-b|--body]}} "{{body}}" {{[-a|--assignee]}} "{{@me}}"`
 
 - Create a new issue interactively, reading the body text from a file:
 
-`gh issue create --body-file {{path/to/file}}`
+`gh issue create {{[-Fľ--body-file]}} {{path/to/file}}`
 
 - Create a new issue in the default web browser:
 
-`gh issue create --web`
+`gh issue create {{[-w|--web]}}`
 
 - Display the help:
 

pages/common/gh-issue.md

@@ -9,23 +9,23 @@
 
 - Display a specific issue in the default web browser:
 
-`gh issue view {{issue_number}} --web`
+`gh issue view {{issue_number}} {{[-w|--web]}}`
 
 - Create a new issue in the default web browser:
 
-`gh issue create --web`
+`gh issue create {{[-w|--web]}}`
 
 - List the last 10 issues with the `bug` label:
 
-`gh issue list --limit {{10}} --label "{{bug}}"`
+`gh issue list {{[-L|--limit]}} {{10}} {{[-l|--label]}} "{{bug}}"`
 
 - List closed issues made by a specific user:
 
-`gh issue list --state closed --author {{username}}`
+`gh issue list {{[-s|--state]}} closed {{[-A|--author]}} {{username}}`
 
 - Display the status of issues relevant to the user, in a specific repository:
 
-`gh issue status --repo {{owner}}/{{repository}}`
+`gh issue status {{[-R|--repo]}} {{owner}}/{{repository}}`
 
 - Reopen a specific issue:
 

pages/common/gh-label.md

@@ -9,11 +9,11 @@
 
 - View labels for the repository in the current directory in the default web browser:
 
-`gh label list --web`
+`gh label list {{[-w|--web]}}`
 
 - Create a label with a specific name, description and color in hexadecimal format for the repository in the current directory:
 
-`gh label create {{name}} --description "{{description}}" --color {{color_hex}}`
+`gh label create {{name}} {{[-d|--description]}} "{{description}}" {{[-c|--color]}} {{color_hex}}`
 
 - Delete a label for the repository in the current directory, prompting for confirmation:
 
@@ -21,7 +21,7 @@
 
 - Update the name and description for a specific label for the repository in the current directory:
 
-`gh label edit {{name}} --name {{new_name}} --description "{{description}}"`
+`gh label edit {{name}} {{[-n|--name]}} {{new_name}} {{[-d|--description]}} "{{description}}"`
 
 - Clone labels from a specific repository into the repository in the current directory:
 

pages/common/gh-pr-create.md

@@ -9,16 +9,16 @@
 
 - Create a pull request, determining the title and description from the commit messages of the current branch:
 
-`gh pr create --fill`
+`gh pr create {{[-f|--fill]}}`
 
 - Create a draft pull request:
 
-`gh pr create --draft`
+`gh pr create {{[-d|--draft]}}`
 
 - Create a pull request specifying the base branch, title, and description:
 
-`gh pr create --base {{base_branch}} --title "{{title}}" --body "{{body}}"`
+`gh pr create {{[-B|--base]}} {{base_branch}} {{[-t|--title]}} "{{title}}" {{[-b|--body]}} "{{body}}"`
 
 - Start opening a pull request in the default web browser:
 
-`gh pr create --web`
+`gh pr create {{[-w|--web]}}`

pages/common/gh-pr-merge.md

@@ -13,7 +13,7 @@
 
 - Merge the pull request, removing the branch on both the local and the remote:
 
-`gh pr merge --delete-branch`
+`gh pr merge {{[-d|--delete-branch]}}`
 
 - Merge the current pull request with the specified merge strategy:
 
@@ -21,11 +21,11 @@
 
 - Merge the current pull request with the specified merge strategy and commit message:
 
-`gh pr merge --{{merge|squash|rebase}} --subject {{commit_message}}`
+`gh pr merge --{{merge|squash|rebase}} {{[-t|--subject]}} {{commit_message}}`
 
 - Squash the current pull request into one commit with the message body and merge:
 
-`gh pr merge --squash --body="{{commit_message_body}}"`
+`gh pr merge {{[-s|--squash]}} {{[-b|--body]}} "{{commit_message_body}}"`
 
 - Display help:
 

pages/common/gh-pr.md

@@ -18,7 +18,7 @@
 
 - Approve the pull request for the current branch:
 
-`gh pr review --approve`
+`gh pr review {{[-a|--approve]}}`
 
 - Merge the pull request associated with the current branch interactively:
 
@@ -30,7 +30,7 @@
 
 - Edit the base branch of a pull request:
 
-`gh pr edit --base {{branch_name}}`
+`gh pr edit {{[-B|--base]}} {{branch_name}}`
 
 - Check the status of the current repository's pull requests:
 

pages/common/gh-repo.md

@@ -17,7 +17,7 @@
 
 - View a repository in the default web browser:
 
-`gh repo view {{repository}} --web`
+`gh repo view {{repository}} {{[-w|--web]}}`
 
 - List repositories owned by a specific user or organization (if the owner is not set, the default owner will be the currently logged in user):
 
@@ -25,8 +25,8 @@
 
 - List only non-forks repositories and limit the number of repositories to list (default: 30):
 
-`gh repo list {{owner}} --source -L {{limit}}`
+`gh repo list {{owner}} --source {{[-L|--limit]}} {{limit}}`
 
 - List repositories with a specific primary coding language:
 
-`gh repo list {{owner}} --language {{language_name}}`
+`gh repo list {{owner}} {{[-l|--language]}} {{language_name}}`

pages/common/gh-run.md

@@ -13,11 +13,11 @@
 
 - Display information about the steps of a job:
 
-`gh run view --job={{job_number}}`
+`gh run view {{[-j|--job]}} {{job_number}}`
 
 - Display the log of a job:
 
-`gh run view --job={{job_number}} --log`
+`gh run view {{[-j|--job]}} {{job_number}} --log`
 
 - Check a specific workflow and exit with a non-zero status if the run failed:
 

pages/common/gh-screensaver.md

@@ -10,16 +10,16 @@
 
 - Run a specific screensaver:
 
-`gh screensaver --saver {{fireworks|life|marquee|pipes|pollock|starfield}}`
+`gh screensaver {{[-s|--saver]}} {{fireworks|life|marquee|pipes|pollock|starfield}}`
 
 - Run the "marquee" screensaver with a specific text and font:
 
-`gh screensaver --saver {{marquee}} -- --message="{{message}}" --font={{font_name}}`
+`gh screensaver {{[-s|--saver]}} {{marquee}} -- --message="{{message}}" --font={{font_name}}`
 
 - Run the "starfield" screensaver with a specific density and speed:
 
-`gh screensaver --saver {{starfield}} -- --density {{500}} --speed {{10}}`
+`gh screensaver {{[-s|--saver]}} {{starfield}} -- --density {{500}} --speed {{10}}`
 
 - List available screensavers:
 
-`gh screensaver --list`
+`gh screensaver {{[-l|--list]}}`

pages/common/gh-secret-set.md

@@ -13,12 +13,12 @@
 
 - Set a secret for a specific repository:
 
-`gh secret set {{name}} --body {{value}} --repo {{owner}}/{{repository}}`
+`gh secret set {{name}} {{[-b|--body]}} {{value}} {{[-R|--repo]}} {{owner}}/{{repository}}`
 
 - Set an organization secret for specific repositories:
 
-`gh secret set {{name}} --org {{organization}} --repos "{{repository1,repository2,...}}"`
+`gh secret set {{name}} {{[-o|--org]}} {{organization}} {{[-r|--repos]}} "{{repository1,repository2,...}}"`
 
 - Set an organization secret with a specific visibility:
 
-`gh secret set {{name}} --org {{organization}} --visibility {{all|private|selected}}`
+`gh secret set {{name}} {{[-o|--org]}} {{organization}} {{[-v|--visibility]}} {{all|private|selected}}`

pages/common/gh-secret.md

@@ -9,11 +9,11 @@
 
 - List secret keys for a specific organization:
 
-`gh secret list --org {{organization}}`
+`gh secret list {{[-o|--org]}} {{organization}}`
 
 - List secret keys for a specific repository:
 
-`gh secret list --repo {{owner}}/{{repository}}`
+`gh secret list {{[-R|--repo]}} {{owner}}/{{repository}}`
 
 - Set a secret for the current repository (user will be prompted for the value):
 
@@ -25,7 +25,7 @@
 
 - Set an organization secret for specific repositories:
 
-`gh secret set {{name}} --org {{organization}} --repos {{repository1,repository2}}`
+`gh secret set {{name}} {{[-o|--org]}} {{organization}} {{[-r|--repos]}} {{repository1,repository2}}`
 
 - Remove a secret for the current repository:
 
@@ -33,4 +33,4 @@
 
 - Remove a secret for a specific organization:
 
-`gh secret remove {{name}} --org {{organization}}`
+`gh secret remove {{name}} {{[-o|--org]}} {{organization}}`

pages/common/gh-ssh-key.md

@@ -17,4 +17,4 @@
 
 - Add an SSH key to the currently authenticated user's account with a specific title:
 
-`gh ssh-key add --title {{title}} {{path/to/key.pub}}`
+`gh ssh-key add {{[-t|--title]}} {{title}} {{path/to/key.pub}}`

pages/common/gh-workflow.md

@@ -9,15 +9,15 @@
 
 - View a specific workflow in the default browser:
 
-`gh workflow view {{id|workflow_name|filename.yml}} --web`
+`gh workflow view {{id|workflow_name|filename.yml}} {{[-w|--web]}}`
 
 - Display the YAML definition of a specific workflow:
 
-`gh workflow view {{id|workflow_name|filename.yml}} --yaml`
+`gh workflow view {{id|workflow_name|filename.yml}} {{[-y|--yaml]}}`
 
 - Display the YAML definition for a specific Git branch or tag:
 
-`gh workflow view {{id|workflow_name|filename.yml}} --ref {{branch|tag_name}} --yaml`
+`gh workflow view {{id|workflow_name|filename.yml}} {{[-r|--ref]}} {{branch|tag_name}} {{[-y|--yaml]}}`
 
 - List workflow files (use `--all` to include disabled workflows):
 
@@ -29,7 +29,7 @@
 
 - Run a manual workflow using a specific branch or tag with JSON parameters from `stdin`:
 
-`echo '{{{"param1": "value1", "param2": "value2", ...}}}' | gh workflow run {{id|workflow_name|filename.yml}} --ref {{branch|tag_name}}`
+`echo '{{{"param1": "value1", "param2": "value2", ...}}}' | gh workflow run {{id|workflow_name|filename.yml}} {{[-r|--ref]}} {{branch|tag_name}}`
 
 - Enable or disable a specific workflow:
 

pages/common/gh.md

@@ -2,7 +2,7 @@
 
 > Work seamlessly with GitHub.
 > Some subcommands such as `config` have their own usage documentation.
-> More information: <https://cli.github.com/>.
+> More information: <https://cli.github.com/manual/gh>.
 
 - Clone a GitHub repository locally:
 
@@ -18,7 +18,7 @@
 
 - View an issue in the default web browser:
 
-`gh issue view --web {{issue_number}}`
+`gh issue view {{[-w|--web]}} {{issue_number}}`
 
 - Create a pull request:
 
@@ -26,7 +26,7 @@
 
 - View a pull request in the default web browser:
 
-`gh pr view --web {{pr_number}}`
+`gh pr view {{[-w|--web]}} {{pr_number}}`
 
 - Check out a specific pull request locally:
 

pages/common/peludna-prognoza.md

@@ -17,4 +17,4 @@
 
 - Display the pollen measurement page for a city at <https://plivazdravlje.hr> in the default web browser:
 
-`peludna-prognoza "{{city}}" --web`
+`peludna-prognoza "{{city}}" {{[-w|--web]}}`

pages/common/virsh-undefine.md

@@ -1,4 +1,4 @@
-# virsh-undefine
+# virsh undefine
 
 > Delete a virtual machine.
 > More information: <https://manned.org/virsh>.

pages/common/virt-clone.md

@@ -5,8 +5,8 @@
 
 - Clone a virtual machine and automatically generate a new name, storage path, and MAC address:
 
-`virt-clone --original {{vm_name}} --auto-clone`
+`virt-clone {{[-o|--original]}} {{vm_name}} --auto-clone`
 
 - Clone a virtual machine and specify the new name, storage path, and MAC address:
 
-`virt-clone --original {{vm_name}} --name {{new_vm_name}} --file {{path/to/new_storage}} --mac {{ff:ff:ff:ff:ff:ff|RANDOM}}`
+`virt-clone {{[-o|--original]}} {{vm_name}} {{[-n|--name]}} {{new_vm_name}} {{[-f|--file]}} {{path/to/new_storage}} {{[-m|--mac]}} {{ff:ff:ff:ff:ff:ff|RANDOM}}`

pages/common/virt-install.md

@@ -1,24 +1,24 @@
 # virt-install
 
 > Create virtual machines with libvirt and begin OS installation.
-> More information: <https://virt-manager.org/>.
+> More information: <https://manned.org/virt-install>.
 
 - Create a virtual machine with 1 GB RAM and 12 GB storage and start a Debian installation:
 
-`virt-install --name {{vm_name}} --memory {{1024}} --disk path={{path/to/image.qcow2}},size={{12}} --cdrom {{path/to/debian.iso}}`
+`virt-install {{[-n|--name]}} {{vm_name}} --memory {{1024}} --disk path={{path/to/image.qcow2}},size={{12}} {{[-c|--cdrom]}} {{path/to/debian.iso}}`
 
 - Create a x86-64, KVM-accelerated, UEFI-based virtual machine with the Q35 chipset, 4 GiB RAM, 16 GiB RAW storage, and start a Fedora installation:
 
-`virt-install --name {{vm_name}} --arch {{x86_64}} --virt-type {{kvm}} --machine {{q35}} --boot {{uefi}} --memory {{4096}} --disk path={{path/to/image.raw}},size={{16}} --cdrom {{path/to/fedora.iso}}`
+`virt-install {{[-n|--name]}} {{vm_name}} --arch {{x86_64}} --virt-type {{kvm}} --machine {{q35}} --boot {{uefi}} --memory {{4096}} --disk path={{path/to/image.raw}},size={{16}} {{[-c|--cdrom]}} {{path/to/fedora.iso}}`
 
 - Create a diskless live virtual machine without an emulated sound device or a USB controller. Don't start an installation and don't autoconnect to console but attach a cdrom to it (might be useful for when using a live CD like tails):
 
-`virt-install --name {{vm_name}} --memory {{512}} --disk {{none}} --controller {{type=usb,model=none}} --sound {{none}} --autoconsole {{none}} --install {{no_install=yes}} --cdrom {{path/to/tails.iso}}`
+`virt-install {{[-n|--name]}} {{vm_name}} --memory {{512}} --disk {{none}} --controller {{type=usb,model=none}} --sound {{none}} --autoconsole {{none}} --install {{no_install=yes}} {{[-c|--cdrom]}} {{path/to/tails.iso}}`
 
 - Create a virtual machine with 16 GiB RAM, 250 GiB storage, 8 cores with hyperthreading, a specific CPU topology, and a CPU model that shares most features with the host CPU:
 
-`virt-install --name {{vm_name}} --cpu {{host-model}},topology.sockets={{1}},topology.cores={{4}},topology.threads={{2}} --memory {{16384}} --disk path={{path/to/image.qcow2}},size={{250}} --cdrom {{path/to/debian.iso}}`
+`virt-install {{[-n|--name]}} {{vm_name}} --cpu {{host-model}},topology.sockets={{1}},topology.cores={{4}},topology.threads={{2}} --memory {{16384}} --disk path={{path/to/image.qcow2}},size={{250}} {{[-c|--cdrom]}} {{path/to/debian.iso}}`
 
 - Create a virtual machine and kickstart an automated deployment based on Fedora 35 using only remote resources (no ISO required):
 
-`virt-install --name {{vm_name}} --memory {{2048}} --disk path={{path/to/image.qcow2}},size={{20}} --location={{https://download.fedoraproject.org/pub/fedora/linux/releases/35/Everything/x86_64/os/}} --extra-args="{{inst.ks=https://path/to/valid/kickstart.org}}"`
+`virt-install {{[-n|--name]}} {{vm_name}} --memory {{2048}} --disk path={{path/to/image.qcow2}},size={{20}} {{[-l|--location]}} {{https://download.fedoraproject.org/pub/fedora/linux/releases/35/Everything/x86_64/os/}} {{[-x|--extra-args]}} "{{inst.ks=https://path/to/valid/kickstart.org}}"`

pages/common/virt-qemu-run.md

@@ -9,12 +9,12 @@
 
 - Run a QEMU virtual machine and store the state in a specific directory:
 
-`virt-qemu-run --root={{path/to/directory}} {{path/to/guest.xml}}`
+`virt-qemu-run {{[-r|--root]}} {{path/to/directory}} {{path/to/guest.xml}}`
 
 - Run a QEMU virtual machine and display verbose information about the startup:
 
-`virt-qemu-run --verbose {{path/to/guest.xml}}`
+`virt-qemu-run {{[-v|--verbose]}} {{path/to/guest.xml}}`
 
 - Display help:
 
-`virt-qemu-run --help`
+`virt-qemu-run {{[-h|--help]}}`

pages/common/virt-sparsify.md

@@ -2,7 +2,7 @@
 
 > Make virtual machine drive images thin-provisioned.
 > Note: Use only for offline machines to avoid data corruption.
-> More information: <https://libguestfs.org>.
+> More information: <https://manned.org/virt-sparsify>.
 
 - Create a sparsified compressed image without snapshots from an unsparsified one:
 

pages/common/x11docker.md

@@ -2,23 +2,23 @@
 
 > Securely run GUI applications and desktop UIs in Docker containers.
 > See also `xephyr`.
-> More information: <https://github.com/mviereck/x11docker>.
+> More information: <https://github.com/mviereck/x11docker#terminal-syntax>.
 
 - Launch VLC in a container:
 
-`x11docker --pulseaudio --share={{$HOME/Videos}} {{jess/vlc}}`
+`x11docker {{[-p|--pulseaudio]}} --share {{$HOME/Videos}} {{jess/vlc}}`
 
 - Launch Xfce in a window:
 
-`x11docker --desktop {{x11docker/xfce}}`
+`x11docker {{[-d|--desktop]}} {{x11docker/xfce}}`
 
 - Launch GNOME in a window:
 
-`x11docker --desktop --gpu --init={{systemd}} {{x11docker/gnome}}`
+`x11docker {{[-d|--desktop]}} {{[-g|--gpu]}} --init={{systemd}} {{x11docker/gnome}}`
 
 - Launch KDE Plasma in a window:
 
-`x11docker --desktop --gpu --init={{systemd}} {{x11docker/kde-plasma}}`
+`x11docker {{[-d|--desktop]}} {{[-g|--gpu]}} --init={{systemd}} {{x11docker/kde-plasma}}`
 
 - Display help: