how-to search and replace recursively in file paths and contents

# START -- how-to search and replace recursively in file paths and contents

export dir=/var/aktia/3rdparty/docs/docx; 

export to_srch="emric"

export to_repl="t24"

#-- search and replace in file names, skip those in .git

find "$dir/"  -not -path "./.git/*" -type d |\

perl -nle '$o=$_;s#'"$to_srch"'#'"$to_repl"'#g;$n=$_;`mkdir -p $n` ;'

find "$dir/"  -not -path "./.git/*" -type f |\

perl -nle '$o=$_;s#'"$to_srch"'#'"$to_repl"'#g;$n=$_;rename($o,$n) unless -e $n ;'

#-- search and replace in file contents, skip those in .git

find "$dir/" -not -path "./.git/*" -type f -exec perl -pi -e "s#$to_srch#$to_repl#g" {} \;

find "$dir/" -not -path "./.git/*" -type f -name '*.bak' | xargs rm -f"

# STOP  -- how-to rename files recursively in file paths and contents

my ~/.tmux.conf (revised) + how-to build tmux from source

# file: ~/.tmux.conf

# v1.0.1

# this is your <<prefix>>

# remap prefix from 'C-b' to 'C-j', because it is the only letter left from  the 

# bash shortcuts with the Control option

unbind C-b

set-option -g prefix C-j

bind-key C-j send-prefix

# v1.0.2

# enable vi mode

set-window-option -g mode-keys vi

# confirm by <<prefix>> :list-keys -t vi-copy

# v1.0.3

# increase the number of lines - obs RAM consuming

set-option -g history-limit 9000

#v 1.0.4 easier copy paste 

# src: https://leanside.com/2014/01/copy-paste-in-tmux/

setw -g mode-keys vi # vim-style movement

# in normal tmux mode# 

# `tmux prefix + Escape` starts copy mode.

bind Escape copy-mode

# `prefix + p` pastes the latest buffer

bind p paste-buffer 

#

# # in copy mode…

# `v` begins a selection. (movement keys to select the desired bits)

bind -t vi-copy v begin-selection 

# `y` copies the current selection to one of tmux's "paste buffers"

bind -t vi-copy y copy-selection 

# `V` changes between line- and columnwise selection

bind -t vi-copy V rectangle-toggle 

# when in copy mode act like vim for Yanking

bind -t vi-copy Y copy-end-of-line 

# ?!

bind + delete-buffer

# 

# start ::: how-to build tmux from source on older boxes ?!

# mkdir -p /tmp/tmux-install; cd /tmp/tmux-install

# wget https://github.com/downloads/libevent/libevent/libevent-2.0.21-stable.tar.gz

# tar xzvf libevent-2.0.21-stable.tar.gz

# cd libevent-2.0.21-stable

# ./configure && make

# sudo make install

# # on GentOS

# sudo yum install -y ncurses-devel

# # or Ubuntu

# sudo apt-get install -y ncurses-dev

# # clone the latest stable master branch version

# git clone https://github.com/tmux/tmux.git

# cd tmux/

# sh autogen.sh

# /configure && make

# # and verify 

# which tmux 

# tmux -V

# stop  ::: how-to build tmux from source on older boxes ?!

#

# v1.1.2

# Initialize TMUX plugin manager (keep this line at the very bottom of tmux.conf)

# mkdir -p ~/.tmux/plugins

# git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm

# git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tmux-copycat

##  and verify by:

# find ~/.tmux/plugins -type d -maxdepth 2

## stdout should look like

# ~/.tmux/plugins/

# ~/.tmux/plugins/tpm

# ~/.tmux/plugins/tmux-copycat

#

# start ::: how-to enable <<prefix>> + / = highlighted search back in terminal !!!

# install by : <<prefix> , I

# v1.0.5 

# enable search results highlighting in copy mode

# src: https://github.com/tmux-plugins/tmux-copycat

set -g @plugin 'tmux-plugins/tmux-copycat'

run '~/.tmux/plugins/tpm/tpm'

#

#

# Usage: 

# ---------------------------------------------------------

# place into your ~/.tmux.conf

# reload by :

# <<prefix>>, :source-file ~/.tmux.conf when in tmux session

#

# reload plugings by: 

# Ctrl + J, U

#

# v1.0.6

# A short cheat-sheet

# source: https://tmuxcheatsheet.com

# tmux sessions management

# tmux new -s sess-name

# tmux attach -t sess-name

#

# tmux sessions handling

# those require <<prefix>> 

# :new<CR>  new session

# ----------------------

# s          list sessions

# $          rename session

# d          exit a session without killing it

# 

# tmux windows handling

# those require <<prefix>> 

# tmux windows handling

# ----------------------

# c     new window

# ,     rename window

# w     list windows

# f     find window

# q     show windows numbers

# x     kill window

# swap-window -t 0

# 

# how-to save the pane ouput to a file

# <<prefix>>

# :capture-pane -S -2000

# where 2000 is the amount of lines to capture

# <<prefix>>

# :save-buffer /tmp/tmux-buffer.log

#

# VersionHistory

# ---------------------------------------------------------

# export version=1.1.3

# ---------------------------------------------------------

# 1.1.3 -- 2017-05-09 15:31:24 -- ysg -- add full instruction for src build

# 1.1.2 -- 2017-04-10 11:22:01 -- ysg -- instruction for faster plugins setup 

# 1.1.1 -- 2016-12-07 13:50:49 -- ysg -- save buffer instructions 

# 1.1.0 -- 2016-12-07 13:21:01 -- ysg -- better docs for copy-cat , shortcut for sessions

# 1.0.9 -- 2016-09-01 13:01:46 -- ysg -- swap window

# 1.0.8 -- 2016-08-29 11:24:09 -- ysg -- more shortcuts in doc

# 1.0.7 -- 2016-08-29 09:20:29 -- ysg -- more shortcuts in doc

# 1.0.6 -- 2016-08-23 23:12:29 -- ysg -- added cheat-sheet

# 1.0.5 -- 2016-08-23 22:04:23 -- ysg -- search highlight with plugins

# 1.0.4 -- 2016-08-17 08:38:02 -- ysg -- easier copy paste

# 1.0.3 -- 2016-07-20 09:34:18 -- ysg -- vi copy mode

# 1.0.2 -- 2016-07-20 09:28:18 -- ysg -- vi copy mode

# 1.0.1 -- 2016-07-12 23:29:33 -- ysg -- Ctrl + J as prefix 

# 1.0.0 -- 2016-07-12 23:29:10 -- ysg -- orginal version

#

# eof file: ~/.tmux.conf

the disconnect between human readable documentation and source code

It is amazing how long the whole software industry has continued to rally without a proper connection / association / mutual understanding of the people understanding rather source code and the people understanding mostly human readable documentation.
For the poor guys like me, which have to constantly read code without full understanding of what it is supposed to do I got the following idea:

- single record specs for userstories, requirements , issues, etc.
- each single record is identifiable via UUID
- do_run_log <<uuid>> in the src code implementing an requirement or userstory
- saving to a single execution run log file with timestamp
- run-translation-tool - generating human readable log : <<ts>> reg for userstory : <<title>>