prezto/modules/gnu-utility/README.md

# GNU Utility

Provides for the interactive use of GNU utilities on BSD systems.

Installing GNU utilities on non-GNU systems in `$PATH` without a prefix, i.e.,
`ls` instead of `gls`, is not recommended since scripts that target other
utilities will be broken.

This module wraps GNU utilities in functions without a prefix for interactive
use.

This module must be loaded _before_ the [_`utility`_][1] module so that GNU
utilities enabled in this module are available for configuration in _`utility`_
module.

## Settings

### Prefix

To use a different prefix, add the following to
_`${ZDOTDIR:-$HOME}/.zpreztorc`_, and replace `'g'` with the desired prefix.

```sh
zstyle ':prezto:module:gnu-utility' prefix 'g'
```

## Authors

_The authors of this module should be contacted via the [issue tracker][2]._

- [Sorin Ionescu](https://github.com/sorin-ionescu)

[1]: ../utility#readme
[2]: https://github.com/sorin-ionescu/prezto/issues
general: Reformat documentation with better formatting and wording General purpose reformating and rewording in (a few places). This should also make markdown linting happier. Prefer back-ticks wherever useful and use `console` for code blocks to be executed on terminal. Also, update references links wherever possible (including update from 'http://' to 'https://'). 2021-05-04 01:59:31 +00:00			`# GNU Utility`
Add documentation for gnu-utils 2012-04-04 13:01:25 +00:00
[Fix #698] Describe module in README the same as in code 2014-10-15 22:54:24 +00:00			`Provides for the interactive use of GNU utilities on BSD systems.`
Add documentation for gnu-utils 2012-04-04 13:01:25 +00:00
general: Reformat documentation with better formatting and wording General purpose reformating and rewording in (a few places). This should also make markdown linting happier. Prefer back-ticks wherever useful and use `console` for code blocks to be executed on terminal. Also, update references links wherever possible (including update from 'http://' to 'https://'). 2021-05-04 01:59:31 +00:00			Installing GNU utilities on non-GNU systems in `$PATH` without a prefix, i.e.,
Remove 'core' from gnu-utility documentation It works with more than GNU Core Utilities. 2012-04-11 20:48:09 +00:00			`ls` instead of `gls`, is not recommended since scripts that target other
			`utilities will be broken.`
Add documentation for gnu-utils 2012-04-04 13:01:25 +00:00
[Fix #348] Clarify how GNU utilities are wrapped 2012-12-21 00:11:17 +00:00			`This module wraps GNU utilities in functions without a prefix for interactive`
			`use.`
Add documentation for gnu-utils 2012-04-04 13:01:25 +00:00
general: Update documentation better qualifying runcom paths Zsh and Prezto files don't always reside in `~/`. Instead, they have a more spec compliant location (`${ZDOTDIR:-$HOME}/`). Make them unambiguous in the documentation. Likewise, for `$GNUPGHOME`. Further, add instruction for optionally setting up Prezto in `$XDG_CONFIG_HOME`. While at this, also add clarification on relative ordering of some of the modules, apply more formatting tweaks and doc improvements. 2021-05-05 17:59:01 +00:00			This module must be loaded _before_ the [_`utility`_][1] module so that GNU
			utilities enabled in this module are available for configuration in _`utility`_
			`module.`
[#135] Inform of the gnu-utility loading order 2012-05-20 23:02:52 +00:00
general: Reformat documentation with better formatting and wording General purpose reformating and rewording in (a few places). This should also make markdown linting happier. Prefer back-ticks wherever useful and use `console` for code blocks to be executed on terminal. Also, update references links wherever possible (including update from 'http://' to 'https://'). 2021-05-04 01:59:31 +00:00			`## Settings`
Add documentation for gnu-utils 2012-04-04 13:01:25 +00:00
			`### Prefix`

general: Update documentation better qualifying runcom paths Zsh and Prezto files don't always reside in `~/`. Instead, they have a more spec compliant location (`${ZDOTDIR:-$HOME}/`). Make them unambiguous in the documentation. Likewise, for `$GNUPGHOME`. Further, add instruction for optionally setting up Prezto in `$XDG_CONFIG_HOME`. While at this, also add clarification on relative ordering of some of the modules, apply more formatting tweaks and doc improvements. 2021-05-05 17:59:01 +00:00			`To use a different prefix, add the following to`
			_`${ZDOTDIR:-$HOME}/.zpreztorc`_, and replace `'g'` with the desired prefix.
Add documentation for gnu-utils 2012-04-04 13:01:25 +00:00
[general] Switch code block formatting to use fence formatting Changes: * Indented code block doesn't support syntax highlighting, use fenced formatting (```) instead for better syntax highlighting * Wrap commands/functions in backticks * Typo fixes 2017-07-21 01:07:29 +00:00			```sh
			`zstyle ':prezto:module:gnu-utility' prefix 'g'`
			```
Add documentation for gnu-utils 2012-04-04 13:01:25 +00:00
general: Reformat documentation with better formatting and wording General purpose reformating and rewording in (a few places). This should also make markdown linting happier. Prefer back-ticks wherever useful and use `console` for code blocks to be executed on terminal. Also, update references links wherever possible (including update from 'http://' to 'https://'). 2021-05-04 01:59:31 +00:00			`## Authors`
Add documentation for gnu-utils 2012-04-04 13:01:25 +00:00
general: Update documentation better qualifying runcom paths Zsh and Prezto files don't always reside in `~/`. Instead, they have a more spec compliant location (`${ZDOTDIR:-$HOME}/`). Make them unambiguous in the documentation. Likewise, for `$GNUPGHOME`. Further, add instruction for optionally setting up Prezto in `$XDG_CONFIG_HOME`. While at this, also add clarification on relative ordering of some of the modules, apply more formatting tweaks and doc improvements. 2021-05-05 17:59:01 +00:00			`_The authors of this module should be contacted via the [issue tracker][2]._`
Add documentation for gnu-utils 2012-04-04 13:01:25 +00:00
general: Reformat documentation with better formatting and wording General purpose reformating and rewording in (a few places). This should also make markdown linting happier. Prefer back-ticks wherever useful and use `console` for code blocks to be executed on terminal. Also, update references links wherever possible (including update from 'http://' to 'https://'). 2021-05-04 01:59:31 +00:00			`- [Sorin Ionescu](https://github.com/sorin-ionescu)`
Clean up READMEs 2012-05-22 00:18:30 +00:00
general: Update documentation better qualifying runcom paths Zsh and Prezto files don't always reside in `~/`. Instead, they have a more spec compliant location (`${ZDOTDIR:-$HOME}/`). Make them unambiguous in the documentation. Likewise, for `$GNUPGHOME`. Further, add instruction for optionally setting up Prezto in `$XDG_CONFIG_HOME`. While at this, also add clarification on relative ordering of some of the modules, apply more formatting tweaks and doc improvements. 2021-05-05 17:59:01 +00:00			`[1]: ../utility#readme`
			`[2]: https://github.com/sorin-ionescu/prezto/issues`