5 Hooke initializes a number of variables by reading configuration
11 Hooke uses Python's configparser_ library to read the config files.
12 The format is similar to MS Windows' INI (initialization) format::
18 .. _configparser: http://docs.python.org/library/configparser.html
25 $ ./bin/hk.py --save-config -c ''
29 $ ./bin/hk.py -c 'save_config --output .hooke.cfg'
31 To write a well commented example config file to :file:`.hooke.cfg`.
34 Finding configuration files
35 ---------------------------
37 The default search path follows the `Filesystem Hierarchy Standard`_,
38 and so will probably need adjustment for non-\*nix systems. The
41 * :file:`/usr/share/hooke/hooke.cfg`
42 * :file:`/etc/hooke/hooke.cfg`
43 * :file:`~/.hooke.cfg`
44 * :file:`./.hooke.cfg`
46 but alternatives can be specified from the command line launching
49 .. _Filesystem Hierarchy Standard: http://www.pathname.com/fhs/
51 .. todo:: Implement command-line specified config file.
53 .. warning:: Any changes you make to the configuration during a Hooke
54 run will *not be saved* when Hooke exits. To save the changes,
55 either run the `save config` command before closing Hooke, or start
56 Hooke with the ``--save-config`` option.