From 660054d93a484b686b1caed814782fae9b9b75b6 Mon Sep 17 00:00:00 2001
From: Mitsuo Tokumori <rtokumori@pucp.edu.pe>
Date: Tue, 30 Aug 2022 15:01:59 -0500
Subject: Translate README to AsciiDoc

---
 README.adoc | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 README.adoc

(limited to 'README.adoc')

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]
-- 
cgit v1.2.3

