qusal/salt/utils/tools/zsh/README.md

# zsh

Zsh environment in Qubes OS.

## Table of Contents

*   [Description](#description)
*   [Installation](#installation)
*   [Usage](#usage)

## Description

Install Zsh, setup it to be the user shell and touch ~/.zshrc to avoid
warnings.

## Installation

*   Top:

```sh
sudo qubesctl top.enable utils.tools.zsh
sudo qubesctl --targets=TARGET state.apply
sudo qubesctl top.disable utils.tools.zsh
```

*   State:

<!-- pkg:begin:post-install -->

```sh
sudo qubesctl --skip-dom0 --targets=TEMPLATEVMS state.apply utils.tools.zsh.change-shell
sudo qubesctl --skip-dom0 --targets=APPVMS state.apply utils.tools.zsh.touch-zshrc
```

<!-- pkg:end:post-install -->

## Usage

Standard Zsh usage. No extra configuration required.
refactor: initial commit 2023-11-13 14:33:28 +00:00			`# zsh`

			`Zsh environment in Qubes OS.`

			`## Table of Contents`

doc: lint markdown files Only way to have a unified markdown syntax is to enforce the wanted syntax by linting the files. Don't rely on the many markdown syntaxes, be consistent. 2024-07-04 17:10:11 +02:00			`* [Description](#description)`
			`* [Installation](#installation)`
			`* [Usage](#usage)`
refactor: initial commit 2023-11-13 14:33:28 +00:00
			`## Description`

			`Install Zsh, setup it to be the user shell and touch ~/.zshrc to avoid`
			`warnings.`

			`## Installation`

doc: lint markdown files Only way to have a unified markdown syntax is to enforce the wanted syntax by linting the files. Don't rely on the many markdown syntaxes, be consistent. 2024-07-04 17:10:11 +02:00			`* Top:`

refactor: initial commit 2023-11-13 14:33:28 +00:00			```sh
doc: prefix qubesctl with sudo Fixes: https://github.com/ben-grande/qusal/issues/20 2024-02-23 16:54:35 +01:00			`sudo qubesctl top.enable utils.tools.zsh`
			`sudo qubesctl --targets=TARGET state.apply`
			`sudo qubesctl top.disable utils.tools.zsh`
refactor: initial commit 2023-11-13 14:33:28 +00:00			```

doc: lint markdown files Only way to have a unified markdown syntax is to enforce the wanted syntax by linting the files. Don't rely on the many markdown syntaxes, be consistent. 2024-07-04 17:10:11 +02:00			`* State:`

refactor: initial commit 2023-11-13 14:33:28 +00:00			`<!-- pkg:begin:post-install -->`
doc: lint markdown files Only way to have a unified markdown syntax is to enforce the wanted syntax by linting the files. Don't rely on the many markdown syntaxes, be consistent. 2024-07-04 17:10:11 +02:00
refactor: initial commit 2023-11-13 14:33:28 +00:00			```sh
doc: prefix qubesctl with sudo Fixes: https://github.com/ben-grande/qusal/issues/20 2024-02-23 16:54:35 +01:00			`sudo qubesctl --skip-dom0 --targets=TEMPLATEVMS state.apply utils.tools.zsh.change-shell`
			`sudo qubesctl --skip-dom0 --targets=APPVMS state.apply utils.tools.zsh.touch-zshrc`
refactor: initial commit 2023-11-13 14:33:28 +00:00			```
doc: lint markdown files Only way to have a unified markdown syntax is to enforce the wanted syntax by linting the files. Don't rely on the many markdown syntaxes, be consistent. 2024-07-04 17:10:11 +02:00
refactor: initial commit 2023-11-13 14:33:28 +00:00			`<!-- pkg:end:post-install -->`

			`## Usage`

			`Standard Zsh usage. No extra configuration required.`