Update and comment provisioning scripts

apps/neovim/init.vim

@@ -177,6 +177,7 @@ Plug 'posva/vim-vue', {'for': ['vue']}
 Plug 'elixir-lang/vim-elixir', {'for': ['elixir', 'eelixir']}
 Plug 'mattn/emmet-vim', {'for': ['html']}
 Plug 'wavded/vim-stylus', {'for': ['styl', 'stylus', 'vue']}
+Plug 'quabug/vim-gdscript', {'for': ['gd', 'gdscript']}
 Plug 'rust-lang/rust.vim', {'for': ['rs', 'rust']}
 Plug 'mustache/vim-mustache-handlebars', {'for': ['html.handlebars', 'handlebars', 'hbs']}
 Plug 'plasticboy/vim-markdown', {'for': ['md', 'markdown', 'vimwiki']}

apps/qutebrowser/keys.conf

@@ -452,6 +452,15 @@ record-macro
 run-macro
     @
 
+wq
+    ZZ
+
+tab-focus -1
+    g$
+
+tab-pin
+    <ctrl-p>
+
 [insert]
 # Keybindings for insert mode.
 # Since normal keypresses are passed through, only special keys are

scripts/arch-linux/provisioning/0-adduser.bash

@@ -1,10 +1,21 @@
 #!/usr/bin/env bash
 
+# user's username
 USERNAME=daniel
+GROUPS=admin,users,wheel
 
+# add admin group
 groupadd admin 2>/dev/null
+
+# create actual home directory
 mkdir -p "/home/$USERNAME/usr"
-useradd -m -d "/home/$USERNAME/usr" -G admin,users,wheel -s "/bin/bash" "$USERNAME"
+
+# add user with groups
+useradd -m -d "/home/$USERNAME/usr" -G "$GROUPS" -s "/bin/bash" "$USERNAME"
+
+# give home directory ownership
 chown -R "$USERNAME:$USERNAME" "/home/$USERNAME"
+
+# have user set new user's password
 echo "Setting password for user '$USERNAME'"
 passwd "$USERNAME"

scripts/arch-linux/provisioning/1-pacaur.bash

@@ -1,5 +1,7 @@
 #!/usr/bin/env bash
 
+# installs pacaur on a fresh arch install
+
 # install the dependencies
 sudo pacman -S git curl openssl perl expac yajl --noconfirm
 
@@ -26,4 +28,3 @@ cd -
 
 # once installed, let the package manager manage itself and its dependencies
 pacaur -S cower pacaur --noconfirm --noedit
-

scripts/arch-linux/provisioning/2-essentials.bash

@@ -1,51 +1,56 @@
 #!/usr/bin/env bash
 
 pacaur -S \
