INSTALL.rst
author Oleksandr Gavenko <gavenkoa@gmail.com>
Wed, 11 Oct 2017 00:28:06 +0300
changeset 1541 dca10cecc9e2
parent 1480 34b763cbc5cf
child 1657 5992e8df79c5
permissions -rw-r--r--
Set font size depending on DPI.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
749
a8d71dd0fbd5 Convert documentation files to RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 383
diff changeset
     1
.. -*- coding: utf-8 -*-
12
fb11a9de5ab3 Добавил коментарии по инсталляции файлов настроек.
Oleksander Gavenko <gavenko_a@3g.ua>
parents:
diff changeset
     2
749
a8d71dd0fbd5 Convert documentation files to RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 383
diff changeset
     3
=======================================
a8d71dd0fbd5 Convert documentation files to RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 383
diff changeset
     4
 'dot-emacs' installation instruction.
a8d71dd0fbd5 Convert documentation files to RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 383
diff changeset
     5
=======================================
a8d71dd0fbd5 Convert documentation files to RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 383
diff changeset
     6
.. contents::
a8d71dd0fbd5 Convert documentation files to RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 383
diff changeset
     7
a8d71dd0fbd5 Convert documentation files to RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 383
diff changeset
     8
Copyright (C) 2008-2011 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
1397
d4182b28cdc1 Including ~/usr/share/info in INFOPATH. Tweak for INFOPATH and cygwin-mount.el.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 751
diff changeset
    12
Setup on Windows
d4182b28cdc1 Including ~/usr/share/info in INFOPATH. Tweak for INFOPATH and cygwin-mount.el.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 751
diff changeset
    13
================
d4182b28cdc1 Including ~/usr/share/info in INFOPATH. Tweak for INFOPATH and cygwin-mount.el.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 751
diff changeset
    14
d4182b28cdc1 Including ~/usr/share/info in INFOPATH. Tweak for INFOPATH and cygwin-mount.el.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 751
diff changeset
    15
Choose separate ``HOME`` directory like ``c:\home`` and set this environment
d4182b28cdc1 Including ~/usr/share/info in INFOPATH. Tweak for INFOPATH and cygwin-mount.el.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 751
diff changeset
    16
variable in ``System => Advanced System Settings => Environment Variables``.
d4182b28cdc1 Including ~/usr/share/info in INFOPATH. Tweak for INFOPATH and cygwin-mount.el.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 751
diff changeset
    17
d4182b28cdc1 Including ~/usr/share/info in INFOPATH. Tweak for INFOPATH and cygwin-mount.el.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 751
diff changeset
    18
After setting ``HOME`` environment variable Emacs expands ``~`` path element to
d4182b28cdc1 Including ~/usr/share/info in INFOPATH. Tweak for INFOPATH and cygwin-mount.el.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 751
diff changeset
    19
that directory allowing quicker access to your file (especially with ``ido``).
12
fb11a9de5ab3 Добавил коментарии по инсталляции файлов настроек.
Oleksander Gavenko <gavenko_a@3g.ua>
parents:
diff changeset
    20
1442
3326fe242cb8 Fix spelling and typos.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1401
diff changeset
    21
If ``INFOPATH`` is not set it automatically extended with additional directory
3326fe242cb8 Fix spelling and typos.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1401
diff changeset
    22
``~/usr/share/info``. With ``cygwin-mount.el`` Cygwin info pages become
3326fe242cb8 Fix spelling and typos.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1401
diff changeset
    23
available in native Emacs too!
1397
d4182b28cdc1 Including ~/usr/share/info in INFOPATH. Tweak for INFOPATH and cygwin-mount.el.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 751
diff changeset
    24
d4182b28cdc1 Including ~/usr/share/info in INFOPATH. Tweak for INFOPATH and cygwin-mount.el.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 751
diff changeset
    25
.. note::
158
f3ed60aecfd8 Setup MANPATH.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 155
diff changeset
    26
1442
3326fe242cb8 Fix spelling and typos.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1401
diff changeset
    27
   Example of ``INFOPATH`` which works with Cygwin and native Emacs::
1397
d4182b28cdc1 Including ~/usr/share/info in INFOPATH. Tweak for INFOPATH and cygwin-mount.el.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 751
diff changeset
    28
