restrucutre and add search function

vim/vimrc

@@ -3,8 +3,9 @@
 " \ V /| | | | | | | | | (__
 "  \_/ |_|_| |_| |_|_|  \___|
 
-"(((((((((((( general settings ))))))))))))
+"------------------------------------------------------------------------------
-set nocompatible
+"general settings
+"------------------------------------------------------------------------------
 
 "tab/indent
 set tabstop=4
@@ -70,20 +71,37 @@ set directory=~/.vim/.swap//,/tmp//
 "leader key
 let mapleader=','
 
-"(((((((((((( normal keybinds ))))))))))))
+"------------------------------------------------------------------------------
+"normal mode keybinds
+"------------------------------------------------------------------------------
+
+"normal keybinds
 nnoremap <silent><leader><space> :let @/ = ""<CR>
 nnoremap <leader>p :set invpaste<CR>
 nnoremap <silent><leader>lb :call ToggleLineBreak()<CR>
 nnoremap <silent><leader>wr :call ToggleWrap()<CR>
 nnoremap <silent><leader>cc :call ToggleColorColumn()<CR>
-
 nnoremap <leader>ts "=strftime("%F %T%z")<CR>p
 nnoremap =j :%!python -m json.tool<CR>
 
-"(((((((((((( abbreviations ))))))))))))
+"plugin keybinds
+nnoremap <silent><leader>e :call ToggleNetrw()<CR>
+nnoremap <leader>at :ALEToggle<CR>
+if !exists('##TextYankPost')
+	map y <Plug>(highlightedyank)
+endif
+
+"------------------------------------------------------------------------------
+"abbreviations
+"------------------------------------------------------------------------------
+
 inoreabbrev <expr> #!! "#!/usr/bin/env"
 
-"(((((((((((( commands ))))))))))))
+"------------------------------------------------------------------------------
+"custom commands
+"------------------------------------------------------------------------------
+
+"common typos and abbreviations
 cnoremap w!! w !sudo tee % > /dev/null
 command! W w !sudo tee % > /dev/null
 command! Trim %s/\s\+$//
@@ -91,20 +109,30 @@ command! Q q
 command! WQ wq
 command! Q1 q!
 
-"(((((((((((( plugins ))))))))))))
+"------------------------------------------------------------------------------
+"plugins (vim-plug)
+"------------------------------------------------------------------------------
+
+"ensure vim-plug is installed on VimEnter
 if empty(glob('~/.vim/autoload/plug.vim'))
 	silent !curl -fLo ~/.vim/autoload/plug.vim --create-dirs
 				\ https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
 	autocmd VimEnter * PlugInstall --sync | source $MYVIMRC
 endif
 
-"filetype may interfere with plugins
+"filetype *may* interfere with certain plugins
 filetype off
 
+"entry function
 call plug#begin('~/.vim/plugged')
+
 	"## vim plug ##
 	Plug 'junegunn/vim-plug'
+
+	"-------------
 	"== general ==
+	"-------------
+
 	"## quality of life ##
 	Plug 'tpope/vim-surround'
 	Plug 'tpope/vim-commentary'
@@ -112,33 +140,39 @@ call plug#begin('~/.vim/plugged')
 	Plug 'tpope/vim-rsi'
 	Plug 'tpope/vim-eunuch'
 	Plug 'tpope/vim-repeat'
+	Plug 'editorconfig/editorconfig-vim'
+
 	"## git ##
 	Plug 'tpope/vim-fugitive'
 	Plug 'airblade/vim-gitgutter'
-    "## editorconfig ##
+
-    Plug 'editorconfig/editorconfig-vim'
+	"## visual ##
-    "## colors, highlights and indents ##
 	Plug 'machakann/vim-highlightedyank'
 
+	"-----------------------
 	"== language specific ==
+	"-----------------------
+
 	"javascript/css/html
 	Plug 'pangloss/vim-javascript'
 	Plug 'mattn/emmet-vim'
+
 	"go
 	Plug 'fatih/vim-go'
+
 	"## linting ##
 	Plug 'w0rp/ale'
+
 call plug#end()
 
-"(((((((((((( plugin keybinds ))))))))))))
+"------------------------------------------------------------------------------
-nnoremap <silent><leader>e :call ToggleNetrw()<CR>
+"plugin settings
-nnoremap <leader>at :ALEToggle<CR>
+"------------------------------------------------------------------------------
-if !exists('##TextYankPost')
-  map y <Plug>(highlightedyank)
-endif
 
