From 80de3780c13b7c27c67737a0225716f657589dd4 Mon Sep 17 00:00:00 2001 From: Cameron Katri Date: Wed, 28 Apr 2021 14:41:53 -0400 Subject: Add README.md --- README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..fb3f3ed --- /dev/null +++ b/README.md @@ -0,0 +1,10 @@ +# opendircolors +A BSD-licensed replacement for GNU dircolors(1) + +FreeBSD's (and MacOS') `ls(1)` supports colors using the `LSCOLORS` variable, where as GNU's uses the more customizable `LS_COLORS` which is generated with the command `dircolors(1)` in coreutils. This repo contains two different utilites, `opendircolors(1)` and `dirconvert(1)`. + +### `opendircolors(1) [-bch] file` +A near drop in replacement for GNU's `dircolors(1)`, lacking only built in defaults and `-p`. This will read from `file` and prints the commands needed to set both `LSCOLORS` and `LS_COLORS`. The typical usage is to add ``eval "`opendircolors ~/.dir_colors`"`` to your `.*shrc`. + +### `dirconvert(1) LSCOLORS | LS_COLORS` +Will read the inputed string and convert it to the other format, ignoring anything that can't be converted. -- cgit v1.2.3-56-ge451