2 files changed, 61 insertions, 21 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]
diff --git a/README.md b/README.md
deleted file mode 100644
index 70f2a52..0000000
--- a/README.md
+++ /dev/null
@@ -1,21 +0,0 @@
-My configuration settings and config files for various programs.
-
-
-# Files
-
-``` 
-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)
-```