-"(((((((((((( plugin settings ))))))))))))
+" this function gets called with the VimEnter autocommand to set plugin
+" options
 function! SetPluginSettings()
+
 	"netrw
 	let g:netrw_banner = 0
 	let g:netrw_winsize = 24
@@ -146,6 +180,9 @@ function! SetPluginSettings()
 	let g:netrw_preview = 1
 	let g:netrw_alto = 0
 	let g:netrw_usetab = 1
+	let g:netrw_browsex_viewer = "xdg-open"
+	let g:NetrwIsOpen = 0 "for toggle function
+
 	"git gutter
 	augroup git_gutter
 		if exists(':GitGutter')
@@ -154,6 +191,8 @@ function! SetPluginSettings()
 			autocmd BufWritePost * GitGutter "update GitGutter after writing
 		endif
 	augroup END
+
+	"ale
 	if exists(':ALEToggle')
 		let g:ale_fixers = {
 					\   '*': ['remove_trailing_lines', 'trim_whitespace'],
@@ -162,9 +201,17 @@ function! SetPluginSettings()
 		let g:ale_sign_error = '->'
 		let g:ale_sign_warning = '--'
 	endif
+
 endfunction
 
-"(((((((((((( general use functions ))))))))))))
+"------------------------------------------------------------------------------
+"general functions
+"------------------------------------------------------------------------------
+
+"----------------
+"toggle functions
+"----------------
+
 function! ToggleColorColumn()
 	if &cc == ''
 		set cc=80
@@ -193,10 +240,8 @@ function! ToggleWrap()
 	endif
 endfunction
 
-"make netrw toggleable
+function! ToggleNetrw() "make netrw toggleable
 	"https://vi.stackexchange.com/questions/10988/toggle-explorer-window
-let g:NetrwIsOpen=0
-function! ToggleNetrw()
 	if g:NetrwIsOpen
 		let i = bufnr("$")
 		while (i >= 1)
@@ -212,12 +257,22 @@ function! ToggleNetrw()
 	endif
 endfunction
 
-"(((((((((((( enable syntax/filetype ))))))))))))
+"----------------
+"search functions
+"----------------
+
+"------------------------------------------------------------------------------
+"syntax/filetype
+"------------------------------------------------------------------------------
+
 syntax enable
 filetype plugin indent on
 runtime macros/matchit.vim
 
-"(((((((((((( gui settings ))))))))))))
+"------------------------------------------------------------------------------
+"gui settings
+"------------------------------------------------------------------------------
+
 if has("gui_running")
 	set guioptions -=m
 	set guioptions -=T
@@ -230,48 +285,68 @@ if has("gui_running")
 	endif
 endif
 
-"(((((((((((( win32 settings ))))))))))))
+"------------------------------------------------------------------------------
+"win32 settings
+"------------------------------------------------------------------------------
+
 if has('win32')
 endif
 
-"(((((((((((( auto commands ))))))))))))
+"------------------------------------------------------------------------------
+"auto commands
+"------------------------------------------------------------------------------
+
 if has("autocmd")
+
+	"------------
 	"## global ##
+	"------------
+
+	"set plugin settings on VimEnter
 	augroup set_plugin_settings
 		autocmd!
 		autocmd VimEnter * call SetPluginSettings()
 	augroup END
 
+	"keep equal proportions when windows resized
 	augroup auto_resize_windows
 		autocmd!
 		autocmd VimResized * wincmd =
 	augroup END
 
-    "## save cursor position in a file ##
+	"save cursor position in a file
 	au BufReadPost * if line("'\"") > 1 && line("'\"")
 				\ <= line("$") | exe "normal! g'\"" | endif
 
+	"--------------------------------
 	"## language/filetype specific ##
+	"--------------------------------
+
+	"shell
 	augroup filetype_shell
 		autocmd!
 		autocmd BufNewFile,BufRead *bash* set syntax=sh
 	augroup END
 
+	"python
 	augroup filetype_python
 		autocmd!
 		autocmd FileType python xnoremap <leader>r <esc>:'<,'>:w !python3<CR>
 	augroup END
 
+	"go
 	augroup filetype_go
 		autocmd!
 		set expandtab!
 	augroup END
 
+	"html
 	augroup filetype_html
 		autocmd!
 		autocmd FileType html :syntax sync fromstart
 	augroup END
 
+	"where tabs should = 2 spaces
 	augroup half_tab
 		autocmd!
 		autocmd FileType html,javascript,css,json,yaml,yml,sh