1 files changed, 61 insertions, 0 deletions
diff --git a/README.adoc b/README.adoc
new file mode 100644
index 0000000..1805ca7
--- /dev/null
+++ b/README.adoc
@@ -0,0 +1,61 @@
+= dotfiles
+Mitsuo
+2022-08-30
+:source-highlight: highlight.js
+
+My configuration settings and config files for various programs.
+
+
+== Usage
+
+To run installation script do 
+
+[source, sh]
+====
+# Modify install.sh according to your needs, then
+chmod u+x install.sh
+./install.sh
+====
+
+Default behaviour is to copy (instead of sym-linking) the dotfiles to their
+appropiate locations.
+
+*Some dotfiles require manual installation.*
+
+
+== Description 
+
+The following applications are configured:
+
+Vim:: Nothing fancy, "the essential" and just some custom mappings
+Bash:: Vim input, aliases, XDG variables, git prompt
+Git:: My name, email, favorite difftool
+Ideavimrc:: Some config for Vim plugin for IntelliJ and Pycharm
+
+// TODO: finish this list
+
+
+////
+Some files are included in the installation script 
+
+ profile                             sh config
+ bashrc                              bash "run commands"
+ bash_aliases
+ inputrc                             vim input for bash
+ vim/fun.vim                         some vim functions
+ vim/vimrc                           vim "run commands"
+ extra/newdebian                     my debian/KDE Pasma 5 conf
+ extra/qtcurvetestsettings.qtcurve     
+ extra/20-libinput.conf              enable touchpad functionality
+                                     (x220 specific)
+ 
+ git/                                Git config files
+ other/                              Other config files
+ other/ideavimrc                     ~/.ideavimrc (Pycharm)
+////
+
+
+== Files currently requiring manual installation
+
+*st*: For emoji support: Install https://st.suckless.org/patches/font2/[font2]
+and https://aur.archlinux.org/packages/libxft-bgra[libxft-bgra]