homebrew: Add a wrapper function for the brew(1) command

This wrapper function for the `brew`(1) command does the following:

- Detect the location of the "real" brew(1) command.
- Change user and group when the Homebrew installation is owned by a different
  user (to preserve sane file permissions).
- Set a relaxed umask(1) so that other users can use software installed by
  Homebrew.
- Call the "real" `brew`(1) command.

std_aliases: Add new "lx" alias for "ls -A"

lsd: Don't use long options in the ls(1) alias

Both the "--date" and "--group-dirs" options are "nice", and I'd like to
set them here, but it looks like long options break the file name
completion logic: when a long option is present, you can't tab-complete
any file or folder name any more, which is _really_ annoying!

So remove those options again (for now)!?

If you wan't to use long options, like the ones removed now here, you
can use a configuration file in ~/.config/lsd/config.yaml, for example.

New "lsd" plugin

New "bat" plugin

Fix markdownling warning MD049: Emphasis style should be consistent

Update copyright notices for 2022 :-)

std_functions: Make open_command() work on Linux without X11 running

New "websearch" plugin

std_functions: Fix return code of open_command()

Write an initial PATH variable to the "ax-io" cache file

This initial PATH  becomes overwritten by the path plugin at the
"zprofile" stage later on, but this way "ax-io" stage plugins have a
somewhat saner PATH to begin with ...

Simplify error checking on cache file creation

Just try to write to the cache file without testing first. And the
"cache_file" variable can never be empty, see code above!

Disable Powerlevel9k "instant prompt" warnings in debug mode

30_path: Fix file name in header

axzshctl: Be verbose for "axzshctl update-caches" in debug mode

byebye: Be silent in "check mode"

Git: Ignore the "debug"-mode trigger file

less: Hide "ps: stdin: not a terminal" when using lesspipe.sh

axttyinfo: Show COLORTERM when set

axttyinfo: Show LANG only when actually set

axemoji: Show host name in root prompts

Refactor "root prompt" handling, don't show root "logname" by default

But still enable it for the axemoji theme, so no functional changes.

Revert 'Set "path" and "manpath" as "unique" type (-U), too!'

When setting "path" to unique, PATH becomes reset on some systems? Hm??
So don't do it ...

This reverts commit 25cf1cc8c8c30f0162e551d6fdfdd84212b24395.

axzshctl: Show hint how to restart the shell when enabling AX-ZSH

axzshctl wrapper: Clean up the environment when disabling AX-ZSH

Fix PATH environment after plugins ran

This is especially important to keep the desired search order in place
when other plugins appended/prepended paths.

Set "path" and "manpath" as "unique" type (-U), too!

Fix core plugin numbering

[0-4]*: Runs pre-plugins
[5-9]*: Runs post-plugins

Refactoring: Always use "[[" (instead of "[")

No functional changes.

12_locale: Some minor tweaks and refactoring

- Regular expressions aren't anchored, no .* needed at the beginning/end
- fgrep is "non standard", so use "grep -F"
- Quote unknown locale name in message ...
- And use "raw mode" (-r) for read.

homebrew: Make sure brew(1) command actually works

There are wrapper scripts out there -- at least my own ;-) -- which
are available even on systems where no "real" brew is available, and
therefore this wrapper errors our when called. So not only check for
brew's existence, but if it is working when checking for plugins.

fzf: Update plugin to work on Fedora 35

README.md: Add "integration with other projects" section

And mention Powerlevel10k support!

README.md: Reformat the file a bit

- Add more links, as references at the end of the document.
- Add link to our own GitHub "homepage".
- Emphasis that you really should use Git to install AX-ZSH!
- Fix link to zdharma-continuum/fast-syntax-highlighting

2021. Still ... ;)

homebrew: Fix detection of Homebrew command completions

neofetch: Implement axzsh_neofetch() function

This function can be used to call neofetch(1) exactly as the plugin does.

Enhance handling of the Homebrew environment

- Call "brew shellenv" to set all relevant environment variables,
- and use "$HOMEBREW_PREFIX" when looking for installed files.

Refactoring: Use "axzsh_" prefix (instead of "ax_") for all functions & variables

New function names:
- axzsh_hostname_prompt_root()
- axzsh_hostname_prompt_yn()
- axzsh_logname_prompt_root()
- axzsh_logname_prompt_yn()
- axzsh_plugin_fnc()
- axzsh_plugin_init()
- axzsh_prompt()
- axzsh_vcs_prompt()
- _axzsh_ssh_prompt()

New array names:
- axzsh_hostname_prompt_functions
- axzsh_logname_prompt_functions
- axzsh_vcs_prompt_functions

std_functions: Add (very simple) "open" function

Right now, this supports macOS (Darwin), Cygwin and Linux.

40_path: Add Go and Cargo bin paths to $PATH when they exist

git: Add "gsta" and "gstp" aliases for Git stash push/pop

30_env.ax-io: Try to use a user-specific subfolder when TMPDIR is not set

git: Bring aliases in line with OhMyZsh (and extend our list!)

Changed:
* gc: Add "--verbose"
* gd: Remove "--patch-with-stat"
* gst: Use default format

Removed:
* gdc: Deprecated in OhMyZsh ...

New:
* g
* gapa
* gdca
* gdcw
* gdw
* gf
* gfa
* gl
* gp
* gsb
* gsh
* gss

