.. -*- 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``).

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

.. note::

   To later ``INFOPATH`` to work with Cygwin and native Emacs use paths like::

     INFOPATH=e:/opt/cygwin/usr/share/info;e:/home/usr/share/info;e:/bin/gnuwin32/info:

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

``MANPATH`` automatically expanded with additional directory
``~/usr/share/info`` 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::