-	tree \
-	rofi \
-	the_silver_searcher ripgrep \
-	alsa-utils \
-	htop \
-	openssh \
-	openssl \
-	ruby \
-	nodejs npm \
-	python python-pip \
-	python2 python2-pip \
-	pass \
-	google-chrome-dev \
-	bash-completion \
-	fzf \
-	rsync \
-	pulseaudio pavucontrol \
-	neovim vim \
-	unzip \
-	xsel \
-	xclip \
-	tmux \
-	rxvt-unicode-pixbuf \
-	xorg-xinit xorg-server xorg-xrdb \
-	xcb-util xcb-util-keysyms xcb-util-wm xorg-xrandr xdotool feh xorg-xprop \
-	irssi \
-	pulseaudio-ctl \
-	alsa-plugins \
-	unclutter-xfixes-git gtk-engine-murrine xorg-server-devel \
-	bspwm-git sxhkd-git xdo-git \
-	terminus-font ttf-monaco \
-	ttf-freefont \
-	ttf-font-awesome \
-	curl \
-	w3m w3m-img \
+	tree `# Handy Filesystem Viewing Utility` \
+	rofi `# Application Launcher` \
+	the_silver_searcher ripgrep `# Code Search Utilities` \
+	alsa-utils `# Audio Utilities` \
+	htop `# Process Management and System Resources Monitoring` \
+	openssh `# Remote Access` \
+	openssl `# Crypto` \
+	ruby `# Language` \
+	nodejs npm `# Language` \
+	python python-pip `# Python 3 Language` \
+	python2 python2-pip `# Language` \
+	pass `# Password Management` \
+	google-chrome-dev `# Default Web Browser` \
+	bash-completion `# Handy Scripts for Tab-Completion in Bash` \
+	fzf `# Fuzzy File Finder` \
+	rsync `# File Transfer` \
+	pulseaudio pavucontrol `# Audio Backend and Controls` \
+	neovim vim `# Text Editors` \
+	unzip `# Handy Utility for ZIP Files` \
+	xsel `# Manage X Selection` \
+	xclip `# Manage X Clipboards` \
+	tmux `# Terminal Multiplexer` \
+	rxvt-unicode-pixbuf `# Terminal with PixBuf Patches` \
+	xorg-xinit xorg-server xorg-xrdb `# X.org Display Server` \
+	xorg-drivers `# Video Drivers for X?` \
+	xcb-util xcb-util-keysyms xcb-util-wm xorg-xrandr xdotool feh xorg-xprop `# X Utilties` \
+	pulseaudio-ctl `# CLI Utility for Pulseaudio` \
+	alsa-plugins `# Plugins for ALSA` \
+	unclutter-xfixes-git `# Hides cursor after no use for a time` \
+	gtk-engine-murrine xorg-server-devel `# GTK Theme Base and Headers?` \
+	bspwm-git sxhkd-git xdo-git `# Window Manager and Tools for its use` \
+	terminus-font ttf-monaco `# Primary Fonts` \
+	ttf-freefont `# Font` \
+	ttf-font-awesome `# Icon Font` \
+	curl `# HTTP Utility` \
+	w3m w3m-img `# Viewing Images in Terminals` \
 	--noconfirm --noedit
 
+# install text editor utilities
 sudo pip3 install neovim
 sudo pip2 install neovim
 
+# shortcut for browser
 sudo ln -s /usr/bin/google-chrome-unstable /usr/bin/chrome
 
+# install patched fonts
 mkdir -p "$HOME/.fonts/OTF"
 curl -L -o "$HOME/.fonts/OTF/monaco_powerline_nerd_font.otf" https://github.com/taohex/font/raw/master/Monaco%20for%20Powerline%20Nerd%20Font%20Complete.otf
 fc-cache -vf
 
+# install rxvt-unicode script for resizing font on-the-fly
 mkdir -p "$HOME/.urxvt/ext"
 curl -L -o "$HOME/.urxvt/ext/resize-font" https://raw.githubusercontent.com/simmel/urxvt-resize-font/master/resize-font

scripts/arch-linux/provisioning/3-extras.bash

@@ -1,31 +1,28 @@
 #!/usr/bin/env bash
 
 pacaur -S \
-	gtk-theme-arc-git \
-	xorg-drivers \
-	elementary-icon-theme \
-	lemonbar-xft-git \
-	thunar thunar-volman gvfs \
-	gvfs-smb \
-	ttf-opensans ttf-dejavu ttf-liberation \
-	avr-libc avr-gcc dfu-programmer dfu-util \
-	xorg-xbacklight \
-	gimp inkscape krita \
-	audacity \
-	reptyr \
-	cmake python python2-pip \
-	accountsservice \
-	xss-lock \
-	deluge \
-	lightdm lightdm-gtk-greeter \
-	polybar-git \
+	gtk-theme-arc-git `# GTK Theme` \
+	elementary-icon-theme `# GUI File Explorer Icons` \
+	thunar thunar-volman gvfs `# GUI File Explorer + Volume Management/Auto-Mount Disks)` \
+	gvfs-smb `# Auto-Detect Samba Shares` \
+	ttf-opensans ttf-dejavu ttf-liberation `# Fonts` \
+	avr-libc avr-gcc dfu-programmer dfu-util `# Keyboard Programming Utilities` \
+	xorg-xbacklight `# Xorg Backlight Control` \
+	gimp inkscape krita `# Image/Vector Editing Applications` \
+	audacity `# Audio Editing Application` \
+	cmake `# Cross-Platform Make` \
+	irssi `# IRC Client` \
+	accountsservice `# Mainly for User Avatars with LightDM` \
+	deluge `# GUI Torrent Client` \
+	lightdm lightdm-gtk-greeter `# Nice User Login` \
+	polybar-git `# Bar` \
 	php \
