Remove stuff that is obsolete or moved to dottum

INSTALL.md

@@ -1,126 +1,5 @@
-INSTALLATION
-============
+INSTALLING
+==========
 
-
-To install, you need to perform following steps:
-
-1.  Clone repository to a stable place on your box
-
-    For now, I'm going to assume it's local/mydots
-
-2.  Move (and merge if needed) your existing configs to dotfiles folder.
-    Remove the dot from name, e.g.:
-
-        $ mv ~/.gnucash ~/local/mydots/dotfiles/gnucash
-
-    If your configs live under `~/.config` folder, put them under a folder
-    similar to the dotfiles:
-
-        $ mv ~/.config/dunst ~/local/mydots/dotfiles.config/dunst
-
-    Note that for bash, vim and git, I recommend different solutions--see
-    below.
-
-3.  Run mklinks script with single argument: path to dotfiles folder (or how
-    you named it), e.g.:
-
-        $ ~/local/mydots/mklinks ~/local/mydots/dotfiles
-
-    The script will create links back in your `$HOME`, uless they (or real
-    files) did already exist, in which case it will only warn you.  This
-    makes it easy to exclude some of your applications from some of your
-    machines: just skip step 2 for them.
-
-    Pro tip: Notice how the mklinks script discovers your `.config/`-bound
-    files such as dunst.
-
-     1. The path you pointed to is "path/to/dotfiles", so this will be
-        regarded as "base path" of your config pool.
-
-     2. Any members of the *base* directory will be prefixed with single
-        dot and symlinked *directly* to your home--just as the ancient
-        tradition dictates.
-
-     3. If the "base path" has neighbor called the same but with suffix
-        `.config`, i.e. `path/to/dotfiles.config`, it will symlink all
-        present members to `~/.config` path--just as XDG convention
-        uses in its most common version.
-
-     4. The case is similar for `.local/share` files; here you'll just need
-        to go one step deeper: files that should be linked to `~/.local/share`
-        should be in `dotfiles.local/share`.
-
-
-Instructions for bash
----------------------
-
-Although similar technique could be used for bash, I prefer to have defaults
-specified by distro.  Therefore I use other technique:
-
-Instead of step 2 above, move/merge your specific ~/.bashrc changes to either
-one of these, or preferably, split them as needed:
-
-    dotfiles/bash/main.bashrc
-    dotfiles/bash/user/<your-username>.bashrc
-    dotfiles/bash/host/<your-hostname>.bashrc
-    dotfiles/bash/post.bashrc
-
-Then, replace your ~/.bashrc with your default distro's one, commonly found
-in /etc/skel/.bashrc, and use `dotfiles/bash/setup` to patch it:
-
-    $ cp /etc/skel/.bashrc ~/
-    $ local/mydots/dotfiles/bash/setup
-
-From that point on, `.bashrc` will source appropriate fies for you, so do not
-make any changes to your local `.bashrc`, unless you really want them to be
-local, i.e. private only.
-
-
-Instructions for Vim
---------------------
-
-If you want to keep default vim-ish behavior and have all local config in
-~/.vimrc, you can use above generic steps.  However, if you want to have
-rather more sophisticated model, and for example use my vim configuration
-as a starting point, do this instead of step 2:
-
-1.  Merge your local ~/.vimrc into dotfiles/vim/vimrc
-
-2.  Create a symlink to ~/.vim/vimrc:
-
-        $ cd
-        $ ln -s local/mydots/dotfiles/vim/vimrc .vimrc
-
-You could actually have your .vimrc symlink point right to local/mydots/...
-I find this more flexible, though.
-
-### perlcritic_vim ###
-
-Additionally, if you want to use perlcritic.vim, you need to:
-
-*   install Perl::Critic (from CPAN)
-
-*   put bin/perlcritic\_vim to your PATH
-
-
-Instructions for git
---------------------
-
-**Note**: For most of config I have shared, you will need at least git 1.8.
-Without it, things will not work, and you might even end up with broken git!
-
-However, if you only want to use the sharing/splitting mechanism, 1.7 *should*
-be OK.  **No warranties**, though.
-
-The pricnicple is the same as in bash section above: a new folder is created,
-local config is split into parts per user/host or global one, and original
-file becomes just a crossroads into these.
-
-Except that since git does not support expansion in config paths, the file
-must be created by a script.  So what you want to do is the same as for bash
-above, except that instead of applying patch to your .gitconfig, you simply
-delete it and run dotfiles/git/setup.
-
-If you have a local changes that you don't want to share, you can either put
-them into the re-created ~.gitconfig, or (as I prefer) in
-dotfiles/git/private/gitconfig
+Dotfiles here are managed by my new tool called 'dottum', which is not
+released at this point.  Contact me if impatient.

