.. -*- coding: utf-8 -*-

=====================
 'dot-emacs' README.
=====================
.. contents::

:Author: Oleksandr Gavenko <gavenkoa@gmail.com>

Installation
===

To install::

  make install

To download external packages::

  mymake install-packages

Config files structure
===

I use ``~/.emacs.d/init.d`` as main entry point for customisation. Tha file load
anoth files in such order:

  ``~/.emacs.d/.emacs-autogen``
    Hold environment info discovered during installing. Automatically generated.
  ``~/.emacs.d/.emacs-pre``
    For manually written customisation (usually for updating load-path) which
    can affect on ``.emacs-my``. Will not be overridden on install.
  ``~/.emacs.d/my/loaddefs.el``
    Definition for my modes autoload functions. Automatically generated.
  ``~/.emacs.d/.emacs-custom``
    For storing customisations by Emacs itself. Some settings from this file can
    effect on loaded elisp files from .emacs-my. Will not be overridden on
    install.
  ``~/.emacs.d/.emacs-my``
    Here main customisations is placed.
  ``~/.emacs.d/.emacs-post``
    For storing connection settings, passwords and enabling modes added to
    load-path in ``~/.emacs.d/.emacs-pre``. Will not be overridden on install.