README.rst
author Oleksandr Gavenko <gavenkoa@gmail.com>
Sat, 28 Feb 2015 14:10:39 +0200
changeset 1232 8c3600d2317d
parent 749 a8d71dd0fbd5
child 1237 a194c21bc9d2
permissions -rw-r--r--
css-eldoc-enable
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
749
a8d71dd0fbd5 Convert documentation files to RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 386
diff changeset
     1
.. -*- coding: utf-8 -*-
a8d71dd0fbd5 Convert documentation files to RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 386
diff changeset
     2
a8d71dd0fbd5 Convert documentation files to RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 386
diff changeset
     3
=====================
a8d71dd0fbd5 Convert documentation files to RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 386
diff changeset
     4
 'dot-emacs' README.
a8d71dd0fbd5 Convert documentation files to RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 386
diff changeset
     5
=====================
a8d71dd0fbd5 Convert documentation files to RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 386
diff changeset
     6
.. contents::
12
fb11a9de5ab3 Добавил коментарии по инсталляции файлов настроек.
Oleksander Gavenko <gavenko_a@3g.ua>
parents:
diff changeset
     7
301
da1fac055e5d Move config files structure to README.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 300
diff changeset
     8
Copyright (C) 2010 by Oleksandr Gavenko <gavenkoa@gmail.com>
279
fd6164dfec82 Update copyright statement and year.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 221
diff changeset
     9
fd6164dfec82 Update copyright statement and year.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 221
diff changeset
    10
You can do anything with this file without any warranty.
42
04fd7747bc49 Update copyright notice.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 13
diff changeset
    11
749
a8d71dd0fbd5 Convert documentation files to RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 386
diff changeset
    12
Config files structure.
a8d71dd0fbd5 Convert documentation files to RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 386
diff changeset
    13
=======================
46
773ac573338d Update content.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 42
diff changeset
    14
293
292c9ded7c63 Describe new load order.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 279
diff changeset
    15
Main Emacs config file is '~/.emacs'. I decide don't store beside it all
292c9ded7c63 Describe new load order.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 279
diff changeset
    16
customisations. Instead it simply load files in such order:
46
773ac573338d Update content.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 42
diff changeset
    17
386
3efe37437745 Explore environment for abilities and tup config in ~/.emacs-autogen.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 352
diff changeset
    18
  '~/.emacs-autogen'
3efe37437745 Explore environment for abilities and tup config in ~/.emacs-autogen.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 352
diff changeset
    19
                It content depend on installation environment. Automatically
3efe37437745 Explore environment for abilities and tup config in ~/.emacs-autogen.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 352
diff changeset
    20
                generated.
293
292c9ded7c63 Describe new load order.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 279
diff changeset
    21
  '~/.emacs-pre'
292c9ded7c63 Describe new load order.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 279
diff changeset
    22
                For manually written customisation (usually for updating
352
a54dc30fba33 Small spell correction. ~/.emacs-post role was explained more clear.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 350
diff changeset
    23
                load-path) which can affect on '.emacs-my'. Will not be
a54dc30fba33 Small spell correction. ~/.emacs-post role was explained more clear.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 350
diff changeset
    24
                overridden on install.
293
292c9ded7c63 Describe new load order.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 279
diff changeset
    25
  '~/.emacs.d/my-lisp/autoload-my.el'
292c9ded7c63 Describe new load order.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 279
diff changeset
    26
                For defining autoload function for modes (instead loading all
292c9ded7c63 Describe new load order.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 279
diff changeset
    27
                mode files to save startup time). Automatically generated.
350
5e1c168ef21b Document that '~/.emacs-custom.el' now loaded before '~/.emacs-my'.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 301
diff changeset
    28
  '~/.emacs-custom.el'
352
a54dc30fba33 Small spell correction. ~/.emacs-post role was explained more clear.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 350
diff changeset
    29
                For storing customisations by Emacs itself. Some settings from
a54dc30fba33 Small spell correction. ~/.emacs-post role was explained more clear.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 350
diff changeset
    30
                this file can effect on loaded elisp files from .emacs-my.
a54dc30fba33 Small spell correction. ~/.emacs-post role was explained more clear.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 350
diff changeset
    31
                Will not be overridden on install.
293
292c9ded7c63 Describe new load order.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 279
diff changeset
    32
  '~/.emacs-my'
292c9ded7c63 Describe new load order.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 279
diff changeset
    33
                Here main customisations placed.
292c9ded7c63 Describe new load order.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 279
diff changeset
    34
  '~/.emacs-post'
352
a54dc30fba33 Small spell correction. ~/.emacs-post role was explained more clear.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 350
diff changeset
    35
                For storing connection settings, passwords and enabling modes
a54dc30fba33 Small spell correction. ~/.emacs-post role was explained more clear.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 350
diff changeset
    36
                added to load-path in ~/.emacs-pre. Will not be overridden on
a54dc30fba33 Small spell correction. ~/.emacs-post role was explained more clear.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 350
diff changeset
    37
                install.
749
a8d71dd0fbd5 Convert documentation files to RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 386
diff changeset
    38