Squashed 'tmux/.tmux/plugins/tmux-sensible/' content from commit e31a671

git-subtree-dir: tmux/.tmux/plugins/tmux-sensible
git-subtree-split: e31a671

LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <https://unlicense.org>

README.md

@@ -0,0 +1,209 @@
+# .stowed
+This repository is used to store all dot-config files for various shells and editors.  This repository can be cloned to a new linux machine which can be setup quickly with GNU `stow`. This will bring back all custom shell and editor configurations or easily sync custom configuration between linux machines.
+
+[How Nested Git Repositories Are Configured - For Reference ONLY](nested_git_repos.md):  A reference on how this .stowed repository was created with the various nested git repositories for the shell and editor plugins.
+
+**Stowed Terminal Tools:**
+- tmux
+
+**Stowed Shells:**
+- bash
+- zsh
+
+**Stowed Editors:**
+- nvim
+- vim
+- emacs
+
+## How To Use GNU Stow
+### 1) Install GNU Stow
+```console
+# Install Stow
+sudo apt install -y stow
+```
+
+### 2) Clone This Repo on a New Linux Host
+```console
+git clone https://github.com/badaniya/.stowed $HOME/.stowed
+```
+
+### 3) Run Stow Command to Establish Symlinks to the Repository
+```console
+# Create Symlinks to Repo
+stow -d $HOME/.stowed tmux bash zsh nvim vim emacs
+
+# To Force Symlink Creation (NOTE: May miss some hidden files or symlinks)
+stow -d $HOME/.stowed --adopt tmux bash zsh nvim vim emacs
+cd $HOME/.stowed
+git reset --hard HEAD
+
+# Sure-file Way to Ensure Stow Symlink Creation (NOTE: Ensure the GNU Stow succeeds before quitting the shell) 
+rm -rf $HOME/.bash*; rm -rf $HOME/.zsh*; rm -rf $HOME/.oh-my-zsh; rm -rf $HOME/.config/nvim; rm -rf $HOME/.vim*; rm -rf $HOME/.emacs*; stow -d $HOME/.stowed bash zsh nvim vim emacs
+```
+
+## Follow-up Package Installation for Shell/Editor Tools
+### 1) Tmux
+```console
+# tmux: Ubuntu package version
+sudo apt install -y tmux
+```
+
+### 2) Zsh
+```console
+# zsh: Ubuntu package version
+sudo apt install -y zsh
+
+# powerline: Terminal fonts for zsh bullet-train theme
+sudo apt install fonts-powerline
+```
+
+### 3) Neovim
+```console
+# neovim: Latest version
+curl -LO https://github.com/neovim/neovim/releases/latest/download/nvim-linux64.tar.gz
+sudo rm -rf /opt/nvim
+sudo tar -C /opt -xzf nvim-linux64.tar.gz
+
+# ripgrep: For NeoVIM search
+sudo apt install -y ripgrep
+
+# nerdfont: Terminal fonts for nvim theme
+wget https://github.com/ryanoasis/nerd-fonts/releases/download/v3.2.1/JetBrainsMono.zip
+unzip -od ~/.local/share/fonts/ JetBrainsMono.zip
+fc-cache -fv
+```
+
+### 3.1) Neovim Plugin Dependencies
+#### Database UI Plugin
+```console
+# DB UI - postgres/mysql (vim-dadbod and vim-dadbod-ui)
+sudo apt install -y postgresql-client
+sudo apt install -y mariadb-client 
+```
+
+### 4) Vim
+```console
+sudo apt install -y vim
+```
+
+### 5) Emacs
+```console
+sudo apt-add-repository -y ppa:kelleyk/emacs
+sudo apt update -y
+sudo apt install -y emacs28
+```
+
+## Linux Development Environment Setup
+### 1) Golang
+```console
+# golang:
+golang_version="1.22.1"
+wget https://go.dev/dl/go"$golang_version".linux-amd64.tar.gz
+sudo tar -xvf go"$golang_version".linux-amd64.tar.gz
+sudo rm -rf /usr/local/go && sudo mv go /usr/local
+
+# gopls:
+go install golang.org/x/tools/gopls@latest
+
+# dlv:
+go install github.com/go-delve/delve/cmd/dlv@latest
+
+# golangci-lint:
+curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sudo sh -s -- -b /usr/bin v1.55.2
+
+# gosec:
+cd ~/.go
+curl -sSfL https://raw.githubusercontent.com/securego/gosec/master/install.sh | sh -s v2.18.1
+
+# gotestsum:
+go install gotest.tools/gotestsum@latest
+```
+
+## How to Use These Stowed Shell/Editor Tools
+```console
+# 1) Start a new tmux session
+tmux [new -s <session-name>]
+
+# 2) Start nvim from within tmux to maintain session persistence across remote shell logins
+nvim
+```
+
+## General Tmux Session Commands
+```console
+# 1) List existing tmux sessions
+tmux ls
+
+# 2) Detach from a tmux session
+tmux detach
+
+# 3) Attach to a tmux session
+tmux attach -t <# | session-name>
+
+# 4) Delete all tmux sessions
+tmux kill-session
+```
+
+## Tmux Key Bindings
+```console
+# General Tmux Bindings (<C> is the Ctrl key)
+<C-b> $ : Rename the tmux session name
+<C-b> c : Creates a new tmux window
+<C-b> " : Creates a new tmux pane horizontally split below
+<C-b> % : Creates a new tmux pane vertically split on the right
+<C-b> x : Exits current tmux pane or window (user prompted)
+<C-b> q : Displays tmux pane numbers
+<C-b> # : Switch to the tmux window number
+
+# Tmux Pane Switching
+<C-h> : Move to the pane on the left
+<C-j> : Move to the pane below
+<C-k> : Move to the pane above
+<C-l> : Move to the pane on the right
+
+# Newer Tmux 3.2 Copy/Paste
+<left-mouse-click> : copy
+<middle-mouse-click> : paste
+
+# Older Tmux 3.0a Copy/Paste
+<C-S-left-mouse-click> : copy
+<C-S-middle-mouse-click> : paste 
+```
+
+## Nvim Key Bindings
+```console
+# General Nvim Bindings
+<space> : Main leader key for all menus
+<\> : Toggle NeoTree - Directory Browser
+
+# Nvim Window Switching (<C> is the Ctrl key)
+<C-h> : Move to the window on the left
+<C-j> : Move to the window below
+<C-k> : Move to the window above
+<C-l> : Move to the window on the right
+
+# Nvim Tab Switching (<M> is the Alt key)
+<M-#> : Switch to the file tab #
+<M-,> : Switch to the file tab on the left
+<M-.> : Switch to the file tab on the right
+<M-<> : Move the current file tab position to the left
+<M->> : Move the current file tab position to the right 
+<M-c> : Close out the current file tab
+<M-p> : Toggle pinning the current file tab
+
+# Nvim Code Navigation
+<C-]> | <C-left-mouse-click>: Go to Definition
+<C-t> | <C-right-mouse-click> : Pop back up the stack
+<leader> gr : Goto References
+<leader> gI : Goto Implementations
+
+# Nvim Telescope
+<leader> sg : ripgrep search in project workspace
+<C-q> : Add telescope search results to the quickfix list
+
+# Nvim Debug
+<F2> : Step Into
+<F3> : Step Over
+<F4> : Step Out
+<F5> : Start/Continue
+<F8> : Toggle Breakpoint
+```