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

=======================================
 'dot-emacs' installation instruction.
=======================================
.. contents::

Copyright (C) 2008-2011 by Oleksandr Gavenko <gavenkoa@gmail.com>

You can do anything with this file without any warranty.

Setup on Windows
================

Choose separate ``HOME`` directory like ``c:\home`` and set this environment
variable in ``System => Advanced System Settings => Environment Variables``.

After setting ``HOME`` environment variable Emacs expands ``~`` path element to
that directory allowing quicker access to your file (especially with ``ido``).

If ``INFOPATH`` is not set it automatically extended with additional directory
``~/usr/share/info``. With ``cygwin-mount.el`` Cygwin info pages become
available in native Emacs too!

.. note::

   Example of ``INFOPATH`` which works with Cygwin and native Emacs::

     INFOPATH=/cygdrive/d/home/usr/share/info:/usr/share/info:/usr/local/share/info:

   Latest ``:`` sign instructs Cygwin built-in info viewer to include system
   paths and native Emacs to include its own info pages regardless installation
   directory.

``MANPATH`` automatically expanded with additional directory
``~/usr/share/man`` if ``cygwin-mount.el`` is installed. Trailing ``:``
correctly treated in native Emacs with ``cygwin-mount.el``.

.. note::

   To use ``woman`` on Windows set MANPATH like this (note that path in
   Cygwin/MinGW style so you need use cygwin-mount.el)::

  MANPATH=:/cygdrive/d/home/usr/share/man:/usr/share/man:/usr/local/share/man

.. note:: Default man search paths is listened in ``/usr/share/misc/man.conf``.

.. note:: You can customise ``woman-manpath`` variable.

GTD (org-mode).
===============

In home dir create .gtd subdir with todo.org file. Put simple content on top
of them::

  -*- coding: utf-8 -*-

  #+STARTUP: overview
  #+STARTUP: hidestars
  #+ARCHIVE: %s_done::