From b631c0bfa8a60ed6d1e38e6aec5b110950eeef02 Mon Sep 17 00:00:00 2001 From: Colin Hebert Date: Wed, 4 Apr 2012 14:01:25 +0100 Subject: [PATCH] Add documentation for gnu-utils --- plugins/gnu-utils/README.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 plugins/gnu-utils/README.md diff --git a/plugins/gnu-utils/README.md b/plugins/gnu-utils/README.md new file mode 100644 index 00000000..24bf6e7f --- /dev/null +++ b/plugins/gnu-utils/README.md @@ -0,0 +1,27 @@ +gnu-utils +========= + +Allow to use an alternate set of coreutils ([GNU coreutils][1]). + +On some systems, such as Mac OS, the coreutils installed aren't the +gnu-coreutils. +In this case it's possible to install GNU coreutils, allowing to access to GNU +coreutils commands with a different prefix (ie: `gls` for `ls`). + +Some installers create, during the installation of GNU coreutils, an alternative +folder containing the same commands with a "vanilla name" (actually `ls`). +This allows to add the said folder to `PATH`. +This solution can be a problem if you only want the GNU coreutils commands +inside your zsh session (and you want to run scripts that still use the original +coreutils). +The _gnu-utils plugin_ takes care of that by "hashing" the commands instead of +adding them to the `PATH`. + +Authors +------- + +*The authors of this plugin should be contacted via the github bug tracker.* + + - [Sorin Ionescu](/sorin-ionescu) + +[1]: http://www.gnu.org/software/coreutils/