TODO.md

@@ -1,9 +0,0 @@
-TODO
-====
-
-*   Allow multiple DOTROOTs; merge them (e.g. some from Dropbox, some from
-    Github
-
-*   Do something about parens' highlighting (tin torte.vim)
-
-*   Add documentation for gittum, particulatly message aliases

bin/perlcritic_vim

@@ -1,13 +0,0 @@
-#!/usr/bin/perl
-
-use Perl::Critic;
-
-my $file = shift;
-my $critic = Perl::Critic->new();
-my @violations = $critic->critique($file);
-
-for (@violations) {
-    my ($l, $c) = m/.* at line (\d+), column (\d+)\./;
-    $_ =~ s/ at line \d+, column \d+\././;
-    print "$file:$l:$c:$_";
-}

external/README.md

@@ -1,6 +0,0 @@
-This folder it intended to be ignored by git and to hold symlinks to
-paths outside this repo (possibly backed up/synced by other, more
-suitable means).
-
-dotfiles* may then safely contain relative symlinks to this sub-folder
-without need to store the--often host-specific path.

mklinks

@@ -1,324 +0,0 @@
-#!/bin/bash
-
-warn() {
-    echo "$@" >&2
-}
-
-think() {
-    $Verbose || return
-    warn "$@"
-}
-
-die() {
-    warn "$@"
-    exit 3
-}
-
-usage() {
-    warn "usage: $0 init     VAULT SUBVAULT"
-    warn "usage: $0 explore  VAULT SUBVAULT"
-    exit 2
-}
-
-debug() {
-    $Debug || return
-    local msg
-    for msg in "$@";
-    do
-        warn "debug:$msg"
-    done
-}
-
-debugv() {
-    $Debug || return
-    local vn
-    local vd
-    for vn in "$@";
-    do
-        if vd=$(declare -p "$vn" 2>/dev/null);
-        then
-            warn "debug:${vd#declare ?? }"
-        else
-            warn "debug:$vn #Unset"
-        fi
-    done
-}
-
-debugc() {
-    $Debug || return
-    debug "-- cmd begin: $*"
-    Debug=false "$@" | sed -e 's/^/debug:/' >&2
-    debug "-- cmd end --"
-}
-
-lssv() {
-    #
-    # List sub-vaults
-    #
-    # Sub-vault is a sub-path of vault directory that contains items
-    # that should be linked separately, to a similar $HOME subpath,
-    # rather than linking the whole sub-tree.  This is typical for
-    # .config directory specified by XDG standard.
-    #
-    # For example, imagine vault like this:
-    #
-    #     dotfiles/
-    #     ├── config
-    #     │   ├── dunst
-    #     │   │   └── dunstrc
-    #     │   └── uzbl
-    #     │       ├── config
-    #     │       └── style.css
-    #     ├── i3
-    #     │   └── config
-    #     ├── i3status.conf
-    #     └── vimrc
-    #
-    # Without sub-vault, the "config" would be linked as "$HOME/.config":
-    #
-    #     $HOME/.config         -> dotfiles/.config
-    #     $HOME/.i3             -> dotfiles/i3
-    #     $HOME/.i3status.conf  -> dotfiles/i3status.conf
-    #     $HOME/.vimrc          -> dotfiles/vimrc
-    #
-    # This is impractical in most cases, as normally you want to select
-    # applications to link--some dotfiles could be specific to some
-    # hosts or even private.
-    #
-    # Setting 'config' as sub-vault will tell mklinks that you don't
-    # want to link this item directly but rather each of its items:
-    #
-    #     $HOME/.config/dunst   -> dotfiles/config/dunst
-    #     $HOME/.config/uzbl    -> dotfiles/config/uzbl
-    #     $HOME/.i3             -> dotfiles/i3
-    #     $HOME/.i3status.conf  -> dotfiles/i3status.conf
-    #     $HOME/.vimrc          -> dotfiles/vimrc
-    #
-    # This way, you can have other items under "$HOME/.config" that
-    # are either purely local or linked to another vault.
-    #
-    # Note that the subvault can be deeper than one level, i.e.
-    # subvault "local/share" also works:
-    #
-    #     $HOME/.local/share/klavaro -> dotfiles/local/share/klavaro
-    #
-    local sv
-    test -n "${SubVaults[0]}" && {
-        think "using sub-vaults from command line"
-        for sv in "${SubVaults[@]}";
-        do
-            echo "$sv"
-        done
-        return
-    }
-    test -f "$Vault/dotvault/subvaults" && {
-        think "reading subvaults from file: $Vault/dotvault/subvaults"
-        grep . "$Vault/dotvault/subvaults" \
-          | grep -v "^#.*"
-        return
-    }
-    think "using hard-coded list of subvaults"
-    echo config
-}
-
-lsvault() {
-    #
-    # List all vaults and subvaults, depth-first
-    #
-    {
-        echo "$Vault"
-        lssv \
-          | while IFS= read -r sv;
-            do
-                test -e "$Vault/$sv" || {
-                    think "ignoring non-existent sub-vault: $sv"
-                    continue
-                }
-                test -d "$Vault/$sv" || {
-                    warn "ignoring non-directory sub-vault: $sv"
-                    continue
-                }
-                echo "$Vault/$sv"
-            done
-    } \
-      | LC_ALL=C sort \
-      | tac
-}
-
-istarget() {
-    #
-    # True if item $1 is possible target
-    #
-    # Item is obviously not a possible target if it's
-    # a (sub-)vault.
-    #
-    # A less obvious case is when item is an intermediate directory
-    # on a path leading to a sub-vault.  Such item cannot be a target!
-    #
-    # For example: there are sub-vaults:
-    #
-    #     foo
-    #     foo/bar/baz
-    #
-    # and a tree:
-    #
-    #     foo
-    #     ├── A
-    #     └── bar
-    #         └── baz
-    #             └── B
-    #
-    # Items A and B could both be targets, but baz could not be!
-    #
-    #TODO: write an explanation
-    #
-    local item=$1
-    debugv item
-    Verbose=false lsvault | grep -qxF "$item"   && return 1
-    Verbose=false lsvault | grep -qx "$item/.*" && return 1
-    return 0
-}
-
-pfxpath() {
-    #
-    # Prefix paths with $1
-    #
-    # Just like `sed "s/^/$1/" but works with any characters
-    # in $1 excepr newline, which is not allowed in paths..
-    #
-    local pfx="$1"
-    local path
-    while IFS= read -r path;
-    do
-        echo "$pfx$path"
-    done
-}
-
-lstarget() {
-    #
-    # List potential items in vault $1
-    #
-    local vlt=$1
-    debugv vlt
-    local item
-    find "$vlt" -mindepth 1 -maxdepth 1 -printf "%P\n" \
-      | pfxpath "$vlt/" \
-      | grep -v "$Vault/dotvault" \
-      | while IFS= read -r item;
-        do
-            istarget "$item" && echo "$item"
-        done
-}
-
-make_links() {
-    #
-    # Create all links
-    #
-    local slpath
-    local target
-    local vlt
-    lsvault \
-      | while IFS= read -r vlt;
-        do
-            lstarget "$vlt" \
-              | while IFS= read -r target;
-                do
-                    slpath=$(slpath "$target")
-                    if test -L "$slpath";
-                    then
-                        $ClobberLinks || {
-                            warn "skipping existing slpath: $slpath"
-                            continue
-                        }
-                        think "removing existing link: $slpath"
-                        maybe rm "$slpath"
-                    fi
-                    test -e "$slpath" && {
-                        warn "skipping existing non-link: $slpath"
-                        continue
-                    }
-                    maybe ln -sr "$target" "$slpath"
-                done
-        done
-}
-
-explore() {
-    #
-    # Show what would be done
-    #
-    local vlt
-    local tgt
-    local tgts
-    lsvault \
-      | sort \
-      | while IFS= read -r vlt;
-        do
-            tgts=$(lstarget "$vlt")
-            test -n "$tgts" || continue
-            if test "$vlt" == "$Vault";
-            then
-                echo "VAULT:$vlt:"
-            else
-                echo
-                echo "SUBVAULT:$vlt"
-            fi
-            sort <<<"$tgts" \
-              | while IFS= read -r tgt;
-                do
-                    echo "${tgt}:$(slpath "$tgt")"
-                done \
-              | sed -e "s|:$HOME|:=> ~|" \
-              | column -ts: \
-              | sed -e "s/^/    /"
-        done
-}
-
-maybe() {
-    #
-    # Maybe do things $@, maybe not (if in debug mode)
-    #
-    $Debug && { debug "WOULD: $*"; return; }
-    "$@"
-}
-
-slpath() {
-    #
-    # Print path where to create link for target $1
-    #
-    local item=$1
-    echo "$HOME/.${item#$Vault/}"
-}
-
-route() {
-    local Vault=$1; shift
-    local SubVaults=()
-    test -n "$Vault" || usage
-    test -e "$Vault" || die "vault does not exist: $Vault"
-    test -d "$Vault" || die "vault is not a directory: $Vault"
-    SubVaults=("$@")
-    case $Action in
-        init)       make_links  ;;
-        explore)    explore     ;;
-        *)          usage       ;;
-    esac
-}
-
-export LC_ALL=C
-
-main() {
-    local Action
-    local Debug=false
-    local Verbose=false
-    local ClobberLinks=false
-    while true; do case $1 in
-        -d) Debug=true;         shift ;;
-        -v) Verbose=true;       shift ;;
-        -f) ClobberLinks=true;  shift ;;
-        -*)                     usage ;;
-        *)                      break ;;
-    esac done
-    Action=$1; shift
-    route "$@"
-}
-
-main "$@"

other/git-hooks/pre-commit

@@ -1,39 +0,0 @@
-#!/usr/bin/env python
-from __future__ import with_statement
-import os
-import re
-import shutil
-import subprocess
-import sys
-import tempfile
-
-
-def system(*args, **kwargs):
-    kwargs.setdefault('stdout', subprocess.PIPE)
-    proc = subprocess.Popen(args, **kwargs)
-    out, err = proc.communicate()
-    return out
-
-
-def main():
-    modified = re.compile('^[AM]+\s+(?P<name>.*\.py)', re.MULTILINE)
-    files = system('git', 'status', '--porcelain')
-    files = modified.findall(files)
-
-    tempdir = tempfile.mkdtemp()
-    for name in files:
-        filename = os.path.join(tempdir, name)
-        filepath = os.path.dirname(filename)
-        if not os.path.exists(filepath):
-            os.makedirs(filepath)
-        with file(filename, 'w') as f:
-            system('git', 'show', ':' + name, stdout=f)
-    output = system('pep8', '.', cwd=tempdir)
-    shutil.rmtree(tempdir)
-    if output:
-        print output,
-        sys.exit(1)
-
-
-if __name__ == '__main__':
-    main()