summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorCarlo Sala <carlosalag@protonmail.com>2023-05-02 12:41:01 +0200
committerCarlo Sala <carlosalag@protonmail.com>2023-05-06 13:39:01 +0200
commitc5208867f1eb46f722e040b239150817abec87a6 (patch)
tree79fda8f6be2827ac4200cb46b2bd59cb022a87a9 /README.md
parent5a3f565e7d4371db92ba574f231b396c2c8c9a19 (diff)
downloadzsh-c5208867f1eb46f722e040b239150817abec87a6.tar.gz
zsh-c5208867f1eb46f722e040b239150817abec87a6.tar.bz2
zsh-c5208867f1eb46f722e040b239150817abec87a6.zip
feat(theme-and-appearance): allow disabling gnu-ls in bsd
To disable gnu-ls (`gls`) even if it's installed in freeBSD and macOS you can set it up with: ```zsh zstyle ':omz:lib:theme-and-appearance' gnu-ls no ``` Closes #11647
Diffstat (limited to 'README.md')
-rw-r--r--README.md13
1 files changed, 13 insertions, 0 deletions
diff --git a/README.md b/README.md
index 556d4c8c5..650fb00ea 100644
--- a/README.md
+++ b/README.md
@@ -40,6 +40,7 @@ To learn more, visit [ohmyz.sh](https://ohmyz.sh), follow [@ohmyzsh](https://twi
- [Manual Installation](#manual-installation)
- [Installation Problems](#installation-problems)
- [Custom Plugins and Themes](#custom-plugins-and-themes)
+ - [Disable GNU ls in macOS and freeBSD systems](#disable-gnu-ls)
- [Skip aliases](#skip-aliases)
- [Getting Updates](#getting-updates)
- [Updates verbosity](#updates-verbosity)
@@ -278,6 +279,18 @@ If you have many functions that go well together, you can put them as a `XYZ.plu
If you would like to override the functionality of a plugin distributed with Oh My Zsh, create a plugin of the same name in the `custom/plugins/` directory and it will be loaded instead of the one in `plugins/`.
+### Disable GNU ls in macOS and freeBSD systems
+
+<a name="disable-gnu-ls"></a>
+
+The default behaviour in Oh My Zsh is to use GNU `ls` even in macOS and freeBSD systems if it's installed (as
+`gls` command) when enabling colorized `ls` in `lib/theme-and-appearance.zsh`. If you want to disable this
+behaviour you can use zstyle-based config before sourcing `oh-my-zsh.sh`:
+
+```zsh
+zstyle ':omz:lib:theme-and-appearance' gnu-ls no
+```
+
### Skip aliases
<a name="remove-directories-aliases"></a>