1442
3326fe242cb8 Fix spelling and typos.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1401
diff changeset
    29
     INFOPATH=/cygdrive/d/home/usr/share/info:/usr/share/info:/usr/local/share/info:
158
f3ed60aecfd8 Setup MANPATH.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 155
diff changeset
    30
1442
3326fe242cb8 Fix spelling and typos.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1401
diff changeset
    31
   Latest ``:`` sign instructs Cygwin built-in info viewer to include system
1397
d4182b28cdc1 Including ~/usr/share/info in INFOPATH. Tweak for INFOPATH and cygwin-mount.el.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 751
diff changeset
    32
   paths and native Emacs to include its own info pages regardless installation
d4182b28cdc1 Including ~/usr/share/info in INFOPATH. Tweak for INFOPATH and cygwin-mount.el.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 751
diff changeset
    33
   directory.
12
fb11a9de5ab3 Добавил коментарии по инсталляции файлов настроек.
Oleksander Gavenko <gavenko_a@3g.ua>
parents:
diff changeset
    34
1401
8856efafc5fe Notes on setting MANPATH to work with Cygwin.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1397
diff changeset
    35
``MANPATH`` automatically expanded with additional directory
1480
34b763cbc5cf Fix typos.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1442
diff changeset
    36
``~/usr/share/man`` if ``cygwin-mount.el`` is installed. Trailing ``:``
1401
8856efafc5fe Notes on setting MANPATH to work with Cygwin.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1397
diff changeset
    37
correctly treated in native Emacs with ``cygwin-mount.el``.
158
f3ed60aecfd8 Setup MANPATH.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 155
diff changeset
    38
1401
8856efafc5fe Notes on setting MANPATH to work with Cygwin.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1397
diff changeset
    39
.. note::
8856efafc5fe Notes on setting MANPATH to work with Cygwin.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1397
diff changeset
    40
8856efafc5fe Notes on setting MANPATH to work with Cygwin.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1397
diff changeset
    41
   To use ``woman`` on Windows set MANPATH like this (note that path in
8856efafc5fe Notes on setting MANPATH to work with Cygwin.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1397
diff changeset
    42
   Cygwin/MinGW style so you need use cygwin-mount.el)::
158
f3ed60aecfd8 Setup MANPATH.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 155
diff changeset
    43
f3ed60aecfd8 Setup MANPATH.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 155
diff changeset
    44
  MANPATH=:/cygdrive/d/home/usr/share/man:/usr/share/man:/usr/local/share/man
f3ed60aecfd8 Setup MANPATH.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 155
diff changeset
    45
1401
8856efafc5fe Notes on setting MANPATH to work with Cygwin.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1397
diff changeset
    46
.. note:: Default man search paths is listened in ``/usr/share/misc/man.conf``.
159
caee78ca8c40 About MANPATH on Windows.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 158
diff changeset
    47
1480
34b763cbc5cf Fix typos.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1442
diff changeset
    48
.. note:: You can customise ``woman-manpath`` variable.
158
f3ed60aecfd8 Setup MANPATH.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 155
diff changeset
    49
749
a8d71dd0fbd5 Convert documentation files to RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 383
diff changeset
    50
GTD (org-mode).
a8d71dd0fbd5 Convert documentation files to RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 383
diff changeset
    51
===============
155
6a2edc852b4a About GTD (org-mode).
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 111
diff changeset
    52
300
0f55e6d6aea3 Fix spelling.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 295
diff changeset
    53
In home dir create .gtd subdir with todo.org file. Put simple content on top
751
f8f9771725f5 Fix markup.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 749
diff changeset
    54
of them::
155
6a2edc852b4a About GTD (org-mode).
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 111
diff changeset
    55
6a2edc852b4a About GTD (org-mode).
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 111
diff changeset
    56
  -*- coding: utf-8 -*-
6a2edc852b4a About GTD (org-mode).
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 111
diff changeset
    57
6a2edc852b4a About GTD (org-mode).
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 111
diff changeset
    58
  #+STARTUP: overview
6a2edc852b4a About GTD (org-mode).
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 111
diff changeset
    59
  #+STARTUP: hidestars
6a2edc852b4a About GTD (org-mode).
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 111
diff changeset
    60
  #+ARCHIVE: %s_done::
749
a8d71dd0fbd5 Convert documentation files to RST syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 383
diff changeset
    61