-	nginx \
-	urxvt-perls-git urxvt-resize-font-git \
-	samba \
-	neofetch \
-	cloc \
-	wine-staging lib32-libpulse \
-	ttf-noto-fonts-simple ttf-noto-fonts-ib noto-fonts-emoji \
-	siji-git gohufont artwiz-fonts phallus-fonts-git \
+	nginx `# Web Server` \
+	urxvt-perls-git urxvt-resize-font-git `# rxvt-unicode scripts` \
+	samba `# Sharing Files with other PCs` \
+	neofetch `# swag` \
+	cloc `# For counting lines of code` \
+	wine-staging lib32-libpulse `# WINE Goodies` \
+	ttf-noto-fonts-simple ttf-noto-fonts-ib noto-fonts-emoji `# Emoji` \
+	siji-git gohufont artwiz-fonts phallus-fonts-git `# Bitmap Fonts` \
 	--noconfirm --noedit

scripts/arch-linux/provisioning/amd.bash

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+
+# todo?

scripts/arch-linux/provisioning/irc.bash

@@ -1,4 +1,4 @@
 #!/usr/bin/env bash
 
-# TODO: setup weechat matrix plugin
+# TODO: setup weechat matrix plugin?
 # git clone 

scripts/arch-linux/provisioning/tmux-plugins.bash

@@ -2,7 +2,11 @@
 
 # tmux plugin manager
 git clone https://github.com/tmux-plugins/tpm "$HOME/.tmux/plugins/tpm"
+
+# load tmux config
 tmux source "$HOME/.tmux.conf"
+
+# clean, install, and update plugins
 bash "$HOME/.tmux/plugins/tpm/bindings/clean_plugins"
 bash "$HOME/.tmux/plugins/tpm/bindings/install_plugins"
 bash "$HOME/.tmux/plugins/tpm/bindings/update_plugins"

setup

@@ -74,8 +74,8 @@ links=(
 	# bar files
 	"$dfp/de/bar/polybar-config"             "$XDG_CONFIG_HOME/polybar/config"
 
-	# neofetch config
-	"$dfp/apps/ranger"                       "$XDG_CONFIG_HOME/ranger"
+	# ranger config
+	"$dfp/pps/ranger/"                       "$XDG_CONFIG_HOME/ranger/"
 
 	# neofetch config
 	"$dfp/apps/neofetch/config"              "$XDG_CONFIG_HOME/neofetch/config"

shell/aliases

@@ -49,12 +49,14 @@ alias tdf="tmux attach -t df || tmux new -s df -c \"$DOTFILES_PATH\""
 alias tmon="tmux attach -t mon || tmux new -s mon"
 
 # git aliases
+# TODO: make these git aliases in the gitconfig?
 alias gs="git status"
 alias gl="git log"
 alias gpl="git pull"
 alias gp="git push"
 alias grbpf="git push --force-with-lease"
 alias gac="git add -A && git commit"
+alias gsur="git submodule update --remote"
 
 grb() {
 	MAIN_BRANCH="master"
@@ -85,6 +87,7 @@ alias p="ping 8.8.8.8"
 alias setbg="feh --bg-fill"
 alias C="clear && clear"
 alias keyrepeat="xset r rate 250 80"
+alias r="ranger"
 
 # games aliases
 # this sometimes fixes steam dynamic library issues?