***************** Configuring Hooke ***************** Hooke initializes a number of variables by reading configuration files. Syntax ------ Hooke uses Python's configparser_ library to read the config files. The format is similar to MS Windows' INI (initialization) format:: [My Section] foo = bar baz = 5 .. _configparser: http://docs.python.org/library/configparser.html Examples -------- Run:: $ hooke --save-config -c '' To write a well commented example config file to :file:`.hooke.cfg`. Finding configuration files --------------------------- The default search path follows the `Filesystem Hierarchy Standard`_, and so will probably need adjustment for non-\*nix systems. The default path list is * :file:`/usr/share/hooke/hooke.cfg` * :file:`/etc/hooke/hooke.cfg` * :file:`~/.hooke.cfg` * :file:`./.hooke.cfg` but alternatives can be specified from the command line launching Hooke. .. _Filesystem Hierarchy Standard: http://www.pathname.com/fhs/ .. todo:: Implement command-line specified config file. .. warning:: Any changes you make to the configuration during a Hooke run will *not be saved* when Hooke exits. To save the changes, either run the `save config` command before closing Hooke, or start Hooke with the ``--save-config`` option. .. todo:: Implement `save config` command.