axzshctl: Allow dashes in OhMyZsh plugin names

Greatly enhance the README.md file

Add support for remote OhMyZsh plugins

OhMyZsh plugins are referenced by an "@ohmyzsh/<name>" identifier, and
the OhMyZsh source tree is cloned with Git as needed.

std_aliases: Use "last -aw" for "lastf" and "lasth" aliases

axzshctl: Fix syntax of "set-theme" in help output

install.sh: Correctly report an error when "zsh" is not found

fzf: Newer Debian/Ubuntu packages use a different folder layout

googler: Use "g0" alias to not clash with OhMyZsh "g" alias for "git"

axzshctl: Validate plugin names in EnablePlugin()

ax.zsh: Put new cache files in place only after they are complete

ax.zsh: Don't call mkdir(1) unconditionally

ax.zsh: Fix comment, output is only allowed in "ax-io" stage!

axzshctl: Only auto-complete enabled plugins on "disable-plugin" subcommand

axzshctl: Make UpdatePluginCache() less verbose by default

axzshctl: Delete ZSH cache folder on "update-caches", too

50_completion: Try to find all available completion functions

Try to add all folders possibly containing completion functions to the
fpath before calling compinit. See <https://github.com/ohmyzsh/ohmyzsh/issues/4614>
for a discussion of this topic, for example. It boils down to:

1. We have to call compinit early,
2. but plugins can add completions later, that won't be found ...

Get rid of "bash_completion" default plugin

The "bashcompinit" system results in way too many errors, and the
dysfunctional bash completions even shadow working ZSH completion
functions way too often. This makes no sense. Get rid of it!

googler: Show browser output by default

New "browser_select" plugin

editor_select: Mark plugin as optional

googler: Limit number of results depending on LINES available

editor_select: Alias "zshrnv" in non-login shells, too!

Add new "starship" theme wrapper

See <https://starship.rs>.

Note: This is a wrapper for the starship(1) command to integrate it into
AX-ZSH. You still need it installed first!

ssh: Slightly enhance file comments

30_env.ax-io: Create individual XDG_RUNTIME_DIR, when not set

30_env.ax-io: Use mktemp(3) to detect default remporary directory

cheat: Add c() function for browsing cht.sh when fzf(1) is available

Handle plugins with ".plugin.zsh" folder suffix

axzshctl: Handle GitHub plugins with dots (".") in their names

New "autojump" plugin

axzshctl: Bring Git updates in line and show logs

Bring Git update commands for AX-ZSH and plugins in line (same error
handling), and show one-line summaries of commits pulled in.

01_zprofile.zshrc: Don't forget the "ax-io" stage!

01_zprofile.zshrc: Don't duplicate code, call axzsh_handle_stage()

Correctly mark variables as local in axzsh_handle_stage()

Move 3rd-party integration into axzsh_handle_stage()

The "debug mode" does not depend on "AXZSH" being unset

Split 30_env into "ax-io" and "zshrc" stage

We want it to fix TMPDIR etc. in non-login shells, too! And this makes
sense, as there are some startup sequences (for example when using
screen(1) or tmux(1)) which result in br0ken TMPDIR settings ..

axzshctl set-theme completion: Look for all types in custom_themes/ and rpositories

calendar: Check for successful invocation, not only presence

30_env: Tweak TMPDIR handling, no longer bother with TMP

Move the whole 30_env plugin logic to the "ax-io" stage, so that all
other plugins in all stages can depend on it.

And make sure that TMPDIR ...
- is set and writable; show a warning message if not;
- always ends with a "/", which makes its usage a bit safer.

Don't use $HOSTNAME or call hostname(1), use $HOST instead!

Add a hint to ax.zsh, so that iTerm2 doesn't add its shell integration

You should enable the iTerm2 plugin instead!

iterm2: Update integration, add iterm2_clear_captured_output() function

This brings our integration in line with upstream v12 (don't cache the
host name; we simply use $HOST now), fixes some typos, enhances the test
for the iterm2_print_user_vars() function and introduces a ax-zsh
specific new iterm2_clear_captured_output() function.

axzshctl check-plugins: Use a subshell and cache core zshrc-stage plugins

This reduces execution time of "axzshctl check-plugins" on one of my
macOS machines from ~24 down to ~8 seconds. Wow!

00-newline: This plugin is optional for "axzshctl check-plugins"

axzshctl: Embed "ax-common" compatibility functions

axzshctl check-plugins: Enhance output

axzshctl check-plugins: Correctly handle "ax-io" plugins

history: Make sure HISTFILE is set

Not setting HISTFILE at all disables the history mechanism completely,
so validate this and set HISTFILE, when not done already on the
system-level, for example.

This somewhat reverts commit 7ec1869f094410a2fa14da065fda0e0421446ada.

iterm2: Enable use inside of tmux(1) sessions

iterm2: Add iTerm 2 tools folder to search path

std_aliases: Add some more common aliases

Add "la", "-", "md" and "rd" aliases known from OhMyZsh.

history: Introduce the clear_history() function

less: Explicitely set the PAGER variable to the path of less(1)

history: Don't fiddle with HISTFILE, use its defaults

Don't relocate it to $ZSH_CACHE_DIR, as it clearly is not "cached data":
it can't be recreated when lost!

Add "00-newline" plugin